mods.conf

# =============================================================================
# Minecraft Splitscreen Mods Configuration
# =============================================================================
# Each non-blank, non-comment line defines one mod.
#
# Format:
#   required|Mod Name|platform|mod_id[|dep1,dep2,...]
#   optional|Mod Name|platform|mod_id[|dep1,dep2,...]
#
#   required  — always installed; gates Minecraft version selection
#   optional  — offered to the user during interactive install
#   platform  — modrinth or curseforge
#   mod_id    — the project ID on that platform
#   deps      — (optional) comma-separated names of other mods in this file
#               that must be present when this mod is installed. The installer
#               resolves these transitively (BFS) before the API pass runs.
#
# Required mods are also used by version_management.sh to determine which
# Minecraft versions are compatible. Change them only if the replacement mod
# supports the same splitscreen.properties contract.
#
# To add a mod: append a line below. To remove an optional mod: delete or
# comment out its line. The installer will reflect the change on next run.
# =============================================================================

# ── Required ─────────────────────────────────────────────────────────────────
# Controlify: controller input (replaces old Controllable / CurseForge 317269)
required|Controlify|modrinth|DOUdJVEm|
# NOTE: the "Splitscreen Support" mod (modrinth yJgqfSDR) was removed 2026-06-23 —
# window tiling is now done by KWin (the nested compositor), not by an in-game mod.
# Do NOT re-add it: the mod owns the GLFW window and re-asserts its own geometry on
# every resize, which fights and overrides the KWin tiling.

# ── Required: performance (standard set, 2026-07-17) ──────────────────────────
# Installed identically across every splitscreen instance — this is the perf
# baseline for running up to 4 concurrent Minecraft sessions on one Deck without
# CPU/GPU contention. See docs/ (or the source research doc) for the rationale.
required|Sodium|modrinth|AANobbMI|
required|Lithium|modrinth|gvQqBUqZ|
required|FerriteCore|modrinth|uXXizFIs|
# ModernFix-mVUS — community fork of ModernFix (nmDcB62a) that keeps publishing
# Fabric builds for current Minecraft versions; the original mod stopped cutting
# Fabric releases. Use this fork, not nmDcB62a, or the installer will find no
# compatible version on anything recent.
required|ModernFix|modrinth|TjSm1wrD|
required|Entity Culling|modrinth|NNAgCjsB|
required|ImmediatelyFast|modrinth|5ZwdcRci|
# Starlight (lighting engine rewrite) deliberately NOT included: the Fabric port
# is archived and capped at Minecraft 1.20.4, so it would never resolve against
# the recent versions this installer targets.
#
# Avoid / use with caution (not included):
# - C2ME: multithreaded chunk gen competes hard for CPU cores across 4 instances.
# - Iris / shader packs: expensive across 4 concurrent sessions.