# Mod Configurations Matrix & Schemas

## Summary Matrix

> **Note on File Paths**: `runtime/data/config/...` on the host filesystem mounts directly to `/data/config/...` inside the `mc_forge_server` Docker container.

| Mod | Config File Path | Key Setting | Value | Purpose |
| :--- | :--- | :--- | :--- | :--- |
| **LTS Auth** | `runtime/data/config/lts_auth/messages.yml` | `timeout_kick` | `Authentication time has expired!` | Ingame auth, invulnerability lock & auto-kick |
| **FLAN** | `runtime/data/config/flan/flan_config.json` | `Visitor` rights | `break: false`, `open_container: true` | Anti-griefing with permitted container access |
| **Locks Reforged** | `runtime/data/config/locks-common.toml` | `Lock Generation Chance` | `1.0` | Controls world generation probability of locked containers |
| **Improved Mobs** | `runtime/data/config/improvedmobs/common.toml` | `"Enable difficulty scaling"` | `false` | Disables time-based scaling & HUD banner |
| **Majrusz Difficulty** | `runtime/data/config/majruszsdifficulty.json` | `is_per_player_difficulty_enabled` | `true` | Isolated per-player milestone progression |
| **Create Addition** | `runtime/data/config/createaddition-common.toml` | `generator_efficiency` | `0.5` | Tech power generation rebalance |
| **Sophisticated Core** | `runtime/data/config/sophisticatedcore-common.toml` | `enabledItems` | Tier 3/4 upgrades = `false` | Cap portable storage capacity |
| **JourneyMap** | `runtime/data/journeymap/server/6.0/*.config` | `radarEnabled` | `"Disabled"` | Server-enforced radar disablement |
| **Distant Horizons** | `runtime/data/config/DistantHorizons.toml` | `distantGeneratorMode` | `"INTERNAL_SERVER"` | Native DH pregenerator for vanilla chunks + LODs |

---

## Validated Configuration Code Snippets

### 1. Locks Reforged (`runtime/data/config/locks-common.toml`)
```toml
"Lock Generation Chance" = 1.0
"Generation Enchant Chance" = 0.4
"Generated Locks" = ["locks:wood_lock", "locks:copper_lock", "locks:iron_lock", "locks:steel_lock", "locks:gold_lock", "locks:diamond_lock", "locks:netherite_lock"]
"Generated Lock Chances" = [3, 3, 3, 2, 2, 1, 1]
```

### 2. Improved Mobs (`runtime/data/config/improvedmobs/common.toml`)
```toml
[general]
"Enable difficulty scaling" = false

[ai]
"Breaker Chance" = 0.0
"Break BlockEntities" = false
```

### 3. FLAN (`runtime/data/config/flan/flan_config.json`)
```json
{
  "defaultGroups": {
    "Visitor": {
      "flan:open_container": true,
      "flan:break": false,
      "flan:place": false,
      "flan:explosions": false,
      "flan:bucket": false
    }
  }
}
```

### 4. Sophisticated Core (`runtime/data/config/sophisticatedcore-common.toml`)
```toml
[common]
        # Disable / enable any items here (disables their recipes)
        enabledItems = [
                "sophisticatedbackpacks:stack_upgrade_tier_3|false",
                "sophisticatedbackpacks:stack_upgrade_tier_4|false"
        ]
```

### 5. Majrusz's Progressive Difficulty (`runtime/data/config/majruszsdifficulty.json`)
```json
{
  "game_stages": {
    "is_per_player_difficulty_enabled": true,
    "list": [
      {
        "id": "expert",
        "triggers": { "dimensions": ["minecraft:the_nether"] }
      },
      {
        "id": "master",
        "triggers": { "dimensions": ["minecraft:the_end"] }
      }
    ]
  }
}
```

### 6. JourneyMap Server Enforced Radar (`runtime/data/journeymap/server/6.0/journeymap.server.global.config` & `journeymap.server.default.config`)
```json
{
  "radarEnabled": "Disabled",
  "caveMappingEnabled": "Disabled",
  "surfaceMappingEnabled": "Enabled"
}
```

### 7. Distant Horizons (`runtime/data/config/DistantHorizons.toml`)
```toml
[common.worldGenerator]
    # Set to INTERNAL_SERVER to generate both vanilla chunks and LODs natively via (/dh pregen start)
    distantGeneratorMode = "INTERNAL_SERVER"

[common.threads]
    # Balanced preset ensures DH pregen does not starve main server thread on Forge
    threadPreset = "BALANCED"
```