🏷️ PEAK Tag

PEAK Tag transforms your PEAK run into an intense multiplayer game of tag with special powers, dynamic scoring, and strategic gameplay mechanics.
One player becomes IT — chase, warp, ragdoll, and survive with new systems designed to keep the game fast, fair, and brutally fun.

Any bugs, feedback, or hype can be launched directly into the PEAK modding discord
Find it in #mod-releases under the same name!

---

🆕 What's New in v1.1.0

✨ Player Powers System

• Hidden Powers: IT players receive special powers based on configurable chances
• Power Activation: Powers activate when IT crouches + reaches simultaneously
• Three Power Types:
  • 🥊 Player Stun Power: Global ragdoll effect for all non-IT players
  • 🌍 Player Warp Power: Warp non-IT players to the lowest Y positioned NON-IT player as a group (Getting to the fire quickly isnt always safe)
  • 📦 Player Item Drop Power: Drop all items from non-IT players (keeps backpacks equipped)
• Audio Cues: "Poof" sound and Smoke appears when power is ready (heard by everyone in range)
• Mystery System: Neither host nor IT knows what power they have until it's used

🚀 Performance Optimizations

• Eliminated Log Spam: Scoreboard rendering is now silent
• Removed Reflection: Direct Harmony patches with publicized assembly
• Optimized Loops: Cached array access and reduced dictionary lookups
• Streamlined Code: Eliminated redundant null checks and redundant operations

🛡️ Enhanced Affliction System

• Host Protection: Host is completely immune to all afflictions via Harmony patches
• Client Management: Afflictions are cleared from clients every second

---

🔧 Core Features

🎯 Tag System

• Initial IT Selection: Configurable delay before choosing the first IT player
• Tag Detection: IT can tag others by looking at them up close while reaching
• Instant Role Swap: On tag, roles swap immediately with grace period protection
• Scoreboard Tracking: Persistent tracking of tags made vs. tags received per player

🪂 Warp & Punish Mechanics

• Distance Monitoring: If a player falls behind the IT player by configurable distance, they are warped forward
• Smart Positioning: Warps place players near each other with slight randomization

💀 Ragdoll & Visual Effects

• Initial IT Ragdoll: Initial IT is ragdolled for configurable duration
• Tag Ragdolls: Tags also ragdoll IT for configurable duration
• Eye Management: Only IT shows the distinctive "swirl" eyes, automatically managed

🔥 Campfire Rules

• Safe Zones: IT cannot tag near unlit campfires (15m radius)
• Fire Consequences: When a fire lights, IT is ragdolled and placed on cooldown
• Cooldown System: Configurable window where IT cannot tag after a fire lights

🎁 Gift Systems

Global Gifts (Everyone)

• Random Items: Players receive random helpful items every configurable interval
• Item Pool: Anti-rope spools, balloons, bounce shrooms, chain launchers, pitons, coconuts, magic beans, rope cannons, scout cannons, shelf shrooms
• Smart Distribution: Items go to pockets first, then backpacks if available

Boost Gifts (IT Only)

• Infinite Stamina: Lollipops (ID 44) provide extended stamina boosts (Force Fed)
• Sprint & Climb: Energy drinks (ID 27) enhance movement abilities (Force Fed)
• Chain Feeding: Multiple items force fed in sequence for maximum effect
• Configurable Timing: Adjustable intervals and multipliers for boost duration

🚫 Game Modifications

• Scoutmaster Block: Scoutmaster is disabled during Tag runs (host-only)
• Luggage Control: All luggage is pre-opened and empty (no loot spawning)(On biome changes they wont appear open)
• Backpack Seeding: Ensures all players get backpacks to carry their loot
• Zero Carry Weight: Host patches all item weights to 0 for fairness

---

⚙️ Configuration Options

Player Powers

Key	Default	Description
PlayerStunPowerChance	0.05 (5%)	Chance for Player Stun power (global ragdoll)
PlayerStunPowerTime	5.0	Duration in seconds for Player Stun power ragdoll effect
PlayerWarpPowerChance	0.05 (5%)	Chance for Player Warp power (warp non-IT to lowest Y)
PlayerItemDropChance	0.05 (5%)	Chance for Player Item Drop power (drop all items)

Campfires

Key	Default	Description
ItCooldownSeconds	60	Seconds IT cannot tag after a campfire lights
ItRagdollSecondsOnLight	5	How long IT ragdolls when a campfire lights

IT Rules

Key	Default	Description
InitialItDelaySeconds	20	Seconds to wait before picking the initial IT
InitialRagdollSeconds	10	Ragdoll time for the initial IT (also grayscale duration)
WarpCheckInterval	5	How often (seconds) to check IT distance
WarpDistanceMeters	80	Distance threshold before warp triggers

Gifts

Key	Default	Description
IntervalSeconds	120	Seconds between random global gifts
ExcludeRescueHook	true	Exclude Rescue Hook from gift pool

Boost Gifts (IT Only)

Key	Default	Description
IntervalSeconds	90	Seconds between boost gift rolls for current IT
InfiniteStaminaTimeMultiplier	3	Base ~13s × this value for lollipop duration
BoostSprintAndClimbMultiplier	3	Base ~13s × this value for energy drink duration

Scoreboard

Key	Default	Description
Key	S	Key to toggle scoreboard visibility
ModifierKey	LeftAlt	Modifier key for scoreboard (default: Alt+S)
RequireModifier	true	Require modifier key to toggle scoreboard
ShowOnStart	false	Show scoreboard when the game starts
BackgroundColor	Black (80% alpha)	Background color of the scoreboard
TextColor	White	Text color of the scoreboard
HeaderColor	White	Header color of the scoreboard
FontSize	16	Font size of the scoreboard text
Width	350	Width of the scoreboard
Height	250	Height of the scoreboard
X	10	X position of the scoreboard
Y	10	Y position of the scoreboard

---

📦 Installation

1. Download via Thunderstore manually
2. Extract the .dll file to: /PEAK/BepInEx/plugins/
3. Run the game to generate a config file

🔥 Recommended: Use Thunderstore Mod Manager for easy installation and updates! 🔥

---

🎮 How to Play

Basic Rules

1. Wait for Initial IT: After starting a run, wait for the configurable delay
2. IT Selection: A random player becomes IT and gets ragdolled
3. Tagging: IT must look at players and be close enough to them while reaching to tag them
4. Role Swap: Tagged player becomes new IT with grace period protection
5. Avoid Campfires: IT cannot tag near unlit campfires (safe zones)

Power System

1. Power Gifts: IT players receive random powers based on configurable chances
2. Power Activation: Crouch + reach simultaneously to use your power
3. Audio Cue: Listen for the "poof" sound and witness smoke that indicates power is ready
4. Strategic Use: Powers can turn the tide of the game in your favor

Scoring

• Tags Made: How many players you've successfully tagged
• Tags Received: How many times you've been tagged
• Net Score: Tags made minus tags received
• Persistent: Stats carry over to the airport until you start a new run

---

👨‍💼 Author

Made by tony4twenty
Check out my other PEAK mods

---

📝 Version History

v1.1.0 (Current)

• ✨ Added Player Powers System with 3 power types
• 🚀 Major performance optimizations and code cleanup
• 🛡️ Enhanced host affliction protection
• 🎯 Improved scoreboard system with persistent stats
• 🔧 Better Harmony patch implementation
• 🎁 Added Boost Gifts system for IT players
• 🪂 Improved warp mechanics and distance monitoring
• 🧊 Enhanced affliction management system
• 🤬 Curse system removed

v1.1.0

• 🏷️ Core tag system implementation
• 🔥 Campfire safety mechanics
• 🎁 Basic gift system
• 🚫 Scoutmaster blocking