Installation Guide

Get Moto Coin running on your Fabric server in under 5 minutes.

📋 Requirements

Make sure you have the following before you start:

  • Minecraft Java Edition — version 1.21.11
  • Fabric Loader — 0.18.1 or newer
  • Fabric API — 0.141.3+1.21.11 or newer
  • Fabric Language Kotlin — 1.13.8+kotlin.2.3.0 or newer
  • Java — 21 or newer
⚠ī¸

Both Fabric API and Fabric Language Kotlin are required. The mod will crash on startup without them. Download them from Modrinth before continuing.

Minecraft 1.21.11 Fabric Loader â‰Ĩ 0.18.1 Java 21+

🔧 Step 1 — Install Fabric Loader

Skip this section if you already have Fabric installed for 1.21.11.

1
Download Fabric Installer

Go to fabricmc.net/use/installer and download the universal JAR installer.

2
Run the installer

Open the JAR, select Server tab, choose Minecraft version 1.21.11, select loader version 0.18.1 or newer, pick your server directory, click Install.

3
Accept the EULA

Open eula.txt in the server folder and set eula=true.

đŸ“Ļ Step 2 — Install Dependencies + Moto Coin

Download the required mods

Place all three JARs into your server's mods/ folder:

⚙ī¸
Fabric API

0.141.3+1.21.11 or newer
modrinth.com/mod/fabric-api

☕
Fabric Language Kotlin

1.13.8+kotlin.2.3.0 or newer
modrinth.com/mod/flk

đŸĒ™
Moto Coin

v1.0.1 for MC 1.21.11
mods.motofo20.de/motocoin

Folder structure

Your mods/ folder should look like this:

server/
├── mods/
│   ├── fabric-api-0.141.3+1.21.11.jar
│   ├── fabric-language-kotlin-1.13.8+kotlin.2.3.0.jar
│   └── moto-coin-1.0.1.jar
├── eula.txt
└── server.properties
ℹī¸

Moto Coin is a server-side mod. Clients do not need it installed — but they do need the Moto Coin resource pack if you want the custom coin texture to appear.

đŸ–Ĩī¸ Step 3 — Server Configuration

Resource pack (optional but recommended)

To display the gold coin texture, install the resource pack on your server or distribute it to players:

1
Download the resource pack

Available on the Moto Coin mod page under Downloads.

2
Host it and link in server.properties

Upload the ZIP to a file host and set resource-pack=<url> and resource-pack-required=false in server.properties.

Permissions

Admin commands require operator level 2 (default OP). No additional permission plugin is needed. Use /op <player> to grant access.

✅

No config file is needed. The mod creates default shops automatically on first start. Use /cointrader addshop in-game to add your own.

🚀 Step 4 — First Launch

1
Start the server

Run your normal startup command. Look for [moto-coin] Moto Coin initialized in the console to confirm the mod loaded.

2
Test as a player

Join the server and run /cointrader. A shop UI should open.

3
Give yourself a Moto Coin

As an OP, run:

/give @s minecraft:paper[minecraft:custom_model_data={floats:[1001.0]}] 1

The paper should show the coin texture if the resource pack is installed.

4
Add your first admin shop (optional)

Stand where you want the shop, then run /cointrader addshop "My Shop". Players can right-click to open it.

⚠ī¸

MC 1.21.10+ note: The custom_model_data component now requires map format: {floats:[1001.0]}. The old integer format =1 will throw a "Malformed 'minecraft:custom_model_data' component: Not a map" error.

❓ FAQ

The mod isn't loading / commands are unknown â–ŧ
Make sure all three JARs are in the mods/ folder: Fabric API, Fabric Language Kotlin, and Moto Coin. A missing dependency causes the mod to silently fail. Check the server log for [ERROR] lines at startup.
"Malformed 'minecraft:custom_model_data' component: Not a map" â–ŧ
This happens when using the old integer format for custom_model_data. Since MC 1.21.4, this component requires map format. Use:

/give @s minecraft:paper[minecraft:custom_model_data={floats:[1001.0]}] 1

Never use [minecraft:custom_model_data=1] on 1.21.10+.
Does the mod work with Paper/Purpur? â–ŧ
No. Moto Coin is a Fabric mod and requires a Fabric server. Paper and Purpur use a different mod loader (Bukkit/Spigot API) and are not compatible. You must run Fabric Loader 0.18.1+ as your server software.
Can players use the mod without installing anything? â–ŧ
Yes. Moto Coin runs entirely server-side. Players on vanilla clients can join and use /cointrader normally. The only optional client-side element is the resource pack for the custom coin texture.
What Fabric Loader version do I need? â–ŧ
Moto Coin requires Fabric Loader 0.18.1 or newer. Version 0.18.4 and above also work fine. The mod does not support older loaders.
Where is the data stored? â–ŧ
Shop configurations and player balances are stored in your world's data/ folder. They persist across restarts and are saved whenever a player logs out or a shop is modified.
← Back to Mod Page Fabric API ↗ Fabric Language Kotlin ↗