Skip to content
Erudites Docs
GitHub

프로젝트 설정

작성자: S. Lee
작성일: 2025년 7월 26일
수정일: 2025년 7월 27일

프로젝트는 IntelliJ를 사용하여 작성하고, Gradle을 사용하여 빌드합니다. 이 과정에서 Paper API를 사용하여 플러그인을 작성합니다.

IntelliJ IDEA 설치

Section titled “IntelliJ IDEA 설치”

JetBrains ToolBox를 설치하고, ToolBox를 통해 IntelliJ IDEA를 설치합니다.

IntelliJ IDEA를 설치한 후, IntelliJ에서 Minecraft Development Plugin을 설치합니다.

Install JetBrains Toolbox
Install MCDev Plugin
Install IntelliJ IDEA and MCDev Plugin

프로젝트 생성

Section titled “프로젝트 생성”

Project 페이지에서 New Project를 선택하고, Java를 선택합니다.

이름을 작성하고, 경로를 선택합니다. (e.g. C:\Users\admin\Documents\GitHub\erudites-dev\erudites-plugin)

Build System은 Gradle을 선택하고, JDK는 21, Gradle DSL은 Kotlin을 선택합니다.

Gradle Version은 8.12 이상을 선택합니다.

Group ID는 도메인을 뒤집은 형태로 작성합니다. (e.g. dev.erudites)

Artifact ID는 이름과 동일하게 작성합니다. (e.g. erudites-plugin)

New Project
New Project

Gradle 종속성 설정

Section titled “Gradle 종속성 설정”

Paper Docs를 참고하여 프로젝트를 설정합니다.

먼저 build.gradle.kts를 수정합니다. 다음과 같이 작성합니다:

build.gradle.kts
java {
    toolchain.languageVersion.set(JavaLanguageVersion.of(21))
}

repositories {
    mavenCentral()
    maven("https://repo.papermc.io/repository/maven-public/")
}

dependencies {
    compileOnly("io.papermc.paper:paper-api:1.21.1-R0.1-SNAPSHOT")
}

작성 후, IntelliJ IDEA에서 Gradle을 Sync합니다.

리로드 코끼리 아이콘을 클릭하거나, Gradle 탭에서 Sync All Gradle Projects 버튼을 클릭합니다.

Sync Gradle
Sync Gradle

Main 클래스 생성

Section titled “Main 클래스 생성”

Group ID 경로에 메인클래스를 생성합니다. (e.g. dev/erudites/someproject/SomeProjectPlugin.java)

이때, PascalCase로 작성합니다. (e.g. SomeProjectPlugin)

SomeProjectPlugin에 JavaPlugin을 상속받고, onEnable 메서드를 오버라이드합니다.

Main Class
Main Class

Main 클래스 등록

Section titled “Main 클래스 등록”

Paper Docs를 참고하여 plugin.yml 파일을 작성합니다.

plugin.yml
name: SomeProject
version: 0.1.0
main: dev.erudites.someproject.SomeProjectPlugin
authors:
  - EruditesDev
website: https://erudites.dev
api-version: "1.21"
Plugin YML File
plugin.yml File

Build

Section titled “Build”

프로젝트를 빌드합니다. IntelliJ IDEA에서 Gradle 탭을 열고, Tasks > build > build를 선택합니다.

빌드가 성공적으로 완료되면, build/libs 폴더에 JAR 파일이 생성됩니다.

Build Project
Build Project