ModsJava
SxMobCoins

# SxMobCoins
**A second currency your players can hold in their hands.**
Mobs drop coins as a *real item*. Players carry them, trade them, lose them on death, and
spend them at shop keepers you place anywhere in the world — each keeper selling whatever
you put inside it, at whatever price you set.
No Vault. No economy plugin. No NPC library. No database. One jar.
## Why coins as items?
A balance is a number only the plugin can see. An item is in the player's hands: they can
sort it, hide it in an ender chest, hand it to a friend, and lose it when something kills
them far from spawn. The cost of that choice is forgery — which is why every coin is signed.
## Features
- **Signed against forgery.** Being a coin is decided by an HMAC signature made with a key
that exists only in your server's database — not by the material, name or lore. A renamed
sunflower buys nothing, and neither do coins from another server.
- **They still stack.** Every genuine coin carries the same signature.
- **Per-mob drop table** with a default for everything unlisted and an ignore list.
- **Shop keepers with their own stock.** Place as many as you like, each with its own items,
prices and name.
- **Filled like a chest.** Drag an item onto a shelf, or shift click it across. Left click
raises the price, right click lowers it, shift click takes it back.
- **Farm limits.** Spawner mobs pay a fraction or nothing, kills nobody landed pay nothing,
and there is an hourly cap per player.
- **Survives restarts.** Shops, stock, prices and the signing key live in SQLite; keepers
are rebuilt when their chunks load, leaving no stray villagers behind.
- **Folia ready.** Regionised threading is detected at startup and used where it exists.
## Commands
| Command | What it does | Permission |
|---|---|---|
| `/mobcoins` | What coins are and where to spend them | `sxmobcoins.use` |
| `/mobcoins shop create` | Place a keeper where you stand | `sxmobcoins.admin` |
| `/mobcoins shop rename [number] ` | Name it | `sxmobcoins.admin` |
| `/mobcoins shop remove [number]` | Remove the nearest shop, or one by number | `sxmobcoins.admin` |
| `/mobcoins shop list` | Every shop and what it sells | `sxmobcoins.admin` |
| `/mobcoins edit` | Open the nearest shop as a till | `sxmobcoins.admin` |
| `/mobcoins give [amount]` | Hand out coins | `sxmobcoins.admin` |
| `/mobcoins reload` | Reload config and messages | `sxmobcoins.admin` |
Sneak and right click a keeper as an admin to open the editor straight away.
## Configuration
```yaml
coin:
material: SUNFLOWER
announce: ACTIONBAR # where a player is told a kill paid
drops:
default: { chance: 0.2, min: 1, max: 1 }
mobs:
ZOMBIE: { chance: 0.25, min: 1, max: 1 }
ignored: [COW, SHEEP, PIG, CHICKEN]
protection:
require-player-kill: true # a lava pit pays nothing
spawner-multiplier: 0.0 # spawner farms pay nothing
max-per-hour: 250
delivery: INVENTORY
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 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 Hangar — 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.
SxMobCoins is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 1 times (via Hangar). Download it and open it directly in the game.