Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 모드 개발 환경 구축하기 ======

===== 모드 개발에 필요한 도구들=====

   * Java 8 (권장) 또는 새 버전을 위한 Java 개발 킷 (JDK) [[https://adoptopenjdk.net/]]
   * Java IDE, 예: [[https://www.jetbrains.com/idea/download/#section=windows|Intellij IDEA]] and [[https://www.eclipse.org/downloads/|Eclipse]]. [[https://code.visualstudio.com/|Visual Studio Code]]같은 다른 코드 편집기를 쓰실 수 있습니다..

===== 모드 스타트업 =====
마인크래프트 Fabric 모드를 개발 시작하는 방법은 2가지가 있습니다. 수동으로 개발 환경을 구축하거나, 프로그램을 실행시켜서 알아서 개발 환경을 구축하게 하실 수 있습니다.

==== 수동적 방법 ====
   - ''LICENSE''와 ''README.md''는 빼고 [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]]에 있는 모든 파일을 복사하세요 (Kotlin을 사용하고 싶으시다면 [[https://github.com/natanfudge/fabric-example-mod-kotlin|이 Kotlin버전]]을 복사하세요).
   - ''gradle.properties''를 아래와 같이 수정하세요:
       * ''archives_base_name''과 ''maven_group''를 당신의 설정으로 그룹으로 설정하세요. (예: 본인의 사이트가 fabricmc.net이라면 net.fabricmc)
       * 마인크래프트 버전, 매핑과 로더 버전을 설정하세요. [[https://modmuss50.me/fabric.html|이 웹사이트]]에서 원하는 버전을 확인할 수 있습니다.
       * ''build.gradle''에 사용할 다른 의존성을 설정하세요.
   - ''build.gradle'' 파일을 IDE로 불러오세요. 다음 섹션에서 각각 IDE의 방법을 알 수 있습니다.
   - 즐거운 모딩하세요!

''genSources'' Gradle task(작업)을 통해 참조를 위한 마인크래프트 소스코드를 생성할 수 있습니다. (IntelliJ IDEA에는 이미 디컴파일러가 있기 때문에 코드를 검색하는 데만 유용합니다.)
만약 사용하는 IDE가 Gradle 연동 기능이 없다면, 터미널에서 ''gradlew genSources''를 실행할 수 있습니다. (리눅스/MacOS에서는 ''./gradlew genSources'')

=== IntelliJ IDEA ===
- 메인 메뉴에서 Import Project를 선택합니다. (만약, 이미 열려있는 프로젝트가 있다면 File -> Open을 클릭합니다)
- 프로젝트의 build.gradle 파일을 선택해 불러옵니다.
- Gradle이 모두 세팅이 완료되면, File -> Close Project를 누르고 실행 설정이 제대로 표시되지 않는 문제를 해결하기 위해 다시 프로젝트를 엽니다.
- (만약 실행 설정이 보이지 않는다면, Gradle 탭에서 Gradle Project를 다시 불러와보세요)

//선택 옵션(권장하지 않음)//:
기본적으로, IntelliJ는 Gradle를 프로젝트를 빌드하기 위해 사용됩니다. 이 작업은 Fabric에 불필요하며 제작 시간이 길어지고 다른 문제들과 함께 핫 스왑 관련 이상한 문제가 발생합니다. 기본 제공 컴파일러를 사용하도록 설정하려면:
    - Gradle Settings 창을 Gradle 탭에서 여세요.
    - Build and run using과 Run test using 필드를 InteliJ IDEA로 설정하세요.
    - File -> Project Structure로 간 다음에 Project compiler output을 ''$PROJECT_DIR$/out''로 설정하세요.

불행하게도, 이것은 IDE 전체에 Build and run using과 Run tests using 옵션이 기본(글로벌 값)으로 설정되는것은 불가능하기때문에, 새 프로젝트를 생성할때마다 반복할 필요가 있습니다.

**중요:** Gradle과 개발 환경을 망가뜨리므로 ''./gradlew idea''를 실행하지 마세요

=== 이클립스 ===
만약 이클립스를 사용하고 계신다면 ''gradlew eclipse''를 실행하세요.

=== Visual Studio Code ===
만약 Microsoft가 개발한 Visual Studio Code를 사용중이라면, [[ko_kr:tutorial:vscode_setup|이 방법]]을 참고하세요.
==== MinecraftDev IntelliJ IDEA 플러그인 ====
IntelliJ IDEA를 사용중이라면 MinecraftDev 플러그인을 사용할 수 있습니다. 이 플러그인은 Fabric 프로젝트 자동 생성, 인스펙션, Shadow/엑세서 필드 생성, 그리고 Mixin 타깃 참조 (JVM 기술어?)와 같은 일부 Mixin 관련 기능에 대한 지원을 추가합니다. 이 플러그인은 [[https://plugins.jetbrains.com/plugin/8327|IntelliJ 플러그인 리포지토리]]에서 찾을 수 있으므로, IntelliJ의 내부 플러그인 브라우저(File -> Settings -> Plugins)에서 Marketplace 탭을 클릭하고 Minecraft를 검색해서 설치할 수 있습니다.
==== 자동 생성기 ====
만약 IntelliJ MinecraftDev 플러그인이나 [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] 레포지토리를 사용할 수 없다면 ExtraCrafTX님이 만든 새로운 탬플릿으로 Fabric 모드를 자동으로 생성해주는 [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]]를 사용할 수 있습니다. 다음 과정을 따르세요.
  - [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|여기]]에서 다운로드하고 압축을 풀으세요
  - 새 디렉터리를 만들고, ''(대충 GeneratorFabricMod가 있는 폴더)/bin/GeneratorFabricMod''를 실행하세요.
  - 의존성이 모두 받아진 후, 필요한 정보를 입력하세요.
  - 모두 완료될경우, 그냥 IDE에서 프로젝트 폴더를 여세요.
===== 모드 개발 기초 =====
[[ko_kr:tutorial:items|아이템]]이나 [[tutorial:blocks|블록]]을 한번 추가해 보세요. [[tutorial:hotswapping|마인크래프트를 재시작 하지 않고도 변경 사항을 적용하는 방법]]이 필요하실 수 있으니 참고로 읽어보세요.

===== 조언 =====
  * 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''. Running ''gradlew %%--%%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.

===== 문제점 해결 =====

==== 소리가 없는 문제 ====

때때로 IDE를 통해 gradle 프로젝트를 불러올때, 에셋이 제대로 다운로드 되지 않을 때가 있습니다. 이럴 때는, ''downloadAssets'' task를 직접 실행하거나 IDE의 Gradle 메뉴를 이용해 task를 실행하거나, 간단하게 커맨드 쉘(cmd, powershell, bash 등등)을 통해 ''gradlew downloadAssets''를 실행하면 해결됩니다.