CoinsAPI icon

CoinsAPI -----

A flexible coins and currency system for your Minecraft network.

Download Now
56.6 KB .jar


[​IMG]

CoinsAPI – 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
  1. Drop CoinsAPI.jar into /plugins.
  2. Start the server once.
  3. Edit config.yml (currency name, start balance, MySQL, Redis, webhook).
  4. (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)
Scoreboard example:
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 ) ;
}
 
Events (simple):
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
}
 
Vault: if Vault is present and enabled in config, CoinsAPI registers as Economy provider automatically.

───────────────────────────────────────────────

❓ 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
• 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)

───────────────────────────────────────────────

Screenshots / Videos
  • /coins gui (player)
  • /coins gui <player> (admin)
  • /coins history <player> — log preview

───────────────────────────────────────────────

Get Started
  1. Drop the JAR into /plugins
  2. Start the server
  3. Configure config.yml (MySQL/Redis/Vault/Webhook as needed)
  4. (Optional) Install PlaceholderAPI / Vault

───────────────────────────────────────────────

⚡ Support & Feedback
Questions or suggestions? Send a message or open an issue!
View on SpigotMC
Resource Information
Author:
----------
Total Downloads: 20
First Release: Aug 24, 2025
Last Update: Aug 25, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings