AimAndCrouchToggles

A BepInEx mod for Mycopunk that adds optional toggle aim and toggle crouch.

Features

• Toggle Aim: Press aim once to enter ADS, press again to exit — no need to hold. Weapons with aiming disabled ( IsAimEnabled false), such as Gunship Cannon, Plate Launcher, and Carver, are left alone. Toggle aim resets on death/resurrect.
• Toggle Crouch: Press the slide/crouch button to stay crouched until you press it again. Sliding still works as normal when you have momentum.

Both features are on by default and can be enabled or disabled independently in the config.

Getting Started

Dependencies

• Mycopunk (base game)
• BepInEx 5.4.2403 or compatible (e.g. BepInExPack for Mycopunk)

Building

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

Alternatively, with the .NET CLI:

dotnet build --configuration Release

The project targets netstandard2.1. Game and BepInEx assembly reference paths in the .csproj may need adjusting for your machine.

Installing

Via Thunderstore (recommended)

1. Install with a Thunderstore mod manager
2. The mod is placed in the correct BepInEx plugins folder automatically

Manual installation

1. Place AimAndCrouchToggles.dll in <Mycopunk Directory>/BepInEx/plugins/

Usage

The mod loads automatically through BepInEx when the game starts. Check the BepInEx console for a load confirmation message.

Configuration

Settings live in:

<Mycopunk Directory>/BepInEx/config/sparroh.aimandcrouchtoggles.cfg

Config changes are hot-reloaded while the game is running — save the .cfg file and the mod applies the new values automatically (look for Config reloaded from disk. in the BepInEx log).

Help

• Mod not loading? Verify BepInEx is installed correctly and check console logs for errors.
• Toggle not working? Confirm the setting is enabled in the config file; save the file to hot-reload without restarting.
• Aim stuck on? Toggle aim resets on death/resurrect; you can also disable the setting to force-clear it.

Authors

• Sparroh

License

This project is licensed under the MIT License — see the LICENSE file for details.

Changelog

1.1.2

• Refactor

1.1.1

• Toggle Aim no longer forces ADS on weapons that have aiming disabled (canAim / IsAimEnabled false), including Gunship Cannon (Mini Cannon), Plate Launcher, and Carver

1.1.0

• Initial combined release
• Toggle Aim: press to enter/exit ADS instead of hold
• Toggle Crouch: press slide/crouch to stay crouched until pressed again
• Config hot-reload while the game is running

1.0.1

• Implemented toggle aiming instead of hold aiming
• Aim state toggles on button press
• Automatic sprint resume after aiming/firing stops
• Reset toggle aim state on player resurrection
• Improved accessibility for controller and keyboard users

1.0.0

• Implemented toggle crouch/slide instead of hold
• Press slide once to enter crouch/slide, press again to exit
• Prevents automatic uncrouching while toggle crouch is active
• Maintains compatibility with existing crouch/slide mechanics
• Improved accessibility for players who prefer toggle controls