PEAKcraft

  # PEAKcraft

  Free-form wall climbing for Minecraft. Inspired by **PEAK** (Aggro Crab / Landfall, 2024).

  ## Features

  - **Wall climbing** — hold RMB while looking at any block to grab on and climb
  - **Stamina system** — drains while moving, regens on the ground; hitting 0 makes you slip
  - **Stamina slide** — accelerates uncapped; at ~8 blocks/sec you lose grip entirely
  - **Mantle** — automatically pull yourself onto 1-block-high ledges
  - **Dash** — Left Ctrl: quick burst along the wall (~2 blocks). Allowed even with negative stamina
  - **Corner traversal** — strafe A/D, turn corners smoothly
  - **Rain matters** — ×0.65 climb speed, ×1.7 stamina drain
  - **Procedural hand animation** — both arms visible in first person, in sync with grip sounds
  - **Camera effects** — gentle sway + +20% FOV while climbing
  - **Minimalist HUD** — 3-slot hotbar + stamina bar
  - **Empty-hand climbing** — press a hotbar key twice to toggle to "no item" mode

  ## Controls

  | Action | Key |
  |--------|-----|
  | Grab wall | RMB (hold) |
  | Move up | W |
  | Strafe along wall | A / D |
  | Dash | Left Ctrl |
  | Release | Let go of RMB or press Space |
  | Empty hand | Press the same hotbar number twice |

  ## Install

  1. NeoForge 1.21.1
  2. Download `peakcraft-x.x.x.jar`
  3. Drop into `mods/`

  ## Compatibility

  Works in single-player and multiplayer. Pure NeoForge — no extra dependencies.

  ## Design notes

  - Hotbar is intentionally limited to 3 slots — fits the "climb light, climb fast" theme
  - Slots 4–9 are wiped (items drop to the ground)
  - You can't climb while holding an item — switch to empty hand first

  ## Credits

  - Climbing concept inspired by PEAK (Aggro Crab / Landfall)
  - Code, balance, animations — [your name]
  - Bugs & feedback — GitHub Issues / Modrinth comments