Начать здесь

Тебе не нужно сначала понимать весь API WorldBox. Первая задача намного меньше:

NeoModLoader работает
        ↓
твой мод компилируется и загружается
        ↓
твой marker появляется в Player.log
        ↓
работает одна маленькая механика
        ↓
и только потом: большие системы

Финиш этой страницыТы можешь доказать: «loader видит мой мод, мой код запустился, одна механика работает» — без гадания.

START

Пройти интерактивный маршрут первого мода

Шесть маленьких checkpoint. Прогресс хранится только в твоём браузере и в любой момент сбрасывается.

Открыть маршрут →

До того как трогать код

На старте достаточно нескольких вещей:

WorldBox, где NeoModLoader уже запускается;
любой удобный редактор кода/текста;
Player.log, потому что он показывает, дошли ли мы до compile/load/runtime;
отдельный тестовый save, если рецепт меняет состояние мира.

Для первого успешного запуска тебе не нужны Harmony, свой UI, огромная архитектура, база данных или двадцать папок.

Пять вещей, которые постоянно встречаются

Если mod.json, Main.cs, NML и runtime пока сливаются в одну кашу — сначала открой простую схему моддинга. Там объяснено, за что отвечает каждый слой и где искать проблему.

MAPЧто такое NML, mod.json, Main.cs и Player.log?Сначала схема в голове, потом API. MODСгенерировать минимальный каркасДва файла, один load-marker, без лишних систем. RUNПроверить первый запускТочно увидеть, как выглядит успех. FIXНе заработалоВыбрать первую проверку по реальному симптому. ABCСловарь человеческим языкомКоротко о терминах, которые встречаются в гайдах. HOWДобавить одну механикуПрактические рецепты после доказанного каркаса.

Полезная привычка при отладке

Когда что-то не работает, называй этап, а не просто «мод сломан»:

NML не видно
→ loader/setup

C# error / мод не компилируется
→ compile

мод загружен, но своего marker нет
→ load / entry-point assumption

marker есть, механика не работает
→ feature/runtime

сейчас работает, после reload/restart пропадает
→ persistence/lifecycle

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

После первого успеха

Выбери одну цель в Рецептах. Если рецепт зависит от version-sensitive поведения, открой Матрицу совместимости и посмотри статус evidence, прежде чем считать поведение универсальным.

Правило новичкаСначала заставь мод загрузиться. Потом докажи одну работающую вещь. И только потом делай сложно.