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을 통해 제공되며, 오픈소스이므로 직접 컴파일도 가능하다.

설치 방법

1. Paper 또는 Spigot 서버 준비
2. SpigotMC에서 다운로드
3. plugins 폴더에 JAR 파일 넣기
4. 서버 재시작
5. 자동으로 데이터베이스 생성 및 설정 완료

기본 명령어

일반 명령어

명령어	설명
/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 후원 또는 직접 컴파일 필요
• 일부 모드 블록은 제대로 추적되지 않을 수 있음
• 대규모 롤백 시 일시적인 서버 부하 발생 가능

같이 보기

• WorldGuard
• 마인크래프트/플러그인

외부 링크

• 공식 웹사이트
• 공식 문서
• GitHub 저장소
• Patreon 페이지