Credits

!Features

• 💰 Economy System — Per-player balance with configurable starting amount, min/max limits and negative balance support

• 🗄️ 3 Database backends — H2 (embedded, zero config), SQLite and MySQL with HikariCP connection pooling

• 🔗 Vault — Full Vault Economy API implementation, compatible with all Vault-dependent plugins (ShopGUI+, EssentialsX, etc.)

• 📊 PlaceholderAPI — Placeholders to display balance and leaderboard rank anywhere

• 💸 Player Payments — Send credits to other players with cooldown, min/max amount and toggle support

• 🏆 Leaderboard GUI — Fully customizable top players GUI via guis.yml, with player heads and custom skull textures

• 🎨 Advanced Colors — Legacy & codes, HEX &#RRGGBB, gradients <gradient:#color1:#color2> and <bold> tag

• 🔊 Sound Effects — Configurable sound, volume and pitch per event

• 📝 Fully Configurable Messages — Every message editable in lang.yml

• 🔄 Hot Reload — Reload configuration without restarting the server

!Commands

Command	Description	Permission
/credits help	Show help menu	credits.use
/credits balance [player]	Check your or another player's balance	credits.use
/credits pay <player> <amount>	Send credits to another player	credits.use
/credits top	Open the leaderboard	credits.top
/credits give <player> <amount>	Give credits to a player	credits.admin
/credits take <player> <amount>	Take credits from a player	credits.admin
/credits set <player> <amount>	Set a player's balance	credits.admin
/credits reset <player|all>	Reset a player's or all balances	credits.admin
/credits reload	Reload the configuration	credits.admin

✏️ Aliases: /bal, /balance, /money

!Permissions

Permission	Description	Default
credits.use	Basic commands (balance, pay, help)	true
credits.top	View the leaderboard	true
credits.admin	All admin commands	op

!Placeholders

Placeholder	Description	Example
%credits_balance%	Raw balance	1234
%credits_balance_formatted%	Formatted balance	1,234
%credits_balance_short%	Compact balance	1.2k, 3.5M, 2.1B
%credits_top_1%	#1 player — name & balance	Steve - 50,000
%credits_top_N%	#N player on the leaderboard	Alex - 30,000

!Integration

🔗 Vault

• Full Economy implementation
• Works with all Vault-compatible plugins
• Can be toggled via vault.enabled

📊 PlaceholderAPI

• All placeholders listed above
• Usable in scoreboards, holograms, signs, chat, etc.

!Config

Everything is configurable in config.yml:

• 💰 Economy — Starting balance, min/max, allow-negative, number format
• 💸 Payments — Enable/disable, min/max amount, cooldown in seconds
• 🔊 Sounds — Sound, volume and pitch per event
• 🗄️ Database — H2, SQLite or MySQL
• 🎨 GUI — Fully customizable leaderboard via guis.yml (pattern, items, textures)

🗄️ Supported Databases

Type	Use Case
H2	Default — embedded, no setup required
SQLite	Lightweight alternative
MySQL	Large servers or multi-instance setups

🎨 Supported Color Formats

• Legacy codes (&a, &c, &l, etc.)
• HEX (&#RRGGBB)
• Gradients (<gradient:#0088FF:#70BCFF>text</gradient>)
• Bold tag (<bold>text</bold>)

---

Made with ❤️ by NoxuWT