Back to mods
Aeonis project artwork

Modrinth · Minecraft mod

Aeonis

Possess and control any Minecraft mob in first person using Fabric commands—fly as the Ender Dragon, fire Wither skulls, blink, dash, and summon combat pets.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Aeonis release matches 26.1?

Updated 6 months ago
Best match for your filters 4.5
Game version 26.1, 26.1-pre-1, 26.1-pre-2
Loader Fabric, Quilt

Aeonis 4.5 targets 26.1, 26.1-pre-1, 26.1-pre-2 with Fabric, Quilt. Installation on the client is optional. Installation on the dedicated server is optional. All 2 required mods have matching files.

Where it goes

Is Aeonis required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Fabric, Quilt
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does Aeonis 4.5 need?

4.5 on 26.1. Every mod below is checked against that same setup.

All 2 required mods have matching files

Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

Fabric API Needed by Aeonis 4.5
required
Matching file found Matched file: 0.155.3+26.1.2

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Aeonis without breaking your instance.

Built for Aeonis 4.5 on 26.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 4.5. It targets 26.1, 26.1-pre-1, 26.1-pre-2 with Fabric, Quilt; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 4.5. It opens that exact file at the source.

About this project

What does Aeonis add?

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.

Component Version
Minecraft 26.3
Java 25 (minimum for both build and runtime)
Gradle 9.5.1 (via the included wrapper)
Fabric Loader 0.19.5 or newer
Fabric API 0.161.0+26.3
Fabric Language Kotlin 1.14.1+kotlin.2.4.20
Fabric Loom 1.17-SNAPSHOT
NeoForge 26.3.0.6-beta
NeoGradle (userdev) 7.1.39
KotlinForForge 6.3.0 or newer
Mod Menu (optional, Fabric only) 21.0.0-beta.1

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.

Module Purpose
common Loader-agnostic game logic: commands, entities, items, dimensions, the transform/possession system, and the AI assistant. Compiled against Minecraft with Fabric Loom in the unobfuscated workflow.
fabric Fabric entrypoints, mixins, client rendering, networking, and fabric.mod.json.
neoforge NeoForge entrypoints, mixins, client rendering, networking, and neoforge.mods.toml.

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

Command Description
/transform <entity> [variant...] Transform into a mob. Accepts an entity ID and optional variant arguments.
/untransform Return to your normal player form.
/exitbody s Exit to Survival mode.
/exitbody c Exit to Creative mode.

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

Command Description
/prank smite <players> Strike with lightning.
/prank yeet <players> Launch into the sky.
/prank disco <players> Party effects.
/prank supersize <players> Scale players up.
/prank smol <players> Scale players down.
/prank chaos <players> Three random effects.
/prank rocket <players> Rocket launch.
/prank spin <players> <times> Spin players.
/prank freeze <players> Freeze in place.
/prank burn <players> Set on fire.
/prank drunk <players> Nausea and blindness.
/prank boing <players> Super bounce.
/prank confetti <players> Firework confetti burst.
/prank swap <player_a> <player_b> Swap two players.
/prank morph <players> <type> Temporary transform for two minutes.

Event tools

Command Description
/event ambush Surprise mob ambush.
/event scan Scan for hostiles nearby.
/event thunder Start the thunder dome event.
/event copper Drop copper on players.
/event time <ticks> Warp time forward.
/event cleanse <players> Remove all effects.
/event crit_save Critical save (revive).
/event pro_gamer Pro gamer mode.
/event exitbody <s|c> Exit body (Survival or Creative).

Abilities

Command Description
/ability mimic zombie Play the zombie ambient sound.
/ability mimic wither Play the wither ambient sound.
/ability mimic ghast Play the ghast cry.
/ability mimic dragon Play the dragon growl.
/ability dash Quick dash forward.
/ability blink <range> Teleport a short distance.
/ability jump Moon jump.
/ability roar Warden roar.
/ability darkness Darkness pulse.
/ability summon vex Summon a pet vex.
/ability summon wolves <count> Summon spirit wolves.

AI tools

Command Description
/ai chaotic <entities> Enable chaotic AI (experimental).
/ai chaotic stop Disable chaotic AI.
/ai director <entities> walk_to <x y z> [speed] Walk entities to a position.
/ai director <entities> look_at <target> Make entities look at a target.
/ai director <entities> attack <target> Make entities attack a target.
/ai director <entities> stop Stop all orders for entities.

System and features

Command Description
/aeonis soul Enter soul mode (spectator, possess with the P key).
/aeonis unsoul Exit soul mode.
/aeonis sys ping Show server and mod stats.
/aeonis sys story Show Aeonis story flavour text.
/aeonis help Show the in-game help listing.
/aeonis reload Reload all mod features and reset state.
/aeonis features extra_mobs Query whether Aeonis custom mobs are enabled.
/aeonis features extra_mobs <true|false> Enable or disable Aeonis custom mob spawning.

Companion bots

Command Description
/comp spawn Spawn a companion bot.
/comp mode <mode> Set the companion behaviour mode (attack, follow, retreat).

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.

Project description from Modrinth.

Pick your setup

Aeonis by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

62 available setups

Showing the newest 12 of 30 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Aeonis versions and loaders

6 of 17 releases match
Clear filters

Looking for an older file? The official Modrinth project page is in Resources.