This package has been deprecated and may no longer be maintained. We recommend looking for an alternative.
TinySnail
A tiny snail crawls toward the nearest player. Touch = death. Killable. Steals valuables. Investigates gunshots. Scared of flashlights. Permanent slime trail. Hot-cold HUD. Procedural audio. Difficulty presets. Multiplayer-synced.Changelog
1.9.0
REPO modding best-practices pass.
- REPOConfig integration: every numeric config now declares a proper
AcceptableValueRange<float>/AcceptableValueRange<int>and every enum-like string declaresAcceptableValueList<string>. This makes the mod's config render as proper sliders and dropdowns in the in-game REPOConfig menu (used by 1600+ mods), AND gives BepInEx native bounds-validation instead of relying on post-hoc clamping. TheDifficulty.Presetfield becomes a dropdown listing the four presets + Custom;HUD.Positionbecomes a dropdown of the five anchor strings. - F6 hot-reload support:
Plugin.OnDestroynow properly tears everything down —Harmony.UnpatchSelf(), despawns all managers (network, HUD, reproduction, snails), clears decals, invalidates shared materials, and clears the noise registry. You can now drop the DLL intoBepInEx/scripts/instead ofplugins/for iterative dev and hit F6 to reload without restarting REPO. - All
SafeXaccessor clamping is preserved as a belt-and-suspenders safety net even with the new validators.
1.8.2
Bright glowing slime.
- All slime visuals (permanent floor decals, the live trail behind the snail, slime drip particles, and the death burst) now use an emissive
Standardshader. REPO's bloom post-process turns the emission into actual glow — slime trails light up dark corridors and read at a glance across the map. - Bigger decals: scale factor doubled (decals are now
clamp(scale × 10, 0.18, 1.6)instead ofclamp(scale × 6, 0.10, 1.0)). - Brighter, more saturated slime palette: hot-white-yellow core fading through saturated lime to a deeper green halo. The blob texture upgraded from 64×64 to 128×128 with a two-stop alpha (core + halo) for that glow look.
- Trail behind the snail lasts longer (10s, was 6s) and is thicker at the head (0.45u, was 0.30u) so the fresh glow segment lingers.
- New
[Visual] SlimeGlowIntensityconfig (default1.0, clamp[0, 8]) — multiplier on the emissive intensity. Set 0 for non-glowing matte slime; crank to 4+ for "this map has been sprayed." - All slime materials are shared (one decal material, one trail material, one particle material) so 600 decals still draw efficiently.
1.8.1
Bug sweep + singular framing.
- Fixed:
TinySnailSpawnercould NPE when the local player'splayerTransformwas null at spawn time (anchor was checked, transform wasn't). - Fixed:
SnailNetworkwould silently miss all Photon events ifPhotonNetwork.NetworkingClientwas null at plugin Awake time. Subscription now retries every frame until ready. - Fixed:
SnailReproductionManagercould spam hundreds of no-op doubling calls (and log lines) in one frame after a long pause. Hard ceiling of 12 doublings/level applied. - Fixed: HUD pulse-rate lerp
twas unclamped; could produce out-of-range pulse speeds in edge cases. - Cleaned: Removed a no-op
velocity = Vector3.zerowrite on the kinematic rigidbody of carried valuables. - Cleaned: Default-mode framing is now singular ("the snail") throughout configs, log messages, manifest description, and README — since by default there is one snail per level. The doubling mode is opt-in (
[Spawning] DoubleEachMinute = trueor presetInevitable/Snailpocalypse). - Manifest description shortened to 226 chars (Thunderstore limit is 256).
1.8.0
Optional asset bundle support.
- The plugin now loads a Unity asset bundle from
BepInEx/plugins/<TeamName-TinySnail>/assets/tinysnail.bundleif present, and uses the embeddedTinySnailprefab in place of the runtime-built primitive snail. If the bundle is missing or fails to load, the procedural snail is used — nothing breaks. - The bundle is opt-in: the package ships without one (the procedural snail is still the default). To build your own, see
unity/UNITY_SETUP.mdin the source repo (Unity Editor 2022.3 + Built-in Render Pipeline; anEditor/BuildBundle.cshelper is included). - No changes to existing config, behavior, audio, or networking — this is purely a visual upgrade path for modders who want to ship a sculpted snail.
1.7.0
Smart snails.
- Investigate noises. Gunshots (
ItemGun.Shoot) and player damage (PlayerHealth.Hurtwith damage ≥ 10) register as noise events. Snails within 60 units divert toward the noise for 4 seconds, abandoning their chase target if the noise is meaningfully closer. Slow, but listening. - Scared by flashlight. If a player's active flashlight is pointed within a 30° cone of a snail for >0.5 seconds at <15 units range, the snail retracts into its shell and freezes for 3 seconds. Stall tactic.
- Steal valuables. Snails crawl over loose valuables (PhysGrabObjects with mass < 4) and carry them on their backs. The valuable stays stuck until you grab it back, the snail dies, or the level ends.
- New
[Behavior] InvestigateNoises,ScaredByFlashlight,StealValuablestoggles, all defaulttrue. - New Harmony hooks:
ItemGun.Shoot,PlayerHealth.Hurt(postfix).
1.6.0
Difficulty + killable + audio.
- Difficulty presets. New
[Difficulty] Preset = Cute / Standard / Inevitable / Snailpocalypse / Custom. One knob overrides speed, rage, kill radius, count, and doubling. UseCustomto fall back to individual fields. - Killable snails. New
[Killable]section. Throwing a valuable hard enough (ImpactDamageThreshold3 m/s default) kills the snail. Crouching within the kill radius now stomps the snail instead of dying. Default snail HP = 1 (one-shot anything). - Death VFX. Slime particle burst on snail death.
- Procedural audio. Looping 3D slither sound on each snail (range 15u, configurable). 2D heartbeat thump that speeds up from 1.5s → 0.3s as the nearest snail closes. Squelch one-shot when a snail dies. All audio generated procedurally — no asset files ship in the DLL.
1.5.0
Multiplayer networking. Hardened.
- Snails are now synchronized across all clients. The master client owns the simulation and broadcasts snail positions to everyone else via Photon events (no PhotonView registration needed). All players see the same set of snails moving in the same places. Pose updates default to 15 Hz (configurable
[Networking] UpdateRateHz, range 1–30). - Authority model: master client simulates chase + kill detection. Clients are display-only and lerp received poses for smoothness. Kill is still routed through
PlayerHealth.Hurt, which uses the game's own networked damage RPC. - Singleplayer: unchanged. The network layer detects singleplayer and skips all broadcasts.
- Security pass: received Photon payloads are validated for length, finite floats, position bounds, and sane ID range. Ghost-snail count is capped at
2× SafeCountMaxon the receiving side to prevent flooding. All event handlers wrapped in try/catch. - Material leak fixed: new
MaterialCleanupMonoBehaviour explicitly destroys each per-instance material clone when a snail dies, preventing slow GPU memory growth. - Full audit doc: see
SECURITY_AUDIT.mdin the repo for the complete review.
1.4.1
DoubleEachMinuteis now OFF by default. The default experience is one snail per level. Doubling is opt-in for users who want escalating dread.
1.4.0
Big release.
- Doubling mechanic (opt-in): when
[Spawning] DoubleEachMinute = true, the snail population doubles every minute on the level clock (1→2→4→8→…), capped byCountMax(default 32). Off by default — the default experience is one tiny snail per level. Flip the toggle if you want escalating dread. - Permanent slime decals: snails leave sticky-looking slime quads on the floor wherever they crawl. Persists for the rest of the level. Global cap of 600 decals to keep performance sensible.
- Smart multi-target snails: each snail picks the nearest player to its own position as its target, and switches target if another player gets closer. They're slow, but they're smart.
- HUD heat meter: subtle on-screen proximity warning with a heat word (Ice cold → Cool → Tepid → Warm → Hot → Burning → SCORCHING) and a colored bar that fills as the nearest snail closes in. Rounded panel, cute snail icon, raw distance is hidden by default for atmosphere (toggle
HUD.ShowDistance). - Cuter snail visuals: bigger expressive eyes with catchlight glints, soft pastel body color, smile mouth, softer shell stripe palette.
- Robustness pass: all Update loops wrapped in try/catch (one bad frame won't crash the snail or the game), config values clamped, ground raycasts use a safer layer mask, cleanup on level change and main-menu exit.
1.3.0
- HUD heat meter (initial)
- Robustness/security pass
1.2.0
- Procedural shell + body textures, eye tracking, breathing, shell spin, slime particle drips
1.1.0
- Multi-part snail, slime trail, wobble, ground-stick, multi-snail spawning, snail rage
1.0.0
- Initial release.
