Clearlag 문서 원본 보기

'''Clearlag'''는 [[마인크래프트]] 서버의 성능을 최적화하는 플러그인이다. 불필요한 엔티티 제거, 청크 언로드, 메모리 관리 등을 통해 서버 렉을 줄이고 TPS를 향상시킨다.

== 주요 기능 ==
=== 자동 엔티티 제거 ===
설정된 주기마다 바닥에 떨어진 아이템, 경험치 구슬, 화살 등을 자동으로 제거한다:
* 제거 전 경고 메시지 표시
* 특정 아이템 제외 설정
* 플레이어 근처 아이템 보호

=== 청크 관리 ===
* 사용하지 않는 청크 자동 언로드
* 청크당 엔티티 수 제한
* 스폰 청크 최적화

=== 성능 모니터링 ===
* 실시간 TPS 확인
* 메모리 사용량 모니터링
* 엔티티 통계 제공

== 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /lagg clear || 즉시 엔티티 제거 || lagg.clear
|-
| /lagg check || 엔티티 수 확인 || lagg.check
|-
| /lagg reload || 설정 리로드 || lagg.reload
|-
| /lagg killmobs || 모든 몹 제거 || lagg.killmobs
|-
| /lagg chunk || 청크 정보 확인 || lagg.chunk
|-
| /lagg tps || TPS 확인 || lagg.tps
|-
| /lagg halt || 서버 활동 일시정지 || lagg.halt
|-
| /lagg gc || 가비지 컬렉션 실행 || lagg.gc
|}

== 설정 ==
<pre>
# config.yml 주요 설정
auto-removal:
  enabled: true
  interval: 300  # 초 단위
  warning-time: 60  # 경고 시간
  warning-message: "&c[청소] &f60초 후 바닥 아이템이 제거됩니다!"
  
  remove:
    item: true
    arrow: true
    exp-orb: true
    falling-block: false
    painting: false
    
  item-whitelist:  # 제거하지 않을 아이템
    - DIAMOND
    - DIAMOND_BLOCK
    - NETHERITE_INGOT
    
entity-limits:
  enabled: true
  max-per-chunk: 50  # 청크당 최대 엔티티
  mob-spawning:
    zombie: 30
    skeleton: 30
    creeper: 20
    
chunk-management:
  unload-chunks: true
  keep-spawn-loaded: true
  chunk-unload-time: 60  # 초
</pre>

== 고급 설정 ==
=== 지역별 설정 ===
<pre>
# 월드별 다른 설정 적용
per-world-settings:
  world:
    auto-removal-interval: 300
    entity-limit: 100
  world_nether:
    auto-removal-interval: 600
    entity-limit: 50
  world_the_end:
    auto-removal-interval: 180
    entity-limit: 200
</pre>

=== 스마트 클리어 ===
<pre>
smart-clear:
  enabled: true
  # 플레이어가 많을 때만 작동
  minimum-players: 10
  # TPS가 낮을 때만 작동
  tps-trigger: 18.0
  # 아이템이 많을 때만 작동
  item-trigger: 1000
</pre>

== 성능 최적화 기능 ==
=== 몹 스포너 제한 ===
<pre>
mob-spawner:
  max-spawn-radius: 16  # 스포너 활성화 거리
  max-mobs-per-spawner: 10  # 스포너당 최대 몹
  disable-on-low-tps: true  # 낮은 TPS에서 비활성화
</pre>

=== 레드스톤 최적화 ===
<pre>
redstone:
  disable-on-low-tps: true
  tps-threshold: 16.0
  max-pistons-per-chunk: 50
  max-redstone-per-chunk: 300
</pre>

== 활용 팁 ==
* '''대규모 팜 관리''': 청크당 엔티티 제한으로 과도한 몹 팜 방지
* '''이벤트 서버''': 이벤트 중 엔티티 제거 일시 중지 가능
* '''생존 서버''': 귀중품 아이템 화이트리스트 설정
* '''미니게임''': 게임별 다른 제거 주기 설정

== 알림 시스템 ==
<pre>
notifications:
  clear-warning:
    - "&c========== 청소 알림 =========="
    - "&e60초 후 바닥 아이템이 제거됩니다!"
    - "&e귀중품은 상자에 보관하세요!"
    - "&c=========================="
    
  clear-success:
    message: "&a%count%개의 엔티티가 제거되었습니다!"
    sound: ENTITY_PLAYER_LEVELUP
</pre>

== 호환성 ==
* [[마인크래프트]] 1.8 - 1.21
* WorldGuard 연동 (지역 보호)
* GriefPrevention 연동 (클레임 보호)
* 모든 Spigot 기반 서버 지원

== 문제 해결 ==
* '''아이템이 사라지지 않음''': 화이트리스트 확인
* '''TPS가 개선되지 않음''': 엔티티 외 다른 원인 확인 필요
* '''특정 지역 제외하기''': WorldGuard 플래그 사용

== 추가 명령어 ==
{| class="wikitable"
! 명령어 !! 설명 !! 권한
|-
| /lagg area <반경> || 주변 엔티티 제거 || lagg.area
|-
| /lagg unloadchunks || 청크 강제 언로드 || lagg.unloadchunks
|-
| /lagg profile || 서버 프로파일링 || lagg.profile
|-
| /lagg blacklist || 블랙리스트 관리 || lagg.blacklist
|}

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