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

# Permissions

## Admin

| Permission      | Description                     |
| --------------- | ------------------------------- |
| `aircore.admin` | Grants all AirCore permissions. |

***

## Chat

### Commands

| Permission                                          | Description                               |
| --------------------------------------------------- | ----------------------------------------- |
| `aircore.module.chat.command.msg`                   | Use `/msg`.                               |
| `aircore.module.chat.command.msg.all`               | Message everyone.                         |
| `aircore.module.chat.command.reply`                 | Use `/reply`.                             |
| `aircore.module.chat.command.msgtoggle`             | Toggle private messages.                  |
| `aircore.module.chat.command.msgtoggle.others`      | Toggle private messages for others.       |
| `aircore.module.chat.command.socialspy`             | Toggle Social Spy.                        |
| `aircore.module.chat.command.socialspy.others`      | Toggle Social Spy for others.             |
| `aircore.module.chat.command.chattoggle`            | Toggle chat.                              |
| `aircore.module.chat.command.chattoggle.others`     | Toggle chat for others.                   |
| `aircore.module.chat.command.mentiontoggle`         | Toggle mentions.                          |
| `aircore.module.chat.command.mentiontoggle.others`  | Toggle mentions for others.               |
| `aircore.module.chat.command.announcetoggle`        | Toggle periodic announcements.            |
| `aircore.module.chat.command.announcetoggle.others` | Toggle periodic announcements for others. |
| `aircore.module.chat.command.block`                 | Block a player.                           |
| `aircore.module.chat.command.unblock`               | Unblock a player.                         |
| `aircore.module.chat.command.broadcast`             | Use `/broadcast`.                         |
| `aircore.module.chat.command.slowmode`              | Toggle slow mode.                         |
| `aircore.module.chat.command.*`                     | Use all chat commands.                    |

### Color Tags

| Permission                               | Description                   |
| ---------------------------------------- | ----------------------------- |
| `aircore.module.chat.color.black`        | Use `<black>` in chat.        |
| `aircore.module.chat.color.dark_blue`    | Use `<dark_blue>` in chat.    |
| `aircore.module.chat.color.dark_green`   | Use `<dark_green>` in chat.   |
| `aircore.module.chat.color.dark_aqua`    | Use `<dark_aqua>` in chat.    |
| `aircore.module.chat.color.dark_red`     | Use `<dark_red>` in chat.     |
| `aircore.module.chat.color.dark_purple`  | Use `<dark_purple>` in chat.  |
| `aircore.module.chat.color.gold`         | Use `<gold>` in chat.         |
| `aircore.module.chat.color.gray`         | Use `<gray>` in chat.         |
| `aircore.module.chat.color.dark_gray`    | Use `<dark_gray>` in chat.    |
| `aircore.module.chat.color.blue`         | Use `<blue>` in chat.         |
| `aircore.module.chat.color.green`        | Use `<green>` in chat.        |
| `aircore.module.chat.color.aqua`         | Use `<aqua>` in chat.         |
| `aircore.module.chat.color.red`          | Use `<red>` in chat.          |
| `aircore.module.chat.color.light_purple` | Use `<light_purple>` in chat. |
| `aircore.module.chat.color.yellow`       | Use `<yellow>` in chat.       |
| `aircore.module.chat.color.white`        | Use `<white>` in chat.        |
| `aircore.module.chat.color.hex`          | Use hex colors in chat.       |
| `aircore.module.chat.color.*`            | Use all chat colors.          |

### Decoration Tags

| Permission                                     | Description                                         |
| ---------------------------------------------- | --------------------------------------------------- |
| `aircore.module.chat.decoration.shadow`        | Use `<shadow:color>` to color text shadows in chat. |
| `aircore.module.chat.decoration.bold`          | Use `<bold>` in chat.                               |
| `aircore.module.chat.decoration.italic`        | Use `<italic>` in chat.                             |
| `aircore.module.chat.decoration.underlined`    | Use `<underlined>` in chat.                         |
| `aircore.module.chat.decoration.strikethrough` | Use `<strikethrough>` in chat.                      |
| `aircore.module.chat.decoration.obfuscated`    | Use `<obfuscated>` in chat.                         |
| `aircore.module.chat.decoration.*`             | Use all chat formatting.                            |

### Formatting Tags

| Permission                                | Description                                                         |
| ----------------------------------------- | ------------------------------------------------------------------- |
| `aircore.module.chat.format.rainbow`      | Use `<rainbow>` in chat.                                            |
| `aircore.module.chat.format.gradient`     | Use `<gradient>` in chat.                                           |
| `aircore.module.chat.format.transition`   | Use `<transition>` in chat.                                         |
| `aircore.module.chat.format.pride`        | Use `<pride>` in chat.                                              |
| `aircore.module.chat.format.font`         | Use `<font>` in chat.                                               |
| `aircore.module.chat.format.insertion`    | Use `<insert>` in chat to add shift-click insertable text.          |
| `aircore.module.chat.format.hover`        | Use `<hover>` in chat to show tooltips.                             |
| `aircore.module.chat.format.click.safe`   | Use `<click:open_url>` and `<click:copy_to_clipboard>` in chat.     |
| `aircore.module.chat.format.click.unsafe` | Use `<click:run_command>` and `<click:suggest_command>` in chat.    |
| `aircore.module.chat.format.click.*`      | Use all click actions in chat.                                      |
| `aircore.module.chat.format.keybind`      | Use `<key>` in chat to show a player's configured keybind.          |
| `aircore.module.chat.format.translatable` | Use `<lang>` and `<lang_or>` in chat to show client-localized text. |
| `aircore.module.chat.format.newline`      | Use `<newline>` in chat to insert line breaks.                      |
| `aircore.module.chat.format.*`            | Use all chat formatting.                                            |

### Misc

| Permission                              | Description                                     |
| --------------------------------------- | ----------------------------------------------- |
| `aircore.module.chat.mention`           | Mention other players using the mention symbol. |
| `aircore.module.chat.mention.all`       | Mention all players using the mention symbol.   |
| `aircore.module.chat.url-formatting`    | URLs are automatically formatted.               |
| `aircore.module.chat.display-tag.<tag>` | Access to a specific tag.                       |
| `aircore.module.chat.display-tag.*`     | Use all display tags.                           |
| `aircore.module.chat.channel.<channel>` | Access to a specific channel.                   |
| `aircore.module.chat.channel.*`         | Use all chat channels.                          |

### Bypasses

| Permission                                      | Description                            |
| ----------------------------------------------- | -------------------------------------- |
| `aircore.module.chat.bypass.cooldown`           | Bypass the chat message cooldown.      |
| `aircore.module.chat.bypass.toggle`             | Bypass private message toggles.        |
| `aircore.module.chat.bypass.block`              | Bypass being blocked by other players. |
| `aircore.module.chat.bypass.filter.caps`        | Bypass the caps filter.                |
| `aircore.module.chat.bypass.filter.spam`        | Bypass the spam filter.                |
| `aircore.module.chat.bypass.filter.advertising` | Bypass the advertising filter.         |
| `aircore.module.chat.bypass.filter.profanity`   | Bypass the profanity filter.           |
| `aircore.module.chat.bypass.filter.unicode`     | Bypass the unicode filter.             |
| `aircore.module.chat.bypass.filter.*`           | Bypass all chat filters.               |
| `aircore.module.chat.bypass.*`                  | Bypass all chat restrictions.          |

{% hint style="info" %}
`aircore.module.chat.*` grants all chat module permissions.
{% endhint %}

## Economy

### Commands

| Permission                                               | Description                                     |
| -------------------------------------------------------- | ----------------------------------------------- |
| `aircore.module.economy.command.balance`                 | Check your balance.                             |
| `aircore.module.economy.command.balance.others`          | Check others' balance.                          |
| `aircore.module.economy.command.balancetop`              | Use `/balancetop`.                              |
| `aircore.module.economy.command.pay`                     | Use `/pay`.                                     |
| `aircore.module.economy.command.paytoggle`               | Toggle payments.                                |
| `aircore.module.economy.command.paytoggle.others`        | Toggle payments for others.                     |
| `aircore.module.economy.command.payconfirmtoggle`        | Toggle payment confirmation prompts.            |
| `aircore.module.economy.command.payconfirmtoggle.others` | Toggle payment confirmation prompts for others. |
| `aircore.module.economy.command.eco`                     | Use `/eco`.                                     |
| `aircore.module.economy.command.eco.give`                | Give balance to a specific player.              |
| `aircore.module.economy.command.eco.give.all`            | Give balance to all online players.             |
| `aircore.module.economy.command.eco.give.server`         | Give balance to all players.                    |
| `aircore.module.economy.command.eco.take`                | Take balance from a specific player.            |
| `aircore.module.economy.command.eco.take.all`            | Take balance from all online players.           |
| `aircore.module.economy.command.eco.take.server`         | Take balance from all players.                  |
| `aircore.module.economy.command.eco.set`                 | Set balance for a specific player.              |
| `aircore.module.economy.command.eco.set.all`             | Set balance for all online players.             |
| `aircore.module.economy.command.eco.set.server`          | Set balance for all players.                    |
| `aircore.module.economy.command.eco.reset`               | Reset balance for a specific player.            |
| `aircore.module.economy.command.eco.reset.all`           | Reset balance for all online players.           |
| `aircore.module.economy.command.eco.reset.server`        | Reset balance for all players.                  |
| `aircore.module.economy.command.sell`                    | Use `/sell`.                                    |
| `aircore.module.economy.command.*`                       | Use all economy commands.                       |

### Bypasses

| Permission                                     | Description                                    |
| ---------------------------------------------- | ---------------------------------------------- |
| `aircore.module.economy.bypass.pay.toggle`     | Bypass payment toggles.                        |
| `aircore.module.economy.bypass.pay.limits`     | Bypass the minimum and maximum payment amount. |
| `aircore.module.economy.bypass.balance.limits` | Bypass the minimum and maximum balance limits. |
| `aircore.module.economy.bypass.tax.<number>`   | Allows overriding the default tax deducted.    |
| `aircore.module.economy.bypass.tax`            | Bypasses the deducted tax.                     |
| `aircore.module.economy.bypass.*`              | Bypass all economy restrictions.               |

{% hint style="info" %}
`aircore.module.economy.*` grants all economy module permissions.
{% endhint %}

## Homes

### Commands

| Permission                                | Description             |
| ----------------------------------------- | ----------------------- |
| `aircore.module.homes.command.home`       | Use `/home`.            |
| `aircore.module.homes.command.sethome`    | Use `/sethome`.         |
| `aircore.module.homes.command.delhome`    | Use `/delhome`.         |
| `aircore.module.homes.command.playerhome` | View others' homes.     |
| `aircore.module.homes.command.*`          | Use all homes commands. |

### Bypasses

| Permission                                    | Description                                   |
| --------------------------------------------- | --------------------------------------------- |
| `aircore.module.homes.bypass.limit.<number>`  | Allows overriding the default home limit.     |
| `aircore.module.homes.bypass.limit`           | No limit on the number of homes.              |
| `aircore.module.homes.bypass.disabled-worlds` | Set and teleport to homes in disabled worlds. |
| `aircore.module.homes.bypass.*`               | Bypass all homes restrictions.                |

{% hint style="info" %}
`aircore.module.homes.*` grants all homes module permissions.
{% endhint %}

## Kits

### Commands

| Permission                                  | Description                 |
| ------------------------------------------- | --------------------------- |
| `aircore.module.kits.command.kit`           | Use `/kit`.                 |
| `aircore.module.kits.command.kit.<kitname>` | Access to a specific kit.   |
| `aircore.module.kits.command.kit.*`         | Use all kits                |
| `aircore.module.kits.command.kit.others`    | Claim kits for others.      |
| `aircore.module.kits.command.kit.all`       | Claim kits for all players. |
| `aircore.module.kits.command.createkit`     | Use `/createkit`.           |
| `aircore.module.kits.command.editkit`       | Use `/editkit`.             |
| `aircore.module.kits.command.deletekit`     | Use `/deletekit`.           |
| `aircore.module.kits.command.*`             | Use all kits commands.      |

### Bypasses

| Permission                                   | Description                    |
| -------------------------------------------- | ------------------------------ |
| `aircore.module.kits.bypass.cooldown`        | Bypass kit cooldowns.          |
| `aircore.module.kits.bypass.disabled-worlds` | Claim kits in disabled worlds. |
| `aircore.module.kits.bypass.onetime`         | Reclaim one-time kits.         |
| `aircore.module.kits.bypass.*`               | Bypass all kits restrictions.  |

{% hint style="info" %}
`aircore.module.kits.*` grants all kits module permissions.
{% endhint %}

## Teleport

### Commands

| Permission                                                | Description                                              |
| --------------------------------------------------------- | -------------------------------------------------------- |
| `aircore.module.teleport.command.tp`                      | Use `/tp`.                                               |
| `aircore.module.teleport.command.tp.others`               | Teleport to another player.                              |
| `aircore.module.teleport.command.tppos`                   | Use `/tppos`.                                            |
| `aircore.module.teleport.command.tphere`                  | Use `/tphere`.                                           |
| `aircore.module.teleport.command.tphere.all`              | Teleport all players to you.                             |
| `aircore.module.teleport.command.tpoffline`               | Use `/tpoffline`.                                        |
| `aircore.module.teleport.command.tpa`                     | Use `/tpa`.                                              |
| `aircore.module.teleport.command.tpahere`                 | Use `/tpahere`.                                          |
| `aircore.module.teleport.command.tpahere.all`             | Request all players to teleport to you.                  |
| `aircore.module.teleport.command.tpaccept`                | Use `/tpaccept`.                                         |
| `aircore.module.teleport.command.tpaccept.all`            | Accept all pending teleport requests.                    |
| `aircore.module.teleport.command.tpdeny`                  | Use `/tpdeny`.                                           |
| `aircore.module.teleport.command.tpdeny.all`              | Deny all pending teleport requests.                      |
| `aircore.module.teleport.command.tpcancel`                | Use `/tpcancel`.                                         |
| `aircore.module.teleport.command.tpcancel.all`            | Cancel all pending sent teleport requests.               |
| `aircore.module.teleport.command.tptoggle`                | Toggle incoming teleport requests.                       |
| `aircore.module.teleport.command.tptoggle.others`         | Toggle incoming teleport requests for others.            |
| `aircore.module.teleport.command.tpaconfirmtoggle`        | Toggle teleport request confirmation prompts.            |
| `aircore.module.teleport.command.tpaconfirmtoggle.others` | Toggle teleport request confirmation prompts for others. |
| `aircore.module.teleport.command.tpautoaccept`            | Toggle auto-accepting incoming teleport requests.        |
| `aircore.module.teleport.command.tpautoaccept.others`     | Toggle auto-accept for others.                           |
| `aircore.module.teleport.command.back`                    | Use `/back`.                                             |
| `aircore.module.teleport.command.spawn`                   | Use `/spawn`.                                            |
| `aircore.module.teleport.command.spawn.others`            | Teleport others to spawn.                                |
| `aircore.module.teleport.command.setspawn`                | Use `/setspawn`.                                         |
| `aircore.module.teleport.command.warp`                    | Use `/warp`.                                             |
| `aircore.module.teleport.command.warp.<warpname>`         | Access to a specific warp.                               |
| `aircore.module.teleport.command.warp.others`             | Teleport others to a warp.                               |
| `aircore.module.teleport.command.setwarp`                 | Use `/setwarp`.                                          |
| `aircore.module.teleport.command.deletewarp`              | Use `/deletewarp`.                                       |
| `aircore.module.teleport.command.*`                       | Use all teleport commands.                               |

### Bypasses

| Permission                                            | Description                                                  |
| ----------------------------------------------------- | ------------------------------------------------------------ |
| `aircore.module.teleport.bypass.cooldown`             | Bypass the teleport request cooldown.                        |
| `aircore.module.teleport.bypass.countdown`            | Bypass the teleport countdown.                               |
| `aircore.module.teleport.bypass.toggle`               | Bypass teleport request toggles.                             |
| `aircore.module.teleport.bypass.max-pending.<number>` | Allows overriding the default max-pending teleport requests. |
| `aircore.module.teleport.bypass.max-pending`          | Bypass the maximum pending teleport requests limit.          |
| `aircore.module.teleport.bypass.disabled-worlds`      | Teleport and use warps in disabled worlds.                   |
| `aircore.module.teleport.bypass.*`                    | Bypass all teleport restrictions.                            |

{% hint style="info" %}
`aircore.module.teleport.*` grants all teleport module permissions.
{% endhint %}

## Utils

### Commands

| Permission                                           | Description                               |
| ---------------------------------------------------- | ----------------------------------------- |
| `aircore.module.utils.command.heal`                  | Use `/heal`.                              |
| `aircore.module.utils.command.heal.others`           | Heal another player.                      |
| `aircore.module.utils.command.heal.all`              | Heal all players.                         |
| `aircore.module.utils.command.feed`                  | Use `/feed`.                              |
| `aircore.module.utils.command.feed.others`           | Feed another player.                      |
| `aircore.module.utils.command.feed.all`              | Feed all players.                         |
| `aircore.module.utils.command.fly`                   | Use `/fly`.                               |
| `aircore.module.utils.command.fly.others`            | Toggle flight for another player.         |
| `aircore.module.utils.command.god`                   | Use `/god`.                               |
| `aircore.module.utils.command.god.others`            | Toggle god mode for another player.       |
| `aircore.module.utils.command.speed`                 | Use `/speed`.                             |
| `aircore.module.utils.command.speed.others`          | Set speed for another player.             |
| `aircore.module.utils.command.speed.all`             | Set speed for all online players.         |
| `aircore.module.utils.command.repair`                | Use `/repair`.                            |
| `aircore.module.utils.command.repairall`             | Use `/repairall`.                         |
| `aircore.module.utils.command.clearinventory`        | Use `/clearinventory`.                    |
| `aircore.module.utils.command.clearinventory.others` | Clear another player's inventory.         |
| `aircore.module.utils.command.clearinventory.all`    | Clear all online players' inventories.    |
| `aircore.module.utils.command.kill`                  | Use `/kill`.                              |
| `aircore.module.utils.command.kill.others`           | Kill another player.                      |
| `aircore.module.utils.command.kill.all`              | Kill all players.                         |
| `aircore.module.utils.command.invsee`                | Use `/invsee`.                            |
| `aircore.module.utils.command.invsee.modify`         | Modify another player's inventory.        |
| `aircore.module.utils.command.endersee`              | Use `/endersee`.                          |
| `aircore.module.utils.command.endersee.modify`       | Modify another player's enderchest.       |
| `aircore.module.utils.command.enderchest`            | Use `/enderchest`.                        |
| `aircore.module.utils.command.enderchest.others`     | View another player's enderchest.         |
| `aircore.module.utils.command.afk`                   | Use `/afk`.                               |
| `aircore.module.utils.command.nick`                  | Use `/nick`.                              |
| `aircore.module.utils.command.nick.others`           | Set another player's nickname.            |
| `aircore.module.utils.command.sudo`                  | Use `/sudo`.                              |
| `aircore.module.utils.command.ping`                  | Use `/ping`.                              |
| `aircore.module.utils.command.ping.others`           | Check another player's ping.              |
| `aircore.module.utils.command.seen`                  | Use `/seen`.                              |
| `aircore.module.utils.command.gamemode`              | Use `/gamemode`.                          |
| `aircore.module.utils.command.gamemode.others`       | Change another player's gamemode.         |
| `aircore.module.utils.command.gamemode.all`          | Change gamemode for online players.       |
| `aircore.module.utils.command.time`                  | Use `/time`.                              |
| `aircore.module.utils.command.playertime`            | Use `/playertime`.                        |
| `aircore.module.utils.command.playertime.others`     | Change another player's personal time.    |
| `aircore.module.utils.command.weather`               | Use `/weather`.                           |
| `aircore.module.utils.command.playerweather`         | Use `/playerweather`.                     |
| `aircore.module.utils.command.playerweather.others`  | Change another player's personal weather. |
| `aircore.module.utils.command.announcement`          | Use `/announcement`.                      |
| `aircore.module.utils.command.*`                     | Use all utils commands.                   |

### Virtual Workstations

| Permission                                           | Description                           |
| ---------------------------------------------------- | ------------------------------------- |
| `aircore.module.utils.command.virtual.craftingtable` | Use `/craftingtable`.                 |
| `aircore.module.utils.command.virtual.anvil`         | Use `/anvil`.                         |
| `aircore.module.utils.command.virtual.cartography`   | Use `/cartography`.                   |
| `aircore.module.utils.command.virtual.loom`          | Use `/loom`.                          |
| `aircore.module.utils.command.virtual.smithingtable` | Use `/smithingtable`.                 |
| `aircore.module.utils.command.virtual.stonecutter`   | Use `/stonecutter`.                   |
| `aircore.module.utils.command.virtual.grindstone`    | Use `/grindstone`.                    |
| `aircore.module.utils.command.virtual.*`             | Use all virtual workstation commands. |

### Bypasses

| Permission                                       | Description                                                                                                                     |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `aircore.module.utils.bypass.cooldown.<command>` | Bypasses the cooldown for a specific utils command. Registered dynamically based on the cooldowns configured in `commands.yml`. |
| `aircore.module.utils.bypass.cooldown.*`         | Bypass all utils command cooldowns.                                                                                             |
| `aircore.module.utils.bypass.*`                  | Bypass all utils restrictions.                                                                                                  |

{% hint style="info" %}
`aircore.module.utils.*` grants all utils module permissions.
{% endhint %}

## Wildcards

| Permission                  | Description                                                                                             |
| --------------------------- | ------------------------------------------------------------------------------------------------------- |
| `aircore.module.<module>.*` | Grants all permissions for a specific module (`chat`, `economy`, `homes`, `kits`, `teleport`, `utils`). |
| `aircore.module.*`          | Grants all module permissions.                                                                          |
| `aircore.admin`             | Grants all AirCore permissions.                                                                         |

## Misc

| Permission                         | Description                     |
| ---------------------------------- | ------------------------------- |
| `aircore.misc.enderchest.rows.<#>` | Enderchest size override (1-6). |


---

# 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://airdevelopment.gitbook.io/docs/aircore/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.