Ultimate Custom Gear

Ultimate Custom Gear

Добавляй кастомное снаряжение в Minecraft, не написав ни строчки на Java

UltimateCustomGear — это data-driven мод для NeoForge на Minecraft 1.21.1. Закинь JSON-файл в папку, перезапусти игру — и твой предмет существует: зарегистрирован, с текстурой, крафтится и виден в JEI. Он создан для владельцев серверов и сборщиков модпаков, которым нужен кастомный контент, но не хочется ради него поддерживать отдельный мод.

Что можно создать

• Комплекты брони с характеристиками для каждой части, эффектами при ношении и бонусами за полный комплект
• Оружие — мечи, луки, арбалеты, щиты
• Инструменты — кирки, топоры, лопаты, мотыги, с уровнями добычи и вспашкой по области
• Еду с питательностью, скоростью поедания и эффектами при съедании
• Блоки, включая направленные и подверженные гравитации, с текстурами для каждой грани
• Жидкости с собственным цветом, растеканием и эффектами при контакте

Чем он отличается

Сопротивления урону. Броня может снижать урон по типу урона, по атакующему или по обоим сразу — огнеупорная броня, броня убийцы драконов, броня, работающая только против мобов-нежити. Правила разрешаются по специфичности, так что правило про стрелы скелетов имеет приоритет над общим правилом про стрелы. Дроп с мобов. Любой предмет может выпадать с любого моба, с настраиваемым шансом, количеством, фильтрами по сущностям и поведением Looting. Этого достаточно, чтобы построить серверную экономику на одном лишь JSON. 3D-модели брони. С установленным GeckoLib броня рендерится как полноценная модель из Blockbench с опциональными анимациями вместо плоских слоёв. Без GeckoLib она откатывается к 2D — мод всё равно работает. Настоящие рецепты. Все ванильные типы рецептов, задаваемые в JSON и внедряемые как серверные данные, так что JEI показывает их как любые другие рецепты. Ингредиенты принимают теги, поэтому #minecraft:planks означает любую доску из любого мода. Рецепты из других модов можно пропускать без изменений, с защитой, чтобы они чисто исчезали при отсутствии того мода. Теги в обе стороны. Твой контент может вступать в существующие теги, чтобы рецепты других модов его принимали, а ты можешь добавлять контент других модов в нужные тебе теги. Контент-паки. Поставляй всё одним .zip-файлом, который игроки кидают в папку. Один файл, ничего не распаковывать, ничего не установить неправильно. Проверка в мультиплеере. Сервер при входе проверяет, что у клиентов совпадающий контент, чтобы никто не играл с подсказкой, противоречащей урону, который он на самом деле наносит. Режим проверки настраивается — кик, предупреждение или игнорирование. Живая перезагрузка. /customgear reload обновляет названия, эффекты, рецепты, дроп и сопротивления без перезапуска. Балансируй свою экономику, пока игроки онлайн.

Полный предмет, от начала до конца

{
  "id": "magic_apple",
  "type": "food",
  "names": { "en_us": "Magic Apple" },
  "nutrition": 4,
  "saturation": 1.2,
  "always_edible": true,
  "mob_drops": {
    "entities": ["#minecraft:undead"],
    "chance": 0.15,
    "min": 1,
    "max": 2
  },
  "on_eat_effects": [
    { "effect": "minecraft:regeneration", "amplifier": 1, "duration": 10 },
    { "effect": "minecraft:absorption",   "amplifier": 0, "duration": 120 }
  ],
  "texture": {
    "mode": "reference",
    "refs": { "item": "minecraft:item/golden_apple" }
  },
  "recipe": {
    "type": "shaped",
    "pattern": ["GGG", "GAG", "GGG"],
    "key": { "G": "minecraft:gold_block", "A": "minecraft:apple" }
  }
}

Это весь файл. Теперь мобы-нежить имеют 15% шанс его выронить, он крафтится, и JEI о нём знает.

Документация

Полная документация — каждое поле, каждый тип, проработанные примеры и руководство по миграции для ломающих изменений — в вики (ссылка в боковой панели). Начни с Getting Started, если ты никогда не писал контентный JSON, или перейди сразу к Field Reference, если знаешь, что ищешь.

Совместимость

• Minecraft 1.21.1 · NeoForge 21.1.x
• JEI — опционально, рекомендуется. Рецепты отображаются полностью
• GeckoLib — опционально, нужен только для 3D-моделей брони
• Работает с контентом любого установленного мода: ссылайся на их модели, используй их предметы как ингредиенты, добавляй их контент в свои теги
• Модифицированные зачарования применяются к зачаровываемым кастомным предметам автоматически Серверу и клиентам нужна одна и та же версия мода и совпадающие файлы контента.

Лицензия

MIT.