トラブルシューティングと FAQ
📌 リポジトリソースコードに関する免責事項: この Wiki のドキュメントはリポジトリ内の現在のソースコードの状態を反映しており、CurseForge および Modrinth での公開リリースビルドに先駆けた最新の未リリースコミットや開発中の機能が含まれている場合があります。
❓ よくある質問
Q1: 既存のワールドで config/stack-size-adjuster.json の設定が反映されません。
A: グローバル設定ファイル（stack-size-adjuster.json）は新規作成されたワールドにのみ適用されます。既存のワールドではルールが level.dat に記録されているため、ゲーム内で /gamerule コマンドを使用して変更してください：
text
/gamerule stack-size-adjuster:items_64_limit 256Q2: スタック制限を 39,768,215 より大きくするとどうなりますか？
A: $39,768,215$ を超える設定は、ラージチェストでの 32 ビット整数オーバーフローのリスクが生じます。54 スロットすべてが満杯になった場合、合計数が上限（$2,147,483,647$）を超えてマイナス値になり、アイテム移動時に消失する原因となります。上限を $\le 39,768,215$ に保つことを強く推奨します。
Q3: チェストを壊した際、何千個も落ちずに 8 個程度の山しか出ないのはなぜですか？
A: これはサーバー負荷を抑えるための仕様で、stack-size-adjuster:max_drop_entities（デフォルト: 8）によって制御されています。Item Clumps と併用することで、その 8 個の山も自動的に 1 つにまとめられます。
🛠️ 主な問題と解決策
| 症状 | 原因 | 解決策 |
|---|---|---|
| インベントリがバニラ制限のまま | ネットワーク同期パケットの不達またはバージョン不一致 | クライアントとサーバーの両方に同一バージョンが導入されているか確認してください。 |
| Give コマンドで「アイテムが多すぎます」と出る | /give の要求数が $100 \times \text{maxStackSize}$ を超過 | 指定数を減らすか、複数回に分けてコマンドを実行してください。 |
| ModMenu で YACL 設定画面が開かない | ModMenu または YACL が未導入 | クライアントに ModMenu と YetAnotherConfigLib (YACL v3) を導入してください。 |