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

1. Build the plugin (or use a prebuilt DLL if you have one).
2. Drop the plugin DLL into:
   • BepInEx/plugins/
3. Run the game once to generate the config file.
4. 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 scorpion is held.

This multiplier adjusts the entire sting sequence while held:

• the moment the attack animation starts
• the windup duration
• and when damage is applied

1 keeps vanilla held behavior.

AttackStartDistance (float, default: -1)

Override Mob.attackStartDistance.

AttackDistance (float, default: -1)

Override Mob.attackDistance.

AttackAngle (float, default: -1)

Override Mob.attackAngle.

AttackCooldownSeconds (float, default: -1)

Override the internal attack cooldown.

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

[Attack] Damage & status

DamageType (enum, default: Vanilla)

Easy-to-type values (like the dynamite mod).
Recommended: keep Vanilla unless you intentionally want different status effects.

Allowed values:

• Vanilla (uses the game’s default)
• Injury, Hunger, Cold, Poison, Crab, Curse, Drowsy, Weight, Hot, Thorns, Spores, Web

DamageMultiplier (float, default: 1)

Global multiplier applied to both initial and over-time ticks.

EnableInitialDamageTick (bool, default: true)

If false, disables the single “instant” sting tick.

EnableOvertimeDamageTick (bool, default: true)

If false, disables the over-time tick.

InitialDamageMultiplier (float, default: 1)

Extra multiplier for the initial tick.

Total initial scaling = DamageMultiplier * InitialDamageMultiplier.

OvertimeDamageMultiplier (float, default: 1)

Extra multiplier for the over-time tick.

Total overtime scaling = DamageMultiplier * OvertimeDamageMultiplier.

Troubleshooting

“Nothing changes”

• Make sure you edited the correct config file in BepInEx/config/.
• Restart the game after editing the config.

Multiplayer feels inconsistent

• Ensure all players are using the same config.
• Remember: AI runs on the scorpion owner; damage is applied locally on the victim.

License / attribution

This project is a gameplay mod for PEAK. It patches runtime behavior via Harmony and does not redistribute game assets.