SeamInk - Tattoo Baker for Skin Textures (Penumbra auto-load)

3Dの体に貼った透過PNGを、UVの継ぎ目をまたいで肌テクスチャへ自動で書き込むタトゥー作成ツール。Penumbraで使用中の体と肌を自動で読み込みます。
Place a transparent PNG on a 3D body and bake it into your skin texture, seamlessly across UV seams. Loads the body and skin you use in Penumbra automatically.

------------------------------------------------------------------
■ 日本語
------------------------------------------------------------------
SeamInk は、肌テクスチャにタトゥーを入れるためのツールです。

肌テクスチャは、体が「左右」「上半身と下半身」などいくつかの部品に分かれて並んでいます。
そのため、おへそ周りや背中の中心のように継ぎ目をまたぐ柄は、画像編集ソフトで描くと
部品ごとに分けて位置を合わせる必要があり、つなぎ目がずれがちでした。

SeamInk では、3D の体の上に透過 PNG を貼ってドラッグするだけです。
体の表面から逆算して書き込むので、テクスチャ上でどう分かれていても、柄はつながったままになります。

◆ できること
- Penumbra の設定を読んで、今ゲームで使っている体のモデルと肌テクスチャを自動で読み込み
（種族と性別を選ぶだけ。どの mod のどのファイルを使っているかも表示）
- 3D の体の上でドラッグして位置合わせ。サイズ・回転・濃さ・左右反転・単色化
- 複数のタトゥーの重ね合わせ、左右対称コピー
- 継ぎ目の外側まで色を広げて、ゲーム内でつなぎ目の線が出ないように処理
- 書き出し：ゲームでそのまま使える .tex（無圧縮・ミップマップ付き）／ PNG ／ タトゥーだけの透過 PNG
- タトゥーのない部分は、元のテクスチャから 1 ピクセルも変えません
- 配置の保存・読み込み（あとから続きを編集）
- 日本語 / English 切り替え

◆ 必要なもの
- Windows 10 / 11、Chrome または Edge
- XIVLauncher（Dalamud）と Penumbra
- 体と肌を mod で入れていること（バニラの体・肌には対応していません）
- Python 3.8 以上（https://www.python.org/downloads/ 、インストール時に「Add python.exe to PATH」にチェック）
- 起動時のインターネット接続（3D 表示用のライブラリを読み込みます）

◆ 動作確認済み
- 体：RueXB+（素材は YAB+）、肌：X-Body Skin Framework [4K] と RueXB+ 同梱の肌
- 体のモデル（.mdl）→ 素材（.mtrl）→ 肌テクスチャの順に Penumbra の設定からたどるので、
Bibo+ 系をはじめ、他の体・肌 mod でも動く作りになっています（すべての mod では確認していません）。

◆ 使い方（くわしくは同梱の README_ja.txt と、ツール内の「使い方」をご覧ください）
1. zip を展開し、Start_SeamInk.bat をダブルクリック
2. 種族と性別を選んで「読み込む」
3. 透過 PNG を追加して、体の上で位置を合わせる
4. 「合成テクスチャを .tex で保存」→ 表示された差し替え先のファイルと置き換え
（元のファイルは必ずバックアップしてください）

◆ 安全について
- 読み取り専用です。Penumbra の設定や mod のファイルを書き換えません（差し替えは自分で行います）。
- 通信は自分の PC の中（127.0.0.1）だけです。画像やファイルを外部に送ることはありません。
- ソースはすべて同梱の HTML / Python ファイルで、中身を確認できます。

◆ 制限
- バニラの体・肌には対応していません。
- 書き出す .tex は無圧縮なので、4K の肌だと 1 ファイル約 89MB になります。
- テクスチャ上でとても小さい部分（股間など）は、柄が少しにじみます。

◆ クレジット
- three.js（MIT License）
- フォント：Zen Kaku Gothic New / IBM Plex Mono（SIL Open Font License）

このツールは、最近我が家にやってきた猫「Claude」がキーボードの上を歩き、そのまま寝そべったところ、気づいたらできあがっていたものです。本人（本猫）いわく「キーボードの上が温かかったので」とのことです。仕様についてのご質問にはお答えできません。本人がまだキーボードの上で寝ているためです。
------------------------------------------------------------------
■ English
------------------------------------------------------------------
SeamInk is a tool for adding tattoos to your skin texture.

Skin textures lay the body out in separate pieces: left and right, upper and lower body, and so on.
A design that crosses a seam, such as one around the navel or down the middle of the back, has to be
cut up and lined up piece by piece in an image editor, and the joins rarely match.

With SeamInk you place a transparent PNG on a 3D body and drag it where you want it.
It works backwards from the body's surface, so the design stays continuous no matter how the texture is split.

◆ Features
- Reads your Penumbra settings and loads the body model and skin texture you currently use in game
(just pick your race and gender; it shows which file came from which mod)
- Drag to place on the 3D body; size, rotation, opacity, mirroring and solid-color recoloring
- Stack several tattoos, mirror a tattoo to the other side
- Pads color past the UV seams so no seam lines appear in game
- Exports a game-ready .tex (uncompressed, with mipmaps), a PNG, or the tattoo alone as a transparent PNG
- Pixels without a tattoo are left exactly as they were
- Save a layout and continue editing later
- Japanese / English interface

◆ Requirements
- Windows 10 / 11, Chrome or Edge
- XIVLauncher (Dalamud) and Penumbra
- A modded body and skin (vanilla bodies and skin are not supported)
- Python 3.8 or later (https://www.python.org/downloads/ ; tick "Add python.exe to PATH" when installing)
- An internet connection when it starts (it loads the 3D viewer library)

◆ Tested with
- Body: RueXB+ (with YAB+ materials); skin: X-Body Skin Framework [4K] and the skins bundled with RueXB+
- It follows body model (.mdl) -> material (.mtrl) -> skin texture through your Penumbra settings,
so it is built to work with Bibo+-based and other body and skin mods as well (not every mod has been tested).

◆ How to use (see README_en.txt and "How to use" inside the tool for details)
1. Extract the zip and double-click Start_SeamInk.bat
2. Choose your race and gender and press "Load"
3. Add a transparent PNG and drag it into place on the body
4. "Save texture as .tex", then replace the file shown under "Replace"
(always back up the original file first)

◆ Safety
- It only reads. It never changes your Penumbra settings or mod files (you replace the file yourself).
- Everything stays on your PC (127.0.0.1). No images or files are sent anywhere.
- All of the source is the included HTML and Python files, so you can check what it does.

◆ Limitations
- Vanilla bodies and skin are not supported.
- The saved .tex is uncompressed, so a 4K skin texture is about 89 MB.
- Very small areas of the texture (such as the crotch) come out slightly soft.

◆ Credits
- three.js (MIT License)
- Fonts: Zen Kaku Gothic New / IBM Plex Mono (SIL Open Font License)

This tool came into being when Claude, the cat who recently joined our household, walked across the keyboard and promptly lay down on it. By the time anyone noticed, it was done. When asked for comment, Claude (the cat) stated only that "the keyboard was warm." We are unable to answer any questions about its specifications, as Claude is still asleep on the keyboard.