Skip to content

Configuration

CaptainGummiball edited this page Nov 19, 2026 · 1 revision

Configuration

config/shulkaero/config.json is created on the first run. Edit it and apply with /shulkaero reload (or restart the game).

Option Default Meaning
enabled true Master switch. /shulkaero toggle flips and saves it.
onlyNamedBoxes false Only boxes with a custom (anvil) name get a waypoint.
waitForPickup true After breaking a box, keep the waypoint while the dropped box item lies nearby; remove it once the item is picked up, despawns or burns. false: remove the waypoint as soon as the box is gone.
pickupSearchRadius 8 Radius in blocks around the break position in which the dropped item is searched (1–32). The search anchor follows the item if it drifts.
checkIntervalTicks 10 How often tracked positions are checked, in client ticks (1–200). 10 = twice per second.
feedback "actionbar" Where messages appear: "actionbar", "chat" or "none".
useOwnWaypointSet false Create waypoints in their own Xaero waypoint set instead of the currently active one.
waypointSetName "Shulkaero" Name of that set.
colorFromNameCodes false If the box name contains a literal § color code (e.g. §6Gold), use that chat color for the waypoint instead of the box color.
namePrefix "" Prefix for every waypoint name, e.g. "[Box] ".

Notes and limits

  • Only boxes you place are tracked — the box's name is not available client-side for other players' placements.
  • If a tracked box is destroyed while the chunk is not loaded on your client, the waypoint is removed the next time you come near the position.
  • Whether a dropped box item is still lying there can only be seen while you are within ~32 blocks of the drop (item entities are not sent to distant clients); further away the waypoint simply stays until you come closer.
  • Tracked boxes are persisted in config/shulkaero/tracked_waypoints.json, per world/server (using Xaero's own world path, so multiworld servers and dimensions are kept apart). Worlds not visited for 90 days are pruned from that file automatically.

Clone this wiki locally