Grims Nilla Fishin’

Setup and operating reference for 0.4.3, covering the 129-fish catalogue, Java/Bedrock resources, commands, configuration, economy, and saved data. For player controls and recipes, use the Player Wiki. Species rules and base prices are in the Fish Roster.

Requirements and installation

This build targets Paper 26.3 and Java 25. Packforge supplies the Java artwork; Geyser needs separate Bedrock resources and mappings. Native touch menus use GrimsClientChecker and Floodgate on the Paper backend. Vault is optional when using internal Fishing Coins. PyroFishing is not required.

Use the complete GrimsNillaFishin-Test-0.4.3.zip bundle:

1. Stop the server. For an upgrade, back up worlds and the entire plugins/GrimsNillaFishin/ folder together.
2. Replace the old plugin JAR with GrimsNillaFishin-0.4.3.jar in plugins/. Keep existing configuration and saved data.
3. Install the bundle’s grims_nilla_fishin content folder with Packforge.
4. Install the Bedrock pack and both mapping files in the running Geyser instance, as shown below.
5. Start the server, run /pf zip, and serve the rebuilt combined Java pack through your Packforge host. Restart Geyser and reconnect clients to load the Bedrock update.
6. Review the new defaults and run the acceptance checks below before releasing the update to players.

Geyser/packs/GrimsNillaFishin-Bedrock-0.4.3.mcpack
Geyser/custom_mappings/grims_nilla_fishin.json
Geyser/custom_mappings/grims_nilla_fishin_blocks.json

Use the folders of the Geyser instance actually serving players, including on proxy setups. Enable Geyser custom content as described in the installation guide. Remove superseded GNF Bedrock packs with the same pack UUID instead of loading multiple versions together.

The separate Java ZIP is for standalone visual checks. Production Packforge installations should serve their combined pack. Create gameplay items through GNF recipes, shop, or /gnf give; artwork-only items are not a substitute for plugin-tagged equipment.

Mobile, controller, and trap presentation

GrimsClientChecker selects the menu layout from the player's input preference. Touch uses native forms for Shop, Skills, Diary, and traps; keyboard/mouse and controller normally use inventory menus. Mobile hardware alone does not force touch layout. Install Floodgate and GrimsClientChecker on the Paper backend; proxy installations also need Floodgate data forwarding.

The Sushi Station and Sushi Cook Book stay chest menus on touch, in a seven-column copy titled — Mobile (the Crops Stove and Cook Book pattern). They need only GrimsClientChecker; with Packforge installed its crossplay service decides first, exactly as for trap forms.

Traps use a vanilla barrel appearance until the matching custom artwork is available to players. Check that the content is loaded and the pack is being served before diagnosing a trap appearance problem.

Fish and tackle menu icons use 16×16 artwork. Tackle held in the world or attached to rods/hooks uses the 32×32 artwork. Nightcrawler uses its cup for inventory and its single-worm sprite for the hook. Bedrock's ordinary dropped tackle item uses its inventory icon.

Commands and permissions

/gnf is the short alias for /nillafishin. Brackets mean optional arguments; replace angle-bracket placeholders with actual values.

Admin trap access also requires normal use permission. /gnf list is public.

Player commands

The command-free shortcut is to hold a fishing rod, crouch, and use it before casting. Reeling an existing line does not open the menu.

Admin commands

Normal give amounts are 1–64; rods require exactly 1. Omitted amounts and pages default to 1, and omitted targets default to the issuing player. Include the amount when targeting another player: /gnf give iron_rod 1 PlayerName. Console must name an online target. /gnf status is player-only.

For allfish, the number is a page, not a quantity. Pages 1–7 contain 18 fish; page 8 contains 3. Clear inventory space between pages. If the complete grant will not fit, nothing is given.

There is no reload, skill-reset, or stock-reset command in this build. Restart after configuration changes.

What the admin rod tests

The admin rod randomly selects equally from all 129 species in any fishable water, including the four realm species that ordinary water fishing never produces. It does not fish the void or lava; those loops ignore it. It bypasses rod tiers, habitat, time/weather/moon conditions, and shared population limits. Repeated catches can repeat a species; it is not a sequential catalogue tour.

Its catches and command-given fish are marked as test items and provide no Fishing XP, diary credit, or shop payment. Admin rod catches also give no vanilla XP. The rod requires admin permission to use and cannot be crafted into normal equipment.

Use this rod to inspect artwork and catch delivery. Use ordinary rods and naturally caught fish to test biome restrictions, stock, XP, diary records, and sales.

Fishing and progression rules

Epic, Legendary, and Mythic require equipped bait or a lure. Normal junk and treasure results remain available on all three player rod tiers. Iron attempts an eligible custom replacement whenever vanilla produces an ordinary fish; empty stock or no eligible species can produce no fish instead.

Eligibility uses the hook or trap location. All nine ocean biome variants are covered. Night is tick 13000 through 22999, and full moon is phase zero. The roster lists every species' exact habitat and conditions.

The catalogue contains 23 Common, 28 Uncommon, 28 Rare, 26 Epic, 16 Legendary, and 8 Mythic species. Rarity weighting is relative to what is currently eligible:

Matching tackle triples a species' selection weight within its eligible rarity. These weights are not guaranteed percentages across all waters. Species definitions, weight ranges, and rarity weights are part of this build; the supplied catalogue JSON is a reference, not a runtime configuration file.

Realm fishing: the void and lava

Four species live where a vanilla bobber cannot fish at all, so the plugin runs its own bite loop for them instead of waiting on PlayerFishEvent. Water fishing is untouched, and these four are filtered out of every water cast and every trap — including water a player carries into the End.

Both realms need a Tier 2 iron rod, because Legendary and Mythic require one. A copper rod reports a snapped line instead of a catch. Realm tackle is what starts the loop: no other bait or lure is tracked, and VOIDBORN/INFERNAL species ignore every other tackle even if the rod reaches the right spot.

A tracked bobber is checked every two ticks. When it reaches its realm the plugin anchors it — gravity off, velocity cleared — so a void cast hangs at the drop instead of falling out of the world, and emits particles and a sound about once a second. After the configured bite window, exactly one bite resolves: the fish goes into the player's inventory (overflow drops at their feet), the bobber is reeled in, and bait or lure consumption uses the normal tackle.* chances. If the bobber leaves its realm before then, it resumes falling and its progress resets.

Realm catches draw on the same shared 32×32 population as rods and traps, and record diary, XP and sale value like any other active catch. Because the loop is server-side, no resource pack or client support is involved; vanilla clients see an ordinary bobber. Set void-fishing.enabled or lava-fishing.enabled to false to remove a realm entirely, which also removes the only route to its two species.

Skills, catches, and crafting

Fishing starts at level 1 with no points. Each subsequent level grants one point. Baiting Hands, Trapcraft, Trophy Angler, and Water Reading each have five ranks. Skill spending requires confirmation.

Only active catches award Fishing XP. The first active catch bonus still applies if the player previously caught that species in a trap. Traps record diary catches but award no Fishing XP. Trading and shop transactions do not award XP.

Trapcraft unlocks crafting capacities 6, 9, 12, 15, and 18; the basic trap holds 3 catches. Finished traps can be traded and used without that crafting rank. Bigger traps add storage without changing rarity, population, or attempt frequency. Recipes and equipment controls are in the Player Wiki. Automated Crafter blocks cannot create the player-gated equipment recipes.

Sushi Station

Grims Crops refuses Rare-and-above fish and the whole JELLY family in its cooking groups on purpose, which leaves 76 of the 129 catches with no destination. The Sushi Station is GNF's own answer, and it runs entirely inside this plugin.

Placing and saving stations

The Sushi Station uses the Crops resource pack for its placed appearance. Keep the supplied Crops pack installed for the correct model. Station locations are saved in plugins/GrimsNillaFishin/stations.yml; include that file in backups. Right-click a station to open it. Breaking it drops the station item. Craft one with a barrel surrounded by four dried kelp, or use /gnf give sushi_station.

Ingredients, and why Grims Crops is optional

Recipes match on an item's item_model, never on another plugin's private tag. GNF reads the model key off the stack — gcrops:rice, grims_nilla_fishin:crown_tuna — and decides for itself.

Grims Crops is therefore never contacted and never required, and no softdepend is declared. 26 of the 30 dishes ask for at least one Crops ingredient — seven different ones: butter, chili_pepper, cooking_oil, grapes, lettuce, rice, tomato — and only the four jellos are made from vanilla items and fish alone. On a server without Crops those model keys never appear, so those dishes cannot be assembled. They stay listed in the cook book deliberately, so players can see what the station would do rather than silently getting a shorter book.

Matching rules

Matching is exact cover: every occupied slot must be claimed by the recipe, so one spare item in the grid means no dish. That is what keeps two recipes from ever claiming the same grid. Slot position is never considered, and no dish has a cook timer or needs fuel — everything here is prepared instantly.

Thirty dishes ship: six tier dishes taking any fish of a rarity, twenty naming one fish each, and four jellyfish jellos. Nutrition runs 4–13 and saturation 3–14, always a clear step above the raw fish the dish is made from.

Assets

The 30 Sushi dishes, Sushi Station item and Sushi Cook Book are included in the main Java and Bedrock packs and their mappings. Install the matching main packs; separate legacy Sushi packs are not needed.

Geyser gets a definition for every dish (with its food and eating time, so Bedrock players can eat it), for the cook book, and for the station item under minecraft:barrel. The placed station's block override is in the Grims Crops Geyser mappings, with its art in the Crops packs.

Configuration reference

Edit plugins/GrimsNillaFishin/config.yml, then restart. For upgrades, compare against the bundle's defaults/config.yml and merge desired settings into the existing configuration.

progression.xp defaults are vanilla: 5, common: 10, uncommon: 15, rare: 25, epic: 40, legendary: 60, and mythic: 90.

Fishing, trap, and tackle probability values use 0–1. Natural bait-drop keys are percentages from 0–100, are safely clamped to that range, and use 0 to disable a source. Natural bait is an extra tagged drop, does not replace vanilla block drops, and is not awarded in Creative. Trap catch and bait-loss chances must total at most 1. Baiting Hands reduces loss chances by 8% per rank, to a maximum 40% reduction; for example, 75% becomes 45%. A cast resolves tackle loss once, and an uneventful cast/reel costs nothing.

The old starter-storage-slots, tier-1-uncommon-chance, and bobber-offset-x/y options do not control the new systems.

Trap operation

All rods and traps in an area share its custom population. Only one trap attempts a catch per area interval, regardless of trap count. Selection balances eligible owners before selecting one of their traps. Full, unbaited, dry, and unloaded traps cannot produce catches, and unloaded time does not accumulate catch-up attempts.

Traps accept either water bait, but no lures and no realm bait, and target eligible local Common/Uncommon species. Magma Grub Bait is refused with a message, including through "Add all bait", since a water trap would consume it against a pool it can never match. The owner's Baiting Hands rank can conserve bait. Trap weight rolls receive matching-bait benefits, but not Trophy Angler's active-cast bonus.

Placement requires source water and appropriate nearby source water for operation. Open-water placement aims roughly two blocks forward and respects obstructions. Menus require the owner or an admin to remain within eight blocks. Pickup returns the trap, bait, and catches only when everything fits. Hoppers, pistons, explosions, and ordinary breaking are blocked from moving or destroying registered traps.

Economy and fish values

Set the mode to internal to force local coins, or vault to require a registered Vault provider. Required Vault mode fails startup when no provider is available. Changing modes does not convert balances between economies.

Default purchase prices under shop.buy-prices are Nightcrawler 1, Glow Grub 2, Magma Grub 4, Feather Spinner 30, Bobber Popper 35, Minnow Spoon 40, and Void Eye 140. Use the tackle IDs listed above as keys. Under shop.vanilla-prices, plain raw cod, salmon, tropical_fish, and pufferfish sell for 1, 1.5, 2, and 2 respectively.

Natural custom fish sell for:

species base price × min(fish weight ÷ species ideal weight, shop.max-weight-multiplier)

Prices are rounded to currency precision. Lighter fish can pay below base value. Older unweighted custom fish use base value. Test fish cannot be sold, and duplicate copies of an already sold unique catch cannot be sold again.

Sales inspect the player's main storage inventory, excluding armor, offhand, and cursor items. Individual-slot and bulk sales show a preview and require confirmation. The plugin rechecks items and prices before payment. Full inventories block purchases without charging, and a failed sale payment restores the fish. Test transactions against the actual economy provider, including Bedrock accounts.

Saved data, upgrades, and recovery

Population and trap data save every ten seconds and on normal shutdown. Player changes commit through SQLite transactions; the driver is bundled. Stop the server before backing up the whole plugin folder and worlds together. SQLite may have players.db-wal and players.db-shm sidecar files while running; do not copy only the main database during live operation.

An existing players.yml can be imported once and is retained afterward. Existing Tier 1 rods and tagged seed bait remain recognized. Registered legacy barrel/chorus traps migrate when loaded, preserving owners and contents; old four-slot traps round up to six. Unregistered decorative blocks are not migrated.

For rollback, restore the matching worlds, plugin data, JAR, and packs from the same backup. An abrupt crash can revert the latest world or trap/population checkpoint; those files and the database are not one atomic save. Malformed trap/population data can stop startup to protect saved state: inspect the error and restore a valid backup instead of deleting records to force startup.

Acceptance checks

1. Install the matching JAR, pack content, Bedrock pack, and both JSON mappings. Check server startup for errors.
2. Give all eight fish pages in batches and inspect inventory/drop artwork on Java and Bedrock. Use the admin rod to inspect random catches.
3. Switch to normal rods. Verify copper retains vanilla fish, iron excludes vanilla/Common fish, high rarities need tackle, and habitat/conditions apply.
4. Attach, swap, and remove tackle through inventory and crafting. Check bite/snags, conservation, and removal of consumed tackle on both clients.
5. Crouch-use an uncast rod to open the hub. Test touch forms separately from keyboard/controller inventory menus, including skill and sale confirmations.
6. Catch a natural fish, inspect its weight and diary record, gain/spend skill points, then test individual and bulk sales. Verify test fish cannot earn rewards.
7. Craft each trap tier with the correct rank. Test source-water placement, swimming placement, bait switching, collection, pickup, shared stock, and unloading.
8. Cast into the End's void and into Nether lava with an iron rod and the matching tackle. Confirm the bobber anchors, one bite resolves inside the configured window, the catch and its diary/XP/sale behavior match a water catch, and neither species ever appears in water or a trap.
9. Restart and verify saved skills, diary, balances, trap contents, and capacities.
10. Craft a Sushi Station (it is in the recipe book) or /gnf give sushi_station, place it, and confirm it shows as a sushi counter with the Crops 0.15.4 pack, right-click opens the station, redstone, pistons and a block placed under it do not change it, and breaking it returns the station. Prepare one tier dish and one named dish; every dish and both cook book buttons show their art on Java and Bedrock.

The gameplay checklist and visual checklist provide deeper coverage. The 0.2.3 presentation baseline was confirmed in game; 0.4.3 still requires live server, Java/Bedrock, touch/controller, and protection-plugin acceptance testing. Automated validation does not replace those checks.

Troubleshooting