Skip to content

Compatibility and Troubleshooting

Jump to bottom
Bl4ues edited this page Jul 19, 2026 · 4 revisions

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.

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.

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.

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.

SCP Additions Wiki

Clone this wiki locally