MMO Econ

MMO Econ

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

Currently supports Minecraft 1.21.1 NeoForge & Fabric.
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.
• Player-to-player Auction House.

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.
• /ah, /auctionhouse - Open the Auction House GUI.
• /ah sell (price) [quantity] - List an item on the Auction House.

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.

MMO Econ

An Economy & GUI Shop mod, Designed for small to medium scale multiplayer servers & singleplayer worlds!

Currently supports Minecraft 1.21.1 NeoForge & Fabric. 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.
• Player-to-player Auction House.

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.
• /ah - Open the Auction House GUI.
• /ah sell (price) [quantity] - List an item on the Auction House.

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.