본문 바로가기

DP-RandomChallenge개요

소개

DP-RandomChallenge는 플레이어마다 개인 랜덤 챌린지(미션) 를 배정하고, 목표를 달성하면 보상을 지급하는 플러그인입니다. 챌린지 제작과 보상 설정은 모두 게임 안 GUI에서 하며, config 파일에 챌린지를 직접 쓸 필요가 없습니다.

주요 기능

  • 전투·수집·탐험·생존·건축 5분류, 43가지 챌린지 타입
  • 타입별 필수 값(목표 수량, 대상 몹 등)과 선택 필터(월드, 무기, 바이옴 등)를 GUI에서 설정
  • 플레이어마다 독립적인 챌린지와 진행도, 재시작 후에도 유지
  • 4가지 갱신 모드: TIME, COMPLETE, MIXED, FIXED
  • 보상: 돈(경제 플러그인), 아이템(27칸 GUI에 직접 넣기), 콘솔 명령어
  • 진행도 변동 시 액션바 표시, 내 챌린지 현황 GUI(최근 완료 이력 포함)
  • PlaceholderAPI 플레이스홀더, 다른 플러그인용 개발자 API와 이벤트
  • 영어 / 한국어 메시지 지원

작동 방식

  1. 플레이어가 접속하면, 챌린지가 없거나 시간이 지난 경우 랜덤 챌린지를 자동 배정합니다 (FIXED 모드 제외).
  2. 플레이(몹 처치, 채광, 이동 등)가 진행도에 반영됩니다.
  3. 목표를 달성하면 보상을 지급하고, 갱신 모드에 따라 다음 챌린지를 줍니다.

챌린지가 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() 을 확인하세요.