Choose your pace on foot, on Roach and in the water, in The Witcher 3 Remastered.
Download on Nexus Mods · GitHub Releases · Every feature and setting · Changelog · Report a problem
Controlled Movement (CM) lets you pick the pace for the moment: an extra-slow walk for tight interiors, normal walking and running, a faster exploration pace, a gentle trot on Roach or a quieter swim. Hold Walk/Run and scroll to step the pace up or down, or tap Walk/Run to jump to one of two favorites.
- Three independent profiles: Player (Geralt and Ciri on foot), Roach and Swimming, each with its own settings and presets, sharing one set of remappable controls.
- Native animations. Player pace runs through the game's own movement calculation and animation graph, so turns, stops and sprint look as they do in vanilla.
- Steps or True Steps. A ladder of 3 to 10 editable steps, or fine numeric steps with your own increment, minimum and maximum.
- Fluid Movement for Player and Roach: smooth speed changes, starts and optional stop resets, with Linear, Smooth, Build-up, Surge and (Roach) Charge curves.
- Fluid Controls for Player: optionally enter the game's real sprint state above a pace you choose.
- Smooth swim starts (1.4.1). The push-off from a standstill follows your Swimming value, or a fixed Swim start speed of your choice.
- Presets: Player Default and K, Roach Default and K, Swimming Default. All editable after applying.
Native rules stay in charge: restrictions, collisions, stamina, sprint rules, scenes, combat and fast swimming all behave as in vanilla. CM never changes the game clock, forces velocity or teleports.
The full description of every setting, input row and limitation is in docs/features.md.
- The Witcher 3: Wild Hunt Remastered, patch 5.01 (build 5.0.0.1048522), PC.
- Keyboard and mouse. Gamepad movement is not controlled.
- Sharedutils Remastered with its menu-descriptor module, for the settings' hover help (CM's adapter is built against its 3.1.1 interface).
- Recommended: a Remastered-aware mod manager such as Relapse's Mod Manager Redux (Remastered 2.2 or newer). Manual install works too.
Download modControlledMovement-<version>.zip from the Nexus Mods page or from Releases.
With a mod manager: close the game, back up your CM folders and settings if you have an older version, install the ZIP and enable both modules, modControlledMovement and modControlledMovement_Menu. Keep your existing bindings when asked. Then check the four CM commands under Options > Key Bindings; the no-modifier pair starts unassigned on purpose.
Manual install
Close the game and extract the ZIP. Back up any configuration file before you edit it.
- Mod folders: copy both folders from the ZIP's
ModsintoThe Witcher 3\Mods. - Settings menu: copy
bin\config\r4game\user_config_matrix\pc\modControlledMovement.xmlto the same folder in your game. - Key bindings menu: add the four
Varlines from the ZIP'sbin\config\r4game\user_config_matrix\pc\input.xmlto thePCInputgroup'sVisibleVarsin the game's owninput.xmlat that path. The ZIP's file is a fragment; keep the rest of the game's file. - Controls: merge
Mods\modControlledMovement\input.settings.part.txtintoDocuments\The Witcher 3\input.settings(use the real Documents folder if it is redirected). It has 26 rows in six sections:Exploration,Exploration_Replacer_Ciri,Horse,Horse_Replacer_Ciri,SwimmingandDiving. Add the rows to the existing sections instead of duplicating them, keep the repeatedIK_MouseZandIK_Nonerows (they are separate actions), and keep your own remaps and cleared bindings.
Updating and removing
Updating: close the game and replace both complete CM folders and modControlledMovement.xml together. Your saved settings stay; installing never applies a preset. From 1.4.0 to 1.4.1 nothing else changes. From a version before 1.4.0, see the update notes in docs/features.md.
Going back: each release's rollback-notes.md says which earlier ZIP to use. Remove both current CM folders before installing the older ones.
Removing: remove both CM folders and modControlledMovement.xml, the four CM Var lines in input.xml, and CM's four action rows in each of the six input.settings sections. Keep everything else.
With Require modifier key on (the default):
| Input | Action |
|---|---|
| Hold Walk/Run (Left Ctrl) + scroll up | Increase pace |
| Hold Walk/Run + scroll down | Decrease pace |
| Quick single tap of Walk/Run | Favorite 1 |
| Quick double tap of Walk/Run | Favorite 2 |
The same commands work on foot, on Roach and in the water. Rebind them under Options > Key Bindings; turning the modifier off switches to the separate, unassigned "No-Modifier" pair. Settings are under Mods > Controlled Movement.
- Behavior graph overrides. CM replaces
horse_draft_exploration.w2beh(Roach) andpc_swimming.w2beh(Swimming). Another mod that replaces either file conflicts, and Script Merger cannot merge them. There is no Player graph override. - Script hooks. CM replaces
CR4Player.CanSprintandCR4LocomotionPlayerControllerScript.CalculateMoveSpeed, and wrapsW3HorseComponentStateExploration.UpdateLogic. Movement mods that replace the same methods need an explicit merge. - Alternate Horse Controls: works alongside CM with CM's Enable Roach control off.
- Values are requests, not measured speeds. Player: walk 0.60, run 1.00, sprint 1.50. Roach: 0.40 to 8.00, with 4.00 the vanilla top speed. Swimming: 0.60 to 2.00 animation playback, with 1.00 vanilla.
- Not tested yet: Ciri, controllers, Steam Deck and Linux. Reports are welcome.
- Known issue: the menu cursor can occasionally stay attached to a slider as you leave the menu and move its value. If your pace changes unexpectedly, reopen the menu and check your values.
Each version has a GitHub Release with the mod ZIP, SHA256SUMS, test-notes.md (how it was tested and what was not) and rollback-notes.md (going back to the previous version).
To check a download in PowerShell, in the folder with the ZIP:
Get-FileHash .\modControlledMovement-1.4.1.zip -Algorithm SHA256The result must equal that file's line in SHA256SUMS.
What is where
| Path | What |
|---|---|
mod/ |
The mod exactly as it ships: the install tree inside each release ZIP |
mod/Mods/modControlledMovement/content/scripts/local/controlledMovement/ |
CM's twelve WitcherScript modules |
mod/Mods/modControlledMovement_Menu/ |
The hover-help adapter for Sharedutils, with its compiled precompiled.rsblob |
mod/bin/config/r4game/user_config_matrix/pc/ |
The settings menu and the four key binding declarations |
docs/features.md |
Every feature, setting, input row and limitation |
releases/<version>/ |
The notes published with each GitHub Release |
The behavior graph bundles, menu, string tables and presets are generated by tools in the private working repository, which also holds the game files they are built from. This repository carries their output exactly as shipped.
Branches
mainholds published releases only, one tagged commit per version (v1.4.0,v1.4.1, ...).developis where changes to this repository land; a release is a merge ofdevelopintomain.
Report bugs on the Nexus Mods page's Bugs tab, or open an issue here. Please include your CM version, which profile (Player, Roach or Swimming), your preset or edited values, your bindings and modifier setting, other movement, horse, swimming, input or menu mods you use, and the steps that show the problem.
For a detailed log, launch the game with -debugscripts, run CM_PlayerTrace(1) or CM_SwimTrace(true) in the console, and attach the CM lines from Documents\The Witcher 3\scriptslog.txt.
Made by Kyle with the help of AI tools (ChatGPT and Claude). Kyle directed the work and tests every release in game.
Special thanks to voidsmith, author of Natural Motion (Keys and Scroll Wheel Speed Control). Studying Natural Motion helped find the right movement functions, and voidsmith gave explicit permission to use the mod in developing Controlled Movement. Natural Motion is a credited reference, not a dependency. Please visit voidsmith's page and support that work.
Thanks to Aeltoth and the Sharedutils contributors for the hover-description tools.
Parts of CM's scripts are adapted from the game's own scripts, which remain the work of CD PROJEKT S.A.
Licence: Creative Commons Attribution-NonCommercial 4.0 (CC BY-NC 4.0), full text in LICENSE. Anyone may copy, change and share Controlled Movement, including inside their own free mods, as long as they credit Kyle and do not sell it or use it commercially. The licence covers CM's own work, not the game material it adapts.
This is an unofficial fan work and is not approved or endorsed by CD PROJEKT RED.