Stable Build: v3.1.0 (1.18 - 1.21.11)

The Ultimate Parrot Companion

BirdPartner isn't just a cosmetic plugin—it's a server staple. Give your players a loyal shoulder companion, completely customizable and performance-optimized.

Download Now
BirdPartner GUI Menu

Core Features

Everything you need for a perfect pet system.

Color Customization

Instant color changes via GUI. Red, Blue, Green, Cyan, Gray.

Interactive GUI

Simple /parrot command opens the menu.

Modern Support

Native support: 1.18, 1.19, 1.20, up to 1.21.11.

Plugin Showcase

See BirdPartner in action

BirdPartner is free and open source.

Buy me a coffee

Commands & Permissions

Reference documentation for server administrators.

Command Permission Node Description
/parrot parrot.use Opens the main parrot selection GUI. This is the primary command for players.
/parrot help None Shows the help menu with available commands.
/parrot reload parrot.admin Reloads config.yml and messages.yml. Admin only.
/parrot remove parrot.remove Manually removes the parrot from your shoulder if it gets stuck.

Color Permissions

Grant these permissions to allow players to select specific colors in the GUI.

parrot.color.red Red Parrot
parrot.color.blue Blue Parrot
parrot.color.green Green Parrot
parrot.color.cyan Cyan Parrot
parrot.color.gray Gray Parrot
parrot.color.* All Colors

Introduction to BirdPartner

BirdPartner is designed to be the most lightweight and compatible pet solution for survival, hub, and RPG servers. Unlike other pet plugins that use complex NMS (net.minecraft.server) code which breaks every update, BirdPartner uses the standard Bukkit API where possible, ensuring longevity and stability.

Why choose BirdPartner?

  • Lightweight with no impact on TPS.
  • Native support for Minecraft 1.18 through 1.21.1.
  • Fully customizable GUI menus.

Installation Guide

Installing BirdPartner is straightforward. Follow these steps to get started.

  1. Download the BirdPartner.jar.
  2. Stop your server using the stop command.
  3. Drag and drop the jar file into your server's /plugins folder.
  4. Start your server. The config file will be generated automatically.
Warning: Do not use `/reload` to install plugins. Always restart your server to ensure data saves correctly.

Configuration

The configuration file is split into two main sections: Settings and Messages. You can edit this in `plugins/BirdPartner/config.yml`.

# config.yml
settings:
  gui-rows: 1
  sound-on-summon: true
  
  # Allow parrots to exist in WorldGuard protected regions?
  worldguard-bypass: false

messages:
  prefix: "&8[&aBirdPartner&8] "
  summon: "&aYour parrot has arrived!"

Hex Colors

BirdPartner supports RGB Hex colors in messages for versions 1.16+. Use the format #RRGGBB.

Troubleshooting

Parrot disappears when I jump?

This is default Minecraft behavior. You can enable `stay-on-jump: true` in the config to try and force the parrot to stay, though vanilla mechanics may sometimes override this.

GUI not opening?

Check the console for errors. Ensure you are not running a plugin that blocks inventory opening events (like some Auth plugins) in the lobby.

Developer API

BirdPartner provides a simple API to interact with user pets.

import com.example.birdpartner.api.ParrotAPI;

public void onJoin(PlayerJoinEvent event) {
    // Summon a red parrot for the player
    ParrotAPI.getInstance().summonParrot(event.getPlayer(), ParrotColor.RED);
}

Update History

v3.1.0 - The Winter Drop

Released Jan 15, 2026
  • Full compatibility update for Minecraft 1.21.11.
  • Refined packet handling for smoother shoulder riding on high-latency connections.
  • Added new "Ice Blue" variant for supporters.

v3.0.0 - The Void Update

Released June 20, 2025
  • Major codebase rewrite for performance.
  • Added support for Hex colors in parrot names.
  • Fixed issues with multi-world permissions.

v2.4.1 - The Tricky Trials Update

Released Oct 12, 2024
  • Added full support for Minecraft 1.21.
  • Fixed an issue where parrots would despawn when entering the Trial Chambers.
  • Optimized shoulder entity tracking packet usage.

v2.3.0 - Trails & Tales

Released June 15, 2023
  • Added support for Minecraft 1.20.
  • Updated library dependencies.
  • Fixed NullPointerException when clicking empty slots in the GUI.

v2.2.5 - GUI Overhaul

Released Jan 04, 2023
  • Complete rewrite of the Inventory GUI system.
  • Added custom skull support for GUI icons in config.yml.

v2.1.0 - The Wild Update

Released June 10, 2022
  • Added support for Minecraft 1.19.
  • Fixed sound effects playing twice on some servers.

Earlier versions can be found on SpigotMC history.