Awesome
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
<!-- table -->| 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
<!-- table -->| 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.