Neo Guan Niao - Bird Watching Mod

Neo Guan Niao is a Minecraft mod that introduces a living bird ecosystem to the game.

Unlike traditional pet mods, Neo Guan Niao focuses on creating a world where birds behave like real creatures: they have unique behaviors, habitats, appearances, individual traits, and growth processes.

Observe, feed, tame, breed, and care for birds as you build your own connection with the wildlife around you.

📖 Introduction

Neo Guan Niao is an unofficial NeoForge remake and expansion of the original Guaniao mod.

After being redesigned for Minecraft 1.21.1 NeoForge, the mod introduces many new ecological systems:

• New modular bird behavior architecture
• Individual bird data system
• Bird egg and breeding system
• Nest and incubation system
• Bird guide system
• Birdbath interaction system
• Bird food bag growth control system
• Feather economy system
• Bird researcher villager trades
• Bird watching achievement system
• Expanded bird collection and observation gameplay

The goal of Neo Guan Niao is to make birds more than decorative creatures — they are living parts of the Minecraft world.

✨ Features

🐦 Diverse Bird Species

Currently included:

More bird species will be added in future updates.

🪶 Individual Bird System

Every bird is unique.

Birds have their own:

• Gender
• Individual size
• Feather color and skin
• Model variation
• Growth state
• Genetic traits

Offspring may inherit traits from their parents or develop mutations, creating unique birds for your collection.

🥚 Eggs and Breeding System

Some birds can form pairs and reproduce.

Bird eggs store information such as:

• Bird species
• Feather color
• Gender
• Size
• Hatching time
• Genetic data

Some rare skins can only be obtained through breeding, encouraging players to develop their own bird collections.

🪺 Nest System

Bird nests are not just decorative blocks — they are part of the bird ecosystem.

Features:

• Birds search for suitable nests
• Automatic egg laying
• Egg management
• Natural incubation process

Birds can reproduce in a more natural way instead of simply spawning offspring.

🛁 Birdbath System

Build birdbaths to attract nearby birds.

Birds can:

• Drink water
• Clean their feathers
• Use birdbath areas as activity locations

Observing birdbaths is a great way to discover nearby wildlife.

🌾 Bird Food and Growth Control

Neo Guan Niao introduces a bird food bag system.

Different food bags provide different functions:

• Seed-based food
• Fish-based food
• Growth control food

Bird food bags allow players to adjust bird growth:

• Pause growth
• Resume growth
• Accelerate growth

This gives players more control when raising their bird companions.

📖 Customizable Bird Guide

The mod includes an in-game bird observation guide.

Features:

• Record discovered birds
• View bird information
• Customize the interface with the E key
• Keep track of your bird discoveries

Explore the world and build your own bird encyclopedia.

🎮 Gameplay

Taming Birds

Tamed birds can:

• Follow the player
• Become companions
• Interact with the environment

Taming is one of the main ways to build a relationship with birds.

🎨 Visual Features

GeckoLib Animation

All birds use GeckoLib animation technology:

• Flying animations
• Walking animations
• Eating animations
• Interaction animations

Combined with individual variations, every bird feels alive and different.

🧠 Bird Behavior System

Neo Guan Niao uses a modular Controller + Ticker architecture.

Each behavior is independently managed, making the AI system easier to expand and maintain.

Supported behaviors include:

• Flying
• Searching for food
• Fleeing
• Social interaction
• Breeding
• Taming
• Environmental interaction

and more.

📋 Requirements

• Minecraft: 1.21.1
• NeoForge: 21.1.233+
• Java: 21
• GeckoLib: 4.7.2+

🔧 Installation

1. Install NeoForge 1.21.1
2. Install GeckoLib
3. Put NeoGuanNiao-x.x.jar into your .minecraft/mods folder
4. Launch Minecraft

🛠️ Development Information

Developer

NeoForge remake:

• Fodoth_jinzi89

Original authors:

• EdDYON
• 映素
• 哥斯拉

Technology Stack

• Java 21
• NeoForge
• GeckoLib 4
• Gradle

🤝 Contributing

Issues and Pull Requests are welcome!

When reporting a problem, please provide:

1. Minecraft version
2. NeoForge version
3. Mod version
4. Description of the problem
5. Log files

📄 License

This project uses a dual-license structure.

Original Mod Content

Code and resources from the original Guaniao mod remain under the original author's license.

Neo Guan Niao Original Content

New code, resources, and original additions are licensed under:

GNU General Public License v3.0 only

GPL-3.0-only allows:

• Free use
• Modification
• Redistribution
• Commercial use

However, derivative works must continue to use GPL-3.0-only.

See the LICENSE file for details.

🙏 Credits

Special thanks to:

• Original Guaniao mod authors
• NeoForge development team
• GeckoLib development team

📞 Contact

GitHub:

https://github.com/Fodoth-jinzi89

Issue Tracker:

https://github.com/Fodoth-jinzi89/NeoGuanNiao/issues

Bring birdsong back to Minecraft.

🪶 Discover. Observe. Protect.