Shops UI

Have you ever wanted your shops to be accessible through a UI?

Using this plugin, players can buy and sell items and vehicles in your server's shop easily!

This plugin is made for OpenMod, the successor of RocketMod. OpenMod supports all RocketMod plugins. Migrate to OpenMod now. Feel free to ask questions in the OpenMod Discord.

Easily migrate from your existing ZaupShops installation using the migration command. See more in the Migration section.

Usage

Players can simply use /shop (or /vshop to directly access the vehicle shop). See the media on this page to view an example of the UI.

At the moment, commands must be used to configure the shop. More info on configuring the shops can be found in the Commands section.

Shop whitelists/blacklists are supported. The permission you specify in the commands for setup are not exact however. If you put eaglefire as the whitelist permission, the actual permission would be ShopsUI:groups.eaglefire. The permission you specify has ShopsUI:groups. added to the front.

For more information on features and configuring this plugins, refer to the documentation site.

Migration

If you wish to migrate from ZaupShops, you can simply run the command /shop migrate.

If you used whitelists and blacklists with ZaupShop, you must also change some of your permissions. All existing permissions starting with zaupgroups. must be changed to start with ShopsUI:groups.. For example, the following permissions show their original and their migrated permissions:

• zaupgroup.epicguns -> ShopsUI:groups.epicguns
• zaupgroup.vip -> ShopsUI:groups.vip
• zaupgroup.mvp -> ShopsUI:groups.mvp

Commands

Commands for UI:

• /shop - Opens the shop UI.
• /vshop - Opens the shop UI directly to the vehicle tab.

Commands for shop management:

Basic commands:

• /shop add <buy | sell> <item> <price> - Adds the item to the shop to be bought or sold.
• /shop remove <buy | sell> <item> - Removes the buyable/sellable item from the shop.
• /vshop add <vehicle> <price> - Adds the vehicle to the shop to be bought.
• /vshop remove <vehicle> - Removes the buyable vehicle from the shop.
• /shop reload - Reloads the shops from the database.

UI-related management commands:

• /shop order <item> <order> - Sets the order of items in the shop UI.
• /vshop order <vehicles> <order> - Sets the order of vehicles in the shop UI.

Whitelist/blacklist commands:

• /shop whitelist <add | rem> <item> <permission> - Manage item shop whitelists.
• /shop blacklist <add | rem> <item> <permission> - Manage item shop blacklists.
• /vshop whitelist <add | rem> <vehicle> <permission> - Manage vehicle shop whitelists.
• /vshop blacklist <add | rem> <vehicle> <permission> - Manage vehicle shop blacklists.

The permission you specify has ShopsUI:groups. added to the front of it. abc turns into ShopsUI:groups.abc.

Alternative buy/sell commands:

• /buy <item> [amount] - Buys the item from the shop.
• /sell <item> [amount] - Sells the item to the shop.
• /vbuy <vehicle> - Buys the vehicle from the shop.

Configuration

For information on configuring this plugin, or to see the default config, refer to the documentation.

Translations

For information on the translations available for this plugin (used to change messages or UI text) refer to the documentation.

Installation

Tutorial Video: https://youtu.be/1N-3ex9rbnk

Or

1. Run the following command to install necessary libraries:

• openmod install OpenMod.EntityFrameworkCore.MySql
• openmod install SilK.Unturned.Extras
• openmod install SilK.UnturnedImages

2. Specify in your Imperial Plugins config the testing branch.

3. Add the following workshop id to your WorkshopDownloadConfig.json file - 2412328215

4. Change the connection string in your new ShopsUI/config.yaml file to allow ShopsUI to connect to your MySQL server.

Ask questions or get support in my Discord server