Launcher

Scripts

Patchwork supports multiple formats of code extensions.

• DLL, bepinex and IPA contract, more on this topic here
• Plain C# code script using custom event/trigger dispatch

Script path specifies all the places where to look for scripts and DLL plugins. Scripts can be enabled/disabled at game run time. At game run time, DLLs can be only re-enabled if previously disabled before game launch.

Mods

Mods are loaded from patchwork/mod folder, with each mod having its own folder for abdata file structure.

No distinction is made between normal or zip mods as both are pretty much the same.

Load mods from abdata

This enables loading of "hardmods" from Koikatu/abdata/. It is advised to keep this off, and let the unzip script convert any hardmods from there into a softmod which will be put into Koikatu/patchwork/mod/abdata. You can then edit that copy like any other mod without affecting your vanilla install which depends on the Koikatu/abdata folder.

Unsafe mods

Safe mods are ones which replace .unity3d files contents in full - those work properly as dependency reference as the original AB is never loaded (ie as if it were a hardmod). Most of mods you encounter are safe.

Unsafe mods are those which override core game asset bundle (such as oo_base) only partially, and as such can't serve as dependency reference for other bundles. As the name implies, unsafe mods may introduce glitches. This happens more frequently in patchwork as opposed to vanilla game, as most assets are now loaded out of order and in parallel increasing the likelihood of broken dependency chain. Vanilla game loads most of these assets sequentially and can survive more abuse from unsafe mods.

Logging

Log output is in Koikatu_Data\output_log.txt.

Trace should be always enabled, spam logging increases verbosity.

Performance

• Lazy asset GC - delay removing of assets and other objects from memory for as long possible, retaining those in cache (faster loads of same model). Faster load times, at the expense of higher memory use.
• Lazy GC - delay general heap garbage collection as long as possible. Faster load times, at expense of higher memory usage.
• Async chara maker loading. Load chara maker first, and then mods in the background. Some list entries wont show mods until all are loaded. Disable if you encounter glitches in maker.
• Async animation loading. Load character animations all in parallel instead of sequentially. Disable if you encounter animator glitches (characters spawn in a tpose, don't move, or don't show up at all).
• Cache scripts to disk. Faster startup times.
• Cache mod metadata. Faster startup times, but can be unstable. Delete patchwork/cache if you encounter stale metadata problem, or just keep this disabled.

HiPoly overworld

• Spawn high poly characters on school grounds. High resource usage. You should disable low poly talk scenes in conjuction with this.

H rendering

• Sync o_mnpb - set female private parts to body painted texture (main & sub color).
• o_mnpb hide - no special meshes for private parts, instead assume full body female decensor
• Sync o_dankon - set male private parts to body painted texture (main & sub color). Assumes main body texture is accounting for this, or you'll get distorted result.
• No telescope - disable telescopign "accordion" for most H positions

Clip masking

Without telescoping, dick can now clip through body in H. To prevent this, you can enable and configure alpha mask which automatically hides the part of the texture before it would show clipped. The values are generally different for each decensor, as it depends on UV mapping.

To do this, open male character in chara maker and make it naked, and enable Simulate checkbox - this will animate extend-retract texture mask as it would do according to animation clip time in H.

Now set scale very high or low - like 16 or 0.25. You should get a checkerboard pattern which illustrates how the mask window moves. Now you want to tweak x and y so that checkerboard tile moves only in horizontal direction. Finally you figure out scale so that one checkerboard tile moves onwards/towards whole dick, masking it and revealing it as a whole repeatedly in horizontal direction - from balls to tip.

Custom uncensor

Here you can set base body files (ie uncensors) separately for gender. The files can be both in abdata or mod folder, what is set is simply the name the game normally looks for, and further filename resolution is done as usual.

Misc

• On top -
• Disable Launcher (edit patchwork.xml to restore) -
• (bench) replace all character textures with a white dot -
• Fast exit -

Dyn bone physics

• loop -
• reflect -
• divisor -
• rate -

Painted texture sizes

Body and face textures are painted from main color and subcolor, and then various tatoos, eye texturs, clothing textures and so on are layered on top of it to form the final texture which is ultimately used by the game.

This changes the size of the substrate texture stuff is being painted on. If you have high resolution body, face or clothing textures, you may need to increase the resolutions in here accordingly to prevent the high res texture paint being downscaled when painted on a base texture too small.

Override postprocessing

Enabling this hard-sets camera effect according to fields you have checked. Whatever else game configures is disregarded if this option is enabled.

Override hair shadows

Most hair have a blue shadow tint. This setting sets the shadow color to that of base hair. Strength is base shadow strength and limit is clamp to avoid having dark areas too dark.

This is a global setting, but there's also a (default off) per character setting in hair section of the maker. If per-character setting is used, the global launcher setting will be ignored.

Recalculate bust normals

The game ignores normals of the model for bust and recalculates its own at runtime from monob parameters. The setting should disable those and keep the original of the model. Work in progress / may be broken.