TradeChest

Мод TradeChest

Мод для Minecraft на Fabric, который добавляет сундуки автоматической торговли с сеткой инвентаря 9x5. Настройте магазины в стиле торговых автоматов, где покупатели кладут предметы для покупки и автоматически получают предметы для продажи взамен.

Возможности

• Система автоматической торговли: Кладите предметы для покупки — предметы для продажи автоматически доставляются в зону получения
• Сетка инвентаря 9x5: Отдельные области для предметов покупки, получения, настройки, сбора владельцем и хранения товаров на продажу
• Система владения: Защитите свои торговые точки с помощью владения по имени пользователя
• Нельзя использовать как обычный сундук: Сундуки торговли можно использовать только после правильной настройки
• Перемещение предметов: Предметы покупки автоматически перемещаются в область сбора владельца после сделок

Требования

• Minecraft 1.20.1
• Fabric Loader 0.15.7+
• Fabric API
• Java 17 или выше

Установка

Для игроков

1. Установите Fabric Loader

   • Скачайте и запустите Fabric Installer
   • Выберите Minecraft 1.20.1 и установите Fabric

2. Скачайте зависимости

   • Скачайте Fabric API для 1.20.1
   • Поместите JAR-файл Fabric API в папку .minecraft/mods

3. Установите мод TradeChest

   • Скачайте последний JAR-файл мода TradeChest
   • Поместите его в папку .minecraft/mods

4. Запустите игру

   • Запустите Minecraft с профилем Fabric
   • Предмет «Сундук торговли» будет доступен во вкладке «Функциональные блоки» в креативе

Для разработчиков

1. Клонируйте репозиторий

   git clone https://github.com/rodortega/mc-tradechest.git
   cd mc-tradechest

2. Соберите из исходников

   ./gradlew build

3. Запустите в режиме разработки

   ./gradlew runClient

Как использовать

Крафт

Скрафтите сундук торговли по этому рецепту:

[Доски] [Доски] [Доски]
[Доски] [Бумага] [Доски]
[Доски] [Доски] [Доски]

Базовая настройка

1. Поставьте сундук торговли — его нельзя использовать, пока не настроен владелец

2. Установите владельца (слот 18):

   • Переименуйте бумагу на наковальне, указав ваше точное имя пользователя
   • Поместите её в слот 18 (первый слот третьего ряда)
   • Теперь вы владелец и можете управлять сундуком

3. Настройте требования покупки (слот 19):

   • Переименуйте бумагу: 10 minecraft:iron_ingot
   • Поместите в слот 19
   • Это определяет, что должны предоставить покупатели

4. Настройте предметы продажи (слот 20):

   • Переименуйте бумагу: 5 minecraft:diamond
   • Поместите в слот 20
   • Это определяет, что получат покупатели

5. Заполните товары на продажу:

   • Поместите алмазы в нижний ряд (слоты 36-44)
   • Туда можно класть только настроенный тип предмета продажи

6. Готово к торговле:

   • Покупатели кладут железные слитки в верхний ряд (слоты 0-8)
   • Алмазы автоматически появляются в зоне получения (слоты 9-17)
   • Железные слитки перемещаются в вашу область сбора (слоты 27-35)

Сетка инвентаря (9x5)

Ряд 1: [Область ввода предметов покупки — покупатели кладут сюда предметы покупки]  (Слоты 0-8)
Ряд 2: [Зона получения — сюда автоматически попадают обменянные предметы]           (Слоты 9-17)
Ряд 3: [ВЛАДЕЛЕЦ] [ПОКУПКА] [ПРОДАЖА] [----ЗАБЛОКИРОВАННАЯ ЗОНА НАСТРОЙКИ----]      (Слоты 18-26)
Ряд 4: [Сбор владельцем — сюда попадают предметы покупки после сделок]             (Слоты 27-35)
Ряд 5: [Хранилище товаров на продажу — владелец складывает сюда товары]            (Слоты 36-44)

Как работает торговля

1. Действие покупателя: Кладёт 10 железных слитков в ряд 1
2. Автоматическая обработка: Система обнаруживает завершённую сделку

3. Перемещение предметов:

   • 5 алмазов перемещаются из ряда 5 в ряд 2 (зона получения)
   • 10 железных слитков перемещаются из ряда 1 в ряд 4 (сбор владельцем)
4. Получение покупателем: Покупатель забирает алмазы из ряда 2
5. Обработка излишков: Если покупатель положил 15 железа, 5 излишка остаются в ряду 1 для получения

Пример: автоматический магазин алмазов

1. Этап настройки:

   • Переименуйте бумаги: ВашеИмя, 10 minecraft:iron_ingot, 5 minecraft:diamond
   • Поместите бумаги в слоты 18, 19, 20 соответственно
   • Заполните 64 алмаза в нижний ряд (слоты 36-44)

2. Сделка покупателя:

   • Покупатель кладёт 20 железных слитков в верхний ряд
   • Система автоматически обрабатывает 2 сделки (20 ÷ 10 = 2)
   • 10 алмазов появляются в зоне получения (5 × 2 = 10)
   • 20 железных слитков перемещаются в область сбора владельцем
   • Покупатель забирает 10 алмазов из зоны получения

3. Выгода владельца:

   • Забирайте 20 железных слитков из ряда 4 в любое время
   • Пополняйте алмазы в ряду 5 по мере необходимости
   • Ручное вмешательство не требуется

Права доступа

Форматы бумаг

• Бумага владельца: Просто ваше точное имя пользователя (например, Steve)
• Бумага покупки: [количество] [item_id] (например, 10 minecraft:iron_ingot)
• Бумага продажи: [количество] [item_id] (например, 5 minecraft:diamond)

Решение проблем

• Сундук вообще не используется: Сначала нужно поместить бумагу владельца в слот 18

• Не удаётся убрать бумагу владельца: Убедитесь, что имя на бумаге точно совпадает с вашим игровым ником
• Не удаётся положить бумаги покупки/продажи: Вы должны быть владельцем (ваша именная бумага должна лежать в слоте 18)
• Торговля не работает: Убедитесь, что бумаги покупки и продажи настроены в слотах 19-20
• Не удаётся положить предметы в нижний ряд: В слотах 36-44 разрешён только настроенный тип предмета для продажи
• Предметы не перемещаются автоматически: Проверьте, что у вас есть запас предметов для продажи и зона подбора не заполнена

Сборка

Этот мод использует инструментарий Fabric:

# Очистка и сборка
./gradlew clean build

# Запуск клиента для тестирования
./gradlew runClient

# Генерация jar с исходниками
./gradlew sourcesJar

Разработка

Структура проекта

• src/main/java/com/rodmod/tradechest/ - Основной код мода
• src/main/resources/ - Ресурсы и файлы данных
• build.gradle - Конфигурация сборки
• gradle.properties - Свойства проекта

Ключевые классы

• RodMod - Главный инициализатор мода
• TradeChestBlock - Реализация блока
• TradeChestBlockEntity - Блок-сущность с логикой инвентаря
• TradeChestMenu - Меню контейнера для GUI
• TradeChestSlot - Кастомный слот с ограничениями на размещение

Лицензия

Этот мод доступен под лицензией CC0. Не стесняйтесь учиться на нём и включать его в свои проекты. Купите мне кофе!