Jump to content

About This File

-----------------------------------------------------------------------------------------------
Devious Devices - A Bondage Framework for Fallout 4

 

Code By Kimy, using some design ideas from Min's DD implemention for Skyrim.
Additional code by AG12.
Devious Devices Art assets by Zadil, Koffii, Pincopallino and Heretical.
Additional art assets by DixiePig, Vioxsis, Newmiller, HisDudeness, Vader666, mxwqtkl, Dasha and Nytesorrow.
Fallout 4 conversion of Skyrim art assets by Bumex
-----------------------------------------------------------------------------------------------

 

DESCRIPTION

 

Devious Devices is a collection of restraining devices and toys to torment your Nora, including, but not limited to: chastity belts, collars, cuffs, vibrators, gags, and even hobble skirts! And don't worry about wiggling out of them: All devices lock in place, and only the correct key can open the locks! And these devices don't just look restrictive, they ARE! These handcuffs really lock your hands on your back and make you unable to fight. Running in leg irons? No way! And yes, wearing a gag will make you speak gibberish!

 

NPC Support: Yes, it works with the other denizens of the Wasteland, too. Is Preston asking you to save yet another settlement you couldn't care less about? Just gag him and shut him up!

 

Intuitive Interfaces! - No need to use spells, or batch files or other quirky methods to enjoy these devices! Just click them in your inventory and choose what you want to do with them via the easy to use interaction menu!

 

Framework! - Want to create your own bondage mod? Kinky quests? Custom restraints? DD is providing all needed functionality for that, so you don't have to! Want to create custom bondage items? Just make your item use the DD scripts and customize dozens of properties to your taste and create your own toys without writing one line of code! Items with custom keys? No problem! Multiple locks? For sure! Timed locks? You bet! Cuttable material? Yep, got that, too! Impossible to struggle out from? Check! Override animations? Just tell the item which ones to use, or create your own! Items that cannot be removed as long as another is locked on? Yes, even that! And if all of that isn't enough, create your own spell effects and add any number of them to your item. If you think it can't be done, think again!

 

REQUIRED MODS

 

- All DLCs (And please don't ask for a non-DLC version. I won't make one.)
- CBBE Body - http://www.nexusmods.com/fallout4/mods/15/?
- Bodyslide and Outfit Studio - http://www.nexusmods.com/fallout4/mods/25/?
- Armor Keyword Resource - http://www.nexusmods.com/fallout4/mods/6091/?
- Torture Devices - http://www.loverslab.com/topic/68652-torturedevices/

 

INSTALLATION

 

1. Install the NEWEST versions of ALL requirements listed above using your favorite mod manager, including THEIR respective requirements.
2. Install this mod with a mod manager of your choice.
3. Run Bodyslide and batch build all assets using the preset of your choice.

 

CONFLICTS

 

General: The point of this mod is locking the player character in restraints hard to remove. This feature might cause issues with other mods not expecting the character to wear non-removable items. Known issues will be listed in this section. Feel free to report incompatibilities in the support thread.

 

No other conflicts known at this point.

 

KNOWN ISSUES AND LIMITATIONS

  • The items do not have world/ground models. I don't have world models I could use.
  • Gags do not change an actor's expression and do not force them to open their mouth. That's currently not feasible to do (at least not that I'd know of). For that reason, the panel gag works best.
  • Some of the items might clip with others and with clothing. There is currently no way to dynamically hide armor on a character.
  • The code is currently not attempting to catch brute-force removal of DD items via UnequipAll(). This command, if used on the player without other precautions, breaks the game anyway, as it stips the PipBoy from the player as well. I don't expect mods to widely use it. I will deal with it down the road in case I have to.
  • Some API functions work on the player only, not NPCs (e.g. RemoveGenericItemByKeyword). This is due to a scripting lanaguage limitation. As a consequence, modders need to keep track of what they are equipping on NPCs, if they want to remove the items later on.

 

PERMISSIONS

  • You can NOT post this mod or any of its parts (including any derived works) outsides of LL without my explicit permission.
  • You can NOT incorporate any of my code in any for-profit project (Donations/Patreons are fine as long as they are strictly voluntary and don't offer the donor any tangible advantage over non-donors)
  • You can NOT incorporate any of my code in mod that's going to be uploaded to Bethesda.Net and/or made available for consoles in any other way.
  • You can NOT use any of my code in a closed source project. No exceptions, ever. No need to ask for permission either. I won't give it. Even in my wildest dreams I can't think of a good reason not to publish a mod's source code.
  • You can NOT publish a fork of this mod (as in using it as a base for a project offering similar functionality) without my permission. That includes porting it to other platforms/games.
  • You CAN otherwise use my code for your own projects as long as you include all source code with your distribution and allow others to use your own code in a similar fashion. And give proper credit where it's due. All above rules still apply!


Legacy clause: If I can no longer be contacted for a sustained period of time despite sincere efforts to do so, I grant the LL staff permission to assign a new maintainer to Devious Devices to update it with fixes and feature enhancements. In case this clause is invoked, I do reserve the right to request back maintainer status of the mod at any time for any reason, though.

 


For all third party assets used by this mod (namely art assets, see credits section), all conditions set by their original creators apply instead. Please contact the respective author for further information on permissions etc.

 

FOR MODDERS

 

Please refer to the documentation in the archive!

 

DIFFERENCES BETWEEN FALLOUT 4 DEVIOUS DEVICES AND SKYRIM DEVIOUS DEVICES

 

There are actually quite a few of them. Some are owed to FO4 being a different game with different capabilities. Some are lessons learned from years of developing for Skyrim DD. Generally, DD for FO4 is not really a 1:1 port of Skyrim DDI, it's more a reimplementation. In particular:

 

Stuff that's different because of game differences and/or scripting limitations:

  • Unlike Skyrim DDI, effects and relations between devices aren't hardcoded in Fallout 4 DD. Not a single one of them is. All effects, without any exception, are set via item properties and/or keywords. E.g. if you want to create a custom plug and want them to be unable to be removed from a character wearing a chastity belt, you will have to assign the relevant item properties, or the code will ignore it. You can even make gags that don't prevent you from speaking or corsets that make you blind. Because even these effects are not hardcoded for the device types. Unless you tell the code otherwise, a device is just a lockable thing that by itself doesn't do anything except cling to you.
  • Skyrim DDI's approach to creating custom items was objected oriented inheritance: You would inherit the base script and override/add what you wanted. FO4 DD's approach is making everything customizable via script properties and hardcode as few features as possible. This approach should make writing custom code unnecessary almost 100% of the time. Since every item can have an arbitrary number of spell effects attached to it, there is practically no limit to what you can do.
  • There are only limited global user settings affecting item difficulty or behavior in FO4 DD. There never will be any customization options allowing shutting off any features of the device system entirely. Everything influencing item behavior is determined on the device level. This is putting all control in the hands of the modder, where it should be. The settings can be vastly different from item to item. E.g. one item can have a 20% chance to break the key, another can have 0%. The user can apply a modifer to generic items, but a device designed to be punishing will always be punishing in relation to others. Which makes item behavior predictable for modders using the framework - the item will behave exactly the way it was designed! On the flip side, it puts also more responsibility on the modder, not to create unfun features or devices that users will generally end up hating.
  • DDI had a tag-based item database for randomly picking restraints. I do not plan to implement this feature. There is a function in this mod that can pick random devices from formlists. It's not quite as powerful as DDI's tag database, but for most applications it will do its job just nicely. The FormLists are exposed to the API, so 3rd party mods can add their own devices to it!
  • FO4 DD has only one blindfold mode, that's equivalent to Leeches mode in DDI. No other blindfold modes are planned for the framework. The player can NOT set the blindfold strength. The modder can. But even the strictest setting still allows you to navigate your environment. The compass is still there, too. The framework blindfolds are a lot less punishing than their counterparts in DDI.
  • There is no hardcoded event system either. If you want devices to trigger reoccurring events, create a magic effect running a timer and add it to the correct device property. Refer to the implementation of the Plug Vibrate effect to see how to do that. Most of the old events did not get reimplemented because they did not do much, except displaying a text.
  • The dreaded corset implementation is gone and won't be back. The price for that is serious clipping of corsets with most chastity belts, but I prefer that to non-working scripts and broken item states all over the place. There are special chastity belt add-ons for use with corsets. They don't clip.
  • Vaginal piercings did not get implemented and likely never will. This item type was underwhelming in Skyrim (yet another vibrating thing that barely can be seen on the character...) Plugs trigger vibrate effects and that's all the vibrations you will ever need!
  • There is only one class of hand restraints in FO4 DD. Armbinders, yokes, shackles, handcuffs and all other types of wrist restraints share one item type. Which means that characters cannot wear handcuffs and armbinders at the same time, unlike in DDI. Yes, I know that in real life it's possible to put a handcuffed person in an armbinder for additional giggles, but this little drawback made the implementation of wrist restraints so much more efficient that it's not even funny.


Generally: The code allows you all sorts of freedom, but you need to be responsible with it. If you create a quest restraint with only one key in the entire world that can unlock it, and then set the key break chance to 90%...don't complain about angry users laying siege to your support thread!

 


FAQ:

 

Q: How to best report any issues with Devious Devices?
A: Post your issue in the support thread and describe what happened, and how. In enough detail that I might have a chance to understand what went wrong there. Oh, and post a Papyrus log if you can. While I might be able to guess the cause of your problem every now and then, chances are that I will never find out what went wrong unless you provide me with the log. DO NOT PM ME WITH SUPPORT REQUESTS!!!

 

Q: I have this and that problem with an older version of Devious Devices.
A: Please don't ask me about older versions. Ever. I release patches for a reason. Use them! Some of them even might have fixed the exact bug you're reporting to occur in your ancient version of this mod. Only the newest version is supported at any time. Don't post any questions in the support thread unless you're running the -newest- version of this mod AND all of its requirements.

 

Q: I have a support question and wonder if I should PM it to you.
A: Please, PLEASE do NOT use PMs for support issues and bug reports. I might/will ignore them and delete them without responding to them! Support requests belong in the support thread and nowhere else, so other people having the same issue can see the reply as well, or even help each other, so I don't have to answer ALL questions people might have.

 

Q: I love this mod and want to support you. Can I?
A: It would be very much appreciated! I have a Patreon set up if you want to tip me: https://www.patreon.com/kimy

 

Q: Can I suggest new features?
A: Absolutely! I have implemented a lot of user-suggested features in my mods and I will continue doing so. But please understand that I cannot implement them all and that some others I really just won't like enough.

 

Q: Will this mod ever support male player characters?
A: Male player characters will never be officially supported. Blame it on me being lazy or on the general lack of interest of the LL community in DD support for males. It's also just fair, because the gaming industry is making me play guy characters in their games all the time and I don't like that either. Some of the items offer male models at their creator's discretion, in which case I might add them to DD, so that they can be used on male NPCs. But I will not ever give any sort of guarantee that any particular item will work on males, and I will never test or design any feature of this mod with male characters in mind.

 

Q: Why are the bundled items changing my body when equipped? Why are some items invisible? Why is everything so messed up???
A: Use Bodyslide, Luke! It's listed in the requirements for a reason. You need to actually build the assets with Bodyslide!

 

Q: Is this mod compatible with <obscure mod you found in a remote corner of the internet and nobody else but you ever seems to use>?
A: Ummm...I dunno.. You tell me! I list all known incompatibilities in this ReadMe, but there are really a lot of mods out there, and I can't possibly test them all.

 

Q: Why don't you add <items from this and that other restraint mod available on LL> to DD's item library?
A: If the other mod has been out on LL for more than a couple months and I haven't added the items, chances are that I don't like them enough and/or their creators didn't give me permission.

 

Q: Can I translate your mod?
A: I'd feel honoured, but please re-post only the files needed for the actual translation, as a patch with a link to the offical mod! Do NOT re-distribute the entire mod. If you want to post the translated files outsides of LL, please ask for permission first. I am likely to give permission for non-English speaking communities outside of the EU or NA and very, very unlikely otherwise. I also reserve the right to pack any translated files with the main mod and distribute it as part of DD.

 

Q: I found this awesome model that would be a perfect fit for a DD item. Will you include it?
A: I will not put in anything in DD that doesn't support CBBE Bodyslide. The model AND the sliders obviously also need to come with permissions to freely include and distribute it in 3rd party mods. If it does, feel free to suggest it!

 

Q: How can make this mod not ever hide the PipBoy? I want to use my own PipBoy hider mod!
A: Set DD_PipBoyAlwaysHide to -1. This will completely disable the hider feature. Warning: Some restraints will look extremely silly with the PipBoy not hidden. Use this only if you have the PipBoy permanently hidden by another mod and do NOT use this setting when DD's hider feature is currently active.

 

Q: Where can I get the items in game?
A: There is a vendor in Goodneighbor, in the Memory Den. She can sell you restraints and (standard) keys. Her name is Kimy!

 

Q: Can I craft the items?
A: Yes! Make a restraint workbench (found in the workshop menu)

 

Q: Can I craft keys?
A: No. Kimy (the NPC) can sell you standard keys. But she knows how desperate locked-up people are to get their hands on a key, so her prices might be a tad obscene.

 

Q: Will DD integrate with FourPlay?
A: While DD content mods might want to be able to trigger sex scenes to enhance their quests, the framework itself has limited reason to. The biggest use-case is providing a means to pick restraints-aware animations for scenes (so that these chastity belts actually prevent what they are meant to prevent), but FP is not yet stable enough to consider adding it as a dependency. I also want to keep DD F4SE free, so I will probably be looking for ways to link to it as a soft dependency or through an add-on.

 

Q: Will this mod ever support another body than CBBE Bodyslide?
A: That's very extremely unlikely. The Skyrim body wars still haunt me, and I am not keen on a reprisal. Unless another body completely takes over the market in the future, I will not even think about it. And I hope none ever will. CBBE is good enough and supports pretty much any imaginable body shape through Bodyslide. There is zero reason for more body mods, really.

 

Q: How about physics support?
A: In contrast to Skyrim, no single physics mod has currently achieved high enough popularity/support to warrant supporting it. Once this changes and physics-supported gear becomes widely available, it will be considered.

 

CREDITS AND THANKS


What's New in Version 2.0

Released

  • Version 2.0
  • NEW SAVE GAME OR CLEAN SAVE GAME REQUIRED!
  • - Added: Device modding/crafting (contributed by AG12). Players can now craft and mod DD devices at workstations. (Note for modders: As a consequence of the new system, color mods have to be added at design time when putting items into containers!)
  • - Added: Manipulate Device dialogue. When voluntarily equipping a device, you can now manipulate it so that you can remove at any time. This feature does not work for non-generic devices (e.g. quest or custom devices). The item creator can also disable it for their generic devices, if they so choose.
  • - Added: Difficulty modifier! You like bondage, but don't want to spend half your life in chains? Or think they are not nearly punishing enough? Rejoice! The new global variable DD_Config_DifficultyModifier lets you adjust the escape system to your liking and will affect many settings with just one simple control! Decrease the value for higher difficulty and increase it to lower it. The default value is 4 (which results in a modifier of 1.0 and will use the settings as defined for the device). Do not set this variable to higher than 9 or lower than zero. The maximum range of the multiplier is +/- 75%. Mind you that this feature still doesn't let you completely disable any particular feature of the escape system. Also, it will not be applied to quest and non-generic items unless their creator specifically enables it for that device.
  • - Added: A minigame for lockpicking (also contributed by AG12). Set DD_Config_lockPickSystem to 1 to enable it, or to 0 (default) to continue using the RNG based system.
  • - Fixed: Device manipulation will no longer leave zombie scripts baked in the savegame.
  • - Fixed: NPC support now -really- works.
  • - Fixed: The gag sounds should no longer stall the engine.
  • - Fixed: When using the device dialogue, the item will no longer get marked as unequipped, depsite it's still worn.

×
×
  • Create New...