
GUI Shop
A server side mod for admin GUI shops via command
Screenshots



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



Available Versions
How to Install GUI Shop on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.2).
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
Minecraft Versions
1.20.2, 1.20.1, 1.19.2
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install GUI Shop with just one click on your server.