ForgeSkin
Applies ForgeSkin packs (textures, attachments, live ammo screens, animated layers) to your own weapons.
| Date uploaded | a day ago |
| Version | 1.0.0 |
| Download link | NAinfini-ForgeSkin-1.0.0.zip |
| Downloads | 12 |
| Dependency string | NAinfini-ForgeSkin-1.0.0 |
This mod requires the following mods to function
BepInEx-BepInExPack_GTFO
BepInEx pack for GTFO. Preconfigured and includes Unity Base DLLs.
Preferred version: 3.2.4NAinfini-ForgeCore
Public GTFO mod foundation: asset bundles, logging, settings, pools, networking, input leases, local saves and calls into the game's own systems.
Preferred version: 1.0.2README
ForgeSkin

- Skin editor (Windows): download the installer (
Setup.exe) from https://github.com/NAinfini/GTFO-Forge-Mods/releases/latest - Source code: https://github.com/NAinfini/GTFO-Forge-Mods
- Skins: each skin is its own mod. Install skin mods from Thunderstore, or make your own with the editor.
皮肤编辑器(Windows)下载:https://github.com/NAinfini/GTFO-Forge-Mods/releases/latest 里的安装包 Setup.exe。源码:https://github.com/NAinfini/GTFO-Forge-Mods。
皮肤是单独的模组:在 Thunderstore 上装,或用编辑器自己做。
Applies ForgeSkin weapon skins to your own gear in GTFO: replaced textures and materials, models mounted on the gun, live screens (ammo, kills, damage dealt and taken, accuracy, health, infection — as digits or a bar), animated layers, flashes and sounds played on game events (kill, hit, miss, fire, reload, aim, low ammo, empty, going down, revived, ...; several sounds on one event play one at random, and kills can have their own sounds per enemy), and a custom part layout. Skins can also hang charms on a cord or chain that sway with gravity and swing as you move (on the gun in your own hands).
Character skins replace your whole character with an imported humanoid model. It moves with the game's own animations (walking, running, crouching, jumping, holding the gun, going down, being revived), its hair, skirt and ribbons swing as you move, and in first person you see the model's own arms; where you can be hit stays the original character's. The lobby figure wears it too.
You normally don't install this by hand: skin mods made with the ForgeSkin editor list it as a dependency, so your mod manager installs it with them.
Please also update ForgeCore to 1.0.1 (请同时更新 ForgeCore 到 1.0.1).
Get skins, make skins
Forge provides the editor and this base mod; the skins themselves are mods their authors publish on Thunderstore.
- Get skins: find skin mods on Thunderstore and install them with your mod manager, like any other mod (they list ForgeSkin as a dependency), then pick them in the lobby with the SKINS button.
- Make or change skins: the ForgeSkin editor, for Windows. Download the installer (
Setup.exe, updates itself) or the portable zip from the latest release: https://github.com/NAinfini/GTFO-Forge-Mods/releases/latest. Its built-in tutorial (the book button) walks through a first gun skin and a character. - Share skins: in the editor, Export → Export as Thunderstore skin mod… makes a zip ready for Thunderstore; upload it there yourself. Teammates see your skin once they install that mod.
- A single skin file: a
.forgeskinsomeone sent you goes intoBepInEx/ForgeSkin/skins/of your profile. - Source: https://github.com/NAinfini/GTFO-Forge-Mods.
下载编辑器:https://github.com/NAinfini/GTFO-Forge-Mods/releases/latest (安装版 Setup.exe 会自动更新,也有免安装 zip)。
皮肤由作者各自发布在 Thunderstore,用模组管理器安装;自己做的皮肤在编辑器里点 导出 → 导出为 Thunderstore 皮肤模组…,
再自己上传到 Thunderstore。单个 .forgeskin 皮肤文件放进档案的 BepInEx/ForgeSkin/skins/。装好后在大厅点 SKINS 选用。
Screenshots

Your skins show on your gear: in your hands, on a sentry or mine you placed, on the magazines your gun drops, and on pickups lying in the level whose item has a skin (they keep it when you pick them up). Teammates who have the same skin mod installed see the character, skins, colours and adjustments you picked, and you see theirs; their skin's shot, wield and down/revive sounds play at their gun. A teammate's gear whose skin you don't have (or have in another version) keeps its original look, and the skin picker says which mod to install. Bots' guns and teammates' mines keep their original look.
In the lobby, the SKINS button opens the skin picker: choose a character and a
skin for each gear, or the original look (a gear with several skins installed lists them all, each with the preview picture
its author exported with it; a pack from an older editor shows none until it is exported again), and recolour the skin's
player colours with one of the author's colour schemes or a row of hues. Your choices are kept in BepInEx/config/ForgeSkin.choices.json and ForgeSkin.colours.json. Skin packs go in
BepInEx/ForgeSkin/skins. Skins installed by the editor of ForgeSkin 1.1.0 or earlier are still in
BepInEx/plugins/ForgeSkin/skins, which the game no longer reads: open the editor once and it moves them over (the game's log
says so while skins are left there).
Settings
BepInEx/config/ForgeSkin.cfg. Enabled, HologramShader and Toon are also behind the gear in the skin picker's title bar
(Show skins, Game hologram effect, toon rendering); a change there applies at once and is saved to this file.
| Setting | Default | Meaning |
|---|---|---|
Enabled |
true | Turn off to apply no skins (your picks and colours are kept) |
Development |
false | For skin mod authors: also reload skins whenever a skin mod in the plugins folder changes, and write every detail to BepInEx/ForgeSkin/forgeskin.log (the skins folder is always followed) |
Readback |
false | Write each gear's vanilla part poses to BepInEx/ForgeSkin/readback/ for troubleshooting |
HologramShader |
true | Draw holograms with the game's hologram shader; off uses a plain glow |
Toon |
Deferred | How a character's toon materials are drawn on your screen only: Deferred lit by the game and seen by the thermal sight, Forward a cleaner toon look the thermal sight does not see, Off like every other material |
Errors go to BepInEx/LogOutput.log, each with a code.
CHANGELOG
Changelog
1.0.1
Needs ForgeCore 1.0.2. In multiplayer the host and every client should update ForgeCore: a client's kills come from the host's ForgeCore.
- New: character models that are not a whole human. A creature without fingers, with one arm or leg, or with unlike sides now works as a character skin: only its hips need a bone. A part without a bone keeps its shape and moves with the part above it, a hand whose arm is incomplete does not reach for the gun, and a model without both upper arms shows the game's own arms in first person. A pack made this way needs ForgeSkin 1.0.1 or later.
- New: sight reticles. A gun skin can replace the reticle in a holographic sight's lens, up to three picture layers, each with its own colour, strength, size, depth and on or off. Only you see it, when you aim down the sight. A skin with a reticle needs ForgeSkin 1.0.1 or later.
- New: inspect your weapon. Press the inspect key (I by default; change it under Forge mods on the game's key settings page) with a gun in your hands, skinned or not, to turn it over and look at it, then bring it back. Each kind of gun has its own motion: pistols, revolvers and compact guns are turned over in the hand, and a revolver spins twice before it goes back; rifles, shotguns, machine guns and snipers are turned with both hands. Firing, aiming, reloading, melee, using, sprinting, opening a menu or being hit ends it, and nothing you press is held back. Teammates see your wrist turn the gun. Known issue: rifles, shotguns, machine guns and snipers are held badly while their right side is shown; this is fixed in a later version.
- Fixed: on a client, kill and damage screens, kill sounds, Kill and Hit flashes and wear with kills counted nothing. They now show in the frame of your hit and are corrected when the host's result arrives (a kill that did not happen is taken off the screen); wear with kills follows the host's result only.
- Fixed: on a client, Miss flashes and the accuracy screen judged most hits as misses; they now follow your own shots, the same as on the host.
- Fixed: a teammate's character skin turned flat pink once the level started.
- Fixed: after joining a lobby that others were already in, everyone in it, you included, stood in their original look until someone changed a skin. Character skins now go on as soon as each figure appears.
- Fixed: hologram rings on your gun (such as Critical Line's) were drawn in the middle of the screen while you danced or did another action seen from behind.
- Two skin packs with the same skin: the newer file is used, and the log says where both are.
1.0.0
First release on Thunderstore. Needs ForgeCore 1.0.1, which the mod manager installs with it. Skins are separate mods that depend on this one; install them from Thunderstore or make your own with the ForgeSkin editor.
- Weapon skins on your own gear: replaced textures and materials (precompressed in the pack, so a skin goes on without a stall), models mounted on the gun or replacing its parts, charms that swing on a rope or chain, live screens (ammo, kills, damage dealt and taken, accuracy, health, infection), animated layers, code effects drawn live, holograms, wear stages, and flashes and sounds on game events (kill, hit, miss, fire, reload, aim, low ammo, empty, going down, revived, ...; kill sounds per enemy).
- What you leave in the world wears your skin too: the sentry and mines you place, your gun's dropped magazines, and pickups whose item has a skin.
- Character skins: replace your whole character with an imported humanoid model. It moves with the game's own animations, the original character is hidden, and where you can be hit stays the original's. Hair, skirts and ribbons swing and rest against the body; in first person you see the model's own arms. Each player chooses how toon materials are drawn on their screen (
TooninForgeSkin.cfg). - The SKINS picker in the lobby (button or rebindable key, English and Chinese): gear and character slots, skin cards with the picture each pack carries, colour schemes and player colours, the adjust page for what a skin lets you change, and the settings behind the gear in its title bar.
- Teammates who have the same skin pack see the skin, colours and adjustments you picked, on your gear and your character, and you see theirs; gear whose skin they do not have shows its original look, and the picker says which Thunderstore mod to install. With ForgeReplay, replays show each player's skins.
- Skins come from skin mods in the plugins folder (a
forgeskin.forgefile lists their packs), from the skins folderBepInEx/ForgeSkin/skinsthe editor installs into (followed while the game runs), and from other plugins throughSkinPacks.Register. - Errors are written to
BepInEx/LogOutput.logwith a code each;BepInEx/ForgeSkin/forgeskin.logis what the editor reads after "Apply to game".