ORM - OverrideResourceManager

ORM - OverrideResourceManager

Клиентский мод на Fabric для Minecraft 1.21.4, позволяющий заменять текстуры и модели предметов прямо во время игры — без ресурспака. Оверрайды хранятся в обычных файлах в config/orm/ и перезагружаются вместе со стеком ресурсов (F3+T).

Возможности

Установка

1. Установите Fabric Loader и Fabric API для Minecraft 1.21.4.
2. Поместите .jar ORM в папку mods/.
3. Запустите игру — папка config/orm/ создастся автоматически.

Структура файлов

config/orm/
├── overrides.json            ← основной конфиг (список записей оверрайдов)
├── models/
│   └── <name>.json           ← кастомные модели Blockbench/JSON
└── textures/
    └── item/
        └── <name>.png        ← файлы текстур (+ опциональный .png.mcmeta для анимации)

Модели и текстуры указываются в overrides.json через пространство имён orm::

• "model": "orm:sword" → config/orm/models/sword.json
• "texture": "orm:item/texture2d/apple" → config/orm/textures/item/texture2d/apple.png Подпапки полностью поддерживаются, их структура сохраняется:

config/orm/textures/item/sword/anim/animation.png
  → orm:item/sword/anim/animation

Справочник по overrides.json

Каждая запись — это JSON-объект. Поля:

Должно быть задано хотя бы одно из полей texture или model.

Пример использования

Пример ниже взят из реального рабочего конфига. Он заменяет два инструмента кастомными 3D-моделями в стиле Diablo (каждая с анимированным слоем текстуры) и заменяет золотое яблоко на плоскую 2D-текстуру.

config/orm/overrides.json

[
  {
    "item": "minecraft:netherite_sword",
    "name": "Netherite Sword",
    "model": "orm:sword"
  },
  {
    "item": "minecraft:netherite_pickaxe",
    "name": "Netherite Pickaxe",
    "model": "orm:pickaxe"
  },
  {
    "item": "minecraft:golden_apple",
    "name": "Golden Apple",
    "texture": "orm:item/texture2d/apple"
  }
]

Структура файлов для примера выше

config/orm/
├── overrides.json
├── models/
│   ├── sword.json
│   └── pickaxe.json
└── textures/
    └── item/
        ├── sword/
        │   ├── diablo_texture.png       ← статичная базовая текстура
        │   └── anim/
        │       ├── animation.png        ← кадры анимированного оверлея
        │       └── animation.png.mcmeta ← тайминг кадров
        ├── pickaxe/
        │   ├── diablo_texture.png
        │   └── anim/
        │       ├── animation.png
        │       └── animation.png.mcmeta
        └── texture2d/
            └── apple.png               ← плоская 2D-замена

Как работает каждая запись

Netherite Sword / Pickaxe — "model": "orm:sword" загружает models/sword.json. Сама модель ссылается на два слоя текстур:

• orm:item/sword/diablo_texture — статичная детализированная текстура 128×128
• orm:item/sword/anim/animation — анимированный оверлей, управляемый animation.png.mcmeta Оба сопоставляются по отображаемому имени ("name": "Netherite Sword"), так что затрагиваются только предметы с точно таким именем. Переименуйте предмет в наковальне во что угодно другое — и ванильная модель вернётся. Golden Apple — "texture": "orm:item/texture2d/apple" глобально заменяет ванильный golden_apple.png (без фильтра по имени), так что каждое золотое яблоко в мире использует textures/item/texture2d/apple.png.

Формат .mcmeta для анимированной текстуры

{
  "animation": {
    "frametime": 3,
    "frames": [0, 1, 2, 3]
  }
}

Поместите файл .mcmeta рядом с .png с тем же именем и суффиксом .mcmeta.

Клавиша: быстрое добавление

Откройте любой экран инвентаря и кликните средней кнопкой мыши по слоту с предметом. ORM считает ID предмета, отображаемое имя и CustomModelData, добавит новую запись в overrides.json и выведет подтверждение в чат. Созданная запись использует поле texture с путём, производным от ID предмета — замените плейсхолдер текстуры на ваш реальный файл. Привязка по умолчанию: средняя кнопка мыши (можно переназначить в Управление → Override Resource Manager).

Перезагрузка

Нажмите F3+T, чтобы перезагрузить ресурспаки. ORM заново прочитает overrides.json, пересканирует models/ и textures/ и перестроит реестр оверрайдов без перезапуска игры.

Требования

• Minecraft 1.21.4
• Fabric Loader 0.19.2+
• Fabric API 0.119.4+1.21.4