Minecraft 플러그인 zAuctionHouse

🔌 zAuctionHouse 소개

zAuctionHouse는 플레이어가 아이템을 등록, 둘러보기, 구매할 수 있는 기능이 풍부한 경매장을 구현하는 Minecraft 플러그인입니다. 구성 가능성, GUI 중심 인터페이스, 여러 경제 타입 지원에 중점을 둡니다. 이 프로젝트는 GroupeZ-dev가 유지 관리하며, 저장소와 문서에는 최신 Java와 서버 아키텍처를 대상으로 한 V4 재작성 버전이 소개되어 있습니다.

🎯 목적

zAuctionHouse는 플레이어가 즉시 구매 등록을 만들고, 대량 판매를 수행하며, 카테고리별 인벤토리를 둘러볼 수 있는 중앙 마켓플레이스를 제공해 게임 내 아이템 거래 문제를 해결합니다. 관리자 감사 기능과 선택적 네트워크 동기화를 원하는 서버에 적합합니다.

⚙️ 기능

• 즉시 구매(buy-it-now) 등록과, 지원되는 경우 입찰형 흐름.
• 대량 판매: 하나의 등록으로 여러 아이템 판매.
• 구매 전에 내용을 확인할 수 있는 Shulker 상자 미리보기.
• 대량 등록을 위한 카테고리 필터, 고급 정렬, 페이지네이션.
• 다중 경제 지원(Vault, PlayerPoints, CoinsEngine, 아이템 기반 화폐, XP/레벨).
• 구성 가능한 세금 시스템과 권한 기반 세금 감면.
• 자동 수령 또는 수동 수령 방식의 금액 지급, 오프라인 판매 알림.
• 완전 커스터마이즈 가능한 GUI와 인벤토리 템플릿을 위한 zMenu 연동.
• 형식화된 메시지와 플레이스홀더를 위한 PlaceholderAPI 및 MiniMessage 지원.
• 관리자 도구: 관리자 패널, 작업 로그, 거래 기록, 아이템 복구, 캐시 관리 명령.
• 분산 잠금과 pub/sub를 사용하는 Redis 애드온을 통한 멀티서버 동기화.
• 블랙리스트/화이트리스트 아이템 제어, 월드 제한, 등록 및 가격 제한, 그리고 race conditions를 방지하는 거래 잠금.
• 구성 가능한 embed 내용의 판매 알림을 위한 Discord webhook 지원.

🧩 대상

• 플레이어 주도형 마켓플레이스를 원하는 Survival 및 SMP 서버.
• 거래 시스템이 필요한 Skyblock, Factions, 경제 중심 서버.
• 여러 백엔드 서버 간에 동기화된 마켓플레이스가 필요한 네트워크.
• 감사 로그와 관리자 복구 도구가 필요한 서버 관리자.

🏗️ 사용 예시

• 플레이어가 희귀 드롭이나 제작 아이템을 고정 가격으로 등록해 다른 플레이어가 즉시 구매할 수 있게 함.
• 서버 운영자가 권한을 통해 세금 규칙과 VIP 세금 감면을 적용함.
• 멀티서버 네트워크가 Redis 애드온을 사용해 hub 서버와 backend 서버 간에 등록과 판매를 동기화함.

⌨️ 명령어

(위 명령어는 공식 프로젝트 문서와 저장소의 빠른 시작 자료에서 가져온 것입니다.)

🔐 권한

(공식 설정과 문서에서 명시적으로 언급된 권한 노드만 나열했습니다.)

⚙️ 설치

📥 설정

• 프로젝트 배포본(공식 판매 페이지 또는 카탈로그)에서 공식 zAuctionHouse jar를 받습니다.
• zAuctionHouse jar(및 필요한 플러그인)를 서버 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔에서 플러그인이 초기화되는지 확인합니다.
• plugins/zAuctionHouse/config.yml을 사용해 플러그인을 설정하고 plugins/zAuctionHouse/inventories/의 GUI 인벤토리를 커스터마이즈합니다.

📦 의존성

• 필수: zMenu, PlaceholderAPI.
• 선택적 / 지원 연동: Vault, LuckPerms, 그리고 멀티서버 동기화를 위한 zAuctionHouse Redis 애드온.

🧠 기술 노트

• 이 프로젝트는 최신 Java를 대상으로 하며(V4 재작성은 Java 21 대상), 아키텍처에서 repository 패턴 / ORM을 사용합니다.
• 권장 서버 소프트웨어에는 Paper와 Paper 포크가 포함되며, Folia와 여러 Paper 기반 포크도 지원으로 표시되어 있습니다.
• 공식 문서와 배포본은 Minecraft 1.20부터 1.21+까지의 지원을 보여줍니다(운영에 배포하기 전에 정확한 빌드 호환성은 프로젝트 문서를 확인하세요).

❓ FAQ

• 무료 버전이 있나요?
  무료 데모 빌드가 제공됩니다(프로젝트는 일부 플랫폼에서 free/demo 릴리스를 제공합니다). 다만 완전하고 지원되는 릴리스는 프로젝트의 프리미엄 채널을 통해 배포됩니다.

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

구성 가능하고 GUI 중심이며 다중 경제를 지원하고 선택적 멀티서버 동기화가 필요한 마켓플레이스가 필요하다면, zAuctionHouse는 zMenu를 통한 GUI 커스터마이징과 관리자 감사 기능을 갖춘 유지 관리되는 경매장 구현을 제공합니다.