427Team-Shifter icon

Shifter

Linger in the Mineshaft caves and they start to shift: openings seal out of sight, passages loop back, friends vanish. Nothing new is added - just doubt. All players need it.

By 427Team
Last updated 3 hours ago
Total downloads 24
Total rating 0 
Categories Server-side Interiors Hazards AI Generated
Dependency string 427Team-Shifter-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Shifter

The caves don't like being lingered in.

Spend too long in the Mineshaft caves and the way back isn't quite where you left it. Openings you just walked through are solid rock. Passages lead back into rooms you've already been in. Your friend was right behind you a second ago.

Nothing new is added to the game. No monster, no sounds, no effects, no messages. Everything you see is the game's own geometry. You're left wondering whether you're imagining things.

Every player in the lobby needs this mod. The host decides what happens and every player sees the same cave.

What it does

  • Shifts. After a player has spent a while in the caves, openings start sealing: some behind them, some ahead of them, and the ways out of the caves. A sealed opening is the interior's own dead-end rock wall, the same one the game puts on any unused doorway. An opening only changes while no player is near it and nobody can see it. After a while the cave quietly puts itself back.
  • The first shift of the day is a tease. Just one opening behind you, briefly. Was it always like that?
  • Herding. The cave never blocks the open route toward the nearest dangerous creature, and closes the side passages along it first. It doesn't kill you. It delivers you.
  • Loops. Step into a passage and you may end up in an identical passage that leads straight back into the room you just left.
  • Far swaps (rare). Walk through an opening and you may end up in an identical room somewhere else in the cave.

Loops and far swaps keep your exact position, facing and momentum. They only happen when nothing that differs between the two places is on screen (different rooms through openings, items, enemies, other players) and when no one else can see you vanish or appear. If the exact spot isn't standable in the copy, you're placed on the closest spot that is (within 1.5 m by default). Loops and far swaps each have their own lobby-wide cooldown, so two players walking together will only lose one of them.

Safety

  • It never seals the last way out of the room you're standing in (unless AllowFullTrap is on).
  • Everything reopens on its own. Anything still sealed is force-reopened shortly after a shift ends.
  • Openings with real doors are never touched.
  • Swaps check the landing spot (real floor, room to stand) and cancel if it isn't safe. A last-resort safety net puts you back if a swap ever drops you out of the level.

Requirements and compatibility

  • Only affects the Mineshaft interior's caves. Other interiors are untouched.
  • All players need it. Keep the same config across the lobby for the most consistent behaviour.
  • Needs only BepInEx. No LethalLib, LethalNetworkAPI or other libraries.

Config

BepInEx/config/427Team.Shifter.cfg. Delete the file to get these defaults back.

Timing

Setting Default What it does
TriggerSeconds 150 How many seconds a player must spend in the caves before the cave starts shifting.
TriggerChance 0.5 Chance (0-1) that it happens each time it checks. 1 = always.
RecheckSeconds 45 If the chance roll fails, how many more seconds in the caves before it rolls again.
EventSeconds 90 How long the cave stays shifted before it starts quietly putting itself back.
ForceRevertSeconds 60 Safety net: after the event ends, anything still sealed this many seconds later is reopened even if someone is looking.
CooldownSeconds 300 Minimum time between two shifts.
TeaseSeconds 30 How long the first (tease) shift lasts.
TeaseCooldownSeconds 120 Cooldown after the tease shift before a real one can happen.

Shifts

Setting Default What it does
PathBehindCount 2 How many of the most recent cave openings the triggering player walked through get sealed behind them.
AheadCount 2 How many openings AHEAD of the triggering player get sealed (out of sight, deeper in the cave). 0 = off.
AheadMaxDepth 3 How many cave rooms ahead of the player an 'ahead' seal can be (1 = only openings of the room they're in).
AheadReplanSeconds 20 While a shift is active, re-pick openings ahead of the player this often, so the way forward keeps closing as they move. 0 = only once at the start.
MaxSealedAtOnce 10 Upper limit on how many openings can be sealed at the same time.
AllowFullTrap false If false, an opening is never sealed when that would leave a player's current room with no way out.
FirstShiftTease true The first shift of each day is tiny: one opening behind the player, short, nothing else. Makes them doubt themselves before the real one.
HerdTowardEnemies true Herding: seals never block the shortest open route from the triggering player to the nearest indoor enemy, and close the side passages along it first. The cave doesn't kill - it delivers.
HerdMaxRooms 8 Only herd toward enemies at most this many rooms away.
HerdIgnoreEnemies Docile Locust Bees,Manticoil,Tulip Snake,Red Locust Bees,Hoarding bug Comma-separated enemy names that don't count for herding (harmless or outdoor ones).
SealCaveExits true Seal every opening that leads from the caves to the rest of the facility.
MinPlayerDistance 5 An opening never changes while any player is closer than this (metres).
MaxChangesPerSecond 1 How many openings may change per second at most. Lower = slower, sneakier.

Loops & far swaps

Setting Default What it does
LoopEnabled true Turns loops and far swaps on or off. They only happen when nothing that differs between the two rooms is on screen.
LoopChance 0.2 Chance (0-1) per cave opening walked through that you get looped: you step into a passage and, without noticing, end up in an identical passage that leads straight back into the room you just left.
LoopCorridorsOnly false Only loop in passages with exactly two openings (tunnels). Most Mineshaft cave pieces are junctions, so this makes loops very rare.
LoopGlobalCooldown 120 After ANY player is looped, nobody can be looped again for this many seconds.
FarSwapGlobalCooldown 300 After ANY player is far-swapped, nobody can be far-swapped again for this many seconds.
SwapsOnlyDuringShifts false If true, loops/far swaps only happen during a shift (old behaviour, limited by LoopMaxPerShift). If false they can happen any time in the caves, limited by the global cooldowns.
SwapMinCaveSeconds 60 A player must have been in the caves this long before they can be looped or far-swapped.
SwapMaxNudge 1.5 If no copy has the same surroundings at your exact spot (rocks are scattered differently), swap you to the closest spot you can stand on within this many metres instead. 0 = only exact swaps.
SwapViewDistance 18 How far (m) you can make out details in the dark caves. Differences further away than this don't block a swap. Lower = more swaps, higher = safer.
FarSwapChance 0.05 Chance (0-1) per cave opening that you instead get swapped into an identical room FAR away (rolled before LoopChance).
FarSwapMinRooms 6 A far swap goes to a random identical room at least this many rooms away (best-matching copies first).
LoopMaxPerShift 2 Only with SwapsOnlyDuringShifts: most loops + far swaps one player can get per shift.
LoopRequireMatchingBehind false Far swaps: only when the room behind the copy is identical to the one you came from. Off = more far swaps; the swap still waits until you aren't looking back.

Debug (all off by default)

Setting Default What it does
DebugKeys false F7 (host): force a full shift now. Shift+F7 (host): force the small tease shift. F9: photo tour - saves before/after screenshots of cave openings to BepInEx/Shifter_Photos. F10 (host): put everything back. Shift+F10: show status in chat.
ForceMineshaft false TESTING ONLY: every moon generates the Mineshaft interior. Every player in the lobby must have the same value or their interiors won't match.
DebugChat false Show what Shifter is doing in your in-game chat (only you see it): cave timers, chance rolls, seals and reopens. The host sees everything; other players see seal/reopen counts.
DebugTint false Tint every wall Shifter spawns red, so you can tell them apart from the real ones. Only affects walls spawned after it's turned on.
OnlyLoops false TESTING: every cave opening you walk through tries a loop (back into the room you just left) whenever a seamless one exists. No shift needed, no limit, only affects you.
OnlyFarSwaps false TESTING: every cave opening you walk through tries a far swap (random identical room far away). No shift needed, no limit, only affects you. If both Only* options are on, it picks one at random each time.
VerboseLogging false Log every seal/unseal and the dungeon scan.

Debug keys (with DebugKeys on)

Key Action
F7 Force a full shift (host)
Shift+F7 Force the tease shift (host)
F9 Photo tour: saves before/after screenshots of a few cave openings to BepInEx/Shifter_Photos (only on your screen)
F10 Reopen everything (host)
Shift+F10 Show status in chat