GUI Shop

GuiShop is a Fabric server-side mod to create and manage GUI shops in Minecraft. It comes with its own economy but also integrates seamlessly with other economy providers. GuiShop is based on the works of UnsafeDodo, adapted and extended to fit my needs.

Features

Support for multiple shops

Sell as many items you want

Shop view supports pagination

Support for multiple balances

Buy and sell one or multiple items at once

Bought items appear in your cursor

Other notable features:

• Drag and drop any items from your inventory to the shop. If it can be sold, it will be sold.
• Shop items support item components (enchantments, custom names, custom model data, etc.).
  • Note: Selling (inventory -> shop) items with enchantments is not supported yet.
  • Supports multiple currencies, each item can be configured to use a different currency.
  • Supports any economy mod that implements the Common Economy API.
  • Has its own built-in economy provider that can be configured with multiple currencies and accounts.
    • These currencies can be used by other mods that use the Common Economy API.
    • Has commands to manage balances (view, send, add, remove).
    • Can simulate any real-life currency by configuring prefix, suffix, decimal places and an icon.
  • Shops can be opened through commands, allowing integration with NPC mods like Taterzens.
  • The mod supports LuckPerms for permissions.

Installation

Put the .jar file in the "mods" folder

(Requires Fabric API and (optionally) a supported Economy)

Commands and permissions

All commands can be used by admins (permission level 3) or by users/groups with the specific permission

Commands examples

Create a shop: /guishop create "Test shop""

Add item in a shop: /guishop additem "Diamond" minecraft:diamond[minecraft:enchantment_glint_override=true,minecraft:custom_name=hello] 250 100 guishop:credit "This is a Diamond\\An expensive diamond\\Shiny" (you can split each description line by using "\\")

Item components are supported in the same way as in the /give command. You can use an item generator like mcstacker or the one from Gamergeeks to generate items with components like enchantments, custom names, etc. In-game, you'll also get suggestions for item components.

The buy and sell prices are without any formatting so say you configured 2 decimal places in your config and you want to sell an item for 1.50, you would use 150 as the sell price.

Remove item from shop: /guishop removeitem "Test shop" "Diamond"

Open a shop and show it to a specific player: /guishop open "Test shop" "Steve"

You can also add items only to be bought or sold in a shop. Items with a buy price of -1 can only be sold and items with a sell price of -1 can only be bought.

Economy configuration

Guishop has a built-in optional economy provider that can be configured in the ./config/guishopeconomy.json file.

Economy provider configuration example

{
  "disabled": false,
  "database": {
    "type": "sqlite",
    "currency": "./config/guishop.sqlite"
  },
  "economy": {
    "currencies": {
      "credit": {
        "name": "Credits",
        "prefix": "$",
        "suffix": "",
        "decimalPlaces": 2,
        "icon": "minecraft:diamond"
      }
    },
    "accounts": {
      "account": {
        "name": "Account",
        "currency": "credit",
        "icon": "minecraft:diamond"
      }
    }
  },
  "command": {
    "disabled": false,
    "alias": ""
  }
}

Guishop configuration

You can find the main config file in ./config/guishop.json.

In economyProviders you can specify the economy provider you want to use. This can be an external economy mod that uses the Common Economy API or the built-in economy provider configured in guishopeconomy.json. The object is a mapping usually mod_id:currency_id to a list of account_id's. To use the build-in economy provider, prefix your configured currency with guishop:.

In shops you can define your shops and their items. Both the items' names and descriptions support Simplified Text Format. You can both use the config file and in-game commands to add items to the shop.

Just remember to:

• reload the mod using /guishop reload after editing the config file,
• save the in-game changes using /guishop forcesave to reflect them in the config file.
• not to work in both the config file and in-game at the same time.
  • If the in-game changes are saved, they will overwrite any changes made to the config file.
  • If the config file is reloaded, it will overwrite any in-game changes.
  • Be careful when making large-scale changes to the config file while the server is running as the mod will automatically save in-game changes every 30 minutes.

JSON example

{
  "economyProviders": {
    "guishop:credit": [
      "account"
    ]
  },
  "shops": [
    {
      "shopName": "Shop number one",
      "items": [
        {
          "name": "The boat",
          "itemId": "minecraft:acacia_chest_boat",
          "description": [
            "This is a nice boat",
            "Very beautiful"
          ],
          "buyPrice": 50,
          "sellPrice": 25,
          "currency": "guishop:credit",
          "componentChanges": {}
        },
        {
          "name": "Free BBQ Sword",
          "itemId": "minecraft:diamond_sword",
          "description": [],
          "buyPrice": 0,
          "sellPrice": -1,
          "currency": "guishop:credit",
          "components": {
            "minecraft:enchantment_glint_override": true,
            "minecraft:custom_name": "\"hello\""
          }
        },
        {
          "name": "Amethyst",
          "itemId": "minecraft:large_amethyst_bud",
          "description": [
            "<red>Such a spectacular</red>",
            "<purple>amethyst</purple>",
            "<rainbow>SHINY</rainbow>"
          ],
          "buyPrice": 200,
          "sellPrice": 100,
          "currency": "guishop:credit",
          "components": {}
        }
      ]
    },
    {
      "shopName": "A second shop",
      "items": []
    }
  ]
}

Supported Economies:

From 1.4.5 and onwards, the mod supports any (combination of) economy mod that uses the Common Economy API. A great example is Common Bridge, which bridges multiple economy plugins to use the Common Economy API.

GuiShop also comes with its own economy provider which can be configured in the config file. This build-in economy provider can be configured with multiple currencies and accounts. (The multi-account per currency functionality has not been properly implemented yet.)