Headquarters (HQ)

HQ

(Fabric)

One button for everything: HQ adds an "HQ" button to your inventory that opens a list of shortcuts to your mods' settings screens and to any command you save.

FEATURES

The HQ button

• Centered above the inventory panel, in survival and creative (above the creative tabs). It moves with the inventory when the recipe book opens. With Wave Matrix installed, its ♪ button sits to the right and the pair is centered.
• Kept away from the sides, where item-list mods like JEI, REI and EMI, inventory sort buttons and tabs usually go. Only on a very small screen, with no room above, does it move to the left of the panel.

The HQ screen

• Right side: a scrolling list of the shortcuts mods offer, one button per mod. Hover over a button to see its command and who added it.
• Left side, top: two rows of eight picture buttons. Hover over one for what it does.
  • Row 1: Sun = time to day, Clock (noon) = time to noon, Clock (midnight) = time to midnight, Moon = time to night, Light blue glass = clear weather, Blue glass = rain, Gray glass = thunder (it flashes white twice, quickly, every 5 seconds, like lightning), and the game mode toggle: a Diamond Sword when you are in survival, a Totem of Undying in creative. Press it to switch.
  • Row 2: Night vision toggle (Eye of Ender = on, Ender Pearl = off), Speed toggle (Diamond Boots = on, Leather Boots = off; Speed II), then find the nearest village and go there: any village (Bell), or a plains (Oak Door), taiga (Spruce Door), desert (Jungle Door), savanna (Acacia Door) or snowy (Pale Oak Door) village.
• Everything keeps HQ open except the village buttons, which close it (you are teleported). The game mode, night vision and speed pictures change to show the new state.
• The picture buttons run /time, /weather, /gamemode, /effect and /locate + /tp, so they need operator permission (cheats on in singleplayer). Without it the picture buttons are hidden altogether (and appear as soon as you get permission).
• The pictures are always Minecraft's own, read from the game itself, so resource packs and texture packs don't change them.
• Left side, below: type a name and a command, then Add, to save your own shortcut. Yours are in a scrolling list under it. Each has a pencil to edit it (its name and command load into the boxes, the Add button becomes Save, and Cancel backs out; a rename keeps its place) and an X to delete it.
• Pressing a shortcut runs its command as if you typed it.

Villages

• The village buttons ask the game where the nearest village is, wait for the place to load, then put you on the ground there. If none is found nearby, HQ says so and you stay put. (Villages don't exist in the Nether or End, and there are no jungle villages in Minecraft.)

Shortcuts from mods

• Mods that support HQ add their own shortcut automatically. Nothing to set up.
• If you remove a mod, its shortcut is gone the next time you start the game. Nothing is left behind in your config.
• Mod shortcuts can't be deleted (they belong to the mod).

Your own shortcuts

• Save any command, for example:
  /hq add findvillage /locate structure minecraft:village_plains
• Then run it with /hq findvillage or from the HQ screen.
• Commands run with your own permissions: HQ never lets you use a command you couldn't type yourself.

COMMANDS

Command	Description
/hq	Open the HQ list.
/hq add <name> <command>	Save a command as a shortcut. The leading / is optional.
/hq <name>	Run a shortcut.
/hq remove <name>	Delete one of your shortcuts.
/hq list	List every shortcut in chat.

Names can use letters, numbers, _ and - (up to 32). "add", "remove" and "list" are reserved.

SETTINGS

Your shortcuts are saved in config/hq.json. Everything is managed from the HQ list or the /hq commands.

HQ COMPATIBILITY (for mod authors)

Add your mod's shortcut with no code and no dependency on HQ. Put this in your mod's fabric.mod.json:

  "custom": {
    "hq": { "name": "My Mod", "command": "mymod" }
  }

• "command": what to run, without the slash.
• "name": the button label (default: your mod's name).
• "id": optional, the name for /hq <id> (default: your mod id).
• For several shortcuts, use a list of these objects.

HQ reads these from the installed mods every time the game starts.

Mods with HQ shortcuts: More Danger, Populations, Tameful, Conflict Resolution, Any Skins, Identifiable, Peace and Quiet, Mob Crate, Magic Square, Wave Matrix, Wide Awake.

COMPATIBILITY & NOTES

• Client only: it doesn't need to be on the server.
• Works with mods that open their screens through a client command (like /md) as well as with server commands.