GemXp — Store Your Minecraft XP in Soul Gems

GemXp plugin for Minecraft turns XP into soul gems: store levels safely, trade them with friends, and customize transfer loss for balanced server economy.

Download GemXp

Original name: GemXp

FileVersionLoaderSize
GemXp.jar——13 КБDownload

GemXp: Smart Experience Storage for Minecraft

Every Minecraft player knows the sinking feeling of losing hours of accumulated experience after an unexpected fall into lava or a surprise creeper explosion. Levels painstakingly gathered in deep caves or during epic dragon battles vanish in a heartbeat. GemXp: Smart Experience Storage for Minecraft addresses this universal frustration with a clever, elegant solution. Instead of letting experience remain an abstract number vulnerable to loss, this plugin transforms it into a tangible, physical item that can be stored, traded, or saved for the perfect moment. As a fully independent successor to the well-known PearlXP, GemXp has been completely rewritten from the ground up and expanded with a host of new features that make it a standout tool for server administrators and players alike.

The Core Mechanic: Soul Gems Explained

At the heart of GemXp lies the concept of the "soul gem." By default, an empty gem is represented by a standard ender pearl, while a filled gem takes the form of an eye of ender. This intuitive visual progression makes it immediately clear to players what they are holding. To charge a gem, the player simply selects the appropriate item in their hotbar and clicks the left mouse button. A portion of their experience flows into the gem, as if the soul is being crystallized into a physical form.

The transfer process is not without its nuances. The developers have built in a configurable loss percentage that applies when filling a gem. This adds an element of risk and realism to the mechanic, forcing players to think strategically about when and how they store their hard-earned levels. Restoring experience works in the reverse manner: a simple click on a filled gem returns the stored XP to the player. A particularly nice touch is that in Creative mode, gems can be charged even without any actual experience, making testing and server setup significantly easier.

Key Features of the Soul Gem System

  • Empty gems default to ender pearls; filled gems default to eyes of ender, providing instant visual recognition.
  • Both states can be customized with different item IDs to match server themes or player preferences.
  • Creative mode allows for free charging of gems, simplifying testing and demonstration scenarios.
  • Filled gems can be stacked, though the maximum stack size is configurable to prevent excessive hoarding.

Comprehensive Configuration for Any Server

Server administrators will appreciate the remarkable flexibility that GemXp offers. Every message displayed by the plugin can be translated into any language by simply editing the configuration file. This makes the plugin accessible to international communities without requiring any coding knowledge. The visual appearance of both empty and filled gems is fully customizable through item identifiers. While the classic pairing of ender pearl and eye of ender works perfectly out of the box, administrators can assign custom blocks or items to suit their server's aesthetic. It is even possible to use the same item for both states, although having a visual distinction helps players quickly identify their inventory contents.

The configuration options go beyond simple aesthetics. Several parameters deserve special attention:

  • Transfer loss: The percentage of experience lost when filling a gem, with a default of 10%. This can be set to zero for exact preservation.
  • Maximum stack size: Prevents infinite accumulation of filled gems in a single inventory slot, maintaining economic balance.
  • Maximum gem capacity: The current hard limit stands at 32767 experience points per gem, which is more than sufficient for even the highest player levels.
  • Inventory tooltips: Hovering over a gem displays its nature and the exact amount of stored experience, providing clear information at a glance.

Thanks to its well-architected design, the plugin integrates seamlessly with MCStats metrics. This allows server owners to track feature usage and understand how their community interacts with the soul gem system. For those concerned about privacy or performance, this integration can be easily disabled in the plugins/PluginMetrics/config.yml file.

Installation and Getting Started

GemXp is distributed as a standard server-side plugin compatible with Bukkit, Spigot, and Paper servers. The installation process is straightforward: simply place the jar file into the plugins folder and restart the server. No client-side modifications are required, meaning players can join with a completely vanilla Minecraft client. This makes the plugin an excellent choice for friends playing on a local server or a dedicated hosting solution.

For those who wish to quickly test the plugin in a single-player world or on their own local server, using a modern launcher that supports mod and plugin management can streamline the process significantly. Such tools allow users to download GemXp: Smart Experience Storage for Minecraft for Minecraft directly from a menu and launch the desired setup without complex manual configuration.

The plugin introduces several straightforward permissions that administrators can assign through any standard permissions manager. Notably, no primary command is required for daily use; all interaction occurs through item clicks, making the interface intuitive even for newcomers. A complete list of permissions and configuration examples is available on the project's GitHub repository, which can be easily located by searching for "GemXp." For players asking "how to install" the plugin, the process is as simple as dropping the jar into the plugins folder and restarting the server.

Comparison with Predecessor and Unique Advantages

Unlike the original PearlXP, GemXp is a fully independent project that incorporates numerous improvements and refinements. The integration with MCStats provides developers with valuable insights into feature popularity, while the localization support opens the plugin to a global audience. The ability to use stacks of filled gems and configure experience loss creates a more dynamic server economy. Players can trade experience, establish "soul banks," or participate in quests that reward charged gems as prizes.

The development team, consisting of Marex (recursivr) and Zonta, has invested significant effort into rewriting the codebase, resulting in a stable and lightweight plugin. The idea originated in the IRC chat of the nebtown.info community and has found new life through this continued development. Video demonstrations, such as the one by Stadvert, provide a visual walkthrough of all plugin stages, helping players and administrators quickly familiarize themselves with the mechanics.

Practical Usage Scenarios and Tips

When first implementing GemXp on a server, start with the default soul gem items so players can quickly recognize the new mechanic. If balance is a concern, increase the transfer loss percentage to encourage thoughtful use of the system. On servers with a strong PvP focus, filled gems become valuable loot, and the ability to transfer them between players creates the foundation for a dynamic in-game economy. Players can sell experience, barter for rare items, or store levels for future challenging encounters.

Monitoring the maximum stack size is crucial; allowing too many gems per slot could devalue experience as a commodity. Always test configuration changes on a separate world before deploying them to the main server. While the plugin is forgiving of errors, changing item identifiers requires careful attention to ensure that selected blocks do not conflict with other mods or plugins. The default pairing of ender pearl and eye of ender remains an ideal choice, as these items are familiar to every player and naturally fit the game's aesthetic.

Conclusion: An Indispensable Tool for Server Administrators

GemXp: Smart Experience Storage for Minecraft transforms abstract experience points into a tangible, tradeable resource, opening new possibilities for player interaction and server management. Its ease of configuration, full localization support, and thoughtfully designed limits make it a versatile solution for any project, from vanilla survival servers to complex RPG setups. Whether the goal is to protect player progress, add depth to the economy, or create new gameplay opportunities, this plugin delivers on all fronts. The active development and open-source nature of the project guarantee long-term support and the potential for customization to meet unique community needs. For any server administrator seeking to preserve player achievements and enrich the gameplay experience, GemXp is a tool well worth exploring.