# Commands and Permissions {% hint style="info" %} Arguments with `<>` are required and `()` are optional parameters. {% endhint %} ## Player Commands ### /hb help Display command help. | | | | -------------- | ---------------- | | **Alias** | `h` | | **Permission** | `headblocks.use` | ### /hb progress Show heads found for the executing player or another player. | | | | ---------------- | ------------------------------------ | | **Alias** | `p` | | **Arguments** | `(player)` | | **Sender** | Player | | **Permission** | `headblocks.commands.progress` | | **Other player** | `headblocks.commands.progress.other` | ### /hb top Display leaderboard of heads found. | | | | -------------- | ------------------------- | | **Alias** | `t` | | **Arguments** | `(limit)` | | **Permission** | `headblocks.commands.top` | ### /hb leave Leave the current timed run. | | | | -------------- | ---------------- | | **Permission** | `headblocks.use` | | **Sender** | Player | ## Admin Commands All admin commands require `headblocks.admin`. ### /hb give Give a HeadBlock item to a player. | | | | ------------- | ----------------------------- | | **Alias** | `g` | | **Arguments** | ` (* or head number)` | | **Sender** | Player | ### /hb remove Remove head by UUID or remove targeted head. | | | | ------------- | ------------ | | **Arguments** | `(headUUID)` | ### /hb removeAll Remove all spawned heads. | | | | ------------- | ----------- | | **Arguments** | `--confirm` | ### /hb reset Reset player's progress. | | | | ------------- | ---------- | | **Arguments** | `` | ### /hb resetAll Reset all player progress. | | | | ------------- | ----------- | | **Arguments** | `--confirm` | ### /hb list List all spawned heads (grouped by hunt, filterable). | | | | ------------- | ----------------- | | **Alias** | `l` | | **Arguments** | `(huntId) (page)` | ### /hb stats Show heads found by player (grouped by hunt, filterable). | | | | ------------- | -------------------------- | | **Alias** | `s` | | **Arguments** | `(player) (huntId) (page)` | ### /hb reload Reload configuration and language files. ### /hb move Move targeted HeadBlock to another location. | | | | ------------- | ---------------------- | | **Alias** | `m` | | **Arguments** | `--confirm / --cancel` | | **Sender** | Player | ### /hb export Export database to SQL file with player data. | | | | ------------- | ------------------------------ | | **Alias** | `e` | | **Arguments** | ` ` | ### /hb rename Rename targeted head. | | | | ------------- | -------- | | **Alias** | `r` | | **Arguments** | `(name)` | | **Sender** | Player | ### /hb options Configure head mechanics via GUI. | | | | ------------- | ---------------------------------- | | **Alias** | `o` | | **Arguments** | `counter / hint / order / rewards` | | **Sender** | Player | ### /hb version Show current plugin version. | | | | --------- | --- | | **Alias** | `v` | ## Hunt Commands All hunt commands require `headblocks.admin`. ### /hb hunt create Create a new hunt (alphanumeric + hyphens only). | | | | ------------- | -------- | | **Arguments** | `` | ### /hb hunt delete Delete a hunt. Default: removes heads from world and resets progress. With `--keepHeads`: moves heads and progress to fallback hunt. | | | | ------------- | ---------------------------------------------------- | | **Arguments** | ` --confirm [--keepHeads] [--fallback ]` | {% hint style="warning" %} The default hunt cannot be deleted. {% endhint %} ### /hb hunt enable Set a hunt state to ACTIVE. | | | | ------------- | -------- | | **Arguments** | `` | ### /hb hunt disable Set a hunt state to INACTIVE. | | | | ------------- | -------- | | **Arguments** | `` | ### /hb hunt list List all hunts with state and head count. ### /hb hunt info Show detailed hunt info (state, priority, behaviors, heads, players). | | | | ------------- | -------- | | **Arguments** | `` | ### /hb hunt select Set the active hunt for head placement. No argument resets to "default". | | | | ------------- | -------- | | **Arguments** | `(name)` | | **Sender** | Player | ### /hb hunt active Display your currently selected hunt. | | | | ---------- | ------ | | **Sender** | Player | ### /hb hunt set Reassign the targeted head to the specified hunt. | | | | ------------- | -------- | | **Arguments** | `` | | **Sender** | Player | ### /hb hunt assign Mass-assign heads to a hunt. | | | | ------------- | -------------------------- | | **Arguments** | ` (N)` | ### /hb hunt transfer Transfer a specific head (by UUID) to a different hunt. | | | | ------------- | --------------- | | **Arguments** | ` ` | ### /hb hunt progress Show progression for a specific hunt. | | | | ------------- | ----------------- | | **Arguments** | ` (player)` | ### /hb hunt top Show leaderboard for a specific hunt. | | | | ------------- | ---------------- | | **Arguments** | ` (limit)` | ### /hb hunt reset Reset a player's progress in a specific hunt. | | | | ------------- | ----------------- | | **Arguments** | ` ` | ### /hb hunt schedule Manage the scheduled behavior of a hunt. Supports three scheduling modes: **range** (date bounds), **slots** (weekly time windows), and **recurring** (yearly/monthly/weekly cycles). | | | | ------------- | --------------------------- | | **Arguments** | ` (args...)` | **Sub-actions:** | Action | Arguments | Description | | ------------- | --------------------------- | ---------------------------------------------------------- | | `start` | ` (HH:mm)` | Set the range start date (time defaults to 00:00) | | `end` | ` (HH:mm)` | Set the range end date (time defaults to 00:00) | | `clear` | `(start\|end)` | Remove the schedule entirely, or only the start/end | | `mode` | `` | Switch the scheduling mode (resets mode config) | | `addslot` | ` ` | Add a time slot (e.g., `MON,WED,FRI 14:00 18:00`) | | `removeslot` | `` | Remove a time slot by its 1-based index | | `every` | `` | Set the recurrence unit (recurring mode) | | `startref` | `` | Set the start reference (`MM/dd`, day number, or day name) | | `duration` | `` | Set the duration (`31d`, `2w`, `48h`) | | `activefrom` | `` | Set the active-from bound (slots mode) | | `activeuntil` | `` | Set the active-until bound (slots mode) | | `info` | | Display the current schedule configuration | **Examples:** ``` # Range mode (default) /hb hunt schedule christmas start 12/01/2025 /hb hunt schedule christmas end 12/31/2025 23:59 /hb hunt schedule christmas clear /hb hunt schedule christmas clear start # Slots mode /hb hunt schedule weekend mode slots /hb hunt schedule weekend addslot SAT,SUN 10:00 20:00 /hb hunt schedule weekend addslot MON,WED,FRI 14:00 18:00 /hb hunt schedule weekend activefrom 03/01/2026 /hb hunt schedule weekend activeuntil 06/30/2026 /hb hunt schedule weekend removeslot 1 /hb hunt schedule weekend info # Recurring mode /hb hunt schedule xmas mode recurring /hb hunt schedule xmas every year /hb hunt schedule xmas startref 12/01 /hb hunt schedule xmas duration 31d /hb hunt schedule xmas addslot SAT,SUN 14:00 18:00 /hb hunt schedule xmas info ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://aerwyn81.gitbook.io/headblocks/headblocks3/getting-started/commands.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.