⚠️ 안내

본 플러그인은 현재 개발 중이며, 아직 정식 출시되지 않았습니다.
출시 시 본 게시글 또는 디스코드를 통해 안내드릴 예정입니다.

📩 문의 / 알림 신청
Discord : drew0414_1

🌍 DRPG_LevelSystem은 무엇이 다른가?

DRPG_LevelSystem은
단순한 RPG 레벨 플러그인이 아닌,
안정성 · 확장성 · 디버깅 편의성을 최우선으로 설계된
RPG 스킬 레벨링 엔진입니다.

기존 RPG 플러그인들이 자주 겪는 문제인

• 데이터 불일치(Desync)

• 복잡한 밸런싱

• 유지보수 난이도

를 구조적으로 해결하는 것을 목표로 개발되었습니다.

 데이터 무결성 & 안정성 설계

✔ 중앙 캐시 기반 데이터 관리

• 모든 플레이어 데이터는 중앙 메모리 캐시를 통해서만 처리

• 명령어/이벤트 사용 후 즉시 저장

• 서버 재부팅 시 데이터 롤백 가능성 차단

✔ 비동기 저장 구조 (Async I/O)

• JSON / SQL(MySQL, SQLite) 저장 로직 전부 비동기 처리

• I/O 부하가 높아도 메인 스레드 블로킹 없음

• 대규모 서버 환경에서도 안정적인 성능 유지

데이터 기반 스킬 시스템 (JSON)

✔ 완전 JSON 정의 구조

• 스킬 EXP 트리거

• 성장 곡선

• 조건 필터

• 보상 로직

모두 Java 코드 수정 없이 .json 파일로 정의

📁 경로 예시

유연한 보상 시스템

• 레벨별 보상 완전 분리 (rewards/*.json)

• NBT 기반 아이템 커스터마이징 지원

  • 이름 / Lore

  • 커스텀 데이터

  • 특수 속성 부여

• 레벨업 보상 알림 포맷 커스터마이징 가능

서버 연동 & 운영 편의

• PlaceholderAPI 연동 예정 (v1.1.0)

  • 레벨 / EXP / 스킬 정보 표시 가능

• LuckPerms 연동 예정

  • 명령어 / 기능 권한 제어

• 최초 실행 시 예제 JSON 자동 생성

  • 비개발자 서버 운영자도 즉시 사용 가능

디버깅 & 오류 대응 시스템

• JSON 파일 구조 및 문법 자동 검사

• 단순 오류 자동 수정 시도

• 치명적 오류 발생 시:

  • 서버 크래시 방지

  • 관리자에게만 상세 경고 출력 (Fail-Safe Mode)

디버그 모드 활성화 시:

• 파일 로드

• 파싱

• 등록 과정

• 오류 원인
  모두 상세 로그 출력

관리자 명령어

• /drpg levelsystem 또는 /drpg ls

• 권한 설정 가능 (LuckPerms 연동 시)

• 캐시 동기화, 데이터 관리 명령 제공

예정된 업데이트 로드맵

▶ v1.1.0

• MySQL / SQLite 지원

• 디버그 로그 세분화

• JSON 예외 처리 강화

• 칭호 시스템 추가

▶ v1.2.0

• 이벤트 타입 대폭 확장

• NBT 기반 조건 / 보상 완전 지원

💬 마무리

DRPG_LevelSystem은
“프로그래머가 아닌 서버 운영자도 깊이 있는 RPG 서버를 만들 수 있게”
하는 것을 목표로 개발 중입니다.

피드백, 개선 제안, 테스트 서버 제안 모두 환영합니다.

❓ Q&A

Q. 이 플러그인은 언제 출시되나요?

A.
현재 핵심 시스템 구현 및 구조 안정화 단계이며,
제작 이후 첫 공개 배포를 목표로 하고 있습니다.
정확한 일정은 확정되는 대로 본 게시글 또는 디스코드를 통해 안내드릴 예정입니다.

Q. Spigot / Paper 어떤 서버에서 사용 가능한가요?

A.
현재 Paper 기반으로 개발 및 테스트 중이며,
Spigot에서도 동작하도록 설계되어 있습니다.
다만 성능 및 안정성을 위해 Paper 사용을 권장드립니다.

Q. 기존 RPG 플러그인과 함께 사용 가능한가요?

A.
가능하도록 설계 중입니다.
본 플러그인은 레벨·스킬 시스템에 집중한 구조이며,
전투/퀘스트/아이템 플러그인과 병행 사용을 전제로 개발하고 있습니다.
(PAPI, LuckPerms 연동 예정)

Q. 서버에 부하가 크지 않나요?

A.
아닙니다.

• 모든 데이터는 중앙 캐시 기반으로 관리되며

• 저장 로직은 비동기 처리

• 이벤트 처리도 최소 연산만 수행하도록 설계되었습니다.

v1.1.0 이후 MySQL/SQLite 적용 시
대규모 서버 환경에서도 안정적으로 동작하도록 개선될 예정입니다.

Q. 스킬이나 레벨 구조를 마음대로 바꿀 수 있나요?

A.
네, 가능합니다.
스킬, 경험치, 조건, 보상은 모두 JSON 파일로 정의되며,
Java 코드 수정 없이 서버 성향에 맞게 자유롭게 커스터마이징할 수 있습니다.

Q. 스킬을 새로 추가하려면 코딩이 필요한가요?

A.
아니요.
새로운 스킬은 JSON 파일 추가만으로 등록 가능하도록 설계되어 있습니다.
개발 지식이 없는 서버 운영자도 사용 가능하도록 예제 파일이 함께 제공될 예정입니다.

Q. XP 파밍이나 악용 문제는 어떻게 처리되나요?

A.

• 반복 행동 감지

• 특정 조건 필터링

• 쿨타임 / 제한 조건
  등을 통해 XP 그라인딩 및 보스 반복 파밍을 방지하는 구조가 적용되어 있습니다.

Q. 오류가 발생하면 서버가 멈추지 않나요?

A.
치명적인 오류가 아닌 경우 서버가 다운되지 않도록 설계되어 있습니다.
JSON 파싱 오류 등은 관리자에게 경고 로그만 출력하며,
Fail-Safe 방식으로 서버 안정성을 우선합니다.

Q. 데이터는 어디에 저장되나요?

A.
현재는 JSON 기반 저장 방식을 사용하고 있으며,
v1.1.0부터 MySQL / SQLite 선택 사용이 가능해질 예정입니다.

Q. 무료인가요? 유료인가요?

A.
현재는 무료 공개를 기준으로 개발 중이며,
추후 상황에 따라 배포 방식은 변경될 수 있습니다.
(변경 시 사전 공지 예정)

Q. 피드백이나 테스트 서버 참여는 어떻게 하나요?

A.
아래 디스코드로 연락 주시면 됩니다.
테스트 서버 제안, 기능 개선 요청, 버그 리포트 모두 환영합니다.

📩 Discord : drew0414_1

Q. 소스코드는 없나요?

A. 

소스코드는 아쉽게도 없습니다. 대신 메뉴얼이 있습니다.

아래에 있는 링크를 누르시면 됩니다.

https://github.com/drewdrew0414/DRPG_levelSystem