Geo's Belt Tweaks

Geo's belt tweaks for Dyson Sphere Program.

Tweaks

• Show belt preview tilt: Belt previews show the belt's slope and tilt.
• Match starting belt height: Match the height of the belt or splitter you start from, rounded to the nearest build level. Splitters with ports at multiple heights use the base level; raise the belt height to use an upper port.
• Match starting belt tier: Extending a belt selects its tier.
• Toggle belt surface height: Press numpad 0 (or your rebound reset-height hotkey) to reset to the surface, then press it again to restore the previous height. Closing the belt tool clears the remembered height. Tilt still resets on each press.
• Remember belt free-angle mode: Keep free-angle mode selected with R when closing and reopening the belt tool.

All tweaks are enabled by default. Set ShowBeltPreviewTilt, MatchStartingBeltHeight, MatchStartingBeltTier, ToggleBeltSurfaceHeight, or RememberBeltFreeAngleMode to false under [Building] in BepInEx/config/com.geostyx.dsp.geosbelttweaks.cfg to disable a tweak. In-game configuration changes apply immediately to previews and the surface-height toggle, to the next belt you start for height and tier, and when reopening the belt tool for free-angle mode. After editing the file, reload the configuration or restart the game.

Setting up a development environment

Install the .NET 10 SDK. The mod targets .NET Framework 4.7.2. References restore from NuGet, so no game install is needed to build.

From the mod directory:

bun turbo build

Outputs: bin/Release/net472/GeosBeltTweaks.dll and the validated Thunderstore archive dist/GeosBeltTweaks.zip. Import the zip into a dedicated r2modman profile.

NuGet restores use the committed packages.lock.json in locked mode. When intentionally updating a package reference, regenerate the lock with dotnet restore -p:RestoreLockedMode=false, review both files, then rebuild.

Compatibility and verification

The compile-time baseline is BepInEx 5.4.17, DysonSphereProgram.GameLibs 0.10.34.28347-r.0, and Unity 2022.3.62. In-game behavior is untested.

Before releasing gameplay changes:

• Verify the patched methods against the intended game's assemblies; compile-time reference packages do not establish runtime behavior.
• Load in the test profile and check BepInEx logs for successful startup and patch failures. Exercise each tweak on fresh and existing saves, save/reload, return-to-menu/load-another-save, configuration toggles, and overlapping mods as applicable.
• Record the exact tested game, loader, and overlapping mod versions and results in the release notes.

@repo/dsp-mod-geosbelttweaks

0.3.0

Minor Changes

• ea30041: feat: chain upgrade belts across tier changes to a single tier
• ea30041: feat: remove the build range limit from chain belt upgrades

0.2.0

Minor Changes

• 92956fb: feat: tilt belt preview caps to match the belt's slope and tilt

• fb0479d: feat: remember belt free-angle mode when reopening the belt tool

  Add a default-on RememberBeltFreeAngleMode setting that preserves free-angle mode between belt-building sessions, without per-frame hooks or allocations.

• 5b21ffb: feat: scaffold Geo's Belt Tweaks DSP mod

• 6c2c5f7: feat: default new belt runs to the starting belt's height and tier

  Add independently configurable, default-on tweaks that select the starting belt's height and tier when extending a built or unbuilt belt. Preserve manual height and tier changes afterward and the current selection when starting on empty ground.

• 91d5616: feat: match starting splitter height when building belts

  Extend MatchStartingBeltHeight to built and unbuilt splitters while keeping the selected belt tier.

• 820d5a1: feat: toggle between surface and previous belt height with the reset-height hotkey

  Add a default-on ToggleBeltSurfaceHeight setting. Remember the height before resetting to the surface and restore it on the next press, preserving the vanilla tilt reset and clearing the remembered height when the belt tool closes. Store the height without allocating or looking up per-tool state, and only run toggle logic on reset-height key presses.

Patch Changes

• b93fa03: feat: version DSP mods from package.json

• 5abebdc: chore: align Geo's Belt Tweaks scaffold with DSP modding practices

  • Pin build dependencies and the C# language version, and lock NuGet resolution.
  • Keep game and loader assemblies out of runtime outputs.
  • Retain Harmony ownership during startup and roll back patches on initialization failure.
  • Exclude generated build files from formatting checks.
  • Validate release archives automatically and replace the manual archive checklist with the validation command.
  • Document the reference baseline and runtime release checks without claiming in-game validation.

• 5b21ffb: chore: move Geo's Belt Tweaks into the geos-dsp-mods workspace

• 5cc9efe: fix: keep queued belt preview caps aligned with the belt's slope and tilt

• 7b5833d: docs: rewrite the Geo's Belt Tweaks README for Thunderstore

• 5b21ffb: chore: rebrand the mod as Geo's Belt Tweaks

• d15620b: feat: prepare Geo's Belt Tweaks for public releases under the Geostyx namespace