creator-mods-suite

# Creator Mods Suite **Creator Mods Suite**는 Minecraft 1.21.1을 플레이하는 Minecraft 콘텐츠 크리에이터, YouTuber, 스트리머를 위해 특별히 설계된 종합 모딩 제품군입니다. 녹화 목적의 게임플레이를 향상시키는 8가지 독립적으로 토글 가능한 기능을 제공하며, 단일 멀티로더 코드베이스 내에서 NeoForge와 Fabric 로더를 모두 지원합니다. ## 핵심 목적 이 제품군은 Minecraft용 "감독 도구 키트" 역할을 하여, 크리에이터가 명령어나 키바인딩을 사용해 복잡한 이벤트를 트리거하고, 카메라 앵글을 관리하며, 게임 규칙을 즉석에서 수정할 수 있게 해줍니다. 이를 통해 녹화 세션 중에 일시정지하거나, 메뉴로 나가거나, 게임을 재시작할 필요가 없어 매끄럽고 전문적으로 보이는 영상을 보장합니다. ## 주요 기능 이 제품군은 각각 특정 창작 기능을 담당하는 8개의 개별 모듈로 구성됩니다: 1. **Director's Toolkit (`/toolkit`)**: 화면상의 클래퍼보드, 테이크 마커, 몹/플레이어용 프리즈 스위치, 웨이브 스포너, 아레나 스냅샷, 카메라 북마크, 클린 프레임 HUD 토글을 갖춘 녹화 보조 도구입니다. 테이크를 정밀하게 제어할 수 있습니다. 2. **Ashen Colossus (`/colossus`)**: GeckoLib로 구동되는 애니메이션 3단계 보스 전투입니다. 충격파 강타, 용암 비, 미니언 웨이브, 화염 고리 격노 단계 같은 메커니즘을 포함합니다. 3. **Power Kit (`/power`)**: 대시, 화염 폭발, 지면 강타, 엔더 풀, 방패 돔, 몹 프리즈 등 6가지 키바인드 활성화 능력을 제공합니다. 서버 권위 쿨다운과 핫바 행을 통한 시각적 피드백을 포함합니다. 4. **Rule Engine (`/rule`, `/shop`)**: 11가지 중첩 가능한 옵션(예: 무작위 드롭, 제작 배수, 용암 바닥, 거대 몹)으로 게임 규칙을 실시간 수정할 수 있습니다. 손쉬운 전환을 위한 데이터팩 프리셋을 지원합니다. 5. **Evolve (`/evolve`)**: 각 단계마다 크기, 스탯 부스트, 패시브 능력을 얻는 5단계 플레이어 변신 시스템으로, 파티클 효과와 모델 교체가 동반됩니다. 6. **Event Director (`/event`)**: 블러드 문, 운석, 공성전, 행운의 비, 공허 상승 같은 연출된 월드 이벤트를 트리거합니다. 이벤트는 단계 기반이며 명령어로 시간을 재조정하거나, 건너뛰거나, 중지할 수 있습니다. 7. **Arsenal (`/arsenal`)**: Grapple Blade, Storm Bow, Gravity Hammer, Soul Scythe 등 4가지 고유 무기를 도입하며, 각각 뚜렷한 기계적 상호작용을 가집니다. 8. **Cursed Vault (`/vault`)**: 미니 보스(Vault Keeper)를 소환하는 Cursed Altar와 그것을 처치하면 열리는 봉인된 상자가 포함된 직소 던전 구조물입니다. 한 명령어로 초기화하는 기능을 포함합니다. ## 크리에이터 중심 설계 * **명령줄 제어**: 모든 기능은 채팅 명령어(예: `/colossus phase 3`, `/event skip`)로 제어 가능하여 게임플레이를 방해하지 않고 실시간 조정이 가능합니다. * **사일런트 모드**: 명령어가 채팅 로그 대신 액션 바에만 피드백을 출력하도록 구성할 수 있어, 녹화 영상의 잡음을 방지하면서 운영자에게는 오류 메시지가 계속 보입니다. * **독립적 토글**: 8가지 기능 각각은 구성이나 명령어를 통해 개별적으로 활성화 또는 비활성화할 수 있습니다. 비활성화된 기능은 게임 월드에 아무것도 등록하지 않아 사용하지 않을 때 성능 오버헤드나 시각적 간섭이 전혀 없습니다. * **비간섭 HUD**: 모든 커스텀 HUD 레이어는 바닐라 F1 전체 화면 모드를 존중하며, 명령어로 플레이어별로 정리할 수 있어 다중 카메라 설정에 도움이 됩니다. * **카메라 안전**: 크리에이티브 또는 관전자 모드의 플레이어는 적대적 메커니즘(보스 공격, 환경 위험)의 영향을 받지 않아 카메라 운영자가 장면을 안전하게 비행하며 통과할 수 있습니다. ## 기술 세부 사항 * **호환성**: NeoForge 21.1.250+ 및 Fabric Loader 0.19.5+와 함께 Minecraft 1.21.1을 지원합니다. Java 21이 필요합니다. * **아키텍처**: 게임플레이 로직을 위한 공유 `common/` 모듈을 사용하며, 플랫폼별 진입점과 믹스인을 위한 별도의 `fabric/` 및 `neoforge/` 모듈을 둡니다. 이를 통해 로더 간 동일한 동작을 보장합니다. * **구성**: 단일 `config/creatormods.json` 파일로 관리됩니다. 밸런스 값은 하드코딩된 상수이며, 동적 데이터는 Minecraft 데이터팩을 사용합니다. * **테스트**: 이 프로젝트는 로더당 486개의 JUnit 5 단위 테스트와 134개의 인월드 GameTest를 포함한 광범위한 테스트를 갖추고 있으며, 로직, 네트워킹, 상호작용 게임플레이 시나리오를 다룹니다. * **에셋**: 현재 에셋은 리소스 누락 없이 모드가 실행되도록 프로그래밍 방식(Python 텍스처, ffmpeg 오디오)으로 생성된 임시 자산입니다. 실제 예술 자산은 계획되어 있으나 아직 포함되지 않았습니다. ## 설치 사용자는 소스에서 모드를 빌드하거나, 제공되는 경우 제공된 JAR을 사용해야 합니다. 의존성으로는 GeckoLib(애니메이션에 필요)과 Fabric API(Fabric 빌드용)가 있습니다. 전체 기능을 위해서는 클라이언트와 서버 양쪽에 모드를 설치해야 합니다. ## 라이선스 이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되어, 변경 사항의 의무적 공개 없이 포크, 수정, 개인 서버 사용이 가능합니다.