Whoa... where did all these birds come from?

Bird Watching adds a bunch of birds to Minecraft, and they seem very determined to make the world a little less empty.

You may be walking through a village, minding your own business, and suddenly notice a sparrow hopping around like it owns the place. You may pass by a quiet patch of water and find a night heron standing there with the patience of someone waiting for a very late bus. You may see budgerigars moving around in little groups, doves wandering through open ground, or pigeons doing what pigeons always do: being suspiciously comfortable everywhere.

The birds in this mod walk, fly, rest, forage, gather with their own kind, and react when something nearby feels dangerous. Some prefer water and wetlands, some like villages and fields, and some are just happy to wander around wherever the world gives them enough space and enough excuses.

Night herons usually appear near water. They are calm, quiet, and good at standing still in a way that makes you wonder whether they are hunting, resting, or silently judging your building choices.

Sparrows are small, quick, and much busier than they probably need to be. They fit well around villages, farms, paths, and places where crumbs might theoretically exist. If a peaceful rural scene feels like it is missing something, a sparrow can usually fix that.

Budgerigars bring more color and noise. They tend to appear in small lively groups, making the world feel a bit brighter and less lonely. They are tiny birds with the energy of creatures that believe every fence, branch, and patch of grass deserves an urgent meeting.

Spotted doves are calmer. They walk around open areas, fields, and quiet places with the relaxed confidence of birds that have no urgent plans and no interest in explaining themselves.

Pigeons are pigeons. They wander around, look busy, and somehow make almost any place feel like it has been part of their territory for years. If a pigeon appears somewhere strange, that is not necessarily a problem. That might simply be pigeon logic.

Bird Watching also includes a bird guide. You can use it to view the birds, read short notes about them, and check their animated previews. It is not a giant encyclopedia, but it is useful when you see something feathered in the distance and want to know whether it is rare, cute, suspicious, or all three.

There are bird-related blocks and items too, including bird cages, bird baths, and breadcrumbs. These can be used for decoration, small interactions, or simply for making your builds feel more lived in. A garden looks better with birds. A village feels better with birds. Even a random patch of grass becomes more interesting when something tiny lands there and immediately starts acting important.

Bird Watching is still being updated. More birds, sounds, behaviors, interactions, and little surprises may be added over time. The goal is to make Minecraft feel a bit more alive, a bit more natural, and occasionally a bit more ridiculous.

我去……哪来的这么多鸟？

《观鸟》给 Minecraft 加了一些鸟，而且它们非常努力地想让这个世界显得没那么空。

你可能只是路过一个村庄，什么也没打算做，结果突然看到一只麻雀在地上跳来跳去，像是在巡视自己的地盘。你可能走到一片安静的水边，发现夜鹭站在那里，一动不动，耐心得像是在等一辆永远不会来的末班车。你也可能看到虎皮鹦鹉三三两两地活动，斑鸠在开阔地慢慢走，或者鸽子出现在某个完全合理又有点奇怪的地方，并表现得好像这里本来就是它家。

这个模组里的鸟会走动，会飞行，会休息，会觅食，会和同类聚在一起，也会在觉得附近不太安全的时候赶紧离开现场。有些鸟喜欢水边和湿地，有些鸟更常出现在村庄和农田附近，也有些鸟只是单纯觉得这个地方不错，于是就来了。

夜鹭通常会出现在水边。它们安静、冷静，而且很擅长站着不动。你很难判断它到底是在捕食、休息，还是在认真评价你刚刚盖出来的房子。

麻雀很小，也很忙。它们适合出现在村庄、农田、小路旁，以及任何理论上可能存在食物碎屑的地方。如果一片乡村场景少了点生活气息，那么放几只麻雀进去通常就对了。

虎皮鹦鹉会带来更多颜色和动静。它们常常成群活动，让世界显得更热闹。虽然个头不大，但它们看起来总像是坚信每根树枝、每片草地、每个栅栏旁边都应该开一次小型会议。

珠颈斑鸠要安静一些。它们会在开阔地、田野和比较平缓的环境里慢慢走动，看起来没有什么急事，也完全不打算解释自己为什么在这里。

鸽子就是鸽子。它们会到处走，看起来很忙，而且总能让一个地方突然产生一种“这里好像早就被鸽子占领了”的感觉。如果你在某个奇怪的地方看到鸽子，那不一定是问题。也许只是鸽子觉得那里可以待。

模组里也有一本观鸟图鉴。你可以用它查看不同鸟类，阅读一些简单记录，并预览它们的动画。它不是一本特别严肃的大型百科，但当你远远看到一个长羽毛的小东西，并开始怀疑它到底是什么、可不可爱、可不可疑的时候，它就很有用了。

此外，模组还加入了一些鸟类相关的方块和物品，包括鸟笼、鸟浴盆和面包屑。它们可以用来装饰，也可以用于一些小互动，或者单纯让你的建筑和环境看起来更有人生活过。花园里有鸟会更自然，村庄里有鸟会更热闹，就算是一块普通草地，只要有小鸟落下来开始认真走来走去，也会突然显得重要起来。

《观鸟》还在继续更新。以后可能会加入更多鸟类、声音、行为、互动和一些小惊喜。这个模组的目标是让 Minecraft 多一点生命感，多一点自然气息，偶尔也多一点莫名其妙但很像鸟会干出来的事情。

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.