Overview and Mod Architecture
Fzzy Core is an API and foundational library developed by fzzyhmstrs to assist Kotlin mod development. Originally created by separating Amethyst Core into distinct functional modules, it serves as the foundational layer for other projects in the author's catalog, such as Amethyst Core for magic-themed mods. Both client and server installations are required. The library supports the Fabric and Quilt mod loaders on Minecraft versions 1.20 and 1.20.1 under the MIT License, with no Forge port planned at this time.
Permanent Modifier Framework
The library introduces a modifier system engineered as an alternative parallel to vanilla enchanting. Here's the thing, rather than standard enchantments that can be stripped away, modifiers function as permanent affixes that can't be removed by grindstones. Modifiers encapsulate their functionality internally and trigger as a unified entity rather than piecemeal routines. They also support hierarchical family trees for descriptive progression stages, allowing gear to advance through thematic tiers like Rusty, Shiny, and Gleaming, accompanied by built-in helper utilities to present modifiers in gold tooltip text.
Item Frameworks and Gameplay Mechanics
Fzzy Core supplies several specialized frameworks for building custom items and game mechanics:
- Mana Equipment: A dedicated framework enables developers to construct items fueled by mana rather than consuming standard durability damage.
- Flavor Text Systems: Authors can attach descriptive flavor text and explanatory functionality lines to standard items or tools through language files or dedicated methods.
- Persistent Timed Effects: The system allows the creation of delayed, recurring, or non-repeating events operating independently of specific object tick cycles.
- Point-of-View Particles: A client-side visual tool positions particles at designated coordinates within a player's perspective, facilitating effects such as dripping handheld objects or smoking torches.
Configuration Syncing and Development Utilities
To simplify project maintenance, Fzzy Core provides an automatic configuration synchronization system using Kotlin functionality. Server configuration settings automatically sync to connecting client players upon joining. The configuration utility includes helper routines that automatically update configuration files to newer formats while preserving stored settings from older versions.
For general coding assistance, the library includes a configurable base enchantment class that allows individual enchantments to be toggled on or off. A multi-version text wrapper helps prevent merge conflicts across text updates, while integrated KDoc documentation throughout the source assists mod developers during implementation.
