Skip to content

Getting Started

CaptainGummiball edited this page Nov 19, 2026 · 1 revision

Getting started

Installation

  1. Install Xaero's Minimap (26.4.x recommended; Xaero's World Map is optional but recommended — Shulkaero waypoints show on both).
  2. Drop the Shulkaero jar for your Minecraft version and loader into mods/:
    • MC 1.21 – 1.21.11: shulkaero-fabric-... or shulkaero-neoforge-... (the jar name tells you which versions it covers)
    • MC 26.1 – 26.3: the one shulkaero-universal-... jar works on both loaders
  3. On Fabric, Fabric API is optional — only the /shulkaero command needs it; everything else works without it.

Nothing is installed on the server; Shulkaero works on any server, vanilla or modded.

First steps

  • Place a shulker box. After about half a second a waypoint with the box's name appears (undyed boxes are purple, dyed boxes get the matching waypoint color), and you get a short actionbar message.
  • Rename a box at an anvil before placing it — the waypoint uses that name and its initials.
  • Break the box: the waypoint stays while the dropped item lies there, and disappears once you (or anyone) pick it up. In creative (no drop) it disappears right away.
  • Waypoints you delete or rename in Xaero yourself are left alone from then on.

The /shulkaero command

Command Effect
/shulkaero Shows the usage line
/shulkaero list Lists the tracked boxes of the current world
/shulkaero clear Forgets all tracked boxes of this world (waypoints are kept)
/shulkaero toggle Turns Shulkaero on/off (saved to the config)
/shulkaero reload Reloads config/shulkaero/config.json

Next: Configuration.

Clone this wiki locally