| 장르 | 재미, RPG, 월드 생성 |
|---|---|
| 게임버전 | 1.21 |
| API | 페이퍼 |
| 원산지 | 국산 |
| 개발자 | didi78579 |
| 저작권 | 알수 없음 |
| 자료 출처 | https://github.com/didi78579/DD_RPG |
| 소스 | https://github.com/didi78579/DD_RPG |
- ALL IN ONE 바닐라 마크 RPG 플러그인 -
로비,사냥터,보스,강화,합성,뽑기,경제,기타등등
플러그인 하나로 RPG서버가 가능한 플러그인(*Beta*)
(현생이슈로 여까지만 만들었고 추후 업데이트 기다린다면 꽤 걸릴 수 있습니다.)
(마저 만들어 줄사람 환영)
DD_RPG-1.0-SNAPSHOT.jar
디디 RPG 1.0.0.mrpack
-디코-
https://discord.gg/c7BvAjfPFT
ai 요약
(자세한 건 디코섭에서 문의 받음)
# DD_RPG 플러그인 가이드
Paper **1.21.x**용 RPG 플러그인입니다. 스탯 전투, 직업·스킬, 강화·합성, 사냥터, 보스 레이드, 로비·경제·상점까지 한 서버 루프로 묶여 있습니다.
---
## 1. 한눈에 보는 구조
| 영역 | 역할 |
|------|------|
| **로비** (`DD_RPG_lobby`) | 접속·전직·NPC(사냥/강화/합성/상점/길드/보스) |
| **사냥터** (`DD_RPG_hunt_*`) | 레벨 구간별 월드, 드랍 → 배낭 → 판매 |
| **보스전** (`DD_RPG_raid_*`) | 토벌 → 클리어 기록 → 전직 조건 |
| **성장** | 레벨·강화·합성·장신구·직업 스킬 |
| **경제** | 디디코인, `/sell`, 상점·뽑기·경매 |
일반 유저는 **명령어보다 로비 NPC**로 대부분을 씁니다. 많은 관리 명령은 기본이 **op**입니다.
---
## 2. 설치·실행
**요구사항**
- Paper **1.21.11** 권장 (API 1.21), **Java 21**
- 클라이언트 모드팩 (필수) -
---
## 3. 플레이어 플레이 루프
1. **접속** → 로비 이동
2. **무직이면** 1차 전직 GUI 자동
3. 로비 NPC로 **사냥터** 입장 → 몹 처치 → **배낭**에 드랍
4. `/sell`로 **디디코인** 환전
5. **강화 / 합성 / 상점·장신구 뽑기**로 장비 성장
6. **보스 토벌** → 클리어 누적
7. 레벨·보스 조건 충족 시 **2·3·4차 전직** GUI
8. 직업 스킬(R/C/F 등)로 전투
로비 **지옥문**은 네더가 아니라 **일반 월드(허브) 스폰**으로 즉시 이동합니다.
---
## 4. 기능별 설명
### 스탯·전투
- 장비·레벨·직업 보너스를 합쳐 체력/공격/방어/주문력/관통/흡혈 등 계산
- `/stat`으로 확인, 사이드바에 요약
- 물리·마법 모두 방어 상수·가중치로 감쇠 (`config.yml` → `stats.combat`)
- **PvP 피해는 약 1/5** (`CombatCalculator` 고정값 0.2). 피흡도 **실제 적용 피해** 기준
- 보스·스킬 피해는 별도 헬퍼/스킬 코드 경로
### 레벨
- 상한·경험치 곡선: `level` 섹션
- `/level` 조회, 관리는 `DD_RPG.level.admin`
### 직업·스킬
| 단계 | 대략 | 내용 |
|------|------|------|
| 1차 | 시작 | 검사/마법사/창/전사/아쳐 등 |
| Lv.10 | 우클 계열 | 찌르기·간파 등 |
| 2차 @20 | R | 전직 분기 + 레이드 게이트 |
| 3차 @40 | C | |
| 4차 @60 | F | |
- **전직 조건**: 해당 레벨 **이하**이면서 **컨트롤러가 있는** 보스를 모두 토벌
- `/직업`은 **관리자 전용**. 유저는 로비(무직)·보스 클리어 후 자동 GUI
- 스킬: Keybind 또는 `/skill r|c|f`
### 강화 (대장간)
- 무기 +0~30, 재료 티어·성공/유지/하락 확률
- 로비 **금 블록 NPC** 또는 `/enhance`(기본 op)
- 성공 시 로비 채팅 알림, **+20 이상**이면 축하 효과음
### 합성
- 같은 등급 장식 갑옷 3개 → 상위 등급
- 로비 **철 블록 NPC**
- 성공 시 로비 알림, **금 등급 이상**이면 축하 효과음
### 정제·일일 등
- 시간 걸리는 정제, 일일 보상 등이 합성/상점 흐름에 연결됨 (`refine.yml`, `daily-rewards.yml`)
### 사냥터
- `hunt.grounds`의 구간별 월드
- 엘리트·레벨 스케일·몹 배율은 config
- `/hunt`는 기본 op → 유저는 로비 **에메랄드 NPC**
- 허브(`world` 등)에서 네더/엔드 **포탈 출입 차단**
### 배낭·판매·돈
- 사냥 드랍은 **배낭** (`/bag`, 마음대로 꺼내기 어려움)
- `/sell` GUI로 판매 → **디디코인**
- `/money` 잔액, 관리자는 give/set/take
### 상점·장신구·경매
- 유틸 포션, 대장간 랜덤 갑옷, **장신구 뽑기**
- 희귀 이상 뽑기 → 로비 알림 / 에픽 이상 축하음
- `/accessory`로 4슬롯 장착
- `/auction` 플레이어 경매
### 길드
- 생성·가입·해산 등. 명령은 기본 op → 유저는 로비 **청금석 NPC**
- 보스전 초대 등에 사용
### 보스 레이드
- `/raid` 또는 로비 **네더라이트 NPC**
- 대기 후 전용 아레나 월드 + 스케매틱
- 토벌 성공 → 클리어 저장 → 로비 전체 알림(난이도별 색/꾸밈) → 전직 가능하면 GUI
- 제한 시간·전멸 시 실패·로비 귀환
대표 보스 예: 사막 수호자(낙타), 묵시록의 마녀, 쿵푸 팬더, 엘더 가디언 등 (config `raid.bosses` + `controller`)
### 로비
- 접속 시 텔레포트, 풀피 회복, 모험 모드
- **더블점프(대시)**
- NPC 마커 블록으로 기능 구분 (스케매틱에 심어두어야 함)
---
## 5. 명령어 요약
| 명령 | 기본 권한 | 비고 |
|------|-----------|------|
| `/lobby` | 전원 | `paste`/`setspawn`/`reload`는 admin |
| `/raid` | 전원 | join/start |
| `/skill`, `/stat`, `/level` | 전원 | level 조작은 admin |
| `/sell`, `/bag`, `/money`, `/auction`, `/accessory` | 전원 | money 조작은 admin |
| `/job` | **op** | 관리자 전직 도구 |
| `/enhance`, `/synthesize`, `/hunt`, `/shop`, `/guild` | **op** | 유저는 로비 NPC |
---
## 6. 다른 사람이 쓸 때 꼭 알 점 (주의사항)
1. **`config-sync.force-from-jar`**
`true`면 기동마다 jar 안 config로 **덮어씀**(백업 `.bak`). 서버에서 설정을 고칠 거면 **`false`**.
2. **WorldEdit 필수에 가깝다**
없으면 로비·보스 맵 붙여넣기가 안 되거나 경고만 나고, NPC/스폰 마커가 깨질 수 있음.
3. **스케매틱 이름 규칙**
- 로비: `lobby.schem`
- 보스: **`boss_10.schem`처럼 id와 동일**
- 붙이는 위치·마커(옵시디언=플레이어, 우는 옵시디언=보스 등) README 준수
4. **전직은 `/직업`이 아님**
유저 전직 = 로비/보스 클리어 자동. `/직업`은 강제·디버그용.
5. **컨트롤러 없는 보스**
config에만 있고 AI가 없으면 토벌·전직 게이트에 안 잡힐 수 있음.
6. **높은 체력**
보스/플레이어 HP가 크면 Paper/Spigot `maxHealth` 상한을 올려야 할 수 있음.
7. **월드 이름 충돌**
`DD_RPG_lobby`, `DD_RPG_hunt_*` 등을 다른 플러그인과 겹치지 말 것. 레이드 월드는 임시이며 재시작 시 고아 월드 정리됨.
8. **PvP 밸런스**
피해 1/5은 코드 고정. 바꾸려면 `CombatCalculator.PVP_DAMAGE_SCALE` 수정 후 빌드.
9. **권한**
상점·길드·사냥터 명령을 유저에게 열려면 LuckPerms 등으로 `DD_RPG.*.use`를 따로 줘야 함. 설계상은 NPC 위주.
10. **로컬 `deployPlugin` 경로**
개발자 PC용 복사 경로가 하드코딩돼 있을 수 있음. 다른 환경에서는 `jar`만 쓰면 됨.
---
## 7. 관리자 초기 세팅 체크리스트
1. Paper 1.21 + Java 21, 플러그인 jar 설치
2. WorldEdit 설치(또는 auto-download 허용)
3. 기동 후 `config-sync`를 운영에 맞게 조정
4. `schematics/lobby`, `schematics/bosses` 확인
5. `/로비 paste` · NPC 스폰 확인
6. 테스트 계정으로: 전직 → 사냥 → 판매 → 강화/합성 → 보스 1회
7. 전직 게이트용 보스 클리어 진행 확인 (`boss-clears.yml`)
---
## 8. 데이터 파일 (백업 대상)
`plugins/DD_RPG/` 안 예:
`config.yml`, `levels.yml`, `jobs.yml`, `economy.yml`, `bags.yml`, `guilds.yml`, `boss-clears.yml`, `accessories.yml`, `auction_data.yml`, `refine.yml`, `daily-rewards.yml`, `schematics/` …
---
요약하면, 이 플러그인은 **로비를 허브로 한 레벨링 RPG**이고, 전투는 전부 스탯 공식, 성장은 강화·합성·장신구·직업, 엔드 콘텐츠는 **보스 토벌 = 전직 열쇠**입니다. 다른 서버에 올릴 때는 **WorldEdit·스케매틱·config-sync·권한(NPC vs 명령)** 네 가지만 먼저 맞추면 대부분 안정적으로 돌아갑니다.
원하면 이 내용을 `README.md`로 저장해 줄 수도 있습니다.
댓글이 없습니다.
새로운 댓글을 등록해 주세요!