ModsJava
CoinsAPI
Java mod listed for Minecraft 1.20–1.21. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotCoinsAPI – The flexible currency API for Minecraft
Simple, fast, and modern coin system for your server & network
───────────────────────────────────────────────
What is CoinsAPI?
A lightweight economy core for Spigot/Paper with YAML/MySQL storage, PlaceholderAPI, a clean developer API, optional Vault bridge, and network sync via Redis.
───────────────────────────────────────────────
✨ Highlights
- Player GUI – [/coins gui] shows balance & hints.
- Admin GUI – [/coins gui <player>] quick actions: +100, -100, Set 1000, History.
- Transaction History – [/coins history <player> [limit]] with timestamped entries.
- Vault Integration – works with any plugin using Vault Economy.
- Global Balances – MySQL storage + optional Redis pub/sub for live cross-server updates (Bungee/Velocity).
- Discord Webhooks – notifications for large transfers & admin actions.
- Developer Events – easy hooks: balance change, pay (cancellable), account create.
- PlaceholderAPI – %coins_balance%, %coins_name%.
- No negatives – balances never drop below zero.
- Tab completion & clickable help.
───────────────────────────────────────────────
✅ Compatibility
- Server: Spigot / Paper (1.20 – 1.21.x)
- Java: 17 or 21
- Optional: PlaceholderAPI, Vault, Redis
───────────────────────────────────────────────
⚙️ Installation
- Drop CoinsAPI.jar into /plugins.
- Start the server once.
- Edit config.yml (currency name, start balance, MySQL, Redis, webhook).
- (Optional) Install PlaceholderAPI / Vault if you use them.
───────────────────────────────────────────────
⌨️ Commands
- /coins — show your balance
- /coins help — clickable help
- /coins gui — open player GUI
- /coins gui <player> — open admin GUI for target
- /coins add|remove|set <player> <amount> — admin actions
- /coins history <player> [limit] — recent transactions (admin)
- /pay <player> <amount> — send coins to a player
Permissions
- coins.use — /coins, /pay
- coins.gui — /coins gui (player)
- coins.admin — add/remove/set, admin GUI
- coins.history.admin — history command
───────────────────────────────────────────────
Example config.yml
Code (YAML):
lang : "en"
coins:
display-name : "Coins"
start-balance : 100
storage:
type : "YAML" # "YAML" or "MYSQL"
mysql:
host : "localhost"
port : 3306
database : "minecraft"
user : "root"
password : "password"
useSSL : false
async:
enabled : true
redis:
enabled : false
host : "127.0.0.1"
port : 6379
password : ""
channel : "coinsapi:balance"
vault:
enabled : true
history:
enabled : true
max-per-player : 250
webhook:
enabled : false
url : ""
large-transfer-threshold : 10000
bstats:
enabled : true
service-id : 0
PlaceholderAPI
- %coins_balance% — player balance
- %coins_name% — currency name (from config)
Code (Text):
Balance: %coins_balance% %coins_name%
Developer API
Code (Java):
// Get service
CoinsService coins = org. bukkit. Bukkit. getServicesManager ( ). load (CoinsService. class ) ;
if (coins != null ) {
long bal = coins. getBalance (player. getUniqueId ( ) ) ;
coins. transfer (player. getUniqueId ( ), target. getUniqueId ( ), 50 ) ;
}
Code (Java):
@EventHandler
public void onPay (CoinsPayEvent e ) {
if (e. getAmount ( ) > 1000000 ) e. setCancelled ( true ) ; // block very large transfers
}
@EventHandler
public void onChange (CoinsBalanceChangeEvent e ) {
// log or react to balance changes
}
───────────────────────────────────────────────
❓ FAQ
PlaceholderAPI not detected? Install PlaceholderAPI and restart the server.
Vault not working? Ensure Vault is installed and vault.enabled: true.
Global balances? Use the same MySQL DB across servers; enable Redis for live updates.
No horizontal lines? Spigot BBCode doesn’t support [HR]; this page uses colored unicode lines.
───────────────────────────────────────────────
Changelog
Spoiler: 1.1.0
• Player & Admin GUI
• Transaction history command
• Vault economy bridge
• Redis-based network sync (optional)
• Developer events (pay, balance change, account create)
• Discord webhook notifications
• bStats opt-in (service-id configurable)
• Transaction history command
• Vault economy bridge
• Redis-based network sync (optional)
• Developer events (pay, balance change, account create)
• Discord webhook notifications
• bStats opt-in (service-id configurable)
───────────────────────────────────────────────
Screenshots / Videos
- /coins gui (player)
- /coins gui <player> (admin)
- /coins history <player> — log preview
───────────────────────────────────────────────
Get Started
- Drop the JAR into /plugins
- Start the server
- Configure config.yml (MySQL/Redis/Vault/Webhook as needed)
- (Optional) Install PlaceholderAPI / Vault
───────────────────────────────────────────────
⚡ Support & Feedback
Questions or suggestions? Send a message or open an issue!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
CoinsAPI is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 57 times (via Spigot). Download it and open it directly in the game.