Skip to content

Add the fishing mini-game#31

Open
edenfps wants to merge 1 commit into
Open-Source-Free-Realms:minigamefrom
edenfps:fishing
Open

Add the fishing mini-game#31
edenfps wants to merge 1 commit into
Open-Source-Free-Realms:minigamefrom
edenfps:fishing

Conversation

@edenfps

@edenfps edenfps commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Implements the Free Realms fishing mini-game end-to-end on the server, reverse-engineered from the client (opcode 138). The client only animates the bobber/fish; the bite simulation is driven entirely server-side.

Core loop

Cast → bobber + underwater school → fish gets interested → bites (lunge + splash) → fight → reel-up → catch banner + inventory grant. Reel timing gates a catch vs a miss. Catches persist to the DB and survive relog.

Content

  • Per-hole fish tables for all six fishing holes, feeding the Fish Finder with real species names + icons.
  • Treasure chest (static catchable-head + money-shot burst) and junk catches.
  • Multiplayer sync of fishing visuals to nearby players.

Gear

  • Equipped rod → cast-distance tier (short / greater / deepest).
  • Lures → +10% catch chance for their fish; Treasure Magnet → +treasure. Activated from the tackle box via the action bar.

Ambient scenery (WIP)

Wandering fish + fishing-spot markers in the water. Renders; movement/placement still being tuned.

Debug tooling

tp / tporigin and /pos chat commands.

Docs

  • FISHING_HANDOFF.md — the map / onboarding
  • FISHING_RE_NOTES.md — wire-level reverse-engineering notes
  • FISHING_WIKI.md — hole / fish / lure data
  • FISHING_1TO1_PLAN.md — remaining-work roadmap

… client)

Implements Free Realms fishing end-to-end on the server (opcode 138). The client
is a terminal that animates the bobber/fish but the bite simulation is driven
entirely server-side.

Core loop: cast -> bobber + underwater school -> fish gets interested -> bites
(lunge + splash) -> fight -> reel-up -> catch banner + inventory grant. Reel
timing gates a catch vs a miss. Catches persist to the DB and survive relog.

Content:
- Per-hole fish tables for all six holes, feeding the Fish Finder with real
  species names and icons.
- Treasure chest (static catchable-head + money-shot burst) and junk catches.
- Multiplayer sync of fishing visuals to nearby players.

Gear:
- Equipped rod -> cast-distance tier (short/greater/deepest).
- Lures -> +10% catch chance for their fish; Treasure Magnet -> +treasure.
  Activated from the tackle box via the action bar.

Ambient scenery (WIP): wandering fish + fishing-spot markers in the water.

Debug: tp/tporigin and /pos chat commands.

Docs: FISHING_HANDOFF.md (map), FISHING_RE_NOTES.md (wire-level RE),
FISHING_WIKI.md (hole/fish/lure data), FISHING_1TO1_PLAN.md (roadmap).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant