# forge.cfg — companion notes

Source: ported from 1.7.10 server (`industrial-server/legacy-reference/config/forge.cfg`) on 2026-04-25.

## Scope

Forge's config file is large and most keys are sensible defaults that don't need overriding. We only port fields that diverge from 1.12.2 stock behavior.

## What was kept (ported)

| Field | Legacy value | Default | Reason |
|---|---|---|---|
| `disableVersionCheck` | `true` | `false` | Suppresses Forge's HTTP version-check ping on every boot. Server-side preference. |
| `removeErroringEntities` | `true` | `false` | Anti-crash net — drop a broken Entity rather than crash the server. Mandatory on heavy modpacks. |
| `removeErroringTileEntities` | `true` | `false` | Same as above for TileEntities. A single bad TE in a chunk would otherwise hard-crash on every world load. |
| `fullBoundingBoxLadders` | `true` | `false` | Required by some mod-added climbables (ropes, custom ladders) on the legacy pack. Keep enabled unless investigation finds it breaks something on 1.12.2. |

## What was dropped

| Field | Legacy value | Why dropped |
|---|---|---|
| `clumpingThreshold` | `64` | Default in 1.12.2 (range 64–1024), no override needed. |
| `sortRecipies` | `false` | Default in 1.12.2. |
| `biomeSkyBlendRange` | `[2..34]` | Default array values, no divergence. |
| `zombieBaseSummonChance` | `0.1` | Default in 1.12.2. |
| `zombieBabyChance` | `0.05` | Default in 1.12.2. |
| `defaultSpawnFuzz` | `20` | Default in 1.12.2. |
| `spawnHasFuzz` | `true` | Default in 1.12.2. |
| `enableGlobalConfig` | `false` | Default in 1.12.2. |

## Risks / things to double-check after first boot

1. **`removeErroringEntities=true`** — silently masks bugs. If we see `[FML/]: Removing entity` spam in logs, investigate root cause; do not just leave it forever.
2. **`fullBoundingBoxLadders=true`** — changes vanilla physics slightly. If players report weird behavior climbing standard ladders on 1.12.2, flip back to `false` (vanilla behavior).
3. The 1.12.2 Forge `forge.cfg` will regenerate missing keys on first boot with current defaults — only the four fields above will retain our overrides.
