Alex’s Caves — Unofficial NeoForge 1.21.1 Port

An unofficial port of Alex’s Caves for Minecraft 1.21.1 NeoForge, bringing the original cave biomes, creatures, structures, equipment, blocks, items, and exploration experience to a newer version of Minecraft.

About This Port

This project is an unofficial community port of the original Alex’s Caves mod.

The purpose of this project is to make Alex’s Caves playable on Minecraft 1.21.1 with NeoForge while preserving the gameplay and content of the original mod as closely as possible.

This project is not an official update to Alex’s Caves and is not affiliated with, sponsored by, or endorsed by the original developers.

Original Project & Credits

All credit for the original Alex’s Caves mod, including its original code, concepts, textures, models, animations, sounds, mobs, blocks, items, biomes, structures, and other assets, belongs to AlexModGuy and the original Alex’s Caves contributors.

I do not claim ownership of the original Alex’s Caves content.

Please support and visit the original project:

Original Alex’s Caves — CurseForge:
https://www.curseforge.com/minecraft/mc-mods/alexs-caves

Original Alex’s Caves — Source Code:
https://github.com/AlexModGuy/AlexsCaves

How This Project Differs From the Original

The original Alex’s Caves release targets Minecraft 1.20.1, while this project ports the mod to:

Minecraft 1.21.1
Mod Loader: NeoForge

The primary changes in this project are technical changes required to make the original mod function on Minecraft 1.21.1 and the newer NeoForge environment.

Porting work includes changes such as:

• Updating Minecraft 1.20.1 code for Minecraft 1.21.1

• Updating Forge systems to their NeoForge equivalents

• Updating mod initialization and event handling

• Updating blocks and item registration

• Updating entity registration

• Updating biome and world-generation systems where necessary

• Updating networking and packet handling

• Updating client/server communication

• Updating rendering systems

• Updating entity renderers and animations where required

• Updating configuration handling

• Updating capabilities and attachment-related systems

• Updating sound registration and playback systems

• Updating fluid-related systems

• Updating keybind and client-side event handling

• Replacing APIs that were removed or changed between Minecraft versions

• Fixing crashes and incompatibilities caused by the Minecraft/NeoForge version transition

• Additional compatibility and stability fixes required for Minecraft 1.21.1

The goal is not to redesign Alex’s Caves.

The goal is to preserve the original mod's content and gameplay while adapting the underlying code so that it can function correctly on Minecraft 1.21.1 NeoForge.

Features

The port aims to retain the content and experience of Alex’s Caves, including:

• Rare underground cave biomes

• Unique creatures and bosses

• New blocks and building materials

• Weapons, tools, armor, and equipment

• Underground structures

• Cave-specific resources

• Special mechanics and progression systems

• Vehicles and other unique gameplay systems

• Original animations, models, textures, and sounds

• Exploration-focused underground gameplay

Some systems may behave differently from the original version when changes are required because of differences between Minecraft 1.20.1 Forge and Minecraft 1.21.1 NeoForge.

Requirements

Minecraft: 1.21.1
Mod Loader: NeoForge
Environment: Client & Server

Additional dependencies required by the port should be installed according to the dependency information shown on the CurseForge download page.

Development Status

This is an unofficial port and is still being updated and tested.

Because Alex’s Caves is a large and complex mod, there may be differences, bugs, crashes, rendering problems, networking problems, or other compatibility issues that do not exist in the original Minecraft 1.20.1 release.

Bug fixes and compatibility improvements may be included in future versions of the port.

If you encounter an issue, please provide as much information as possible, including:

• Minecraft version

• NeoForge version

• Port version

• Installed mods

• Crash report or latest.log

• Steps to reproduce the problem

License

This project uses the GNU General Public License version 3 (GPLv3), matching the license used by the original Alex’s Caves CurseForge project.

The original copyright notices and appropriate attribution are retained.

This port does not change ownership of any original Alex’s Caves content.

For information about the original project and its licensing, please visit:

https://www.curseforge.com/minecraft/mc-mods/alexs-caves

Original source repository:

https://github.com/AlexModGuy/AlexsCaves

Disclaimer

This is an unofficial community-maintained port.

It should not be confused with an official Alex’s Caves release. Questions or bug reports specifically related to this 1.21.1 port should be directed to the port project rather than the original developers.

Please support the original Alex’s Caves project and its creators.