Minecraft 플러그인 CoreProtect

🔌 CoreProtect 소개

CoreProtect는 블록과 엔티티 변경을 기록해 검색 가능한 기록과, 그리핑·실수로 인한 피해·디버깅을 위한 되돌리기/복구 도구를 제공하는 Minecraft 플러그인입니다. 신뢰할 수 있는 데이터 기록과 관리 도구에 초점을 맞춰, 서버 운영자가 플레이어 행동을 확인하고, 필요한 부분만 롤백 또는 복구하며, 저장된 데이터를 관리할 수 있게 해 줍니다.

🎯 목적

CoreProtect의 핵심 목적은 서버 측 데이터 기록과 그리핑 방지입니다. 누가 무엇을 언제 변경했는지 기록하고, 스태프가 게임 내에서 최근 변경 사항을 확인하며, 플레이어/시간/영역별로 과거 변경 사항을 검색하고, 필요할 때 이를 되돌리거나 복구할 수 있게 합니다.

⚙️ 기능

• 공식 문서로 확인된 블록 및 엔티티 변경(블록 설치, 블록 파괴, 엔티티 변경)의 지속적인 기록.
• 세계와 상호작용하면서 기록된 변경 사항을 볼 수 있는 게임 내 인스펙터 모드.
• 플레이어, 시간, 반경 또는 영역별로 과거 변경 사항을 조회하는 lookup 명령어.
• 기록된 변경 사항을 되돌리거나 다시 적용하는 rollback 및 restore 명령어.
• 보존 규칙에 따라 오래된 데이터를 삭제하고 최적화 플래그로 공간을 회수하는 purge 명령어.
• SQLite와 MySQL 백엔드 간 데이터 이전을 지원하는 데이터베이스 마이그레이션 지원.
• 월드별로 기록 동작을 변경할 수 있는 월드별 설정 파일.
• 공식 문서에 제공된 대로 다른 플러그인이 CoreProtect 데이터를 읽고 쓸 수 있는 공개 API.

🧩 대상 사용자

• 플레이어 활동에 대한 포렌식 로그가 필요한 서버 관리자와 모더레이터.
• 그리핑이나 실수로 인한 피해를 복구하고 싶은 Survival 및 SMP 서버.
• 검색 가능한 과거 데이터와 제어된 롤백이 필요한 크고 작은 서버.

🏗️ 사용 예시

• 관리자가 인스펙터를 사용해 기지에서 블록을 제거한 사람이 누구인지 확인하고, 해당 변경 사항만 대상으로 롤백을 수행한다.
• 모더레이터가 신고를 조사하기 위해 일정 시간 동안의 플레이어 행동을 lookup한다.
• 서버 운영자가 네트워크형 백엔드로 전환하기 위해 CoreProtect 데이터베이스를 SQLite에서 MySQL로 마이그레이션한다.

⌨️ 명령어

참고: 명령어 이름과 설명은 공식 CoreProtect 문서를 기반으로 합니다. migrate-db 명령어는 데이터베이스 마이그레이션 기능의 일부로 문서화되어 있으며, 각 명령어의 명시적 권한 노드는 공식 권한 문서에 나와 있습니다.

🔐 권한

⚙️ 설치

📥 설정

• Minecraft 버전에 맞는 공식 CoreProtect JAR을 다운로드해 서버의 plugins/ 디렉터리에 넣으세요.
• 서버를 다시 시작하고 서버 콘솔에서 CoreProtect가 로드되는지 확인하세요.
• 설정 변경 후에는 /co reload를 사용하면 재시작 없이 적용할 수 있습니다.

📦 종속성

• CoreProtect 자체에 대해 공식 문서에는 필수 타사 플러그인 종속성이 나와 있지 않습니다. (일부 타사 도구와 연동은 호환됨으로 문서화되어 있습니다. 특정 연동은 명시적으로 활성화된 경우에만 나열하세요.)

🧾 설정

• CoreProtect는 플러그인 폴더에 config.yml을 생성합니다.
• 월드별 설정 파일은 config.yml을 월드 이름으로 된 파일(예: world_nether.yml)로 복사해 만들 수 있으며, 이때 해당 월드의 기록 설정을 덮어쓸 수 있습니다.
• 데이터베이스 마이그레이션 단계와 안전한 마이그레이션 방법은 공식 문서에 설명되어 있습니다.

🧠 기술 참고

• CoreProtect는 다른 플러그인이 기록된 데이터와 상호작용할 수 있는 API를 제공합니다(공식 API 문서에 설명됨).
• CoreProtect는 문서화된 마이그레이션 명령어를 사용해 SQLite와 MySQL 백엔드 간 데이터 마이그레이션을 지원합니다.
• 이 프로젝트는 Artistic-2.0 라이선스로 배포됩니다.

🤝 이 플러그인이 유용한 경우

플레이어 행동을 조사하거나 그리핑을 복구하기 위해 검색 가능한 서버 측 기록과 신뢰할 수 있는 rollback/restore 도구가 필요하다면, CoreProtect는 서버 관리자와 모더레이션 팀에 적합한 집중형 기록 및 복구 도구 세트를 제공합니다.