Ashlar checks / tooling (push) Successful in 5s
New [Game] mantling setting, on by default, with mantle max height (1.1 times the actor's height above its feet) and mantle duration (0.4 s). When the player jumps or falls into a wall while moving towards it (within 60 degrees), the movement solver casts the player's collision shape up, across the edge and down. If it finds a surface flat enough to stand on, above the feet and within reach, with headroom and room on top, the player moves up, across and onto it along that checked path. Movement and jump input are ignored meanwhile, and the climb ends any fall without fall damage. No animation is needed. A script move or teleport, noclip or paralysis cancels a climb. Lua: self.controls.mantle (true by default) vetoes climbs while false, and the actor's scripts get an AshlarMantle event with the ledge height when one starts. The engine logs "Ashlar mantle:" lines at verbose level. Player only; with the setting off nothing changes. The geometry rules (reach, headroom, room on top, slope, too high, too low) and the climb path are in mwphysics/mantle.cpp, apart from the physics calls, with unit tests. The new mantle scenario uses a CC0 box mesh written for it: the player climbs an 80 unit ledge, doesn't climb it with the Lua veto, and doesn't climb a 240 unit wall. Closes #28 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
730 lines
29 KiB
ReStructuredText
730 lines
29 KiB
ReStructuredText
Game Settings
|
|
#############
|
|
|
|
.. omw-setting::
|
|
:title: show owned
|
|
:type: int
|
|
:range: 0, 1, 2, 3
|
|
:default: 0
|
|
:location: :bdg-success:`Launcher > Settings > Interface`
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Mode
|
|
- Meaning
|
|
* - 0
|
|
- No clues are provided which is the default Morrowind behaviour.
|
|
* - 1
|
|
- The background of the tool tip for the object is highlighted in the colour specified by the colour background owned setting in the GUI Settings Section.
|
|
* - 2
|
|
- The crosshair is the colour of the colour crosshair owned setting in the GUI Settings section.
|
|
The crosshair is not visible if crosshair is false.
|
|
No clues are provided than the object is owned when a GUI window is open.
|
|
* - 3
|
|
- Both the tool tip background and the crosshair are coloured.
|
|
|
|
Enable visual clues for items owned by NPCs when the crosshair is on the object.
|
|
|
|
.. omw-setting::
|
|
:title: show projectile damage
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Interface`
|
|
|
|
If this setting is true, the damage bonus of arrows and bolts will show on their tooltip.
|
|
|
|
.. omw-setting::
|
|
:title: show melee info
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Interface`
|
|
|
|
If this setting is true, the reach and speed of weapons will show on their tooltip.
|
|
|
|
.. omw-setting::
|
|
:title: show enchant chance
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Interface`
|
|
|
|
Whether or not the chance of success will be displayed in the enchanting menu.
|
|
|
|
.. omw-setting::
|
|
:title: best attack
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-info:`In Game > Options > Prefs`
|
|
|
|
If this setting is true, the player character will always use the most powerful attack when striking with a weapon
|
|
(chop, slash or thrust). If this setting is false,
|
|
the type of attack is determined by the direction that the character is moving at the time the attack begins.
|
|
|
|
.. omw-setting::
|
|
:title: can loot during death animation
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If this setting is true, the player is allowed to loot actors (e.g. summoned creatures) during death animation,
|
|
if they are not in combat. In this case we have to increment death counter and run disposed actor's script instantly.
|
|
|
|
If this setting is false, player has to wait until end of death animation in all cases.
|
|
Makes using of summoned creatures exploit (looting summoned Dremoras and Golden Saints for expensive weapons) a lot harder.
|
|
Conflicts with mannequin mods, which use SkipAnim to prevent end of death animation.
|
|
|
|
.. omw-setting::
|
|
:title: difficulty
|
|
:type: int
|
|
:range: -500 to 500
|
|
:default: 0
|
|
:location: :bdg-info:`In Game > Options > Prefs`
|
|
|
|
This setting adjusts the difficulty of the game and is intended to be in the range -100 to 100 inclusive.
|
|
Given the default game setting for fDifficultyMult of 5.0,
|
|
a value of -100 results in the player taking 80% of the usual damage, doing 6 times the normal damage.
|
|
A value of 100 results in the player taking 6 times as much damage, while inflicting only 80% of the usual damage.
|
|
Values below -500 will result in the player receiving no damage,
|
|
and values above 500 will result in the player inflicting no damage.
|
|
|
|
.. omw-setting::
|
|
:title: actors processing range
|
|
:type: int
|
|
:range: 3584 to 7168
|
|
:default: 7168
|
|
:location: :bdg-info:`In Game > Options > Prefs`
|
|
|
|
This setting specifies the actor state update distance from the player in game units.
|
|
Actor state update includes AI, animations, and physics processing.
|
|
Actors close to this distance softly fade in and out instead of appearing or disappearing abruptly.
|
|
Keep in mind that actors running Travel AI packages are always active to avoid
|
|
issues in mods with long-range AiTravel packages (for example, patrols, caravans and travellers).
|
|
|
|
.. omw-setting::
|
|
:title: classic reflected absorb spells behavior
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If this setting is true, effects of Absorb spells which were reflected by the target are not mirrored,
|
|
and the caster will absorb their own stat resulting in no effect on either the caster and the target.
|
|
This makes the gameplay as a mage easier, but these spells become imbalanced.
|
|
This is how Morrowind behaves.
|
|
|
|
.. omw-setting::
|
|
:title: classic calm spells behavior
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If this setting is true, Calm spells will take their target out of combat every frame.
|
|
This means that a Calm spell of any magnitude will always take actors out of combat for the entirety of its duration.
|
|
This is how Morrowind behaves without the Morrowind Code Patch. If this setting is off,
|
|
Calm spells will only take their target out of combat once. Allowing them to re-engage if the spell was not sufficiently strong.
|
|
|
|
.. omw-setting::
|
|
:title: use magic item animations
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
If this setting is true, the engine will use casting animations for magic items, including scrolls.
|
|
Otherwise, there will be no casting animations, just as in original engine
|
|
|
|
.. omw-setting::
|
|
:title: show effect duration
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Interface`
|
|
|
|
Show the remaining duration of magic effects and lights if this setting is true.
|
|
The remaining duration is displayed in the tooltip by hovering over the magical effect.
|
|
|
|
.. omw-setting::
|
|
:title: enchanted weapons are magical
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Make enchanted weapons without Magical flag bypass normal weapons resistance (and weakness) certain creatures have.
|
|
This is how Morrowind behaves.
|
|
|
|
.. omw-setting::
|
|
:title: prevent merchant equipping
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Prevent merchants from equipping items that are sold to them.
|
|
|
|
.. omw-setting::
|
|
:title: followers attack on sight
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Make player followers and escorters start combat with enemies who have started combat with them or the player.
|
|
Otherwise they wait for the enemies or the player to do an attack first.
|
|
Please note this setting has not been extensively tested and could have side effects with certain quests.
|
|
|
|
.. omw-setting::
|
|
:title: shield sheathing
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
If this setting is true, OpenMW will utilize shield sheathing-compatible assets to display holstered shields.
|
|
|
|
To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
|
|
Also you can use additional _sh meshes for more precise shield placement.
|
|
Warning: this feature may conflict with mods that use pseudo-shields to emulate item in actor's hand (e.g. books, baskets, pick axes).
|
|
To avoid conflicts, you can use _sh mesh without "Bip01 Sheath" node for such "shields" meshes, or declare its bodypart as Clothing type, not as Armor.
|
|
Also you can use an _sh node with empty "Bip01 Sheath" node.
|
|
In this case the engine will use basic shield model, but will use transformations from the "Bip01 Sheath" node.
|
|
|
|
.. omw-setting::
|
|
:title: weapon sheathing
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
If this setting is true, OpenMW will utilize weapon sheathing-compatible assets to display holstered weapons.
|
|
|
|
To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
|
|
Additional _sh suffix models are not essential for weapon sheathing to work but will act as quivers or scabbards for the weapons they correspond to.
|
|
|
|
.. omw-setting::
|
|
:title: use additional anim sources
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
Allow the engine to load additional animation sources when enabled.
|
|
For example, if the main animation mesh has name Meshes/x.nif,
|
|
the engine will load all KF-files from Animations/x folder and its child folders.
|
|
This can be useful if you want to use several animation replacers without merging them.
|
|
Attention: animations from AnimKit have their own format and are not supposed to be directly loaded in-game!
|
|
|
|
.. omw-setting::
|
|
:title: barter disposition change is permanent
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If this setting is true,
|
|
disposition change of merchants caused by trading will be permanent and won't be discarded upon exiting dialogue with them.
|
|
This imitates the option that Morrowind Code Patch offers.
|
|
|
|
.. omw-setting::
|
|
:title: only appropriate ammunition bypasses resistance
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If this setting is true, you will have to use the appropriate ammunition to bypass normal weapon resistance (or weakness).
|
|
An enchanted bow with chitin arrows will no longer be enough for the purpose, while a steel longbow with glass arrows will still work.
|
|
This was previously the default engine behavior that diverged from Morrowind design.
|
|
|
|
.. omw-setting::
|
|
:title: strength influences hand to hand
|
|
:type: int
|
|
:range: 0, 1, 2
|
|
:default: 0
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
This setting controls the behavior of factoring of Strength attribute into hand-to-hand damage, which is using the formula
|
|
Morrowind Code Patch uses for its equivalent feature: damage is multiplied by its value divided by 40.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Mode
|
|
- Meaning
|
|
* - 0
|
|
- Strength attribute is ignored
|
|
* - 1
|
|
- Strength attribute is factored in damage from any actor
|
|
* - 2
|
|
- Strength attribute is factored in damage from any actor except werewolves
|
|
|
|
.. omw-setting::
|
|
:title: normalise race speed
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
By default race weight is factored into horizontal movement and magic projectile speed like in Morrowind.
|
|
For example, an NPC which has 1.2 race weight is faster than an NPC with the exact same stats and weight 1.0 by a factor of 120%.
|
|
If this setting is true, race weight is ignored in the calculations which allows for a movement behavior
|
|
equivalent to the one introduced by the equivalent Morrowind Code Patch feature.
|
|
This makes the movement speed behavior more fair between different races.
|
|
|
|
.. omw-setting::
|
|
:title: projectiles enchant multiplier
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.0
|
|
|
|
|
|
The value of this setting determines how many projectiles (thrown weapons, arrows and bolts) you can enchant at once according to the following formula:
|
|
|
|
.. math::
|
|
|
|
\text{count} = \frac{\text{soul gem charge} \cdot \text{projectiles enchant multiplier}}{\text{enchantment strength}}
|
|
|
|
A value of 0 means that you can only enchant one projectile.
|
|
If you want to have Morrowind Code Patch-like count of projectiles being enchanted at once, set this value to 0.25 (i.e. 25% of the charge).
|
|
|
|
.. omw-setting::
|
|
:title: uncapped damage fatigue
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
There are four ways to decrease an actor's Fatigue stat in Morrowind gameplay mechanics:
|
|
Drain, Absorb, Damage Fatigue magic effects and hand-to-hand combat.
|
|
However, in Morrowind you can't knock down an actor with a Damage Fatigue spell or an Absorb Fatigue spell.
|
|
Morrowind Code Patch adds an option to make it possible for Damage Fatigue spells. This is the equivalent of that option.
|
|
|
|
Setting the value of this setting to true will remove the 0 lower cap from the value,
|
|
allowing Damage Fatigue to reduce Fatigue to a value below zero.
|
|
|
|
.. omw-setting::
|
|
:title: turn to movement direction
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
Affects side and diagonal movement. Enabling this setting makes movement more realistic.
|
|
|
|
If disabled then the whole character's body is pointed to the direction of view. Diagonal movement has no special animation and causes sliding.
|
|
|
|
If enabled then the character turns lower body to the direction of movement. Upper body is turned partially. Head is always pointed to the direction of view. In combat mode it works only for diagonal movement. In non-combat mode it changes straight right and straight left movement as well. Also turns the whole body up or down when swimming according to the movement direction.
|
|
|
|
.. omw-setting::
|
|
:title: smooth movement
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
Makes NPCs and player movement more smooth.
|
|
|
|
Recommended to use with "turn to movement direction" enabled.
|
|
|
|
.. omw-setting::
|
|
:title: smooth movement player turning delay
|
|
:type: float32
|
|
:range: ≥ 0.01
|
|
:default: 0.333
|
|
|
|
Max delay of turning (in seconds) if player drastically changes direction on the run. Makes sense only if "smooth movement" is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: NPCs avoid collisions
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If enabled NPCs apply evasion maneuver to avoid collisions with others.
|
|
|
|
.. omw-setting::
|
|
:title: NPCs give way
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Standing NPCs give way to moving ones. Works only if 'NPCs avoid collisions' is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: swim upward correction
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Makes player swim a bit upward from the line of sight. Applies only in third person mode. Intended to make simpler swimming without diving.
|
|
|
|
.. omw-setting::
|
|
:title: swim upward coef
|
|
:type: float32
|
|
:range: -1.0 to 1.0
|
|
:default: 0.2
|
|
|
|
Regulates strength of the "swim upward correction" effect (if enabled).
|
|
Makes player swim a bit upward (or downward in case of negative value) from the line of sight. Recommended range of values is from 0.0 to 0.25.
|
|
|
|
.. omw-setting::
|
|
:title: trainers training skills based on base skill
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
The trainers in Morrowind choose their proposed training skills based on their 3 best attributes.
|
|
|
|
If disabled then the 3 best skills of trainers and the training limits take into account fortified/drained trainer skill.
|
|
|
|
If enabled then the 3 best skills of trainers and the training limits are based on the trainer base skills.
|
|
|
|
.. omw-setting::
|
|
:title: always allow stealing from knocked out actors
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
By Bethesda's design, in the latest released version of Morrowind pickpocketing is impossible during combat,
|
|
even if the fighting NPC is knocked out.
|
|
|
|
This setting allows the player to steal items from fighting NPCs that were knocked out if enabled.
|
|
|
|
.. omw-setting::
|
|
:title: graphic herbalism
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Some mods add harvestable container models. When this setting is enabled, activating a container using a harvestable model will visually harvest from it instead of opening the menu.
|
|
|
|
When this setting is turned off or when activating a regular container, the menu will open as usual.
|
|
|
|
.. omw-setting::
|
|
:title: allow actors to follow over water surface
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
If enabled actors will always find path over the water surface when following other actors. This makes OpenMW behaviour closer to the vanilla engine.
|
|
|
|
If disabled actors without the ability to swim will not follow other actors to the water.
|
|
|
|
.. note::
|
|
Has effect only when Navigator is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: default actor pathfind half extents
|
|
:type: float32|float32|float32
|
|
:range: > 0
|
|
:default: 29.27999496459961 28.479997634887695 66.5
|
|
|
|
Actor half extents used for exterior cells to generate navmesh.
|
|
Changing the value will invalidate navmesh disk cache.
|
|
|
|
.. omw-setting::
|
|
:title: day night switches
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Some mods add models which change visuals based on time of day. When this setting is enabled, supporting models will automatically make use of Day/night state.
|
|
|
|
.. omw-setting::
|
|
:title: actor collision shape type
|
|
:type: int
|
|
:range: 0, 1, 2
|
|
:default: 0 (Axis-aligned bounding box)
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Collision is used for both physics simulation and navigation mesh generation for pathfinding.
|
|
Cylinder gives the best consistency between available navigation paths and ability to move by them.
|
|
Changing this value affects navigation mesh generation therefore navigation mesh disk cache generated for one value
|
|
will not be useful with another.
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Mode
|
|
- Meaning
|
|
* - 0
|
|
- Axis-aligned bounding box
|
|
* - 1
|
|
- Rotating box
|
|
* - 2
|
|
- Cylinder
|
|
|
|
.. omw-setting::
|
|
:title: player movement ignores animation
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
In third person, the camera will sway along with the movement animations of the player.
|
|
Enabling this option disables this swaying by having the player character move independently of its animation.
|
|
|
|
.. omw-setting::
|
|
:title: smooth animation transitions
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Visuals > Animations`
|
|
|
|
Enabling this option uses smooth transitions between animations making them a lot less jarring. Also allows to load modded animation blending.
|
|
|
|
.. omw-setting::
|
|
:title: rebalance soul gem values
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
:location: :bdg-success:`Launcher > Settings > Gameplay`
|
|
|
|
Enabling this option drastically reduces the value of filled soul gems.
|
|
The value will depend on soul magnitude but not the size of the used
|
|
soul gem.
|
|
|
|
The new value formula is based on the Morrowind Code Patch project:
|
|
|
|
.. math::
|
|
|
|
\text{new value} = 0.0001 \cdot (\text{soul magnitude})^3 + 2 \cdot (\text{soul magnitude})
|
|
|
|
.. omw-setting::
|
|
:title: terrain obstructs focus
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: false
|
|
|
|
If enabled, focused object selection will account for terrain.
|
|
The default behavior matches Morrowind, allowing objects partially or totally submerged in terrain to gain focus.
|
|
|
|
.. omw-setting::
|
|
:title: real time combat
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled, melee and ranged attacks that physically connect always hit.
|
|
The classic hit chance instead scales their damage, between 25% and 100%,
|
|
so weapon skill, agility, luck, fatigue and the target's evasion still matter.
|
|
Disable for Morrowind's hit and miss rolls.
|
|
|
|
With this setting on, the player blocks actively: hold the Block control with the weapon drawn to raise the block
|
|
stance. In the stance the player can't attack and movement slows to the block stance speed setting. Every melee hit
|
|
inside the ``fCombatBlockLeftAngle`` to ``fCombatBlockRightAngle`` arc is blocked with no roll:
|
|
with a shield, completely, as before, with shield durability loss; without a shield, a drawn melee weapon parries the
|
|
hit, letting the weapon block damage share through and taking the rest as weapon wear.
|
|
Both cost fatigue and train Block, and the fatigue cost of a block falls with Block skill, to half at 100.
|
|
Without the stance the player doesn't block at all. NPCs and creatures follow the ai active blocking setting.
|
|
|
|
.. omw-setting::
|
|
:title: block stance speed
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.5
|
|
|
|
Ashlar setting. Movement speed multiplier while the player holds the block stance.
|
|
Only used when real time combat is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: weapon block damage
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.5
|
|
|
|
Ashlar setting. Share of melee damage that still gets through when the player blocks with a weapon instead of a
|
|
shield. 0 makes weapon blocks as good as shields. Only used when real time combat is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: ai active blocking
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled together with real time combat, NPCs and creatures block through the same stance and arc
|
|
rules as the player instead of the classic block roll. In combat, an actor with a shield ready and its weapon drawn
|
|
raises the stance when an enemy in front of it winds up a melee attack within reach, and lowers it about half a
|
|
second after the swing, or after two seconds at most, so that it can attack again.
|
|
It can't attack while blocking. Whether it reacts to a wind-up is rolled once per wind-up: 10% at 0 Block skill and
|
|
agility, rising with Block skill and a fifth of agility to at most 90%, and scaled by fatigue. The reaction delay
|
|
falls from 0.6 to 0.15 seconds over the same range.
|
|
Actors without a shield never block, and a creature blocks only if it can carry a shield.
|
|
Disable to give NPCs and creatures the classic block roll. Only used when real time combat is enabled.
|
|
|
|
.. omw-setting::
|
|
:title: attack fatigue threshold
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.1
|
|
|
|
Ashlar setting. Share of maximum fatigue below which an actor can't start a weapon attack, with real time combat on.
|
|
An actor at zero fatigue or below can never attack. The player gets a "too tired to attack" message once per press,
|
|
and NPCs and creatures wait for their fatigue to recover instead of trying to attack. Spells aren't affected.
|
|
|
|
With real time combat on, the fatigue cost of a weapon attack is paid when the swing is released rather than when it
|
|
lands, so a swing costs fatigue even if it is interrupted or misses. The cost is
|
|
``(fFatigueAttackBase + fFatigueAttackMult * normalized encumbrance) * (0.5 + 0.5 * strength)`` plus
|
|
``weapon weight * strength * fWeaponFatigueMult``, where strength is the wind-up from 0 to 1. A quick tap costs half
|
|
the base cost and nothing for the weapon; a full wind-up costs the same as a classic full-strength attack.
|
|
|
|
.. omw-setting::
|
|
:title: attack fatigue cap
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.5
|
|
|
|
Ashlar setting. Share of maximum fatigue below which an actor's strongest possible attack shrinks, with real time
|
|
combat on. The cap falls linearly from full strength at this share to a quarter strength at zero fatigue, so a tired
|
|
actor hits for less and its attacks cost less, instead of only losing accuracy. 0 disables the cap.
|
|
|
|
.. omw-setting::
|
|
:title: hit reactions
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled together with real time combat, melee hits cause short reactions that break up an
|
|
opponent's attack:
|
|
|
|
- A connecting hit makes the victim flinch. A wind-up in progress is interrupted, and no attack starts until the
|
|
flinch ends. The flinch lasts 0.2 to 0.7 seconds, growing with the damage up to a quarter of the victim's maximum
|
|
health, and is halved for an attack with no wind-up.
|
|
- A blocked hit or parry makes the blocker recoil for 0.1 to 0.25 seconds, depending on the attack strength.
|
|
- A blocked blow at three quarters strength or more staggers the attacker for 0.25 to 0.6 seconds.
|
|
|
|
The flinch starts when the hit's stagger is applied, so Lua's ``ignoreStagger`` attack field prevents it, as does god
|
|
mode. Hit animations still play when the loaded content has them; the timing works without them.
|
|
|
|
.. omw-setting::
|
|
:title: movement acceleration
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled, an actor's movement ramps up to speed when it starts moving and slows down when it stops,
|
|
instead of reaching full speed on the first frame and stopping dead. Changing direction blends through the ramp:
|
|
reversing slows down to a stop before speeding up the other way, and movement to the side of the new direction dies
|
|
away at the deceleration rate. Movement is ramped in the actor's own frame, so turning is never delayed, and turning
|
|
on the spot is unaffected. NPCs and creatures ramp up the same way but stop at once when their movement is released,
|
|
so they never overshoot a path point. If disabled, movement behaves as in OpenMW.
|
|
|
|
Lua scripts set the requested movement through ``self.controls``; the ramp then applies to it.
|
|
``types.Actor.getCurrentSpeed`` returns the speed after the ramp.
|
|
|
|
If smooth movement is also on, this ramp applies after it.
|
|
|
|
.. omw-setting::
|
|
:title: movement acceleration time
|
|
:type: float32
|
|
:range: >= 0
|
|
:default: 0.15
|
|
|
|
Ashlar setting. Seconds it takes to go from standing to full speed with movement acceleration on. 0 is instant.
|
|
|
|
.. omw-setting::
|
|
:title: movement deceleration time
|
|
:type: float32
|
|
:range: >= 0
|
|
:default: 0.1
|
|
|
|
Ashlar setting. Seconds it takes the player to go from full speed to standing with movement acceleration on. 0 is
|
|
instant. NPCs and creatures always stop at once.
|
|
|
|
.. omw-setting::
|
|
:title: movement air control
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.3
|
|
|
|
Ashlar setting. How quickly movement can change while jumping or falling, as a share of the rate on the ground. At
|
|
0.3, reaching full speed in the air takes 0.5 seconds with the default acceleration time. 0 keeps movement from
|
|
changing until the actor lands.
|
|
|
|
.. omw-setting::
|
|
:title: sprint
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled, holding the Sprint control (Left Alt or D-pad up by default; ``self.controls.sprint`` in
|
|
Lua) while moving forward makes an NPC, in practice the player, move at sprint speed multiplier times its run speed.
|
|
A sprint counts as running for animations, Athletics training and the running fatigue cost, and drains sprint
|
|
fatigue drain on top. It needs sprint fatigue threshold of fatigue to start and ends when fatigue runs out (below
|
|
1% of maximum).
|
|
|
|
A sprint isn't possible while sneaking, in the block stance, swimming or levitating, or when knocked down or
|
|
paralyzed. Pressing Use with a weapon or spell ready ends the sprint until Sprint is released, so no attack or spell
|
|
starts while sprinting. AI doesn't sprint, and creatures can't. If disabled, the Sprint control does nothing.
|
|
|
|
.. omw-setting::
|
|
:title: sprint speed multiplier
|
|
:type: float32
|
|
:range: >= 1
|
|
:default: 1.4
|
|
|
|
Ashlar setting. Sprint speed as a multiple of run speed.
|
|
|
|
.. omw-setting::
|
|
:title: sprint fatigue drain
|
|
:type: float32
|
|
:range: >= 0
|
|
:default: 10
|
|
|
|
Ashlar setting. Fatigue per second that sprinting at full speed costs on top of the running cost. It falls with
|
|
Athletics, to half at 100.
|
|
|
|
.. omw-setting::
|
|
:title: sprint fatigue threshold
|
|
:type: float32
|
|
:range: [0, 1]
|
|
:default: 0.1
|
|
|
|
Ashlar setting. Share of maximum fatigue an actor needs to start a sprint. Once started, a sprint carries on until
|
|
fatigue falls below 1% of maximum.
|
|
|
|
.. omw-setting::
|
|
:title: mantling
|
|
:type: boolean
|
|
:range: true, false
|
|
:default: true
|
|
|
|
Ashlar setting. If enabled, the player climbs onto a ledge when jumping or falling into it while moving towards it,
|
|
instead of sliding down the wall. The ledge has to be flat enough to stand on, no higher than mantle max height
|
|
above the feet, with room on top and nothing above the player in the way; the engine checks this with the player's
|
|
collision shape. The climb takes mantle duration seconds, ignores movement and jump input, and ends any fall without
|
|
fall damage. It needs no animation.
|
|
|
|
Lua scripts can stop climbs by setting ``self.controls.mantle = false``, and get an ``AshlarMantle`` event when one
|
|
starts. NPCs and creatures don't climb. If disabled, behaviour is unchanged from OpenMW.
|
|
|
|
.. omw-setting::
|
|
:title: mantle max height
|
|
:type: float32
|
|
:range: [0, 3]
|
|
:default: 1.1
|
|
|
|
Ashlar setting. Highest ledge the player can climb, as a multiple of their height, measured from the feet at the
|
|
moment they touch the wall.
|
|
|
|
.. omw-setting::
|
|
:title: mantle duration
|
|
:type: float32
|
|
:range: [0.05, 5]
|
|
:default: 0.4
|
|
|
|
Ashlar setting. Seconds a climb onto a ledge takes.
|