WerewolfUtils

WerewolfUtilsは、Minecraftの「WerewolfQuest」データパックを補助・拡張するためのPaperプラグインです。GUIを用いた直感的な操作、カスタムネームタグの表示、特定のダメージに対するカスタムトーテム処理などの機能を提供します。

概要

このプラグインはデータパックのスコアボードやタグと連動して動作します。指定されたスコアが変動したことを検知してGUIを自動で開いたり、アイテムのドロップを制限したりすることで、より快適なゲームプレイを実現します。

主な機能

• インタラクティブなGUI
  • スコアボードの変動（ww_gui_fortune など）をトリガーとして、対象プレイヤーを選択するGUIを自動的に開きます。
  • 対応アクション: 占い対象の選択、騎士の加護対象の選択、推理対象の選択、最初の感染源（ゾンビ）の選択、ゲッサー用の役職選択。
• OP向け設定GUI (/wwconfig)
  • OP（または werewolfutils.config 権限）を持つプレイヤーが ww_config の各設定値（昼夜の長さ・役職人数・闇鍋モードなど）をGUIで編集できます。
  • 変更内容はプラグインの config.yml に保存され、データパック読み込み時（init 内の #reapply ww_gui_config 1 トリガー）に自動で再適用されるため、/reload 後も維持されます。
• カスタムネームタグ
  • TextDisplay エンティティを利用し、ゲーム参加者（ww_players チーム）の頭上にネームタグを表示します。
  • プレイヤー間の距離（10ブロック以内）、視線の通過、スニーク状態、透明化状態などを考慮して、動的に表示・非表示が切り替わります。
• カスタムトーテム（ダメージ無効化）処理
  • 「騎士の祈り」(ww_knight_prayer) または「騎士の加護」(ww_knight_blessing) のスコアを持つプレイヤーが即死ダメージを受けた際、そのダメージをキャンセルし、HPを全回復させます。同時にトーテムの使用音と専用メッセージを再生します。
• アイテムドロップの制限
  • 役職専用の重要アイテム（占い師の心（占い師用）、推理の魂、地雷、カメレオンの仮面、感染確認）のドロップを自動的にキャンセルします。
  • スコアボード設定 (ww_config の #no_drop) によって、ゲーム中の全ドロップを制限することも可能です。

動作環境

• サーバー: Paper またはそのフォーク (API-Version: 1.21.4-R0.1-SNAPSHOT)
• 対応バージョン: Minecraft 1.21 以降
• Java: Java 21 以降