ToggleCrouch

A BepInEx mod for MycoPunk that changes crouching and sliding from hold-to-maintain to toggle mode.

Description

This client-side mod transforms the default crouch/slide mechanics from holding the button continuously to a toggle system. Press the slide/crouch button (typically C or Left Bumper) once to enter crouch/slide mode, and press it again to exit. This eliminates the need to hold the button while sneaking, sliding, or performing low-profile movement mechanics.

Perfect for players who prefer toggle-style controls, experience hand fatigue from holding buttons, or need improved accessibility. The mod maintains all existing crouch and slide functionality while simply changing the input method from hold-based to toggle-based.

Getting Started

Dependencies

• MycoPunk (base game)
• BepInEx - Version 5.4.2403 or compatible
• .NET Framework 4.8

Building/Compiling

1. Clone this repository
2. Open the solution file in Visual Studio, Rider, or your preferred C# IDE
3. Build the project in Release mode

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Installing

Option 1: Via Thunderstore (Recommended)

1. Download and install using the Thunderstore Mod Manager
2. Search for "ToggleCrouch" under MycoPunk community
3. Install and enable the mod

Option 2: Manual Installation

1. Ensure BepInEx is installed for MycoPunk
2. Copy ToggleCrouch.dll from the build folder
3. Place it in <MycoPunk Game Directory>/BepInEx/plugins/
4. Launch the game

Executing program

Once installed, the mod works automatically and affects crouch/slide mechanics:

Toggle Behavior:

• Enter Crouch/Slide: Press slide button once (C key/Left Bumper)
• Exit Crouch/Slide: Press slide button again
• Same Physics: All crouch/slide movement, benefits, and restrictions work identically
• Visual Feedback: Standard crouched/sliding animations and mechanics unchanged

State Management:

• Toggle state persists until manually exited via button press
• Automatically manages transitions between standing/sneaking/sliding
• Prevents unintended auto-uncrouching while toggle is active

Movement Continuity:

• Can move between crouch states (stand to crouch, crouch to slide) while toggle is on
• Maintains crouch state through different terrain and movement scenarios
• Compatible with all existing game mechanics that require or modify crouching

Help

• Still have to hold? Mod changes input from hold-to-toggle - you should only need to press once now
• Getting stuck? Press the slide/crouch button again if you can't exit - no UI state changes
• Different behavior? The underlying crouch/slide mechanics work exactly the same, just input method differs
• Performance impact? Minimal - only monitors button presses and manages toggle flag
• Conflicts with mods? Shouldn't conflict unless other mods heavily modify crouch/slide systems
• Controller/keyboard? Works with both input types using the standard slide/crouch button
• Sneaking still works? Yes - the slide button actives sneak mode when toggle is on
• Testing? Press slide button, move around crouched, press again to stand up

Authors

• Sparroh
• funlennysub (original mod template)
• @DomPizzie (README template)

License

• This project is licensed under the MIT License - see the LICENSE.md file for details