Skip to content

Latest commit

 

History

History
377 lines (289 loc) · 19.8 KB

README.md

File metadata and controls

377 lines (289 loc) · 19.8 KB
Raw

English | 日本語

LoveMachine

QA Download Patreon

Download   Watch Demo (NSFW)

Adds support for some computer-controlled sex toys in the following games:

Title Developer 🥽 VR 🖥 Desktop
AI-deal-Rays Riez-ON ✓
AI Shoujo Illusion ✓ with AISVR ✓
Custom Order Maid 3D 2 Kiss ✓ ✓
Datsui Janken Visionary ✓
Emotion Creators Illusion ✓ with EC_VR ✓
Holy Knight Ricca Mogurasoft ✓
HoneyCome Illgames ✓
Honey Select Illusion ✓
Honey Select 2 Illusion ✓ ✓
Houkago Rinkan Chuudoku Miconisomi ✓ with AGHVR ✓
Incubus 2: Camlann Tanpakusitsu ✓
Insult Order Miconisomi ✓ with IOVR ✓
Koikatsu Illusion ✓ ✓
Koikatsu Party Illusion ✓ ✓
Koikatsu Sunshine Illusion ✓ ✓
Koi-Koi VR: Love Blossoms Apricot Heart ✓ ✓
Last Evil Flametorch ✓
Oedo Trigger CQC Software ✓ sold separately ✓
PlayHome Illusion ✓ ✓
RoomGirl Illusion ✓
Secrossphere Illusion ✓
Sexaroid Girl Daminz ✓
Solas City Heroes MrZGames ✓
Succubus Cafe Migi Studio ✓
VR Kanojo Illusion ✓
Writhing Play Robi ✓ ✓

The following early access games are also supported, but compatibility with later versions of them is not guaranteed.

Title Developer Supported Version Plugin
Our Apartment Momoiro Software 0.5.3.a Available in the installer
Melty Night VR Cauchemar 0.5.5 Patreon post, or build the mnvr branch
Orc Massage TorchEntertainment July 11, 2023 Patreon post, or build the om branch
Summer In Heat Miconisomi 0.10 Free patreon post
Summer Vacation Scramble Illgames 1.0.0 Free patreon post

Supported devices

LoveMachine connects to adult toys through the Buttplug protocol, which supports over 200 devices. Among those, LoveMachine can recognize linear (moving back-and-forth), vibrating, rotating and tightening sex toys.

Some of the devices that have been confirmed to work well with the mod:

Strokers

Vibrators

Rotators

  • Vorze A10 Cyclone

Oscillators

ℹ️ Every supported device works with every game. No exceptions.

⚠ The devices listed under Oscillators have no positional feedback. They don't know which way is up and down, so they can't accurately sync to in-game characters. If you want to buy a device that can, you're looking for something under Strokers.

The LoveMachine.Experiments plugin also adds experimental support for two depth sensing devices (Lovense Calor and the Hotdog) to Koikatsu and Koikatsu Sunshine.

Installation

Download and run the installer. If you encounter the "Windows protected your PC" message, click More info > Run anyway.

Intiface Central must also be installed.

How to use

  1. Open Intiface Central.
  2. Click on the big Play button.
  3. Turn on the device you want to use.
  4. Start the game.

The Space key acts as a kill switch for all devices while in-game. To reactivate your devices, press F8. Both of these key bindings can be modified under Plugin Settings > LoveMachine > Kill Switch Settings.

⚠ In certain games, the kill switch may not work if the BepInEx console is open while playing in VR, because it can steal focus from the game window. It is recommended to disable the console.

If you need further help in using the plugin, check the Troubleshooting page or open an issue.

If you found this project useful, please give it a ⭐.

How it works, limitations

Whenever a new animation loop starts, LoveMachine records the relative positions of certain bones for one cycle, then it tries to guess which bones are the most likely to be involved in the action (e.g. a penis and a mouth). More often than not, it guesses correctly; when it doesn't, you can manually select which bone of which character to track in the Plugin Settings. You can even select a different bone for each device to reenact more complex scenes.

After one cycle of learning, the plugin translates the relative movement of the guessed/selected bones into something that the device can perform (e.g. axial movement for strokers, or rotating back-and-forth for rotators).

As the whole thing is based on bone positions, this will only work for reasonably sized and proportioned characters.

Configuration

⚠ IL2CPP games (RoomGirl, Holy Knight Ricca) are not compatible with ConfigurationManager at the moment. If you want to change the settings in those games, you can edit the configuration file (BepInEx\config\Sauceke.LoveMachine.IL2CPP.cfg) in Notepad.

In Plugin Settings > LoveMachine, you can set the following parameters:

Animation Settings (KK/KKS only)

  • Track Animation Blending: H-Scene animations in Koikatsu and KKS shift slowly back and forth between two variants of the same animation. The two variants sometimes have different stroke patterns. This setting allows you to track both variants, which makes animation tracking more precise, but may also result in some abrupt changes mid-stroke. Turned on by default.

Core Settings

  • POV: Which character's point of view should be simulated. Possible values:
    • Balanced: Replicates relative movement. Should work for most players, most of the time.
    • Male: Male bottom POV. Only replicates the female character's movements.
    • Female: Female bottom POV. Only replicates the male character's movements.

Device List

This is where all your devices connected to Intiface are listed.

  • Connect: Connect or reconnect to the Intiface server.
  • Scan: Scan for devices.

General device settings (all devices):

  • Group Role: Which girl the device is assigned to in a group scene. This also affects scenes that are not group scenes, e.g. if a device is assigned to second girl, and there is only one girl in the scene, it will not be activated at all.
  • Body Part: Selects the body part that will be tracked by the device. Defaults to Auto (which means it will find the one closest to the player's balls). Can be used to re-enact TJ/FJ with alternating movement using two devices. In Koikatsu and KKS, it also tracks fondling/fingering movements.
  • Latency (milliseconds): Latency of sex toys is usually negligible, but if you're experiencing any noticeable delay between your display and your device, use this setting to correct it. There's no way to calibrate this, so you'll have to experiment.
  • Updates per second: How often to send commands to this device. BLE devices can usually handle about 10-20 commands per second.

Stroker settings:

  • Max Strokes (per minute): The maximum speed your stroker is capable of at 100% stroke length.
  • Stroke Zone / Slow: The range of the stroking motion when going slow. 0% is the bottom, 100% is the top.
  • Stroke Zone / Fast: The range of the stroking motion when going fast. 0% is the bottom, 100% is the top.
  • Smooth Stroking: Makes the stroking movement less robotic, but not all strokers can handle this. Known to work well on Handy and OSR2 devices. Turned off by default.

Vibrator settings:

  • Intensity Range: Minimum and maximum vibration intensity allowed for this device. 0% = no vibration, 100% = full strength.
  • Vibration Pattern: The waveform of the vibration intensity. Available values are Sine, Triangle, Saw, Pulse, Constant, and Custom.
  • Custom Pattern: Available if Vibration Pattern is set to Custom. You can set the vibration intensity curve using the sliders.

Oscillator settings:

  • RPM Range: The minimum and maximum rotations per minute this device is capable of.

Pressure settings:

  • Pressure Range: Minimum and maximum pressure allowed on this device, in percentages.
  • Pressure Update Interval (seconds) How much time it takes for this device to change pressure, in seconds. Defaults to 5.

You may also want to:

  • Save device assignments: If enabled, the Threesome Role and Body Part attributes will be saved for all devices. Disabled by default.

Intiface Settings

  • WebSocket host: The URL of the host Intiface is running on. Should be ws://127.0.0.1 unless it's running on a remote machine.
  • WebSocket port: The port Intiface is listening on. Usually 12345.
  • Reconnect Backoff Time (seconds): Waiting time between attempts to connect if the connection was lost or not made.

Kill Switch Settings

Safety measure to avoid hurting yourself if the sex gets too rough or something goes wrong. By default, pressing Spacebar will immediately stop all connected devices.

  • Emergency Stop Key Binding: Sets the keystroke for activating the kill switch (Space by default).
  • Resume Key Binding: Sets the keystroke for deactivating the kill switch (F8 by default).

Stroker Settings

  • Stroke Length Realism: How much the stroke length should match the animation. 0% means every stroke will use the full available length. 100% means every stroke will be scaled to its in-game length.
  • Hard Sex Intensity: How fast your stroker will fall during hard sex animations. 100% is twice as fast as 0%. I'm not responsible for any injuries that may occur due to the use of LoveMachine.
  • Orgasm Depth: The position of the stroker during orgasm.
  • Orgasm Shaking Frequency: How many strokes to do per second during orgasm.

Rotator Settings

  • Rotation Speed Ratio: The speed ratio for rotation. 0% is no rotation, 100% is full speed rotation. Default is 50%.
  • Rotation Direction Change Chance: The direction of rotation changes with the probability of this setting. Default is 30%.

Oscillation Settings

  • RPM limit: Maximum allowed rotations per minute for any device. Default is 300.

Pressure Settings

  • Enable Pressure Control: Whether to use the pressure feature of this device. On by default.
  • Pressure Mode: Determines how the pressure will be set.
    • Cycle: Gradually build up and release pressure over a fixed duration.
    • Stroke Length: Longer strokes = more pressure.
    • Stroke Speed: Faster strokes = more pressure.
  • Pressure Cycle Length (seconds): If the Pressure Mode is set to Cycle, determines the length of a buildup-release cycle in seconds.

Contributing

PRs for onboarding new games are welcome. The process is relatively simple and requires barely any coding. See the PlayHome implementation for reference. PRs for supporting new device types are also welcome.

This mod is provided free of charge, but I do accept donations. If you'd like to boost my morale, please check me out on Patreon.

Developers

Sauceke   •   nhydock   •   hogefugamoga   •   RPKU   •   andama777 (JP translation)

Patrons

ManlyMarco   •   '- [ Willox ] ヘンタイ    •   AbGz   •   AkronusWings   •   Alex   •   Ambicatus   •   Andrew Hall   •   as a1031   •   AstralClock   •   asuka   •   Atlantic Dragon   •   Average MBT viewer   •   Benos Hentai   •   boaz   •   BOOK   •   Bri   •   Bunny Dreammy   •   butz   •   cat tail   •   Ceruleon   •   Chai   •   CJ   •   CookieMuncher   •   CROM   •   CSV TORP   •   Daniel   •   dc1222   •   DDJTK   •   EPTG   •   er er   •   Ergo   •   Firestorm447   •   funnychicken   •   Gabbelgu   •   Gaku Kihara   •   gmolnmol   •   gold25   •   GOU YOSIHIRO   •   Greg   •   Grindcore   •   hiro   •   Ior1yagami   •   jason   •   Jayhawk   •   Jesse Russell   •   JJ   •   John Last   •   Kai Yami   •   KodFish   •   KTKT   •   kunewb   •   kuni   •   Lancer   •   Laneo   •   le d   •   lover not fighter   •   Maha   •   Marcos Gonzalez   •   milkyway ミルク    •   mokochurin   •   Moon2S Clap   •   Nemi   •   Nephilim Bacon   •   Noel Molina   •   nppon   •   PhazR   •   pontatata   •   POPO popo   •   prepare55   •   real name   •   RP 君    •   SavagePastry   •   Shakes   •   shiro   •   Sphiffy   •   Taibe   •   TO   •   TrashTaste   •   ttrs   •   tutinoko   •   unitora   •   Wel Adunno   •   xagtxc   •   yur liao   •   Zijian Wang   •   Zomba Mann   •   ヴい＠CBN   •   グリム・ ヴァン・アストル 聖騎士    •   こわい まんじゅー    •   シルバー    •   ふ    •   マラカス    •   り ょすけ みのかわ    •   一太 川崎    •   優希 岩永    •   哲慶 宗    •   国崎往人    •   夢 阿    •   洋 冨岡    •   猛 羽場    •   终晓    •   郁弥 中村    •   闇《YAMI》   •   高島　渉

Acknowledgements

This mod would not have been possible without the BepInEx plugin framework and, of course, the Buttplug.io project.