RpgUpgradePlugin

- 시스템 안내용 아이템 또는 책 최초 지급은 플레이어별로 한 번만 진행해라. 사망, 재접속, `/reload`를 했다고 기본 아이템이 중복 지급되지 않게 해라. 기본 아이템이 인벤토리에 들어갈 공간이 없다면 바닥에 떨어뜨리거나 다시 지급할 수 있도록 처리해라. ## 3. 강화석 아이템과 채굴 획득 시스템 '강화석'이라는 전용 아이템을 만들어라. - 이름은 한국어 `강화석`으로 표시해라. - 일반 돌, 석탄 광석, 철 광석, 금 광석, 다이아몬드 광석, 레드스톤 광석, 청금석 광석, 에메랄드 광석, 구리 광석 등 채굴 가능한 블록을 캤을 때 강화석이 추가로 나올 수 있게 해라. - 가능하면 네더 및 엔드의 주요 광물도 포함해라. - 광물 블록의 원래 드롭 아이템은 정상적으로 유지해라. - 강화석은 기존 드롭에 추가되는 보너스 아이템이어야 한다. - 획득 확률은 테스트하기 편할 정도로 비교적 높게 설정해라. 기본 목표는 블록당 약 10~15%로 하되, 실제 채굴 환경에서 너무 낮거나 높으면 조정하기 쉽게 설정값을 분리해라. - 행운 인챈트와 섬세한 손길 등 기존 채굴 기능을 가능한 한 보존해라. - 같은 블록에서 강화석이 중복으로 지급되는 버그를 방지해라. - 플레이어가 직접 캔 경우에만 지급하고, 폭발이나 다른 시스템으로 파괴된 블록에서 무한 생성되지 않도록 해라. 확률을 실제로 구현할 수 없는 블록이나 특수한 상황은 별도로 명시해라. ## 4. 모루를 이용한 무기 강화 시스템 강화석과 무기를 모루에서 조합해 강화하는 시스템을 만들어라. 목표 사용 방식: 1. 모루 왼쪽 슬롯에 강화할 무기를 넣는다. 2. 다른 슬롯에 강화석을 넣는다. 3. 강화 결과로 기존 무기의 능력치 중 하나가 무작위로 +1 증가한다. 4. 강화에 성공한 무기를 결과 슬롯에서 가져간다. 가능하다면 기존 내구도를 수리하는 방식과 비슷한 사용감을 제공해라. 다만 실제로 무기를 수리하면서 강화도 진행할 수 있는지 확인하고, 불가능하면 모루 사용 방식이 최대한 비슷하게 느껴지도록 구현해라. ### 강화 대상 - 검 - 도끼 - 곡괭이 - 삽 - 괭이 - 활 - 쇠뇌 - 삼지창 - 철퇴 - 방어구 등 추가 확장이 가능한 구조 ### 강화 능력치 기존 마인크래프트 인챈트와 동일한 효과를 단순히 부여하는 방식은 사용하지 마라. 예를 들어 날카로움, 강타, 발화 등의 인챈트를 새로 부여하는 것이 아니라 실제 능력치 또는 커스텀 전투 시스템의 수치를 변경해야 한다. 무기 강화 능력치 예시: - 공격력 +1 - 공격 속도 +1 - 사거리 +1 - 치명타 확률 +1 - 치명타 피해 +1 - 추가 피해 +1 - 몬스터 대상 추가 피해 +1 - 넉백 수치 +1 방어구 능력치 예시: - 방어력 +1 - 추가 체력 +1 - 피해 감소 수치 +1 - 이동 속도 +1 - 넉백 저항 +1 도구 능력치 예시: - 채굴 속도 +1 - 채굴 드롭 보너스 확률 +1 - 내구도 관련 보너스 +1 위의 +1은 각 능력치의 의미에 맞게 구현해야 한다. 확률은 퍼센트 단위, 공격력은 실제 피해 수치 등으로 구분해라. 모든 능력치를 무조건 같은 단위로 취급하지 마라. ### 중요한 구현 조건 바닐라 마인크래프트 데이터팩은 인챈트와 달리 공격력·공격 속도·치명타·사거리 등의 수치를 모든 무기에 자유롭게 추가하는 데 한계가 있을 수 있다. 따라서 다음을 지켜라. - 26.3에서 지원하는 아이템 속성 및 데이터 컴포넌트를 우선 사용해라. - 바닐라에서 직접 적용할 수 없는 능력치는 무기별 커스텀 데이터에 저장하고, 실제 공격 이벤트를 감지해 구현할 수 있는지 확인해라. - 실제 전투 효과가 없는 단순한 로어 텍스트만 바꾸고 구현 완료라고 하지 마라. - 치명타 확률, 추가 피해 등 구현이 불가능하거나 제약이 있는 능력치는 명확히 구분해라. - 바닐라 데이터팩의 이벤트 감지 한계 때문에 구현이 어렵다면 가장 가까운 대체 방식을 제안해라. - 무기 고유 데이터와 강화 수치가 아이템을 버리거나 줍거나, 인벤토리에서 옮기거나, 재접속해도 유지되도록 해라. - 강화석을 소모하고 강화 결과가 확정된 뒤에는 동일 강화가 중복 적용되지 않게 해라. - 강화 결과가 원본 무기의 이름, 설명, 기존 인챈트, 내구도, 기타 데이터를 가능한 한 보존하게 해라. - 이미 강화된 무기도 반복 강화할 수 있게 해라. - 강화 횟수와 현재 능력치를 확인할 수 있게 해라. ### 강화 UI 모루를 이용한 강화가 데이터팩의 실제 기술적 한계 때문에 불가능하다면, 모루를 대체하는 전용 강화 메뉴를 구현해라. 예를 들어 강화용 아이템을 우클릭하거나 전용 책 메뉴를 사용해 강화할 무기를 선택하고, 강화석을 소비하는 방식이다. 단, 구현하지 않은 모루 연동이 작동한다고 표시해서는 안 된다. ## 5. RPG 레벨과 경험치 시스템 플레이어별 레벨, 경험치, 필요 경험치, 스탯 포인트를 관리해라. 기본 규칙: - 시작 레벨: 1 - 시작 스탯 포인트: 3 - 레벨업 1회당 스탯 포인트 3 획득 - 최대 레벨: 100 - 몬스터 처치 등을 통해 RPG 경험치를 획득 - 경험치가 필요량에 도달하면 자동 레벨업 - 경험치가 여러 레벨의 필요량을 초과하면 남은 경험치를 보존하면서 여러 번 레벨업 - 최대 레벨 도달 후 추가 레벨업이 발생하지 않도록 처리 - 모든 플레이어의 데이터는 서로 독립적으로 저장 경험치 공식은 유지보수하기 쉽게 함수 또는 설정값으로 분리해라. 몬스터 처치 경험치도 설정 가능하게 해라. ## 6. RPG 스탯 시스템 다음 기본 스탯을 구현해라. - 힘(STR) - 민첩(DEX) - 지능(INT) 추가로 확장 가능한 구조를 만들어라. - 체력 - 공격력 - 방어력 - 이동 속도 - 치명타 확률 - 치명타 피해 스탯 포인트를 소비해 스탯을 올릴 수 있어야 한다. 각 스탯은 실제 게임 플레이에 영향을 줘야 한다. 수치만 표시하는 기능으로 끝내지 마라. 각 스탯이 어떤 효과를 제공하는지, 수치당 효과가 얼마인지 README에 기록해라. 바닐라에서 직접 구현할 수 없는 효과는 커스텀 전투 시스템 등으로 대체하고 그 한계를 명시해라. ## 7. 스탯 UI 및 메뉴 가능한 범위에서 한국어 RPG 메뉴를 구현해라. 메뉴에는 다음 정보를 표시해라. - 현재 레벨 - 현재 경험치 / 다음 레벨 필요 경험치 - 현재 스탯 포인트 - 힘 / 민첩 / 지능 - 공격력 / 방어력 / 체력 - 무기 강화 횟수 - 강화된 능력치 목록 스탯을 투자하는 버튼과 강화 상태를 확인하는 메뉴를 제공해라. 메뉴는 가능하면 책의 클릭 가능한 버튼, 채팅 컴포넌트, 액션바 등을 활용해 구현해라. 스탯 정보를 채팅창에 한 번 출력하는 것만으로 UI 구현을 완료했다고 하지 마라. 인벤토리 화면의 기존 슬롯을 임의로 변경할 수 있다고 주장하지 마라. 데이터팩에서 가능한 방식으로 구현해라. ## 8. 한국어 명령어 사용자가 쉽게 사용할 수 있도록 가능한 한 한국어 명령어를 제공해라. 원하는 명령어 예시: - `/생성` : 시스템 아이템 또는 메뉴 아이템 지급 - `/스탯` : 현재 스탯 확인 - `/스탯 힘` : 힘 스탯 투자 - `/스탯 민첩` : 민첩 스탯 투자 - `/스탯 지능` : 지능 스탯 투자 - `/강화` : 강화 메뉴 열기 또는 강화 상태 확인 - `/레벨` : 현재 레벨과 경험치 확인 마인크래프트 명령어 파서에서 한글 명령어를 직접 등록할 수 있는지 먼저 확인해라. 직접 등록할 수 없다면, 한국어 별칭을 제공하는 가장 안정적인 방법을 사용해라. 예를 들어 `/trigger` 점수판 명령어나 책의 클릭 버튼을 통해 기능을 실행할 수 있다. 명령어를 지원하지 않으면서 된다고 주장하지 말고, 실제로 작동하는 대체 명령어를 README에 정확히 기록해라. ## 9. 갓 모드 테스트 명령어 개발과 테스트를 위해 관리자 전용 테스트 기능을 반드시 추가해라. 요청하는 사용 방식: ### `/갓 레벨업` - 현재 레벨을 100 증가시킨다. - 최대 레벨 제한을 고려해 최종 레벨이 100을 넘지 않게 한다. - 정상 레벨업 로직을 거쳐야 한다. - 레벨업 1회당 포인트 3개를 지급한다. - 시작 레벨이 1이고 100레벨까지 올린다면 총 99회 레벨업이므로 297포인트를 받아야 한다. - 만약 별도의 테스트 명령으로 정확히 100회 레벨업을 실행한다면 포인트 300개가 지급되어야 한다. - 레벨과 포인트를 채팅에 표시해 결과를 검증할 수 있게 해라. 위 두 상황을 혼동하지 말고 명령어 동작을 명확히 구현해라. ### `/갓 스탯추가` 실행한 플레이어에게 다음 수치를 추가해라. - 사용 가능한 스탯 포인트 +10000 - 힘 +10000 - 민첩 +10000 - 지능 +10000 - 추가한 결과를 채팅으로 표시 ### 추가 테스트 명령어 가능하면 다음도 구현해라. - `/갓 경험치` : 테스트용 경험치 지급 - `/갓 강화석` : 강화석 지급 - `/갓 초기화` : 테스트 데이터 초기화 - `/갓 확인` : 레벨, 경험치, 포인트, 스탯, 강화 데이터 출력 갓 명령어는 관리자 또는 치트 권한이 있는 플레이어만 사용할 수 있도록 보호해라. 일반 플레이어가 악용할 수 없게 해라. 테스트 기능을 사용한 뒤에도 실제 레벨업과 강화 시스템이 정상적으로 작동해야 한다. ## 10. 데이터 저장과 안정성 - 플레이어별 스탯, 레벨, 경험치, 강화 데이터를 저장해라. - 재접속 후 데이터가 유지되게 해라. - `/reload` 이후 점수판과 기능이 정상적으로 작동해야 한다. - 데이터팩이 같은 아이템을 무한 지급하지 않게 해라. - 함수가 매 틱 과도하게 실행되어 렉이 발생하지 않게 해라. - 무한 루프, 중복 이벤트, 아이템 복제, 강화석 무한 생성, 음수 포인트 등 주요 오류를 방지해라. - 죽음, 차원 이동, 아이템 드롭 및 재획득 상황에서도 가능한 한 데이터가 유지되게 해라. ## 11. 확장 가능한 추가 기능 기본 요구사항이 완성된 다음, 26.3의 데이터팩 기능으로 실제 구현할 수 있는 추가 RPG 기능을 최대한 추가해라. 우선순위: 1. 몬스터 처치 경험치 2. 레벨업 알림과 효과 3. 스탯 메뉴 4. 무기 강화 이력 5. 강화 단계에 따른 색상 및 아이템 설명 6. 강화 실패나 파괴 없는 기본 강화 시스템 7. 장비별 능력치 확인 8. 보스 또는 강력한 몬스터 처치 보상 9. 희귀 강화석 또는 고급 강화석 10. 설정을 변경할 수 있는 한국어 관리 메뉴 기존 기본 마인크래프트 기능을 최대한 유지하고, 추가 기능은 서로 충돌하지 않게 만들어라. ## 12. 최종 검증 및 결과물 작업 완료 후 다음을 제공해라. 1. 설치 가능한 전체 데이터팩 ZIP 2. 압축 해제한 데이터팩 폴더 3. 한국어 README 4. 실제 구현된 기능 목록 5. 구현되지 않은 기능과 기술적 한계 6. 26.3 호환성 확인 결과 7. JSON 및 함수 문법 검사 결과 8. 각 테스트 명령어의 예상 결과 9. 새 월드에서 검증하는 절차 최소한 다음 테스트를 수행하거나, 실제 Minecraft 실행 환경이 없어 테스트할 수 없다면 미실행이라고 명확히 표시해라. - 월드 진입 후 기본 아이템 지급 - 재접속 후 아이템 중복 지급 여부 - 광물 채굴 시 강화석 획득 - 강화석과 무기 조합 - 무기 강화 수치가 실제 전투에 반영되는지 - 기존 인챈트와 내구도가 보존되는지 - 레벨업 및 포인트 계산 - `/갓 레벨업` 결과 - `/갓 스탯추가` 결과 - 재접속 후 스탯 및 강화 데이터 유지 - `/reload` 후 정상 작동 - 데이터팩 오류 로그 확인 **가장 중요한 요구사항:** 설명만 제공하지 말고 실제 파일을 만들어라. Minecraft Java Edition 26.3을 기준으로 모든 문법을 확인하고, 실제 구현이 불가능한 부분은 숨기지 말고 기술적 한계와 대안을 명확히 제시해라. 만약 데이터팩은 불가능하지만 모드로 구현이 가능할 수 있으며 jar 파일을 줄 수 있다면 모드로 생성해도 괜찮다.