METRON MODDING SDK

Руководство по моддингу Metron

Создавайте свои блоки, предметы, 3D glTF-модели, рецепты и Lua-скрипты. Изолированная архитектура с гарантией стабильных 20 TPS и мгновенным хот-релоадом без перезапуска игры.

8 подробных глав Декларативный RON 3D glTF / .glb из Blender Lua 5.4 Sandbox (500 мкс) Хот-релоад F3 + T

Три слоя контента в Metron

Любой мод чётко разделяется на данные, визуальные ресурсы и логику поведения:

Слой данных · RON

Datapack

Декларативное описание вокселей, инструментов, крафта и структур в читаемом формате RON без необходимости трогать код ядра.

  • BlockDef с динамическими ID ≥ 256
  • ItemDef со шкалой прочности и скоростью
  • ✓ Рецепты: верстак 3×3, печь, топливо
Гайд по блокам и данным →
Визуальный слой · Ресурсы

Resource pack

Атлас текстур, современные 3D-модели glTF из Blender, совместимость с Minecraft JSON, бесшовные CTM-текстуры и скины окон GUI.

  • ✓ glTF / .glb низкополигональные 3D-модели
  • ✓ Continuity / OptiFine CTM repeat и random
  • ✓ Кастомные фоны инвентаря, сундуков и печей
Гайд по 3D-моделям и пакам →
Слой логики · Lua 5.4

Lua Scripting

Динамика игры и взаимодействие с миром в безопасной песочнице с лимитом 500 мкс на вызов для защиты игрового тикрейта.

  • ✓ Хуки on_block_break и on_block_place
  • ✓ Регистрация команд через commands:register
  • ✓ Полный доступ к инвентарю metron.inventory
Гайд по скриптам и SDK →
01 Основы

Архитектура и три слоя контента

Как устроен моддинг в Metron: философия стабильного тикрейта, три слоя (Datapack, Resourcepack, Lua) и хот-релоад по F3+T.

02 Основы

Быстрый старт: первый мод за 5 минут

Пошаговая инструкция по созданию первого мода: манифест pack.ron, кастомный блок, скрипт на Lua и хот-релоад в игре.

03 Контент

Блоки (BlockDef): воксели от А до Я

Полная анатомия BlockDef: прочность, светоизлучение, звуки шагов, уровни инструментов, дропы и динамическая регистрация ID.

04 Контент

Предметы и инструменты (ItemDef)

Создание предметов, слитков и инструментов: шкала прочности, классы инструментов, скорость добычи блоков и команда /give.

05 Контент

Рецепты: верстак, плавка и топливо

Создание рецептов для RecipeBook: форменный и бесформенный крафт в сетках 2x2 и 3x3, переплавка в печи и кастомное топливо.

06 Визуал

3D-модели (glTF/JSON) и Ресурспаки

Использование Minecraft JSON-моделей и современных 3D-моделей glTF из Blender, атлас вокселей, CTM-текстуры и кастомизация GUI.

07 Логика

Lua Scripting & Event SDK

Программирование на Lua: хуки событий мира, регистрация команд, управление инвентарем, песочница и отладка через /lua.

08 Примеры

Cookbook: готовые рецепты и примеры модов

Практические примеры мини-модов от А до Я: Счастливый блок, Магический кристалл, кастомные чат-команды и чеклист публикации.