{"id":82832,"date":"2026-06-04T20:57:29","date_gmt":"2026-06-04T17:57:29","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/"},"modified":"2026-06-04T20:57:29","modified_gmt":"2026-06-04T17:57:29","slug":"huskhomesgui-navitems","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/","title":{"rendered":"HuskHomesGUI Navitems"},"content":{"rendered":"

# NavItems \u2014 item shift right-click shortcuts for HuskHomes<\/p>\n

**Summary**
\nTurns a few vanilla items into fast travel tools. NavItems adds concise usage **lore** to those items (without renaming) and runs HuskHomes commands on **shift + right-click**:<\/p>\n

* **Compass** \u2192 `\/warplist`
\n* **Recovery Compass** \u2192 `\/homelist`
\n* **Goat Horn** \u2192 `\/sethome home-` (number is global, never re-used)
\n* **Book** \u2192 `\/phomeslist` (public homes)<\/p>\n

—<\/p>\n

## Features<\/p>\n

* **Shift+Right-click while holding item to trigger**
\n* **Always-on instructive lore**
\n* **Unique home names**: `home-1`, `home-2`, `home-3`\u2026 stored in `plugins\/NavItems\/data.yml` so numbers never repeat across restarts.
\n* **Namespaced command first, fallback second** (e.g. `huskhomes:warplist` \u2192 `warplist`).
\n* **Light cooldown** (configurable) to prevent accidental double-fires.
\n* `\/navitems [player]` helper command to hand out the four items (with lore).<\/p>\n

—<\/p>\n

## Dependencies<\/p>\n

* **Required:** **HuskHomes** https:\/\/modrinth.com\/plugin\/huskhomes (the commands this plugin runs come from HuskHomes).
\n* **Required:** **Updated HuskHomes GUI** https:\/\/modrinth.com\/plugin\/updated-huskhomesgui \u2014 if missing, it will only list warps and homes by triggering `\/warplist`, `\/homelist`, or `\/phomeslist`<\/p>\n

> Players still need the relevant HuskHomes permissions to use the lists or set homes. NavItems only triggers the commands; HuskHomes handles access.<\/p>\n

—<\/p>\n

## Commands & permissions<\/p>\n

**Commands**<\/p>\n

* `\/navitems [player]` \u2014 gives Compass, Recovery Compass, Goat Horn, Book (all with usage lore)<\/p>\n

**Permissions**<\/p>\n

* `navitems.use` \u2014 allow using the items (right-click actions)
\n* `navitems.give` \u2014 allow `\/navitems` (default: op)<\/p>\n

Example (LuckPerms):<\/p>\n

“`
\n\/lp group default permission set navitems.use true
\n\/lp user permission set navitems.give true
\n“`<\/p>\n

—<\/p>\n

## Configuration<\/p>\n

`plugins\/NavItems\/config.yml`<\/p>\n

“`yaml
\ncommands:
\n warplist: “huskhomes:warplist”
\n homelist: “huskhomes:homelist”
\n phomeslist: “huskhomes:phomeslist”
\n sethome: “huskhomes:sethome %name%”<\/p>\n

homeNamePrefix: “home-”
\ncooldownMs: 600
\n“`<\/p>\n

* Change the command strings or the name prefix if you like.
\n* Namespaced commands ensure HuskHomes is targeted even if other plugins add similar commands.<\/p>\n

—<\/p>\n

## Compatibility<\/p>\n

* **Server:** Paper \/ Purpur (Paper recommended)
\n* **Minecraft:** 1.21.x
\n* **Java:** 21<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Drop the JAR into `\/plugins`.
\n2. Start the server once (generates `config.yml` & `data.yml`).
\n3. Grant `navitems.use` (and, if desired, `navitems.give`).
\n4. (Optional) Install the **updated unofficial HuskHomes GUI** to get menu UIs for the lists.<\/p>\n

—<\/p>\n

## FAQ<\/p>\n

**Does this rename items?**
\nNo \u2014 only lore is added. Names remain vanilla.<\/p>\n

**What if another plugin uses these items too?**
\nNavItems cancels the interaction after firing the command and has a short cooldown. You can also withhold `navitems.use` from groups that shouldn\u2019t trigger it.<\/p>\n

**Can I map different items or commands?**
\nYes \u2014 edit `config.yml`. The code is small and easy to extend if you want deeper customization.<\/p>\n

—<\/p>\n

## Changelog (latest)<\/p>\n

**1.2.0**<\/p>\n

* Right-click actions for Compass \/ Recovery Compass \/ Goat Horn \/ Book
\n* Always-on lore for those vanilla items
\n* Global, persistent `home-` naming
\n* Namespaced HuskHomes commands with fallback
\n* `\/navitems` helper command<\/p>\n

—<\/p>\n","protected":false},"excerpt":{"rendered":"

Compass opens warps, Recovery Compass opens homes, Goat Horn sets a new home named home, and Book shows public homes. The plugin always adds concise usage lore to those items.<\/p>\n","protected":false},"featured_media":82833,"template":"","meta":{"_minecraft_slug":"huskhomesgui-navitems","_minecraft_project_id":"TlXRWf5o","_minecraft_author":"rk.kakarigi","_minecraft_license":"Apache-2.0","_minecraft_downloads":72,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"huskhomesgui-navitems.zip","_minecraft_size_bytes":19157,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:24:28.006387Z","_minecraft_date_created":"2025-09-05T07:40:22.838385Z","_minecraft_date_modified":"2025-09-06T14:42:56.275094Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/huskhomesgui-navitems","_minecraft_icon_attachment_id":82833,"_minecraft_imported_at":"2026-06-04T17:57:30+00:00","_minecraft_import_hash":"12d7334dfaaa250042bcaaa81daea4e0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-82832","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nHuskHomesGUI Navitems - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"HuskHomesGUI Navitems - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Compass opens warps, Recovery Compass opens homes, Goat Horn sets a new home named home, and Book shows public homes. The plugin always adds concise usage lore to those items.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/\",\"name\":\"HuskHomesGUI Navitems - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp\",\"datePublished\":\"2026-06-04T17:57:29+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/huskhomesgui-navitems\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"HuskHomesGUI Navitems\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"HuskHomesGUI Navitems - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/","og_locale":"en_US","og_type":"article","og_title":"HuskHomesGUI Navitems - Minecraft","og_description":"Compass opens warps, Recovery Compass opens homes, Goat Horn sets a new home named home, and Book shows public homes. The plugin always adds concise usage lore to those items.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/","name":"HuskHomesGUI Navitems - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp","datePublished":"2026-06-04T17:57:29+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/huskhomesgui-navitems-icon-55168f44edcb206c6376261ee793663fe3db31d5_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/huskhomesgui-navitems\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"HuskHomesGUI Navitems"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/82832","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/82833"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=82832"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=82832"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=82832"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=82832"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}