Retrium

Retrium v0.1.0 — Initial Release (Minecraft 1.21.1 · Fabric Loader 0.16+)

New Features

• GL capability auto-detection — On startup, Retrium probes your driver and selects the best available rendering path automatically. No manual configuration required.

  • MODERN (GL 3.3+): mod is inactive, no performance impact
  • LEGACY (GL 2.1 + ARB shader extensions): VBO batching + GLSL 1.20 shader active
  • FALLBACK (GL 2.1, no shader support): CPU-side batching + frustum culling only

• Chunk batch merging — Multiple nearby 16×16×16 chunk sections are merged into a single VBO and drawn in one call instead of one draw call per section. Targets a 10–20× reduction in draw call count on old drivers where per-call CPU overhead dominates.

• Frustum culling — A dependency-free 6-plane frustum culler skips geometry that is outside the view before it ever reaches the GPU. Works on all three GL tiers.

• Legacy terrain shader — A minimal GLSL 1.20 (#version 120) shader for the LEGACY tier: one texture sample, baked vertex lighting, no branching. Designed to spend as few ALU ops per fragment as possible on 15-year-old hardware.

• Fixed-function fallback path — For drivers with no shader support at all, Retrium still reduces draw calls via CPU-side batch merging without touching the shader pipeline.

• Tunable config — RenderConfig exposes key knobs for players on constrained hardware:

  • batchGroupSize — how many sections merge per VBO (default: 8)
  • hardCullDistanceGroups — distance pre-cull before frustum check (default: 12)
  • maxBatchRebuildsPerFrame — caps per-frame re-upload cost on chunk edits (default: 2)
  • entityRenderDistance — caps entity render range (default: 32 blocks)
  • disableSmoothLighting — disables MC's AO recalculation, the biggest single CPU cost in chunk building on old hardware (default: on)
  • forceFallbackTier — escape hatch for drivers that lie about their capabilities

Known Limitations

• The chunk-batching render override (MixinWorldRenderer) is a stub in this release — the GL capability detection and all engine infrastructure is active, but the actual per-frame intercept of Minecraft's terrain draw loop requires mixin targets verified against your specific MC build via genSources. See README_MIXINS.md.
• No config screen yet — values must be changed in code until a config lib is wired up.
• GL 3.3+ users see zero effect by design; use Sodium instead.