Poseidon

A client-side Fabric mod that automates rod fishing — cast, wait for the bite, reel in, and recast, all with configurable human-like timing.
Named after the Greek god of the sea.

Requires PlayerAPI and YetAnotherConfigLib to run.
ModMenu is optional — it adds a settings button to the mod list.

---

Features

Smart Bite Detection

Poseidon scans nearby text for the !!! signal servers send when your bobber gets a bite. When detected, it reels in after a configurable human reaction delay with optional randomness so the timing never looks mechanical.

Auto-Recast

After every catch the rod is recast automatically. A configurable decision window gives server chat time to arrive before committing, so triggers that suppress or stop the recast always fire in time. Recast delay is independently configurable (min/max ms) and can be disabled entirely.

Ping-Aware Decision Window

The decision window — how long Poseidon waits for a chat trigger before recasting — is exposed as a player setting so you can tune it to match your connection.

Chat Triggers

Define keyword triggers that match incoming chat messages. Each trigger can:

• Play a custom sound
• Show a title on screen
• Suppress the next auto-recast
• Stop the bot entirely (HUD stays open)

Tracked Entity Warnings

Poseidon tracks entities you fish up and enforces configurable per-area caps. When you hit the cap it alerts you. Entities that have been alive too long (configurable, default ~5 min) trigger a despawn warning so you can act before they vanish.

Bobber Drift Detection

If your hook attaches to a moving entity the bobber drifts away from where it landed. Poseidon detects drift beyond a configurable radius after a short settle period, reels in, and recasts — keeping the bot from stalling on a moving target.

Live HUD

An in-game overlay (toggleable keybind) shows:

• Bot active/inactive state
• Bobber status — grey: no bobber, yellow: bite signal detected, green: bobber idle
• Last catch info and active entity count
• Live countdown text when a bite signal is present

Fully Configurable

All timings, thresholds, sounds, and toggles are exposed through a YACL config screen. Open it from ModMenu, the /poseidon command, or a keybind. No file editing required.

---

Controls

All keybinds are rebindable in Options → Controls → Poseidon.

Action	Default Key
Toggle Fishing	Y
Toggle HUD	H
Open Config	(unbound)

Type /poseidon in chat to open the config screen directly.

---

Installation

1. Install Fabric Loader for Minecraft 1.21.11
2. Install Fabric API
3. Install PlayerAPI
4. Install YetAnotherConfigLib
5. Install ModMenu (optional)
6. Drop poseidon-*.jar into your mods folder

---

Compatibility

Minecraft	Fabric Loader	Java
1.21.11	≥ 0.18.4	21

---

License

LGPL-3.0