GUI Shop

GUI Shop

A server side mod for admin GUI shops via command

by
6.9K Downloads
fabriceconomyutility
Rent Server with this Mod

Screenshots

Buy
Sell
Shop GUI

About this Mod

GUI Shop

A fabric server-side mod to create and manage GUI shops.
They can be later opened by using 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 a supported Economy)

Commands and permissions

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

Description Command Permission
Main command /guishop automessage.main
Create a shop /guishop create <shopName> automessage.create
Delete a shop /guishop delete <shopName> automessage.delete
Add an item in a shop /guishop additem <shopName> <itemMaterial> <buyPrice> <sellPrice> <description> <nbt> <quantities> automessage.additem
Remove an item from a shop /guishop removeitem <shopName> <itemName> automessage.removeitem
Open a shop for a player /guishop open <shopName> <playerName> automessage.open
List all shops /guishop list automessage.list
List all items in a shop /guishop list <shopName> automessage.list
Force save config /guishop forcesave automessage.forcesave
Reload config file /automessage reload automessage.reload

Commands examples

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

Add item in a shop: /guishop additem "Diamond" "minecraft:diamond" 250.00 100.00 "This is a Diamond\\An expensive diamond\\Shiny" "{}" "1:10:32:64" (you can split each description line by using "\\", and you can input up to 4 quantities splitted by ":")

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

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

Configuration

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

Both items' names and descriptions support Simplified Text Format.

You can even add items from the JSON file (check JSON Example). This can be useful when your additem command would be very long, or to easily set a NBT (remember to reload the mod using /guishop reload after editing the config file)

JSON example

{
  "shops": [
    {
      "shopName": "Shop number one",
      "items": [
        {
          "name": "The boat",
          "material": "minecraft:acacia_chest_boat",
          "description": [
            "This is a nice boat",
            "Very beautiful"
          ],
          "buyPrice": 50.0,
          "sellPrice": 25.0,
          "nbt": "{}",
          "quantityList": [
            1
          ]
        },
        {
          "name": "BBQ Sword",
          "material": "minecraft:diamond_sword",
          "description": [],
          "buyPrice": 0.0,
          "sellPrice": 0.0,
          "nbt": "{Damage:0,Enchantments:[{id:\"fire_aspect\",lvl:2},{id:\"sweeping\",lvl:2}],display:{Lore:['[{\"text\":\"Crispy and tasty\",\"italic\":false}]'],Name:'[{\"text\":\"The BBQ\",\"italic\":false}]'}}",
          "quantityList": [
            1
          ]
        },
        {
          "name": "Amethyst",
          "material": "minecraft:large_amethyst_bud",
          "description": [
            "<red>Such a spectacular</red>",
            "<purple>amethyst</purple>",
            "<rainbow>SHINY</rainbow>"
          ],
          "buyPrice": 200.0,
          "sellPrice": 100.0,
          "nbt": "{}",
          "quantityList": [
            1,
            40,
            64
          ]
        }
      ]
    },
    {
      "shopName": "A second shop",
      "items": []
    }
  ]
}

Supported Economies:

Showcase

Screenshot1

Screenshot2

Screenshot3

Available Versions

GUI Shop 1.4.0+1.20.1release
MC 1.20.1fabric
April 7, 2024
GUI Shop 1.3.2+1.20.1release
MC 1.20.1fabric
March 4, 2024
GUI Shop 1.3.1+1.20.1release
MC 1.20.1fabric
December 18, 2023
GUI Shop 1.3.0+1.20.1release
MC 1.20.1, 1.20.2fabric
November 2, 2023
GUI Shop 1.2.0+1.19.2release
MC 1.19.2fabric
August 16, 2023

How to Install GUI Shop on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.2).

3

Install Mod

Open the mod browser in the dashboard and search for "GUI Shop". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.20.2, 1.20.1, 1.19.2

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

GUI Shop 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.2). You can switch loaders with one click in the panel.

Is GUI Shop compatible with fabric?

GUI Shop officially supports fabric for Minecraft 1.20.2, 1.20.1, 1.19.2. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with GUI Shop – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if GUI Shop 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.

Rent Modded Server

Install GUI Shop with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.20.21.20.11.19.2