TERIE-Blessing

팀 테리에 RPG 서버용 가호 시스템 플러그인입니다. 플레이어는 /가호로 가호를 장착/변경하고, 관리자는 /blessing 명령으로 가호 데이터와 시스템 상태를 관리합니다.

요구 환경

• 서버: Paper 1.21.10
• 플러그인 API: 1.21.10

명령어

플레이어

• /가호
  • 가호 변경 GUI(호퍼 5칸)를 엽니다.

관리자 (terie.blessing.admin)

• /blessing enable
• /blessing disable
• /blessing reload
• /blessing create <id>
• /blessing delete <id>
• /blessing list
• /blessing give <id> <all|player> [playerName]
• /blessing modify displayName <id> <displayName>
• /blessing modify lore <id> <index> <lore>
• /blessing modify itemModel <id> <itemModel>
• /blessing modify default effect <id> <effect> [amplifier]
• /blessing modify default effect remove <id>
• /blessing modify interval effect <id> <effect> [amplifier] [duration] [interval]
• /blessing modify interval effect remove <id>
• /blessing modify interval command <id> <command> [interval]
• /blessing modify interval command remove <id>

참고:

• /blessing 명령은 탭 자동완성(명령어 힌트)을 지원합니다.
• /blessing list는 플레이어가 실행하면 항목 클릭으로 본인에게 지급 명령을 실행할 수 있습니다.

데이터 파일 구조

plugins/TERIE-Blessing/
  config.yml
  blessing/
    {id}.yml
  status/
    {UUID}.yml

config.yml

enabled: true

blessing/{id}.yml

display_name: "&fexample"
lore:
  - "&7Blessing description"
item_model: ""
default: []
interval:
  effects: []
  commands: []

status/{UUID}.yml

blessing: "example"

동작 메모

• 가호 GUI 제목은 가호 변경이며, 호퍼 5칸(0~4) 중 0,1,3,4 슬롯은 잠금 슬롯입니다.
• 잠금 슬롯은 검은색 색유리판으로 채워지고, 이동/클릭/드래그/숫자키 교체 등 상호작용이 차단됩니다.
• 실제 가호 슬롯은 2번만 사용하며, 유효한 가호 아이템만 배치할 수 있습니다.
• 잘못된 명령어나 잘못된 아이템 입력 등 오류 상황은 빨간색 메시지로 안내됩니다.
• 가호 아이템 기본 재질은 PAPER입니다.
• display_name, lore는 & 색상 코드를 지원합니다.
• 가호를 장착/변경하면 즉시 반영되고, {가호 이름}의 가호를 받았습니다. 메시지와 인첸트 테이블 효과음이 재생됩니다.