Mods / StepUp Advanced

Tags: #QoL #Utility
Author: Elocrypt
Side: Both
Created: Nov 30th 2024 at 12:09 AM
Last modified: 54 minutes ago
Downloads: 26872
Follow Unfollow 446

Recommended download (for Vintage Story 1.21.0-rc.1 - 1.21.1):
StepUpAdvanced_v1.2.2.zip  1-click install


StepUp Advanced

Precision movement for Vintage Story — configurable step height & speed, ceiling awareness, blacklist, and server enforcement.
QoL Server-Enforced Movement Configuration

StepUp Advanced refines terrain traversal with live hotkeys, blacklist control, and optional server-side limits. It builds on the original StepUp concept with more configurability and multiplayer-friendly enforcement.

Core Controls
  • Configurable Step Height (0.2–2+ blocks).
  • Configurable Step Speed (0.5–2x).
  • Blacklist specific block codes to disable step-up near them.
  • Hotkey toggles and real-time adjustments.
New Movement Logic
  • Ceiling Guard: detects low ceilings to prevent micro-bumping.
  • Forward Ceiling Probe: predictive checks for fast movement.
  • Speed-Only Mode: let other mods own height; SUA manages speed.
Multiplayer & Admin
  • ServerEnforceSettings: clamp min/max, push config on join.
  • Disable client hotkeys where not permitted; clamp all changes to bounds.
  • Client+server blacklists merge; server list is globally enforced.

Controls — Keybinds

  • Insert — Toggle On/Off
  • Home — Reload Config
  • PageUp / PageDown — Step Height ↑ / ↓
  • Arrow Up / Arrow Down — Step Speed ↑ / ↓
Tip: combine Ceiling Guard + Forward Probe for smooth traversal under overhangs and trees.

Commands

Client
  • .sua — list client commands
  • .sua add — add targeted block to blacklist
  • .sua remove — remove targeted block from blacklist
  • .sua list — list blacklisted blocks
Server
  • /sua — list server commands
  • /sua add — add targeted block to server blacklist
  • /sua remove — remove targeted block from server blacklist

Server Enforcement

  • On join, clients receive server config; hotkeys can be disabled if not allowed.
  • All client changes are clamped between server min/max limits when enforced.
  • Server limits are validated and auto-corrected if out of bounds.

New in v1.2.0

  • Speed-Only Mode — let another mod manage height; SUA manages speed.
  • Ceiling Guard & Forward Probe — predictive collision checks (distance/support options).
  • Localization — multi-language support.
  • Refinements — clamping rules, faster update path, field caching; step-speed now always applies.
  • Cleanup — removed experimental step-down prototype.
Migration: set SpeedOnlyMode = true to delegate height to other mods; use Reload Config (or relog) to switch reliably. Consider ServerEnforceSettings = true for global clamps.

Default Config

{ "StepUpEnabled": true, "ServerEnforceSettings": false, "AllowClientChangeStepHeight": true, "AllowClientChangeStepSpeed": true, "AllowClientConfigReload": false, "StepHeight": 1.2, "StepSpeed": 1.3, "DefaultHeight": 0.6, "DefaultSpeed": 0.7, "StepHeightIncrement": 0.1, "StepSpeedIncrement": 0.1, "BlockBlacklist": [], "ServerMinStepHeight": 0.6, "ServerMaxStepHeight": 1.2, "ServerMinStepSpeed": 0.7, "ServerMaxStepSpeed": 1.3, "EnableHarmonyTweaks": true, "SpeedOnlyMode": false, "CeilingGuardEnabled": true, "ForwardProbeCeiling": false, "RequireForwardSupport": false, "ForwardProbeDistance": 1, "ForwardProbeSpan": 1, "CeilingHeadroomPad": 0.05 }

Support the Project

If StepUp Advanced helps you, consider supporting future development — it really makes a difference.

Open-Source Friendly Actively Updated MP-Safe

Design Note

Multiplayer includes a hardcoded (in older version) max step height of 2 blocks (configurable) to keep traversal sensible and avoid “cheat-like” behavior on servers that require the mod.


Credits: Original StepUp by CopyGirl. StepUp Advanced by Elocrypt.

Mod Version For Game version Downloads Released Changelog Download 1-click mod install*
1.2.2
1.21.0-rc.1 - 1.21.1
17 54 minutes ago StepUpAdvanced_v1.2.2.zip 1-click install

StepUp Advanced — v1.2.2

Zero-friction updates, safer config writes, and a server-side notice toggle.
Fixes Reliability Server Admin

Highlights

  • No more “delete your config” on update: automatic schema versioning + migration fills new fields and normalizes old values.
  • Crash-proof config saving: single-writer policy with OS mutex, debounce, and retry backoff (plays nice with Defender/OneDrive).
  • Server-enforced notice toggle: server owners can suppress the one-time enforcement banner to keep their own banner visible.
New & Added
  • Auto-migration pipeline: loads old JSON, fills new keys with safe defaults, repairs zeroed ranges, writes back once.
  • Server banner flag: ShowServerEnforcedNotice (default true) to suppress the “server enforced” chat notice if desired.
  • Blacklist schema: StepUpAdvanced_BlockBlacklist.json now has its own schema/versioning; entries deduped + sorted.
Changed
  • Save policy: single-player client writes; dedicated server writes; SP integrated server does not write (prevents double-writes).
  • Debounced saves: hotkey/UI spam coalesces into one save (~200 ms).
  • Runtime clamping: when enforcement is ON, height & speed are clamped to both server min and max (not just max).
  • Watcher echo suppressed: server-initiated reloads avoid duplicate file-watch broadcasts.
Fixed
  • Rare crash on config save with “file in use by another process” (race vs. AV/indexer/cloud sync).
  • Stale/zeroed values after updates when old configs lacked new fields (no regeneration required now).
  • Occasional duplicate client pushes after /reload scenarios.

New / Tuned Config Keys

  • ShowServerEnforcedNoticetrue/false, controls the one-time “server enforcement” banner on clients. Default: true.
  • SchemaVersion — internal; used for automatic migration (no manual edits needed).

Upgrade Notes

  • No action required: updating from previous versions preserves your settings; missing fields are added automatically.
  • Server owners: to suppress the banner, set "ShowServerEnforcedNotice": false in StepUpAdvancedConfig.json and reload/restart.
  • If you run cloud backup/sync on /ModConfig/, the new save logic will retry rather than crash.
Thanks for the reports & test worlds — this release focuses on making updates painless and servers quieter when they need to be.
1.2.1
1.21.0-rc.1 - 1.21.1
3631 Aug 25th at 1:48 PM StepUpAdvanced_v1.2.1.zip 1-click install

StepUp Advanced — v1.2.1

Ceiling-guard tune-up, smarter probes and better performance.
Fixes Movement Logic

Highlights

  • Ceiling Guard refined: fewer false positives under overhangs; maintains smooth climbing when space truly allows.
  • Forward Probe options: add span & headroom padding controls for fine-grained tuning.
  • Performance polish: less reflection churn, fewer redundant writes, lightweight caching.
New & Added
  • Config: ForwardProbeSpan (width across the facing) and CeilingHeadroomPad (safety margin) for ceiling checks.
  • Default Config: Can be found in the mod description or on the discord page.
Changed
  • Ceiling logic: forward probe respects support rules more narrowly; headroom clamping favors real traversable gaps.
  • Clamping path: client floors still apply (height ≥ 0.2; speed ≥ 0.6), but server caps only bind when enforcement is ON.
  • Command outputs: unified success/warn/error styling; clearer values and reasons (e.g., min/max, enforcement blocks).
  • Internals: cached field lookups, skip-same-value writes, and a small scratch position to reduce allocations.
Fixed
  • Cases where players snapped upward under flat overhangs despite adequate headroom.
  • Edge scenarios where legitimate climbs were blocked when a nearby ceiling was present.
  • Minor chat spam/duplication on repeated enforcement notifications.

New / Tuned Config Keys

  • ForwardProbeSpan — horizontal sweep width (blocks) when checking forward ceiling.
  • CeilingHeadroomPad — extra headroom margin (0.00–0.25 suggested) to avoid grazing ceilings.
  • ForwardProbeCeiling, RequireForwardSupport — still available; behavior refined for fewer false positives. (Disabled by default)

Notes & Tuning Tips

  • If you encounter conservative clamping under complex overhangs, try: increase CeilingHeadroomPad slightly (e.g., 0.05 → 0.10) or set ForwardProbeSpan to 0–1.
  • For debugging, temporarily disable ForwardProbeCeiling or RequireForwardSupport to isolate environment-specific terrain layouts.
  • Server operators: enforcement behavior unchanged — caps only bind when ServerEnforceSettings = true.
  • Ensure you delete your StepUpAdvancedConfig.json so it generates a new one with the new values to prevent any issues.
Thanks for the reports & test worlds — they directly shaped the ceiling-guard improvements in this release.
1.2.0
1.21.0-rc.1 - 1.21.0-rc.4
216 Aug 12th at 11:20 PM StepUpAdvanced_v1.2.0.zip 1-click install
  • Added: Speed-only mode
    SpeedOnlyMode config to let other mods (e.g., XSkills) own step height while this mod only adjusts speed. Height hotkeys are disabled and height is not applied when enabled (requires relog or a config reload if allowed).
  • Added: Ceiling guard & forward probe
    Prevents “micro-bumping” into low ceilings or floating roofs ahead of you. Options: CeilingGuardEnabled, ForwardProbeCeiling, ForwardProbeDistance, RequireForwardSupport.

  • Added: Localization
    Translations for multi-language support. All are AI generated, please, you are welcome to submit your own lang file, I will gladly replace the AI generated Lang files.
  • Changed: Colorization and Formatting
    • Text has been reformatted and colorized for better readability
  • Changed: Clamping rules (client-side floor, server caps only when enforced)

    • Height hotkeys are clamped to a client floor (no negatives) and only capped at server max when ServerEnforceSettings = true.

    • Speed hotkeys have a client floor and respect server max only when enforced.

  • Changed: Apply performance

    • Caches reflection (StepHeight / elevateFactor fields).

    • Skips writes if value didn’t change.

    • Reuses a scratch BlockPos to cut allocations.

  • Fixed: Step speed doing “nothing”
    Now affects the actual elevate factor every tick even when the backing field is private; warns once if the game build exposes no compatible field (Harmony path still works).

  • Removed/Deferred: Experimental step-down logic
    The “snappy step-down” prototype was removed (collision/cache constraints). Might revisit later if the engine exposes safer hooks.

Notes / Migration

  • To let another mod manage height (e.g., XSkills), set SpeedOnlyMode = true. You’ll need to relog (or use the Reload hotkey if AllowClientConfigReload = true) for a reliable switch.

  • Server owners: set ServerEnforceSettings = true to push height/speed clamps to clients; otherwise clients use their local floors and are only limited on the low end. 

 

Delete your VintagestoryData/ModConfig/StepUpAdvancedConfig.json and then load into the game world to generate a new config with the new additional features.

Once a new config is generated and you have restarted the game with the intitial settings you want everything should work fine.

1.1.1
1.20.0 - 1.20.3 1.20.5 - 1.20.7 1.20.8 - 1.20.10 1.20.11 - 1.20.12
337 Aug 25th at 1:17 PM StepUpAdvanced_v1.1.1.zip 1-click install

StepUp Advanced — v1.1.1

Ceiling-guard tune-up, smarter probes and better performance.
Fixes Movement Logic

Highlights

  • Ceiling Guard refined: fewer false positives under overhangs; maintains smooth climbing when space truly allows.
  • Forward Probe options: add span & headroom padding controls for fine-grained tuning.
  • Performance polish: less reflection churn, fewer redundant writes, lightweight caching.
New & Added
  • Config: ForwardProbeSpan (width across the facing) and CeilingHeadroomPad (safety margin) for ceiling checks.
  • Default Config: Can be found in the mod description or on the discord page.
Changed
  • Ceiling logic: forward probe respects support rules more narrowly; headroom clamping favors real traversable gaps.
  • Clamping path: client floors still apply (height ≥ 0.2; speed ≥ 0.6), but server caps only bind when enforcement is ON.
  • Command outputs: unified success/warn/error styling; clearer values and reasons (e.g., min/max, enforcement blocks).
  • Internals: cached field lookups, skip-same-value writes, and a small scratch position to reduce allocations.
Fixed
  • Cases where players snapped upward under flat overhangs despite adequate headroom.
  • Edge scenarios where legitimate climbs were blocked when a nearby ceiling was present.
  • Minor chat spam/duplication on repeated enforcement notifications.

New / Tuned Config Keys

  • ForwardProbeSpan — horizontal sweep width (blocks) when checking forward ceiling.
  • CeilingHeadroomPad — extra headroom margin (0.00–0.25 suggested) to avoid grazing ceilings.
  • ForwardProbeCeiling, RequireForwardSupport — still available; behavior refined for fewer false positives. (Disabled by default)

Notes & Tuning Tips

  • If you encounter conservative clamping under complex overhangs, try: increase CeilingHeadroomPad slightly (e.g., 0.05 → 0.10) or set ForwardProbeSpan to 0–1.
  • For debugging, temporarily disable ForwardProbeCeiling or RequireForwardSupport to isolate environment-specific terrain layouts.
  • Server operators: enforcement behavior unchanged — caps only bind when ServerEnforceSettings = true.
  • Ensure you delete your StepUpAdvancedConfig.json so it generates a new one with the new values to prevent any issues.
Thanks for the reports & test worlds — they directly shaped the ceiling-guard improvements in this release.
1.1.0
1.20.0 - 1.20.3 1.20.5 - 1.20.7 1.20.8 - 1.20.10 1.20.11 - 1.20.12
1140 Aug 12th at 11:16 PM StepUpAdvanced_v1.1.0.zip 1-click install

Fixed: Ceiling guard & forward probe not properly detecting ledges. 

 

NOTE: Delete your VintagestoryData/ModConfig/StepUpAdvancedConfig.json and then load into the game world to generate a new config with the new additional features.

Once a new config is generated and you have restarted the game with the intitial settings you want everything should work fine.

1.0.9
1.20.0 - 1.20.3 1.20.5 - 1.20.7 1.20.8 - 1.20.10 1.20.11 - 1.20.12
104 Aug 12th at 3:45 PM StepUpAdvanced_v1.0.9.zip 1-click install
  • Added: Speed-only mode
    SpeedOnlyMode config to let other mods (e.g., XSkills) own step height while this mod only adjusts speed. Height hotkeys are disabled and height is not applied when enabled (requires relog or a config reload if allowed).
  • Added: Ceiling guard & forward probe (Bugged, still not working properly - looking into it!)
    Prevents “micro-bumping” into low ceilings or floating roofs ahead of you. Options: CeilingGuardEnabled, ForwardProbeCeiling, ForwardProbeDistance, RequireForwardSupport.

  • Added: Localization
    Translations for multi-language support. All are AI generated, please, you are welcome to submit your own lang file, I will gladly replace the AI generated Lang files.
  • Changed: Colorization and Formatting
    • Text has been reformatted and colorized for better readability
  • Changed: Clamping rules (client-side floor, server caps only when enforced)

    • Height hotkeys are clamped to a client floor (no negatives) and only capped at server max when ServerEnforceSettings = true.

    • Speed hotkeys have a client floor and respect server max only when enforced.

  • Changed: Apply performance

    • Caches reflection (StepHeight / elevateFactor fields).

    • Skips writes if value didn’t change.

    • Reuses a scratch BlockPos to cut allocations.

  • Fixed: Step speed doing “nothing”
    Now affects the actual elevate factor every tick even when the backing field is private; warns once if the game build exposes no compatible field (Harmony path still works).

  • Removed/Deferred: Experimental step-down logic
    The “snappy step-down” prototype was removed (collision/cache constraints). Might revisit later if the engine exposes safer hooks.

Notes / Migration

  • To let another mod manage height (e.g., XSkills), set SpeedOnlyMode = true. You’ll need to relog (or use the Reload hotkey if AllowClientConfigReload = true) for a reliable switch.

  • Server owners: set ServerEnforceSettings = true to push height/speed clamps to clients; otherwise clients use their local floors and are only limited on the low end. 

1.0.8
1.21.0-rc.1 - 1.21.0-rc.2
283 Jul 28th at 9:38 AM StepUpAdvanced_v1.0.8.zip 1-click install

Recompiled for VS 1.21.0-rc.1

1.0.7
1.20.0 - 1.20.3 1.20.5 - 1.20.7 1.20.8 - 1.20.10 1.20.11 - 1.20.12
792 May 18th at 1:26 PM StepUpAdvanced_v1.0.7.zip 1-click install

Fixes

  • Client + Server Block Blacklist Support

    • Server owners can now use /sua add, /sua remove, and .sua list to manage server block blacklists.

    • Players can use .sua add, .sua remove, and .sua list to manage block blacklists.
  • Merged Blacklist Logic

    • Server blacklist is enforced globally.

    • Client blacklist acts as a local extension — both are applied during gameplay.

Technical & Stability Improvements

  • Config file watcher with automatic sync to clients when modified on server.

  • Safe debounced config saving to prevent crashes and race conditions.

Feedback

Please, report any bugs/crashes/problems or feature requests/ideas on the VS discord

 

Download

You can download here from the github repository if the ModDB download is not working: StepUpAdvanced_v1.0.7.zip
1.0.6 170 May 18th at 6:00 AM StepUpAdvanced_v1.0.6.zip 1-click install

Bug Fixes

  • When disabling StepUp, the default behaviour of being able to step up slabs wasn't possible.
  • In Singleplayer instances, most functions would not work properly if ServerEnforceSettings was false.
  • Multiplayer config would no sync with the client properly or update properly, sometimes causing CTDs.
  • Server clamping was forced in Singleplayer instances.

 

Notes

Server owners need to ensure that `AllowClientConfigReload` is equal to `false` in your config to prevent players from changing values beyond clamp limits.
In Singleplayer, clamping is no longer present and is now only enforced in multiplayer instances.

Feedback

Please, report any bugs/crashes/problems or feature requests/ideas on the VS discord

 

1.0.5 416 May 15th at 6:28 AM StepUpAdvanced_v1.0.5.zip 1-click install

The long awaited request:

New Features

 

  • Server-defined clamp ranges for Step Height and Step Speed:

    • ServerMinStepHeight, ServerMaxStepHeight

    • ServerMinStepSpeed, ServerMaxStepSpeed

  • These values override client attempts to go outside the defined bounds.

  • Clients can still adjust within limits if AllowClientChangeStepHeight / StepSpeed is enabled.

Enforced

 

  • If ServerEnforceSettings is true, the server sends its full config to clients on join.

  • Clients then:

    • Respect server min/max limits

    • Are blocked from modifying values if not permitted

    • Receive chat feedback when a server restriction prevents action

 

Config Handling

 

  • Clamp values are internally validated:

    • All values are auto-corrected to fall within hardcoded absolute bounds (StepHeight: 0.2–2.0, StepSpeed: 0.5–2.0)

    • If ServerMin > ServerMax, the system corrects it automatically and logs a warning

 

 

1.0.4 5897 Feb 7th at 2:45 PM StepUpAdvanced_v1.0.4.zip 1-click install

New Features:

Block Blacklist Implementation:
- Introduced a configurable block blacklist that allows players to specify blocks near which the step-up functionality is disabled.
- The step height reverts to the default setting when the player is in proximity to any blacklisted blocks, enhancing control over movement mechanics.

Client-Side Commands for Blacklist Management:
- Added the .sua add command: Players can target a block in the game world and execute this command to add the block's type to the blacklist dynamically.
- Added the .sua remove command: Allows players to remove a block type from the blacklist by targeting the block and executing the command.

Real-Time Blacklist Detection:
- Improved the detection mechanism to account for diagonal movements and corner cases, ensuring that the step height adjusts appropriately when moving near blacklisted blocks from any direction.

Bug Fixes:
- Resolved an issue where the step height wouldn't adjust in real-time while the player was moving near blacklisted blocks.
The system now continuously checks the player's proximity to blacklisted blocks, allowing for immediate adjustments.

1.0.3 5778 Dec 26th 2024 at 4:06 AM StepUpAdvanced_v1.0.3.zip 1-click install

New Features (for *1.20.0+)

  • Step Speed Configuration:
    • Players can now adjust their step speed using the newly implemented StepSpeed configuration.
    • This allows fine-tuning how quickly your character steps up onto blocks for a more customizable gameplay experience.
    • Maximum Step Speed is 2.0,
      Minimum Step Speed is 0.5

Hotkey Improvements

  • Introduced hotkey functionality for increasing and decreasing step speed.
    • Arrow Up/Arrow Down: Adjust the step speed incrementally.


*This version still works for v1.19.8 but the added step speed functionality only works for v1.20.0+

- Removed debugging for release (sorry about that!)
1.0.2 207 Dec 24th 2024 at 1:20 AM StepUpAdvanced_v1.0.2.zip 1-click install

New Features

  • Dynamic Hotkey Support: Hotkeys are now dynamically mapped using api.Input.HotKeys, making the mod fully compatible with user-customized keybindings.

Quality of Life Improvements

  • Prevent Repeated Actions:
    • Holding down the "Toggle StepUp" or "Reload Config" keys no longer causes repeated actions. These actions are now executed only once per key press, thanks to new state-tracking logic.
  • Improved Feedback for Step Height Adjustments:
    • Duplicate messages when holding the increment or decrement hotkeys (e.g., "Step height cannot exceed 2.0 blocks") have been eliminated. Messages are now displayed only when explicitly attempting to go beyond the limit.

Configuration Validation

  • The mod now automatically adjusts invalid values in the configuration file:
    • StepHeight values above the maximum (2.0) are clamped to the maximum.
    • StepHeightIncrement values below the minimum (0.1) are clamped to the minimum.
    • New Behavior for DefaultHeight: If DefaultHeight is set above the maximum or below the minimum, it is reset to the original default value (0.6).
  • Any invalid values are logged to inform users of the adjustments and to ensure consistency.

Compatibility

  • The mod is now compatible with Vintage Story v1.19.8 and may also work with earlier versions (not officially tested for versions older than v1.19.8).
1.0.1 625 Dec 22nd 2024 at 6:48 AM StepUpAdvanced_v1.0.1.zip 1-click install

- Max step height is 2 blocks and cannot go above this limit.
- Removed server configuration/settings, wouldn't work properly.

This version is more server friendly, as the height limit is hardcoded and cannot go above 2 blocks.

1.0.0 136 Nov 30th 2024 at 12:37 AM StepUpAdvanced_v1.0.0.zip 1-click install

Initial Release

0.9.3 353 Dec 22nd 2024 at 9:48 PM StepUpAdvanced_v0.9.3.zip 1-click install

- 1.19 compatible version


56 Comments (oldest first | newest first)

💬 Elocrypt , 48 minutes ago (modified 48 minutes ago)

WickedSchnitzel
Added a new config setting for this, ensure that "ShowServerEnforcedNotice" is set to false. (It's true by default)
You may have to initially regenerate the config (delete config and it will generate a new one) for the setting to show up in the config.
Any future update from this one the config should automatically update. 

💬 Beedy, 6 days ago

KranKyKroK I believe the waiste-high or foot-high camera position is a vanilla problem. It happens to me a lot especially after sleeping. It it'll be like that for about a minute or half then snap up corrected by its own.

💬 Haltingpoint, Sep 24th at 12:14 AM

This mod seems to have a conflict with MoveLikeKaji (a climbing mod) that prevents this mod from working at all. Verified by disabling MoveLikeKaji. Is there a way to run both simultaneously so I can get the climbing functionality of MoveLikeKaji?

💬 WickedSchnitzel, Sep 16th at 8:04 PM

Could you add a setting to let us disable the chat info on join (server enforcement on). Some servers are using their own info on join which should not get pushed out of focus by mod infos.

💬 Ensorcelled, Sep 10th at 1:59 PM (modified Sep 10th at 2:27 PM)

/EDIT ok, it looks like it is trying to play some sound file for wood sound, likely was a wood block that got removed. Seems like it's this mod trying to predict sounds to play as you advance, even in fly+no clip mode. If I approach from stone side and click clear the blocks so this one is visible, I can click clear it, BUT if I fly at it from the room side, crashes every time, force to /tp in console, because client doesn't even load in before crash. Thankfully server sees you before you are "there". /edit

 

Howdy, getting client crash with this error any time I get near a null block 13243 from a removed mod. v 1.21.1 of VS and 1.2.1 of this mod.  I have NO black listed blocks, verified. Even did a .sua remove before approaching it in creative. Crashes survival OR creative with admin rights.

 

Crash Report
System.NullReferenceException: Object reference not set to an instance of an object.   at stepupadvanced.StepUpAdvancedModSystem.IsNearBlacklistedBlock(IClientPlayer player) in C:\Users\Elocr\source\VintageStoryMods\v121\stepupadvanced\stepupadvanced\stepupadvancedModSystem.cs:line 694   at stepupadvanced.StepUpAdvancedModSystem.ApplyStepHeightToPlayer() in C:\Users\Elocr\source\VintageStoryMods\v121\stepupadvanced\stepupadvanced\stepupadvancedModSystem.cs:line 751   at Vintagestory.Common.GameTickListener.OnTriggered(Int64 ellapsedMilliseconds) in VintagestoryLib\Common\Model\GameTickListener.cs:line 25   at Vintagestory.Common.EventManager.TriggerGameTick(Int64 ellapsedMilliseconds, IWorldAccessor world) in VintagestoryLib\Common\EventManager.cs:line 102   at Vintagestory.Client.NoObf.ClientMain.MainRenderLoop(Single dt) in VintagestoryLib\Client\ClientMain.cs:line 836   at Vintagestory.Client.GuiScreenRunningGame.RenderToPrimary(Single dt) in VintagestoryLib\Client\MainMenu\Screens\GuiScreenRunningGame.cs:line 172   at Vintagestory.Client.ScreenManager.Render(Single dt) in VintagestoryLib\Client\ScreenManager.cs:line 719   at Vintagestory.Client.ScreenManager.OnNewFrame(Single dt) in VintagestoryLib\Client\ScreenManager.cs:line 663   at Vintagestory.Client.NoObf.ClientPlatformWindows.window_RenderFrame(FrameEventArgs e) in VintagestoryLib\Client\ClientPlatform\GameWindow.cs:line 113   at OpenTK.Windowing.Desktop.GameWindow.Run()   at Vintagestory.Client.ClientProgram.Start(ClientProgramArgs args, String[] rawArgs) in VintagestoryLib\Client\ClientProgram.cs:line 338   at Vintagestory.Client.ClientProgram.<>c__DisplayClass10_0.<.ctor>b__1() in VintagestoryLib\Client\ClientProgram.cs:line 133   at Vintagestory.ClientNative.CrashReporter.Start(ThreadStart start) in VintagestoryLib\Client\ClientPlatform\ClientNative\CrashReporter.cs:line 95

 

Does not happen with this mod removed. Expected it was something with regard to the block checking, but turned that off, no good still. 

💬 Haltingpoint, Sep 2nd at 11:50 PM

Am I missing something with how to use this? I seem to have to hold sprint to move up steps. Walking forward does not do it automatically. I have tried increasing step height over 2 and no change.

💬 ItsGromit, Aug 31st at 6:30 PM

Is there a way to make it so you only step up if you are moving forward? And if you are crouching the stepup is disabled? I would have thought the ForwardProbe settings would do that but I couldn't figure it out.

💬 Tasshroom33, Aug 26th at 4:27 AM

KranKyKroK 1.21.0 is working for me, I can't reproduce that issue either.
Thanks for the fast update Elocrypt.

💬 Elocrypt , Aug 26th at 12:30 AM

KranKyKroK

Are you using the latest version of StepUp Advanced? I cannot reproduce what you are experiencing. This mod doesn't do anything with the camera anyway, zoom on the other hand does.

💬 KranKyKroK, Aug 26th at 12:02 AM (modified Aug 31st at 11:23 PM)

started new wrold in 1.21 stable with this and zoom mod enabled. camera was set at waist height in first person. disabled this mod and problem went away. 

 

(Edit) disabled and re-enabled and works fine.

💬 Elocrypt , Aug 17th at 7:31 AM (modified Aug 17th at 7:33 AM)

TeeSee

Delete version 1.2.0 and/or version 1.8.0.

The error you are getting is from 1.2.0 or 1.8.0 if you are using either of those.. Those are for VS 1.21 only which is using NET8.

1.1.0 is the version you want to use, which is for VS 1.20 which is still on NET7.

 

I can confirm that 1.1.0 works pefrectly fine, I just downloaded a fresh copy and tested it to verify that it works with 1.20.12

If you don't delete 1.2.0 and try to download and use 1.1.0 its going to automatically try to use 1.2.0 because its technically a newer version, which is why you need to ensure you delete it.

💬 TeeSee, Aug 17th at 4:36 AM

Not working for me on 1.20.12

Both versions give this error

Crash Report
16.8.2025 21:33:05 [Error] [stepupadvanced] An exception was thrown when trying to load assembly:
16.8.2025 21:33:05 [Error] [stepupadvanced] Exception: Could not load file or assembly 'System.Runtime, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified.
at System.ModuleHandle.ResolveType(QCallModule module, Int32 typeToken, IntPtr* typeInstArgs, Int32 typeInstCount, IntPtr* methodInstArgs, Int32 methodInstCount, ObjectHandleOnStack type)
at System.ModuleHandle.ResolveTypeHandle(Int32 typeToken, RuntimeTypeHandle[] typeInstantiationContext, RuntimeTypeHandle[] methodInstantiationContext)
at System.Reflection.RuntimeModule.ResolveType(Int32 metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments)
at System.Reflection.CustomAttribute.FilterCustomAttributeRecord(MetadataToken caCtorToken, MetadataImport& scope, RuntimeModule decoratedModule, MetadataToken decoratedToken, RuntimeType attributeFilterType, Boolean mustBeInheritable, ListBuilder`1& derivedAttributes, RuntimeType& attributeType, IRuntimeMethodInfo& ctorWithParameters, Boolean& isVarArg)
at System.Reflection.CustomAttribute.AddCustomAttributes(ListBuilder`1& attributes, RuntimeModule decoratedModule, Int32 decoratedMetadataToken, RuntimeType attributeFilterType, Boolean mustBeInheritable, ListBuilder`1 derivedAttributes)
at System.Reflection.CustomAttribute.GetCustomAttributes(RuntimeModule decoratedModule, Int32 decoratedMetadataToken, Int32 pcaCount, RuntimeType attributeFilterType)
at System.Attribute.GetCustomAttributes(Assembly element, Type attributeType, Boolean inherit)
at System.Attribute.GetCustomAttribute(Assembly element, Type attributeType, Boolean inherit)
at System.Reflection.CustomAttributeExtensions.GetCustomAttribute[T](Assembly element)
at Vintagestory.Common.ModContainer.<>c__DisplayClass36_0.<LoadAssembly>b__1(Assembly ass) in VintagestoryLib\Common\API\ModContainer.cs:line 457
at System.Linq.Enumerable.WhereEnumerableIterator`1.ToList()
at Vintagestory.Common.ModContainer.LoadAssembly(ModCompilationContext compilationContext, ModAssemblyLoader loader) in VintagestoryLib\Common\API\ModContainer.cs:line 454
💬 Elocrypt , Aug 14th at 4:51 PM (modified Aug 14th at 4:53 PM)

Cliffrd

For version 1.1.0 in the StepUpAdvancedConfig.json set this to true "EnableHarmonyTweaks": true, when you load the game and adjust, reload your game once and it should change properly afterwards.
This should fix the issue you are having.

💬 Cliffrd, Aug 14th at 9:25 AM

1.1.0 feels much slower stepping up compared to 1.0.7, even though the speeds are the same. And now 1.0.7's download link doesn't work😒

💬 Elocrypt , Aug 14th at 12:01 AM

The_Revisionist
If you are loading into a Singleplayer world, that is intended as its singleplayer and there doesn't need to be any clamping.
If you are connecting to a server, the server should have "ServerEnforcedSettings": true then when you connect to that server ServerEnforcedSettings will automatically be applied with the clamping that was done in the configuration on the servers config.

💬 The_Revisionist, Aug 13th at 10:31 PM

Elocrypt Thanks, it works now. However, for some reason the ServerEnforceSettings variable resets to false in the config file every time I load into a world.

💬 Elocrypt , Aug 12th at 11:25 PM (modified Aug 12th at 11:51 PM)

The_Revisionist
Make sure that you delete the file in this directory (assuming you dont have a custom data folder) VintagestoryData\ModConfig\StepUpAdvancedConfig.json
Once that has been deleted, you can enter the game world and a new file will generate with defaults. You then should close the game and edit/save the file with your initial settings you want and then you can join the game again and everything should function as it should from there.

💬 The_Revisionist, Aug 12th at 10:33 PM

Elocrypt I deleted the old settings file but the new one doesn't seem to generate (I loaded a world but still nothing).

💬 Elocrypt , Aug 12th at 3:48 PM

Katilist
The latest version 1.0.9 supports XSkills Steeplechaser with step speed included. Ensure `SpeedOnlyMode = True` in the config.
You may have to delete your current stepupadvancedConfig.json for the new options to generate after the first load. Cheers!

💬 Tasshroom33, Jul 29th at 2:41 PM

Is it possible to bridge the gap between this and better fps camera to fix the snapping of the camera on step up and smooth it out?

💬 Tasshroom33, Jul 26th at 1:15 PM

Love this mod, it's hard to play without it now lol.

💬 ThePogdra, Jun 19th at 2:03 PM

Must-have mod if you ask me, but I was wondering if it'd be possible to add an option for a step *down feature. I seriously hate that if you miss a single step going down a staircase your character makes a hurt sound. Having a more compact staircase with blocks to hit your head on hurts less, but is just as bad for immersion and slows you down a slight bit. It's a minor inconvenience obviously so no sweat if it doesnt seem worth your time, I'm just curious.  

💬 Elocrypt , May 19th at 11:20 AM

I re-released v1.0.7 that fixed a bug preventing the block blacklist to work in singleplayer instances. 

If your block blacklist is not working, all you need to do is redownload v1.0.7 and replace it. 

💬 Elocrypt , May 15th at 6:39 PM

Katilist
I will look into trying to fix this, I do remember StepUp Advanced prevents XSkills stepheight changes.
I want to make this compatible with XSkills, and this is on my todo list. Thank you for reminding me!

💬 Katilist, May 15th at 2:35 PM

If I can use this on my server to increase the speed of stepping up (and only the speed), I might use it.

One of the most annoying aspects of VS is the blocky terrain, and stepping up in VS is so slow, losing forward momentum to go up one block.

However, I use Xskills that allows the step height to be altered, but not the speed. I'd like to continue to rely on Xskills, but simply have a faster upward movement.

The configs don't seem to be able to disable the alteration of step amount via keybind.

💬 Asil, May 15th at 12:35 PM

Been using this for a while and just had an idea for a branch mod: Tree Climbing. Nuts and fruits can be gained without destroying a whole tree, or you can escape some of the critters that want to eat you. One can also get a lay of the land or have access to your tree house early in the game. 

💬 Elocrypt , May 15th at 6:33 AM

WickedSchnitzel
PeterSanderson
There is now Server enforced clamping, thank you for the feature request! 

💬 Elocrypt , Apr 29th at 8:59 PM

Poggalogg
I believe stepping up a block consumes stamina/satiety at the same rate walking/running does (depending if you are walking vs running when stepping up the block).
This doesn't count as a jump, so you wouldn't be consuming stamina/satiety as if it were a jump.

💬 Poggalogg, Apr 24th at 4:39 AM

Does stepping up a block consume the same amount of stamina/satiety as jumping up the same block?

💬 PeterSanderson, Apr 5th at 5:29 PM

Elocrypt I second that request. Also, a player accidentally reduced his step height to 0.2 and cannot climb stairs.

Disabling the mod does not revert settings to vanilla and player is stuck at that block height setting until StepUp is enabled and the setting reverted.

But even if you correct the setting in StepUp, the moment it is disabled, zap - back down to 0.2 step height.

Had to remove until this can be resolved. Removal did revert settings back.

So any suggestions on how to restrict control of settings to server side only?

 

💬 WickedSchnitzel, Apr 5th at 3:59 PM

Could you add an option to disable both step speed and height modification seperately. So that only the values an admin is defining in the config will apply and cannot be altered by the player.

💬 Beedy, Mar 14th at 11:59 AM

Elocrypt I haven't notice

💬 Elocrypt , Mar 8th at 7:50 AM

Beedy
I have not noticed any performance differences, do you have performance differences between versions?

💬 Beedy, Mar 6th at 1:31 AM

Since there is constant check for blacklisted blocks, does that affect performance notably compared to this feature being disabled? Thanks.

💬 Elocrypt , Feb 16th at 8:20 AM

WickedSchnitzel
The commands are working. The only commands there are are '.sua add' to add the block you are holding to the block blacklist and '.sua remove' to remove the block you are holding from the block blacklist. The '.sua' command alone will only list the 'add' and 'remove' commands.

💬 WickedSchnitzel, Feb 15th at 9:19 PM

the .step command is still included but does not work

💬 Mokradin, Feb 7th at 3:40 PM

Elocrypt This is great, thank you !

edit: It works very fine, thank you so much !

💬 Elocrypt , Feb 7th at 2:47 PM

Mokradin
I liked this feature idea, this has now been added in the latest release. I also added the `.sua add` and `.sua remove` commands to add/remove the block you are holding to/from the block blacklist.

💬 Xuhybrid, Feb 6th at 5:05 AM

If setting 2 or higher step height it should ask for server permission. Otherwise it should fall back on the client side code I don't see any issue with being able to step up 1 block and any server admins having an issue need to get a life. Thanks for posting the mod.

💬 Mokradin, Feb 5th at 2:18 PM

Could you add a block blacklist config to this mod ? I like this mod, but i want to blacklist some blocks like chests, table.

💬 Elocrypt , Jan 20th at 9:04 PM

Cuttlebear
I intentionally made it so that the server must have the mod in order for it to work on servers, so that it wouldn't act as a cheat (being able to climb up 2 blocks and increasing step speed may be contreversal for some servers). 

Technically, there is a method to bypass the requirement for it to be on a server for it to work on a server. 

Initially, I was going to release this as client sided but I wasn't sure how the community would respond. 

Here is a poll for this matter on my mod page in the Vintage Story discord: https://discord.com/channels/302152934249070593/1331031307379146814/1331050125631426664

💬 Cuttlebear, Jan 20th at 3:53 PM

Do I need to do anything specific to get this to work on my mp server? It works just fine in my SP game, but copying the mod over to my mp mod folder (along with all the other mods that work) makes this mod seem to not load. . .

💬 Elocrypt , Jan 18th at 9:50 AM

TheKhopesh
I am not sure why it would not be working for you. I've installed a fresh v1.20.0 (stable) and this mod seems to be working without any issues for me. 
Do you have any errors or logs? 

If you are trying to use this mod on a server that doesn't have this mod installed, the mod will not work. This is intentional.

💬 TheKhopesh, Jan 17th at 9:52 PM

The mod isn't working for me now that the 1.20.0 official release is out.

💬 Leonix, Dec 28th 2024 at 6:47 PM

Elocrypt

Thank you! :)

💬 Elocrypt , Dec 27th 2024 at 11:43 PM

Leonix
Sorry about that, I forgot to disable debugging. I re-released the current version without debugging, just redownload it replace the old one. 

💬 Leonix, Dec 27th 2024 at 9:02 PM

For some reason, your mod keeps creating harmony.log.txt on my Desktop... :D How do I get rid of that? :D

💬 Elocrypt , Dec 26th 2024 at 2:07 PM

SaltyWater
Which hotkey? If you hold down the hotkeys for incrementing the step height and speed they do change incrementaly based on the set increment value. 
The hotkeys for toggling stepup on/off and reloading the config aren't holdable.

Gabitzu
Thank you for requesting a feature!

💬 Gabitzu, Dec 26th 2024 at 8:42 AM

Thank you for the step up speed config!

💬 SaltyWater, Dec 26th 2024 at 6:11 AM

Amazing mod! Could you add a configuration option to make the key holdable instead of toggleable?

💬 Elocrypt , Dec 26th 2024 at 4:09 AM

Gabitzu
I have added the ability to configure your step up speed in the newest version, although this feature only works for v1.20.0 and up. 

💬 DanaCraluminum, Dec 24th 2024 at 8:50 AM

Add version to zip name, please

💬 Gabitzu, Dec 24th 2024 at 6:35 AM

Could the step up speed be configurable? Thanks

💬 Elocrypt , Dec 24th 2024 at 1:23 AM

SteAStro88
There is now a new version that is compatible with current and older versions! It also fixes some stuff, all changes are in the changelog.
StepUp Advanced v1.0.2

💬 Elocrypt , Dec 22nd 2024 at 9:49 PM

SteAStro88
I released a version that is compatible with v1.19.8, enjoy! StepUp Advanced for v1.19.8

💬 SteAStro88, Dec 22nd 2024 at 3:29 PM

Is this mod compatible with 1.19.8?

 (edit comment delete)
Основной веб-сайт | Почтовый сервер | FTP сервер | Административная панель | API интерфейс | Content Delivery Network | Статические файлы | Ресурсы сайта | Изображения | Файловое хранилище | Блог | Интернет-магазин | Техническая поддержка | Справочная система | Документация | Форум | Новости | Загрузки | Демонстрация | Тестовая среда | Приложение | Медиа контент | Разработка | Промежуточная среда | Бета версия | Безопасная зона | Вход в систему | Панель управления | Портал | Система управления контентом