Pet Mod

Cosmetic Pet Mod for Casualties Unknown

Welcome to the Cosmetic Pet Mod, a companion experience for Casualties Unknown with smooth physics-based following, advanced multiplayer synchronization, and full audio support!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🚀 KEY FEATURES & MECHANICS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. 🦘 Physics-Based Follow Behavior

[]Horizontal Lag: Trails behind you at a configurable follow distance with smooth exponential interpolation — no rigid snapping.[/]

[]Auto-Flipping: Detects your facing direction (or movement delta) with a 150ms hysteresis lock to prevent rapid flutter, always looking the correct way.[/]

[]Teleport Protection: Two-tier guard — soft reset above 8 units, hard snap above 18 units — stops the pet from warping across the screen during fast movement.

2. 🌍 Auto-Leveling Ground System

[]Multi-Raycast Sampling: Three rays span the pet's left, center, and right edges to bridge 1-tile gaps and step smoothly over terrain.[/]

[]One-Way Platform Filtering: Ignores pass-through platforms unless the player is standing on or very close to them.[/]

[]Spring-Damper Suspension: Mathf. SmoothDamp ground interpolation with a small threshold gate (0. 35u) to suppress flat-ground micro-jitter while still gliding over stairs.[/]

[]Item Ignore: The pet sees through all dropped/physical world items — no snapping onto boxes or bags.

3. 🪟 Smart Ceiling Squishing

[]Lookahead Pre-Pass: Ceiling scanning starts before the pet enters an overhang, triggered from a stable origin point above the player.[/]

[]Accurate Clearance: Measured from the pet's actual bottom edge, not the player origin.[/]

[]Asymmetric Interpolation: Compresses 2. 5× faster than it expands for a satisfying jelly squish feel.[/]

[]Minimum Squish Cap: Pet can compress down to 0. 15× its height to squeeze through very tight gaps.[/]

[]Ceiling-Aware Wall Rays: Horizontal wall collision checks are clamped below detected ceilings so the pet can slide sideways without corner-snagging.

4. 💃 Walking Wiggle & Squash-and-Stretch

[]Tilt Wiggle: Mathf. Sin-driven left/right rotation when walking.[/]

[]Squash & Stretch: Vertical compression and horizontal expansion synchronized to stride rhythm.

5. 🛸 Simple Mode (Noclip)

Toggle Simple Mode to bypass all collision checks entirely. The pet smoothly hovers and bobs alongside you, gliding freely through any geometry. Walk wiggles remain active. Useful if you experience physics issues in unusual map geometry.

6. 🔊 Audio Pack Support (Up to 500%)

Drop WAV, OGG, or MP3 files into an audio pack folder and the pet will randomly play them on a configurable interval:[/]

[]500% Volume Cap: Volume goes up to 5. 0× using PlayOneShot to bypass Unity's standard 1. 0 clamp.[/]

[*]Configurable Intervals: Set minimum and maximum seconds between sounds independently.

7. 🛡️ 100% Invincibility

A pure cosmetic companion — no colliders, no health, completely immune to game physics, enemies, and player collision.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌐 MULTIPLAYER SYNCHRONIZATION

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

An industry-grade P2P and Steam Lobby sync architecture so everyone in your session sees (and hears!) your pet perfectly.

👥 Personalized Follow Dynamics

All movement parameters (Follow Speed, Follow Distance, Wiggle Speed, etc.) are client-authoritative and broadcast via Steam lobby member metadata. Each player's pet moves with their chosen settings, independently per-player.

🖼️ P-2-P Custom PNG Transfer

When you load a custom local skin that other players don't have, the mod automatically transfers it:

1. Remote clients detect a new SHA1 hash via lobby metadata.

2. They issue a reliable P2P request on Channel 1337.

3. You send the raw image bytes directly.

4. They cache it by hash in Pets/Cache/ for instant loading next session.

🎵 Multiplayer Audio Sync

When your pet plays a sound, a tiny 6-byte P2P packet (typ