PEAK Ticks 🕷️

Version 1.0.0 — Customize how ticks attach, grow, and affect players across a run.

Allows must "near ground" vegetation to have a chance to attach ticks. Scans runs after each segment jump (lighting campfires to unlock next biome) to find vegetation so it will cause FPS drops for a few seconds. Only 1 tick will attach at a time unless you encounter a tick bomb so be careful so pick them off as soon as you get them!

Everyone in the lobby should install this mod so tick rules stay consistent. The host’s config is synced to clients in multiplayer via PEAKLib host handshake + PhotonCustomPropsUtils room properties. If the host does not have the mod, clients disable PEAK Ticks gameplay for that lobby (prevents tick exploits when rules do not match).

Works with Toss a Tick (optional): when both mods are installed and authorized, thrown ticks follow the same attach limits, bodyparts, growth, and status rules as everything else.

• 🗣️ Find the mod in the Peak Modding Discord under #mod-releases to discuss mod related topics like issues/reports/appreciation

---

🛠️ Features

Attach

• 🎯 Attach ticks to random eligible bodyparts (configurable list; one tick per bodypart)
• 🔢 Support multiple ticks per player (vanilla is 1; configurable up to 18)
• 🌿 Vegetation attach — walking through whitelisted plants in Shore, Tropics, Roots, Alpine, and Mesa can attach ticks
• 💣 Tick bomb — rare bursts that attach several ticks at once
• 🧹 Retires vanilla map TickTrigger spawns when the mod is active (uses mod attach logic instead)

Growth

• ⏱️ Configurable time to reach full size (vanilla: 300 seconds)
• 📏 Configurable max scale, or uncapped growth for ever-growing ticks

Poison / Injury

• ☠️ Configurable pulse interval, flat poison per pulse, and per-tick poison cap
• 📈 Size-based poison — stronger pulses as ticks grow
• 🩸 Injury mode — apply Injury instead of Poison while keeping the same pulse tuning
• ♾️ Optional uncapped status per tick

Removal

• 👇 Look down at ground to pick ticks off! Easier than raycasting onto the tick!

Multiplayer

• 🤝 Host must have PEAK Ticks (PEAKLib plugin GUID handshake)
• 🔄 Host config syncs to joining clients
• 🚫 Clients cannot use mod tick gameplay when the host lacks the mod

---

⚙️ Config Options

You can change these in the mod's config file at:
BepInEx/config/tony4twentys.PEAK_Ticks.cfg

Attach

Setting	Default	Description
MaxTicksPerPlayer	18	Maximum ticks on one player at once. Vanilla is 1.
AttachBodyparts	(see below)	Comma-separated bodyparts eligible for random attach. Each bodypart holds at most one tick.

Default AttachBodyparts:
Knee_R,Knee_L,Hip_R,Hip_L,Hip,Torso,Shoulder_R,Shoulder_L,Elbow_R,Elbow_L,Arm_L,Arm_R,Foot_R,Foot_L,Neck,Head,Hand_R,Hand_L

Vegetation

Setting	Default	Description
EnableVegetationAttach	true	Whitelisted plants can attach ticks in supported biomes
AttachChance	0.01	Chance (0–1) a vegetation touch triggers an attach burst
EnableTickBomb	true	Rare tick bomb bursts on successful attach rolls
TickBombChance	0.01	Chance (0–1) of a tick bomb per successful burst
TickBombMinTicks	2	Minimum ticks attached during a tick bomb
TickBombMaxTicks	18	Maximum ticks attached during a tick bomb
TouchCooldownSeconds	60	Cooldown before the same player can trigger another burst
TagTouchDistance	0.1	Max distance (m) from detector to tagged foliage for attach

Poison

Setting	Default	Description
PoisonPulseIntervalSeconds	29	Seconds between status pulses. Vanilla is 29.
UseInjuryInsteadOfPoison	false	Apply Injury instead of Poison
PoisonPerPulse	0.05	Flat poison per pulse (ignored when SizeBasedPoison is true). Vanilla is 0.05.
SizeBasedPoison	false	Scale poison per pulse with tick size
StartingPoisonPerPulse	0.1	Base poison at tier 0 when size-based
PoisonScaleTierSize	0.5	Scale step per poison tier when size-based
MaxPoisonPerTick	0.5	Max poison one tick can apply over its lifetime. Vanilla is 0.5.
UncappedPoisonPerTick	false	Ignore max poison cap

Extras

Setting	Default	Description
GrowthDurationSeconds	300	Seconds to reach max scale. Vanilla is 300 (5 minutes).
MaxScale	1	Target scale at full growth. Vanilla is 1.
UncappedGrowth	false	Ticks keep growing; MaxScale is ignored

---

📦 Installation

1. Download via Thunderstore
2. Place the .dll file in: /PEAK/BepInEx/plugins/
3. Launch game to generate config
   🕷️ or use a Mod Manager 🕷️

Recommended: add PEAK Ticks to shared mod profiles so everyone runs the same tick rules.

---

📦 Dependencies

• BepInExPack_PEAK
• PEAKLib Core
• PhotonCustomPropsUtils

Optional companion: Toss a Tick — host-only throw-to-attach; uses PEAK Ticks rules when both are installed.

---

📣 Feedback

Suggestions, ideas, or issues?
Reach out via the PEAK Modding Discord

---

👨‍🍳 Credits

Author tony4twenty
My Other Mods tony4twenty

---

🕷️ Configure the crawl. Survive the swarm.