Feathered Friend

Suspicious Feather

The Suspicious Feather (item id featheredfriend:ravens_eye) starts Raven Link.

TLDR:

  1. Right-click the feather to start Raven Link.
  2. If no active raven is available, runtime can revive your perished one for link use.
  3. While linked, you control raven flight and your body is represented by an effigy.
Suspicious Feather feature screenshot
Suspicious Feather and Raven Link in action.
Server-authoritative

Raven Link start/stop validity is validated server-side. Client visuals only mirror server state.


Crafting

Recipe (ravens_eye.json):

  • Ender Eye above Raven Feather (1x2, any column).
Ender Eye
Raven Feather
Suspicious Feather

Start requirements

Raven Link only starts if all checks pass:

  • enableSuspiciousFeather is enabled on server.
  • You are not already in active/pending link session.
  • A valid owned raven can be resolved in your current dimension.
  • If no active raven exists, runtime attempts perished-raven revive path.

If checks fail, the corresponding in-game message is shown (already active, no active raven, cross-dimension unavailable, or feature disabled).


What Raven Link does

When link starts:

  • short transition/handshake runs
  • Raven Link effigy entity is spawned for your body
  • normal player interactions are blocked while linked (attacks + item/entity/block interactions)
  • raven enters manual link-control state

Duration uses ravenLinkDurationSeconds (default 30, range 5..600). Runtime re-reads this during active sessions, so config edits can affect ongoing links immediately.

DEEP DIVE: linked-system pauses

While a raven is link-controlled, some independent timers/systems are paused or deferred (for example courier/summoned lifetime checks) to avoid link state fighting other despawn/cleanup logic.


How links end

A link can end due to:

  • timeout
  • client stop request
  • effigy hit
  • invalid session state (missing raven, etc.)
  • server disabling Suspicious Feather while links are active
Effigy vulnerability

If your effigy is hit, link is canceled immediately with message.featheredfriend.raven_link.cancelled_effigy_hit.


Interaction with other systems

Raven Link integrates with several FF systems:

  • summoned-raven lifetime checks pause while linked
  • courier lifecycle checks can defer while linked
  • Suspicious Chest perch assignment can be temporarily cleared/held and restored on link end
  • delivery cleanup can finalize when the session stops

Support This Project

Like this wiki and these mods?

Every bit of support helps me keep building features, writing docs, and shipping updates.

Back to top