Koikatu Maker Fullscreen Camera Fix

English: A BepInEx 5 plugin for Koikatu / Koikatsu Party that fixes camera ghosting / afterimage trails in the character maker (CustomScene) when you rotate or zoom the camera with the right mouse button. It forces the maker camera to render fullscreen and re-centers the character with a projection offset, so the original post-processing effects (Amplify Color, Bloom) are fully preserved.

搜索关键词 / Keywords: Koikatsu, Koikatu, Koikatsu Party, KKS, character maker, camera, ghosting, afterimage, trail, artifact, fullscreen camera fix, BepInEx, plugin, mod

修复 Koikatu / Koikatsu Party 捏人界面（CustomScene）在右键拉近、转动镜头时角色出现叠影“套娃”且不消失的问题。

原理

• 游戏捏人界面中主相机视口为 rect=(0.325, 0, 1, 1)、clear=Depth，并挂载 CustomRender / AmplifyColorEffect / BloomAndFlares 等多个 OnRenderImage。
• 子视口渲染走离屏路径时，CustomRender 的全屏 rtCamera 缓存与子视口 src 尺寸不匹配，镜头移动后旧像素残留在颜色缓冲，形成叠影。
• 本插件在编辑视图强制主相机全屏渲染，再用投影矩阵 m02 偏移把画面中心移回右侧面板，保留全部后处理特效，从根源消除尺寸不匹配。
• 保存 / 截图模式（saveMode）完全不干预，保持游戏原生小视口，保证拍出来的卡面与屏上一致。

安装

1. 关闭游戏。
2. 将 KoikatuMakerFullscreenCam.dll 复制到 BepInEx/plugins/。
3. 启动游戏，进入捏人界面生效。

配置

首次运行后生成 BepInEx/config/codex.kk.makerfullscreencam.cfg：

• Layout > Projection Offset（默认 0.325）：全屏渲染后把画面中心移回右侧面板的 NDC 偏移量。角色在面板中不居中可以微调此值。

行为

• 编辑视图：全屏渲染 + 投影偏移，无叠影，角色位于右侧面板。
• 空格隐藏 UI：全屏居中（原版 View 行为）。
• 保存 / 截图界面：保持游戏原生布局；拍摄界面屏上可能有叠影残留，但不影响最终保存的卡面 PNG（截图走独立全屏 RT 路径）。

兼容

• Koikatu / Koikatsu Party，BepInEx 5。
• 与 CameraFrameMask、KK_ChaAlphaMask 等插件共存测试正常。

版本

• v1.0.0：正式发布版。实时读取 saveMode / hideFrontUI 判定模式；保存模式零干预。