마인크래프트를 같이 개발해보자 [JE] - Day 01

 

제미나이의 도움을 받아 오늘부터 마인크래프트 개발 일지를 작성해보려합니다.

창작욕이 넘치시지만 개발을 어디서부터 시작해야 할지 모르는 저와 같은 분들에게 도움이 되길 바라며 시작해보겠습니다. 첫 날은 프로젝트를 띄운 후 Hello World 까지 출력하는것이 목표입니다.

질문

마인크래프트 모드 개발을 처음 시작하려고해.
IntelliJ IDEA 기준으로
어떤 개발 환경부터 세팅하는 것이 가장 효율적일까?

🤖 AI 정리 · 개발 환경 Best Practice

IntelliJ IDEA Ultimate를 사용하고 있다면 마인크래프트 1.20.1 기준으로 다음 3가지를 먼저 준비하는 것이 가장 효율적입니다.

1️⃣ JDK 17 (Microsoft Build of OpenJDK 권장)
마인크래프트는 버전마다 요구하는 Java 버전이 다르며, 1.20.1 버전은 반드시 Java 17을 사용해야 합니다.
Java 8이나 11을 사용하면 실행조차 되지 않습니다.

개발자 Tip
오라클 JDK보다 마인크래프트 런처가 기본적으로 사용하는 Microsoft Build of OpenJDK 17을 설치하는 것이 호환성 면에서 가장 안전합니다.
이미 로컬에 Java 17이 설치되어 있다면 그대로 사용해도 무방합니다.

2️⃣ IntelliJ 플러그인: Minecraft Development
이 플러그인은 선택이 아니라 필수입니다.
IntelliJ의 강력한 기능을 마인크래프트 개발에 최적화해 줍니다.

설치 방법
IntelliJ 실행 → Settings (Ctrl + Alt + S) → Plugins → Marketplace
Minecraft Development 검색 후 다운로드 수가 가장 많은 플러그인 설치

주요 기능
- Forge / Fabric 프로젝트 자동 생성
- 마인크래프트 이벤트, NBT 태그 자동 완성
- Mixin 문법 오류 검사

3️⃣ Blockbench
몬스터 및 아이템 모델링을 위한 필수 툴입니다.
Blockbench 공식 홈페이지에서 Windows 앱 버전 설치를 권장합니다.
(웹 버전보다 단축키 및 작업성이 훨씬 좋습니다.)

 

1. Java 17 설치

• SDK 의 경우 제 티스토리 게시글중 SDKMan 설치 방법을 확인하여 유연한 버전관리를 하심을 추천드립니다.

https://happy-persimmon.tistory.com/11

[Window 11] 윈도우 11환경 SDK Man 설치 진행

 

2. Minecraft Development Plugin 설치

• 인텔리제이는 Community 또는 Ultimate 버전을 사용합니다. 어떤 버전을 사용해도 상관은 없지만 제 경우 Ultimate 버전을 사용하기때문에 가이드와 다를 수 있습니다.
• 인텔리제이를 처음 실행을 하면 아래와 같은 창을 확인할 수 있습니다. 플러그인 메뉴를 클릭 해 Minecraft 개발에 필요한 확장 프로그램을 설치해볼 예정입니다.

인텔리제이 첫 화면

 

• 제 경우 이미 설치가 된 상태여서 비활성화 라고 표시되지만 설치 버튼을 클릭 후 Restart IDE 버튼을 눌러주세요

 

3. 프로젝트 생성

• 새 프로젝트 버튼을 클릭하여 첫 마인크래프트 프로젝트를 생성해봅시다.

 

• 이름 : 프로젝트 이름입니다.
• 위치 : 해당 프로젝트파일들을 관리할 장소입니다.
• Groups : 첫 스텝으로는 Mod 개발을 진행할 예정이기때문에 Mod를 선택해주세요
• Templates : Groups와 같은 이유로 Forge로 해주세요
• Minecraft Version : 안정적인 버전을 위해 1.20.1 Forge 47.4.16 을 선택해주세요
• Main Class : Mod 의 코드가 실행될 스타트 클래스 이름을 지정해줍니다. 공부를 진행하며 알게 될 예정이기때문에 가독성 좋게만 작명해주세요
• Group ID : 클래스들이 관리될 그룹 ID 입니다. Main Class와 마찬가지로 가독성 좋게만 작명해주세요

 

• 시작부터 에러가 발생해서 잘못되었다고 생각 할 수 있지만 오른쪽 하단을 보면 'JoseonFarm Gradle 프로젝트 가져오는중' 이라는 문구와 process 진행이 되고있음을 확인 할 수 있습니다.
• 프로젝트에 필요한 구성들을 자동으로 세팅해주고 있다고 이해해주시면 될 것 같습니다.
• 5~10분 정도 Gradle 설치 시간이 소요됩니다.

 

• 아래와 같이 하단에 실행이 완료되었다는 문구가 확인되면 우측 메뉴에서 runClient를 실행시켜주세요.
• 실행 후 Minecraft가 실행된다면 첫 스텝은 완료한 것입니다.

 

 

Day01 오늘은 개발에 필요한 첫 구성 작업을 완료하였는데요. 다음 시간에는 본격적으로 옛 우리 조상님들이 사용하던 화폐인 엽전을 적용시켜보겠습니다. 감사합니다.