Footprints

- Custom player footprints (Local only)
To enable custom footprints, check the `Custom footprint texture` checkbox and configure the `Texture width` and `Texture height` in the settings to match the dimensions of your texture file. Save the settings and restart your game.
Next, navigate to the mod folder and replace the texture in the following path with your custom file:
`assets/footprints/textures/decals/custom-png`

- Partial Server-Controlled

If the server config `Broadcast configs to client` is enabled, the server will broadcast the configuration settings to the client, which will override the client’s local settings.
By default, the client automatically accepts the configuration shared by the server. However, the client can opt out by unchecking the `Accept server configuration` setting.

- Custom Materials Whitelist:
Technically, the whitelist uses `.startsWith` on the block code . For example, a simple value like `soil` will include all soil types, while something like (`soil-low-none`,`soil-medium-none`,...) would result in a more natural result (only on dirt without grass). It's a bit tedious but allows full customization, even with modded blocks, while keeping performance higher than with RegEx.
This is commonly used for quick compatibility with other mods such as Terrain Slabs, which require adding "terrainslabs:" to the list.

- Custom Animals Whitelist:
The Custom Animals Whitelist operates similarly to the Materials Whitelist but applies to entity codes.

(400+ animals with default settings)
I started to notice significant fps drop at >60k prints in memory and 20k visibles. Default values are 30k and 5k.

-------

Low FPS / Performance Issues: Here is a list of configs (rendering tab) that might help improve performance:

• Low resolution: Reduces the size of the texture by about x2 (From ~10x10 to ~6x6 px).

• Rendering distance: Reduces the range of visible prints.
• Max footprints: Reduces the total footprint count in memory (no new prints generate once the limit is reached).
• Max visible: Reduces the amount of textures rendered. Best for dense areas like barns or multiplayer villages.
• Sneaking/Crouching Mode: Limits rendering to only when crouching. Useful for saving performance when not hunting.

-------

Where to edit the configs: You can adjust settings via the in-game menu (requires ConfigLib & ImGUI; a new button appears in the Escape Menu) OR manually edit the JSON file: VintageStoryData/ModConfig/Footprints-....json

• Footprints-Client: Only affects your local game.
• Footprints-Server: Affects all players in multiplayer (and acts as Client for you in singleplayer).

-------

Gray/White Textures or Visible Squares/Rectangles: Usually caused by missing assets or shader/driver issues.

• Missing textures: Reinstall the mod.
• Shader issues: Your GPU may not support the shader. Try updating your drivers and or switching your rendering source if your pc components support it.

-------

Missing Specific Textures:

• Check if the entity is included in the whitelist config. (If you use the whitelist feature)
• If modded, verify if the entity from the mod is listed as compatible.
• Mod updates can break compatibility patches. Check logs for "Footprints" and "patch" warnings/errors.
• Enable "Debug Logging", for details keep reading "Missing Textures (Nothing visible)" below.

-------

Missing Textures (Nothing visible):

• Check configs or reset them.
• Enable "Debug Logging" and wait a few seconds. A grid of textures should appear near the player, and a diagnostic log will generate. Share the logs and your modlist if the issue persist.

-------

Visible Prints Through Fog: Known issue, often worse with high sea levels, fog mods, or shader mods. No full fix currently, but the effect should remain limited.  Fixed in v1.2.4