> For the complete documentation index, see [llms.txt](https://docs.spoof.dev/asteroid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spoof.dev/asteroid/setup/features/scheduler.md).

# Scheduler

Unleash your creativity with a versatile command scheduler. Execute a wide array of commands, each with a customizable probability, infusing your server with dynamic and immersive experiences.

Timing is everything: Determine when fake players execute commands with dynamic time intervals, enhancing the authenticity of your server. Elevating Realism with Smart Behaviors.

```yaml
scheduler:
  time: '{random[10,60]}'
  commands:
    - '{updateRandomItemInMainHand}:80:pa sell {random[100,1000,50]}'
    - '{updateRandomItemInMainHand}:60:pa sell {random[100,1000]}'
```

* Easily put items for sale on the auction house without the need of external plugins

* `time`: Random time for scheduler execution

* `commands`: Scheduler commands with chances and optional random values

| Placeholder                  | Description                                                                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {updateRandomItemInMainHand} | Tells the spoofer that the command that's about to be dispatched needs the player to have an item in hand                                                                 |
| {random\[x,y,z]}             | This generates a random number ranging between **x** and **y**, that is divisible by **z**. If the number isn't divisible by z it will keep generating until it finds one |
| {equipRandomArmor}           | Equips random pieces of armor (between 1-3) from the player's inventory                                                                                                   |
| {equipWholeArmor}            | Overwrites the existing armor with the first pieces of armor found in the player's inventory                                                                              |
| {randomItemInMainHand}       | Re-equips a random item from his inventory in his main hand                                                                                                               |
| {initAIConv}                 | <p>NOTE! This must be used as following: </p><p>":(chance):{initAIConv}"<br>If you are using AI to AI feature, make sure to include this in your scheduler.</p>           |

<table><thead><tr><th>Text features</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>chat!</td><td>NOTE! This must be used as following:<br>"(whatever here):(chance):chat!sup everyone!"<br>Use this before any message inside the scheduler and you will to make the player send a custom message.</td><td></td></tr><tr><td>console-></td><td>NOTE! This must be used as following (only the format, you will be provided an example):<br>"(whatever here):(chance):console->eco give %player% 100%"<br>You can execute console commands using "console->"</td><td></td></tr><tr><td>ANTI-AFK</td><td>To use anti-afk use the following format:<br>":80:console->asteroid extra rotate %player%"<br>It will randomly rotate the player, clearing the afk mode.</td><td></td></tr></tbody></table>