AEONIS: Command Master

Transform into mobs, control unique abilities, run AI-powered command workflows, and explore custom dimension content in one Fabric mod.

From the creators of BLITZ (formerly Emberveil).

Version and Platform

• Current release: 4.0.0 (First Stable 26.1 Release)
• Minecraft: 26.1 (26.1.1 hotfix compatible)
• Loader: Fabric
• License: MIT

What Aeonis Does

Aeonis combines several systems in one mod:

• Mob possession and transformed combat
• AI assistant command execution and automation tools
• Utility/admin commands for events, abilities, and fun tools
• Custom entities and progression content
• Dimension and worldgen expansions

Main Features

1) Mob Possession System

Take direct control of many vanilla mobs in first-person with movement adapted to each mob type.

• Flight support for flying mobs
• Aquatic movement for water mobs
• Left-click special attacks for select mobs
• Cooldown-aware combat flow

Core commands:

/transform <entity>
/untransform
/exitbody s
/exitbody c

Examples of special attacks:

• Wither: explosive skulls
• Ender Dragon: dragon fireballs
• Breeze: wind charges
• Blaze/Ghast: projectile fire attacks

2) AI Assistant (LLM)

Spawn an AI companion that can chat, generate commands, and execute allowed in-game workflows.

Core commands:

/ai llm spawn
/ai llm despawn
/ai llm config

Supports:

• OpenAI
• Google Gemini
• OpenRouter

Workflow features:

• Command execution tags
• Persistent scripts
• Custom command packs
• Scheduled automation tasks

3) Command Systems

Aeonis command families include:

• /prank (fun and chaos tools)
• /ability (mob-like powers)
• /event (event/admin actions)
• /ai (AI controls)
• /aeonis (system/help/features)

Sample prank commands:

/prank smite <players>
/prank yeet <players>
/prank disco <players>
/prank morph <players> <chicken|pig|goat|frog|parrot|random_funny>

Sample ability commands:

/ability dash
/ability blink <range>
/ability roar
/ability summon vex

4) World and Entity Content

• Ancard content line and visual atmosphere systems
• Deeper Dark dimension expansion content (biomes, structures, worldgen pipeline)
• Custom mobs including Copper Stalker line and additional ecosystem entities

4.0.0 Highlights (First Stable 26.1)

• First non-snapshot stable build on Minecraft 26.1
• Migration cycle completed from 1.21.11 to 26.1
• Transform/untransform cleanup reliability improvements
• Camera/interaction stabilization for transformed gameplay
• Warning policy remaster (less global spam, targeted notices only)
• Localization refresh for active Aeonis namespaces

Gameplay Notes

• Soul mode command: /aeonis soul
• Possess target in soul mode with P
• Use /aeonis help for full in-game command help

Installation

1. Install Fabric Loader for Minecraft 26.1
2. Install Fabric API
3. Install Fabric Language Kotlin
4. Place Aeonis jar in the mods folder
5. Launch Minecraft

Requirements

• Minecraft 26.1
• Java 25+ recommended for this release line
• Fabric Loader 0.18.5+
• Fabric API 0.144.3+26.1
• Fabric Language Kotlin 1.13.10+kotlin.2.3.20

Quick Start

/aeonis help
/transform minecraft:ender_dragon
/untransform
/ai llm spawn

For technical detail and full release history, see the project README and changelog in the source repository.

Aeonis

A gameplay and world-content mod for Minecraft, available for both Fabric and NeoForge.

Aeonis adds player and mob transformation, AI-assisted command and control systems, custom dimensions and progression hooks, unique animated mobs, and supporting rendering and utility tooling.

• Version: 5.0.0
• Minecraft: 26.3
• Loaders: Fabric and NeoForge
• License: GPL-3.0-or-later (see LICENSE)

Requirements

Verified against the official Fabric, NeoForged, and Mojang metadata for the 26.3 line.

Mappings are the official Mojang mappings in the unobfuscated workflow. Yarn and intermediary are no longer used anywhere in this project.

Two dependency notes worth reading before reporting a launch problem:

• NeoForge has not published a non-beta build for 26.3 yet. 26.3.0.6-beta is the newest build on the 26.3 line; there is no release or RC.
• KotlinForForge does not yet support Minecraft 26.3. See Known limitations in TODO.md.

Installation

Install the jar that matches your loader. Both jars are built from the same source tree and are not interchangeable.

1. Install Fabric Loader 0.19.5+ or NeoForge 26.3.0.6-beta for Minecraft 26.3.
2. On Fabric, also install Fabric API.
3. Place AeonisCM-5.0.0.jar (Fabric) or aeonis-5.0.0.jar (NeoForge) in your mods directory.
4. Mod Menu is optional on Fabric and only provides the config entry point.

Building from source

A fresh clone builds both jars with a single command:

./gradlew build

Artifacts are written to:

• fabric/build/libs/AeonisCM-5.0.0.jar
• neoforge/build/libs/aeonis-5.0.0.jar

To build one loader only:

./gradlew :fabric:build
./gradlew :neoforge:build

The first build downloads Minecraft, the loader toolchains, and mappings, and can take several minutes. Java 25 must be available; the build requests a Java 25 toolchain and does not rely on a hardcoded JDK path.

Testing a build

Two helpers under scripts/ check a build without needing a launcher or an account.

Boot the mod in a real PolyMC instance and confirm the client reaches the main menu:

python3 scripts/mc-smoke-test.py

It builds the Fabric jar, copies it into the instance's mods/ folder, launches Minecraft with that instance's own libraries and assets, and exits non-zero on a crash, a mixin apply error or an entrypoint failure. Use --instance, --polymc-home or the POLYMC_HOME environment variable to target another instance, --no-build to reuse the existing jar, and --dry-run to inspect the launch command.

Check that every mixin still targets code that exists in the current Minecraft jar:

python3 scripts/check-mixin-targets.py

This resolves @Inject, @Redirect, @Accessor and @Shadow selectors against the deobfuscated jar with javap, catching renames and signature changes that compile cleanly and then fail at runtime. Run ./gradlew :fabric:build at least once first, so that the jar it inspects has been produced.

Project layout

Aeonis is a three-module Gradle build. The split is deliberate: the mod is large and stateful, and both loaders share a single implementation of the gameplay systems so that behaviour cannot silently diverge between them.

Both loader modules depend on common and shade its output into their own jar.

Why a manual multi-project layout

Architectury API was considered and rejected. Aeonis depends heavily on mixins targeting vanilla classes and on a custom transform/possession system that needs per-loader event wiring; Architectury's abstraction layer would have obscured those without removing the need for loader-specific mixin code. A plain multi-project Gradle build keeps each loader's entrypoints and mixins explicit and lets common own the shared logic directly. Config screens use a small per-loader shim rather than a third-party config library, since the existing screens are hand-written.

Commands

All commands require operator permissions unless noted.

Transformation

Examples:

/transform minecraft:zombie
/transform minecraft:wither
/transform minecraft:ender_dragon
/transform minecraft:breeze
/transform minecraft:phantom
/transform minecraft:ghast
/transform minecraft:bee
/transform minecraft:dolphin
/transform minecraft:creeper
/transform minecraft:skeleton
/transform minecraft:blaze
/transform minecraft:enderman

Prank

Event tools

Abilities

AI tools

System and features

Companion bots

AI assistant

The /ai command tree is backed by a configurable LLM integration supporting OpenAI, OpenRouter, and Gemini. API keys and provider selection are configured through the in-game config screen or the Aeonis/llm config file. The assistant can both issue commands and run saved scripts, and it is subject to an operator-configurable allowlist of executable commands. Treat API keys as secrets: they are stored in the config file, not in the world save.

Maintainer notes

Updating to a new Minecraft version

The 26.1 to 26.3 update followed this checklist. It is kept here because it remains the right sequence for the next version bump.

1. Update the Gradle wrapper and confirm the Java baseline the new version requires.
2. Update gradle.properties with the new Minecraft, loader, Fabric API, NeoForge, Loom, and Kotlin versions. Verify each against its official source rather than copying a blog post; beta tags are promoted quickly.
3. Re-check mapping assumptions. This project uses official Mojang mappings in the unobfuscated workflow; do not reintroduce Yarn or intermediary.
4. Sweep for removed or renamed vanilla API. The 26.3 update required, among others, moving entity constants from EntityType to EntityTypes, renaming Entity.hurtMarked to syncVelocity, replacing Entity.setInvulnerable with setPermanentlyInvulnerable, moving the current screen from Minecraft to Gui, replacing GuiGraphics with GuiGraphicsExtractor for HUD elements, and renaming InputConstants.Type.KEYSYM to KEYBOARD.
5. Audit every mixin against the new mappings. Mixins fail at runtime rather than compile time when their target disappears, so check each one by hand.
6. Re-validate worldgen and data pack registries. Legacy datapack content is currently excluded from processResources in the loader modules; see TODO.md.
7. Regression-test the transformed-gameplay paths on both loaders, especially transform and untransform cleanup.
8. Update this README, CHANGELOG.md, and the mod metadata files.

Releasing

1. Set mod_version in gradle.properties.
2. Run ./gradlew clean build and confirm both jars are produced.
3. Verify the version stamped into fabric.mod.json and neoforge.mods.toml inside each jar.
4. Add a CHANGELOG.md entry.

Changelog entries live in CHANGELOG.md.

License

Aeonis is licensed under the GNU General Public License v3.0 or later. Copyright (C) 2025-2026 Aevora Labs. See LICENSE.