Ragnarawk

Ragnarawk - Blue-and-Yellow Macaw for Valheim

Version: 0.2.0 | Author: Wawax007

Adds a tameable Blue-and-Yellow Macaw parrot to Valheim. Find them in the wild, tame them with berries, carry them on your shoulder, and hatch eggs to grow your flock!

---

Installation

1. Install BepInEx 5.4+
2. Extract the zip into your Valheim folder (drag and drop)
3. Launch Valheim

---

Features

Creature

• Blue-and-Yellow Macaw — a fully animated tropical parrot with custom 3D model, textures and sound effects
• Star variants — 0-star (classic blue/yellow), 1-star (green plumage), 2-star (scarlet red plumage)
• Spawn biomes — Meadows, Black Forest, Plains and Mistlands (daytime only)
• Passive wildlife — AnimalsVeg faction, flees from approaching players
• Drops — 2-4 Feathers on death (more from starred variants)
• Custom SFX — idle chirps, alert squawks, hit and death sounds

Taming

• Food — Blueberries, Raspberries, Carrots or Turnips
• Taming duration — 120 seconds by default (configurable)
• Behavior — drop food near the parrot, stay close but don't spook it; it will eat when not alerted
• Once tamed, the parrot follows you and orbits above your head in flight
• Follow / Stay — use the standard interaction key (E) to toggle between Follow and Stay modes

Flight System

• Wild flight — parrots take off, soar and land naturally using Valheim's native MonsterAI random flight system
• Follow-flight — tamed parrots in Follow mode fly in a dynamic orbit above their owner:
• Circular orbit with sinusoidal speed and altitude variation
• Periodic swooping dives for visual flair
• Smooth landing spiral when the player stops moving
• Automatic takeoff when the player starts walking again
• Custom animations — 2D BlendTree with idle, forward flight, banking turns, hover, and gliding states
• Altitude enforcement — parrots maintain proper altitude above terrain even over uneven ground

Shoulder Mount

• Short press G — whistle to call your parrot down to land nearby
• Long press G (hold 0.4s) — call your parrot to perch on your shoulder
• Press G while mounted — dismount (smooth hop to ground or takeoff)
• Works at any distance — overrides Stay mode, the parrot will fly back to you
• Smooth transitions — parabolic arc animation when mounting/dismounting (no teleporting)
• Auto-mount — occasionally, an idle tamed parrot near you may hop onto your shoulder on its own
• Visible to all players — shoulder parrot is synced in multiplayer, other players see it on your shoulder

Parrot Egg

• Craftable at Workbench — 50 Coins + 5 Feathers + 2 Dandelion
• Hatching — drop the egg on the ground and wait ~2 minutes for it to hatch
• Hover text — shows hatching progress percentage when you look at the egg
• Pre-tamed — hatched parrot is already tamed and follows the nearest player
• Spawn VFX — vanilla Valheim poof effect on hatch

Breeding

• Two fed tamed parrots nearby will produce an egg (disabled by default, configurable)
• Respects the maximum nearby parrot count to prevent overpopulation

Sound Effects

• Idle chirp — random chirps while perching or flying (every ~8s, 50% chance)
• Alert squawk — plays when the parrot is spooked by a player
• Hit sound — custom SFX with vanilla hit sparks VFX
• Death sound — custom SFX with vanilla blood splatter VFX
• Whistle — plays when you use the G key to call your parrot

Multiplayer

• Full multiplayer support — works on dedicated servers and peer-to-peer
• Server-synced config — server enforces taming time, breeding settings, and other gameplay values
• ZDO replication — shoulder state, flight mode, and egg hatching progress sync across all clients
• RPC commands — land/takeoff/whistle commands route correctly to the parrot's owner
• Shoulder visibility — other players see the parrot perched on your shoulder in real-time

Localization

34 languages fully supported:

• English, French, German, Spanish, Portuguese (Brazilian), Portuguese (European), Russian, Chinese, Swedish, Norwegian, Danish, Finnish, Icelandic, Italian, Dutch, Polish, Czech, Slovak, Hungarian, Romanian, Bulgarian, Croatian, Serbian, Ukrainian, Macedonian, Lithuanian, Georgian, Greek, Turkish, Japanese, Korean, Thai, Hindi, Abenaki

All creature names, item names, item descriptions, UI messages and hover texts are localized.

---

Configuration

Edit com.wawax007.Parrots.cfg in BepInEx/config/ (generated on first launch).

All gameplay settings are synced with the server (marked [Synced]) — the server's values override client settings. Client-only settings (marked [Not Synced]) can be changed freely.

| Setting | Default | Synced | Description | |---------|---------|--------|-------------| | Force Server Config | On | - | Lock config to server values | | Mount Key | G | No | Key to mount/call parrot | | Hold Threshold | 0.4s | No | Hold duration for shoulder call vs call down | | Taming Time | 120s | Yes | Seconds to tame a parrot while fed | | Hatch Time | 120s | Yes | Seconds for a dropped egg to hatch | | Breeding | Off | Yes | Enable parrot breeding | | Max Nearby | 4 | Yes | Max parrots in area before breeding stops | | Pregnancy Duration | 600s | Yes | Time between breeding cycles |

---

Controls

| Key | Context | Action | |-----|---------|--------| | E | Look at tamed parrot | Follow / Stay toggle | | G (short press) | Tamed parrot following | Whistle — parrot lands nearby | | G (hold 0.4s) | Tamed parrot following | Call parrot to shoulder | | G | Parrot on shoulder | Dismount |

---

Credits

• Wawax007 — mod author