VibeCoding Guide

Как решать базовые ошибки

И как ускорить написание кода. Решаем проблемы с package, названиями классов и учимся писать код быстрее.

Сборка проекта

Что нужно, а что не пригодится вообще. Где найти того самого "слона" и как запустить игру.

Файлы проекта

(что можно трогать, а что нельзя). Разбор структуры папок: где код, а где текстуры.

Как решать базовые ошибки одним кликом

1. Ошибка в package

Как правило, эта ошибка связана с неверно написанным package, либо файл находится не в том package. Package - это папки записанные через точку.

Вот как это выглядит:

Самый простой способ решения:

Это автоматически пропишет тот package, в котором находится сам файл.

Если пакет в исходном коде должен быть другим, то создайте новую папку в проекте и перетащите туда файл.

2. Ошибка в названии класса (...class Metrocube...)

В большинстве случаев, это связано с неправильным написанием названия самого файла. Решается это просто:

⚠️ Важно: Не факт что ошибки, которые показывает IntelliJ IDEA - правда. Попробуйте собрать проект. При ошибке сборки он напишет настоящие ошибки, которые видит именно компилятор.

Как ускорить написание кода

При создании файла не пишите расширение.

✖ Metrocube.java

✔ Metrocube

Это одно и тоже, но ускоряет создание.

Лайфхак для копирования:

Если код скопирован из ИИ, необязательно помнить название класса. Можно создать любой java файл (например назвав его 123) и заменить его содержимое из буфера обмена. А потом просто навестись на название класса и файл изменится как надо.

Полезные горячие клавиши:

CTRL + A — Выделить весь текст (чтобы заменить его сразу, а не удалять)
CTRL + F — Поиск по тексту (найти нужный фрагмент кода)

Сборка проекта

Компиляция (Создание .jar)

Чтобы скомпилировать мод, нужно нажать на "слона" (Gradle) на боковой панели, перейти в папку tasks -> build и нажать на кнопку jar.

Запуск игры (Тестирование)

Кнопка выше не подойдет для быстрого теста. Для запуска Minecraft используйте папку mod development (ниже build), а внутри — runClient.

Именно его нужно использовать для запуска майнкрафта сразу же.

Файлы проекта

В большинстве случаев нужно из ИИ копировать только .java-файлы, все остальное лучше игнорировать.

📂 templates — здесь лежит neoforge.mods.toml (информация о моде).
📂 resources — ресурсы мода (файлы языка .json, звуки, текстуры, модели), а также настройка mixin'ов.
📂 src -> main -> java — здесь находится сам код мода.

🚫 Все остальные файлы лучше не трогать, если не знаешь, что они делают.