AntiBuild( Essentials/EssentialsX AntiBuild 모듈로 배포됨)는 Essentials 스위트의 "antibuild" 기능을 분리하고 확장한 Minecraft 플러그인 모듈입니다. 서버 관리자는 플레이어가 어떤 블록과 아이템을 놓고, 부수고, 사용하고, 제작하고, 줍거나, 버릴 수 있는지에 대해 권한 기반의 세밀한 제어를 할 수 있습니다.

🎯 목적

AntiBuild는 원치 않는 블록/아이템 상호작용과 특정 대상에 대한 그리핑 문제를 해결합니다. 운영자는 아이템 단위와 블록 단위로 행동을 제한할 수 있습니다. 이는 지역 보호만이 아니라, 권한 기반의 중앙집중식 건축 및 상호작용 규칙이 필요할 때 유용합니다.

⚙️ 기능

특정 블록의 설치, 파괴, 사용, 피스톤 이동을 서버 전체에서 블랙리스트로 차단.
특정 아이템 상호작용을 막는 아이템 사용 블랙리스트.
아이템 ID/이름 기준으로 place/break/interact/craft/pickup/drop를 허용/거부하는 권한 기반 규칙.
구버전 블랙리스트 문법(ID) 지원 및 최신 Minecraft 버전에서 아이템 이름으로의 전환.
특정 아이템이 설치, 사용 또는 파괴될 때 스태프에게 알림을 보내는 빌드 알림 시스템.
신뢰할 수 있는 사용자를 검사에서 제외해 런타임 오버헤드를 줄이는 전역 제외 권한.

🧩 대상

아이템/건축물별 제한이 필요한 소규모~대규모 Survival/SMP 및 공개 서버.
이미 Essentials/EssentialsX를 사용 중이며 모듈형 antibuild 기능을 원하는 서버.
특정 아이템에 대해 지역 기반 보호보다 권한 기반 제어를 선호하는 관리자.

🏗️ 사용 예시

플레이어가 TNT, 피스톤 또는 서버에 영향을 주는 다른 블록을 놓지 못하게 하면서 일반 건축은 허용.
특정 아이템(예: flint and steel)의 사용을 막고, 다른 건축은 허용.
플레이어가 모니터링 중인 아이템을 놓거나 상호작용할 때 스태프에게 알림.

🔐 권한

권한	설명	기본값
`essentials.build`	전역 제외: 사용자는 AntiBuild 검사에서 제외됩니다.	지정되지 않음
`essentials.protect.exemptplacement`	플레이어를 설치 블랙리스트에서 제외합니다.	지정되지 않음
`essentials.protect.exemptusage`	플레이어를 사용 블랙리스트에서 제외합니다.	지정되지 않음
`essentials.protect.exemptbreak`	플레이어를 파괴 블랙리스트에서 제외합니다.	지정되지 않음
`essentials.protect.alerts`	모니터링 중인 항목이 트리거될 때 스태프 알림을 받습니다.	지정되지 않음
`essentials.protect.alerts.notrigger`	플레이어가 알림을 트리거하지 않도록 제외합니다.	지정되지 않음
`essentials.build.place.<id>`	특정 아이템/블록 ID(또는 이름)의 설치를 허용합니다.	지정되지 않음
`essentials.build.break.<id>`	특정 아이템/블록 ID(또는 이름)의 파괴를 허용합니다.	지정되지 않음
`essentials.build.interact.<id>`	특정 아이템/블록 ID(또는 이름)과의 상호작용을 허용합니다.	지정되지 않음
`essentials.build.craft.<id>`	특정 아이템 ID(또는 이름)의 제작을 허용합니다.	지정되지 않음
`essentials.build.pickup.<id>`	특정 아이템 ID(또는 이름)의 획득을 허용합니다.	지정되지 않음
`essentials.build.drop.<id>`	특정 아이템 ID(또는 이름)의 드롭을 허용합니다.	지정되지 않음

참고: 이 플러그인은 모듈 문서에 설명된 대로 와일드카드 및 데이터값별 권한 변형(예: essentials.build.* 또는 essentials.build.place.54:*)을 지원합니다.

⚙️ 설치

📥 설정

Essentials/EssentialsX 메인 모듈 버전에 맞는 AntiBuild 모듈을 구합니다(이 모듈은 Essentials/EssentialsX 애드온으로 배포됩니다).
모듈 .jar 파일을 메인 Essentials/EssentialsX 플러그인과 함께 서버의 plugins/ 디렉터리에 넣습니다.
서버를 재시작하고 서버 콘솔에서 모듈이 로드되었는지 확인합니다.

📦 의존성

EssentialsX(메인 모듈과 일치하는 버전) — 모듈이 메인 스위트에 의존하므로 필요합니다.
Vault — 경제/권한 연동을 위해 EssentialsX에서 권장/사용됩니다.
권한 플러그인(예: LuckPerms) — 아이템/블록 권한 노드를 효과적으로 관리하는 데 필요합니다.

🧾 설정

AntiBuild는 블랙리스트 및 알림 설정 섹션을 사용하며, 차단/알림 대상 아이템을 ID(구버전) 또는 최신 Minecraft 버전에서는 아이템 이름으로 지정합니다.
기본 설정 키에는 blacklist.placement, blacklist.usage, blacklist.break, blacklist.piston 및 alert.on-placement, alert.on-use, alert.on-break가 포함됩니다.
이 모듈은 세밀한 제어를 위한 essentials.build.* 권한 패턴을 제공합니다.

🧠 기술 참고

이 모듈은 숫자 ID에 대한 레거시 지원을 유지하지만, Minecraft 1.13+에서는 아이템 이름을 사용합니다.
다운로드한 모듈 빌드의 플랫폼 및 버전 호환성을 확인하세요. 최신 EssentialsX 빌드는 지원되는 Minecraft 버전을 명시합니다.
AntiBuild는 독립형 대형 플러그인이 아니라 Essentials/EssentialsX 생태계의 모듈로 제공됩니다.

🤝 이 플러그인이 유용한 경우

플레이어가 어떤 아이템과 블록을 상호작용할 수 있는지에 대해 정밀한 권한 기반 제어가 필요하다면(예: 그리핑을 막거나 서버에 영향을 주는 블록을 제한하려는 경우), AntiBuild는 기존 Essentials/EssentialsX 설정과 통합하면서 권한과 블랙리스트를 통해 이러한 규칙을 중앙에서 적용할 수 있게 해줍니다.

EssentialsAntiBuild 플러그인 서버