Reaper-s-Sky/README.md

# Reaper's Sky

A curated Minecraft modpack about airships, exploration, and tech progression.
**Minecraft 1.21.1 / NeoForge 21.1.248** — 75 mods.

## Install (Prism Launcher) — one link

If you don't have it yet, grab the latest **Prism Launcher** here:
[Prism Launcher download](https://prismlauncher.org/download/)

1. Open Prism Launcher → **Add Instance → Import from ZIP**.
2. Paste the raw URL to the `.mrpack` file in this repository
   (e.g. `https://git.reaperofveriod.nl/ReaperOfVeriod/Reaper-s-Sky/raw/branch/main/ReapersSky-1.0.0.mrpack`).
3. Import. Prism downloads all mods, applies configs/shaders/resource pack, and sets the instance up automatically.
4. (First launch) Allocate 8 GB RAM in **Settings → Java → Memory**. Requires Java 21.
5. The multiplayer server `reaperofveriod.nl` is pre-listed — just hit **Multiplayer** and join.

## What's inside

<details open>
<summary><b>Core</b> — Create + Aeronautics foundation</summary>

| Mod | Notes |
|-----|-------|
| Create 6.0.10 | Machines, kinetics & contraptions (bundles Flywheel, Ponder, Registrate) |
| Create Aeronautics 1.3.1 | Player-piloted airships & moving contraptions (bundled build) |
| Sable 2.0.5 | Physics/simulation library behind Aeronautics |
| kotlinforforge | Kotlin runtime for NeoForge |
| Curios 9.5.1 | Wearable accessory slots |
| geckolib 4.9.2 | 3D entity animation library |
| playeranimator 2.0.4 | Player animation support |
| Placebo 9.9.2 | Library (required by Apotheosis) |
| Patchouli 93 | In-game guidebook framework |

</details>

<details>
<summary><b>Airships / expansion</b> — Aeronautics addons</summary>

| Mod | Notes |
|-----|-------|
| aeroworks 1.4.2 | Advanced airship workshop tools |
| aeronautics-covers 1.0.1 | Extra block covers for ships |
| aeronautics-dyeable-components 1.0.4 | Dyeable ship components |
| aeronautics-gadgets-and-gizmos 1.1.3 | More airship gadgets |
| aeronautics-portable-engine-liquid-fuel 2.0.0 | Liquid-fuel portable engines |
| aeronautics-propeller-blur 1.0a | Propeller blur effect |
| create-simulated-thrusters 1.0.1 | Simulated thruster blocks |
| create-the-air-war 4.67 | Aerial combat / air war content |
| deployer 0.1.2 | Extra deployer behaviours |
| simulated-gauges 1.1.0 | Gauges for simulated systems |
| jade-sable-compat 1.3.0 | Jade HUD compat for Sable |
| aero-shadow-fix 2.1.0 | Fixes shader ghosting (balloon) |

</details>

<details>
<summary><b>Tech</b> — Create expansion</summary>

| Mod | Notes |
|-----|-------|
| railways 0.3.0-beta.2 | Trains & rail transport |
| create-new-age 1.2.0 | Nuclear / advanced power |
| createbigcannons 5.11.7 | Cannons & artillery |
| createdieselgenerators 1.3.15 | Diesel generators |
| copycats 3.0.6 | Copycat block variants |
| create_connected 1.3.2 | Connected textures & bridges |
| Design-n-Decor 2.2b | Decorative blocks |
| create_jetpack 5.2.1 | Jetpacks |
| cable_facades 2.1.3 | Hide cables/trains under facades |
| ritchiesprojectilelib 2.1.2 | Projectile library (createbigcannons) |

</details>

<details>
<summary><b>Magic</b></summary>

| Mod | Notes |
|-----|-------|
| Iron's Spells 'n Spellbooks 3.16.3 | Spell-casting (uses irons_lib 2.1.0) |
| Ars Nouveau 5.13.0 | Glyph-based spellcrafting & familiars |

</details>

<details>
<summary><b>Exploration</b></summary>

| Mod | Notes |
|-----|-------|
| Terralith 2.6.2 | 95+ new biomes (via lithostitched 1.8.0) |
| YUNG's Better Strongholds 5.1.3 | Overhauled strongholds |
| YUNG's Better Desert Temples 4.1.5 | Overhauled desert temples |
| YUNG's Better Dungeons 5.1.4 | Overhauled dungeons |
| YungsApi 5.1.7 | Library for the YUNG's mods |
| Explorer's Compass 3.4.0 | Find structures |
| Nature's Compass 3.4.0 | Find biomes |
| Xaero's Minimap 26.4.2 | Minimap |
| Xaero's World Map 1.44.2 | Full world map |
| waystones 21.1.41 | Teleport waypoints |

</details>

<details>
<summary><b>Survival / QoL</b></summary>

| Mod | Notes |
|-----|-------|
| Tough As Nails 10.1.0.13 | Temperature & thirst (GlitchCore 2.1.0.2) |
| Farmer's Delight 1.3.3 | Cooking & farming |
| Apotheosis 8.7.0 | Affixes & enchanting (Placebo, Apothic Attributes 2.10.1, Apothic Enchanting 1.6.1, Apothic Spawners 1.4.0) |
| corpse 1.1.13 | Death marker & grave |
| carry-on 2.2.6 | Carry chests & mobs |
| JEI 19.44.0.403 | Recipe viewer |
| appleskin 3.0.9 | Food/hunger HUD |
| MouseTweaks 2.26.1 | Inventory mouse controls |
| Controlling 19.0.5 | Searchable keybinds (Searchables 1.0.2) |
| Jade 15.10.6 | "What am I looking at" HUD |
| WeightedInventory 2.2.0 | Inventory weight/encumbrance |
| balm 21.0.65 | Cross-loader library |

</details>

<details>
<summary><b>Performance</b></summary>

| Mod | Notes |
|-----|-------|
| Sodium 0.8.12 | Rendering performance |
| lithium 0.15.4 | Game logic performance |
| ferritecore 7.0.3 | Memory optimization |
| ImmediatelyFast 1.6.12 | Faster rendering |
| entityculling 1.10.5 | Cull off-screen entities |
| dynamic-fps 3.11.4 | Auto-lower FPS when unfocused |
| modernfix 5.27.20 | Boot & memory fixes |
| Clumps 19.0.0.1 | Group XP orbs |
| spark 1.10.124 | Profiler |

</details>

<details>
<summary><b>Visuals</b></summary>

| Mod | Notes |
|-----|-------|
| Iris 1.8.14-beta.1 | Shader loader |
| EuphoriaPatcher 1.9.3 | Patches Complementary shaders |
| iris-flywheel-compat 2.3.1 | Iris + Flywheel backend compat |
| 3D Skin Layers 1.11.2 | 3D player/mob skins |
| Fresh Animations 1.10.4 | Animated mobs (resource pack — enable in-game) |
| Complementary Reimagined r5.8.1 | Shaderpack (Euphoria-patched, included) |

</details>

## Key config already applied

- **Flywheel backend forced to `flywheel:indirect`** — fixes the Create throttle-lever
  "ghost image" artifact under Iris shaders.
- **aero-shadow-fix** bundled — fixes the white balloon ghost.
- Iris is preset to load the included Complementary Reimagined shaderpack.
- `irisflw replaceCheckerboardTexture = true` for correct textures under shaders.

## After import

- Enable **Fresh Animations** in Options → Resource Packs (ships alongside 3D Skin Layers).
- If shaders look off, verify the Complementary pack is active in Options → Video Settings → Shader Packs.

## Rebuilding the pack (maintainers)

`python3 build_mrpack.py` regenerates the `.mrpack` from the dedicated
**"Reaper's Sky - dev"** instance at
`~/.local/share/PrismLauncher/instances/Reaper's Sky - dev/.minecraft`.
Set `INSTANCE` (and `OVERRIDES`) at the top of the script to point at a different
instance.

## Known limitations

- Create Aeronautics has *known* visual issues under Iris; the bundled config/mods
  resolve the most visible ones (balloon + throttle lever). Occasional artifacts on
  animated Create instances may still appear.
- Shader uniform warnings in the log (`_flw_cullData`, `flw_frustumPlanes`) from Veil
  are cosmetic and do not affect rendering on the `indirect` backend.