Thulium

How it works

Garbage collector pressure reduction. Thulium reduces temporary memory allocations during audio listener updates. After JVM warmup, a local microbenchmark measured 0 bytes allocated per update instead of 40. This can reduce the amount of short lived garbage the Java Garbage Collector has to process.

Forge message formatting. For plain message patterns without formatting syntax, Thulium returns the original text directly instead of constructing a MessageFormat parser. Patterns containing braces, apostrophes or arguments continue through Forge’s original parser.

Small key lookup copies. When Forge builds a fresh key-mapping lookup result, Thulium avoids an intermediate array copy for plain ArrayList buckets containing one to four entries. Larger lists and other collection types use the original copy operation.

Native audio position updates. Thulium uses an equivalent scalar OpenAL call for source-position updates. It forwards every update with the same coordinates; allocation savings depend on JVM warmup and workload.

Sound engine optimization. Thulium can suppress identical one-shot environmental sounds played at the same position within 50 ms. It can also reject eligible sounds when its tracked-channel budget reaches 128. Music, voice, records, player and mob sounds, looping and tickable sounds, relative sounds and non-attenuated sounds are exempt. Modded sounds are exempt by default. Sound filtering can be configured or disabled.

Expected results

Overall FPS improvement is roughly 15-25% depending on your system. On CPU-bound setups the difference is more noticeable. The mod also significantly reduces micro-stutters caused by garbage collection.

Does not modify entities, blocks, chunks, lighting or world generation.