Minecraft 플러그인 SCore

🔌 SCore 소개

SCore는 Ssomar가 제작한 코어/라이브러리 플러그인으로, 플러그인 전체에서 공통으로 쓰이는 기능을 한곳에 모아 제공합니다. 게임 내 편집기와 런타임 기능을 제공하며, 다른 Ssomar 플러그인들이 이를 기반으로 동작합니다. 또한 단독으로 사용하여 커스텀 투사체를 만들고 실행하고, 변수를 관리하고, 패키징된 커스텀 명령을 실행할 수도 있습니다.

🎯 목적

SCore는 플러그인 제작자, 특히 Ssomar 플러그인 계열을 위해 재사용 가능한 기반을 제공하기 위해 존재합니다. 기능을 한 번만 구현하고 여러 플러그인에서 함께 사용할 수 있도록 하기 위함입니다. Ssomar 플러그인을 하나 이상 운영하는 개발자와 서버 관리자, 또는 해당 재사용 기능을 서버에서 활용하고 싶은 사용자를 대상으로 합니다.

⚙️ 기능

• 커스텀 투사체를 만들고 편집할 수 있는 게임 내 편집기.
• 발사하거나 트리거할 수 있는 런타임 커스텀 투사체.
• NUMBER, STRING, LIST 타입의 전역 및 플레이어별 변수.
• 변수용 플레이스홀더 지원(다른 플러그인/설정에서 사용할 수 있는 플레이스홀더 토큰).
• 서버 콘솔 또는 다른 플러그인에서 접근할 수 있는 패키징/커스텀 명령 실행 프레임워크.
• 다른 Ssomar 플러그인의 의존성으로 사용되도록 설계됨.

🧩 대상

• Ssomar 플러그인(ExecutableItems, ExecutableBlocks 등)을 운영하는 서버 소유자.
• 투사체, 변수, 커스텀 명령 실행을 위한 재사용 가능한 라이브러리가 필요한 개발자.
• 해당 기능을 위한 가벼운 서버 내 편집기를 원하는 관리자.

🏗️ 사용 예시

• 한 서버가 SCore를 ExecutableItems와 함께 사용하여 커스텀 투사체 동작을 정의하고 실행한다.
• 관리자가 전역 변수나 플레이어별 변수를 만들고, 메뉴나 다른 플러그인을 위한 플레이스홀더로 노출한다.
• 플러그인 개발자가 여러 플러그인에서 변수 저장과 명령 패키징을 재사용하기 위해 SCore에 의존한다.

⌨️ 명령어

참고: 공식 문서에는 변수용 플레이스홀더 토큰도 함께 설명되어 있습니다(예: %score_variables_<var_name>% 및 %score_variables_<var_name>_int%). 권한 노드는 참조된 플러그인 메타데이터에 포함되어 있지 않습니다.

⚙️ 설치

📥 설정

• 해당 플러그인 버전에 맞는 공식 SCore .jar를 다운로드합니다.
• .jar 파일을 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔에서 SCore가 로드되었는지 확인합니다.
• 다른 Ssomar 플러그인을 함께 사용한다면, 프로젝트 안내에 따라 해당 버전 접미사에 맞는 SCore 빌드를 설치하세요(SCore 빌드를 종속 플러그인 빌드에 맞춤).

🧠 기술 노트

• 확인된 지원 플랫폼: Bukkit, Spigot, Paper, Purpur, Folia.
• 확인된 지원 Minecraft 버전: 1.21.x부터 1.8.x까지(프로젝트에 명시됨).
• 프로젝트 메타데이터에는 제한적인 라이선스 표기(ARR / All Rights Reserved)가 있으며, 동시에 기여용 Git 저장소도 언급됩니다. 이 항목들은 공식 메타데이터에서 함께 표시됩니다.
• SCore는 다른 Ssomar 플러그인의 라이브러리/의존성으로 설치되도록 설계되었으며, 다른 플러그인들이 런타임에 호출하는 기능을 제공합니다.

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

Ssomar 플러그인을 사용 중이거나, 커스텀 투사체와 변수 플레이스홀더를 위한 바로 사용할 수 있는 서버 내 시스템이 필요하다면, SCore는 해당 플러그인들이 의존하는 공유 런타임과 편집기를 제공해 같은 메커니즘을 직접 다시 구현할 필요가 없습니다.