kMoney Docs 📖

Contents

Commands

All subcommands are under /money. The root command /balance is an alias for /money.

Amount Format

All amount arguments accept shorthand suffixes (case-insensitive). Comma-separated numbers are also accepted. The keyword all is supported by /money remove and /money withdraw.

Permissions

Money Checks

• A money check is a physical in-game item (default: Paper) representing a fixed monetary value.
• Players use /money withdraw to convert balance into checks; right-clicking a check claims its value.
• The item material is configurable via check-material in config.yml.
• /money withdraw <amount> <notes> creates a stack of up to 64 checks, each worth amount. Total cost is amount × notes.
• Item lore shows the per-note value and the creator's name.
• Checks are protected against duplication through hoppers, villager trades, and piglin bartering.

Leaderboard

• The rich list is built asynchronously and cached in memory — /money top is always instant regardless of server size.
• Results are paginated at 10 entries per page.
• Cache refresh interval is set by top-update-interval-seconds in config.yml (default: 300 s).
• The interval is re-applied immediately on /money reload.
• Before each refresh, all pending balance changes are flushed to disk so the leaderboard reflects up-to-date data.

Storage

• Balances are stored as individual YAML files at plugins/kMoney/players/<uuid>.yml.
• The economy manager keeps an in-memory write-back cache: reads hit the cache first; a miss loads from disk and populates the cache.
• Writes go to the cache and mark the entry dirty.
• Dirty entries are flushed to disk every 30 seconds via an async autosave task.
• All dirty entries are also flushed synchronously on plugin shutdown.
• Balances can never go negative — removeBalance clamps at zero.

Sounds

Every economy action plays a configurable sound. All sounds are defined in sounds.yml. Each entry supports enabled, sound, pitch (0.1–2.0), and volume. The entire system can be disabled by setting enabled: false at the top of sounds.yml.

Messages & Formatting

• All player-facing text is defined in messages.yml using MiniMessage format.
• Every message automatically receives the global prefix.
• Item lore (check name/value) uses raw messages without the prefix.
• Setting small-font: true in messages.yml replaces all standard Latin characters with Unicode small-caps equivalents — a stylised look without a resource pack.

Formatted amounts use small-caps Unicode suffixes:

ᴋ M ʙ ᴛ ǫ ǫǫ ѕ ѕѕ ᴏᴄ ɴᴏ ᴅᴄ ᴜᴅᴄ … up to ᴛᴠɢ (1e72)

PlaceholderAPI

When PlaceholderAPI is installed, the following placeholders are available:

Vault

• kMoney registers itself as a Vault Economy provider.
• Any plugin that uses the Vault Economy API will automatically use kMoney's balances.
• Bank operations are not supported.

Admin Join Notifications

• Operators with kmoney.admin receive a brief status message on join.
• If the running version matches the latest release on Modrinth: a confirmation message with a GitHub link.
• If a newer version is available: an update notice with a clickable Modrinth download link.
• Each admin can disable this for themselves with /money admin off.

Configuration Files

All three files are reloaded live with /money reload.