Custom Mobs Framework

An advanced, high-performance, and fully configurable mob creation system designed to bring custom entity design and complex AI logic to your Minecraft world. Whether you want to design powerful boss battles, flying ambient creatures, or custom ranged attackers with unique projectile effects, Custom Mobs Framework provides the complete engine to create, manage, and spawn custom mobs.

Featuring dynamic visual UI screens and in-game creator tools for server operators

🎮 Player Features

📖 1. Custom Mobs Bestiary (Codex)

Unlock, record, and track your custom mob encounters from a premium, dark-themed bestiary interface.

• 3D Rotating Viewports: Interact with a live 3D preview of each custom mob.
• Unlock Progress: Undiscovered mobs show up as mysterious dark silhouettes with general lore descriptions until you defeat them.

⚔️ 2. Elite Mobs & Boss Fights

Challenge custom mobs spawned dynamically in your world or through raid events.

• Elite Mobs: Special variations of custom mobs with amplified health, damage, and prefix names.
• Custom Ranged Attacks: Face mobs that shoot custom projectiles equipped with gravity adjustments, custom velocities, and explosive or particle-trail qualities.

🌍 3. Natural Spawning & Habitats

Encounter custom mobs naturally as you explore the world.

• Dynamic Spawn Control: Mobs spawn dynamically in designated biomes based on configured weights.
• Habitat Restrictions: Experience tailored spawns restricted to specific biomes, dimensions, or structures.

🛠️ Admin Features

🖥️ 1. In-Game Mob Creator

Design and customize new mob templates directly inside the game using an expansive, dynamically scaling GUI editor.

• Flexible Model Integrations: Configure any model type! Supports standard Vanilla mobs, GeckoLib animated JSON models, and custom Java classes.
• Advanced AI Goal Selection: Toggle and configure complex behaviors such as Melee, Ranged, Stalking, Flight/Hover physics, Teleporting (on hit, low health, or behind target), Burrowing, Summoning minions, and Fleeing/Seeking water, fire, rain, or light.
• Visual Hitbox Editor: Scale hitboxes (X/Y/Z) using precise sliders without affecting model dimensions, featuring an in-game wireframe toggle to preview the active hitboxes.

☄️ 2. In-Game Projectile Creator

Build custom ranged attacks from scratch in a visual designer screen.

• Custom Textures & Models: Assign specific 3D model IDs or item textures to projectiles.
• Physics Controllers: Toggle gravity flags (enable or disable gravity calculations for straight-line trajectories).
• Visual Effects: Bind custom particle trails and customize detonation explosions (with block-breaking toggles).

🗄️ 3. Asynchronous SQLite Engine

Built to ensure zero lag, even on high-population servers.

• Asynchronous Database Queue: Discoveries, statistics, and world data are saved to a localized world SQLite database via a separate, single-threaded queue to prevent server main thread freezes.
• Dual-Layer Caching: Mob templates and bestiary entries are cached in memory for instantaneous GUI loading, with scheduled background database flushes.

🧠 4. AI Behavior & Priority Overrides

Fine-tune how your entities navigate and interact with players and the environment using the visual goal selector.

• Goal Hierarchy: Assign priorities to behaviors to control which actions take precedence (e.g., Melee or Ranged combat vs. passive wandering).
• Stalking Transitions: Integrate pre-combat stalking phases that restrict combat goals until the mob has been seen/lost a specific number of times.
• Teleport-Behind Attacks: Trigger immediate attack and look-angle overrides during teleportation goals to catch players off-guard.

🌍 5. Custom Natural Spawning Rules

Configure template properties to control how and where your custom mobs generate natively in survival mode.

• Biome Filters: Define whitelist/blacklist filters using standard resource locations (e.g., minecraft:desert, minecraft:plains).
• Weight & Group Sizes: Configure spawn weights to control frequency, and set minimum/maximum pack sizes for native spawns.
• Dynamic Reloading: Changes to templates and spawning properties reload dynamically in-game without needing client or server restarts.

⚔️ 6. Custom Raid & Spawner System

Set up placeable spawners to trigger wave-based battle encounters with unique rewards.

• Raid Spawner Blocks: Place spawner blocks in the world and bind them to specific custom raid templates.
• Wave Configuration: Configure the number of waves, spawn pools per wave, and maximum mobs allowed at once.
• Custom Reward Tables: Grant players items or execute custom console commands upon successful completion of the raid.

🔧 7. Configuration & Commands

Administrators can configure mod settings inside the server_config.json file or use in-game commands (Permission Level 2 required):

💬 Command Reference

Admin Commands

Administrators (Permission level 2/Operator required) can execute the following commands to configure and manage the framework:

• /custom_mobs creator-ui - Opens the main visual Mob Creator GUI editor.

• /custom_mobs projectile-creator-ui - Opens the visual Projectile Creator GUI editor.

• /custom_mobs reload-config - Reloads all mob templates, configurations, and raids from files.

• /custom_mobs status - Shows active custom mob statistics in the current level.

• /custom_mobs killall - Cleans up and discards all active custom mobs.

• /custom_mobs spawn <mob_id> [count] - Spawns a custom mob with an optional count.

• /custom_mobs spawn-mob <mob_id> <is_elite> - Spawns a custom mob, specifying whether it spawns as an Elite variant.

• /custom_mobs spawn-projectile <projectile_id> - Fires a custom projectile from the player's current view vector.

• /custom_mobs bestiary add <player> <mob_id> - Unlocks a discovery in a player's bestiary.

• /custom_mobs bestiary remove <player> <mob_id> - Removes a discovery from a player's bestiary.

• /custom_mobs raid start <raid_id> - Starts a custom raid (globally or on the nearest raid spawner block).

• /custom_mobs raid stop <raid_id> - Stops an active raid.

• /custom_mobs raid info - Lists all currently active raids.

• /custom_mobs add-raid-reward <raid_id> <reward_type> <value> - Adds a reward (item or command) to a raid template.

📌 Dependencies & Installation

• Fabric: Requires Architectury API and Fabric API.
• Forge: Requires Architectury API.