How to connect your toy to ULTRAKILL

UKButt is a BepInEx mod for ULTRAKILL that triggers toy responses on combat events. Install in two minutes through ToyControl's Intiface bridge.

ULTRAKILL is a fast-paced first-person shooter and the community plugin UKButt routes its combat events to your toy. Damage taken, enemies killed, parries, and other moments trigger toy responses.

UKButt uses Buttplug.io, which ToyControl speaks natively through its Intiface bridge.

What you need

ULTRAKILL installed (Steam).
BepInEx installed for ULTRAKILL.
UKButt mod.
A toy paired with ToyControl in your browser.
The ToyControl helper app running.
The Intiface bridge turned on in ToyControl's Game Link tab. Quit Intiface Central first if you have it installed; the two cannot share the port.

Step 1: Install BepInEx for ULTRAKILL

If you have used any ULTRAKILL mod before, you already have BepInEx. If not, download BepInEx for ULTRAKILL from the ULTRAKILL Thunderstore and extract it into your ULTRAKILL install folder.

Step 2: Install UKButt

Download UKButt from its Thunderstore page (search "UKButt" in the ULTRAKILL community).
Drop the mod files into ULTRAKILL/BepInEx/plugins/.

Step 3: Configure UKButt

Launch ULTRAKILL once to generate the config. Then close the game and open BepInEx/config/UKButt.cfg (or use the in-game ConfigurationManager).

Set the Buttplug server URL to ToyControl's Intiface bridge URL (visible in ToyControl's Game Link tab).

Step 4: Play

Launch ULTRAKILL. UKButt loads through BepInEx, connects to ToyControl, and starts mapping events:

Taking damage triggers an intensity burst.
Killing an enemy fires a short response.
Parrying spikes the intensity briefly.
Other events are mapped in the config; adjust to taste.

Tuning the feel

ULTRAKILL is fast and chaotic. Default settings can be overwhelming.

In ToyControl's bottom bar:

Multiplier at 0.5x is a sensible starting point.
Speed range max at 70 keeps peaks reasonable.
Per-device intensity for fine-tuning.

In UKButt's config, you can also reduce per-event intensity if you find specific events too strong.

Troubleshooting

UKButt does not load

Confirm BepInEx is installed and your ULTRAKILL version matches what UKButt expects.
Check BepInEx/LogOutput.log for errors.

Plugin loads but no toy response

Confirm ToyControl's helper app is running.
Verify the Buttplug URL in UKButt config matches ToyControl's.
Click Test toy in ToyControl to confirm the toy works.

Anti-cheat or performance issues

ULTRAKILL has no anti-cheat. BepInEx mods are common in the community. If the game stutters, try fewer simultaneous mods.

Privacy

UKButt runs locally. ToyControl runs locally. Communication is localhost only.