Spigot 및 Paper 플러그인

Bukkit/Spigot/Paper 유형은 Paper, Spigot 및 그 포크에서 실행되는 서버 플러그인을 만들어요. Java(Maven 프로젝트) 또는 Kotlin(build.gradle.kts를 쓰는 Gradle 프로젝트)을 고르세요.

게임에서 플러그인을 플레이해 보려면 지금 체험하기로 비공개 테스트 서버를 시작하세요.

요청을 보내면 Codexe가 플러그인이 어떤 Minecraft 버전용인지 물어봐요. 1.8.8부터 26.3까지 고를 수 있어요. 코드는 그 버전의 API와 Java 수준에 맞춰 작성되고, 테스트 서버도 그 버전으로 실행돼요. 2026년 9월 30일 이전에 만든 프로젝트는 빌드 파일에 적힌 버전을 그대로 유지해요.

#요청에 넣을 내용

• 서버 소프트웨어와 버전: "Paper 1.21.4" 또는 "Spigot 1.20.1". Paper는 Spigot보다 API가 더 넓어요. Spigot용으로 작성한 코드는 Paper에서 실행되지만 그 반대는 안 되므로, 둘 다 필요하면 Spigot으로 요청하세요.
• 명령어와 인수, 사용할 수 있는 사람, 탭 자동 완성.
• 권한과 기본값(true, op, false).
• 수정할 수 있게 하고 싶은 config.yml 키.
• 저장 방식: YAML, SQLite, MySQL, 또는 메모리.
• 연동: Vault, PlaceholderAPI, LuckPerms, WorldGuard… 의존성으로 추가되도록 이름을 분명하게 적으세요.

A Paper 1.21.4 plugin (Java) called Bounties.
- /bounty set <player> <amount>: takes money via Vault, adds it to the player's bounty.
- Killing a player with a bounty pays it to the killer.
- /bounty top shows the 10 highest bounties.
- Bounties stored in SQLite. Minimum bounty 100 (config.yml).
- Permission bounties.set (default true).

A Paper 1.21.4 plugin in Kotlin called Bounties, same features as above.
Use Kotlin idioms (data classes, extension functions) but keep the Bukkit API usage standard.

#Codexe가 생성하는 것

• 올바른 API 의존성을 갖춘 Maven 프로젝트(Java) 또는 Gradle 프로젝트(Kotlin).
• JavaPlugin을 상속하는 메인 클래스와 명령어, 리스너, 저장소 클래스.
• 메인 클래스, api-version, 명령어, 권한이 담긴 plugin.yml, 그리고 설정이 있으면 config.yml.

name: Bounties
version: 1.0.0
main: eu.codexe.bounties.Bounties
api-version: '1.21'
depend: [Vault]
commands:
  bounty:
    description: Manage bounties
permissions:
  bounties.set:
    default: true

#버전과 Java

Codexe는 빌드 파일에서 Minecraft 버전을 읽어 Java 17(1.20.5 이전), Java 21(1.20.5 이상), Java 25(26.x)로 빌드해요. 버전을 말하지 않으면 Paper/Spigot API 1.20.6을 써요.

#빌드와 검증

Codexe는 플러그인을 준비됨으로 표시하기 전에 컴파일하고, JAR에 클래스와 plugin.yml(또는 paper-plugin.yml)이 들어 있는지 확인해요. 플러그인 빌드는 보통 1분도 안 걸려요. 컴파일을 참고하세요.

#설치

JAR를 내려받아 plugins/에 넣고 서버를 재시작한 다음(/reload는 쓰지 마세요), 시작할 때 콘솔에 오류가 없는지 확인하세요.

#자주 생기는 문제