Argon-Performance (Neoforge)

Lite structure-layout optimizer and frame cadence for Minecraft 26.x Neoforge.
Back to Files

argon-0.3.0-neoforge

File nameargon-0.3.0.jar
Uploaded
Nov 16, 2026
Downloads
4
Size
48.5 KB
Mod Loaders
NeoForge
File ID
9641495
Type
R
Release
Supported game versions
  • 26.3

Curse Maven Snippet

NeoForge

implementation "curse.maven:argon-performance-neoforge-1714928:9641495"

Learn more about Curse Maven

What's new

Changelog

0.3.0

NeoForge port of Argon 0.3.0. Structure layout and seeds are unchanged. This version is edge-case correctness, thin-region layout performance, and improvements in reliability.

NeoForge

  • The mod entry point is a @Mod class and the metadata is META-INF/neoforge.mods.toml. The loader name in the log line and in the F3 line reads NeoForge.
  • The mixin targets are written the way NeoForge needs them. Every target is a string with remap = false, because NeoForge runs the game under the official Mojang mappings and there is no refmap to remap against.
  • The build uses ModDevGradle 2.0.148 against NeoForge 26.3.0.103, with the Gradle configuration cache on.
  • The decompile and recompile pipeline is deliberately left on. The layout mixins capture vanilla locals by name, and the local variable table only carries those names in a jar that was produced by recompiling the decompiled sources. The pipeline that skips recompilation hands back a jar whose locals are still the obfuscated ones, so every @Local(name = ...) capture would fail to resolve at runtime.
  • The centre-piece capture in JigsawPlacementMixin is keyed on the local name box. The earlier NeoForge build took the first BoundingBox argument instead, which is the centre piece itself and not the box the target reads, so the capture was of the wrong variable.
  • neoforge.mods.toml uses iconFile rather than the deprecated logoFile, and requires NeoForge 26.3.0 or newer.
  • The mod id, the mod name, the licence, the version and both version ranges come from the Gradle properties, so the metadata and the build cannot drift apart.
  • The unit tests run inside the loader, because the game registries a jigsaw block state comes from are only populated once the loader is up. The injection test moved out of the argon.mixin package, which the loader owns and will not load a test class from.

Layout

  • BoxOctree widens a BoundingBox before adding one to its maximum coordinates. At Integer.MAX_VALUE the old int addition wrapped negative, so a piece at the positive coordinate limit was silently left out of the tree and an overlapping candidate was accepted. The 0.25-deflated query box uses the same widening.
  • A node now subdivides along whichever axes are at least two blocks wide instead of refusing to split unless all three were. A flat or rod-shaped structure region used to keep every piece in one leaf and scan them linearly.
  • The root starts at depth zero, so MAXIMUM_DEPTH = 5 now allows five subdivision levels instead of four.
  • The active child count is sized to the number of axes that actually split, up to eight, so a one- or two-axis split does not walk empty child slots.
  • Removed the unused ArgonProfiler.TOTAL_LAYOUT_TIME_NS counter.

Frame Cadence

  • FrameCadence.waitUntil clears the thread's interrupt flag while it parks and restores it before returning. LockSupport.parkNanos returns immediately while the flag is set, so an interrupted render thread used to busy-spin through the park window; the interrupt is still delivered after the wait.
  • The F3 line reads the live frame limit instead of trusting the pacing flag. Vanilla only calls the frame limiter while the cap is below 260, so the limiter mixin never sees an unlimited frame rate and the pacing state used to stay set from the last limited frame. The line now reports the frame rate that is actually being applied.

Debug

  • TrojanVoxelShape.getCoords now returns the coordinates of its filled 1x1x1 placeholder. It used to return an empty list for a non-empty discrete shape, so any accidental vanilla shape query on the carrier would index an empty coordinate list instead of seeing a small valid shape.

Tests

  • Added a differential test that compares BoxOctree.hasRoomFor with the real vanilla Shapes.join and Shapes.joinIsNotEmpty free-space algebra, candidate for candidate.
  • Added a differential test that compares Argon's attach rule with vanilla's JigsawBlock.canAttach over the whole cross product of parent and child orientations, joint types and name matches.
  • Added regression tests for a piece at Integer.MAX_VALUE, for subdivision of a region one block wide on an axis, for the carrier's placeholder coordinates, and for interrupt preservation in frame pacing.

This mod has no related projects