Familiars: Reimagined API

| Video/Text Guides Coming Soon | Planned Versions: Forge 1.19.x 1.20.x Neoforge 1.21+ |

Latest Version: Forge 1.18.2 - 0.2.5a

| REQUIRES Geckolib | API Contains NO CONTENT | No Fabric Port Planned | Mod is in ALPHA |

Featured Packs: Familiars: Minecraft Pack | Classic Familiars Pack (WIP) |

This is a Remake/Reimagining of the old Familiars Mod from 1.7.10. One of my old favorite mods that was never updated and lost to time. It doesnt even directly exist on the internet.
Original Familiars Mod Video

✨ Your Gateway to Magical Companions in Minecraft

Familiars: Reimagined API is a comprehensive framework for creating magical companion mods in Minecraft. It handles all technical aspects - persistence, networking, UI, and progression systems - so developers can focus on designing unique familiars and abilities. The API features a robust ability system (passive/active/ultimate abilities), quest framework with varied progression, and a polished player interface with quick-swap functionality and skin customization. With annotation-based registration and automatic state management, developers can easily create immersive familiar packs that seamlessly integrate with this foundation.
🌟 What Are Familiars?

Familiars are magical companion entities that players can unlock through quests or XP investment. Each familiar comes with its own unique model, animations, and up to three ability slots that unlock progressively. These abilities range from passive bonuses to powerful activated skills that can assist in combat, resource gathering, or exploration. Familiars follow players on their adventures, providing tactical advantages based on their specialty.

Familiar Creeper
📚 Core Features
For Players

Magical Allies: Expand your Minecraft journey with enchanting companions from various content packs. Each familiar brings its own distinct personality, visual style, and specialized abilities to your adventures. Creator packs can introduce entirely new gameplay mechanics and unique familiar interactions beyond the standard framework!

Default Familiars Pack Icons
Progression Pathways: Embark on tailored quests that challenge your skills while unlocking new familiar companions. Face unique objectives like rare item gathering, monster hunting, or exploration challenges to earn your magical allies. For those preferring a different approach, invest experience points to bypass quest requirements and instantly add familiars to your collection.

Simple Power System: Unlock up to three distinct ability slots for each familiar as you progress, transforming novice companions into formidable allies. Each slot reveals new powers that complement the familiar's specialty - from passive enhancements to powerful activated abilities. Master both your familiar's primary strengths and their secondary powers to create synergistic combinations that match your playstyle.

API Guides coming soon
For Developers

Complete API Framework: Create addon packs with your own custom familiars
Quest System: Design unique unlock requirements using annotations
Ability Framework: Implement powerful familiar abilities with minimal boilerplate code
Factory System: Utilize ready-made utility functions for common operations
Data Persistence: Seamlessly save and load familiar data between play sessions
Visual Effects: Create stunning particle effects and animations for abilities

The Familiars Mod API is designed with extensibility in mind. Our factory system provides ready-made components for:

Effect Creation: Generate particles, animations, and visual effects
Familiar Data Management: Track and persist familiar state between sessions
Quest Implementation: Create custom unlock challenges with minimal code
Method Utilities: Access common operations for blocks, entities, and items
Cooldown Management: Handle ability timing and balance
Persistent Data Storage: Save custom data for your familiars

🔧 Installation

Install Minecraft Forge for 1.18.2
Download and install GeckoLib 3.0.57
Place the Familiars: Reimagined API JAR file in your mods folder
Add any familiar packs you want to use

🧩 Compatibility

Minecraft: 1.18.2
Forge: 40.2.0+
GeckoLib: 3.0.57

🤝 Community & Support

Discord Server: [Link] Join our community for help and showcasing your creations
Wiki: [Link] Comprehensive documentation and tutorials
GitHub: [Link] Report issues and contribute to development
CurseForge: [Link] Download the latest versions and addons

👑 Credits & Permissions

Feel free to include this mod in modpacks
Please provide credit when using this API in your projects
Submit your custom familiar packs to our community showcase!