# HereFishy<\/p>\n
A Paper Minecraft plugin for **auto-fishing** \u2014 automatically catch fish and re-cast your rod without manual intervention.<\/p>\n
## Features<\/p>\n
### Core (always on)<\/p>\n
– **Auto-fishing toggle** \u2014 `\/herefishy start` and `\/herefishy stop`.
\n– **Automatic re-cast** \u2014 After catches or failed attempts the rod is cast again automatically.
\n– **Vanilla-ish loot & XP** \u2014 Simulated vanilla fishing loot (fish, junk, treasure) plus Minecraft XP (1\u20136 per catch).
\n– **Rod durability protection** \u2014 Stops when only a few casts remain (`\u2264 5` uses by default).
\n– **Inventory-full handling**
\n – *Default:* stops with a chat message when you have **no empty slots** (`firstEmpty`).
\n – *Optional routed setup:* when you bind crates + junk spot (below), teleport **fish stash \u2192 trophy chest \u2192 junk stand \u2192 fishing spot**, then resumes if offload succeeds.
\n– **Surplus buffering** \u2014 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.
\n– **Rod break detection** \u2014 Stops if the autofish rod shatters mid-session.
\n– **Session-only memory** \u2014 Dump bindings and `\/herefishy config` choices live **only in RAM** until you disconnect (no YAML persistence).
\n– **AuraSkills hooks** *(optional)* \u2014 When AuraSkills is installed:
\n – **Better simulated rolls** \u2014 More treasure \/ less junk (+0.25% Fishing level scaling).
\n – **Faster re-casting** \u2014 1 tick shaved per ten Fishing levels.
\n – **Vanilla XP +2% per Fishing level** on each catch plus **bonus AuraSkills XP** (+1% per level multiplier on the Aura XP payload).<\/p>\n
### Routed loot dump (Paper 1.1.1)<\/p>\n
1. **Sneak + hold a rod + right-click containers**:
\n – First valid inventory block \u2192 **treasure** chest\/barrel\/etc.
\n – Second valid inventory block \u2192 **fish** stash (must differ from trophy chest).
\n – Third sneak-click (**any block**) \u2192 anchors your **junk** drop location (drops spawn at your feet; stand above lava\/overworld void chutes responsibly).
\n – Sneak-binding while **already fully routed** clears the trio and reboots setup.
\n2. **`\/herefishy config`** \u2014 GUI for every junk\/treasure material in the simulated tables. Toggle whether each stacks into the **treasure chest** vs **junk drops** *(fish ALWAYS use the fish chest)*. Routing updates chat colors & AuraSkills XP weights to reflect the overrides.<\/p>\n
Luck of the Sea on the autofish rod still affects simulated treasure\/junk probabilities.<\/p>\n
## Requirements<\/p>\n
– Paper `1.21+` *(plugin `api-version: ‘1.21’`; built against Paper `1.21.4` API)*
\n– Java `21`
\n– *(Optional)* AuraSkills `2.x`<\/p>\n
## Installation<\/p>\n
1. Grab `HereFishy-1.1.0.jar` from Releases (or `.\/gradlew build` locally \u2014 see below).
\n2. Drop the JAR in `plugins\/`.
\n3. Restart the server (recommended over hot-reloads on production worlds).<\/p>\n
## Building from Source<\/p>\n
“`bash
\n.\/gradlew build # POSIX
\n“`<\/p>\n
“`powershell
\n.gradlew.bat build # Windows PowerShell\/cmd
\n“`<\/p>\n
The compiled plugin jar is written to:<\/p>\n
“`
\nbuild\/libs\/HereFishy-1.1.1.jar
\n“`<\/p>\n
## Commands & permissions<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/herefishy start` | Enable autofish mode | `herefishy.use` |
\n| `\/herefishy stop` | Disable autofish mode | `herefishy.use` |
\n| `\/herefishy config` | Open the treasure\/junk routing GUI | `herefishy.use` |<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `herefishy.use` | Command + sneak-binding interactions | `true` |<\/p>\n
## How to use<\/p>\n
1. Hold any fishing rod in main or off-hand.
\n2. Run `\/herefishy start`.
\n3. Cast once manually \u2014 the hook automates reels + recasts.
\n4. *(Optional)* Configure `\/herefishy config` BEFORE or DURING farming to match personal junk vs treasure taxonomy.
\n5. *(Optional)* While sneaking with rod in-hand, sneak-click binds:
\n – treasure chest \u2192 fish chest \u2192 lava\/junk footing.
\n – Without this trio the plugin behaves like `<1.1.0`: hard stop once inventory lacks space.\n\nAutofishing 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.\n\n## Version\n\nCurrent release documented here: **`1.1.1`** (Gradle + `plugin.yml` stay in sync).\n\n## License\n\nLicensed under [GNU GPLv3](LICENSE).\n<\/p>\n","protected":false},"excerpt":{"rendered":"
A Paper Minecraft plugin for auto-fishing: automatically catch fish and re-cast your rod without manual intervention.<\/p>\n","protected":false},"featured_media":80596,"template":"","meta":{"_minecraft_slug":"herefishy","_minecraft_project_id":"BzHwSqrd","_minecraft_author":"Merlointhesky","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":6,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"herefishy.zip","_minecraft_size_bytes":61902,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:16:13.704227Z","_minecraft_date_created":"2026-05-08T04:11:49.823812Z","_minecraft_date_modified":"2026-05-11T10:01:21.362265Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/herefishy","_minecraft_icon_attachment_id":80596,"_minecraft_imported_at":"2026-06-04T15:26:11+00:00","_minecraft_import_hash":"340d178e44d5822d63a954caa0245248","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,85,89,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-80595","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-food","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n