본문으로 건너뛰기
시작하기

첫 프로젝트 만들기

실제 첫 프로젝트인 Paper 홈 플러그인을 요청부터 테스트한 JAR까지 따라가 보는 안내서예요.

업데이트됨

이 페이지에서
  1. 요청
  2. 그다음에 일어나는 일
  3. 결과 살펴보기
  4. 무언가 바꿔 보기
  5. 빌드하고 테스트하기
  6. 다음 단계

이 안내서에서는 작지만 실제로 쓸 수 있는 플러그인을 만들면서 모든 단계를 한 번씩 거쳐 봐요. 어떤 프로젝트 유형이든 흐름은 똑같아요.

#요청

만들기에서 Bukkit/Spigot/Paper 플러그인 (Java) 유형을 고르고 다음과 같이 적어요.

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

이 요청에 무엇이 들어 있는지 보세요. 플랫폼과 버전, 각 명령어와 그 동작, 타이밍 규칙, 저장 방식, 권한, 그리고 무엇을 설정 가능하게 할지가 모두 담겨 있어요. 이런 내용 덕분에 첫 결과물부터 바로 쓸 만해져요.

#그다음에 일어나는 일

  1. Codexe가 파일을 실시간으로 작성해요. Maven pom.xml, 메인 클래스, 명령어 및 리스너 클래스, plugin.yml, config.yml이 만들어져요.
  2. 배너가 프로젝트를 확인하는 중… 상태를 거쳐 빌드하는 중… 상태로 바뀌어요. Codexe가 플러그인을 컴파일하는 단계예요.
  3. 컴파일러가 오류(예: 잘못된 import)를 보고하면 문제를 고치는 중… 표시가 나타나요. Codexe가 코드를 고치고 다시 빌드해요. 이 과정에는 토큰이 사용되지 않아요.
  4. 프로젝트가 준비됨 상태가 돼요.

#결과 살펴보기

  • plugin.yml을 열어 명령어와 권한이 요청한 내용과 일치하는지 확인하세요.
  • config.yml을 열어 보세요. 쿨다운과 메시지가 들어 있어야 해요.
  • 메인 클래스를 훑어보세요. 모든 줄을 이해할 필요는 없지만, 눈에 띄게 빠진 부분은 찾아낼 수 있어요.

#무언가 바꿔 보기

프로젝트 채팅에 다음과 같이 입력해요.

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe는 처음부터 다시 만들지 않고 기존 파일을 수정해요. 영향을 받는 파일만 다시 작성되기 때문에 후속 요청은 새 프로젝트보다 훨씬 적은 비용이 들어요. 빌드할 수 있는 프로젝트를 변경하면 Codexe가 다시 검증해요.

#빌드하고 테스트하기

컴파일을 눌러 새로 빌드한 다음 JAR 다운로드를 누르세요. JAR를 서버의 plugins/ 폴더에 넣고 재시작하세요. 모든 명령어를 테스트하고, 예외 상황(워밍업 중 이동, 쿨다운, 재시작)도 꼭 확인하세요.

#다음 단계

첫 프로젝트 만들기 | Codexe Docs