Angler's Almanac

An award-recognized Hytale fishing framework mod written in Java, featuring a JSON-driven progression architecture, adaptive minigames, and a third-party developer API.

HytaleJavaGame
Angler's Almanac screenshot

Hytale Modding Contest Finalist: Experiences

Recognized as a "Hidden Gem" by CurseForge.

Overview

Angler's Almanac transforms fishing across Orbis from a simple side activity into a rich, progression-driven adventure. It introduces a complete gameplay loop with biome-specific ecosystems, rarity-scaled interactive minigames, and a dedicated discovery journal.

As Lead Developer & Software Architect, I built the core Java codebase from the ground up—designing the data-loading pipelines, user interfaces, and an extensible developer API adopted by third-party community mods.

Tools & Technologies: Java, Hytale Modding API, JSON Data Schemas, Hytale Asset Editor (HAE), Git


Technical Contributions

1. Extensible Developer API & Event System

Rather than keeping mechanics isolated, I designed Angler's Almanac as a modular foundation for other creators:

  • Event-Driven Hooks: Modders can tap directly into gameplay lifecycle events—such as FishingRodCastEvent, bait consumption, and successful catches—to trigger custom logic.
  • Data Access: Developers can read live catch statistics, query player logs, and register custom fish species or biome-specific loot tables.
  • Official Documentation: Wrote the Official Developer Wiki with guides and code examples, making it easy for community mods and server plugins to integrate out of the box.

2. JSON-Driven Architecture & Hytale Asset Editor (HAE)

To avoid hardcoding gameplay balance into compiled binaries, the mod separates mechanics from content:

  • Fully Moddable JSON Schemas: loot, spawn weightings, biome requirements, and rarity tiers live in clean JSON files for quick tuning and additions.
  • Hytale Asset Editor Integration: Designed custom schemas fully compatible with the built-in Hytale Asset Editor. Server owners and creators can balance loot pools, configure custom bait, and design new fishing rods visually without writing code or recompiling the jar.

3. The Almanac Book & Player Tracking

The Almanac acts as the player's personal in-game compendium


Media & Project Showcase

Showcase

Link


Direct Impact

  • Selected as a Finalist in the CurseForge Hytale Modding Contest (Experiences category) and featured as a CurseForge "Hidden Gem".
  • Integrated as an underlying framework dependency by server plugins and external studio projects, including GINCo's Byte Crashers.

Authors

The Team

  • @RM20: Lead Developer & Software Architecture.
  • CapnSloth: Designer of the original Stardew Style Fishing mod concept for Hytale.
  • ColdLavenderSun (Aka. Fluttershy): Promotional and UI art assets.

Support the Project

  • Support development on Buy Me a Coffee
  • Use Creator Code RM20 when purchasing Hytale.
  • Watch live development streams on Twitch.
  • Watch the development process live on Twitch.