UKButt

Short link: pitr.dev/ukbutt

UKButt is an official BepInEx mod for ULTRAKILL that adds buttplug.io support.

Resources

• Download Latest Release
• Installation
• Running
• Configuration
• Default Values
• Input Modes
• Passthrough Mode
• The buttplug.io standard
• Buttplug.io/Intiface Discord Server (for support questions)

Video

Installation

Start by installing BepInEx 5.4.21

You can also follow one of the Community Made Videos, since BepInEx is commonly used.

Next, download the latest release from the release page and extract the dll files into ULTRAKILL/BepInEx/plugins.

Lastly, you need to install Intiface Central from buttplug.io.

The mod connects to Intiface on port 12345 by default, which is the default port for Intiface Central as well.

Running

Before starting the game itself, launch Intiface Central and start the Intiface Server with the big Start Server button.

That's where you can configure the server and the devices you want to use.

You might have to enable some devices in the settings, depending on what it is.

ULTRAKILL

Next, you should be able to start the game and see Intiface Central connect to the game.

The mod should be functional now.

Configuration

The mod uses ULTRAKILL's preference system and saves its configuration into the Steam Cloud-less ULTRAKILL/Preferences/LocalPrefs.json file, with a ukbutt. prefix.

Preferably, you should change them using the in-game console available by pressing F8.

You can use the ukbutt command to list all available commands.

or ukbutt prefs to get the list of all available preferences and how to change them.

Default Values

Key	Type	Description	Default
ukbutt.socketUri	string	The URI of the Intiface Server.	ws://localhost:12345
ukbutt.strength	float	The strength of the vibration.	0.8
ukbutt.stickForSeconds	float	The minimum duration of a vibration. (in seconds)	2.0
ukbutt.tapStickForSeconds	float	Same as above, but for events marked as subtle.	0.2
ukbutt.useUnscaledTime	bool	Whether to use unscaled (real) time for the duration of the vibration.	false
ukbutt.enableMenuHaptics	bool	Whether to enable haptics in the main menu.	true
ukbutt.inputMode	int	The current InputMode.	1
ukbutt.strokeWhileIdle	bool	If in menu or rank == 0, stroke at lowest speed (rank mode only)	false
ukbutt.linearPosMin	float	Lowest position for stroker movement (rank mode only)	0.1
ukbutt.linearPosMax	float	Highest position for stroker movement (rank mode only)	0.9
ukbutt.linearTimeMin	float	Stroker frequency timing in seconds (rank at ULTRAKILL, rank mode only)	0.3
ukbutt.linearTimeMax	float	Stroker frequency timing in seconds (rank at None/Idle, rank mode only)	1.5

InputModes

Index	Description
0	Nothing
1	Varied (default)
2	Continuous Rank
3	Passthrough

You can change the input mode in-game by using prefs set_local int ukbutt.inputMode <index>

Mode interaction with hardware:

• Varied
  • Vibration will be triggered on certain actions, including shooting, doors, sliding, menu haptics (if set), etc...
  • No effect on strokers
• Continuous Rank
  • Vibration speed or stroker oscillation frequency is set by current style rank. The higher the rank, the faster the vibration or stroking.
• Passthrough
  • Vibration will be the same, as what the game sends to standard controllers.

Passthrough Mode

Note that if you're using the Passthrough mode, the preferences set through the mod won't be used.

In that mode, you can configure the values via the in-game General > Controller Rumble > Customize menu.

Support

If you have issues installing or using Intiface Central, you can either visit the Buttplug.io discord or DM the @buttplugio twitter account.

If you need a list of hardware supported by Intiface Central, visit IOSTIndex.com, which has a full list of supported hardware.