Compatibility and Troubleshooting

Compatibility and Troubleshooting

Updating the mod

• Back up important worlds and configuration directories first.
• Existing published scp_additions registry IDs are retained where required for old-world compatibility.
• Intermediate animation blocks remain registered so old saves resolve them, but they are hidden from creative tabs.
• Existing customized configuration files are never automatically replaced.
• Removed pre-3.0.7 SCP-294 drink registry items are remapped to the configurable generic cup when old worlds are loaded. Legacy drink definitions are normalized without losing their configured IDs, colors, aliases, effects, actions, delays, or messages.

Missing optional mod content

Configuration entries may reference optional mods such as scpo. If an item, entity, effect, sound, or particle ID is unavailable, the affected entry is skipped and reported while unrelated entries remain active.

Malformed resource IDs are different: they invalidate the reload and keep the previous active configuration.

Multiplayer configuration differs from local files

From 3.0.7 onward, the connected server is authoritative for supported gameplay settings. A client receives the host's synchronized rules on login and after supported save, delete, and reload operations.

This does not overwrite the client's local JSON files. The synchronized host snapshot is cleared on disconnect, so later single-player worlds or other servers do not inherit it.

If a value appears stale while connected:

1. confirm that the operator saved or reloaded the server configuration;
2. reconnect the affected client;
3. check the server log for validation errors or unavailable registry IDs;
4. test without client-only copies of old SCP Additions configuration files being edited at the same time.

Disabling natural roamers

Set 173spawn or 106spawn to false to stop new natural encounters. This pauses future spawn scheduling but does not remove an instance that is already loaded.

Use /despawnRoamer scp173, /despawnRoamer scp106, or /despawnAllRoamers to remove active roamers. /disableAllRoamers disables both spawn gamerules at once.

Regenerating defaults

Close the game/server, back up the relevant JSON and .bak, delete only the file to regenerate, and start the installed version again.

Do not delete 914recipes.d, Codex world assets, or the entire configuration directory unless those customizations are disposable.

Codex image or text does not appear

1. Reopen the document editor and confirm World image attached or world text attached.
2. Press Save Document or Save & Give Test Item.
3. Confirm the document remains in the configuration list after reopening it.
4. Check the world's scp_additions/codex_assets directory.
5. Confirm the image is PNG/JPG/JPEG, at most 2.5 MB, and no larger than 4096×4096.

Unique generated documents must be created from the Codex editor. Do not assign CODEX through a generic item rule.

SCP-914 skins do not render in multiplayer

The server synchronizes only the filename. Every relevant client must have the same PNG filename in config/scpadditions/scp914_skins and install Kleiders Custom Renderer API.

Missing textures or animated-door lag in a modpack

First test the same SCP Additions JAR in a minimal instance containing only:

• Forge;
• GeckoLib;
• SCP Additions.

If the issue disappears, add other mods back in groups until it returns. Rendering, shader, connected-texture, particle, and optimization mods are the most relevant groups for missing models, missing textures, or unusually expensive animated blocks.

For a missing texture, reproduce the issue and immediately inspect latest.log for messages containing:

Unable to load model
Using missing texture
FileNotFoundException
scp_294
scp294

For door or Decontamination Checkpoint lag, report whether it changes between Survival, Creative, standing still, moving through collision, and disabling shaders or particle/rendering mods.

For editable sign text that is missing, verify the same sign without shaders or resource packs and report which wall face it is attached to. Include a front, side, and rear screenshot so depth, face orientation, and font rendering can be distinguished.

Configuration save fails on Windows

The mod uses backup creation, atomic replacement where available, retries, and a safe fallback. If a save still fails:

• confirm the file is not read-only;
• close external editors holding the file;
• verify write permission for the instance directory;
• preserve the .bak before manual recovery.

Reporting a bug

Use the GitHub issue tracker and include:

• SCP Additions version;
• Forge and GeckoLib versions;
• complete mod list;
• exact reproduction steps;
• latest.log and crash report when applicable;
• screenshots for visual or interface problems;
• whether the issue still occurs in a minimal Forge + GeckoLib + SCP Additions instance.