MMXX.PLUS BossShopPro Configurator Best shop 1.16.x - 1.18.x 2.1.1 release

This is the best BossShopPro configuration on the market | BossShopPro| MMXX.PLUS
BossShopPro3334.png

WIKI English
It might be difficult to set up a shop, especially a complex and multyfunctional one. So we will thoroughly go through every setup stage here.
Configuration XLSX file contains 8 sheets:

General, Shop, Value: these three are for the shop itself.
Decor, Time_Decor, API, System: these four contain advanced technical settings.
Copy: the tab which you get the result config on.
000.png

General
On General sheet there are 10 tables that you use for general shop setup.
001.png

Language selection - it basically is. Right now there're only English and Russian available.

Server folder path - the path to your Minecraft server root directory. All mod-related dirs are created automatically!

Command - the postfix of the command that's used to open the store (after "/bossshoppro mmxx_shop_", usually the shop name).
Example: /bossshoppro mmxx_shop_woodcutter

Name of shop - The name of the merchant.
Supports color aliases (see section 9)

Product updates from - the stock update mode.

RealTime - the stock will be updated based on the real time (minutes, hours)
GameTime - the stock will be updated based on the ingame time (ticks)
Number of updates - number of updates. Set to 0 to disable stock updates.
RealTime limit: 72 (the fastest the updates may occur is once per 20 minutes).
GameTime limit: 24 (the fastest the updates may occur is once per 1000 ticks).

Loyalty name - The name of the indicator of how loyal the trader is to the client.
Supports color aliases (see section 9)

Number of loyalty - Loyalty levels.

0 - disables loyalty variation;
3 - loyalty rises only;
5 - loyalty rises only;
3x2 - loyalty may rise and fall;
5x2 - loyalty may rise and fall.
Cheat loyalty - Cheat loyalty - the lowest one. It's designed as a way to punish misbehaving players, so that they'd have the highest buy prices and lowest sell prices.

Loyalty type - The way the loyalty is calculated.

General - buy/sell coefficients are the same for all goods.
Custom - buy/sell coefficients are specified for every item.
Rounding prices - Price rounding (number of decimals).

Merchant background - Store background ID. There are 16 premade backgrounds.
Example: 1 - classic background; 2 - black background.

Merchant avatar - Store avatar ID. There are 64 premade avatars.
May as well be replaced with 12 avatars from Origin Realms project - those are included in the archive (they also may be downloaded from the server).
002.png


Loyalty level
- permissions to achieve the loyalty level.
Example: mmxx.trade.loyalty.1
mmxx.trade. - the essential mmxx shop prefix.
loyalty.1 - changeable permission name.

Privilege - permissions to trade privileged types of goods, as in some sort of vip/premium goods categories.
Example: mmxx.trade.privilege.1
mmxx.trade. - the essential mmxx shop prefix.
privilege.1 - changeable permission name.
003.png

Privilege - The message that's displayed when a player lacks the privilege permission to buy an item.

Price - The message with buy/sell price info.

Click - hints about clicking on an item to buy/sell.

Not enough currency - displayed when a player has insufficient funds.

Shift click - hints about clicking on an item to buy/sell a stack of it.

Currency required - insufficient funds appendix (not recommended)
004.png


The intervals your shop is working at are marked green. You can change the interval time borders and the number of intervals. Intervals must follow each other in time order, yet time gaps are allowed so you can set the interval in which there are no goods available.
Note:
Each interval may contain 6 trade items at most.
First interval has to start not sooner than 0:00 (or 0 ticks) and the last one has to end no later than 23:59 (or 23999 ticks). Thus, if you want to sell the same set of goods overnight, you'll need to set two intervals: one before the midnight and another starting at 0:00.

RealTime - Shop updates depend on the real time set on the server machine.

GameTime - Shop updates depend on the ingame time (ticks).
005.png

All active characters that may be used as loyalty symbols are marked green.
0: Left - Standatd loyalty Right - Cheat loyalty.
1: Left - Positive loyalty Right - Negative loyalty.
2,3,4,5 are positioned in the same order.

If you don't like the default character, you can replace it with a char or a combonation of characters that you like and edit it in the resourcepack if needed.
006.png


Here you can set how buy/sell price coefficients are adjusted for all goods depenging on Loyalty level.
Note that every further discount/extra is applied to a previous value, not the initial price.
007.png


You could either use one of premade backgrounds, or add your custom background. Two images of a single background are highlighted green. The image on the right is the bg texture of the shop, and the image on the left is player's inventory texture.
008.png


You could either use one of premade avatars, or add your custom avatar.
The configurator is supplied with 12 avatars from Origin Realms project, which may be easily replaced in resourcepack (those avatars are already adopted to work with this mod).
009.png

You may add your own color aliases!
Just put the RBG value of the color you want (in hex format) into one of 50 cells here, so then you'll be able to use such aliases wherever they're supported!
For example, if you put [001] into your shop name, then it'll have the color of §x§4§d§2§e§1§1
010.png

The point of this section is to have an ability to override CustomModelData of goods buttons and empty cells.
It is not recommended to edit this section unless you're absolutely sure you know what you're doing.

Default - standard shop icons: (→) for goods available to trade and (❌) for unavailable ones.

No pointer - No merchandise available.

Profile - Empty cells for profile creation.

1,2,3,4,5,6,7,8,9,10 - currently are same as Default.
Shop
The Shop sheet consists of 432 tables: for 6 shop's item slots for up to 72 stock updates.

011.png

For clarity of explanation, we'll divide the table into three parts:

012.png

- index of stock update interval.

ON / OFF - Whether the position is active.
ON - active; OFF - inactive (the position won't be even added to the output config file).

stack - whether the stack-buy (Shift+click) is available for this position.
true - a player can stack-buy this item; false - one cannot just buy a stack using Shift+click.

price - position price.

privilege - The privilege ID (index in -5 to 5, depends on the "Number of Loyalty" setting).

Hex - Position item color (for leather armor and etc.)
Supports color aliases.

type - Displayed item ID. The configuration tool already has all 1365 item IDs of 1.18, so you can choose them from a dropdown list.

012.1.png

custommodeldata - Custom model ID, works in 1.14+

name - Position name. "Type" field's item name by default.
Supports color aliases.

buy / sell - Whether the position is for player to buy or to sell.

durability - Item durability level (for armor, weapons and tools).

amount - Amount that will be bought/sold in a single transaction (in a single click).

RewardType - What the player will get (as purchased good or as a reward for selling)
Valid reward types:
1. item - the item in "type" field
2. permission - some permission (up to 5 permissions per 1 purchase)
3. command - command execution (up to 5 commands per 1 purchase)

May contain variables:
1) [reward] - position's price with loyalty coefficient applied;
2) [amount] - position's amount.
4. money - money
5. points - points
6. exp - experience

012.2.png

PriceType - What the player will spend (as a price for purchase, or what item will be sold)
Valid price types:
1. item - the item in "type" field
2. money - money
3. points - points
4. exp - experience
5. PlaceholderAPI - spend "placeholder" using the command (the next field in the table). Here you put the ID of the PlaceholderAPI that you want to use. PlaceholderAPIs are set up on the Value sheet.

Corresponding command may contain variables:
1) [reward] - position's price with loyalty coefficient applied;
2) [amount] - position's amount.
012.3.png

lore - Position description (up to 30 lines).
Supports color aliases.
013.png

enchantment - Enchantments applied to the item (up to 20 enchantments per position).
For every enchantment:
enchantment N - Enchantment name;
lvl - Enchantment level.

potioneffect - Potion effects (up to 10 effects per potion position).
For every effect:
potion name - Potion effect name;
lvl - Potion effect level;
time in seconds - Effect duration.

potion - Arrow potion effect.
Options:
potion name - Potion effect name;
extended? - Whether the effect is extended;
upgraded? - Whether it is upgraded.

check custommodeldata - whether to check the customModelData ID of player's item that's used as PriceType.

check name - whether to check the custom name of player's item that's used as PriceType.

check lore - whether to check the custom lore of player's item that's used as PriceType.

head - Custom head.
Options:
playerhead - nickname of a player whose head should be used;
customskull - custom head ID, like those: https://minecraft-heads.com/custom-heads

unbreakable - Whether bought tools / armour / weapons are unbreakable.

hideflags - Minecraft flags to hide item attributes.
014.png

Here you can set custom loyalty prices for every position (works when Loyalty type is set to Custom in GENERAL settings.
Value
This sheet has 13 tables on it. They are all typical, so we'll take a detailed look only at one of them.
015.png
016.png
017.png

There are 10 of such tables, thus you can add up to ten custom currencies to your shop.
018.png

Placeholder - PlaceholderAPI ID that's used in PlaceholderAPI parameter in position's PriceType settings

type - ID of an item that is displayed in the shop to represent this currency.

icon - currency symbol that will be displayed in chat.

custommodeldata - custom model data ID of an item to display to represent this currency in the shop.

name - currency name, may be different for every currency unit (like Dollars/Cents, Gold/Silver/Copper, etc.).
Supports color aliases.
Copy
This sheet is where you get the compiled configuration file.
Here we've got the settings of our shop prepared to be compiled into a file.
020.png
To get your shop ready you'll neen to follow the next 4 (thirteen) steps.
1. Prepare the text for file.
2. Creating a file.
3. Repeat (1) and (2) five times more.
4. Move the result to the server.

Since Microsoft Excel has troubles with copying double quotes, we should use some extra help. For me, the easiest way is to copy the content of the first column of the Copy sheet into Microsoft Word, and afterwards copy it again in the Command Line (cmd.exe).
So as we press Enter, the 1/6 of the shop will be generated.
Then, we proceed in the same manner with the other five columns of the Copy sheet.

The config will be generated in the Server folder path dir, so if you've set up the General settings properly, you don't need to move anything afterwards.

Though if you have set some other dir as the server path, then you should copy the configuration file into your server directory.

And that's it!

Decor, Time_Decor, API, System - Those are WIP and system sheets, you shouldn't touch them for now (or ever)

WIKI Russian
Настройка магазина дело тяжелое особенно если он имеет множество функций. Всё рассмотрим по порядку! Файл состоит из 8 вкладок:
3 вкладки для настройки самого магазина. (General, Shop, Value)
4 вкладки технические. (Decor, Time_Decor, API, System)
1 вкладка для получения результата. (Copy)
000.png


General
Данный раздел состоит из 10 таблиц для общей настройки магазина.
001.png


Language selection - Выбор языка. На данный момент можно выбрать между Английским и Русским языком.

Server folder path - Путь к папке сервера. Все остальные папки конфигуратор создаст сам!

Command - Продолжение команды для вызова меню магазина.
Пример: /bossshoppro mmxx_shop_woodcutter

Name of shop - Название магазина. А если точнее, то имя продавца.
Данный раздел поддерживает RGB сокращения. (Более подробно ниже.)

Product updates from - Выбор типа обновлений товаров.

RealTime - Обновления привязанное к реальному времени. (часы, минуты)
GameTime - Обновления привязанные к игровому времени. (тики)
Number of updates - количество обновлений. Если вам не нужно обновлять товары в магазине просто ставите 0.
Ограничение для RealTime = 72, А это значит самое частое обновление может происходить раз в 20 минут.
Ограничение для GameTime = 24, А это значит самое частое обновление может происходить раз в 1000 тиков.

Loyalty name - Название лояльности. Изначально это подразумевалось как лояльность торговца к покупателю, но вы можете переименовать как угодно.
Данный раздел поддерживает RGB сокращения. (Более подробно ниже.)

Number of loyalty - Количество лояльностей.

0 - Отключает этот раздел;
3 - Лояльность может только расти;
5 - Лояльность может только расти;
3x2 - Лояльность растет и уменьшается;
5x2 - Лояльность растет и уменьшается.
Cheat loyalty - Читерская лояльность. Самая низкая из всех. Она создана для того, чтобы провинившемуся игроку можно было ограничить торговлю.
У этой лояльности самые большие цены на покупку и самые низкие на продажу!

Loyalty type - Форма подсчета лояльности. Может быть General / Custom.

General - Общая настройка скидок и наценок.
Custom - Для каждого товара настраивается отдельно в своей таблице.
Rounding prices - Округление цен. Количество знаков после запятой. Нужно для определения цельности первой переменой после скидки.

Merchant background - Бэкграунд/Фон магазина. Выбирается уже из 16 заготовленных фонов.
Пример: 1 - Классический фон; 2 - Чёрный фон.

Merchant avatar - Аватар магазина. Выбирается уже из 64 аватарок с номерами.
Можно заменить на 12 аватаров с проекта origin realms. Файлы прилагаются в архиве. (Так же можно скачать с их сервера)
002.png


Loyalty level
- Разрешения для получения той или иной лояльности.

Пример уже готового права: mmxx.trade.loyalty.1
mmxx.trade. - Незаменимая
часть прав.

Privilege - Разрешения для получения доступа к элитным товарам, таким как vip, premium и т.д.

Пример уже готового права: mmxx.trade.privilege.1
mmxx.trade. - Незаменимая часть прав.
003.png

Privilege - Сообщение если товар может купить только привилегированный покупатель.

Price - Сообщение о цене покупки или продажи товара.

Click - Сообщение нажатия на товар при покупке или продаже.

Not enough currency - Сообщение если недостаточно средств для выполнения операции.

Shift click - Сообщение для покупки стака предметов, через Shift.

Currency required - Вставка о недостатке средств. (Не рекомендуем использовать)
004.png


Зеленым помечены все обновления по которым будет работать магазин. Вы можете изменить время интервалов и их количество. Время может быть указано любое, но по порядку. (возможны временные разрывы - позволяет создавать время в которое не будет товаров в магазине.)
Примечание:
В каждый из этих интервалов можно вставить не более 6 товаров.
Время всегда должно начинаться с 0:00 или 0 (для игрового обновления) и заканчиваться до 23:59 или 23999 (для игрового обновления), если вы хотите сделать один и тот же товар пересекающий полночь, вам необходимо создать 2 интервала которые будут ограничены этими рамками времени.

RealTime - Обновление магазина происходит от стоящего времени на компьютере на котором находится сервер.

GameTime - Обновления магазина происходят от игрового времени.
005.png

Зеленым подсвечиваются с все активные символы которые отвечают за символ лояльности.
0: Слева - Стандартная лояльность. Справа - Читерская лояльность.
1: Слева - Положительная Справа - Отрицательная лояльность.
2,3,4,5 - Расположены по тому же принципу.

Если вам не подходит символ который стоит по стандарту, вы можете его заменить здесь на свой символ или сочетание символов или отредактировать в ресурс паке.
006.png


В данном разделе вы можете изменить общую скидку на покупку и наценку на продажу в зависимости от лояльности игрока.

Изменение цен происходит в процентном соотношение от предыдущей лояльности.
007.png


Здесь можно заменить фон магазина на свой или использовать 1 из имеющихся. Зеленым подсвечиваются две картинки одного фона. Правая картинка - верх магазина, левая картинка - инвентарь игрока.
008.png


Здесь можно заменить аватарку торговца на свою или использовать 1 из имеющихся. Зеленым подсвечивается аватарка.
В комплекте с конфигуратором идет 12 аватарок с проекта origin realms, их можно просто заменить в ресурс паке.
Всё адаптировано!
009.png

Вы можете сделать сокращение для цветовой гамы!
Просто запишите в одну из пятидесяти ячеек цвет в формате HEX и вставляйте его сокращение во все переменные, где это возможно!
Просто и удобно!
Пример: Вставляя в название магазина переменную [001] вы будете получать цвет §x§4§d§2§e§1§1
010.png

Этот раздел создан для возможности замены CustomModelData у кнопок товаров и пустых ячеек.
НЕ РЕКОМЕНДУЕТСЯ РЕДАКТИРОВАТЬ! (но это возможно на ваш страх и риск)

Default - стрелки стандартного магазина, когда можно купить товар(→) и когда нельзя(❌).

No pointer - Отвечает за отсутствие товара в магазине. (Возможно заменить на пустую планку.)

Profile - Пустые ячейки для создания профиля.

1,2,3,4,5,6,7,8,9,10 - Такие же стрелки как и в Default.
Shop
Сам магазин состоит из 432 одинаковых таблиц, которые отвечают в свою очередь за 6 слотов магазина с возможностью настроить до 72 обновлений!
011.png
Для объяснения и наглядности будет приведена 1 таблица разбитая на 3 части:
012.png

- порядковый номер обновления магазина.

ON / OFF - Включен ли товар на продажу или нет.
ON - включен; OFF - выключен, этого товара не будет после создания конфига.

stack - Можно ли купить предмет стаком через Shift или нет.
true - можно; false - нельзя.

price - цена товара.


privilege - номер привилегии по порядку которая может купить этот товар. Настраивается в разделе GENERAL.

Hex - цвет товара. Работает с кожаной браней и зельями.
Поддерживает сокращенные переменные HEX.

type - ID предмета. Полный список предметов 1.18 сохранен в конфигураторе, а это все 1365 предметов! Можно вводить самим или выбирать из списка.
012.1.png

buy / sell - Будет происходить покупка или продаже предмета. Меняет положение товаров относительно стрелки.

RewardType - Товар который мы получим. В независимости от того покупаем или продаем.
Получить можем:
1. item - предмет для которого мы делаем описание;
2. permission - права на что-либо (до 5 разрешений за 1 покупку);
3. command - выдача предмета или чего-либо командой (до 5 команд за 1 покупку);
Поддерживает переменные для замены:
1. [reward] - заменяется на цену товар из price с учетом лояльности!
2. [amount] - заменяется на количество товаров из amount
4. money - выдача денег;
5. points - выдача - поинтов;
6. exp - выдача опыта.
Этот раздел настраиваться в этих 3 столбцах.
012.2.png

PriceType - Товар который мы тратим. В независимости от того покупаем или продаем.
Потратить можем:
1. item - предмет для которого мы делаем описание;
2. money - потратить деньги.
3. points - потратить поинты.
4. exp - потратить опыт.
5. PlaceholderAPI - потратить placeholder при помощи команды! Здесь выбирается только его номер и команда для снятия какой-то величины. Настраиваться в разделе VALUE
Поддерживает переменные для замены:
1. [reward] - заменяется на цену товар из price с учетом лояльности!
2. [amount] - заменяется на количество товаров из amount
Этот раздел настраиваться в этих 3 столбцах.
012.3.png

custommodeldata - Кастомное ID работает с версии 1.14+

durability - Прочность предмета. Применяется для брони и инструментов.

name - Название предмета.
Поддерживает сокращенные переменные HEX.

amount - Количество предметов для разовой покупки.

lore - Описание предмета до 30 строк!
Поддерживает сокращенные переменные HEX.
013.png

enchantment - Список зачарований предмета. До 20 чар!
Настраивается:
enchantment - название зачарования;
lvl - уровень;

potioneffect - Эффект зелий. До 10 эффектов на зелье!
Настраивается:
potion name - название эффекта;
lvl - уровень;
time in seconds - время в секундах.

potion - Эффект зелья на стреле.
Настраивается:
potion name - название эффекта;
extended? - расширение;
upgraded? - улучшена или нет.

check custommodeldata - проверка кастомного ID при покупке за предмет.

check name - проверка кастомного названия при покупке за предмет.

check lore - проверка кастомного описания при покупке за предмет.

head - Установка кастомной головы.
Настраивается:
playerhead - никнейм игрока;
customskull - кастомное ID головы. Удобно использовать сайт(более 40.000 голов):
https://minecraft-heads.com/custom-heads

unbreakable - Нерушимость инструментов.

hideflags - флаги которые скрывают описание предмета.
014.png

В этом разделе можно настроить только цены, если включены кастомные лаяльности Loyalty type:Custom в разделе GENERAL.
Value
Этот раздел состоит из 13 таблиц. Они очень похожи так, что разберем на примере одной из кастомных валют.
015.png
016.png
017.png
Таких табличек 10! А это значит, что и 10 любых новых валют можно добавить в 1 магазин!
018.png

Placeholder - сюда записывается числовой PlaceholderAPI и он будет его использовать как валюту для магазина.

type - ID предмета который будет вместо предмета для показа валюты.

icon - символ валюты для чата.

custommodeldata - кастомный ID для показа валюты.

name - название валюты, можно менять для каждого уровня валюты.
Поддерживает сокращенные переменные HEX.
Copy
Это самый главный раздел, но после самой настройки xD
Здесь находятся уже готовый магазин! Его остается только скомпилировать в файл.
020.png
Рабочий магазин получается в четыре этапа.
1. Подготовка текста для создания файла.
2. Создание файла.
3. Повторение 1 и 2 этапа еще 5 раз.
4. Вставка получившегося файла на сервер.

Первый этап мудреный из-за того, что Microsoft Excel не может копировать нормально двойные кавычки.
Для этого берем полностью один столбец и вставляем его в Microsoft Word и копируем его уже оттуда для дальнейшей работы. (Таким образом мы избежим ошибок в конечном результате.)

Второй этап заключается во вставке всего столбца из Microsoft Word в командную строку CMD.exe и ждем пока создастся 1/6 часть магазина.

Третьем этапом повторяем первую и вторую операцию еще 5 раз для получения полного файла.

В четвертом этапе просто переносим готовый файл на сервер и перезапускаем плагин. ГОТОВО!

Decor - Декор. Не редактируется.
Time_Decor - Временный декор. Не редактируется.
API - Список привязок. Не редактируется.
System - Технический раздел для пересчета формул. Не редактируется.
  • 2.0.0 beta.png
    2.0.0 beta.png
    52.8 KB · Views: 191
  • Bossshop2.png
    Bossshop2.png
    168.1 KB · Views: 110
  • BossShopPro3334.png
    BossShopPro3334.png
    49.5 KB · Views: 384
  • 001.png
    001.png
    44 KB · Views: 112
  • 002.png
    002.png
    33 KB · Views: 109
  • 003.png
    003.png
    33.7 KB · Views: 89
  • 004.png
    004.png
    65.6 KB · Views: 84
  • 005.png
    005.png
    6.6 KB · Views: 98
  • 006.png
    006.png
    16.5 KB · Views: 95
  • 007.png
    007.png
    7.6 KB · Views: 90
  • 008.png
    008.png
    24.6 KB · Views: 87
  • 009.png
    009.png
    47.8 KB · Views: 67
  • 010.png
    010.png
    12.8 KB · Views: 86
  • 011.png
    011.png
    92.5 KB · Views: 80
  • 012.png
    012.png
    24.5 KB · Views: 79
  • 012.1.png
    012.1.png
    7.2 KB · Views: 53
  • 012.2.png
    012.2.png
    4.3 KB · Views: 74
  • 012.3.png
    012.3.png
    4.1 KB · Views: 75
  • 013.png
    013.png
    26.2 KB · Views: 63
  • 000.png
    000.png
    5.1 KB · Views: 67
  • 014.png
    014.png
    34.5 KB · Views: 59
  • 015.png
    015.png
    13.6 KB · Views: 57
  • 016.png
    016.png
    12.6 KB · Views: 38
  • 017.png
    017.png
    12.1 KB · Views: 53
  • 018.png
    018.png
    16.2 KB · Views: 36
  • 020.png
    020.png
    160.2 KB · Views: 49

Latest updates

  1. Minor file and texture fixes

    1. Fixed blocking of the main file. 2. Fixed texture of arrows. 3. Added textures...
  2. Upgrade to version 1.18

    Added support for items from version 1.17.X and 1.18.X Everything is tested!
  3. Changing the textures of the pack and connecting the starting design of currencies

    Changing the textures of the pack and connecting the starting design of currencies: 1. At the...

Latest reviews

Very interesting configuration settings, you can ask the author if you don’t understand, he will patiently teach you...
Good UI, but its limited. you can only have a wood merchant. nothing more, and i don't know why there is a renewal but the updates isn't enough to have a renewal.
He only update for bug fix ? and i think the updates only mean to up this resources in mcm.

Nothing more nothing less, not worth it for 7USD + renewal.
The only good is that UI.....
Kostya_1313
Kostya_1313
Thanks for your feedback, now I'm busy creating something more than just an interface with a store .. If everything works out, then this store will turn into something big.

Author

Author
Kostya_1313
Downloads
12
Type
Digital product
License duration
6 Months
Price
15.00 USD
Renewal price
5.00 USD
Views
1,575
First release
Last update
Rating
4.00 star(s) 2 ratings
Top
You need to upgrade!
Our dark style is reserved for our Premium members. Upgrade here.