Home

PleasureLib

PleasureLib is a small UE4SS Lua helper library for Gothic 1 Remake mods. It centralizes generic, defensive code that multiple mods can share without depending on any one mod's behavior.

Current version: 0.5.0

What it provides

• Per-mod runtime instances with consistent logging and error handling
• String, boolean, list, and INI helpers
• Safe text-file reads, writes, and single-value INI updates
• Defensive Unreal object validation, lookup, and runtime capture
• Delayed game-thread callbacks and protected UE4SS hook registration
• Localized native Bool, Int, Float, and Enum settings on a dedicated Settings -> Mods page

Start here

1. Install PleasureLib.
2. Follow Getting Started to use it in a mod.
3. Add the Recommended Loader so the mod does not depend on mods.txt load order.
4. Browse the Core Utilities API or the Unreal and Runtime API.
5. Add native mod options with Native Game Settings.

For complete examples, see Recipes. If something does not load or a helper returns nil, see Troubleshooting.

Design goals

PleasureLib deliberately stays small and generic. A helper belongs here when it is reusable by multiple mods and can remain defensive around UE4SS and Unreal objects. Mod-specific gameplay behavior belongs in the consuming mod.

Source and issue tracker

• Source repository
• Issue tracker