Honeypot

Honeypot은 “허니팟 함정” 방식을 쓰는 안티치트 플러그인이다. 악의적인 플레이어가 함정을 건드리게 유도해서 테러 행위를 탐지하고 처리한다.

주로 엑스레이 사용자를 잡는 데 쓴다.

작동 원리

아무 블록이나 허니팟으로 지정해 두면, 플레이어가 그 블록을 부수거나 상호작용할 때 미리 정해 둔 동작(알림, 밴, 명령어 실행 등)이 실행된다.

설치

플러그인 다운로드: Modrinth | GitHub

핵심 설정

config.yml 주요 설정

plugin:
    # 동작이 실행되기 전까지 부술 수 있는 허니팟 개수
    blocks-broken-before-action-taken: 1

    # 플레이어가 허니팟 블록을 실제로 부술 수 있게 할지 여부
    allow-player-destruction: false

    # 폭발로 허니팟이 부서질 수 있게 할지 여부
    allow-explode: false

# 컨테이너 상호작용 설정
container-actions:
    enable-container-actions: true
    use-inventory-click: false
    only-trigger-on-withdrawal: true

# Discord 알림
discord:
    enable: false
    url: "https://discord.com/api/webhooks/..."
    send-when: action # action 또는 onbreak

# 필터(선택)
filters:
    blocks: false
    inventories: false

# 허용할 블록 종류(필터 사용 시)
allowed-blocks:
    - DIAMOND_ORE
    - EMERALD_ORE
    - ANCIENT_DEBRIS

기본 명령어

# 허니팟 생성
/honeypot create <action> [block]

# 허니팟 제거
/honeypot remove

# 주변 허니팟 찾기
/honeypot locate [range]

# 주변 허니팟 제거
/honeypot remove near [range]

# 플레이어 기록 보기
/honeypot history <player>

# 설정 리로드
/honeypot reload

권한

honeypot.create     # 허니팟 생성
honeypot.remove     # 허니팟 제거
honeypot.locate     # 허니팟 위치 찾기
honeypot.history    # 기록 보기
honeypot.admin      # 모든 관리 권한
honeypot.bypass     # 허니팟 발동 우회
honeypot.notify     # 허니팟 알림 받기

사용자 지정 동작

honeypots.yml 설정

honeypots:
    # 경고 동작
    warn:
        action-type: "command"
        commands:
            - "msg {player} &c경고: 허니팟 함정을 건드렸습니다!"
            - "broadcast &e{player}님이 허니팟 함정을 건드렸습니다"

    # 감옥 동작
    jail:
        action-type: "command"
        commands:
            - "jail {player} griefing 1h"
            - "msg {player} &c테러 행위로 1시간 동안 감옥에 갇혔습니다"

    # 임시 밴
    tempban:
        action-type: "command"
        commands:
            - "tempban {player} 24h 허니팟 함정 발동"

사용 가능한 변수

변수	설명
{player}	발동시킨 플레이어 이름
{world}	월드 이름
{x} {y} {z}	좌표
{block}	블록 종류
{action}	동작 종류

활용 전략

엑스레이 탐지

1. 다이아몬드 층에 배치
   • Y=11~16 층에 가짜 다이아몬드 광석을 놓는다
   • 자연 생성처럼 보이게 분포시킨다
   • 강한 처벌(밴)을 설정한다

# 다이아몬드 광석 블록을 바라보고 실행
/honeypot create ban

건축물 보호

1. 중요한 건축물

   • 건축 자재 사이에 허니팟을 섞어 둔다
   • 주변과 같은 종류의 블록을 쓴다
   • 경고나 킥 동작을 설정한다

2. 창고 보호

   # 상자를 허니팟으로 지정
   /honeypot create theft_warn

단계별 대응

# 1회차: 경고
first-offense: warn
# 2회차: 임시 밴
second-offense: tempban
# 3회차: 영구 밴
third-offense: ban

그 밖의 내용은 공식 Wiki에서 확인한다.