CoreProtect
CoreProtect는 마인크래프트 서버를 위한 빠르고 효율적인 데이터 로깅 및 안티 그리핑 도구이다. 대규모 서버를 염두에 두고 설계되어 서버 성능에 영향을 주지 않으면서 데이터를 기록하고 관리할 수 있다. 2012년 초부터 활발히 개발되고 있는 가장 오래된 플러그인 중 하나로, 블록 변경 사항을 추적하고 롤백할 수 있는 강력한 기능을 제공한다.
주요 기능
- 빠른 데이터 로깅: 모든 블록, 엔티티, 인벤토리 변경 기록
- 무지연 롤백: 롤백/복원 작업 중 서버 랙 없음
- 다양한 데이터베이스 지원: MySQL, SQLite 지원
- WorldEdit 통합: WorldEdit 작업 추적 및 롤백
- 자연 현상 로깅: 물/용암 흐름, 나무 성장, 폭발 등 기록
- 상세한 검색 기능: 시간, 플레이어, 블록 타입별 검색
- 인스펙터 모드: 블록 클릭으로 변경 기록 확인
버전 정보
CoreProtect는 현재 다음과 같은 버전 체계를 사용한다:
- v22.4: 공식 무료 버전 (Minecraft 1.15 - 1.20)
- v23.0+: Patreon 후원자 전용 (Minecraft 1.21+)
- Community Edition: Patreon에서 무료 가입 후 다운로드 가능
최신 Minecraft 버전 지원은 Patreon을 통해 제공되며, 오픈소스이므로 직접 컴파일도 가능하다.
설치 방법
- Paper 또는 Spigot 서버 준비
- SpigotMC에서 다운로드
- plugins 폴더에 JAR 파일 넣기
- 서버 재시작
- 자동으로 데이터베이스 생성 및 설정 완료
기본 명령어
일반 명령어
| 명령어 | 설명 |
|---|---|
| /co help | 도움말 표시 |
| /co inspect | 인스펙터 모드 활성화/비활성화 |
| /co lookup <매개변수> | 특정 조건으로 변경 기록 검색 |
| /co rollback <매개변수> | 변경 사항 롤백 |
| /co restore <매개변수> | 롤백된 내용 복원 |
| /co purge <시간> | 오래된 데이터 삭제 |
| /co status | 플러그인 상태 확인 |
매개변수
| 매개변수 | 설명 | 예시 |
|---|---|---|
| u:<사용자> | 특정 플레이어 지정 | u:Steve |
| t:<시간> | 시간 범위 지정 | t:1h (1시간) |
| r:<반경> | 반경 지정 | r:10 |
| a:<행동> | 특정 행동 지정 | a:block |
| b:<블록> | 특정 블록 지정 | b:stone |
| e:<제외> | 특정 항목 제외 | e:water |
검색 가능한 행동
- block: 블록 설치/파괴
- click: 플레이어 상호작용
- kill: 엔티티 처치
- container: 상자 등 컨테이너 사용
- chat: 채팅 메시지
- command: 명령어 사용
- sign: 표지판 텍스트
- session: 플레이어 접속/종료
시간 형식
시간은 다양한 단위로 지정할 수 있다:
- s: 초 (예: 30s)
- m: 분 (예: 5m)
- h: 시간 (예: 2h)
- d: 일 (예: 7d)
- w: 주 (예: 2w)
조합도 가능하다: t:1h30m (1시간 30분)
사용 예시
# Steve가 1시간 내에 10블록 반경에서 한 모든 행동 검색 /co lookup u:Steve t:1h r:10 # 30분 내 TNT 설치 기록 검색 /co lookup b:tnt t:30m a:+block # Steve의 모든 행동을 1일 전으로 롤백 /co rollback u:Steve t:1d # 10블록 반경 내 크리퍼 폭발 복원 /co restore r:10 e:creeper # 인스펙터 모드로 블록 기록 확인 /co i
설정
config.yml 주요 설정:
# 데이터베이스 설정 use-mysql: false table-prefix: co_ database: database.db # 로깅 설정 log-player-interactions: true log-player-messages: true log-player-commands: true log-player-sessions: true log-world-edit: true # 성능 설정 max-radius: 100 default-radius: 10 rollback-items: true rollback-entities: true # 자동 삭제 purge-time: 0 # 0 = 비활성화
권한
- coreprotect.*: 모든 권한
- coreprotect.inspect: 인스펙터 사용
- coreprotect.lookup: 기록 검색
- coreprotect.rollback: 롤백 실행
- coreprotect.restore: 복원 실행
- coreprotect.purge: 데이터 삭제
- coreprotect.help: 도움말 확인
API
개발자를 위한 API를 제공한다:
<!-- Maven -->
<dependency>
<groupId>net.coreprotect</groupId>
<artifactId>coreprotect</artifactId>
<version>22.4</version>
<scope>provided</scope>
</dependency>
성능 최적화
- MySQL 사용: 대규모 서버에서는 MySQL 권장
- 적절한 삭제 주기: purge-time 설정으로 오래된 데이터 자동 삭제
- 제한된 반경: max-radius로 과도한 검색 방지
- 선택적 로깅: 불필요한 로깅 옵션 비활성화
알려진 문제
- 최신 Minecraft 버전 (1.21+)은 Patreon 후원 또는 직접 컴파일 필요
- 일부 모드 블록은 제대로 추적되지 않을 수 있음
- 대규모 롤백 시 일시적인 서버 부하 발생 가능