잔글 문자열 찾아 바꾸기 - "분류:마인크래프트" 문자열을 "분류:마인크래프트/플러그인" 문자열로
CoreProtect 로그 및 롤백 문서 보강
 
1번째 줄: 1번째 줄:
'''CoreProtect'''는 [[마인크래프트]] 서버를 위한 빠르고 효율적인 데이터 로깅 및 안티 그리핑 도구이다. 대규모 서버를 염두에 두고 설계되어 서버 성능에 영향을 주지 않으면서 데이터를 기록하고 관리할 있다. 2012년 초부터 활발히 개발되고 있는 가장 오래된 플러그인 중 하나로, 블록 변경 사항을 추적하고 롤백할 수 있는 강력한 기능을 제공한다.
'''CoreProtect'''는 [[마인크래프트: 자바 에디션]] 서버에서 블록 변경과 플레이어 행동을 기록하고, 필요한 경우 조회하거나 롤백할 있게 하는 [[마인크래프트/플러그인|마인크래프트 플러그인]]이다. 건축물 훼손, 실수로 인한 블록 변경, 대규모 월드 편집 사고를 조사하고 복구하는 데 사용된다.
 
CoreProtect는 보호 플러그인이 아니라 기록과 복구 플러그인이다. 사전에 막는 역할은 [[WorldGuard]] 같은 보호 플러그인이 담당하고, 이미 일어난 일을 확인하고 되돌리는 역할은 CoreProtect가 맡는다.


== 주요 기능 ==
== 주요 기능 ==
* '''빠른 데이터 로깅''': 모든 블록, 엔티티, 인벤토리 변경 기록
CoreProtect의 주요 기능은 다음과 같다.
* '''무지연 롤백''': 롤백/복원 작업 중 서버 랙 없음
* '''다양한 데이터베이스 지원''': MySQL, SQLite 지원
* '''WorldEdit 통합''': WorldEdit 작업 추적 및 롤백
* '''자연 현상 로깅''': 물/용암 흐름, 나무 성장, 폭발 등 기록
* '''상세한 검색 기능''': 시간, 플레이어, 블록 타입별 검색
* '''인스펙터 모드''': 블록 클릭으로 변경 기록 확인


== 버전 정보 ==
* 블록 설치와 파괴 기록
CoreProtect는 현재 다음과 같은 버전 체계를 사용한다:
* 상자와 컨테이너 변경 기록
* 플레이어 상호작용 기록
* 특정 위치 또는 범위 조회
* 시간 기준 조회
* 플레이어별 조회
* 블록 변경 롤백
* 롤백 취소


* '''v22.4''': 공식 무료 버전 (Minecraft 1.15 - 1.20)
== 설치 방법 ==
* '''v23.0+''': Patreon 후원자 전용 (Minecraft 1.21+)
Paper 서버 기준 설치 절차는 다음과 같다.
* '''Community Edition''': Patreon에서 무료 가입 후 다운로드 가능


최신 Minecraft 버전 지원은 Patreon을 통해 제공되며, 오픈소스이므로 직접 컴파일도 가능하다.
# CoreProtect jar 파일을 다운로드한다.
# 서버의 `plugins` 폴더에 넣는다.
# 서버를 재시작한다.
# `plugins/CoreProtect` 폴더와 설정 파일을 확인한다.
# 데이터베이스 설정이 필요한 경우 별도로 구성한다.


== 설치 방법 ==
소규모 서버에서는 기본 SQLite 저장 방식을 사용할 수 있지만, 장기간 운영되는 서버나 변경량이 많은 서버는 MySQL/MariaDB 같은 외부 데이터베이스를 검토할 수 있다.
# Paper 또는 Spigot 서버 준비
# [https://www.spigotmc.org/resources/coreprotect.8631/ SpigotMC]에서 다운로드
# plugins 폴더에 JAR 파일 넣기
# 서버 재시작
# 자동으로 데이터베이스 생성 및 설정 완료


== 기본 명령어 ==
== 기본 명령어 ==
=== 일반 명령어 ===
CoreProtect의 기본 명령어는 `/co`이다.
{| class="wikitable"
 
! 명령어 !! 설명
<pre>
|-
/co inspect
| /co help || 도움말 표시
/co lookup
|-
/co rollback
| /co inspect || 인스펙터 모드 활성화/비활성화
/co restore
|-
/co purge
| /co lookup <매개변수> || 특정 조건으로 변경 기록 검색
</pre>
|-
| /co rollback <매개변수> || 변경 사항 롤백
|-
| /co restore <매개변수> || 롤백된 내용 복원
|-
| /co purge <시간> || 오래된 데이터 삭제
|-
| /co status || 플러그인 상태 확인
|}


=== 매개변수 ===
{| class="wikitable"
{| class="wikitable"
! 매개변수 !! 설명 !! 예시
! 명령어 !! 용도
|-
|-
| u:<사용자> || 특정 플레이어 지정 || u:Steve
| `/co inspect`
| 블록을 클릭해 변경 기록을 확인하는 검사 모드를 켜거나 끈다.
|-
|-
| t:<시간> || 시간 범위 지정 || t:1h (1시간)
| `/co lookup`
| 조건에 맞는 로그를 조회한다.
|-
|-
| r:<반경> || 반경 지정 || r:10
| `/co rollback`
| 조건에 맞는 변경 사항을 되돌린다.
|-
|-
| a:<행동> || 특정 행동 지정 || a:block
| `/co restore`
| 롤백한 내용을 다시 복구한다.
|-
|-
| b:<블록> || 특정 블록 지정 || b:stone
| `/co purge`
|-
| 오래된 로그를 삭제한다.
| e:<제외> || 특정 항목 제외 || e:water
|}
|}


== 검색 가능한 행동 ==
== 조회 예시 ==
* '''block''': 블록 설치/파괴
특정 플레이어의 최근 변경을 조회하는 예시는 다음과 같다.
* '''click''': 플레이어 상호작용
* '''kill''': 엔티티 처치
* '''container''': 상자 등 컨테이너 사용
* '''chat''': 채팅 메시지
* '''command''': 명령어 사용
* '''sign''': 표지판 텍스트
* '''session''': 플레이어 접속/종료


== 시간 형식 ==
<pre>
시간은 다양한 단위로 지정할 수 있다:
/co lookup u:PlayerName t:1h
* '''s''': 초 (예: 30s)
</pre>
* '''m''': 분 (예: 5m)
* '''h''': 시간 (예: 2h)
* '''d''': 일 (예: 7d)
* '''w''': 주 (예: 2w)


조합도 가능하다: t:1h30m (1시간 30분)
특정 반경 안에서 최근 블록 변경을 조회하는 예시는 다음과 같다.


== 사용 예시 ==
<pre>
<pre>
# Steve가 1시간 내에 10블록 반경에서 한 모든 행동 검색
/co lookup r:20 t:2h
/co lookup u:Steve t:1h r:10
</pre>


# 30분 내 TNT 설치 기록 검색
컨테이너 변경 기록을 확인할 때는 검사 모드를 사용하면 편하다.
/co lookup b:tnt t:30m a:+block


# Steve의 모든 행동을 1일 전으로 롤백
<pre>
/co rollback u:Steve t:1d
/co inspect
 
</pre>
# 10블록 반경 내 크리퍼 폭발 복원
/co restore r:10 e:creeper


# 인스펙터 모드로 블록 기록 확인
검사 모드가 켜진 상태에서 블록이나 상자를 클릭하면 해당 위치의 기록을 확인할 수 있다.
/co i
</pre>


== 설정 ==
== 롤백 예시 ==
config.yml 주요 설정:
특정 플레이어가 최근 30분 동안 변경한 내용을 반경 50블록 안에서 롤백하는 예시는 다음과 같다.


<pre>
<pre>
# 데이터베이스 설정
/co rollback u:PlayerName t:30m r:50
use-mysql: false
</pre>
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


# 자동 삭제
<pre>
purge-time: 0  # 0 = 비활성화
/co restore u:PlayerName t:30m r:50
</pre>
</pre>


== 권한 ==
== 권한 ==
* '''coreprotect.*''': 모든 권한
CoreProtect 명령어는 강력한 조사와 복구 기능을 제공하므로 관리자나 신뢰된 운영자에게만 부여해야 한다.
* '''coreprotect.inspect''': 인스펙터 사용
* '''coreprotect.lookup''': 기록 검색
* '''coreprotect.rollback''': 롤백 실행
* '''coreprotect.restore''': 복원 실행
* '''coreprotect.purge''': 데이터 삭제
* '''coreprotect.help''': 도움말 확인


== API ==
자주 쓰이는 권한 예시는 다음과 같다.
개발자를 위한 API를 제공한다:


<pre>
<pre>
<!-- Maven -->
coreprotect.inspect
<dependency>
coreprotect.lookup
    <groupId>net.coreprotect</groupId>
coreprotect.rollback
    <artifactId>coreprotect</artifactId>
coreprotect.restore
    <version>22.4</version>
coreprotect.purge
    <scope>provided</scope>
</dependency>
</pre>
</pre>


== 성능 최적화 ==
권한은 [[LuckPerms]] 같은 권한 플러그인에서 관리한다.
* '''MySQL 사용''': 대규모 서버에서는 MySQL 권장
 
* '''적절한 삭제 주기''': purge-time 설정으로 오래된 데이터 자동 삭제
== 운영 참고 ==
* '''제한된 반경''': max-radius로 과도한 검색 방지
CoreProtect는 많은 로그를 저장할 수 있다. 서버 규모가 크거나 건축 활동이 많으면 저장 공간과 데이터베이스 성능을 함께 관리해야 한다.
* '''선택적 로깅''': 불필요한 로깅 옵션 비활성화
 
운영자가 확인할 항목은 다음과 같다.


== 알려진 문제 ==
* 로그 보관 기간
* 최신 Minecraft 버전 (1.21+)은 Patreon 후원 또는 직접 컴파일 필요
* 데이터베이스 저장 방식
* 일부 모드 블록은 제대로 추적되지 않을 수 있음
* 저장 공간 사용량
* 대규모 롤백 시 일시적인 서버 부하 발생 가능
* 롤백 권한을 가진 사용자
* 대규모 월드 편집 작업 기록 여부
* 로그 삭제 작업 주기
 
롤백 전에는 가능하면 조회 결과를 먼저 확인하고, 작은 범위에서 테스트하는 것이 좋다.
 
== 플레이시티 블록에서의 활용 ==
[[플레이시티 블록]] 같은 도시건축 서버에서는 건축물 훼손, 실수, 대규모 편집 사고를 확인하고 복구하는 일이 중요하다. CoreProtect는 [[WorldGuard]]의 지역 보호, [[LuckPerms]]의 권한 관리와 함께 서버 안정성을 유지하는 핵심 플러그인이다.


== 같이 보기 ==
== 같이 보기 ==
* [[마인크래프트/플러그인]]
* [[LuckPerms]]
* [[WorldGuard]]
* [[WorldGuard]]
* [[마인크래프트/플러그인]]
* [[WorldEdit]]
* [[플레이시티 블록/서버]]


== 외부 링크 ==
== 외부 링크 ==
* [https://coreprotect.net/ 공식 웹사이트]
* [https://www.spigotmc.org/resources/coreprotect.8631/ CoreProtect on SpigotMC]
* [https://docs.coreprotect.net/ 공식 문서]
* [https://docs.coreprotect.net/ CoreProtect Documentation]
* [https://github.com/PlayPro/CoreProtect GitHub 저장소]
* [https://www.patreon.com/coreprotect Patreon 페이지]


[[분류:마인크래프트/플러그인]]
[[분류:마인크래프트/플러그인]]

2026년 6월 1일 (월) 14:42 기준 최신판

CoreProtect마인크래프트: 자바 에디션 서버에서 블록 변경과 플레이어 행동을 기록하고, 필요한 경우 조회하거나 롤백할 수 있게 하는 마인크래프트 플러그인이다. 건축물 훼손, 실수로 인한 블록 변경, 대규모 월드 편집 사고를 조사하고 복구하는 데 사용된다.

CoreProtect는 보호 플러그인이 아니라 기록과 복구 플러그인이다. 사전에 막는 역할은 WorldGuard 같은 보호 플러그인이 담당하고, 이미 일어난 일을 확인하고 되돌리는 역할은 CoreProtect가 맡는다.

주요 기능

CoreProtect의 주요 기능은 다음과 같다.

  • 블록 설치와 파괴 기록
  • 상자와 컨테이너 변경 기록
  • 플레이어 상호작용 기록
  • 특정 위치 또는 범위 조회
  • 시간 기준 조회
  • 플레이어별 조회
  • 블록 변경 롤백
  • 롤백 취소

설치 방법

Paper 서버 기준 설치 절차는 다음과 같다.

  1. CoreProtect jar 파일을 다운로드한다.
  2. 서버의 `plugins` 폴더에 넣는다.
  3. 서버를 재시작한다.
  4. `plugins/CoreProtect` 폴더와 설정 파일을 확인한다.
  5. 데이터베이스 설정이 필요한 경우 별도로 구성한다.

소규모 서버에서는 기본 SQLite 저장 방식을 사용할 수 있지만, 장기간 운영되는 서버나 변경량이 많은 서버는 MySQL/MariaDB 같은 외부 데이터베이스를 검토할 수 있다.

기본 명령어

CoreProtect의 기본 명령어는 `/co`이다.

/co inspect
/co lookup
/co rollback
/co restore
/co purge
명령어 용도
`/co inspect` 블록을 클릭해 변경 기록을 확인하는 검사 모드를 켜거나 끈다.
`/co lookup` 조건에 맞는 로그를 조회한다.
`/co rollback` 조건에 맞는 변경 사항을 되돌린다.
`/co restore` 롤백한 내용을 다시 복구한다.
`/co purge` 오래된 로그를 삭제한다.

조회 예시

특정 플레이어의 최근 변경을 조회하는 예시는 다음과 같다.

/co lookup u:PlayerName t:1h

특정 반경 안에서 최근 블록 변경을 조회하는 예시는 다음과 같다.

/co lookup r:20 t:2h

컨테이너 변경 기록을 확인할 때는 검사 모드를 사용하면 편하다.

/co inspect

검사 모드가 켜진 상태에서 블록이나 상자를 클릭하면 해당 위치의 기록을 확인할 수 있다.

롤백 예시

특정 플레이어가 최근 30분 동안 변경한 내용을 반경 50블록 안에서 롤백하는 예시는 다음과 같다.

/co rollback u:PlayerName t:30m r:50

롤백은 서버 월드에 직접 영향을 주는 명령어이므로 반드시 조건을 좁혀서 사용한다. 넓은 범위나 긴 시간으로 롤백하면 정상적인 건축물까지 함께 되돌릴 수 있다.

롤백한 내용을 다시 복구하려면 다음 명령어를 사용한다.

/co restore u:PlayerName t:30m r:50

권한

CoreProtect 명령어는 강력한 조사와 복구 기능을 제공하므로 관리자나 신뢰된 운영자에게만 부여해야 한다.

자주 쓰이는 권한 예시는 다음과 같다.

coreprotect.inspect
coreprotect.lookup
coreprotect.rollback
coreprotect.restore
coreprotect.purge

권한은 LuckPerms 같은 권한 플러그인에서 관리한다.

운영 참고

CoreProtect는 많은 로그를 저장할 수 있다. 서버 규모가 크거나 건축 활동이 많으면 저장 공간과 데이터베이스 성능을 함께 관리해야 한다.

운영자가 확인할 항목은 다음과 같다.

  • 로그 보관 기간
  • 데이터베이스 저장 방식
  • 저장 공간 사용량
  • 롤백 권한을 가진 사용자
  • 대규모 월드 편집 작업 기록 여부
  • 로그 삭제 작업 주기

롤백 전에는 가능하면 조회 결과를 먼저 확인하고, 작은 범위에서 테스트하는 것이 좋다.

플레이시티 블록에서의 활용

플레이시티 블록 같은 도시건축 서버에서는 건축물 훼손, 실수, 대규모 편집 사고를 확인하고 복구하는 일이 중요하다. CoreProtect는 WorldGuard의 지역 보호, LuckPerms의 권한 관리와 함께 서버 안정성을 유지하는 핵심 플러그인이다.

같이 보기

외부 링크