Skins
Modular skin support (no more replacing asset files!)
模組介紹 作者原文
Skins
Modular Skin Support for GTFO
English Documentation |
中文文檔 |
Repository |
Latest SkinGroup Editor Build
For feedback and issues, DM @uwufood OR the feedback thread on the GTFO Modding Discord Server
How to Use
- This mod is a library mod, which means it DOES NOT come with any skins by default. You can look at the [dependants
of this mod]( these are likely skin packs you can download.
- For alternative ways of installing/obtaining skins, please refer to the documentation.
- For creating skins packs (skin groups), refer to the documentation.
Documentation
- Everything you need to know about to use this mod to its full extent is included in the documentation.
- When in doubt, refer to the documentation. If you have any questions or suggestions, please don't hesitate to reach out to me on Discord.
Hot Reload
- Skins can be hot reloaded and take effect mid-game.
- Refer to the Reloading Skins section of the documentation for details.
- NOTE: The current version of the plugin might differ from the documentation slightly.
FAQ
- Q: Do I have to reinstall skins for each modded profile?
- Short Answer: No
- Long Answer: When a skin is installed as a mod (i.e., local mod, in mod managers), it is installed
under the per profile skins folder (/Assets/Skins). When the mod is first launched, it attempts to
move all per profile skins to the global skins folder which is shared across all profiles. If there are no complications, you
should only have to install skins once and they will be available for all profiles. The process is described here. If there are any issues, please shoot
me a message on Discord.
Attribution / Dependencies
Plugin
Libraries shipped next to Skins.dll (pure C# ports of nothings/stb by StbSharp, MIT):
- StbImageSharp
- Decodes skin PNG/JPG textures on worker threads.
- StbDxtSharp
- DXT1/DXT5 compression, so skin textures take roughly a quarter of the VRAM of an uncompressed upload.
SkinGroup Editor
- Electron / electron-vite, React, zustand
- The app itself.
- AssetsTools.NET and AssetsTools.NET.Texture (MIT), with AssetRipper.TextureDecoder
- Reading GTFO asset files and building asset bundles for the Port feature (for the bundled wrapper/util ExtractorCore).
- StbImageWriteSharp (MIT)
- Writes extracted textures out as PNG.
- classdata.tpk: Built by AssetRipper/Tpk (MIT) from AssetRipper/TypeTreeDumps and shipped unmodified.
- The Unity type-tree database that lets the above read release builds.
安裝與使用 安裝:按包內說明操作
- 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
- 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
- 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
- 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。
不同模組的安裝位置差異較大,包內說明是最可靠的依據。
下面這些內容需要先安裝,否則該模組不會生效: