Minecraft 플러그인 AuctionHouse

🔌 AuctionHouse 소개

AuctionHouse는 /ah 명령으로 접근할 수 있는 게임 내 경매장을 추가하는 Minecraft 플러그인입니다. 플레이어는 아이템을 판매 목록에 올리고, 목록을 둘러보거나 검색하고, GUI 기반 시장을 통해 아이템을 구매할 수 있습니다. 이 플러그인은 설정 가능한 등록 규칙, 수수료, 공지와 함께 플레이어 간 거래에 중점을 둡니다.

🎯 목적

AuctionHouse는 서버가 플레이어 운영 상점이나 표지판 기반 시장에 의존하지 않고도 관리형 경매 시스템을 제공할 수 있도록 중앙집중형 GUI 기반 마켓플레이스를 제공합니다. 검색 가능한 공개 시장과 설정 가능한 제한, 경제 연동이 필요한 서버를 위한 플러그인입니다.

⚙️ 기능

• /ah로 여는 GUI 경매장.
• 등록 생성 및 취소; 취소되었거나 만료된 아이템 회수.
• 이름, 종류, lore, enchants 또는 판매자로 등록을 검색 및 필터링.
• 시간 또는 가격으로 등록 정렬.
• 등록 제어: 최소/최대 가격, 등록 수수료(고정 및/또는 비율), 상한이 있는 판매자 세금, 등록 간 쿨다운 설정.
• 이름, 종류, lore, 인챈트, 피해량, unbreakable 플래그, custom_model_data, 정규식 패턴으로 아이템 제한.
• 서버 아이템 등록 옵션(1회성 또는 무제한 등록).
• 표지판, 이름이 지정된 블록 엔티티(상자, 셜커, 디스펜서 등), 또는 사용자 지정 이름의 엔티티를 통해 경매를 여는 특수 트리거.
• 호버 툴팁에 남은 시간과 enchants 표시.
• 새 등록에 대한 선택적 공지 및 Discord 연동.
• 국제화 지원과 설정 가능한 메시지, 재료, 사운드.
• 거래를 별도 로그 파일에 기록하고 방치된 아이템을 자동 정리.

🧩 대상

• 공유 플레이어 시장을 원하는 Survival 및 SMP 서버.
• 검색 가능한 경매 GUI가 필요한 경제 중심 서버.
• 설정 가능한 등록 규칙, 수수료, 아이템 제한이 필요한 관리자.

🏗️ 사용 예시

• 플레이어가 남는 전리품을 등록해 상자나 상점 대신 서버 커뮤니티에 경매로 판매합니다.
• 서버 스태프가 서버 제공 아이템용으로 제한형 또는 무제한 등록을 만듭니다.
• 관리자가 특정 아이템을 제한하거나 등록세를 적용해 서버 경제 규칙을 유지합니다.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 .jar를 다운로드해 Spigot 호환 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 다시 시작(완전 재시작)하고 콘솔에서 플러그인이 로드되었는지 확인합니다.
• 제공된 설정 파일을 사용해 필요에 따라 플러그인을 구성합니다.

📦 의존성

• Vault(필수, 1.7.1+ 권장).
• 적절한 경제 플러그인(예: EssentialsX economy 또는 Vault 호환 경제 제공자).
• 적절한 권한 플러그인(기본값 이상의 권한을 사용할 경우).

🧠 기술 참고

• 저장소: 이 플러그인은 SQLite를 사용합니다(외부 데이터베이스 지원 문서 없음).
• 거래를 별도의 로그 파일에 기록하며 국제화를 지원합니다.
• HeadDatabase 머리와 커스텀 스컬 텍스처를 GUI 버튼으로 지원합니다.
• 제작자는 기능과 버전 호환성의 목표가 Spigot이라고 밝히고 있으며, 다른 서버 소프트웨어에서는 동작이 다를 수 있습니다.

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

서버 경제와 Vault에 연동된, 설정 가능한 GUI 기반 경매 시스템이 필요하다면 AuctionHouse는 등록 제어, 검색/필터링, 수수료/세금, 거래 로그를 제공해 관리하기 쉬운 플레이어 마켓을 제공합니다.