Перейти к содержанию

Установка программ#

Minecraft написан на языке Java. Программы на этом языке могут выполняться только если у вас установлена виртуальная машина Java.

Java Development Kit#

Для запуска Minecraft необходима лишь среда выполнения Java (JRE).

Но для разработки собственных модов нам потребуется писать программный код и пользоваться разными инструментами. Это не входит в стандартный Java пакет, поэтому нам нужно установить JDK (Набор инструментов разработчика Java).

Minecraft 1.7.10 работает только с Java 8 (1.8). Более новые выпуски Java данной версией игры не поддерживаются.

Скачайте последнюю версию Oracle JDK и следуйте инструкциям по установке. Ничего в настройках установки менять не надо.

Принятые ограничения корпорацией Oracle
  • С апреля 2019 г. для скачивания файлов нужна регистрация на сайте. Это бесплатно и подтверждать ничего, кроме E-mail не потребуется.
  • С марта 2022 г. скачивание файлов недоступно для пользователей из РФ. Потребуется использовать прокси/VPN. При регистрации следует указывать любую другую страну и использовать иностранный почтовый сервис (напр. GMail, Outlook).

Альтернативная JDK

В качестве альтернативы можно использовать JDK от другого производителя, например BellSoft. Здесь не придётся регистрироваться и искать обходные пути. Скачать Liberica JDK

Forge для пользователей#

Чтобы люди смогли играть с вашим модом, на их Minecraft должен быть установлен загрузчик модов MinecraftForge.

Скачайте установщик (Installer) с официального сайта MinecraftForge:

Картинка скачивания установщика

Запустите скачанный файл. Выберите пункт «Install client», укажите путь к Minecraft, если он не указан и нажмите «OK».

Картинка установщика

Forge для разработки#

Forge использует систему сборки проектов Gradle. Задачей систем сборки является автоматизация процессов, чтобы избавить вас от необходимости вводить множество консольных команд вручную. Проще говоря, Gradle делает за вас всю «грязную работу». В случае Minecraft разработки это: компиляция, тестирование, обфускация кода и упаковка всего в JAR-файл.

Скачивание#

Скачайте набор инструментов для разработки модификаций (SRC, для новых версий MDK) с официального сайта Forge:

Картинка скачивания MDK

Создайте в любом удобном для вас месте папку и распакуйте туда скачанный архив. Вы увидите много файлов. Не все из них вам нужны. Чтобы не захламлять рабочее пространство, удалите все файлы, кроме:

  • build.gradle – Главный файл конфигурации проекта. Описывает процесс сборки проекта.
  • gradlew и gradlew.bat – Скрипты запуска Gradle Wrapper.
  • Папка gradle – Здесь располагается Gradle Wrapper.

Предварительная настройка#

Прекращена поддержка Amazon S3

В ноябре 2022 г. корпорация Microsoft удалила файлы игры с сервиса Amazon S3 из-за чего старые официальные версии ForgeGradle перестали работать выдавая ошибку: Unexpected reponse 403 from http://s3.amazonaws.com/Minecraft.Download/versions/1.7.10/1.7.10.json
Для разработки будет использоваться неофициальная версия ForgeGradle, где эта проблема была исправлена (файлы игры теперь скачиваются с серверов Microsoft).

Команда MinecraftForge давно прекратила поддержку версии Minecraft 1.7.10. Нам потребуется внести несколько небольших изменений в конфигурационные файлы скачанного проекта, исправляющие проблемы совместимости с актуальными версиями ПО.

Для удобства, список изменений представлен в формате diff. Строки, выделенные красным, следует удалить, а зелёные – добавить. Символы «-» и «+» в начале строк копировать не нужно!

Измените следующие файлы:

gradle/wrapper/gradle-wrapper.properties
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
- distributionUrl=https\://services.gradle.org/distributions/gradle-2.0-bin.zip
+ distributionUrl=https\://services.gradle.org/distributions/gradle-4.4.1-bin.zip
build.gradle
buildscript {
    repositories {
        mavenCentral()
        maven {
            name = "forge"
-           url = "http://files.minecraftforge.net/maven"
+           url = "https://maven.minecraftforge.net/"
        }
        maven {
            name = "sonatype"
            url = "https://oss.sonatype.org/content/repositories/snapshots/"
        }
    }
    dependencies {
-       classpath 'net.minecraftforge.gradle:ForgeGradle:1.2-SNAPSHOT'
+       classpath ('com.anatawa12.forge:ForgeGradle:1.2-1.0.+') {
+           changing = true
+       }
    }
}

apply plugin: 'forge'

version = "1.0"
group= "com.yourname.modid" // http://maven.apache.org/guides/mini/guide-naming-conventions.html
archivesBaseName = "modid"

+ // Активация поддержки Java 8 (без этой строчки будет использоваться Java 6)
+ targetCompatibility = sourceCompatibility = JavaVersion.VERSION_1_8

minecraft {
    version = "1.7.10-10.13.4.1614-1.7.10"
    runDir = "eclipse"
}

+ // Активация поддержки юникода, чтобы не было кракозябр
+ tasks.withType(JavaCompile) {
+     options.encoding = 'UTF-8'
+ }

// ...

Инициализация ForgeGradle#

Теперь мы можем инициализировать среду разработки, чтобы ForgeGradle подготовил необходимые файлы для нас. Для этого выполните приведённую ниже команду в командной строке (терминале). Вариант написания отличается в зависимости от ОС и используемой оболочки.

# Windows (CMD)
gradlew setupDecompWorkspace
# Windows (PowerShell)
.\gradlew setupDecompWorkspace
# Linux / MacOS
./gradlew setupDecompWorkspace

Подготовка займёт несколько минут в зависимости от производительности вашего компьютера и скорости интернета. По завершении выполнения вы должны увидеть сообщение «BUILD SUCCESSFUL».

Важно

Команду надо выполнять находясь в каталоге проекта, иначе получите ошибку «Неизвестная команда/файл».
В случае ОС Windows, откройте командную строку с помощью Shift+ПКМ в свободной области окна проводника с файлами проекта, выбрав соответствующий пункт меню.

Как задать переменную JAVA_HOME?

При работе с Gradle из командной строки (терминала) требуется указание пути к JDK с помощью переменной окружения JAVA_HOME. Временно задать путь для текущего сеанса можно одной из следующих команд в зависимости от ОС и оболочки:

# Windows (CMD)
SET JAVA_HOME="C:\Program Files\Java\jdk1.8.0_341"
# Windows (PowerShell)
$env:JAVA_HOME = "C:\Program Files\Java\jdk1.8.0_341"
# Linux / MacOS
export JAVA_HOME='/usr/lib/jvm/jdk1.8.0_341'

Не забудьте изменить путь к JDK на актуальный. И не закрывайте окно терминала — все остальные команды Gradle нужно вводить в этом же окне.

Информация

Настройка среды ForgeGradle производится всего один раз на ПК. Вам не потребуется повторно вводить команду для остальных проектов, разрабатываемых на той же версии Forge и Minecraft (версия указывается в build.gradle в minecraft.version).

Среда разработки (IDE)#

Моды можно писать и в блокноте, но это очень неудобно. Нам нужна специализированная программа, которая умеет подсвечивать код, выполнять авто-импорт и делать много других полезных вещей.

Наиболее популярными IDE на данный момент являются Eclipse и IntelliJ IDEA.

Eclipse бесплатен. У IDEA есть бесплатная Community версия. Мы рекомендуем использовать IDEA, чтобы избежать большинства проблем при написании модификации. Никаких платных функций в этом учебнике нам не потребуется. Выберите наиболее подходящую для вас IDE, основываясь на характеристиках вашего компьютера.