個人向け倉庫のuuid取得するメソッドを追加

Author: miyabi033

api.md

@@ -0,0 +1,94 @@
+# BetterStorage API ドキュメント
+
+このドキュメントは BetterStorage の外部連携用APIについて記述しています。
+
+## 主要クラスと構造
+
+### GroupData
+- `String groupName`: グループ名（表示名）
+- `String groupUUID`: 内部識別用UUID（固定）
+- `boolean isPrivate`: 個人用グループかどうか
+- `String ownerPlugin`: このグループを所有するプラグイン名
+- `long version`: バージョン（保存・競合検出用）
+- `StorageData storageData`: ストレージ全体のデータ
+
+### StorageData
+- `Map<String, InventoryData> storageInventory`: ページIDをキーとしたインベントリ情報
+- `double bankMoney`: 銀行資金
+- `boolean requireBankPermission`: 銀行利用に権限が必要かどうか
+
+### InventoryData
+- `String pageId`: インベントリページのID
+- `String displayName`: 表示名
+- `int rowCount`: 行数（1〜6）
+- `boolean requirePermission`: 権限が必要か
+- `Map<Integer, ItemStack> itemSlot`: スロット番号とItemStackのマップ
+- `List<String> userTags`: タグのリスト
+- `long version`: ページ単位でのバージョン番号
+
+---
+
+## DataIO クラスのメソッド一覧
+
+### static GroupData loadGroupData(String groupName)
+指定したグループ名のデータをデータベースから読み込みます。
+
+### static GroupData loadGroupData(UUID groupUUID)
+UUIDベースでグループデータを読み込みます。
+
+### static void saveGroupData(GroupData groupData)
+グループ全体のデータを保存します（全ページ・メンバー・タグ含む）。
+
+### static void saveGroupData(GroupData groupData, long expectedVersion)
+指定されたバージョンと一致する場合のみ保存します（楽観的排他制御）。
+
+### static boolean saveInventoryOnly(DatabaseManager db, GroupData groupData, String pageId)
+ページ単位でインベントリだけを保存。バージョン整合性チェックも含まれます。
+
+---
+
+## Rollback & DiffLog
+
+### RollbackLogManager
+- `saveRollbackLog(GroupData groupData)`: グループ全体の完全スナップショットを保存
+- `restoreGroupFromRollback(String groupUUID, LocalDateTime timestamp)`: 指定時点のバックアップから復元
+- `getRollbackTimestamps(String groupUUID)`: すべてのバックアップ時刻を取得
+
+### DiffLogManager
+- `saveDiffLogs(DatabaseManager db, GroupData groupData)`: 差分ログ（ページごと）を保存
+- `restoreGroupFromDiffLog(DatabaseManager db, GroupData groupData, LocalDateTime timestamp)`: 差分ログから復元（ページごと）
+
+---
+
+## タグ検索・ユーザーアクセス判定（予定機能）
+
+### StorageAPI（将来追加予定）
+- タグに基づくページフィルタリング
+- ユーザーの所属グループ・権限判定
+- 他プラグインからのCRUD操作（安全なラッパー）
+
+---
+
+## データベース構造
+（詳しくは `TableInitializer` を参照）
+- group_table
+- group_member_table
+- storage_table
+- inventory_table
+- inventory_item_table
+- tag_table
+- inventory_item_log
+- rollback_log
+
+---
+
+## 注意
+- 外部プラグインは `GroupManager.getGroupByUUID(UUID)` または `GroupManager.getGroupByName(String)` を通じて `GroupData` を取得可能。
+- `GroupData` を直接変更した場合、`DataIO.saveGroupData()` によって保存が必要。
+- 差分保存の際は `saveInventoryOnly` を使うと効率的。
+
+---
+
+## バージョン
+BetterStorage 1.0.6-SNAPSHOT 用API仕様書
+

readme.md

@@ -0,0 +1,55 @@
+# BetterStorage
+
+高度で安全なグループ型ストレージ管理プラグイン
+
+## 概要
+
+BetterStorage は、プレイヤーごと・グループごとにインベントリ・お金・タグなどを安全かつ柔軟に管理できる Minecraft サーバー用プラグインです。MariaDBによる永続保存、差分ログによるロールバック、UUIDベースによる高精度な識別が特徴です。
+
+## 特徴
+
+- グループ単位でストレージを管理（共有インベントリ/個人インベントリ）
+- UUIDベースの識別（名前変更でも安全）
+- インベントリやタグの差分を自動保存
+- ロールバック機能搭載（過去の状態に戻せる）
+- Redisや他プラグインとの連携を想定したAPI設計
+- 別プラグインによるGUI制御が可能（BetterStorageはバックエンド）
+
+## 対応バージョン
+
+- Paper 1.16.5
+
+## 依存関係
+
+- MariaDB
+- HikariCP
+
+## インストール
+
+1. `BetterStorage-1.0.6-SNAPSHOT-shaded.jar` を `plugins` フォルダに配置
+2. config.yml に MariaDB 接続情報を記入
+3. サーバーを起動してテーブルを自動生成
+
+## コマンド
+
+```
+/bstorage rollback <groupName/playerName> <yyyy-MM-dd HH:mm:ss>
+/bstorage diff <groupName/playerName> <yyyy-MM-dd HH:mm:ss>
+/bstorage list <groupName/playerName>
+/bstorage help
+```
+
+## 差分とロールバックについて
+
+- 保存時に自動で差分ログを記録
+- 毎日深夜にロールバック用の完全バックアップを保存
+- 差分ログは30日で自動削除
+
+## 開発API
+
+BetterStorageは外部プラグインから `GroupData`, `InventoryData` などのデータ取得や制御が可能です。 詳細は [API.md](API.md) を参照してください。
+
+## ライセンス
+
+MIT License（予定）
+

src/main/java/dev/felnull/DataIO/GroupManager.java

@@ -2,6 +2,7 @@
 
 import dev.felnull.Data.GroupData;
 import org.bukkit.OfflinePlayer;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
@@ -91,4 +92,12 @@ public static List<String> getGroupsForPlayer(OfflinePlayer player) {
     public static List<String> getAllGroupNames() {
         return new ArrayList<>(nameMap.keySet());
     }
+
+    /**個人向けグループデータを取得**/
+    public static @Nullable GroupData getPersonalGroup(UUID playerUUID) {
+        return getAllGroups().stream()
+                .filter(g -> g.isPrivate && g.groupUUID.equals(playerUUID))
+                .findFirst()
+                .orElse(null);
+    }
 }