mcCustomization — гардероб и питомцы для Minecraft
Игрок примеряет одежду на персонаже со своим скином, поворачивает его и выбирает, что надеть. В комплекте 557 вещей. Среди них доспехи, головные уборы, рюкзаки, питомцы и декоративные эффекты.
Своя коллекция на сервере
Гардероб поставляется с моделями и сам раздаёт текстуры игрокам. В игровой админке можно назначить цену, поправить название вещи и сменить цвет надписей. Для собственной коллекции есть готовый пример с лентой ателье.
Что увидит игрок
Слева в примерочной стоит персонаж, справа видны полки. На каждой занятой полке указана цена. Игрок может примерить любую вещь до покупки. Синяя кепка и улитка бесплатны. Остальные 555 вещей продаются за жетоны PlayerPoints.
От примерки до покупки
Откройте /wardrobe и нажмите на нагрудник. Ведите мышью по полке, нажмите правую кнопку или пробел для выбора. Кнопка «Поворот» покажет вещь с другой стороны. Для покупки подтвердите сумму и нажмите «Надеть». После выхода вы вернётесь в исходную точку. Надетый образ увидят другие игроки с загруженными текстурами.
Полки и рынок
На торговом планшете есть «Витрина», «Продать», «Мои лоты» и «Сделки». Нажмите на лот, чтобы открыть его изображение, стоимость за экземпляр, количество и сервер получения. Из карточки можно перейти в примерочную и вернуться к той же вещи. При продаже владелец назначает свою цену.
Покупка на другом режиме
Покупатель может выбрать другой сервер сети. До первого входа на выбранный режим квитанция показывает ожидание выдачи. После получения вещь появляется в коллекции. Для сети настройте общий MySQL или PostgreSQL, разные имена узлов и список доступных режимов. Redis ускоряет обновление статусов.
Гардероб в игре
На снимках показаны костюмы, аксессуары, питомцы, обычный список вещей и торговый планшет.
Команды и права
- /wardrobe открывает вход в гардероб. Также работают /customization, /garderob и /mccustomization.
- /wardrobe open открывает примерочную, /wardrobe leave возвращает игрока назад.
- /wardrobe market открывает рынок. Для обычного меню используйте /wardrobe market plain.
- /wardrobe admin открывает настройки. Доступ получают операторы, группы owner и developer и игроки с правом mccustomization.admin. Право игрока — mccustomization.use.
Версии и дополнения
Серверная линейка — Paper 1.21.11–26.3. Для Paper 1.21.11 нужна Java 21, для проверенных выпусков 26.x — Java 25. Для платных вещей установите совместимую с сервером версию PlayerPoints. Vault передаёт группы прав, CMI учитывается при скрытии персонажа, DialogEngine позволяет открыть выбор категорий из другого игрового меню. При наличии ViaVersion плагин учитывает исходную версию клиента.
Установка и первый вход
Распакуйте ZIP, поместите mcCustomization в папку plugins и запустите сервер. Мир Customization и локальная база H2 создаются автоматически. Для доступа к текстурам снаружи настройте доступный игрокам порт или адрес раздачи в pack.public-url. Полная примерочная доступна с клиента 1.21.11. Клиенты 1.21.4–1.21.10 получают упрощённый интерфейс и русскую подсказку об обновлении. На более ранних клиентах вход закрыт. В архиве INSTALL.txt есть пример подключения своей коллекции и настройки сети.
Настройки по умолчанию
YAML:
# Название узла должно быть уникальным в сети. Для одиночного сервера оставьте local.
server-id: local
# Мир для примерки. Для нового мира укажите свободное имя.
world: Customization
network:
# Режимы, между которыми можно выставлять лоты и получать покупки. self означает этот сервер.
allowed-servers: 'self'
# Для нескольких режимов укажите общий MySQL или PostgreSQL и разные server-id.
# Имя переменной окружения с адресом redis:// или rediss://. Пустое поле включает опрос SQL.
redis-url-env: ''
# Все серверы одного гардероба используют один канал.
redis-channel: 'mccustomization.updates'
appearance:
# Цвет заголовков, кнопок и подтверждения покупки в формате #RRGGBB.
accent: '#E3BE83'
# Цвет выбранной вещи, подсказок и отметки владения.
secondary: '#83CFC1'
# Фон подписей на панели гардероба.
background: '#29222E'
# Цвет цены под миниатюрой.
price: '#FFF2C2'
# Непрозрачная плашка под ценой каждой вещи.
price-background: '#12111A'
# Заголовок при входе в примерочную и в окне выбора категории.
title: 'Гардероб'
# Подсказка над сценой во время примерки.
bossbar: 'Выберите образ на панели справа'
# Частота обновления позиций питомцев и навесных моделей, в тиках.
tick-interval: 3
client:
# До 1.21.4 доступ закрыт. На 1.21.4–1.21.10 игроку предлагается обновиться.
below-minimum: 'Для гардероба нужен Minecraft 1.21.4 или новее. Рекомендуем 1.21.11 и выше.'
below-recommended: 'Обновитесь до Minecraft 1.21.11 или новее, чтобы видеть все модели гардероба.'
pack:
# Встроенная раздача обслуживает только ZIP этого плагина.
bind: '0.0.0.0'
# 0 выбирает свободный порт. Для публичного сервера укажите открытый порт.
port: 0
# При работе за прокси укажите внешний адрес пакета. Подстановка {sha1} доступна.
public-url: ''
storage:
# h2, mysql или postgresql. H2 предназначен для одного сервера.
type: h2
# Адрес MySQL или PostgreSQL. H2 сохраняет данные в папке плагина.
host: '127.0.0.1'
# Порт базы. Обычно 3306 для MySQL и 5432 для PostgreSQL.
port: 3306
# Имя существующей базы, общей для всех режимов сети.
database: 'wardrobe'
# Учётная запись базы с доступом к таблицам гардероба.
user: 'wardrobe'
# Пароль читается из переменной окружения сервера.
password-env: 'MCCUSTOMIZATION_DB_PASSWORD'
# Максимум одновременных соединений с базой для этого режима.
pool-size: 5