> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edcompanions/features/animation.md).

# Opening Animation

When a player opens eggs at a placed egg (and has animations enabled), a fully packet-based sequence plays that **only the opener sees**:

1. Small egg displays spawn one by one at the top of the placed egg and glide out to the side.
2. They float on a circle until the whole ring orbits the egg, then keep orbiting and speed up.
3. The ring bursts (particles + sound) and the pulled companion appears above the egg with a grow-in, floats for a moment — then every roll lands in the buyer's storage.

The placed egg's hologram is hidden for the viewer while the animation runs and restored after. Display entities use client-side teleport interpolation, so the motion is smooth regardless of tick timing.

## Per-egg settings (`eggs/<id>.yml` → `animation:`)

```yaml
animation:
  enabled: true
  orb-count: 8                 # displays in the ring
  orb-display: 'block:DRAGON_EGG'
  orb-scale: 0.5
  orbit-radius: 1.4
  orbit-height: 1.6
  orb-spawn-interval-ticks: 5
  rise-ticks: 8                # each orb rises up from the egg (with a smooth scale-in)
  glide-ticks: 14              # then glides sideways out to its ring slot
  orbit-speed: 0.10            # radians per tick
  orbit-duration-ticks: 60
  reveal-duration-ticks: 40
  reveal-scale: 0.8
  spawn-sound: BLOCK_AMETHYST_BLOCK_CHIME
  reveal-sound: ENTITY_PLAYER_LEVELUP
```

Multi-opens (3x/10x) reveal **every** rolled companion at once, spread on a small circle around the egg.

## Player toggle

The **Animations Toggle** item in the eggs GUI (or `/companions animations`) flips the per-player setting. With animations off (or when eggs are opened without a placed egg), companions go straight to storage.