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

# Commands & Permissions

Comprehensive command syntax and permission nodes for FreeCarts.

## Player Commands

| Command                                           | Description                                               | Permission           |
| ------------------------------------------------- | --------------------------------------------------------- | -------------------- |
| `/freecart`                                       | Spawns a cart at the player's location (same as spawn)    | `freecarts.spawn`    |
| `/freecart spawn [--block <material>]`            | Spawns a cart with optional custom block appearance       | `freecarts.spawn`    |
| `/freecart pick [cart_name]`                      | Picks up targeted cart, fuel station, or named cart       | `freecarts.use`      |
| `/freecart gui [cart_name]`                       | Opens the cart upgrade and management GUI                 | `freecarts.use`      |
| `/freecart garage [player]`                       | Opens virtual garage storage                              | `freecarts.garage`   |
| `/freecart storage`                               | Opens the onboard cargo trunk inventory of targeted cart  | `freecarts.use`      |
| `/freecart depot [player] [cart_name]`            | Opens interactive Depot management & navigation GUI       | `freecarts.use`      |
| `/freecart delivery <fuelcan/repairkit> <amount>` | Orders emergency parachute supply drop                    | `freecarts.delivery` |
| `/freecart access add <player>`                   | Grants driving access to targeted cart                    | `freecarts.use`      |
| `/freecart access remove <player>`                | Revokes driving access from targeted cart                 | `freecarts.use`      |
| `/freecart access list`                           | Lists all authorized riders for targeted cart             | `freecarts.use`      |
| `/freecart access transfer <player>`              | Transfers cart ownership to another player                | `freecarts.use`      |
| `/freecart customize color`                       | Gives interactive name color picker tool                  | `freecarts.use`      |
| `/freecart customize lore`                        | Opens interactive chat prompt to set 3 cart lore lines    | `freecarts.use`      |
| `/freecart customize paint`                       | Gives color paintbrush tool to change model color         | `freecarts.use`      |
| `/freecart customize name set <name>`             | Sets custom display name for targeted cart                | `freecarts.use`      |
| `/freecart customize name show`                   | Displays the current name of targeted cart                | `freecarts.use`      |
| `/freecart variant`                               | Cycles or purchases paint color variants for active model | `freecarts.variant`  |

## Autopilot Commands

| Command                            | Description                                           | Permission            |
| ---------------------------------- | ----------------------------------------------------- | --------------------- |
| `/freecart autopilot follow`       | Toggles autonomous cart follow-owner mode             | `freecarts.autopilot` |
| `/freecart autopilot depot`        | Opens depot destination menu for targeted/ridden cart | `freecarts.autopilot` |
| `/freecart autopilot depot <name>` | Dispatches targeted/ridden cart to specified depot    | `freecarts.autopilot` |
| `/freecart autopilot off`          | Disengages active autopilot mode                      | `freecarts.autopilot` |
| `/freecart autopilot status`       | Displays current navigation status, ETA, and target   | `freecarts.autopilot` |

## Item Distribution Commands

| Command                                                       | Description                                        | Permission       |
| ------------------------------------------------------------- | -------------------------------------------------- | ---------------- |
| `/freecart give cart [player] [--block <mat>] [--model <id>]` | Gives a FreeCart item with optional block or model | `freecarts.give` |
| `/freecart give depot [player] [amount]`                      | Gives Depot Creator placement items                | `freecarts.give` |
| `/freecart give fuelcan [player] [amount]`                    | Gives portable Fuel Can items                      | `freecarts.give` |
| `/freecart give repairkit [player] [amount]`                  | Gives Repair Kit items                             | `freecarts.give` |

## Fuel Station Commands

| Command                                     | Description                                       | Permission        |
| ------------------------------------------- | ------------------------------------------------- | ----------------- |
| `/freecart fuelstation give`                | Gives a universal Fuel Station placement item     | `freecarts.admin` |
| `/freecart fuelstation model import <name>` | Imports BlockDisplay fuel station model from file | `freecarts.admin` |
| `/freecart fuelstation model list`          | Lists all imported fuel station models            | `freecarts.admin` |
| `/freecart fuelstation model info <name>`   | Displays details for specified fuel station model | `freecarts.admin` |

## Model Commands

| Command                          | Description                                | Permission               |
| -------------------------------- | ------------------------------------------ | ------------------------ |
| `/freecart model list`           | Lists all registered 3D cart models        | `freecarts.model`        |
| `/freecart model set <model_id>` | Applies a 3D model to the targeted cart    | `freecarts.model.set`    |
| `/freecart model remove`         | Removes custom 3D model from targeted cart | `freecarts.model.remove` |

## Administrator Commands

| Command                                                        | Description                                                     | Permission                 |
| -------------------------------------------------------------- | --------------------------------------------------------------- | -------------------------- |
| `/freecart reload`                                             | Hot-reloads configuration files, language strings, and models   | `freecarts.admin`          |
| `/freecart admin cleanup`                                      | Purges orphaned database and cache records                      | `freecarts.admin`          |
| `/freecart admin refuel`                                       | Instantly refuels targeted cart to 100%                         | `freecarts.admin`          |
| `/freecart admin repair`                                       | Instantly restores 100 health to targeted cart                  | `freecarts.admin`          |
| `/freecart admin locate <cart_name>`                           | Locates coordinates of an active cart with clickable `/tp`      | `freecarts.admin`          |
| `/freecart admin takeover [player]`                            | Transfers ownership of targeted cart to yourself or player      | `freecarts.admin.takeover` |
| `/freecart admin remove`                                       | Strips ownership from targeted cart (makes it unowned)          | `freecarts.admin`          |
| `/freecart admin info`                                         | Displays owner and authorized riders for targeted cart          | `freecarts.admin`          |
| `/freecart admin dbstats`                                      | Displays HikariCP database pool statistics and tests connection | `freecarts.admin`          |
| `/freecart admin setdepot <player> <x> <y> <z> [world] [name]` | Remotely sets a depot for a player at specified coordinates     | `freecarts.admin`          |
| `/freecart admin depotconfirm <server\|personal\|cancel>`      | Confirms depot registration type when placing a depot block     | `freecarts.admin`          |
| `/freecart import`                                             | Migrates garage and depot data from YAML to SQL database        | `freecarts.admin`          |
| `/freecart export`                                             | Exports garage and depot data from SQL database to YAML files   | `freecarts.admin`          |

## Permission Nodes

| Node                             | Description                                              | Default                              |
| -------------------------------- | -------------------------------------------------------- | ------------------------------------ |
| `freecarts.use`                  | Basic cart driving, interaction, storage, and HUD        | All Players (`true`)                 |
| `freecarts.spawn`                | Allows spawning freecarts with `/freecart spawn`         | Operators (`op`)                     |
| `freecarts.give`                 | Allows giving carts, depots, fuel cans, and repair kits  | Operators (`op`)                     |
| `freecarts.delivery`             | Allows ordering fuel and repair deliveries               | All Players (`true`)                 |
| `freecarts.garage`               | Allows access to virtual garage                          | All Players (`true`)                 |
| `freecarts.garage.slots.<1-18>`  | Unlocks up to specified garage slots (slot 1 is default) | Slot 1: `true`, Others: `false`/`op` |
| `freecarts.depot`                | Allows using depots and opening the depot menu           | All Players (`true`)                 |
| `freecarts.depot.limit.<number>` | Sets player's maximum registered depot limit             | Operators (`op`)                     |
| `freecarts.depot.unlimited`      | Grants depot registrations up to the server hard limit   | Operators (`op`)                     |
| `freecarts.autopilot`            | Allows using the autopilot system                        | All Players (`true`)                 |
| `freecarts.autopilot.debug`      | Allows toggling autopilot pathfinding debug mode         | Operators (`op`)                     |
| `freecarts.fuel.use`             | Allows refueling at fuel stations                        | All Players (`true`)                 |
| `freecarts.fuel.infinite`        | Bypasses fuel costs (free refueling)                     | Operators (`op`)                     |
| `freecarts.fuel.place`           | Allows placing fuel stations                             | Operators (`op`)                     |
| `freecarts.fuel.remove`          | Allows removing fuel stations                            | Operators (`op`)                     |
| `freecarts.fuel.pick`            | Allows picking up fuel stations with `/freecart pick`    | Operators (`op`)                     |
| `freecarts.variant`              | Allows purchasing and using model paint variants         | All Players (`true`)                 |
| `freecarts.model`                | Allows listing cart models                               | Operators (`op`)                     |
| `freecarts.model.set`            | Allows applying 3D cart models                           | Operators (`op`)                     |
| `freecarts.model.remove`         | Allows removing 3D cart models                           | Operators (`op`)                     |
| `freecarts.bypass.cartlimit`     | Bypasses the maximum placed carts in world limit         | Operators (`op`)                     |
| `freecarts.admin`                | Full administrative control                              | Operators (`op`)                     |
| `freecarts.admin.takeover`       | Allows taking ownership of any cart                      | Operators (`op`)                     |
| `freecarts.admin.pick`           | Allows picking up any cart regardless of ownership       | Operators (`op`)                     |
| `freecarts.admin.refuel`         | Allows admin refueling of carts                          | Operators (`op`)                     |
| `freecarts.admin.destroy`        | Allows destroying any freecart                           | Operators (`op`)                     |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://mavenverse.gitbook.io/mavenverse-docs/freecarts/commands-and-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.