Devious Devices - Contraptions 1.5b

Devious Devices: Contraptions
 
ABOUT
 
Devious Devices - Contraptions is the furniture component of the Devious Devices framework. It provides a variety of bondage furniture for use in BDSM themed mods, and provides mechanics for using the devices in game. Device behavior can be freely configured by the modder, and without having to write code or handle complicated packages. The devices are fully compatible with DD restraints, without modders having to write complex workarounds on their end.
 

CONTRIBUTORS
 
Kimy
Supertin
T'ara

CORE FEATURES
 
- Both players and NPCs can use the furniture.
- Actors can be placed and released from devices via script.
- Hotkey to order arbitrary NPCs into furniture, where they can be either locked in, or held for a certain amount of time, at the player's discretion!
- Hotkey triggered dialogue for the player to lock up herself, either to play for a certain amount of time, or with fully engaged locks for extra kink!
- Locking system (requiring one or more keys to release the subject), including optional configurable lock shields preventing unlocking the device for a given time.
- Escape system for both player and NPC. Devices can be struggled out from, lock-picked, or even broken. The player can help NPCs to escape with not in posession of a key, in which case the player performs the escape checks for the NPC.
- Configurable escape difficulties and cooldowns per device.
- Devices are fully compatible with DD restraints. No workarounds needed. Each furniture device can be set to allow any type of DD restraint to be worn while locked in it. Incompatible restraints will be hidden.
- Alternate poses can be set to accommodate DD wrist restraints (e.g. for wearing armbinders while sitting on a wooden horse)
- Arbitrary number of additional scripted effects the device will apply to subjects locked in it.
- Configurable messages per device.
- Outfit swapping for NPCs, stripping for players, plus re-equipping gear on release.
- Arbitrary number of poses per device, one of which is randomly chosen or set by script.
- Struggle animations played both periodically and when trying to escape.
- NPC poses survive cell changes.
- The player cannot wait/sleep if the device doesn't allow it.
- Self Bondage feature, allowing the player to set a timed lock, both for herself or any NPC she locks in the device.
- Optional minigame that rewards the player with configurable rewards if she escapes the device before the release timer sets her free.
- Build-able devices, that can be placed in the game world by the player during a playthough.
 
 
REQUIREMENTS
 
- SexLab
- SexLab Aroused
- Devious Devices Assets
- Devious Devices Integration
- Devious Devices Expansion
- any requirement of the above mods, such as FNIS, XPMSE etc. Please refer to the respective mods for details.
 
 
INSTALLATION
 
1. Install ALL requirements listed above using your favorite mod manager, including THEIR respective requirements.
2. Install this mod.
3. Run FNIS when done
 
 
PERMISSIONS
 
Anyone who wishes to use this mod as a dependency for their own work is quite welcome to. The following rules apply:
 
- You can NOT bundle/re-distribute any part of this mod with your own (e.g. include patched versions of the scripts in your mod), as future updates to DD might break your and other mods if you do
- You can NOT post this mod or any of its parts (including any derived works) outsides of LL without explicit permission.
- You can NOT incorporate any parts of this mod 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 parts of this mod in a project that's going to be uploaded to Bethesda.Net and/or made available for consoles in any other way.
- You can NOT use any parts of this mod in a closed source project. No exceptions, ever. No need to ask for permission either. It won't be given.
- You can NOT publish a fork of this mod (as in using it as a base for a project offering similar functionality) without permission. That includes porting it to other platforms/games.
- You can NOT use any code or assets from this mod in projects competing with it, without permission.
- You can NOT redistribute, repackage, or upload any art assets from this mod without permission. Please contact the artist(s) directly for any inquires.
- You CAN otherwise use 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!
 

In plain English: Do with my code what you want, as long as you credit me, and your own project is also open source and available free of charge. But don't use my own code to make mods competing with mine, don't change my mod's behavior against my will, and don't steal my stuff by uploading it somewhere else.
 

CONTRIBUTION LICENCE
 
Contributions to DD are welcome! If you are considering contributing, here are our guidelines for your consideration:
By contributing assets or code to this project, you grant the DD team represented by its lead maintainer a non-exclusive, non-revokable, and non-transferable licence to use your assets without limitation in Devious Devices or any other projects, provided that proper credits are given. You still retain full rights to your work. Everything you create is still yours. Instead of this licence, you may also opt to place your work under an alternative licence compatible with the above, such as Creative Commons or MIT (it cannot be more restrictive, though!) In the later case, we will mark your work as subject to the licence you chose.

CREDITS
 
Code by Kimy
Models and animations by Supertin
Additional models and animations were imported from ZaZ Animation Pack Version 7, with permission and T'ara's help!
 
KNOWN ISSUES
 
- The furniture object will display a slight flicker when transitioning back and from the struggle animation.
- The NPC interaction key is currently hardcoded to PgUp, as DDC does not yet have its own MCM.
 
 
FREQUENTLY ASKED QUESTIONS - USERS
 
Q: How to best report any issues with this mod?
A: Post your issue in the support thread and describe what happened, and how. In enough detail that we might have a chance to understand what went wrong there. Oh, and post a Papyrus log if you can. While we might be able to guess the cause of your problem every now and then, chances are that we will never find out what went wrong unless you provide me with the log. DO NOT PM THE DD TEAM WITH SUPPORT REQUESTS!!!
 
Q: I have this and that problem with an older version of this mod.
A: Please don't ask about older versions. Ever. We 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. We 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: Can I suggest new features?
A: Absolutely! We have implemented a lot of user-suggested features and will continue doing so. But please understand that we cannot implement them all and that some others we really just won't like enough.
 
Q: Does this mod support male character?
A: The devices should work for either male or female characters, but are primarily designed for females.
 
Q: Can I translate your mod?
A: Yes. But please re-post only the files needed for the actual translation (e.g. localized ESM, string tables etc), as a patch with a link back to the official mod! Do NOT re-distribute the entire mod. If you want to post the translated files outsides of LL, please ask for permission first.
 
Q: I found this awesome model that would be a perfect fit for this mod. Will you include it?
A: The model needs to come with permissions to freely include and distribute it in 3rd party mods. If it does, feel free to suggest it!
 
Q: Where can I find the devices in game?
A: DDC itself does not place any devices in the game world. It is a library of furniture bondage devices and mechanics related to them, meant for modders to create content with. You will need mods actually using the framework.
 
Q: How do I escape a device when locked in one?
A: Press the key you mapped to activate world objects to call the device dialogue.
 
Q: How do I lock a NPC into a device?
A: The hotkey is currenty hardcoded to PgUp. Focus the NPC, press PgUp, then focus the desired device, press PgUp again.
 
 
FREQUENTLY ASKED QUESTIONS - MODDERS
 
Q: Another furniture mod? Why should I use this mod and not something else?
A: DDC has been written from the ground up to complement Devious Devices and is the only furniture mod fully supporting DD wearable restraints. DDC's code is very powerful and flexible, offering many, many advanced features such as locking furniture, an escape system and even selfbondage!
 
Q: Where can I find documentation?
A: API Documentation can be found in zadclibs.psc (code comments within that file). Feel free to ask team members if you need assistance creating a mod using the resources provided by this mod.
 
Q: I want to place devices in the world, but use different parameters. How can I get this done?
A: Place a reference of the desired device in the game world, and change the script properties to your liking. You can even remove poses you don't want this devices to use. There is no need to duplicate the device in CK.
 
 
TROUBLESHOOTING
 
If you run into issues, please read the FAQ first. If this doesn't solve your problem, use the search feature: Most questions you're going to ask have probably already been answered. If you're still unable to find the answer to your issue, please post in the support thread proving a Papyrus log and an in-depth description about your issue to allow us to figure out what went wrong there and why. Do NOT PM maintainers with bug reports. Bug reports go in the support thread and only there! Bug reports not accompanied by a log and/or sent via PM will likely be ignored.