# Commands and Permissions

{% hint style="info" %}
You can create a unlimited types of minions.
{% endhint %}

The main command for TopMinion is **/topminion,** it have **giveminion**, **items** and **reload** as subcommands, players with **OP** or **topminion.admin** can use them.

### */topminion giveminion* usage

<table><thead><tr><th width="150">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Type</td><td>Text (String)</td><td>You have <strong>5 types</strong>, each with their own job: Farmer, Fisher, Lumberjack, Miner and Slayer.</td></tr><tr><td>Material/Mob</td><td>Text (String)</td><td>Each type has its own material or mob that must be farmed, you can create your own minion, for example by making one that mines obsidian.</td></tr><tr><td>Level</td><td>Number (Integer)</td><td>The minions can have a fully configurable level, you can add or remove levels according to your preference.</td></tr><tr><td>Player <strong>(Optional)</strong></td><td>Text (String)</td><td>Name of the player you want to give the minion</td></tr></tbody></table>

### */topminion items* usage

The syntax is /topminion items \<item> give/set and the parameters are being explained here:&#x20;

[🧰](https://emojiterra.com/es/emojis/cofre-es/) | Chest Item Type

&#x20;/topminion items chest set \<tier> \[\<CustomModelData>]

<table><thead><tr><th width="147">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Tier</td><td>Number (Integer)</td><td>Each type of chest has its tier level so that it can be used on the minion. <mark style="color:red;">(Only from 1 to 4)</mark></td></tr><tr><td>Custom Model Data <strong>(Optional)</strong></td><td>Number (Integer)</td><td>You can establish a custom model data to be able to make custom chest.</td></tr></tbody></table>

&#x20;/topminion items chest give \<tier> \[\<player>]

<table><thead><tr><th width="147">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Tier</td><td>Number (Integer)</td><td>Each type of chest has its tier level so that it can be used on the minion. <mark style="color:red;">(Only from 1 to 4)</mark></td></tr><tr><td>Player <strong>(Optional)</strong></td><td>Text (String)</td><td>Name of the player you want to give the chest</td></tr></tbody></table>

[⛽](https://emojipedia.org/fuel-pump) |  Fuel Item Type

&#x20;/topminion items fuel set \<tier> \<percentage> \<fuelActions> \[\<CustomModelData>]&#x20;

<table><thead><tr><th width="148">Parameter</th><th width="90">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>Tier</td><td>Number (Integer)</td><td>Each type of fuel has its tier level so that it can be used on the minion. (Unlimited tier levels)</td></tr><tr><td>Percentage</td><td>Number (Integer)</td><td>It is the percentage of time that will reduce fuel consumption.</td></tr><tr><td>Fuel Actions</td><td>Number (Integer)</td><td>It is the number of actions the minion will do before running out of fuel.</td></tr><tr><td>Custom Model Data <strong>(Optional)</strong></td><td>Number (Integer)</td><td>You can establish a custom model data to be able to make custom fuel.</td></tr></tbody></table>

&#x20;/topminion items fuel give \<fuelName> \[\<player>]

<table><thead><tr><th width="148">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Fuel Name</td><td>Text (String)</td><td>This is done by fuel + the tier for example if you created a fuel with the tier 2 the fuel name would be: fuel2</td></tr><tr><td>Player <strong>(Optional)</strong></td><td>Text (String)</td><td>Name of the player you want to give the fuel</td></tr></tbody></table>

🔥 | Smelter Item Type

&#x20;/topminion items smelter set \<smelterActions> \[\<CustomModelData>]

<table><thead><tr><th width="151">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Smelter Actions</td><td>Number (Integer)</td><td>It is the number of actions the minion will do before running out of autosell.</td></tr><tr><td>Custom Model Data <strong>(Optional)</strong></td><td>Number (Integer)</td><td>You can establish a custom model data to be able to make custom smelter.</td></tr></tbody></table>

&#x20;/topminion items smelter give \[\<player>]

<table><thead><tr><th width="148">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td><p>Player</p><p><strong>(Optional)</strong></p></td><td>Text (String)</td><td>Name of the player you want to give the smelter</td></tr></tbody></table>

💰 | Autosell Item Type

&#x20;/topminion items autosell set \<autosellActions> \[\<CustomModelData>]

<table><thead><tr><th width="148">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td>Autosell Actions</td><td>Number (Integer)</td><td>It is the number of actions the minion will do before running out of autosell.</td></tr><tr><td>Custom Model Data <strong>(Optional)</strong></td><td>Number (Integer)</td><td>You can establish a custom model data to be able to make custom smelter.</td></tr></tbody></table>

&#x20;/topminion items autosell give \[\<player>]

<table><thead><tr><th width="148">Parameter</th><th width="90">Data type</th><th>Description</th></tr></thead><tbody><tr><td><p>Player</p><p><strong>(Optional)</strong></p></td><td>Text (String)</td><td>Name of the player you want to give the autosell</td></tr></tbody></table>

### */topminion reload* usage

It has no parameters so using it will reload all the configuration files


---

# 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://docs.sarry20.com/products/minions/commands-and-permissions.md?ask=<question>
```

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.
