====== RG-Optimizer ======

Minecraft 1.21.10 (Paper / Folia対応) 向けのサーバー負荷軽減および診断プラグインです。
レッドストーン回路、ホッパー、モブのスポーン条件などのバニラ仕様は変更せず、エンティティの削減とラグの記録に特化しています。

===== 機能一覧 =====

==== 1. アイテムマージ (Item Merge) ====
ドロップアイテムを指定範囲内で自動的に結合し、エンティティ数を削減します。
  * **スキャン間隔**: 40 Tick（2秒）ごと
  * **結合範囲**: 3.0 ブロック
  * **除外条件**: 名前付きアイテム、CustomModelDataを持つアイテムは結合から除外されます。

==== 2. 経験値オーブマージ (XP Orb Merge) ====
経験値オーブを指定範囲内で結合します。
  * **スキャン間隔**: 40 Tick（2秒）ごと
  * **結合範囲**: 4.0 ブロック
  * **仕様**: 合計経験値量を維持したまま1つのエンティティにまとめます。

==== 3. 発射物クリーンアップ (Projectile Cleanup) ====
地面やブロックに刺さった発射物（矢、トライデント）を消去します。
  * **消去条件**: 刺さった状態から指定時間（デフォルト5秒 / 100 Tick）が経過したもの

==== 4. 自動ラグ診断モニター (Auto-Diagnostic Monitor) ====
サーバーのMSPTスパイクを検知し、状態の記録とプロファイリングを自動で実行します。
  * **発動条件**: MSPTが 50.0ms を 5秒間 連続で超えた場合
  * **動作1 (レポート出力)**: 発動時のヒープメモリ使用率や実行中のタスク数を記録したテキストファイルを ''plugins/RG-Optimizer/diagnostics/'' に生成します。
  * **動作2 (プロファイラ起動)**: 自動的に ''/spark profiler --start --timeout 15'' を実行し、15秒間のプロファイルを記録します。
==== 5. AI復帰 ====
他のプラグインのバグや処理の問題でmobの動きが止まってしまったのを開放するための機能です。

===== コマンドとパーミッション =====

^ コマンド ^ 説明 ^ パーミッション ^ デフォルト ^
| ''/rg-stats'' | TPS、MSPT、および最適化モジュールの実行統計を表示します。 | ''rgoptimizer.stats'' | OP |
| ''/rg-reload'' | ''config.yml'' の設定を再読み込みします。 | ''rgoptimizer.admin'' | OP |
| ''/rg-unfreeze'' | ''停止したmobのAIを復活させます。 | ''rgoptimizer.admin'' | OP |

===== 設定ファイル (config.yml) =====

<code yaml>
# ============================================================
# RG-Optimizer Configuration
# ============================================================

item-merge:
  enabled: true
  scan-interval-ticks: 40
  merge-radius: 3.0
  exclude-named-items: true
  exclude-custom-model-data: true

xp-merge:
  enabled: true
  scan-interval-ticks: 40
  merge-radius: 4.0

projectile-cleanup:
  enabled: true
  scan-interval-ticks: 100
  stuck-time-threshold: 100

diagnostics:
  enabled: true
  check-interval-ticks: 20
  mspt-threshold: 50.0
  trigger-duration-seconds: 5
  auto-run-spark: true
  cooldown-seconds: 300

metrics:
  enabled: true
  reset-interval-seconds: 300
</code>