Herefishy

HereFishy

A auto-fishing Minecraft plugin for auto-fishing — automatically catch fish and re-cast your rod without manual intervention.

Features

Core (always on)

- bonus AuraSkills XP — `/herefishy start` and `/herefishy stop`. - bonus AuraSkills XP — After catches or failed attempts the rod is cast again automatically. - bonus AuraSkills XP — Simulated vanilla fishing loot (fish, junk, treasure) plus Minecraft XP (1–6 per catch). - bonus AuraSkills XP — Stops when only a few casts remain (`≤ 5` uses by default). - bonus AuraSkills XP - *Default:* stops with a chat message when you have bonus AuraSkills XP (`firstEmpty`). - *Optional routed setup:* when you bind crates + junk spot (below), teleport bonus AuraSkills XP, then resumes if offload succeeds. - bonus AuraSkills XP — If a catch cannot be placed in your inventory (`addItem` overflow) while routed, that stack is routed on the teleport trip instead of spamming drops onshore. - bonus AuraSkills XP — Stops if the autofish rod shatters mid-session. - bonus AuraSkills XP — Dump bindings and `/herefishy config` choices live bonus AuraSkills XP until you disconnect (no YAML persistence). - bonus AuraSkills XP *(optional)* — When AuraSkills is installed: - bonus AuraSkills XP — More treasure / less junk (+0.25% Fishing level scaling). - bonus AuraSkills XP — 1 tick shaved per ten Fishing levels. - bonus AuraSkills XP on each catch plus bonus AuraSkills XP (+1% per level multiplier on the Aura XP payload).

Routed loot dump (Paper 1.1.1)

1. junk drops: - First valid inventory block → junk drops chest/barrel/etc. - Second valid inventory block → junk drops stash (must differ from trophy chest). - Third sneak-click (junk drops) → anchors your junk drops drop location (drops spawn at your feet; stand above lava/overworld void chutes responsibly). - Sneak-binding while junk drops clears the trio and reboots setup. 2. junk drops — GUI for every junk/treasure material in the simulated tables. Toggle whether each stacks into the junk drops vs junk drops *(fish ALWAYS use the fish chest)*. Routing updates chat colors & AuraSkills XP weights to reflect the overrides.

Luck of the Sea on the autofish rod still affects simulated treasure/junk probabilities.

Requirements

- Paper `1.21+` *(plugin `api-version: '1.21'`; built against Paper `1.21.4` API)* - Java `21` - *(Optional)* AuraSkills `2.x`

Installation

1. Grab `HereFishy-1.1.0.jar` from Releases (or `./gradlew build` locally — see below). 2. Drop the JAR in `plugins/`. 3. Restart the server (recommended over hot-reloads on production worlds).

Building from Source

```bash ./gradlew build # POSIX ```

```powershell .gradlew.bat build # Windows PowerShell/cmd ```

The compiled plugin jar is written to:

``` build/libs/HereFishy-1.1.1.jar ```

Commands & permissions

| Command | Description | Permission | |---------|-------------|------------| | `/herefishy start` | Enable autofish mode | `herefishy.use` | | `/herefishy stop` | Disable autofish mode | `herefishy.use` | | `/herefishy config` | Open the treasure/junk routing GUI | `herefishy.use` |

| Permission | Description | Default | |------------|-------------|---------| | `herefishy.use` | Command + sneak-binding interactions | `true` |

How to use

1. Hold any fishing rod in main or off-hand. 2. Run `/herefishy start`. 3. Cast once manually — the hook automates reels + recasts. 4. *(Optional)* Configure `/herefishy config` BEFORE or DURING farming to match personal junk vs treasure taxonomy. 5. *(Optional)* While sneaking with rod in-hand, sneak-click binds: - treasure chest → fish chest → lava/junk footing. - Without this trio the plugin behaves like `<1.1.0`: hard stop once inventory lacks space.

Autofishing halts instantly if rods break/nearly snap, inventories overflow without valid routing, offload fails (`chest full` mid-route), `/herefishy stop` fires, or the player logs off.

Version

Current release documented here: `1.1.1` (Gradle + `plugin.yml` stay in sync).

License

Licensed under GNU GPLv3.