Minecraft 플러그인 eco

🔌 eco 소개

eco는 플러그인 개발을 단순화하고 다른 플러그인에서 재사용할 수 있는 엔진 기능을 제공하도록 설계된 Spigot 개발 라이브러리(독립적으로 동작하는 Minecraft 플러그인)입니다. 명령 및 설정 API, 영구 저장소 어댑터, GUI 및 커스텀 아이템 시스템, 그리고 다양한 통합 기능을 제공하여 플러그인 작성자가 공통 기능을 다시 구현하지 않고 재사용할 수 있게 합니다.

🎯 목적

eco는 현대적인 플러그인에 필요한 개발자용 공통 시스템을 한곳에 모으기 위해 존재합니다. 명령 파싱, 색상 및 메시지 형식, 설정 형식, 영구 데이터 접근, GUI 구성 요소, 아이템 처리, 그리고 다른 서버 측 시스템과의 통합이 포함됩니다. 유지 관리되는 공유 프레임워크 위에서 기능을 빠르게 만들고 싶은 플러그인 작성자를 위한 것입니다.

⚙️ 기능

• 현대적인 명령 API와 파싱
• hex / RGB / MiniMessage를 지원하는 네이티브 색상 파싱
• YAML, JSON, TOML을 지원하는 config 시스템
• YAML, MySQL, MongoDB 백엔드를 지원하는 영구 데이터 저장 API
• GUI API와 사전 제작된 구성 요소
• 커스텀 아이템 및 초고속 ItemStack 처리
• packet 아이템 표시와 가벼운 packet 이벤트 루프
• NMS와 거의 1:1에 가까운 매핑을 제공하는 엔티티 AI API
• Placeholder API와 네이티브 통합(프로젝트에 30개 이상의 통합이 목록으로 제공됨)
• 가격/경제 추상화(경제 플러그인, XP, 아이템을 지원하는 가격 시스템)
• 네이티브 bStats 지원 및 플러그인 업데이트 확인
• 확장 시스템(플러그인을 위한 플러그인)과 개발자를 위한 의존성 주입 도구

🧩 대상

• 재사용 가능한 프레임워크를 원하는 Spigot/Paper 호환 플러그인을 개발하는 플러그인 개발자
• eco에 의존하는 플러그인을 실행하는 서버 소유자(eco를 의존성으로 설치해야 함)
• 커스텀 아이템, GUI, 또는 통합된 저장/명령 도구가 필요한 프로젝트

🏗️ 사용 예시

• 개발자가 eco의 아이템 조회 및 GUI API를 사용하는 커스텀 아이템 팩을 구현한다.
• 플러그인이 eco의 저장소 API를 사용해 로컬 YAML과 원격 MongoDB 백엔드를 코드 중복 없이 모두 지원한다.
• 여러 작은 플러그인이 eco를 공유하여 일관된 명령 처리와 색상 파싱을 제공한다.

⚙️ 설치

📥 설정

• 필요한 서버에 eco를 플러그인으로 설치하려면 JAR를 서버 plugins/ 폴더에 넣고 서버를 재시작하면 됩니다.
• 다른 플러그인이 eco에 의존한다면 해당 플러그인의 plugin.yml 안 depend:에 - eco를 선언하여 서버가 eco를 먼저 로드하게 하세요.

📦 의존성(플러그인 개발자용)

• 이 프로젝트는 compile-only 용도의 Maven 저장소와 Gradle 좌표를 제공합니다. 또한 공개된 아티팩트(예: 그룹 com.willfp 및 버전 태그)를 제공하므로 개발자는 빌드 시 eco를 provided 의존성으로 추가할 수 있습니다.

🧠 기술 참고

• 지원 서버 소프트웨어: 공식 프로젝트는 Spigot, Paper, Purpur, Folia 지원을 명시합니다.
• 지원 Minecraft 버전: 프로젝트는 1.21.4부터 지원한다고 밝히며, 이후 빌드는 최신 1.21.x 계열을 대상으로 합니다.
• 저장 백엔드: YAML, MySQL, MongoDB 어댑터가 프레임워크에서 제공됩니다.
• 라이선스: eco는 MIT 라이선스로 배포됩니다.

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

명령, 설정 형식, GUI 구성 요소, 저장소, 커스텀 아이템처럼 공통 요구 사항을 공유하는 여러 기능이나 플러그인을 개발한다면, eco는 유지 관리되는 프레임워크와 다른 플러그인이 의존할 수 있는 통합 기능을 제공해 중복 작업을 줄여줍니다.