Chunkwright Gems banner: Gems plugin for Paper and Purpur servers, with an in-game screenshot

Chunkwright Gems

$9.99

Ability gems for SMP servers: actives, passives, energy, levels and a ritual for a rare gem.

Instant download after payment. One purchase covers one server or network. Updates are free.

Server
Paper and Purpur
Minecraft
1.21.4 to 26.1
Java
21 or newer
Needs
Optional: PlaceholderAPI
Version
1.0.0, 2026-10-11
Tested
Tested on real servers: 1,446 checks passed on Paper 1.21.4 to 26.1 and Purpur
Download
0.16 MB zip

What it does

Every player holds one of 9 gems. Each gem has an active ability with particles and sounds and passives that work while it is carried. Deaths cost energy and kills give it back; at 0 the gem shatters until an Energy Shard mends it. A multi-day ritual event gives one player the rare Starfall Gem. Craftable Energy Shards and Reroll Prisms, menus, an optional texture pack and PlaceholderAPI placeholders.

  • 9 gems (8 common, 1 rare): Inferno Ring, Frost Nova, Thunderstrike, Quake, Blink, Rejuvenate, Dash, Berserk, Meteor
  • Passive effects and combat perks: ignite, slow, spark, dodge, fall and freeze protection, heal on kill
  • Energy 0 to 10 with 3 levels; shattered gems at 0 energy
  • Lose energy on death, gain it from player kills, with an anti-farm cooldown per pair
  • Craftable Energy Shards and Reroll Prisms, /gems withdraw for trading energy
  • Locked gem item: no dropping, storing or losing it on death
  • Ritual event: altar, kill and offering points, boss bar, final phase, unique Starfall Gem, auto start
  • Every number in gems.yml; add your own gems with any of the 9 ability types
  • Optional resource pack with our own gem textures and a built-in pack host
  • Your gem and All gems menus, PlaceholderAPI placeholders, all text in messages.yml (MiniMessage)

Install

  1. Put Gems-1.0.0.jar in plugins/ and restart the server.
  2. Players get a random common gem on their first join.
  3. Optional: give players the resource pack.
  4. Edit plugins/Gems/config.yml, gems.yml and messages.yml, then run /gems reload.

Requirements

  • Paper or Purpur 1.21.4 to 26.1
  • Java 21+
  • Optional: PlaceholderAPI

Commands

Alias: /gem. /gems with no arguments opens the "Your gem" menu.

CommandWhat it doesPermission
/gems helpCommand listgems.use
/gems menu"Your gem" menugems.use
/gems list"All gems" menu (text list in the console)gems.use
/gems info [player]Gem, energy, level and cooldowngems.use
/gems useUse your gem's activegems.use
/gems itemGet your gem back if it is missinggems.use
/gems withdraw [amount]Turn energy into Energy Shards (keeps at least 1)gems.withdraw
/gems ritualRitual time left, altar and top 5gems.use
/gems ritual start [duration]Start a ritual (default 3d)gems.admin
/gems ritual stopStop it with no winnergems.admin
/gems ritual endEnd it now and give the rewardgems.admin
/gems ritual setaltarThe block you look at becomes the altargems.admin
/gems ritual addpoints <player> <amount>Add (or remove) ritual pointsgems.admin
/gems give <player> <gem> [energy]Set a player's gemgems.admin
/gems energy <player> <set|add|take> <amount>Change energygems.admin
/gems cooldown <player>Reset a cooldowngems.admin
/gems giveitem <player> <energy|reroll> [amount]Give Energy Shards or Reroll Prismsgems.admin
/gems reset <player>New random common gemgems.admin
/gems pack [player]Send the resource pack nowgems.admin
/gems reloadReload all files and recipesgems.admin

Permissions

PermissionDefaultWhat it gives
gems.useeveryonehelp, menu, list, info, use, item, ritual status
gems.withdraweveryone/gems withdraw and the menu button
gems.adminopevery admin command, plus gems.use and gems.withdraw
gems.cooldown.bypassnobodyno cooldown on actives

Every setting is in the commented config.yml, and every message in messages.yml (MiniMessage). The README in the zip lists them all.

How we test it

Tested on real servers: 1,446 checks passed on Paper 1.21.4 to 26.1 and Purpur. Every release runs on Paper 1.21.4, 1.21.5, 1.21.8, 1.21.11, 26.1.2 and Purpur 1.21.11, next to LuckPerms, Vault, EssentialsX and PlaceholderAPI. The run covers unit tests, scripted players going through every command and menu, random input, restarts and reloads. In the soak run 12 bots used the plugin nonstop and the server held 20 TPS, at most 2.2 ms per tick on average.

Changelog

1.0.1 2026-10-12

  • Fixed: a message missing from messages.yml now shows the built-in text instead of a placeholder.

1.0.0 2026-10-11

First release.

  • 9 gems (8 common, 1 rare) with actives, passives, particles and sounds.
  • Energy, 3 levels and shattered gems.
  • Energy Shards and Reroll Prisms with crafting recipes.
  • Locked gem items (no drop, no storing, kept on death).
  • Ritual event with altar, points, boss bar and a unique reward gem.
  • "Your gem" and "All gems" menus.
  • Optional resource pack with a built-in host.
  • PlaceholderAPI placeholders.
  • Paper and Purpur 1.21.4 to 26.1.
  • A player file that can't be read is no longer saved over. The player starts fresh in memory with a new common gem, the file stays as it was, and /gems reset or a fixed file takes it back.
  • The Starfall Gem glow is now checked in our tests (the nether star item glows by default; the shattered Starfall turns it off).

Questions

What is in the download?

One zip of 0.16 MB with the plugin jar, a README with setup, commands and config, the changelog and the licence, plus the optional resource pack.

Which servers does it run on?

Paper or Purpur 1.21.4 to 26.1, with Java 21 or newer (Java 25 for 26.1). We have not tested Spigot or Folia.

Can I use it on my server?

Yes. One purchase covers one server, or one network under one name. You can change the config and messages as you like. You cannot resell or share the plugin.

How do I get the files?

Right after payment you land on your download page, and we email you its link. The page keeps working, so you can download again later.

Are updates free?

Yes. When we release a new version, the same download link gives you the new zip. Every update is posted in #plugin-updates on our Discord.

Support

Ask in #plugin-help on our Discord, or open a Plugin support ticket in #request-a-quote. Need a change only your server has? Custom plugin work.

Made with our own tooling and tested by our team on real servers before release. How we work.

More plugins from our studio

Chunkwright KoTH banner: KoTH plugin for Paper and Purpur servers, with an in-game screenshot

King of the hill zones with a capture timer, boss bar, schedules and rewards.

Paper and Purpur 1.21.4 to 26.1 / Java 21+

New free builds by email

One short email when a new free build is out. Nothing else. Unsubscribe from any email.