Familiar Helpers v0.4.0 — Alpha 🎣

🆕 New Familiar — Fisher Familiar

This update introduces the third helper to Familiar Helpers — the Fisher Familiar!

This little golem automatically catches fish, collects treasures, and delivers its catches to an assigned chest. Like the other familiars, it is summoned using the Awakening Altar.

🎣 Fisher Familiar Features

Automatic Fishing

• Automatically searches for suitable water within a 9-block horizontal radius and ±5 blocks vertically from the altar.

• Finds a suitable standing position, walks to the shore, and casts its fishing rod.

• Can fish from elevated positions if the water is within reach and the casting path is clear.

• Uses Minecraft's authentic vanilla fishing mechanics.

• Catches fish, treasure, and junk using the standard fishing loot tables.

• Respects vanilla open-water requirements for obtaining treasure.

Real Fishing Rod and Enchantments

• Requires a real fishing rod to operate.

• Fishing rods have durability and gradually wear down.

• Supports Luck of the Sea, Lure, and Unbreaking.

• Mending uses experience gained from catches to repair the fishing rod. Any remaining experience is discarded.

• The Fisher stops working when its fishing rod breaks.

Inventory and Delivery

• 9 inventory slots for catches and a separate 10th slot for the fishing rod.

• When all 9 catch slots are occupied, the Fisher heads to its assigned chest, even if the item stacks are not full.

• Physically walks to the chest and deposits its catches.

• Supports regular and double chests.

• Returns to fishing after delivering its catches.

• If the chest is full or unavailable, the Fisher keeps its items and retries later.

• Inventory and settings are saved when leaving and rejoining the world.

⚙️ Fisher Familiar Controls

Two settings are available in the interface:

• Work — enables or disables automatic fishing.

• Delivery — enables or disables depositing catches into a chest.

Assigning a Fishing Spot

1. Shift + Right-click the Fisher Familiar.

2. Shift + Right-click the block where you want it to fish.

3. The Fisher will use the selected location instead of automatically searching for a fishing spot.

If the assigned location becomes unavailable, the Fisher will wait until conditions are suitable again.

Assigning a Chest

1. Shift + Right-click the Fisher Familiar.

2. Shift + Right-click the desired chest.

3. The Fisher can now deliver its catches to that chest.

The fishing spot and delivery chest can be assigned independently.

✨ New Item — Enchanted Bobber

To summon the Fisher Familiar, you'll need an Enchanted Bobber.

Place it inside the Awakening Altar to summon your new helper. To start fishing, place a real fishing rod in the Fisher's dedicated rod slot.

📦 Enchanted Bobber Crafting Recipe

Result: 1 Enchanted Bobber.

All ingredients are consumed when crafting. The summoned Fisher Familiar requires a separate fishing rod to operate.

🎨 New Model and Animations

The Fisher Familiar features a unique model designed in the Familiar Helpers style:

• Compact body and glowing eyes.

• Fishing bucket hat and vest.

• Unique custom-made texture.

• Summoning and disappearing animations at the altar.

• Walking, casting, waiting for a bite, and reeling animations.

• A real fishing rod is displayed in its hand, with the fishing line connected to the rod's tip.

🔧 Improvements and Fixes

• Maintained compatibility with existing worlds from previous versions.

• Improved water detection and casting trajectory calculations.

• Added protection against lost or duplicated catches.

• Improved inventory and assignment persistence.

• Removed outdated debugging commands.

• Cleaned up unnecessary resources from the release build.

• Preserved existing Farmer and Shepherd Familiar functionality.

📋 Compatibility

• Minecraft: 26.1.2

• Mod Loader: Fabric

• Java: 25 or newer

• Fabric Loader: 0.20.1 or newer

• Fabric API: Bundled — no separate installation required

Release Status: Alpha.

The mod has been tested in singleplayer, including loading copies of worlds from previous versions. Dedicated server and multiplayer functionality have not yet been manually tested.

Thank you for your interest in Familiar Helpers! 🌿

You now have three little helpers: Farmer, Shepherd, and Fisher. Each has its own job, helping you automate everyday tasks while preserving the vanilla Minecraft experience.