tony4twenty-PEAK_Tag icon

PEAK Tag

Play A Powerful Game of Tag with your friends!

Last updated a week ago
Total downloads 999
Total rating 3 
Categories Mods Host Only
Dependency string tony4twenty-PEAK_Tag-1.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK-5.4.2403 icon
BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.2403

README

🏷️ 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