PPLShop Fabric Client Mod

PPLShop — это клиентский Fabric-мод для Minecraft, который помогает игрокам находить и просматривать магазины, основанные на табличках (sign-based shops) возле контейнеров.

Основные функции

• Сканирование табличек: Автоматически обнаруживает таблички магазинов вокруг игрока.
• Парсинг данных: Извлекает цену, тип товара и владельца магазина.
• GUI-браузер: Удобный интерфейс для поиска и сортировки товаров в найденных магазинах.
• Система Aliases: Поддержка синонимов и русских названий предметов для корректного распознавания.

Конфигурация и Aliases

• src/client/resources/assets/pplshop/default-config/item_aliases.json: Основной файл сопоставления названий предметов и их ID.
• ParserRulesConfig: Настройки правил парсинга.
• AliasTargetMappings.java: Обработка "виртуальных" или обобщенных целей (например, minecraft:concrete, potion, trim templates), которые могут не иметь прямого соответствия в реестре предметов Minecraft.

Разработка и сборка

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

./gradlew build

Готовый артефакт (jar) будет находиться в build/libs.

Запуск клиента для разработки

./gradlew runClient

Инструкция по исправлению нераспознанных табличек

1. Проверьте отладочные файлы *-sign-unresolved-entries.txt (если включен режим отладки), чтобы увидеть, какие строки не удалось распознать.
2. Добавьте новые синонимы в item_aliases.json.
3. Если целевой ID не является стандартным предметом или требует особой обработки (например, конкретные цвета бетона через общий ID), проверьте или обновите AliasTargetMappings.java.
4. Запустите тесты, чтобы убедиться, что новые алиасы работают корректно и не ломают существующие.

Примечание

Локальные файлы отладки (logs/, debug/*.txt, *-overview.txt и т.д.) не должны попадать в репозиторий. Проверьте .gitignore перед коммитом.