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** — 111 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.2.2.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.

## Server install (Debian 13) — one link

Run this on the server box (sudo/root; needs internet). It installs Java 21,
NeoForge 21.1.248, all 92 server-side mods (sha1-verified), and writes
`eula.txt` + `server.properties` + an 8 GB `run.sh`:

```sh
curl -sSL https://git.reaperofveriod.nl/ReaperOfVeriod/Reaper-s-Sky/raw/branch/main/server/install.sh | sh
```

Then start it (keep it running with tmux/screen):

```sh
tmux new -s mc
cd ~/reaper-sky-server && ./run.sh
```

The world generates on first boot — wait for `Done (...)` and join at
`reaperofveriod.nl`. Full details in [`server/README.md`](server/README.md).

## Updating the server's mods (maintainers)

After adding/removing mods in the Prism instance `Reaper's Sky - dev`, push
them to the live server with one command from the repo root:

```sh
python3 server/build_mods.py --push
```

It regenerates `server/mods.json`, uploads it, then on the server:
**stop → sync mods (prune stale + download new, sha1-verified) → start**, and
waits until the log shows `Done (...)`. No git commit needed first. See
[`server/README.md`](server/README.md#updating-the-servers-mods) for details,
manual options and troubleshooting.

## 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) |
| Pipez 1.2.31 | Item/fluid/energy/gas pipes |
| Create Slice & Dice 4.3.3 | Cooking automation (slicer & sprinkler) |
| Create: Easy Stone Generators 1.2.5 | Passive stone/cobble generation on Create |
| Create Contraption Terminals 1.4.0 | Access Tom's Storage / inventories from contraptions |

</details>

<details>
<summary><b>Storage</b> — Sophisticated set + Tom's</summary>

| Mod | Notes |
|-----|-------|
| Sophisticated Core 1.4.89 | Library for the Sophisticated mods |
| Sophisticated Storage 1.5.91 | Tiered, upgradeable storage barrels/chests |
| Sophisticated Backpacks 3.25.78 | Upgradeable wearable backpacks |
| Sophisticated Storage Create Integration 0.1.21 | Sophisticated Storage on Create contraptions |
| Sophisticated Backpacks Create Integration 0.1.8 | Sophisticated Backpacks on Create contraptions |
| Tom's Simple Storage 2.4.1 | Simple linked storage network |
| Sophisticated Backpacks: Ars Compat 0.3.0 | Source/Sourcelink & repair upgrades (LuminaCherry, CF) |

</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 |
| Create: Ars Nouveau Compat 1.1 | Create ↔ Ars Nouveau bridging (Create: Compat Core 1.0) |
| Sophisticated Backpacks: Ars Compat 0.3.0 | Ars Source upgrades for backpacks |

</details>

<details>
<summary><b>Building</b> — Macaw's set + Chisel + Supplementaries</summary>

| Mod | Notes |
|-----|-------|
| Chisel Reborn 2.0.1 | Chisel tool & hundreds of block variants |
| Supplementaries 3.9.1 | Building & functional variety (uses Moonlight 3.4.1) |
| Architect's Palette 1.4.0-beta.5 | New block palette |
| Macaw's Doors 1.1.5 | Custom doors |
| Macaw's Fences & Walls 1.2.1 | Fences, walls & hedges |
| Macaw's Windows 2.4.2 | Windows & shutters |
| Macaw's Bridges 3.1.2 | Rope & suspension bridges |
| Macaw's Stairs 1.0.2 | Stair variants |
| Macaw's Trapdoors 1.1.5 | Trapdoor variants |
| Macaw's Furniture 3.4.1 | Furniture & seating |
| Macaw's Lights & Lamps 1.1.5 | Lamps & chandeliers |
| Macaw's Paths & Pavings 1.1.1 | Paths & pavement |
| Macaw's Paintings 1.1.0 | New paintings |

</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 |
|-----|-------|
| Apotheosis 8.7.0 | Affixes & enchanting (Placebo, Apothic Attributes 2.10.1, Apothic Enchanting 1.6.1, Apothic Spawners 1.4.0) |
| Gravestone 1.0.40 | Places a gravestone with your items on death (JamLib 1.3.6) |
| Right Click Harvest 4.6.1 | Harvest crops by right-clicking |
| 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 |
| BetterF3 11.0.3 | Customizable F3 debug screen |
| ClientSort 2.2.2 | One-click sort buttons in inventories & chests |
| Controlling 19.0.5 | Searchable keybinds (Searchables 1.0.2) |
| Jade 15.10.6 | "What am I looking at" HUD |
| balm 21.0.65 | Cross-loader library |

</details>

<details>
<summary><b>Food</b> — Farmer's Delight expansion + Create</summary>

| Mod | Notes |
|-----|-------|
| Farmer's Delight 1.3.3 | Cooking & farming (foundation) |
| Expanded Delight 0.1.4 | More crops, snacks & recipes |
| End's Delight 2.6.1 | End-themed food & cooking |
| Create: Confectionery 1.1.3.b | Chocolate & sweets made on Create machinery |

</details>

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

| Mod | Notes |
|-----|-------|
| Sodium 0.8.12 | Rendering performance |
| MoreCulling 1.0.9 | Culls leaf & other block faces (Cloth Config 15.0.140) |
| 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.

## Crashes & getting help

If the game crashes or something breaks, send us the log on **Discord** — with
it we can usually tell you exactly which mod is at fault.

**Where to find the files (Prism Launcher):**

1. Right-click the instance → **Folder** (or **Minecraft folder**). This opens
   the instance directory.
2. Crash reports are in **`crash-reports/`** — pick the newest
   `crash-...-client.txt`.
3. If there is no crash report (game froze or was closed), grab
   **`logs/latest.log`** instead.

Quick paths by OS (the folder name includes the version you imported):

| OS | Instance folder |
|----|-----------------|
| Windows | `%APPDATA%\PrismLauncher\instances\ReapersSky-...\minecraft\` |
| Linux | `~/.local/share/PrismLauncher/instances/ReapersSky-.../minecraft/` |
| macOS | `~/Library/Application Support/PrismLauncher/instances/ReapersSky-.../minecraft/` |

**When posting on Discord, please include:**

- The full crash report or `latest.log` as a **file upload** (not pasted text)
- What you were doing when it happened
- Whether it happens in singleplayer too

> Server-side issues (everyone affected, or things broken only on the server)
> are handled by the maintainers — server logs live in
> `~/reaper-sky-server/logs/latest.log` and `~/reaper-sky-server/crash-reports/`
> on the server box.

## 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.