Repository navigation
Configuration
CaptainGummiball edited this page Nov 19, 2026
·
1 revision
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] ". |
- 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.