Installation¶

This guide covers installing Better Ecology for Minecraft 1.21.1.

Requirements¶

Installation Steps¶

1. Install Fabric Loader¶

1. Download the Fabric installer from fabricmc.net
2. Run the installer and select Minecraft 1.21.1
3. Click "Install"

2. Download Dependencies¶

Download the following mods and place them in your mods folder:

• Fabric API - Required for all Fabric mods

3. Download Better Ecology¶

Download the latest Better Ecology release from the releases page.

4. Install the Mod¶

1. Locate your Minecraft installation folder:
2. Windows: %appdata%\.minecraft
3. macOS: ~/Library/Application Support/minecraft
4. Linux: ~/.minecraft
5. Open the mods folder (create it if it does not exist)
6. Place both fabric-api-*.jar and better-ecology-*.jar in the folder

5. Launch Minecraft¶

1. Open the Minecraft Launcher
2. Select the Fabric profile
3. Click Play

Verifying Installation¶

Once in-game, you can verify the mod is working by:

1. Spawning sheep and observing grazing behavior
2. Watching pigs root in the ground
3. Observing flock cohesion in groups of animals

Troubleshooting¶

Mod Not Loading¶

• Ensure you are using Minecraft 1.21.1
• Verify Fabric Loader is installed correctly
• Check that both Fabric API and Better Ecology are in the mods folder

Game Crashes on Startup¶

• Check for incompatible mods
• Verify Java 21 is installed
• Review the crash log for specific errors

Behaviors Not Working¶

• Run /reload to refresh configurations
• Check server logs for profile loading messages
• Verify configuration files are valid JSON/YAML

Server Installation¶

For server installations:

1. Install Fabric on your server
2. Place mods in the server's mods folder
3. Configuration files are in config/better-ecology/

All clients connecting to the server should also have the mod installed for proper visual feedback.