MMO Econ

MMO Econ

A server-side Economy & Shop mod, Designed for small to medium scale multiplayer servers!

Currently supports only Minecraft 1.21.1 NeoForge.
This mod is a NeoForge port of my original MMOEcon mod for Fabric, with a new and improved codebase.
It is completely server-side and does NOT need to be installed on any clients in order to function in multiplayer.

Features

• Manages persistent player balances server-side.
• Completely customiseable admin GUI shop.
• Player to player payments.
• Sell hand / Inventory.
• A balance Leaderboard.
• Sell Wands
• Playtime balance rewards.

Planned Features

• Player / Mob kill rewards.
• Player to Player trading / Auction house.
• Player run Chestshops.

Commands

• /bal, /money - Displays the player's balance.
• /pay <playername> <amount> - Pays money to player from your balance.
• /bal top - Displays a list of the server's richest players.
• /shop - Opens the GUI shop.
• /sell hand - Sells the currently held item, if its listed a valid sellable in the GUI shop.
• /sell inv - Sells every item in your inventory that is listed as a valid sellable in the GUI shop.
• /shop reload - Reloads MMOShop.json.

Customising the Shop

The admin GUI shop is dynamically populated by /config/mmoecon/MMOShop.json.
If you don't want to write a shop JSON file from scratch, an example one will be generated the first time the mod runs to get you started.

Example MMOShop.JSON Structure

The shop will support any modded items supported by the server its running on.

{
  "categories": [
    {
      "name": "Building Blocks",
      "representativeItem": "minecraft:grass_block",
      "items": [
        { "id": "minecraft:stone", "buyPrice": 3.0, "sellPrice": 0.3  },
        { "id": "minecraft:grass_block", "buyPrice": 1.5, "sellPrice": 0.1  }
      ]
    },
    {
      "name": "Modded Items",
      "representativeItem": "create:cogwheel",
      "items": [
        { "id": "create:cogwheel", "buyPrice": 10.0 }
      ]
    }
    {
      "name": "Custom Server-side Items",
      "representativeItem": "minecraft:emerald",
      "items": [
        { "id": "mmoecon:sell_wand", "special":"sell_wand", "buyPrice": 35000.0 }
      ]
    }
  ]
}

The Sell Wand is currently the only supported "special" item.

Category names support Minecraft's standard & (or §) color and formatting codes, so you can colour and style them however you like. For example, "name": "&6&lModded Items" renders as a bold gold "Modded Items". If you don't supply any codes, the name is shown as normal white text (no forced italics).

MMO Econ

A server-side Economy & GUI Shop mod, Designed for small to medium scale multiplayer servers!

Currently supports only Minecraft 1.21.1 NeoForge. This mod is a NeoForge port of my original MMOEcon mod for Fabric, with a new and improved codebase! It is completely server-side and does NOT need to be installed on any clients in order to function in multiplayer.

Features

• Manages persistent player balances server-side.
• Completely customiseable admin GUI shop.
• Player to player payments.
• Sell hand / Inventory.
• A balance Leaderboard.
• Sell Wands
• Playtime balance rewards.

Planned Features

• Player / Mob kill rewards.
• Player to Player trading / Auction house.
• Player run Chestshops.

Commands

• /bal, /money - Displays the player's balance.
• /pay - Pays money to player from your balance.
• /bal top - Displays a list of the server's richest players.
• /shop - Opens the GUI shop.
• /sell hand - Sells the currently held item, if its listed a valid sellable in the GUI shop.
• /sell inv - Sells every item in your inventory that is listed as a valid sellable in the GUI shop.
• /shop reload - Reloads MMOShop.json.

Customising the Shop

The admin GUI shop is dynamically populated by /config/mmoecon/MMOShop.json. If you don't want to write a shop JSON file from scratch, an example one will be generated the first time the mod runs to get you started.

Example MMOShop.JSON

The shop will support any modded items supported by the server its running on.

{
  "categories": [
    {
      "name": "Building Blocks",
      "representativeItem": "minecraft:grass_block",
      "items": [
        { "id": "minecraft:stone", "buyPrice": 3.0, "sellPrice": 0.3  },
        { "id": "minecraft:grass_block", "buyPrice": 1.5, "sellPrice": 0.1  }
      ]
    },
    {
      "name": "Modded Items",
      "representativeItem": "create:cogwheel",
      "items": [
        { "id": "create:cogwheel", "buyPrice": 10.0 }
      ]
    }
    {
      "name": "Custom Server-side Items",
      "representativeItem": "minecraft:emerald",
      "items": [
        { "id": "mmoecon:sell_wand", "special":"sell_wand", "buyPrice": 35000.0 }
      ]
    }
  ]
}

The Sell Wand is currently the only supported "special" item.

Styling Category Names

Category names support Minecraft's standard & (or §) color and formatting codes, so you can colour and style them however you like. For example, "name": "&6&lModded Items" renders as a bold gold "Modded Items". If you don't supply any codes, the name is shown as normal white text (no forced italics).