LiveSplitHooks

A BepInEx mod for Mycopunk that drives LiveSplit automatically over its named pipe command server. No ASL script required.

Features

• Auto start when a mission begins
• Auto reset + start on each new mission (IL-style; configurable)
• Auto split on successful mission completion
• Auto reset on mission fail / abort
• Optional splits on each main objective
• Incursion floor-clear splits (default target floor 30; ends the run at max floor)
• Sub-mission transitions (e.g. Cranius after setup): split, swap profile, start
• Per-mission split profiles — auto switchsplits by mission name/id
• Load removal via LiveSplit game time (pausegametime / unpausegametime)
• Auto-reconnect if LiveSplit is opened after the game
• Fully configurable triggers

Requirements

• Mycopunk
• BepInEx (BepInExPack for Mycopunk)
• LiveSplit running on the same PC
• For split profile switching: a recent LiveSplit build that supports the switchsplits pipe command

LiveSplit setup

1. Open LiveSplit and load your splits layout as usual.
2. Keep LiveSplit running while you play. The named pipe server (\\.\pipe\LiveSplit) is available by default — no extra component is required for pipe control.
3. Optional: Right-click LiveSplit → Control → compare against Game Time if you use load removal.
4. Launch Mycopunk with the mod installed.

When a mission starts you should see the timer reset (if a previous run exists) and start. Completing the mission splits; failing resets (defaults).

IL vs full-game

• Individual missions (default): leave ResetBeforeStartOnMissionBegin = true. Each mission is its own LiveSplit attempt (reset + start on begin, split on complete).
• Full-game / multi-mission route: set ResetBeforeStartOnMissionBegin = false so the timer keeps running across missions. Use one split segment per mission with SplitOnMissionComplete = true. Prefer leaving split profiles **off ** for full-game runs.

Objective splits

Set SplitOnObjectiveComplete = true to split on each main (non-side) objective. Keep SplitOnExtractObjective = false if SplitOnMissionComplete already ends the run, or you will double-split at extract.

Incursion (floor 30)

Incursion never ends in-game. The speedrun category ends at floor 30.

When the active mission id is listed in FloorChangeSplitMissionIds (default incursion):

• Timer starts on mission begin as usual
• Each floor clear (floor number increases) sends split
• Door code skips that jump multiple floors emit one split per floor crossed (keeps a 30-segment layout aligned)
• Clearing floor 30 (entering floor 31, or skipping past 30) sends the final split and ends the LiveSplit run ( IncursionEndRunAtMaxFloor, default true)
• Final time stays on screen; further floors / mission fail later do not reset or split this attempt

Suggested incursion.lss: 30 segments (cleared floor 1 … cleared floor 30). No extract segment.

Cranius (sub-mission)

Cranius loads after a setup mission on Moldy Tundra (often planet_def). With SplitOnSubMissionTransition = true ( default):

1. Setup mission starts → normal start (and optional profile)
2. Cranius mission starts → split (ends setup attempt) → reset → switchsplits to Cranius profile → start

The game’s mission id is literally ???; C# type is FlatTundraMission. The mod sets primary key **cranius **. Put these in your live profiles.txt (not only the example file):

cranius => Mycopunk - cranius.lss
??? => Mycopunk - cranius.lss
FlatTundra Mission => Mycopunk - cranius.lss
FlatTundraMission => Mycopunk - cranius.lss
# planet_def => Mycopunk - planet_def.lss

Cranius is separate from Amalgamation — only Flat Tundra / cranius aliases apply.

Per-mission split profiles

Use this when different missions need different .lss files (e.g. different objective counts).

1. Put your .lss files in one folder (any path). Filenames can include the game prefix, e.g. Mycopunk - cleanup_detail.lss.
2. In config (BepInEx/config/sparroh.livesplithooks.cfg):

[SplitProfiles]
Enabled = true
Directory = C:\Path\To\LiveSplit\Splits
MapFile = C:\Path\To\LiveSplit\Splits\profiles.txt
Mappings =
AllowSubstringMatch = true

• MapFile = path to the mapping text file (not Mappings — that is for inline lines only).
• Directory = folder used to resolve relative .lss names on the right-hand side of the map.
• Ensure the map file is named profiles.txt (not profiles.txt.txt from Windows hidden extensions).

1. Create profiles.txt next to your splits (see profiles.example.txt):

ouroblitz => Mycopunk - ouroboros_blitz.lss
incursion => Mycopunk - incursion.lss
cleanup_detail => Mycopunk - cleanup_detail.lss
prized_pos => Mycopunk - prized_pos.lss
sat_salvage => Mycopunk - sat_salvage.lss
cranius => Mycopunk - cranius.lss
??? => Mycopunk - cranius.lss
FlatTundra Mission => Mycopunk - cranius.lss
FlatTundraMission => Mycopunk - cranius.lss

Confirmed ids: ouroblitz, incursion, cleanup_detail, prized_pos, sat_salvage, Cranius (cranius / ??? / FlatTundraMission).

1. Start a mission with DebugLogging = true and read the BepInEx log line:

Mission identity key='ouroblitz' name='Ouroboros: Blitz' detail=[OuroborosBlitz | Roguelike Operation]

Prefer the stable key= id for exact mappings; ~Name substring lines work until you log each mission once.

1. On the next matching mission the mod sends reset → switchsplits <path> → start.

Inline mappings also work via SplitProfiles.Mappings (same line format, \n-separated in the cfg value). MapFile is easier to edit.

Note: Profile switching resets the timer before loading the new file so LiveSplit can swap cleanly. That pairs naturally with IL mode.

Installing

Thunderstore / r2modman (recommended)
Install LiveSplitHooks into your Mycopunk profile.

Manual
Place LiveSplitHooks.dll in BepInEx/plugins/.

Configuration

Edit BepInEx/config/sparroh.livesplithooks.cfg (created on first launch):

Building

dotnet build --configuration Release

Output: bin/Release/netstandard2.1/LiveSplitHooks.dll

How it works

The mod connects to LiveSplit’s command server and sends newline-terminated commands (start, split, reset, switchsplits, pausegametime, …).

Game hooks (Harmony):

• MissionManager.OnMissionStarted_Client → capture mission identity, optional profile switch, optional reset, then start
• MissionManager.OnMissionCompleted_ClientRpc → split
• MissionManager.OnFailMission_Client → reset
• ObjectiveBase.Complete / client RPC → optional objective splits
• IncursionObjective.SpawnRooms_ClientRpc / IncursionHUD.SetFloor → floor-clear splits
• Scene / player-load state → game time pause

Mission identity is resolved via MissionManager reflection (name/id and related fields) and logged when debug is on so you can build profile maps without reverse-engineering.

Troubleshooting

• Nothing happens — Confirm LiveSplit is open before or while the game runs; enable DebugLogging and watch the BepInEx log for LiveSplit <= start etc.
• Double splits — Turn off SplitOnObjectiveComplete if you only want one split per mission, or disable SplitOnMissionComplete if you split on objectives only.
• Timer doesn’t use load removal — Set LiveSplit to compare Game Time, and keep PauseGameTimeDuringLoads enabled.
• Pipe connect failed — Another program may be holding the pipe; restart LiveSplit.
• Profile did not switch — Check the mission identity log line, your map keys, and that the .lss path exists. Confirm your LiveSplit version supports switchsplits (update LiveSplit if the command is ignored).
• Wrong splits loaded — Prefer exact keys from the log; disable AllowSubstringMatch if substring rules are too greedy.
• Incursion keeps running after floor 30 — Ensure IncursionEndRunAtMaxFloor = true and that the mission id matches FloorChangeSplitMissionIds (default incursion).

License

MIT — see LICENSE.

Authors

• Sparroh

Changelog

1.2.4

• Clarify Cranius ≠ Amalgamation: remove Amalgamation aliases; Cranius is FlatTundra only (FlatTundraMission / ??? / cranius)

1.2.3

• Cranius: detect FlatTundraMission / asset FlatTundra* → primary key cranius

1.2.2

• Cranius identity: treat mission id ??? as a placeholder; prefer asset name / type aliases → primary key cranius
• Still match profiles on ???, FlatTundra Mission, cranius
• profiles.example.txt: Cranius + planet_def setup entries from in-game logs

1.2.1

• Incursion: end the LiveSplit run when floor 30 is cleared (IncursionEndRunAtMaxFloor, default true) so endless mode does not keep the attempt open
• Document floor-30 finish timing (final split on clearing 30 / entering 31)

1.2.0

• Sub-mission transitions (Cranius): if a new mission starts mid-run, split the setup attempt, reset, switchsplits to the new profile, then start
• Incursion floor-clear splits: hook IncursionObjective.SpawnRooms_ClientRpc + IncursionHUD.SetFloor; split when floor increases (supports +5 code skips); default target floor 30
• Config: SplitOnSubMissionTransition, FloorChangeSplitMissionIds, IncursionFloorSplitMax, IncursionStopSplitsAtMaxFloor
• profiles.example.txt: confirmed ids ouroblitz, incursion, cleanup_detail, prized_pos, sat_salvage; Cranius still ~Cranius until logged

1.1.1

• Tighten mission identity: prefer nested mission ID / MissionName / asset name (e.g. ouroblitz, Ouroboros: Blitz)
• Strip rich-text color tags; stop logging MissionManager network/bool noise
• Expand profiles.example.txt with current IL categories (Blitz confirmed; others substring until logged)

1.1.0

• Add optional split profiles: detect mission identity and switchsplits to a mapped .lss file
• Log mission identity on mission start (when DebugLogging is on) for easy profile map setup
• Config section SplitProfiles (directory, default splits, inline mappings, external map file, substring match)
• Ship profiles.example.txt as a mapping template
• switchsplits / switchlayout helpers on the LiveSplit client

1.0.1

• Add ResetBeforeStartOnMissionBegin (default true) so each new mission resets LiveSplit before starting — fixes IL runs not clearing after a completed mission
• Document IL vs full-game config in README

1.0.0

• Initial release
• LiveSplit named pipe client with auto-reconnect
• Auto start on mission begin
• Auto split on mission complete
• Auto reset on mission fail/abort
• Optional per-objective splits
• Game time pause during loads
• Configurable triggers via BepInEx config