> For the complete documentation index, see [llms.txt](https://titans.gitbook.io/titans/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://titans.gitbook.io/titans/commands-and-permissions.md).

# Commands and Permissions

````
# Titans Command Reference

This page combines all major **player**, **admin**, **leaderboard**, **XP**, **economy**, **Invader**, and **progression** commands for the Titans mod.

Commands are separated by category so server owners can easily copy this into a GitBook wiki page.

---

# Permission Nodes

| Permission | Description |
|---|---|
| `Titans.use` | Standard player permission for most basic Titans commands. |
| `Titans.teleport` | Allows players to teleport to active Titans. |
| `Titans.join` | Allows players to manually join Titan fights. |
| `Titans.leaderboard` | Allows players to open leaderboard GUIs. |
| `titans.admin` | Admin permission for managing bosses, configs, XP, shards, multipliers, and Invaders. |

{% hint style="info" %}
Some servers may use lowercase permission formatting depending on the permission plugin. If a command does not work, check how your permissions plugin stores nodes.
{% endhint %}

---

# Player Commands

These are the main commands normal players can use.

| Command | Description | Permission |
|---|---|---|
| `/titans activebosses` | Shows a list of currently active Titan bosses, including their HP and level. | `Titans.use` |
| `/titans info <bossName>` | Displays detailed info about the specified active boss, including name, species, level, HP, shield info, and despawn timer. | `Titans.use` |
| `/titans time` | Shows the time remaining until the next scheduled boss spawn, if the scheduler is enabled. | `Titans.use` |
| `/titans top <bossName>` | Displays the top 5 players ranked by damage dealt to the specified boss. | `Titans.use` |
| `/titans mydamage <bossName>` | Shows how much total damage you personally dealt to the specified boss. | `Titans.use` |
| `/titans rewards <bossName>` | Lists all potential rewards for the specified boss. | `Titans.use` |
| `/titans where` | Displays the world and coordinates of all currently active bosses. | `Titans.use` |
| `/titans tp <bossName>` | Teleports you directly to the specified active boss's location, if teleporting is allowed. | `Titans.teleport` |
| `/titans join <bossName>` | Manually joins the specified boss fight, if you are within the allowed distance. | `Titans.join` |

---

## Player Command Examples

```text
/titans activebosses
````

Shows all active Titan bosses.

```
/titans info rayquaza
```

Shows detailed information about the active Rayquaza boss.

```
/titans top rayquaza
```

Shows the top 5 damage dealers for Rayquaza.

```
/titans mydamage rayquaza
```

Shows your personal damage dealt to Rayquaza.

```
/titans tp rayquaza
```

Teleports you to Rayquaza if teleporting is enabled and you have permission.

***

## Admin Commands

These commands require admin access or the correct admin permission node.

| Command                                                  | Description                                                                                    | Permission     |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -------------- |
| `/titans despawn <bossName>`                             | Immediately despawns the specified active boss.                                                | `titans.admin` |
| `/titans list`                                           | Lists all available boss IDs from the config folder, not just active bosses.                   | `titans.admin` |
| `/titans reload`                                         | Reloads Titan configs, scheduler settings, and webhook settings without restarting the server. | `titans.admin` |
| `/titans webhooktest`                                    | Sends a test webhook using the configured webhook settings.                                    | `titans.admin` |
| `/titans scheduler toggle`                               | Turns the automatic boss spawn scheduler on or off.                                            | `titans.admin` |
| `/titans scheduler next`                                 | Shows how long until the next scheduled boss spawn attempt.                                    | `titans.admin` |
| `/titans heal <bossName> [amount\|full]`                 | Heals the boss by the given amount, or fully heals it if `full` is used.                       | `titans.admin` |
| `/titans damage <bossName> <amount>`                     | Directly applies the given amount of damage to the boss.                                       | `titans.admin` |
| `/titans shieldinfo <bossName>`                          | Displays information about the boss's current shield, including type, HP, and multiplier.      | `titans.admin` |
| `/titans breakshield <bossName>`                         | Instantly breaks the boss's active shield.                                                     | `titans.admin` |
| `/titans addshield <bossName> <type> <hpThreshold> <hp>` | Adds a new shield phase to the boss.                                                           | `titans.admin` |
| `/titans debug`                                          | Shows debug info, including active boss count and current boss HP values.                      | `titans.admin` |
| `/titans spawn <bossId>`                                 | Manually spawns a Titan boss using its config ID.                                              | `titans.admin` |
| `/titans reloadconfig`                                   | Reloads example configs and language files, useful for testing new setups.                     | `titans.admin` |

***

### Shield Admin Command Details

The shield command uses the following format:

```
/titans addshield <bossName> <type> <hpThreshold> <hp>
```

| Argument        | Description                                                                      |
| --------------- | -------------------------------------------------------------------------------- |
| `<bossName>`    | The active boss receiving the shield.                                            |
| `<type>`        | The shield element type, such as `ELECTRIC`, `STEEL`, or another supported type. |
| `<hpThreshold>` | The boss HP percentage where the shield activates.                               |
| `<hp>`          | The shield HP if the shield is breakable.                                        |

#### Example

```
/titans addshield rayquaza ELECTRIC 50 10000
```

This adds an Electric shield to Rayquaza that activates at `50%` HP with `10,000` shield HP.

***

## Leaderboard Commands

These commands open styled leaderboard GUIs.

| Command                         | Description                                                                 | Permission           |
| ------------------------------- | --------------------------------------------------------------------------- | -------------------- |
| `/titans leaderboard kills`     | Shows players ranked by total boss kills.                                   | `Titans.leaderboard` |
| `/titans leaderboard damage`    | Shows players ranked by total cumulative damage dealt across all bosses.    | `Titans.leaderboard` |
| `/titans leaderboard fights`    | Shows players ranked by number of boss fights joined.                       | `Titans.leaderboard` |
| `/titans leaderboard firsthits` | Shows players ranked by how many times they landed the first hit on a boss. | `Titans.leaderboard` |
| `/titans leaderboard xp`        | Shows players ranked by total lifetime Titan XP.                            | `Titans.leaderboard` |
| `/titans leaderboard partyxp`   | Shows parties ranked by their cumulative XP earnings.                       | `Titans.leaderboard` |

***

### Leaderboard Types

| Leaderboard | Tracks                                 |
| ----------- | -------------------------------------- |
| `kills`     | Total boss kills.                      |
| `damage`    | Total cumulative boss damage.          |
| `fights`    | Total boss fights joined.              |
| `firsthits` | Number of first hits landed on bosses. |
| `xp`        | Lifetime Titan XP.                     |
| `partyxp`   | Total XP earned by parties.            |

***

## Titan XP Commands

Titan XP is the long-term ranking and progression system for players.

Players can earn Titan XP through boss fights, rewards, events, and admin grants.

***

## Titan XP Commands: Players

These commands require the standard player permission.

| Command               | Description                                                                                         | Permission   |
| --------------------- | --------------------------------------------------------------------------------------------------- | ------------ |
| `/titans xp`          | Shows your current Titan XP, rank, and progress toward the next level.                              | `titans.use` |
| `/titans xp [player]` | Shows another player's Titan XP status, if allowed.                                                 | `titans.use` |
| `/titans xp prestige` | Resets your Titan XP to `0` in exchange for a Prestige level, if you have reached the maximum rank. | `titans.use` |

***

### Titan XP Player Examples

```
/titans xp
```

Shows your current Titan XP and rank progress.

```
/titans xp Steve
```

Shows Steve's Titan XP status.

```
/titans xp prestige
```

Prestiges your Titan XP if you meet the requirements.

***

## Titan XP Commands: Admins

These commands require admin access.

| Command                                                         | Description                                                                  | Permission     |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------- |
| `/titans xp log <player>`                                       | Displays a detailed history of XP gains and losses for the specified player. | `titans.admin` |
| `/titans xp event <multiplier> <durationMinutes>`               | Starts a server-wide bonus XP event.                                         | `titans.admin` |
| `/titans xp event`                                              | Shows active XP events if used with no arguments.                            | `titans.admin` |
| `/titans xp admin give <targets> <amount>`                      | Gives Titan XP to one or more players.                                       | `titans.admin` |
| `/titans xp admin take <targets> <amount>`                      | Removes Titan XP from one or more players.                                   | `titans.admin` |
| `/titans xp admin set <targets> <amount>`                       | Sets a player's Titan XP balance to the specified amount.                    | `titans.admin` |
| `/titans xp admin party <partyName> <give\|take\|set> <amount>` | Manages Titan XP for an entire party at once.                                | `titans.admin` |

***

### Titan XP Admin Examples

```
/titans xp event 2.0 60
```

Starts a `2.0x` Titan XP event for `60` minutes.

```
/titans xp admin give Steve 500
```

Gives Steve `500` Titan XP.

```
/titans xp admin take Steve 250
```

Removes `250` Titan XP from Steve.

```
/titans xp admin set Steve 10000
```

Sets Steve's Titan XP to `10,000`.

```
/titans xp admin party dragons give 1000
```

Gives `1,000` Titan XP to the entire `dragons` party.

***

## Economy Commands

The Titans economy uses **Titan Shards** as a currency for shops, rewards, and player trading.

***

## Economy Commands: Players

These commands require the standard player permission.

| Command                                | Description                                                            | Permission   |
| -------------------------------------- | ---------------------------------------------------------------------- | ------------ |
| `/titans shop`                         | Opens the in-game Shard Shop GUI to purchase items.                    | `titans.use` |
| `/titans shards`                       | Checks your current Titan Shards balance.                              | `titans.use` |
| `/titans shards pay <player> <amount>` | Sends a specific number of shards from your balance to another player. | `titans.use` |

***

### Economy Player Examples

```
/titans shop
```

Opens the Titan Shard Shop.

```
/titans shards
```

Shows your current Titan Shard balance.

```
/titans shards pay Steve 100
```

Sends `100` Titan Shards to Steve.

***

## Economy Commands: Admins

These commands require admin access.

| Command                                        | Description                                            | Permission     |
| ---------------------------------------------- | ------------------------------------------------------ | -------------- |
| `/titans shards <player>`                      | Checks the shard balance of the specified player.      | `titans.admin` |
| `/titans shards admin give <targets> <amount>` | Gives Titan Shards to one or more players.             | `titans.admin` |
| `/titans shards admin take <targets> <amount>` | Removes Titan Shards from one or more players.         | `titans.admin` |
| `/titans shards admin set <targets> <amount>`  | Sets a player's shard balance to the specified amount. | `titans.admin` |

***

### Economy Admin Examples

```
/titans shards Steve
```

Checks Steve's shard balance.

```
/titans shards admin give Steve 500
```

Gives Steve `500` Titan Shards.

```
/titans shards admin take Steve 100
```

Removes `100` Titan Shards from Steve.

```
/titans shards admin set Steve 2500
```

Sets Steve's shard balance to `2,500`.

***

## Multipliers and Cooldowns

These commands allow admins to manage cooldowns and temporary damage multipliers.

***

### Admin Multiplier and Cooldown Commands

| Command                                                               | Description                                                                                          | Permission     |
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------- |
| `/titans resetcooldown <player> [bossId]`                             | Resets all cooldowns for a player, or only the cooldown for a specific boss if `bossId` is provided. | `titans.admin` |
| `/titans admin multiplier global <value> [durationMinutes]`           | Sets a global damage multiplier for all players against Titans.                                      | `titans.admin` |
| `/titans admin multiplier player <targets> <value> [durationMinutes]` | Sets a personal damage multiplier for specific players.                                              | `titans.admin` |
| `/titans admin multiplier reset`                                      | Immediately resets all global damage multipliers back to `1.0x`.                                     | `titans.admin` |

***

### Multiplier Examples

```
/titans admin multiplier global 2.0 60
```

Sets a global `2.0x` Titan damage multiplier for `60` minutes.

```
/titans admin multiplier player Steve 1.5 30
```

Gives Steve a personal `1.5x` damage multiplier for `30` minutes.

```
/titans admin multiplier reset
```

Resets all global damage multipliers back to `1.0x`.

```
/titans resetcooldown Steve rayquaza
```

Resets Steve's cooldown for the Rayquaza boss.

***

## Invader Commands

Invader commands are used for the server-wide Invader system, including panic, punishments, blessings, invasion events, and active Invader tracking.

***

## Invader Commands: Players

These commands require the standard player permission.

| Command                                   | Description                                                                           | Permission   |
| ----------------------------------------- | ------------------------------------------------------------------------------------- | ------------ |
| `/titans invaders top`                    | Displays the persistent lifetime damage leaderboard for all players against Invaders. | `titans.use` |
| `/titans invaders active`                 | Shows all current server-wide punishments or blessings currently in effect.           | `titans.use` |
| `/titans invaders multipliers`            | Displays the exact active multipliers for XP, Shiny rates, and Shop prices.           | `titans.use` |
| `/titans invaders dps`                    | Opens a golden-themed GUI showing live damage logs for the currently active Invader.  | `titans.use` |
| `/titans invaders teleport <invaderName>` | Teleports you directly to the active Invader's location to join the defense.          | `titans.use` |

***

### Invader Player Examples

```
/titans invaders top
```

Shows the lifetime Invader damage leaderboard.

```
/titans invaders active
```

Shows current active punishments and blessings.

```
/titans invaders multipliers
```

Shows current server-wide Invader multipliers.

```
/titans invaders teleport rayquaza
```

Teleports you to the active Rayquaza Invader.

***

## Invader Commands: Admins

These commands require admin access.

| Command                                  | Description                                                                                              | Permission     |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------- |
| `/titans invaders spawn <invaderId>`     | Manually spawns an Invader using its config ID.                                                          | `titans.admin` |
| `/titans invaders despawn <invaderName>` | Immediately removes an active Invader from the world.                                                    | `titans.admin` |
| `/titans invaders panic set <0-100>`     | Manually sets the server's Global Heat level to the specified percentage.                                | `titans.admin` |
| `/titans invaders panic get`             | Displays the current server Heat level.                                                                  | `titans.admin` |
| `/titans invaders event list`            | Lists all currently running scheduled invasion events.                                                   | `titans.admin` |
| `/titans invaders clear [name]`          | Clears active punishments for a specific Invader, or clears all server-wide effects if no name is given. | `titans.admin` |
| `/titans invaders scheduler next`        | Shows exactly how long until the next random Invader spawn attempt.                                      | `titans.admin` |
| `/titans invaders list`                  | Lists all available Invader IDs from your configuration folder.                                          | `titans.admin` |

***

### Invader Admin Examples

```
/titans invaders spawn kyogre
```

Manually spawns the Kyogre Invader.

```
/titans invaders despawn kyogre
```

Despawns the active Kyogre Invader.

```
/titans invaders panic get
```

Shows the current Global Heat level.

```
/titans invaders panic set 75
```

Sets Global Heat to `75%`.

```
/titans invaders event list
```

Shows currently active invasion events.

```
/titans invaders clear
```

Clears all active server-wide Invader punishments and blessings.

```
/titans invaders clear kyogre
```

Clears effects caused by Kyogre specifically.

***

## Progression Commands

Progression commands are used for Mastery, Bestiary, and Daily Bounties.

These commands require the standard player permission.

| Command                                                   | Description                                                                   | Permission   |
| --------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------ |
| `/titans mastery`                                         | Opens your Mastery Tree info, showing unspent points and perk levels.         | `titans.use` |
| `/titans mastery upgrade <offensive\|defensive\|utility>` | Spends `1` Mastery Point to level up the specified perk.                      | `titans.use` |
| `/titans bestiary`                                        | Displays your persistent hunting records for every Titan and Invader species. | `titans.use` |
| `/titans bounties`                                        | Shows your current daily tasks and progress toward earning Mastery Points.    | `titans.use` |

***

### Progression Command Examples

```
/titans mastery
```

Shows your Mastery Tree progress.

```
/titans mastery upgrade offensive
```

Upgrades Offensive Power by `1` level.

```
/titans mastery upgrade defensive
```

Upgrades Defensive Power by `1` level.

```
/titans mastery upgrade utility
```

Upgrades Utility Loot by `1` level.

```
/titans bestiary
```

Opens your Titan and Invader hunting records.

```
/titans bounties
```

Shows today's Daily Bounties and your progress.

***

## Command Groups Summary

| Category                  | Purpose                                                                              |
| ------------------------- | ------------------------------------------------------------------------------------ |
| Player Commands           | Basic boss info, rewards, damage tracking, teleporting, and joining fights.          |
| Admin Commands            | Boss spawning, despawning, config reloads, scheduler control, and shield management. |
| Leaderboard Commands      | Opens ranked GUIs for kills, damage, fights, first hits, XP, and party XP.           |
| Titan XP Commands         | Manages Titan XP, ranks, prestige, XP logs, and XP events.                           |
| Economy Commands          | Manages Titan Shards, player payments, and the Shard Shop.                           |
| Multipliers and Cooldowns | Controls cooldown resets and temporary damage multipliers.                           |
| Invader Commands          | Manages Invader bosses, punishments, blessings, panic, and invasion events.          |
| Progression Commands      | Handles Mastery, Bestiary, and Daily Bounties.                                       |

***

## Quick Player Command List

```
/titans activebosses
/titans info <bossName>
/titans time
/titans top <bossName>
/titans mydamage <bossName>
/titans rewards <bossName>
/titans where
/titans tp <bossName>
/titans join <bossName>
/titans leaderboard kills
/titans leaderboard damage
/titans leaderboard fights
/titans leaderboard firsthits
/titans leaderboard xp
/titans leaderboard partyxp
/titans xp
/titans xp [player]
/titans xp prestige
/titans shop
/titans shards
/titans shards pay <player> <amount>
/titans invaders top
/titans invaders active
/titans invaders multipliers
/titans invaders dps
/titans invaders teleport <invaderName>
/titans mastery
/titans mastery upgrade <offensive|defensive|utility>
/titans bestiary
/titans bounties
```

***

## Quick Admin Command List

```
/titans despawn <bossName>
/titans list
/titans reload
/titans webhooktest
/titans scheduler toggle
/titans scheduler next
/titans heal <bossName> [amount|full]
/titans damage <bossName> <amount>
/titans shieldinfo <bossName>
/titans breakshield <bossName>
/titans addshield <bossName> <type> <hpThreshold> <hp>
/titans debug
/titans spawn <bossId>
/titans reloadconfig
/titans xp log <player>
/titans xp event <multiplier> <durationMinutes>
/titans xp admin give <targets> <amount>
/titans xp admin take <targets> <amount>
/titans xp admin set <targets> <amount>
/titans xp admin party <partyName> <give|take|set> <amount>
/titans shards <player>
/titans shards admin give <targets> <amount>
/titans shards admin take <targets> <amount>
/titans shards admin set <targets> <amount>
/titans resetcooldown <player> [bossId]
/titans admin multiplier global <value> [durationMinutes]
/titans admin multiplier player <targets> <value> [durationMinutes]
/titans admin multiplier reset
/titans invaders spawn <invaderId>
/titans invaders despawn <invaderName>
/titans invaders panic set <0-100>
/titans invaders panic get
/titans invaders event list
/titans invaders clear [name]
/titans invaders scheduler next
/titans invaders list
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://titans.gitbook.io/titans/commands-and-permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.