English | 日本語

KubeJS Studio Performance Patch is an optimization and bug-fix addon for KubeJS Studio on Minecraft 1.20.1 (Forge). It resolves severe lag, UI freezing, high CPU overhead in large-scale modpacks, as well as fixing entity loot inspection/test rolls and Windows mojibake (character corruption).

1. Zero-Freeze Item Picker (Lazy Hover-Name Resolution)
   • Eliminates the multi-second UI freezing when opening item/block picker dialogs by replacing synchronous per-item localization with fast formatted labels.
2. High-Speed Pre-Tokenized Search Engine
   • Pre-compiles search tokens outside the item loop, skipping regular expression overhead and reducing memory garbage generation during search keystrokes.
   • Automatically utilizes parallel multi-threaded filtering when browsing large catalogs.
3. High-Speed File Search (Find in Files)
   • Drastically accelerates workspace script and datapack file search through early rejection matching and compiled pattern caching.
4. Registry Caching
   • Caches GameState registry entries and tag options in memory to avoid repetitive object allocation and garbage collection spikes.
5. Loot Table Inspection & Entity Test Rolling Fix
   • Restores drop preview by falling back to server LootData when KubeJS dynamic tables are not present in RawDataStore.
   • Properly handles subpath entity tables (e.g. minecraft:entities/sheep/white) and initializes entity state to allow functional test rolls.
6. UTF-8 Encoding Enforcement & Mojibake Prevention
   • Enforces UTF-8 encoding across all file operations on Windows (MS932) to prevent property tab text corruption and syntax errors.
7. Bilingual / Multilingual Font Fallback
   • Automatically falls back to vanilla font rendering in non-Latin/Japanese environments to prevent tofu/missing glyph boxes.
8. Mod Recipe Type Resolution & Dynamic Visual Slot Grid
   • Resolves mod recipe types from Forge registries and type objects, eliminating ? in the Recipe Browser.
   • Automatically generates responsive slot grids and parameter fields for any mod recipes (such as Advanced AE Reaction Chamber), enabling full visual inspection and editing of non-workbench recipes.
9. Crafting Table & Conditional Recipe Visual Fix
   • Guarantees multi-ingredient crafting table recipes (crafting_shaped, crafting_shapeless) cleanly render on the standard 3x3 grid without being overridden.
   • Tolerates metadata conditions (forge:conditions, etc.) so modpack conditional recipes display full visual slot grids.

KubeJS Studio Performance Patch は、Minecraft 1.20.1 (Forge) 向けの KubeJS Studio 最適化・不具合修正アドオンMODです。 数万種類のアイテムやブロック、レシピ、膨大なスクリプトファイルが存在する大規模MODパック環境において、UIのフリーズ、検索入力時の引っかかり、高CPU負荷を根本から解消するとともに、ルートテーブルのドロップ品確認・テスト抽選機能の修正、Windows環境下での文字化け防止を提供します。

1. アイテム選択ダイアログの即時オープン（ホバー名解決の遅延化）
   • 数万件のアイテムを読み込む際、同期的なローカライズ名解決（getHoverName）を高速な事前生成ラベルに置き換えることで、ダイアログを開く瞬間の数秒〜数十秒の画面フリーズを完全解消します。
2. トークン事前分割による高速検索エンジン
   • 検索入力時の各行判定ごとに正規表現分割を行っていた処理を事前トークン化し、文字列分割処理とGC（メモリゴミ）の発生を抑制します。
   • 大規模リストでは自動的にマルチスレッド並列処理を適用して高速に絞り込みます。
3. 高速ファイル検索（Find in Files 最適化）
   • スクリプト・データパック全文検索において、非正規表現テキスト検索の早期判定スキップとコンパイル済みPatternキャッシュを適用し、検索速度を大幅に向上させます。
4. レジストリエントリキャッシュ
   • GameState のレジストリ要素およびタグ一覧をメモリキャッシュし、不要なオブジェクト再生成とGC負荷を低減します。
5. ルートテーブルドロップ確認＆エンティティテスト抽選の修正
   • KubeJSの動的変更等によりデータストアにキャッシュされていないルートテーブルについて、Minecraftサーバーの実体からJSONフォールバック取得し、ドロップ品確認機能を復旧。
   • サブパス付きエンティティ（羊の毛色やMODエンティティ等）の親エンティティ型解決およびエンティティ状態（座標・ヘルス）を適切に初期化し、テスト抽選が0ドロップになる不具合を修正。
6. ファイル読み書きのUTF-8強制・文字化け完全防止
   • Windows日本語環境（MS932/Shift_JIS）でのファイル読み書き時に発生していたプロパティタブ等の文字化けを防止するため、全ファイルI/Oで UTF-8 を強制適用。
7. 多言語フォントフォールバック
   • 日本語等の非ラテン環境において、デフォルトフォント（JetBrains Mono）で発生する豆腐化・グリフ欠落を防止するため、バニラフォントレンダラーへ適切にフォールバック。
8. MODレシピタイプの解決と動的ビジュアルスロット生成
   • Forge レジストリおよび内部オブジェクトからレシピタイプを網羅的に解決し、レシピ一覧で MOD レシピが ? となる現象を解消。
   • 専用フォームのない外部 MOD レシピ（Advanced AE の反応室など）に対しても、入力アイテム・液体・完成品・追加パラメータを自動解析してスロットグリッドを動的に構成。作業台レシピ以外のあらゆるレシピでスロット表示と確認・編集が可能になります。
9. 作業台レシピ（定型・不定型）および条件付きレシピのビジュアル表示修正
   • 2種以上のアイテムを使用する作業台レシピが誤ってカスタムフォームとして扱われ材料スロットが消える問題を修正し、確実に標準3x3作業台グリッドで表示。
   • forge:conditions 等が付与された条件付きレシピでも、3x3作業台グリッドが棄却されずに視覚的に表示・編集できるよう改善。

1. Minecraft 1.20.1 および Minecraft Forge 47.3.0 以上を準備します。
2. KubeJS Studio（およびその前提MOD: KubeJS, Kotlin for Forge 等）を導入します。
3. 本MODのJARファイル（kjstudioperf-1.20.1-1.0.0-alpha.9.jar）を mods/ フォルダに配置します。
4. ゲームを起動してください。