mcserver/instances/forge-1.20.1-survival/mod-configs.md

171 lines
6 KiB
Markdown

# 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 |
| :--- | :--- | :--- | :--- | :--- |
| **AutoModpack** | `runtime/data/automodpack/automodpack-server.json` | `validateSecrets` / `forceCopyFilesToStandardLocation` | `false` / `["/mods/*.jar", "/servers.dat", "/options.txt", "/config/**"]` | Dynamic modpack delivery, trusted instant join, and forced client option sync |
| **LTS Auth** | `runtime/data/config/lts_auth/messages.yml` | `timeout_kick` | Configured message | In-game auth, invulnerability lock & auto-kick (`players.json` credential store) |
| **Locks Reforged** | `runtime/data/config/locks-common.toml` | `"Enable Loot-Scaled Locks"` | `true` | Loot-value-based container lock tier selection |
| **Improved Mobs** | `runtime/data/config/improvedmobs/common.toml` | `"Breaker Chance"` / `"Stealer Chance"` | `0.0` / `0.3` | Disables block breaking; item stealing enabled (30%); JAR excluded from client sync (`!/mods/improvedmobs*.jar`) |
| **Majrusz Difficulty** | `runtime/data/config/majruszsdifficulty.json` | `is_per_player_difficulty_enabled` | `true` | Isolated per-player milestone progression (`normal`, `expert`, `master` stages) |
| **Create Addition** | `runtime/data/config/createaddition-common.toml` | `[alternator].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 |
| **AntiXray** | `runtime/data/config/antixray.toml` | `enabled` / `[overworld].engineMode` | `false` / `3` | Global default disabled (prevents space/orbit bugs); Overworld Mode 3 & Nether Mode 1 active |
| **JourneyMap** | `runtime/data/journeymap/server/6.0/` | `playerRadarEnabled` / `caveMapping` | `"false"` / `"NONE"` | Server-enforced entity radar restrictions & universe-wide cave mapping disabled |
---
## Validated Configuration Code Snippets
### 1. AutoModpack (`runtime/data/automodpack/automodpack-server.json`)
```json
{
"DO_NOT_CHANGE_IT": 2,
"modpackName": "MC SotoHome",
"modpackHost": true,
"generateModpackOnStart": true,
"syncedFiles": [
"/mods/*.jar",
"!/mods/SimpleBackups*.jar",
"/shaderpacks/*",
"!/config/luckperms/libs/**",
"!/mods/improvedmobs*.jar",
"!/mods/spark*.jar",
"!/mods/antixray*.jar",
"!/mods/doubledoors*.jar",
"!/mods/Clumps*.jar",
"!/mods/collective*.jar",
"!/config/antixray.toml",
"!/mods/lts_auth*.jar",
"/resourcepacks/*",
"/config/**",
"!/config/simplebackups-common.toml",
"!/config/spark/**"
],
"allowEditsInFiles": [
"/config/**",
"/options.txt"
],
"forceCopyFilesToStandardLocation": [
"/mods/*.jar",
"/servers.dat",
"/options.txt",
"/config/**"
],
"autoExcludeServerSideMods": true,
"autoExcludeUnnecessaryFiles": true,
"requireAutoModpackOnClient": true,
"validateSecrets": false,
"acceptedLoaders": [
"forge"
]
}
```
### 2. 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]
["Loot-Scaled Locks"]
"Enable Loot-Scaled Locks" = true
"Loot Value Tiers" = [3.0, 6.0, 10.0, 16.0, 24.0, 40.0, 60.0]
```
### 3. Improved Mobs (`runtime/data/config/improvedmobs/common.toml`)
```toml
[general]
"Enable difficulty scaling" = false
[ai]
"Breaker Chance" = 0.0
"Break BlockEntities" = false
"Stealer Chance" = 0.3
[integration]
"Use Scaling Health Mod" = "OFF"
"Use Player EX Mod" = "OFF"
"Use LevelZ Mod" = "OFF"
```
### 4. Create Addition (`runtime/data/config/createaddition-common.toml`)
```toml
[alternator]
# Alternator efficiency relative to base conversion rate
# Range: 0.01 ~ 1.0
generator_efficiency = 0.5
```
### 5. 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"
]
```
### 6. Majrusz's Progressive Difficulty (`runtime/data/config/majruszsdifficulty.json`)
```json
{
"game_stages": {
"is_per_player_difficulty_enabled": true,
"list": [
{
"id": "normal",
"triggers": { "dimensions": [], "entities": [] }
},
{
"id": "expert",
"triggers": { "dimensions": ["minecraft:the_nether"] }
},
{
"id": "master",
"triggers": { "dimensions": ["minecraft:the_end"] }
}
]
}
}
```
### 7. AntiXray (`runtime/data/config/antixray.toml`)
```toml
# Global default fallback
enabled = false
[overworld]
enabled = true
engineMode = 3
maxBlockHeight = 256
updateRadius = 2
lavaObscures = false
hiddenBlocks = ["#forge:ores", "raw_copper_block", "raw_iron_block", "raw_gold_block"]
replacementBlocks = ["stone", "deepslate", "andesite", "calcite", "diorite", "dirt", "granite", "gravel", "sand", "tuff", "mossy_cobblestone", "obsidian", "clay", "infested_stone", "amethyst_block", "budding_amethyst", "chest"]
[the_nether]
enabled = true
engineMode = 1
maxBlockHeight = 128
updateRadius = 2
lavaObscures = true
hiddenBlocks = ["ancient_debris", "nether_quartz_ore", "nether_gold_ore", "gold_block", "gilded_blackstone"]
```
### 8. JourneyMap Server Enforced Radar (`runtime/data/journeymap/server/6.0/journeymap.server.global.config`)
```json
{
"surfaceMapping": "ALL",
"caveMapping": "NONE",
"radarEnabled": "ALL",
"playerRadarEnabled": "false",
"mobRadarEnabled": "false",
"animalRadarEnabled": "false",
"villagerRadarEnabled": "false"
}
```