This is an old revision of the document!
Table of Contents
모드 개발 환경 구축하기
모드 개발에 필요한 도구들
- Java 8 (권장) 또는 새 버전을 위한 Java 개발 킷 (JDK) https://adoptopenjdk.net/
모드 스타트업
마인크래프트 Fabric 모드를 개발 시작하는 방법은 2가지가 있습니다. 수동으로 개발 환경을 구축하거나, 프로그램을 실행시켜서 알아서 개발 환경을 구축하게 하실 수 있습니다.
수동적 방법
- Edit
gradle.properties
:- Make sure to set
archives_base_name
andmaven_group
to your preferred values. - Make sure to update the versions of Minecraft, the mappings and the loader - all of which can be queried through this website - to match the versions you wish to target.
- Add any other dependencies you plan to use in
build.gradle
.
- Import the build.gradle file to your IDE. You may refer to the next section for specific IDE's.
- Happy modding!
You can generate the Minecraft sources for reference (since IDEA already has a decompiler this is only useful for searching through the code) :
Run the genSources
Gradle task. If your IDE doesn't have Gradle integration, then run the following command in the terminal: gradlew genSources
(or ./gradlew genSources
on Linux/MacOS).
IntelliJ IDEA
If you are using IntelliJ IDEA by JetBrains, please follow these steps:
- In the IDEA main menu, select 'Import Project' (or File → Open… if you already have a project open).
- Select the project's build.gradle file to import the project.
- After Gradle is done setting up, close (File → Close Project) and re-open the project to fix run configurations not displaying correctly.
- (If the run configurations still don't show up, try reimporting the Gradle project from the Gradle tab in IDEA.)
Optional, but recommended: By default, IntelliJ delegates to Gradle to build the project. This is unnecessary for Fabric and causes longer build times and hotswapping related weirdness, among other problems. To make it use the builtin compiler:
- Open the 'Gradle Settings' dialog from the Gradle tab.
- Change the 'Build and run using' and 'Run tests using' fields to 'IntelliJ IDEA'.
- Go to File → Project Structure → Project and set 'Project compiler output' to
$PROJECT_DIR$/out
.
Unfortunately, it is currently impossible to set an IDE-wide default for the 'Build and run using' and 'Run tests using' options, so these steps have to be repeated for every new project.
NOTE: Don't run ./gradlew idea
as it messes up with gradle and breaks develop environment.
이클립스
만약 이클립스를 사용하고 계신다면 gradlew eclipse
를 실행하세요.
Visual Studio Code
If you are using VSCode by Microsoft, please follow these instructions
MinecraftDev IntelliJ IDEA 플러그인
If you are using IntelliJ IDEA you can use the MinecraftDev plugin. This plugin adds support for automatically generating Fabric projects as well as some mixin related features like inspections, generating accessors/shadow fields, and copying Mixin Target References (JVM Descriptors). The plugin can be found in the IntelliJ plugin repository, so you can install it using IntelliJ's internal plugin browser by navigating to File → Settings → Plugins, then clicking the Marketplace tab and searching for Minecraft.
Generator
If you are unable to use the MinecraftDev plugin or the fabric-example-mod repo, you may also use GeneratorFabricMod by ExtraCrafTX, a convenient tool to automatically generate new fabric mods from template. Follow these steps:
- Download latest release of GeneratorFabricMod here and extract them.
- Make a new directory, then run a command shell there and type
path/to/GeneratorFabricMod/bin/GeneratorFabricMod
. - After letting it get its dependencies, follow the instructions and input required information.
- You're now done, just open the project folder with in your IDE.
모드 개발 기초
Try adding an item or a block. It's also a good idea to visit Applying changes without restarting Minecraft. 아이템이나 블록을 한번 추가해 보세요. 마인크래프트를 재시작 하지 않고도 변경 사항을 적용하는 방법이 필요하실 수 있으니 참고로 읽어보세요.
조언
- While Fabric API is not strictly necessary for developing mods, its primary goal is to provide cross-compatibility and hooks where the game engine does not, and as such it is highly recommended! Even some of the tutorials on the wiki implicitly require Fabric API.
- Occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require resetting the cache files. This can be done by running
gradlew cleanloom
. Runninggradlew --stop
can also help with a few rare issues. - Don't hesitate to ask questions! We're here to help you and work with you to make your dream mod a reality.
문제점 해결
소리가 없는 문제
Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the downloadAssets
task manually - either using IDE's built-in menu or by simply running gradlew downloadAssets
.