GlassM

GlassM — Streaming Generation Performance Mod for Casualties Unknown

This project replaces the vanilla "full-layer generation" with player-centered streaming chunk generation, drastically reducing generation overhead and physics costs.

Benchmark Results

FPS Performance:

Device

Scenario

Vanilla

GlassM

Low-End (Snapdragon 870 #1)

34 FPS

Low-End (Snapdragon 870 #1)

28 FPS

Snapdragon 870 #2

53 FPS

Snapdragon 870 #2

46 FPS

Mid-Range (i5)

237 FPS

Mid-Range (i5)

227 FPS

World Generation Time:

Device

Vanilla

GlassM

Low-End (Snapdragon 870 #1)

7 sec

Snapdragon 870 #2

5. 6 sec

Mid-Range (i5) - First Layer

3 sec

Mid-Range (i5) - Subsequent Layers

< 1 sec

Core Features

• Streaming World Generation: Chunks are generated/unloaded on demand based on the player(s) (including all players in multiplayer). Eliminates the full-layer load, resulting in faster entry and smoother gameplay.

• Pre-filled Terrain Data & Streaming Rendering: The entire layer's terrain data is pre-filled at load time (a pure array, extremely low overhead). Chunks are then generated/unloaded on demand.

• Dynamic Physics Zone: Colliders and rigidbody simulations are dynamically disabled for distant chunks. The rigidbody load is significantly reduced from vanilla's 256 blocks.

• Vanilla-Aligned Ore Generation: We use Reflection to invoke the vanilla GenerateOres method. Distribution aligns with vanilla, and mods that patch these ore spawners remain fully compatible.

• Precise Spawn-in: The spawn void is synchronized, and the PlaceBody collision scan lands correctly (Depth 0~15m). Only a 2×2 chunk generation is required for initial spawn.

• Infinite Rock Protection: Streaming generation will not break the boundary Infinite Rock (ID 14).

• Vanilla-Aligned Entities: Thornbacks, stalactites, turret placement parameters and coordinates have been meticulously checked against the vanilla decompiled source. Active creature alert ranges are restored to vanilla levels.

• PerfDiag Built-in Diagnostics: Outputs system timings (WG/Fluid/Rigidbody), FPS, and scene load metrics every 5 seconds.

• Multiplayer Compatibility: Compatible with KrokoshaCasualtiesMP. Chunks load/unload around all players. Client players will no longer fall through the world when the host unloads chunks.

• Structural Fixes: Rendering and collision for large structures across chunk boundaries are now correctly synchronized.

Compatibility Status (v0. 1. 1)

Mod

Status

Custom Structures

✅ Structures are written directly into the pre-filled data, not overwritten.

TitaniumRestored

✅ Hooks after GenerateOres (Data pre-filled successfully).

CUCoreLib (Custom Ores / Structures / Tiles)

✅

TrapLib / AdditionalTraps

✅

✅

QoL Unknown Entity Overrides

❌ Not yet compatible (Entities still go through GlassM's streaming pipeline).

CUCoreLib Buildings (PlaceCrystals)

❌ Not yet compatible (Requires Terrain-Ready event hook).

Installation

• Close the game.