Crystals Minigame Plugin v2.2.2

If you’re enjoying the resource, I’d really appreciate you taking a moment to leave a review. Development takes a lot of time and effort, and your feedback truly helps and motivates me to keep improving! Thank you!

Changelog:

• Changed Coal Wall breaking time from 12.5 -> 7.5 seconds
• Knockback and Punch enchanted books now consume 75% durability (previously stated 40% was incorrect; it was 60%)
• Crystal can now be revived only once
• Added a hologram above destroyed crystals showing the option to repair them
• Added 3 tips that are shown to new players at the start of the game
• Added Compass to the shop that points to the nearest enemy
• Teleport Bow can no longer be enchanted
• Rewritten instant void kill
• Adjustments and fixes in the Level System
  • Players now start at level 0
  • Updated Level Ranges to align with Level Evolution
  • Updated Level Up Banner
  • Fixed incorrect color for Level Evolution 80-89
  • Fixed issue where players couldn’t progress past level 10 and could claim infinite rewards
  • Fixed issues with level 100
  • Fixed issue where unclaimed reward for level showed the current level instead of the level applicable to the unclaimed reward
• Optimized BungeeMode
• Fixed incorrect English in the boss kill message
• Fixed error in console when destroying a crystal in server version 1.21.8
• Fixed issue where some end-of-game actions didn’t execute if a spectator joined during the game
• Fixed issue allowing players to spread items in Shop Menu and Kit Selector
• Fixed issue where players could purchase shop items using items from their inventory with identical names
• Fixed issue where scoreboard updated only for the player who destroyed the crystal
• Fixed issue where player names sometimes kept team color in subsequent games
• Fixed issue where game sometimes didn’t end properly if all enemies disconnected
• Fixed console error occurring when a player disconnected right after dying
• Fixed duplication bug with Teleport Bow, Teleport Ball, 3x3 Coal Wall, and Anti-Knockback when clicking them in the shop
• Fixed incorrect check for enough players when a player disconnected with minPlayers < 5
• Fixed issue where searching for a new arena didn’t consider other servers
• Fixed issue where in some cases players couldn’t spectate an arena from the Lobby

• Added refreshing for Top Stats Hologram
• Optimized Top Stats Hologram
• Added server health monitoring. If the server runs into issues (e.g., high memory usage), a restart will be triggered. The system automatically decides whether ongoing arenas can finish or not
• Added /scheduleRestart [hardDeadline] command to schedule a restart (e.g., for plugin updates)
  • hardDeadline = true > allows arenas to finish
  • hardDeadline = false > enforces a strict deadline (10m)
• Added a small reward summary to the post-death game summary
• Post-death Game Summary is no longer sent if the player dies and the game ends
• Fixed an issue where the plugin sometimes failed to properly integrate with Vault
• Fixed an issue where the dungeon spawn countdown continued even after the game ended
• Fixed an issue where chat.current_balance showed the balance before the currency was deducted
• Fixed an issue where kit purchase costs were only deducted during the first game when playing multiple games without relogging
• Fixed various issues with the Daily Reward Track
• Fixed an issue where minutes were displayed incorrectly in hologram.leaderboard.will_update_in in JsLobby Top Stats Hologram when 1–2 minutes remained

• Added /crystals settings command which allows configuring many game settings (also works with some settings in lobby via JsPlugin /jslobby settings)
• Added /crystals spectate [player] command to spectate players currently in games, also works with crystals.spectate permission
• The /crystals games command now opens a GUI where you can join a game directly or spectate it if it is running, also works with crystals.spectate permission
• JsLobby: Added the /profile command for opening the Profile Menu
• JsLobby: Added the /jslobby games command (also available for players with <minigame>.spectate / jslobby.spectate permission), replacing /jslobby list
• Added the ability to reset the default kit by right-clicking the selected kit in the Kit Selector
• Added the ability to reset selected cosmetics
• Added tab completion for commands
• Players can now change their kit only through their own crystal
• Updated Reward Summary design: reward breakdown is now shown below the header instead of on hover (only when Daily Reward Track is enabled, as it has fewer rewards and won’t spam chat)
• Cosmetic prices are now stored in the database (will be applied to all settings later)
• Improved Server Management
• Improved how statistics are handled
• Teleporting to a player using the Teleporter now closes the inventory
• Players with the same number of kills now share the same rank in Top Players
• Top Players now supports plural forms of score name
• Accessing the Kit Layout Editor now only requires a shift-click
• Joining a new available arena now also allows players with the game.joinfullserver permission
• Changed the argument order for /crystals give <economy> <player> <amount> to /crystals give <player> <economy> <amount>
• Now possible to give currency to offline players
• Added new date formats to the scoreboard: %date_daymonth% (25/02/2026) and %date_daymonthdots% (25. 02. 2026)
• AFK check now only runs during an active game
• Increased the time before AFK players are kicked from 90 seconds to 150 seconds
• Added option to disable the Anti-AFK system (/crystals settings)
• Joining a new available game now also considers other servers if BungeeCord mode is enabled
• Removed /crystals kits help from /crystals help as it was incorrectly listed

Bug Fixes:

• Offline players are now correctly included in Top Players
• Players can no longer send an empty message to all chat by typing only '!'
• Fixed the multi-kill messages (Double Kill, Triple Kill, Quadra Kill, Penta Kill)
• Fixed %dead_color% placeholder in kill message preview
• Fixed the join message where the online player count was sometimes incorrect
• Fixed the title.winner message
• Fixed flying in Spectator mode
• Fixed cases where the Anti-AFK system did not work properly
• Fixed some Projectile Trails dropping collectible item stacks
• Fixed an error when closing the Profile Menu if the Daily Reward Track was disabled
• Fixed an issue where Soulbound items could be moved into chests using number-key swapping
• Fixed an issue where searching for a new available arena included arenas in the final phase, sending players to the lobby
• Fixed an issue where map votes were not properly removed when a player disconnected
• Fixed an issue where game ending could trigger multiple times, causing problems
• Fixed an issue where armor was not removed upon becoming a spectator after death
• Fixed an issue where spectators could pick up arrows from the ground
• Fixed an issue where a player could die outside of an active game and wasn’t teleported correctly
• Fixed an issue where a player received the win message after joining a new arena before it was sent
• Fixed a bug where players could claim the same Daily Reward Track tier multiple times by clicking rapidly
• Fixed typo in /crystals help where one command was listed incorrectly as /miniannirun ...

• Players no longer receive a cosmetics data error message on their first join
• Fixed an issue where the Level System did not work properly on a player’s first join, which also affected chat

Join our Discord to stay up to date with discounts and updates, share your ideas, and report any bugs. https://discord.gg/UFJXmsrX2c

Join our Discord to stay up to date with discounts and updates, share your ideas, and report any bugs. https://discord.gg/UFJXmsrX2c

• Added support for 1.21.9, 1.21.10, and 1.21.11
• Added reworked Top Stats Hologram.
• Added simple Lobby System. Commands like joining an arena or the best arena. Ability to set up player stats and top stats for minigames.
  • In the future, the Lobby System is planned to be improved and more features will be added. Currently, the admin has to handle lobby-related things like setting up items and NPCs that teleport players into the world.
  • I am aware that lobby system should have been in the plugin a long time ago. Sorry it took so long.
• When opening the Map Voting GUI, the maps no longer shuffle and the map order will always remain the same. If there are more than 9 maps, the maps will rotate.
• Fixed database table creation on first startup
• Various other small fixes

• GameAPI now included in the plugin; remove GameAPI plugin from /plugins to avoid conflicts
• This plugin now requires ProtocolLib
• Statistic names in the database cannot contain spaces. Replace spaces with _, or delete and let the plugin to recreate the table.

If you encounter any issues after updating from an older version to this one, please contact me on Discord: john.slovakia. I will try to resolve your issues as soon as possible. Thank you.

Due to the use of new features from newer versions, the plugin is now only supported for minecraft version 1.21+. Version 1.8 and 1.20.4 will not receive any further updates at this moment.

Future plans can be found at the end of the changelog

Changelog:

• Added Resource pack that brings additional custom elements to the game
• Inventories now have their own appearance thanks to resource pack
• Level System added
  • Players gain XP by playing and level up as they progress.
  • Currently, rewards include only coins and cosmetic tokens, but additional rewards are planned for the future, such as extra Quest slots, cosmetic crates, and coin boosters (subject to change)
  • To disable, add levelSystem: false in the config.yml
• Daily Reward Track added: players earn XP by playing and receive rewards for reaching each tier (for now max 7 claims)
  • Players currently receive only coins and cosmetic tokens, but in the future, they will receive reward crates containing additional possible rewards.
  • This will also be used for various events, where players will receive limited currency that they can use to purchase chests containing limited cosmetics (subject to change)
  • Level System must be enabled
  • To disable, add dailyRewardTrack: false in the config.yml
• Boss can no longer be damaged using fired arrows
• Stats with spaces need to be rewritten with _ or the table needs to be deleted
• Added support for deepslate ores
• Added message indicating the player is near a crystal when using Defender kit
• Removed Platform and TNT items from the shop
• Removed Wizard kit to simplify gameplay and limit methods of easily knocking players into the void
• Prevented anvils from being destroyed after use
• Bow removed from the shop
• Cobweb respawn time reduced from 60 → 25 seconds
• Wood regeneration time reduced from 15 → 8 seconds
• Diamond ore regeneration time reduced from 25 → 20 seconds
• Fortune effect removed when mining pumpkins
• New quests added
• Scoreboard indicator for whether a team has a crystal replaced with a custom crystal icon instead of the original heart
• After the first gravel mining, the player always receives an arrow to indicate it’s chance-based; new players also get an info message
• Players can now receive strings for mining cobwebs. This is chance-based. After the first mining, the string is guaranteed. New players also get an info message
• Spectators can now view chests
• Coin Bonus added for quests, level system, and daily rewards - permission: vip.bonus.x (x = 5, 7, 10, 12, 15, 17, 20, 25, 30)
• Quests now reset at fixed times
• Quests now start automatically for players
• Players must claim quest rewards themselves
• CoinsAPI support removed; connect CoinsAPI with VaultAPI and set useVault to true in config
• Players without selected kit will have Kit Selector open at 10 seconds into start
• Each game now has its own Waiting Lobby world
• Better Number formatting added in messages
• Purchasing cosmetics now requires new cosmetic tokens, obtainable via Level up or Daily Reward Track
• Language selection added in the new Player Menu
• Cosmetics can now be managed in the new Player Menu
• Stats hologram design updated
• Top Statistics temporarily removed (requires rework)
• DecentHolograms no longer required for stats holograms
• /crystals start now ignores player count check if a player disconnects
• Improved kit item cooldown visuals
• Players must now confirm cosmetic and perk purchases
• After death or at the end of the game, players can view their stats for the played game by hovering over a message in the chat
• Added option for players to customize their inventory layout for each kit
• Chat format can now be edited in the languages file
• Added TnT kill message
• Added Update Checker
• Added Winstreak stat
• Added support for several Friends & Party plugins
  • Players are notified when a friend or party member joins the game.
  • Players are connected to the same arena.
  • At the end of the game, players can see the placement of party members or friends in the top killers.
  • Additional small features are planned
• Added support for HEX colors
• Added PlaceholderAPI support in messages
• TNT now better detect kills
• Newly gained vanilla advancements no longer appear in the chat
• Data handling redesigned
• Optimization
• Used rewritten GameAPI
• Other small changes

Bug fixes:

• Spectators can no longer pick up XP from the ground
• Cobwebs no longer drop any items
• Wood can no longer be stripped
• Fixed Berserker kit not giving +1 max HP on player kills
• Fixed Defender kit not granting XP to the defender for killing enemies
• Fixed Defender kit not considering kills at crystals or outside
• Fixed Berserker kit not restoring original max HP
• Fixed Defender kit applying Absorption effect near crystals without enemies present
• Fixed issue where game worlds containing “world” or “nether” in the name were not deleted
• Fixed an issue preventing interaction with chests, workbenches, and other inventory blocks while holding tools.
• Fixed a bug where, in some cases, opponents couldn’t be hit
• Fixed several other bugs
• Fixed a bug where game instance reset could crash the server
• Fixed bug where the world wasn’t correctly deleted after the game ended in some cases
• Fixed issue with quests not being properly sorted in the GUI
• Fixed issue with world not being loaded when game start was paused due to low player count

Future Plans:

• Lobby System
• New rewards for the LevelSystem and the Daily Reward Track
• More extensive use of the resource pack
• Limited seasonal cosmetics
• Weekly statistics (possible rewards for top-ranked players)
• Cosmetic System rework and new cosmetics
• Quest system rework (?)
• More plugin customization

• Kit items are now indestructible
• Player now gets xp for assist
• Fixed Instant Heal Potion
• Fixed a bug where it wouldn't properly teleport players after the game ended
• Fixed a bug where the game did not end in the correct conditions
• Fixed a bug where the boss would not respawn after falling into the void
• Fixed a bug where teleporting to a base with the Teleport Ball would cause damage
• Fixed a bug where it was not possible to break the Coal wall
• Other minor bug fixes

• After death, the player now gets Resistance for a few seconds. (after hitting another player, they lose it)
• Added coin bonus - To get the bonus, the player must have vip.bonus<percent> permission - bonus must be a multiple of 5 (= 5, 10, 15,... 50) and maximum is 50%
  Spoiler: For those who have already loaded the languages files

  For those who have already loaded languages files, you need to add:
  
  english.yml:
  chat.economy.bonus: " %economy_color%+ %reward% %economy_name% §7from your §aVIP rank bonus §7(%bonus%%)"
  
  czech.yml:
  chat.economy.bonus: " %economy_color%+ %reward% %economy_name% §7from your §aVIP rank bonus §7(%bonus%%)"
  
  Or if you don't mind losing any edited messages, you can simply delete the files.
• Spectator can no longer hit players in the game.
• Spectator can no longer open chests, furnaces and other blocks
• Fixed other bugs in Spectator Mode
• "View Player Inventory" has now the correct title
• Added getting Bread from Hay Bale and getting Melon Slice from Melon Block
• Default kit is now getting the correct items
• Disabled crafting a minecart and a boat (Due to the possibility of transporting a entities with it)
• Added Coal Wall to the shop
• Removed TNT
• Fixed Boss movement in 1.8.8 version
• Fixed breaking Oak Planks
• Fixed /anvil command in 1.8.9
• Fixed bug where arena would not reset when all players disconnected in Prepapration state
• Fixed a bug where drinking a potion took all potions out of inventory
• Other minor bug fixes