IntelliJ IDEA

모드 템플릿은 IntelliJ IDEA에서 바로 열 수 있는 Gradle 프로젝트이고, runClient 실행 구성(.run/runClient.run.xml)도 들어 있습니다.

준비

• IntelliJ IDEA 2025.2 이상(Community 가능)
• JDK 25

절차

1. 프로젝트 열기
   File → Open에서 settings.gradle.kts가 있는 프로젝트 폴더를 엽니다. Gradle 프로젝트로 인식되면 Trust Project를 누릅니다.

2. JDK 지정
   Project SDK를 JDK 25로 맞춥니다. Settings → Build, Execution, Deployment → Build Tools → Gradle에서 Gradle JVM을 JDK 25(또는 17 이상)로 지정하고, Build and run using은 기본값 Gradle로 둡니다. 게임 실행이 Gradle 작업으로 이루어지기 때문입니다.

3. 실행과 디버그
   실행 구성 목록에서 runClient를 실행하거나 디버그(벌레 아이콘)로 시작합니다. IntelliJ가 Gradle의 게임 실행 작업에 디버거를 연결해 주므로 모드 코드에 중단점을 걸 수 있습니다.

창 없이 확인하기

worldCreateSaveTest는 화면 없이 게임 테스트 서버에서 모드를 로드해 확인합니다. Gradle 창이나 터미널에서 실행하세요.

Windows (PowerShell)

.\gradlew.bat worldCreateSaveTest

macOS · Linux (bash)

./gradlew worldCreateSaveTest

로그

실행 로그는 run/client/logs/latest.log(서버는 run/server/logs/latest.log)에 남습니다.

사람 확인이 필요한 부분

명령은 모두 CLI에서 검증했지만, IntelliJ 화면에서의 동작(프로젝트 가져오기, 실행 구성, 중단점)은 아직 사람이 직접 확인하지 않았습니다. 문제가 있으면 문제 해결을 참고해 알려 주세요.