ConfigurableScorpions

Configurable Scorpions (PEAK) — README

This mod lets you tweak scorpion AI + attack behavior via a BepInEx config file.

Vanilla-first design: every config entry defaults to the game's vanilla behavior.

If you never touch the config, the mod should behave like no mod is installed.

What this mod changes (when configured)

You can configure:

• Targeting / aggression
• Disable chasing players (no player target acquisition)
• Make scorpions aggressive only when held
• Change aggro range
• Toggle line-of-sight requirement
• Allow / block targeting players that are already poisoned

• Movement
• Movement speed
• Turn rate
• Sleep distance / wake radius (when scorpions go dormant / wake up)

• Attack shape + tempo
• Attack start distance / attack distance / attack angle
• Attack cooldown
• Sting windup time
• Special: HeldStingTimeMultiplier adjusts the entire held sting sequence (animation + damage timing)

• Damage / status
• Choose the damage/status type (with an easy “Vanilla” option)
• Enable/disable the initial tick and the over-time tick independently
• Separate multipliers for initial vs over-time tick (+ a global multiplier)

Installation

• Build the plugin (or use a prebuilt DLL if you have one).
• Drop the plugin DLL into:
• BepInEx/plugins/
• Run the game once to generate the config file.
• Edit the config file and restart the game.

Config file path is typically:

• BepInEx/config/com.github.GABRlEL.ConfigurableScorpions.cfg

Multiplayer: who needs the mod?

PEAK uses Photon ownership. Scorpion AI decisions run on the client that owns the scorpion (photonView.IsMine).

Also, scorpions are items: when someone picks up a scorpion, ownership is commonly transferred to the holder.

Damage/status is applied on the victim’s local client (character.IsLocal).

Practical rules of thumb:

• Targeting/movement/attack-start behavior is controlled by the scorpion owner.
• Damage type + damage amounts are applied by each client to themselves when they are stung.
• For consistent gameplay in co-op, it’s best if everyone uses the same config.

Vanilla fidelity notes (important)

This mod avoids re-implementing vanilla logic unless a setting forces it.

Targeting override

The mod calls the game’s original Mob.Targeting() when all of these are vanilla:

• AggroDistanceMultiplier = 1
• RequireLineOfSight = true
• TargetPoisonedPlayers = false
• and the other aggression toggles are at defaults

If only AggroDistanceMultiplier is changed, the mod temporarily scales aggroDistance, calls vanilla targeting, then restores it.

Only when you change LoS and/or Target poisoned does it run a custom targeting loop, because vanilla hardcodes those checks.

Configuration reference

[Targeting]

EnablePathfindingToPlayer (bool, default: true)

If false, scorpions won’t acquire a player target while on the ground (they will patrol instead).

OnlyAggressiveWhenHeld (bool, default: false)

If true, scorpions only target/attack while held as an item. On the ground they patrol.

AggroDistanceMultiplier (float, default: 1)

Multiplies the scorpion’s aggro distance.

• 1 = vanilla
• 0 = effectively disables range-based acquisition

RequireLineOfSight (bool, default: true)

If false, scorpions can target through terrain (skips the terrain line check).

TargetPoisonedPlayers (bool, default: false)

Vanilla behavior avoids targeting players already afflicted with poison-over-time.

Set to true to allow targeting poisoned players.

[Movement]

MovementSpeedMultiplier (float, default: 1)

Multiplies Mob.movementSpeed.

TurnRateMultiplier (float, default: 1)

Multiplies Mob.turnRate.

SleepDistanceMultiplier (float, default: 1)

Scales the distance check used for entering sleep.

WakeRadiusMultiplier (float, default: 1)

Scales the distance check used for waking up.

[Attack]

StingDelaySeconds (float, default: -1)

Override for the windup time until the sting happens.

• -1 = keep vanilla
• >= 0 = override

HeldStingTimeMultiplier (float, default: 1)

Applies only while the s