How keichankotaro/matasabaplugin works
プロジェクトのタイプと目的を特定
• このプロジェクトは「Minecraft サーバー(Spigot/Bukkit)用のプラグイン」で、アイテム消費によるテレポート機能やワールドシード表示などを提供します。
• 主な機能:
・ /tpb 系コマンドで拠点へのテレポート(アイテム消費)
・ /tpbe 系コマンドでエンティティ同伴テレポート
・ /seed でシード値表示
・ config.yml から拠点座標や使用アイテム数を設定
ファイル構造の分析
• トップレベル
・ pom.xml:Maven プロジェクト設定
・ plugin.yml:プラグイン定義(コマンド登録・メタデータ)
・ config.yml:ユーザー設定ファイル
• Java ソース (src/main/java/com/keichankotaro/matasaba/matasabaplugin/)
・ MatasabaPlugin.java:Plugin のエントリポイント(onEnable/onDisable)
・ cmd.java:コマンド実行クラス
・ ItemListener.java:アイテム使用イベントのリスナー
・ BlockManager.java/PlayerManager.java:ゲーム内オブジェクト管理
・ DBManager.java/DBSearch.java:データベース(例:SQLite)操作
• リソース (src/main/resources/)
・ config.yml:デフォルト設定
・ plugin.yml:プラグイン定義
システム設計図に含めるべき主なコンポーネント
a. Plugin コア
• MatasabaPlugin(onEnable:初期化、コマンド/リスナー登録)
b. コマンド処理層
• cmd(tpb/tpbe/seed/rlm の各コマンドをハンドリング)
c. イベントリスナー
• ItemListener(アイテム使用を検知)
d. ビジネスロジック層
• BlockManager/PlayerManager(位置設定、テレポートロジック)
e. 永続化層
• DBManager(接続管理)
• DBSearch(クエリ実行)
f. 設定・定義
• config.yml(拠点情報/使用アイテム設定)
• plugin.yml(プラグイン情報)
g. 外部依存
• Bukkit/Spigot API
• JDBC/SQLite ドライバ
コンポーネント間の関係とデータフロー
• 起動時:MatasabaPlugin → config.yml 読込 → DBManager 初期化 → 各 Manager/Listener 登録
• コマンド実行時:プレイヤー → cmd → BlockManager/PlayerManager → Bukkit API → テレポート処理 → DBSearch ログ取得(必要時)
• イベント検知時:ItemListener → 使用アイテム判別 → PlayerManager 呼び出し → テレポート
• 設定変更時:/rlm → cmd → MatasabaPlugin.reloadConfig()
重要なアーキテクチャパターン/設計原則
• 単一責任原則(Manager クラスごとに役割分担)
• プラグインライフサイクル管理(onEnable/onDisable)
• イベント駆動モデル(Listener)
• 設定外部化(YAML)
図のカスタマイズガイド(Minecraft プラグイン向け)
• プラグインコアと外部 API(Bukkit/Spigot)を明確に分離
• コマンド→ビジネスロジック→DB の流れを矢印で表現
• 設定ファイルと plugin.yml は「設定コンポーネント」としてまとめる
図に必ず含める要素
• 各コンポーネントのラベル(例:MatasabaPlugin, cmd, ItemListener, BlockManager…)
• 矢印(データ/制御の流れ)
• 色分けまたは形状区分(例:
・ Plugin コア:青い長方形
・ ビジネスロジック:緑色長方形
・ イベントリスナー:オレンジ丸
・ DB:シリンダー(円柱)
・ 外部 API:灰色長方形 )
• コマンド/イベント→Manager→API→DB のシーケンスを強調
以上の要素を漏れなく盛り込み、詳細レベルを維持しつつ全体像を俯瞰できるシステム設計図を作成してください。
必要に応じて、補助的にシーケンス図やクラス図を併用すると設計理解がさらに深まります。