Points

Points

Version V0.1.1 | Paper 26.2 | Standalone economy system, no dependencies

Overview

Points is a standalone points (economy) system plugin for Minecraft servers. It gives players a points currency to store, view and manage:

• Fully independent - no external plugin dependencies, can be deployed on its own
• Decimal points supported - values like 0.5 or 520.123, precise to 3 decimal places
• Player point data persisted in the plugin's own data file, auto-saved, surviving server restarts
• Ready-to-use player GUI, leaderboard and admin commands
• Built-in placeholder API and Java API, so other plugins can read player points

Features

• Point accounts: an account is created/updated automatically when a player joins (can be disabled in config)
• Player GUI: /points gui opens a 3x9 chest interface, with the player's head and current points in the center
• Leaderboard: /points list shows all players sorted by points (highest first), with configurable page size
• Point management: add / remove / set commands, with friendly messages when balance is insufficient; decimal points (e.g. 0.5, 520.123) are supported with 3 decimal places
• Placeholder API: %points_player% (player name), %points_access% (points value). Placeholders in chat messages are replaced automatically
• Fully customizable: all messages, colors and GUI content can be configured in config.yml

Commands & Permissions

Command /points Permission - Description Show help menu (filtered by permission) Command /points gui Permission points_player (default: true) Description Open the points currency GUI Command /points list Permission points_admin (default: op) Description View the points leaderboard Command /points add Permission points_admin Description Add points to a player Command /points remove Permission points_admin Description Remove points from a player (warns if insufficient) Command /points set Permission points_admin Description Set a player's points to a specific value

• Subcommands are case-insensitive (/Points GUI works the same as /points gui) and Tab completion is supported
• Target players are resolved in this order: online player -> player already recorded by the plugin -> server's offline cache

API

• Placeholders: %points_player% (player name), %points_access% (points value)

• Java API:

  PointsPlugin points = PointsPlugin.getInstance(); String text = points.replacePlaceholders(player, "Hello %points_player%, you have %points_access% points"); // Result: Hello PactLight, you have 100 points

  Use getPlaceholderService() / getPointsManager() to query individual players.

Integrations

• Can serve as a general economy backend, letting other plugins read/modify player points
• For example, the Credits system of the Store shop plugin is fully modeled on Points

Installation

1. Place Points-V0.1.1.jar into your server's plugins/ folder.
2. Start the server. On first start, the plugin creates config.yml (configuration) and points.yml (data) under plugins/points/.
3. You are done when the console shows "Points economy plugin V0.1.1 enabled".

Note: The data file is read and written automatically by the plugin - do not edit it manually. Changes to config.yml require a server restart.