Bird Watching

Bird Watching

A little movement in the trees. A flash of colour by the water. A reason to bring your camera.

Bird Watching brings animated birds and their everyday routines to Minecraft. Follow a flock through the countryside, stop beside a quiet river, or make room for a few feathered neighbours around your home.

Field Guide & Help · Website · Report a Bug

Watch a world with wings

Sparrows gather near farmland, hummingbirds hover beside flowers, and night herons wait by the water. Look out for colourful parrots, wandering pigeons, curious crows and kingfishers skimming the shoreline.

Birds forage, fly, rest and react to nearby danger. Their habitats, foods and habits vary by species. The in-game Field Guide helps you get to know them, with animated previews and notes on feeding and interaction.

Make a few feathered friends

Offer the right food to tame compatible species, then take your companions along or give them a place to stay. Night herons may bring you fish, hummingbirds can help nearby crops, and seagulls sometimes decide that your food looks better than theirs.

Scatter breadcrumbs, add a bird bath, or decorate a quiet corner with a bird cage. Not every bird is tameable, and each species has its own preferences.

Take the moment home

Use the camera to capture the actual world around you. Experiment with zoom, focus, lenses and filters; keep your photographs as in-game items or export them as PNG images.

At the Frame Workbench, choose a shape and size, combine frame materials, trim and lining, and add item decorations. Adjust the photograph inside, save a favourite design, and hang the finished work on your wall.

Share your photographs and frame designs

Coming in the next update.

The optional Public Album lets you submit your work for review and discover what other players have made.

• Browse approved photographs and frame designs.
• Like your favourites and sort by newest or most liked.
• Download photographs as in-game items, with the original author, title and description preserved.
• Report a work with a reason for the review team to check.

Taking a photo does not publish it. You choose what to submit, and submissions appear publicly only after approval.

观鸟，也把风景带回家

树林里的麻雀、水边等待的夜鹭、花前悬停的蜂鸟，还有掠过水面的翠鸟。带上相机，走慢一点，看看这些小家伙正在忙什么。

认识它们。 不同鸟类有不同的栖息地、食物和习性。翻开游戏内的观鸟图鉴，查看动画和互动方式；给可以驯服的鸟喂食，也可以用鸟浴盆和面包屑布置自己的小花园。

留住这一刻。 用相机拍下实际游戏画面，调整变焦、对焦和滤镜。在相框工作台搭配框体、包边、内衬和物品装饰，再把成品挂到墙上。照片也能保存为游戏内物品或导出 PNG。

下次更新：分享喜欢的作品。 自愿投稿到公共相册，审核通过后公开。照片和相框都可以点赞，并按最新或点赞数排序；下载的照片保留作者、标题和介绍。举报时填写原因，直接交给审核组处理。普通拍照不会自动上传。

中文图鉴与帮助

Installation / 安装

Choose the file for your Minecraft version and loader, and install the matching GeckoLib dependency. For multiplayer, the server and participating clients need matching mod versions.

• Minecraft 1.20.1: Forge · Java 17
• Minecraft 1.21.1: NeoForge · Java 21

请按游戏版本和加载器选择文件，并安装对应的 GeckoLib。联机时，客户端与服务端使用相同的模组版本。不同发行文件的鸟类和功能可能有所区别。

Screenshots are captured in Minecraft 1.20.1 with Complementary Reimagined shaders. Shaders are optional and are not included. New content shown here is a preview of the upcoming update; check the selected file's changelog for availability.

配图为开启 Complementary Reimagined 光影后的游戏实拍；光影非必需，也不包含在模组内。这里展示了下一次更新的新内容，具体功能以所下载文件的更新说明为准。

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.