Flesh is fallible, but ritual honours the Machine Spirit.
- The Warnings of the Cult Mechanicus

Skitarius is a mod that allows you to execute custom sequences of actions, with a multitude of additional features.
It is recommended you read (or at least skim) this description page to ensure you understand how the mod works before using it.

This mod is also available on GitHub.

Features:
Allows for setting custom melee sequences up to twelve steps in length

• Sequences can be applied globally (to all melee weapons), or uniquely per-weapon
• Up to eight unique keybinds can be set (four toggled, four held), each with their own sequence settings
• In addition to standard keybinds, the primary attack input can also be overridden with a sequence (acting as a ninth, held keybind)
• An optional and resizeable HUD element can be displayed to indicate when keybinds are active
• Sequences can be given custom cycle (loop) points, with extra options to modify the behavior of certain attacks
  

Allows for setting custom automatic fire modes for ranged weapons

• Can automatically fire normal attacks, charged attacks, or special actions (including charged/heavy specials)
• Same keybind/per-weapon customization options available as for melee weapons
• Automatic fire can be restricted to only affect weapons when aiming or hipfiring
• Weapon rate of fire is customizeable, with aimed and hipfire rates defined separately
• Custom charge levels can be set for charged attacks
• Optional global toggle which will auto-release charged attacks regardless of any other settings
  

Melee Settings:
Weapon Selection: The weapon which the current settings will be applied for. Select "GLOBAL" to apply to all weapons.
Keybind Selection: The keybind which will trigger the current settings.
Heavy Buff Modifier: If selected, this buff will be used for the "Heavy Buff Stacks" setting.
Heavy Buff Stacks: Heavy attacks will wait for this number of buff stacks before releasing. This setting is ignored if set to 0, or if the current weapon lacks the selected buff.
Special Required for Heavy Modifier: If enabled, heavy attacks will only check for buff stacks if the weapon's special action is active.
Always Activate Special Actions: If enabled, weapons will always trigger special actions in sequences, regardless of weapon state.
Force Heavies When Special Active: If enabled, the current weapon sequence will be overridden with heavy attacks while the weapon's special state is active.

Cycle Point: When the sequence completes, the step specified by this setting will be used as the starting point for the next iteration of the sequence.

JUMP TO CURRENT/GLOBAL: When clicked, the mod will select the currently equipped melee weapon. If this weapon is already selected, it will instead select GLOBAL.
Reset Melee Weapon: When clicked, ALL settings for the currently selected weapon across all keybinds will be reset to defaults.
Reset All Melee Settings: When clicked, ALL melee settings will be reset to defaults, across all weapons and keybinds.

Ranged Settings:
Always Auto-Release Charges: When enabled, the mod will automatically fire at max charge regardless of any other settings. All other Ranged Settings are weapon and keybind specific.
Always Auto-Release Charge Threshold %: This is the threshold that will be used by the Always Auto-Release Charges setting. When Always Auto-Release Charges is enabled, this is effectively the maximum charge any ranged weapon can be charged to, as it will override other threshold settings.

Weapon Selection: The weapon which the current settings will be applied for. Select "GLOBAL" to apply to all weapons.
Keybind Selection: The keybind which will trigger the current settings.
Automatic Fire: The selected option will be triggered in rapid succession when the selected keybind is triggered.
Automatic Fire Options:
Standard: Fires the weapon normally.
Charged: Charges the weapon, releasing at maximum charge or the specified charge threshold.
Special: Triggers the weapon's special action.
Special (Charged): Triggers the weapon's "charged" special action, such as Helbore/Staff heavy attacks.
Special + Standard: Fires normally if the weapon's special is activated, and activates the weapon's special if it is inactive.
Charge Threshold %: A selection between 0-100; when charge levels reach the specified percentage, they will be released. This setting only applies to charged attacks made with the Automatic Fire setting, and do not impact the behavior of the Always Auto-Release Charges setting.
ADS/Hipfire Filter: When set to "ADS Only", the selected Automatic Fire will only trigger while aiming. When set to "Hipfire Only", it will only trigger when not aiming. By default, this is set to "ADS and Hipfire", which will always trigger the selected Automatic Fire when the keybind is triggered.
ADS Attack Delay (ms): Delay in milliseconds applied between each shot while aiming.
Hipfire Attack Delay (ms): Delay in milliseconds applied between each shot when not aiming.

JUMP TO CURRENT/GLOBAL: When clicked, the mod will select the currently equipped ranged weapon. If this weapon is already selected, it will instead select GLOBAL.
Reset Ranged Weapon: When clicked, ALL settings for the currently selected weapon across all keybinds will be reset to defaults.
Reset All Ranged Settings: When clicked, ALL ranged settings will be reset to defaults, across all weapons and keybinds.

NOTE:
Weapons which are already automatic by default do not play nice with the Rate of Fire settings. There is a minimum window set by the game for how quickly the gun can attempt to manually shoot, and it cannot be overridden. If inputs are within this window, it fires at full firerate, regardless of input timings. If inputs are outside of this window, an extra delay is forced upon the weapon.
This means that Rate of Fire settings will not apply at all to these weapons until they are set low enough to push the weapon outside of its "minimum window", at which point the rate of fire drops drastically. There is unfortunately no way to achieve a rate of fire in between these two extremes for natively automatic weapons. This mechanic also applies to the charged attacks of Force Staffs.

Quick-Start Guide:
This mod was originally created to merge the functionality of UngaBunga, KeepSwinging,and FullAuto. Although it now offers much more, below are steps to easily replicate those mods for users interested in replacing them.

UngaBunga:
In Melee Settings, set the desired weapon's Step One setting to "Heavy Attack".
To match UngaBunga's default input settings, set the desired weapon's Keybind Selection to "Override Primary Attack Input". This will trigger heavies when you hold your normal attack input (e.g. left mouse button).
If you would like to block-cancel or special-cancel, set Step Two to either "Block" or "Special Action".
Skitarius has the same options as UngaBunga to allow charging Heavy attacks dependent on Thrust/Slow-And-Steady/Crunch stacks, with an additional toggle to only apply these modifications when the weapon's Special Action is active.

NOTE:
This mod may cause input conflicts when used with UngaBunga, and may not function properly as a result. It is recommended you disable UngaBunga while this mod is in use.

KeepSwinging:
In Melee Settings, set the desired weapon's Sequence Step One to "Light Attack". Similar to setting up the mod to mimic UngaBunga, you can use a dedicated keybind to trigger these light attacks, or use the "Override Primary Attack Input" Keybind Selection to trigger them with your normal attack input.

FullAuto:
In Ranged Settings, set the desired weapon's Automatic Fire to "Standard" for automatic fire.
Similar to FullAuto, ranged weapons can also be made to fire charged attacks (if applicable) with the "Charge" option, or Special Actions with the "Special" option.
If a ranged weapon is incapable of charged attacks, setting Automatic Fire to "Charged" will do nothing.

Sequencing Information:
Sequences will be reset if the player is knocked out of their own combo by enemies (e.g. during stuns), and inputs will be delayed if the player is in a state which cannot execute the next step of the sequence (e.g. sprinting while attempting to perform an action that cannot be performed while sprinting). Sequences also do not know (or care) about the specifics of weapon combos, which is intentional to maintain their flexibility. This means that an input of "Light Attack" may produce the Light 1, Light 2, or Light 3 for a given weapon, depending on when the input is initiated - but the mod only is interested in knowing that a "Light Attack" was requested and should be performed. Using the Cycle Point setting can help to guide weapon-specific combos.

Additionally, be aware that sequence steps are already at their "most simple" state. If you want to trigger a push-attack, you should select the "Push Attack" step option, rather than attempting to "build" it from other steps. For example, selecting "Push" followed by "Light Attack" will make the mod perform each of these actions individually, rather than combining them into a push-attack.

When building sequences, keep in mind that not all weapons are capable of following all possible sequences. The mod will dutifully attempt to  execute any sequence you provide it with, but it may have improper results if the weapon itself cannot handle the sequence.

For example:
The Grenadier Gauntlet will not be able to properly execute sequences containing the "Block" action, because the Grenadier Gauntlet cannot block.

If you're unsure what a weapon allows, test it in the Psykhanium. If, after testing, you think the weapon should be capable of executing a particular sequence that the mod is refusing to perform, make a post about it and I can investigate.

Chinese localization provided by jcyl2023 and SyuanTsai.