RU

RefontCrafts — документация

RefontCrafts — GUI-плагин для кастомных крафтов в верстаке и наковальне на Minecraft-серверах.

Плагин подходит для survival, RPG, RP, economy и custom-серверов, где нужны собственные рецепты, права доступа и поддержка кастомных предметов.

Возможности

• GUI-редактор рецептов верстака.
• GUI-редактор рецептов наковальни.
• Поддержка строгой выкладки 3x3 и бесформенных рецептов.
• Просмотр сохранённых рецептов игроками без OP.
• Поддержка кастомных предметов, зелий, CustomModelData, названий, лора, чар и PDC-данных.
• Мягкое сравнение предметов при exact_meta_match: false.
• Строгий порядок предметов в наковальне.
• Автообновление результата крафта при ЛКМ, ПКМ и drag-раскладке.
• Preview и выдача результата верстака стаками до 126.
• SQLite по умолчанию, MySQL опционально.

Требования

Параметр	Значение
Ядро	Bukkit / Spigot / Paper
Java	Java 8+ для старых серверов; для новых версий Minecraft используй актуальную Java
База данных	SQLite или MySQL
Команда	/rcrafts
Алиасы	/rc, /refontcrafts

Установка

1. Скачай последнюю версию .jar из Releases или Modrinth.
2. Закинь файл в папку plugins/.
3. Перезапусти сервер.
4. Открой главное меню командой:

/rcrafts

После первого запуска плагин создаст конфиг и базу данных.

Команды

Команда	Описание
/rcrafts	Главное меню
/rcrafts view workbench [page]	Просмотр рецептов верстака
/rcrafts view anvil [page]	Просмотр рецептов наковальни
/rcrafts recipe	Создание рецепта верстака
/rcrafts anvil	Создание рецепта наковальни
/rcrafts reload	Перезагрузка конфига и рецептов

Права

Право	По умолчанию	Описание
refontcrafts.use	true	Базовый доступ к /rcrafts
refontcrafts.view	true	Просмотр рецептов
refontcrafts.create.workbench	op	Создание рецептов верстака
refontcrafts.create.anvil	op	Создание рецептов наковальни
refontcrafts.edit.workbench	op	Редактирование рецептов верстака
refontcrafts.edit.anvil	op	Редактирование рецептов наковальни
refontcrafts.delete.workbench	op	Удаление рецептов верстака
refontcrafts.delete.anvil	op	Удаление рецептов наковальни
refontcrafts.reload	op	Перезагрузка плагина
refontcrafts.notify	op	Служебные уведомления
refontcrafts.admin	op	Полный доступ

Важные настройки

settings:
  exact_meta_match: false
  workbench_strict_shape: true
  workbench_preview_limit: 126

  anvil:
    strict_order: true

exact_meta_match

• true — строгое сравнение предметов.
• false — сравнение по важным визуальным и логическим данным без уникальных служебных NBT.

Рекомендуется false, если сервер использует магазины, Brewery, ExecutableItems или другие плагины с кастомными предметами.

workbench_strict_shape

Если включено, рецепт верстака сработает только при точной выкладке предметов по слотам 3x3.

workbench_preview_limit

Лимит визуального количества результата в верстаке. Значение 126 используется как стабильный предел для отображения overstack-результата.

anvil.strict_order

Если включено, левый и правый слоты наковальни считаются разными. Рецепт A + B не сработает как B + A.

FAQ

Почему результат показывает максимум 126?

Это практический предел стабильного клиентского отображения overstack-результата. При больших значениях слот результата может отображаться некорректно.

Можно ли дать игрокам только просмотр рецептов?

Да. Достаточно прав:

refontcrafts.use
refontcrafts.view

Куда писать баги?

В Issues проекта: https://github.com/RizonChik/RefontCrafts/issues

Сборка из исходников

mvn clean package

Готовый .jar будет в папке target/.