Custom Player Points: flexible score and currency system for Minecraft

Custom Player Points mod for Minecraft adds a customizable YAML-based point system: currency, leaderboards, admin shops, and enchanted item purchases for server economy.

Download CustomPlayerPoints

Original name: CustomPlayerPoints

FileVersionLoaderSize
CustomPlayerPoints.jar3 КБDownload

Custom Player Points: Flexible Points System for Minecraft

Running a Minecraft server often means juggling multiple plugins just to track simple numbers: currencies, warning counters, or minigame scores. Most solutions are either too heavy, tied to a specific game mode, or require a degree in configuration files. Custom Player Points: Flexible Points System for Minecraft approaches this problem from a different angle. It is a lightweight, highly adaptable scoring framework that stores everything in plain YAML files, letting server owners define their own categories of points without being locked into a preset use case. Whether you need a player shop currency, a warning system, or a competitive leaderboard, this mod gives you the tools to build it quickly and cleanly.

The philosophy behind this add-on is straightforward: keep the core simple, but make the possibilities broad. Instead of forcing you into a rigid economy plugin, it provides a numeric tracking backbone. You decide what the numbers mean. This makes it an excellent fit for survival servers, mini-game networks, or even creative communities that want to reward participation. Because it is not tied to any specific gameplay loop, it integrates seamlessly into whatever ecosystem you already have running.

Core Features and Design Philosophy

Custom Player Points: Flexible Points System for Minecraft stands out because of its focus on clarity and ease of use. The mod does not try to do everything; it does one thing exceptionally well: manage numeric player data. Here are the primary capabilities you get immediately after installation:

  • YAML-based storage: All point values are saved in human-readable text files, making backups and manual edits trivial.
  • Arbitrary numeric operations: Add, subtract, set, or reset values for any player in any category.
  • Automatic Highscore signs: Display top players on any wooden sign with a simple tag.
  • Built-in AdminShop: Sell items and enchantments directly through sign-based interfaces.
  • Broad version support: The jar file works across many Minecraft releases without requiring a specific loader.

This feature set is intentionally minimal. There are no bloated GUIs or complicated permission trees to manage. The mod is designed to be predictable, fast, and easy to reason about, which is exactly what server administrators need when troubleshooting or expanding their setups.

Understanding the YAML Points System

At the heart of this mod lies its configuration structure. When you first launch the game with the mod installed, it generates a config folder containing YAML files. These files define the categories of points you want to track. For example, you could create categories named warns, money, or minigame_points. Each category can have its own starting value and optional limits.

The constraint is that each category stores only integers. This is a deliberate design choice. By avoiding strings or complex objects, the mod ensures that operations are always fast and that the data remains unambiguous. Editing a config file is as simple as opening it in any text editor, changing a number, and saving. The mod reads these files on startup and also writes changes in real time, so a server restart does not wipe progress.

This approach is particularly useful for server owners who want to tweak values on the fly. Instead of learning a new scripting language or navigating a plugin's proprietary database, you edit a plain text file. The simplicity also makes it easier to integrate with external tools or backup systems, as the data is fully portable.

Setting Up Highscore Leaderboards

One of the most popular features is the Highscore sign. This allows you to turn any standard wooden sign into a live leaderboard. To activate it, you simply place the sign and write [Highscore] on the first line. The mod then takes over, automatically displaying the current leader for the specified points category.

When a player right-clicks the sign, they see the full top list for that category. This is perfect for fostering competition on your server. Whether you are tracking kill counts, parkour completion times, or currency earned, the leaderboard updates dynamically as players earn or lose points. There are no extra commands to set up the display, and no external web panels required. It works out of the box.

This feature shines in mini-game servers where players constantly compare their progress. It also adds a layer of transparency to your economy, as everyone can see who holds the top spot. For administrators, this is a zero-effort way to encourage engagement and reward active players.

The AdminShop and Enchantment Trading

Beyond simple tracking, Custom Player Points: Flexible Points System for Minecraft includes a functional shop system. You can create shop signs using a specific format: [CPP], followed by the item ID, stack size, and the cost in points. For instance, a sign reading [CPP] 264 1 10 will sell one diamond for 10 points. This makes it easy to build a fully functional in-game economy without installing a separate shop plugin.

The shop also supports enchantments. By using the command /cppe <enchantment> <level>, you can open a purchase interface for the specified enchantment. The list of supported enchantments is extensive and covers most of what survival players would want:

  • fire, firearrow, damagearrow, infinitearrow
  • knockbackarrow, thorns, damage, undeaddamage
  • knockback, digspeed, lootbonusblocks, lootbonusmobs
  • oxygen (Respiration), protect_envi, protect_fall
  • protect_fire, protect_explo, protect_projectile
  • silktouch, waterworker (Aqua Affinity)

This opens up a new layer of progression. Players can spend their hard-earned points on rare enchantments like Silk Touch or Fire Protection, which might be otherwise difficult to obtain in pure survival. The cost for each enchantment is fully configurable, so you control how scarce these upgrades are. This creates a meaningful sink for your economy, preventing inflation and giving players long-term goals.

Commands and Administrative Control

Managing points is handled through a set of intuitive commands. Administrators can grant or deduct points directly from the console or in-game, while players can check their own balances at any time. All transactions are logged, which provides a clear audit trail and helps prevent abuse or accidental duplication of points.

The enchantment system via /cppe is a standout feature. It allows you to offer enchantments that are typically hard to obtain, such as silktouch or protect_explo. Because the pricing is adjustable, you can make these high-tier enchantments expensive, creating a strong incentive for players to participate in your server's activities. This turns your points system from a simple counter into a full-fledged progression mechanic.

If you are looking for a convenient way to get started, you might consider using a launcher that simplifies mod management. While the mod itself is a universal jar file, using a launcher can streamline the process of setting up multiple mods and checking compatibility. This is especially helpful for newcomers who are not yet comfortable with manual file placement.

How to Install and Compatibility Notes

Installing the mod is refreshingly straightforward. It is distributed as a single jar file that works across a wide range of Minecraft versions. To install it, you simply place the jar into the mods folder on your server or client. After a restart, the points system is active.

One of the key advantages is that it does not require Forge or Fabric to function. This means you can add it to a vanilla server with a mod loader, or even to a setup that uses a different API. The mod is designed to be non-intrusive and works alongside most popular server frameworks. Configuration files are stored in the config directory, where you can manually adjust category names, starting values, and limits.

For those who prefer a more guided installation, some launchers allow you to select mods from a catalog and handle the file placement automatically. This reduces the risk of errors and saves time, particularly when you are managing a large modpack. The mod's compatibility with all versions of Minecraft means you do not have to worry about version-specific builds when updating your server.

Future Development and Community Input

The developer is actively expanding the mod's capabilities. One planned feature is the ability to purchase additional hearts with points, which would add a new strategic layer to PvP and survival scenarios. There is also ongoing work on translations, with German already near completion. Other languages will be added based on community requests.

Feedback is welcomed. If you have ideas for new point categories or enchantments, the author is open to suggestions. This community-driven approach ensures that the mod continues to evolve in ways that are actually useful to server owners. As the mod grows, it will remain focused on its core promise: being a simple but powerful tool for custom server economies.

Conclusion

Custom Player Points: Flexible Points System for Minecraft is an indispensable tool for administrators who want to implement a flexible scoring system without the overhead of heavy plugins. Its YAML-based configuration, automatic leaderboard signs, integrated shop, and enchantment support make it a versatile solution for servers of any size. The installation process is quick, and the compatibility with all Minecraft versions means you can start using it within minutes.

Whether you are building a full player-driven economy, tracking warnings, or running a competitive mini-game lobby, this mod provides the foundation you need. It turns abstract numbers into meaningful gameplay mechanics, and it does so with a level of simplicity that is rare in the modding community. Try it in your next server build and see how easy it is to transform simple points into a complete reward system.