# keichankotaro/matasabaplugin architecture

> Architecture diagram of the GitHub repository keichankotaro/matasabaplugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/keichankotaro/matasabaplugin
- Repository: https://github.com/keichankotaro/matasabaplugin

## Overview

##### プロジェクトのタイプと目的を特定
- このプロジェクトは「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 のシーケンスを強調

以上の要素を漏れなく盛り込み、詳細レベルを維持しつつ全体像を俯瞰できるシステム設計図を作成してください。
必要に応じて、補助的にシーケンス図やクラス図を併用すると設計理解がさらに深まります。

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Plugin Core
    subgraph "Plugin Core"
        MSP["MatasabaPlugin"]:::core
    end

    %% Command Layer
    subgraph "Command Layer"
        CMD["cmd"]:::command
    end

    %% Event Listener
    subgraph "Event Listener"
        ITL["ItemListener"]:::listener
    end

    %% Business Logic
    subgraph "Business Logic"
        BM["BlockManager"]:::business
        PM["PlayerManager"]:::business
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        DBM["DBManager"]:::database
        DBS["DBSearch"]:::database
    end

    %% Configuration
    subgraph "Configuration"
        CFG["config.yml"]:::config
        PLY["plugin.yml"]:::config
    end

    %% External Dependencies
    subgraph "External API"
        BUK["Bukkit/Spigot API"]:::external
        JDBC["JDBC/SQLite Driver"]:::external
    end

    %% Project Setup
    POM["pom.xml"]:::setup

    %% Connections
    MSP -->|"reads config"| CFG
    MSP -->|"initialize DB"| DBM
    MSP -->|"register cmd/listener"| CMD
    MSP -->|"register cmd/listener"| ITL

    CMD -->|"executes commands"| BM
    CMD -->|"executes commands"| PM
    CMD -->|"reload config"| MSP

    ITL -->|"detect item use"| PM

    BM -->|"uses API"| BUK
    PM -->|"uses API"| BUK

    BM -->|"log/query"| DBS
    PM -->|"log/query"| DBS

    DBM -->|"manage connection"| JDBC
    DBS -->|"execute queries"| JDBC

    %% Click Events
    click MSP "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/MatasabaPlugin.java"
    click CMD "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/cmd.java"
    click ITL "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/ItemListener.java"
    click BM "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/BlockManager.java"
    click PM "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/PlayerManager.java"
    click DBM "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/DBManager.java"
    click DBS "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/java/com/keichankotaro/matasaba/matasabaplugin/DBSearch.java"
    click CFG "https://github.com/keichankotaro/matasabaplugin/blob/main/src/main/resources/config.yml"
    click PLY "https://github.com/keichankotaro/matasabaplugin/blob/main/plugin.yml"
    click POM "https://github.com/keichankotaro/matasabaplugin/blob/main/pom.xml"

    %% Styles
    classDef core fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef command fill:#B0E0E6,stroke:#000,stroke-width:1px
    classDef listener fill:#FFA500,stroke:#000,stroke-width:1px,shape:circle
    classDef business fill:#90EE90,stroke:#000,stroke-width:1px
    classDef database fill:#FFE4B5,stroke:#000,stroke-width:1px
    classDef config fill:#FFFACD,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef setup fill:#E6E6FA,stroke:#000,stroke-width:1px
```
