Чтение исходного кода Minecraft

Чтение исходного кода Minecraft - важный навык в моддинге, потому что:

• Большинство вещей Minecraft не задокументированы.
• Документации/туториалы устаревают довольно быстро.

Чтобы прочитать исходный код Minecraft, вам нужно сначала сгенерировать исходный код. Смотрите раздел “Генерация исходного кода Minecraft” в Настройка среды разработки.

Чтобы найти класс Minecraft, выполните следующие действия:

1. Откройте панель поиска с помощью Ctrl + N.
2. Установите область поиска на Project and Libraries или шире.
3. Введите название класса в поле поиска.

1. Откройте панель поиска с помощью Ctrl + P.
2. Введите имя класса с префиксом #.

В коде Visual Studio вы также можете использовать Ctrl + T, чтобы напрямую открыть поиск по классам.

Поиск части кода, которую вы хотите увидеть, является сложной задачей. Вот несколько советов:

• В полной мере воспользуйтесь возможностями IDE для поиска соответствующего кода, такого как Call hierarchy, Method hierarchy или Type hierarchy.
• Взгляните на моды с открытым исходным кодом, которые похожи на то, что вы хотите создать.
• Если вы добавляете новый контент, есть большая вероятность, что вам потребуется доступ к реестрам, определенным в net.minecraft.util.registry.Registry.
• Имейте в виду, что все начинается с одного основного класса (net.minecraft.client.main.Main для клиента, net.minecraft.server.Main для выделенного сервера).

Чтение байт-кода иногда требуется, потому что:

• Миксины работают с байт-кодом, а не с исходным кодом. Понимание байт-кода имеет важное значение, когда вы пишете сложный миксин.
• Декомпилятор (FernFlower) не идеален. Иногда он выдает недопустимый java-код, такой как int i = true;.

Если вы не знакомы с байт-кодом java, обратитесь в спецификацию JVM.

Чтобы просмотреть байт-код, выполните следующие действия:

1. Откройте класс, байт-код которого вы хотите увидеть.
2. Выберите View в главном меню.
3. Выберите Show Bytecode.

Если ваша IDE не поддерживает просмотр байт-кода, используйте другие средства просмотра байт-кода, такие как этот.

Где находятся сгенерированные исходники?

Они находится либо в пользовательском кэше gradle (~/.gradle/caches/fabric-loom), либо в кэше gradle проекта (./.gradle/loom-cache). Вы можете использовать исходники jar вне вашего IDE.