Differences

This shows you the differences between two versions of the page.

--- ko_kr:tutorial:setup [2021/02/16 08:02] – [MinecraftDev IntelliJ IDEA Plugin] themovieayt
+++ ko_kr:tutorial:setup [2024/06/30 00:06] (current) – ↷ Links adapted because of a move operation 121.165.164.87
@@ Line 10: / Line 10: @@
 ==== 수동적 방법 ====
-   - Copy the starting files from [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] (or from [[https://github.com/natanfudge/fabric-example-mod-kotlin|the Kotlin version]], if you wish to use Kotlin,) excluding the ''LICENSE'' and ''README.md'' files - as those apply to the template itself, not necessarily to your mod.
+   - ''LICENSE''와 ''README.md''는 빼고 [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]]에 있는 모든 파일을 복사하세요 (Kotlin을 사용하고 싶으시다면 [[https://github.com/natanfudge/fabric-example-mod-kotlin|이 Kotlin버전]]을 복사하세요).
-   - Edit ''gradle.properties'':
+   - ''gradle.properties''를 아래와 같이 수정하세요:
-       * Make sure to set ''archives_base_name'' and ''maven_group'' to your preferred values.
+       * ''archives_base_name''과 ''maven_group''를 당신의 설정으로 그룹으로 설정하세요. (예: 본인의 사이트가 fabricmc.net이라면 net.fabricmc)
-       * Make sure to update the versions of Minecraft, the mappings and the loader - all of which can be queried through [[https://modmuss50.me/fabric.html|this website]] - to match the versions you wish to target.
+       * 마인크래프트 버전, 매핑과 로더 버전을 설정하세요. [[https://modmuss50.me/fabric.html|이 웹사이트]]에서 원하는 버전을 확인할 수 있습니다.
-       * Add any other dependencies you plan to use in ''build.gradle''.
+       * ''build.gradle''에 사용할 다른 의존성을 설정하세요.
-   - Import the build.gradle file to your IDE. You may refer to the next section for specific IDE's.
+   - ''build.gradle'' 파일을 IDE로 불러오세요. 다음 섹션에서 각각 IDE의 방법을 알 수 있습니다.
-   - Happy modding!
+   - 즐거운 모딩하세요!
+''genSources'' Gradle task(작업)을 통해 참조를 위한 마인크래프트 소스코드를 생성할 수 있습니다. (IntelliJ IDEA에는 이미 디컴파일러가 있기 때문에 코드를 검색하는 데만 유용합니다.)
+만약 사용하는 IDE가 Gradle 연동 기능이 없다면, 터미널에서 ''gradlew genSources''를 실행할 수 있습니다. (리눅스/MacOS에서는 ''./gradlew genSources'')
-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:
+- 메인 메뉴에서 Import Project를 선택합니다. (만약, 이미 열려있는 프로젝트가 있다면 File -> Open을 클릭합니다)
-    - In the IDEA main menu, select 'Import Project' (or File -> Open... if you already have a project open).
+- 프로젝트의 build.gradle 파일을 선택해 불러옵니다.
-    - Select the project's build.gradle file to import the project.
+- Gradle이 모두 세팅이 완료되면, File -> Close Project를 누르고 실행 설정이 제대로 표시되지 않는 문제를 해결하기 위해 다시 프로젝트를 엽니다.
-    - After Gradle is done setting up, close (File -> Close Project) and re-open the project to fix run configurations not displaying correctly.
+- (만약 실행 설정이 보이지 않는다면, Gradle 탭에서 Gradle Project를 다시 불러와보세요)
-    - (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:
+기본적으로, IntelliJ는 Gradle를 프로젝트를 빌드하기 위해 사용됩니다. 이 작업은 Fabric에 불필요하며 제작 시간이 길어지고 다른 문제들과 함께 핫 스왑 관련 이상한 문제가 발생합니다. 기본 제공 컴파일러를 사용하도록 설정하려면:
-    - Open the 'Gradle Settings' dialog from the Gradle tab.
+    - Gradle Settings 창을 Gradle 탭에서 여세요.
-    - Change the 'Build and run using' and 'Run tests using' fields to 'IntelliJ IDEA'.
+    - Build and run using과 Run test using 필드를 InteliJ IDEA로 설정하세요.
-    - Go to File -> Project Structure -> Project and set 'Project compiler output' to ''$PROJECT_DIR$/out''.
+    - File -> Project Structure로 간 다음에 Project compiler output을 ''$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.
+불행하게도, 이것은 IDE 전체에 Build and run using과 Run tests using 옵션이 기본(글로벌 값)으로 설정되는것은 불가능하기때문에, 새 프로젝트를 생성할때마다 반복할 필요가 있습니다.
-**NOTE:** Don't run ''./gradlew idea'' as it messes up with gradle and breaks develop environment.
+**중요:** Gradle과 개발 환경을 망가뜨리므로 ''./gradlew idea''를 실행하지 마세요
-=== Eclipse ===
+=== 이클립스 ===
-If you are using Eclipse and you would like to have the IDE run configs you can run ''gradlew eclipse''.
+만약 이클립스를 사용하고 계신다면 ''gradlew eclipse''를 실행하세요.
 === Visual Studio Code ===
-If you are using VSCode by Microsoft, please follow [[tutorial:vscode_setup|these instructions]]
+만약 Microsoft가 개발한 Visual Studio Code를 사용중이라면, [[ko_kr:tutorial:vscode_setup|이 방법]]을 참고하세요.
 ==== 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).
+IntelliJ IDEA를 사용중이라면 MinecraftDev 플러그인을 사용할 수 있습니다. 이 플러그인은 Fabric 프로젝트 자동 생성, 인스펙션, Shadow/엑세서 필드 생성, 그리고 Mixin 타깃 참조 (JVM 기술어?)와 같은 일부 Mixin 관련 기능에 대한 지원을 추가합니다. 이 플러그인은 [[https://plugins.jetbrains.com/plugin/8327|IntelliJ 플러그인 리포지토리]]에서 찾을 수 있으므로, IntelliJ의 내부 플러그인 브라우저(File -> Settings -> Plugins)에서 Marketplace 탭을 클릭하고 Minecraft를 검색해서 설치할 수 있습니다.
-The plugin can be found [[https://plugins.jetbrains.com/plugin/8327|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.
+==== 자동 생성기 ====
+만약 IntelliJ MinecraftDev 플러그인이나 [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] 레포지토리를 사용할 수 없다면 ExtraCrafTX님이 만든 새로운 탬플릿으로 Fabric 모드를 자동으로 생성해주는 [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]]를 사용할 수 있습니다. 다음 과정을 따르세요.
-==== Generator ====
+  - [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|여기]]에서 다운로드하고 압축을 풀으세요
-If you are unable to use the MinecraftDev plugin or the [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] repo, you may also use [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]] by ExtraCrafTX, a convenient tool to automatically generate new fabric mods from template. Follow these steps:
+  - 새 디렉터리를 만들고, ''(대충 GeneratorFabricMod가 있는 폴더)/bin/GeneratorFabricMod''를 실행하세요.
-  - Download latest release of GeneratorFabricMod [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|here]] and extract them.
+  - 의존성이 모두 받아진 후, 필요한 정보를 입력하세요.
-  - Make a new directory, then run a command shell there and type ''path/to/GeneratorFabricMod/bin/GeneratorFabricMod''.
+  - 모두 완료될경우, 그냥 IDE에서 프로젝트 폴더를 여세요.
-  - 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.
+[[ko_kr:tutorial:items|아이템]]이나 [[tutorial:blocks|블록]]을 한번 추가해 보세요. [[tutorial:hotswapping|마인크래프트를 재시작 하지 않고도 변경 사항을 적용하는 방법]]이 필요하실 수 있으니 참고로 읽어보세요.
-===== Getting started =====
-Try [[tutorial:items|adding an item]] or [[tutorial:blocks|a block]]. It's also a good idea to visit [[tutorial:applychanges|Applying changes without restarting Minecraft]].
-===== Advice =====
+===== 조언 =====
   * 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.
-===== Troubleshooting =====
+===== 문제점 해결 =====
-==== Missing sounds ====
+==== 소리가 없는 문제 ====
-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''.
+때때로 IDE를 통해 gradle 프로젝트를 불러올때, 에셋이 제대로 다운로드 되지 않을 때가 있습니다. 이럴 때는, ''downloadAssets'' task를 직접 실행하거나 IDE의 Gradle 메뉴를 이용해 task를 실행하거나, 간단하게 커맨드 쉘(cmd, powershell, bash 등등)을 통해 ''gradlew downloadAssets''를 실행하면 해결됩니다.