Skip to content

Commit 2e9e5a6

Browse files
committed
Merge remote-tracking branch 'origin/docs/texmod-module'
2 parents 61067a6 + ffc1c7c commit 2e9e5a6

2 files changed

Lines changed: 39 additions & 0 deletions

File tree

site/src/content/docs/texmod.mdx

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
title: "Texture Mods (gMod)"
3+
section: features
4+
---
5+
6+
import ToolboxPath from '../../components/ToolboxPath.astro';
7+
8+
Toolbox can load texture replacement packs at runtime using a built-in [gMod](https://github.com/gwdevhub/gMod), so you no longer need to run TexMod or uMod as a separate program. Find it under <ToolboxPath steps={["Settings", "gMod/uMod/Texmod"]} />.
9+
10+
gMod itself is downloaded and kept up to date automatically into your Toolbox folder — there's nothing to install. The status line shows whether gMod is active, and the version row offers a manual **Check for gMod updates** if you want to force a re-check.
11+
12+
## Adding packs
13+
14+
Click **Add texture pack** and pick a file. Supported formats:
15+
16+
- `.tpf` and `.zip` — TexMod / uMod packs
17+
- `.dds` — a single replacement texture
18+
19+
Each pack appears as a row with a checkbox. Tick it to load the pack, untick to unload. Use the trash button to remove a pack from the list entirely, or **Unload all** to disable everything at once. Your packs and their enabled state are remembered between sessions.
20+
21+
## Load order
22+
23+
When two packs replace the **same** texture, the one **higher in the list wins**. Use the up/down arrows on each row to change a pack's priority — moving a pack up gives it precedence over the packs below it on any conflicting textures. Packs that don't overlap are all applied regardless of order.
24+
25+
## When changes take effect
26+
27+
gMod swaps textures as the game loads them. Textures already in memory for the area you're standing in are not re-evaluated immediately, so **a pack you load (or reorder) after entering a map may not visibly apply until the next map change**. Zoning into another area — or relogging — forces the game to reload its textures and your changes show up.
28+
29+
## Extracting textures
30+
31+
Expand **Loaded DirectX9 Textures** to capture the textures the game is currently using, so you can build your own replacements. Click **Record textures** to start collecting them as you play (this hashes every texture the game creates and will lower your framerate while active, so stop it when you're done). Click any captured texture to download it as `.dds` (for use in a gMod/uMod/TexMod pack) or `.png`. The hash shown is the gMod/uMod/TexMod texture hash you'll target in a pack.
32+
33+
## Notes
34+
35+
- Running the standalone TexMod or uMod programs alongside Toolbox can conflict — prefer the built-in gMod instead (see the [FAQ](/docs/faq/)).
36+
- If the status line shows gMod isn't active, make sure you have at least one pack added; gMod only loads once there's something to serve.
37+
38+
[back](./)

site/src/lib/nav.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ export const navGroups: NavGroup[] = [
6666
{ slug: 'audio_settings', label: 'Audio Settings' },
6767
{ slug: 'text-to-speech', label: 'Text-to-Speech' },
6868
{ slug: 'theme', label: 'Theme' },
69+
{ slug: 'texmod', label: 'Texture Mods (gMod)' },
6970
{ slug: 'reroll', label: 'Reroll' },
7071
{ slug: 'integrations', label: 'Integrations' },
7172
{ slug: 'input_modules', label: 'Input' },

0 commit comments

Comments
 (0)