DP-RandomChallenge개요
소개
DP-RandomChallenge는 플레이어마다 개인 랜덤 챌린지(미션) 를 배정하고, 목표를 달성하면 보상을 지급하는 플러그인입니다. 챌린지 제작과 보상 설정은 모두 게임 안 GUI에서 하며, config 파일에 챌린지를 직접 쓸 필요가 없습니다.
주요 기능
- 전투·수집·탐험·생존·건축 5분류, 43가지 챌린지 타입
- 타입별 필수 값(목표 수량, 대상 몹 등)과 선택 필터(월드, 무기, 바이옴 등)를 GUI에서 설정
- 플레이어마다 독립적인 챌린지와 진행도, 재시작 후에도 유지
- 4가지 갱신 모드:
TIME,COMPLETE,MIXED,FIXED - 보상: 돈(경제 플러그인), 아이템(27칸 GUI에 직접 넣기), 콘솔 명령어
- 진행도 변동 시 액션바 표시, 내 챌린지 현황 GUI(최근 완료 이력 포함)
- PlaceholderAPI 플레이스홀더, 다른 플러그인용 개발자 API와 이벤트
- 영어 / 한국어 메시지 지원
작동 방식
- 플레이어가 접속하면, 챌린지가 없거나 시간이 지난 경우 랜덤 챌린지를 자동 배정합니다 (
FIXED모드 제외). - 플레이(몹 처치, 채광, 이동 등)가 진행도에 반영됩니다.
- 목표를 달성하면 보상을 지급하고, 갱신 모드에 따라 다음 챌린지를 줍니다.
챌린지가 2개 이상이면 직전 챌린지는 빼고 뽑습니다.
지원 환경
| 항목 | 값 |
|---|---|
| 서버 소프트웨어 | Spigot / Paper 및 호환 포크 (api-version: 1.21) |
| 지원 버전 | 1.21.5 ~ 26.1.2 |
| 필수 의존 플러그인 | DPP-Core 5.4 이상 |
| 선택 연동 | PlaceholderAPI (플레이스홀더), EssentialsX 등 경제 플러그인 (돈 보상) |
개발자 API
다른 플러그인은 com.darksoldier1404.dprdch.api.RandomChallengeAPI 의 정적 메서드로 챌린지를 조회·부여·제거하고 진행도를 바꿀 수 있습니다 (assignChallenge, assignRandom, clearChallenge, addProgress, setProgress, completeChallenge, createChallenge, saveChallenge 등). 배정·진행·완료 시점에는 ChallengeAssignEvent, ChallengeProgressEvent, ChallengeCompleteEvent 가 발생합니다. 모든 메서드는 메인 스레드에서 호출하고, softdepend로 연동할 때는 먼저 RandomChallengeAPI.isAvailable() 을 확인하세요.