Repository navigation
Celtium 0.2.0
Celtium 0.2.0 — GL-less surface, measured
Released 2026-11-04 · tag v0.2.0 · previous v0.1.4-alpha-rc.26
English: 0.2.0 release notes (English)
0.1.4-alpha-rc.26 からの 393 commits(fix 177 / perf 125 / feat 30 / docs 32 / chore 10 / measure 6 /
refactor 5 / test 3 / revert 1 / profile 1 / glow 1)。GL-less レンダラの「起動して絵が出る」土台を、
実測・CPU検証・シーン比較で固めたリリースです。
FPS 目標は未達: Celeritas との paired KPI は 1.189(
NOT_MET)。描画忠実度とエラーゼロは
大きく前進しましたが、フレーム時間ではまだ負けています。詳細は「性能」と「既知の課題」。
ハイライト
- ビルドが通る状態に戻した。上流由来の未コンパイル(
RenderSectionの metrics アクセサ、
mixin の注釈位置、build-1122に Lombok のバージョンが無く annotation processing が動いていなかった)
を修復し、packageJar/validationRemapJarが成功する。 - transformer 生成バイトコードの CPU 検証器を追加。実 LWJGL 宣言 241 件と実 GL クラス 87 個を
ロード検証し、実行時 VerifyError を 4 件修正。うち 1 件は GL20C 自体がロード不能で、
シェーダ経路が起動できない状態だった。 - インデックス描画を実装。クライアント/VBO 頂点、クライアントインデックス、baseVertex、
multi-draw、instance=1 の派生形、12/16/20/24/32 バイトのレイアウトと 32 バイトの再パック。 - レガシー即時モード(glBegin/glEnd)を既定で描画。タイトル画面・メニュー背景・パックメニューの
アートがフレームに載ることをシーンで確認。 - クリエイティブ画面のシーンとアイコン、ツールチップの移動フレーム、モデルリプレイのホットパスを
計測・修正。 - GL 表面の大規模修復: 到達不能だった display list / pixelStore / buffer / texture / FBO /
shader getter 群の再接続、pname 取り違え、未初期化出力、固定幅書き込みのオーバーラン、
VAO 別属性、push/pop 属性スタック、ライト/フォグ/マテリアル、バインディングクエリ。 - 性能計測基盤: 同一 JAR・同一 leg 内 A/B、control arm によるマシンドリフト相殺、
JFR プロファイル、ウィンドウ/グループ/受理経路の内訳。
破壊的変更・移行
- バージョン:
0.2.0。-Pceltium_release_versionで明示ビルドする運用は従来どおり。 - ビルド環境: Gradle を JDK 25 で起動(RetroFuturaGradle 2.0.4 の要件)。
JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64 scripts/build.sh。
build-1122/gradle.propertiesにlombok_versionが必須(無いと@Getterが生成されない)。 - glstub の適用範囲は不変: gl を直接呼ぶ mod 以外には適用しない。
- 設定: 既存の
-Dceltium.*は維持。新規の実験スイッチは既定で安全側
(例:-Dceltium.vulkan.mainClearInQueueは既定 off、-Dceltium.vulkan.replayValueVersionsは既定 on)。 - 配布物:
celtium-forge-mc1.12.2-0.2.0.jar(sha256bf1193b6ba21dc51cd36a5b013607dd58a9ef8bcbc516ca8f24b0c247e9cccee)。
追加(Added)
描画経路
- インデックス描画:
glDrawElements/glDrawRangeElements/glDrawElementsBaseVertex/
glDrawElementsInstanced/glDrawElementsInstancedBaseVertex/glDrawElementsInstancedBaseInstance/
glDrawElementsInstancedBaseVertexBaseInstance(instance=1 は通常描画へ転送)。 - マルチドロー:
glMultiDrawArrays/glMultiDrawElements(サブ描画をデコード経路で再生)。 - レガシー即時モード: glBegin/glEnd の全頂点綴り(float/double/int/short/byte)、glRect*、
マルチテクスチャ座標、全描画モード。 - 描画トポロジ: lines / line strip / line loop / triangle strip / quad strip / polygon の受理と変換。
- 属性:
glVertexAttribPointer/glVertexAttribIPointer(index 0)、normalized/integer フラグ、
VAO 別の属性記録、glPushClientAttrib/glPopClientAttrib/glPushAttrib/glPopAttribの復元。
GL 表面
- display list:
glNewList/glEndList/glCallList/glCallLists/glListBase/
glDeleteLists/glIsList。 - pixelStore: UNPACK/PACK の記録・クエリ・アップロード変換への反映。
- buffer: storage / sub-data / copy / readback / map(DSA 含む)/ clear(零埋め)/ binding クエリ。
- texture: storage(DSA 含む)/ sub-image(DSA)/ parameter(f/iv/fv/Iiv/Iuiv、DSA)/
border colour / level parameter(DSA)/ image readback のゼロ化。 - framebuffer: EXT/ARB 綴り、Named 形式のアタッチメント・状態・パラメータ、renderbuffer の extent。
- shader: info-log(ARB 含む)、active uniform/attrib、program binary、precision、resource 系、
compile/link status、not-found ルックアップ(-1)。 - 同期:
glGetSyncivは SIGNALED、クエリ結果は可視(1)。 - デバッグ:
glGetObjectLabel/glGetObjectPtrLabelの空ラベル。
シーン・検証
- メニュー/タイトル/パックメニュー、クリエイティブ画面、ツールチップ移動、モデル、空、雲、
フォグ、発光 outline のシーンと参照比較。 - ルート検証器(
scripts/cpu-contract/transformer-route-verify.sh)を CPU 契約に追加。 - KPI の control arm(同一 leg 内で candidate / Celeritas / 過去ビルドを交互計測)。
変更・改善(Changed / Improved)
描画忠実度
- タイトル画面・メニュー背景・パックメニューのアートをフレームへ(シーンで確認)。
- クリエイティブ画面のアイコン欠落(空の item plan キャッシュ)を修正。
- ツールチップ: 移動フレームで 1 フレーム 1 ツールチップ、mod FBO バインド中の取りこぼし/残像を修正。
- モデル/カスタム描画: ミラー供給の共通化、属性 0 の記述、VAO 別ポインタ、インデックス経路。
- 空/雲/フォグ/ライト/深度/ブレンド/シザー/ポリゴンオフセットの状態反映を整理。
- 半透明 terrain の背面 cull、combine 中の alpha test 維持、色付きガラスのちらつき修正。
状態・クエリ
- pname の取り違え(SKIP_PIXELS/ROWS、SPOT_CUTOFF、VIEWPORT_DIMS、SHADE_MODEL 等)を修正。
- 未初期化出力の一掃(sampler/renderbuffer/multisample/uniform/object label 等)。
- 固定幅書き込みのオーバーラン修正(light/material の成分数、boolean の 1 バイト)。
- バインディングクエリ(element/pixel/uniform/copy buffer、texture 1D/3D/cube、renderbuffer)。
- 能力値の整合(texture units、anisotropy、attachment/draw buffers、uniform vectors、stack depth)。
性能
- モデルリプレイ: 入力キャッシュ、値バージョン化、ライトペイロードの共有、行列/色/シザーの共有。
- グループ化: 状態キー、フォグ/シザー/ポリゴンオフセットのキャプチャ、ウィンドウ計測。
- クリア: 順序 flush のサイト計測、メイン FBO クリアのキュー搭載(既定 off、拒否 census 付き)。
- ホットパス: 単一参照化、プロパティ読みの定数化、アロケーション削減。
- フォント: バッチの行列保存をスクラッチ化、colour witness の絞り込み。
修正(Fixed)— 主なもの
- 起動/ビルド:
RenderSectionの metrics アクセサ欠落、@Injectの位置 2 件、@Shadowの二重付与、
Lombok の annotation processing 不動作。 - 実行時クラッシュ:
glClearBufferSubDataのスロット、glPushClientAttribの引数欠落、
glDrawElementsInstancedBaseInstanceのスロット、nglGetShaderInfoLogのスロット(GL20C ロード不能)。 - テクスチャ: ミラー未供給、PBO アップロード、DSA アップロード、サブイメージのパッチ、
削除後の名前再利用、サンプラ推論(wrap/filter)。 - FBO: アタッチメント記録、EXT/ARB/Named 綴り、削除時のクリーンアップ、読み出しのルーティング。
- 状態: raw の depth/alpha/lighting enable、push/pop、VAO 属性、ライト/フォグ/マテリアル、
ピクセルストア、バッファバインディング。 - クエリ: 未初期化出力、pname 取り違え、幅の誤り、not-found の 0(-1 へ)。
- 描画: インデックスのレイアウト/オフセット/再パック、クライアントメモリ、instance=1、
ライン/ストリップ/ポリゴン、属性 0。 - GUI: メニュー背景、クリエイティブタブ、ツールチップ、HUD の色/深度。
性能(Performance)
対 Celeritas paired KPI(modpack 環境、AMD RX 6400 / RADV NAVI24、1280×720、3 対)
測定環境(重要): 素のバニラではなく、テスターと同じ Cleanroom Relauncher の modpack インスタンス
celtium-world-accept(192 mods、save qmagnet)で実行しています。シーンは world、pose は
x=217.5 y=48 z=217.5 yaw=180 pitch=10、guiScale=3、renderDistance=12、maxFps=260、vsync off、
1280×720。1 leg 240 秒、warm window は world tick 400–600(hold 620)。
KPI leg は計測税を除くため validation off(-Dceltium.vulkan.validation=false、
presentReadback=false、presentedDumpEvery=0)で、Celeritas 2.5.0-dev(sha256 567dcf8a…)と
同一シーン・同一 JAR 条件で交互に計測しています。control arm は round 58 のビルド(de8ed2e7…)。
validation 0 の証拠は別 leg(validation on、r64c-carry 等)で取得したもので、KPI leg の
validationMessageCount=0 は validation off のため、クリーン性の証拠には数えていません。
| rep | Celtium p50 | Celeritas p50 | 比 | 過去ビルド比 |
|---|---|---|---|---|
| 1 | 2.742 ms | 2.332 ms | 1.176 | 0.985 |
| 2 | 2.869 ms | 2.413 ms | 1.189 | 1.063 |
| 3(負荷混入) | 3.620 ms | 2.311 ms | 1.566 | 1.380 |
| 中央値 | 1.189 | 1.063 |
goalCondition=NOT_MET。clean な 2 rep は 1.176 / 1.189 で、過去ビルド(round 58)比は −1.5% / +6.3%。- rep 3 は
finalLoadAverage0.96 → 3.98 の混入で、同型の汚染は round 63 でも観測済み。 - フレーム内訳(出荷コード、AMD): frame 1322 µs = world 861 + gui 421 + hand 50。
85% は Celtium の即時経路(受理 161 offer × 4024 ns = 648 µs + flush 392 + guiFlush 81)。
単位は offer 160.8 / group 131.9 / 窓 23.4。 - 窓の起点は framebuffer bind(
flushSiteCounts=[bind-framebuffer=792]、flushReasonsの 65%)。
clear 起点という仮説は棄却済み。 - 残る構造レバー: bind ごとの「frame image を実際にサンプルするか」census と不要 flush の削除、
accept path の未計測区間(offPreflight〜offAppend の約 470 行)の bracket、
bindless immediate textures、不透明・depth-write・非 blend 用の第 2 open group。 - 棄却済み(再試行しない): sticky pass 統合(2.85→11.47 ms)、font run の行列 bake(94→8 run)、
clear 起点の flush 削減(窓/フレーム不変)、stateKey の format 要因(hit 21.9% のまま)。
検証(Verification)
- ビルド:
:celtium-vulkan:test :forge122:packageJar :forge122:validationRemapJar成功。 - テスト:
celtium-vulkan422 tests / 0 failures、scripts/tests177 tests OK。 - ルート検証:
transformer-route-verify.sh→ 実 LWJGL 宣言 241、実 GL クラス 87/87、
colour 32/32、texcoord 64/64、query 8/8、failed=0。 - 文書:
check_agent_docsOK、instrument-index --checkcurrent。 - 実機 leg: KPI 9 legs はすべて
fixtureStatus=PASSED、gpuRequirementMet=true、problems=[]
(KPI leg は validation off。クリーン性は validation on の別 leg で確認)。world 画像
(terrain/blocks/items/HUD/minimap/hotbar/hand)を目視確認。 - JAR 検査:
verify_forge_jar.py/verify_version_consistency.pyともverified: true。
既知の課題(Known issues)
- FPS は Celeritas 比 1.189 で未達。accept path とウィンドウが残。Intel の p99(1.048)も未解決。
- メニュー/ツールチップ/クリエイティブタブはシーンで確認済みだが、テスター環境での再確認が必要。
- 未実装: cube map / 3D texture / MSAA / compute / blit / copyImage / 一部の DSA /
stencil(ModularUI の Stencil#reset は mask 0x400 で未実装)。 - 実機 leg は環境依存: 検証ハーネスの Prism インスタンス構成に依存。配布 JAR は別途テスターで確認。
- 影/シェーダパック: Demonica fork の addon として別成果物。core には取り込まない。
インストール
- Cleanroom Relauncher 構成(Cleanroom 0.7.12-alpha / LWJGL 3.4.3 / ゲーム JVM は Java 27)を用意。
celtium-forge-mc1.12.2-0.2.0.jarをmods/に置く。- 起動し、ワールドに入り、GUI/メニュー/クリエイティブ/ツールチップを確認。
- 問題報告には
logs/latest.log、-Dceltium.vulkan.validation=trueの有無、GPU、シーン、JAR の sha256 を添付。
統計
- commits: 393(fix 177 / perf 125 / feat 30 / docs 32 / chore 10 / measure 6 / refactor 5 / test 3 / revert 1 / profile 1 / glow 1)
- 変更ファイル:
celtium-vulkan/forge122/common/scripts/docs - テスト: 422 + 177
- ルート検証: 241 declarations / 87 classes
- 主要証拠: docs/evidence、
docs/plan.md