====== ShulkGPS (Custom) ======

**Custom Plugin**

===== Overview =====

ShulkGPS helps you track and locate your shulker boxes by placing glowing entities above them when placed in the world. Never lose your redstone supplies, building materials, or valuable items with this powerful tracking system. The glowing entity placed over shulker boxes chooses a color based on the ID number, cycling between the 16 colors of Minecraft then repeating (if you have that high of a tracker limit)

----

===== Main Commands =====

<code>
/shulkgps tag [optional name]      - Tag the shulker box in your hand, optionally define a nickname
/shulkgps toggle [ID/name]      - Toggle glowing effect on placed shulkers
/shulkgps list      - View all tagged shulkers and their coordinates
/shulkgps untag [ID/name]      - Remove tracking from a shulker box
</code>

----

===== Tagging System =====

**Creating Tracked Shulkers:**
  * Hold a shulker box in your hand
  * Use `/shulkgps tag [optional name]` to add tracking
  * Assign custom names for easy identification (e.g., "redstone", "building")
  * Each shulker gets a unique ID number automatically
  * Tagged shulkers work normally but gain tracking capabilities

**Tagging Limits:**
  * **Default limit:** 4 tagged shulker boxes per player
  * **Increase trackers:** Win more trackers through the [[plugins:ServerRewards|ServerRewards]] wheel keys
  * **Nicknames:** Use descriptive names or rely on ID numbers
  * **Persistent tags:** Tags survive server restarts and item transfers

----

===== Location Tracking =====

**Glowing System:**
  * Use `/shulkgps toggle [ID/name]` to activate visual tracking
  * Places a glowing entity directly above the shulker box
  * **See through walls** - Glow effect visible through blocks
  * Toggle on/off as needed to reduce visual clutter
  * Only works when shulker boxes are placed in the world

**Coordinate Display:**
  * `/shulkgps list` shows all your tagged shulkers
  * **Placed shulkers:** Display exact coordinates (X, Y, Z)
  * **Inventory shulkers:** Show as "in inventory" without coordinates
  * **Quick reference:** Check locations without traveling to them
  * **Status tracking:** See which shulkers have glow effects active

----

===== Management Features =====

**Removing Tags:**
  * Hold the tagged shulker box you want to untag
  * Use `/shulkgps untag [ID/name]` to remove tracking
  * Frees up a slot for tagging other shulkers
  * Removes all tracking data and glow effects
  * Shulker box returns to normal vanilla behavior

**Tips:**
  * **Use descriptive names** - "redstone", "farms", "nether", "end"
  * **Toggle strategically** - Only activate glow when searching
  * **Track valuable items** - Focus on important or hard-to-replace boxes

----

===== Best Uses =====

**Storage Organization:**
  * **Specialized boxes** - Track redstone, building materials, rare items
  * **Remote storage** - Keep tabs on shulkers at distant bases
  * **Project supplies** - Monitor boxes dedicated to specific builds
  * **Emergency kits** - Track shulkers with backup supplies and tools

**Base Management:**
  * **Multi-base setups** - Track shulkers across different locations
  * **Storage rooms** - Quickly locate specific boxes in large storage areas
  * **Temporary storage** - Keep track of shulkers placed during projects
  * **Shared storage** - Coordinate with other players using named boxes

----

===== Tips =====

  * Use descriptive names to remember what each shulker contains
  * Automatically turns glow effects off to reduce lag
  * Check `/shulkgps list` to see which shulkers are placed vs. in inventory or shulkers too far to see the entity
  * Try increasing your tag limit through ServerRewards for more trackers

===== Related Pages =====

  * [[:plugins|All Server Plugins]]
  * [[:plugins:server-rewards|Server Rewards]] (upgrade your tag limit)

---

//ShulkGPS eliminates the frustration of lost shulker boxes with powerful tracking and visual location tools.//