Clearlag

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

주요 기능

자동 엔티티 제거

설정된 주기마다 바닥에 떨어진 아이템, 경험치 구슬, 화살 등을 자동으로 제거한다:

• 제거 전 경고 메시지 표시
• 특정 아이템 제외 설정
• 플레이어 근처 아이템 보호

청크 관리

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

성능 모니터링

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

명령어

명령어	설명	권한
/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

설정

# 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  # 초

고급 설정

지역별 설정

# 월드별 다른 설정 적용
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

스마트 클리어

smart-clear:
  enabled: true
  # 플레이어가 많을 때만 작동
  minimum-players: 10
  # TPS가 낮을 때만 작동
  tps-trigger: 18.0
  # 아이템이 많을 때만 작동
  item-trigger: 1000

성능 최적화 기능

몹 스포너 제한

mob-spawner:
  max-spawn-radius: 16  # 스포너 활성화 거리
  max-mobs-per-spawner: 10  # 스포너당 최대 몹
  disable-on-low-tps: true  # 낮은 TPS에서 비활성화

레드스톤 최적화

redstone:
  disable-on-low-tps: true
  tps-threshold: 16.0
  max-pistons-per-chunk: 50
  max-redstone-per-chunk: 300

활용 팁

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

알림 시스템

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

호환성

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

문제 해결

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

추가 명령어

명령어	설명	권한
/lagg area <반경>	주변 엔티티 제거	lagg.area
/lagg unloadchunks	청크 강제 언로드	lagg.unloadchunks
/lagg profile	서버 프로파일링	lagg.profile
/lagg blacklist	블랙리스트 관리	lagg.blacklist