
Mercantile
Adds a simple currency system with optional Create 6+ integration
About this Mod
 
 
🪙 Mercantile
This mod adds a simple currency to Minecraft: copper, silver and gold coins (configurable).
While holding a coin and right-clicking, its value will be stored in your "purse".
You can get the coins back by clicking the respective buttons in your inventory.
There is no way to get the items (currently), apart from creative mode or commands.
This means, you'll have to come up with your own economy system for your server.
Some ideas:
- Admin shops, exchanging goods (e.g. Wheat) for coins
- Add coins to chest loot tables using KubeJS + LootJS (this works best with the Lootr mod, so everyone has a chance to loot coins)
- Coins as quest rewards (using something like FTB Quests)
Create Shopkeeper Integration
If you have Create 6+ installed, this mod will enable you to pay super easily with your stored coins at shopkeepers!
Any coins you have in your inventory will be stored before the purchase.
Here is how such an interaction might look like ingame:

Adding your own coins
The mod provides standard textures and item models for copper, silver and gold coins (with different textures depending on the item stack size).
(I am no artist, so I used existing textures from the Thermal Series mods made by Team CoFH.)
If you add any other coins you need to also provide a resource pack with corresponding textures and item models for these items.
You may also want to add the #mercantile:coin tag to any new coins using a datapack or something like KubeJS.
Example
If you want to add a platinum coin, you first need to declare it and its value in the config/mercantile-common.properties config file.
You can do this by adding this line to the file:
platinum = 10000
Note: The coin definitions in this file need to be the same on client and server.
This creates a mercantile:platinum_coin item with a value of 10,000.
Now you need to provide a resource pack with the corresponding textures and item models.
An example for such a resource pack is provided for this specific example in the GitHub repository.
Tips for modpacks
- Include a way to get coins
- If you use the default textures and have Thermal Series mods installed, you may want to remove the recipes for Thermal's own coins using something like KubeJS:
ServerEvents.recipes(event => { event.remove({ input: /^thermal:.+_coin$/ }); event.remove({ output: /^thermal:.+_coin$/ }); event.remove({ id: /^thermal:machines\/press\/press_.+_to_coin$/ }); });
Available Versions
How to Install Mercantile on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Mercantile". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Mercantile server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Mercantile compatible with fabric and forge and neoforge?
Mercantile officially supports fabric, forge, neoforge for Minecraft 1.20.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Mercantile – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Mercantile consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Mercantile with just one click on your server.