# Command Scheduling

The Scheduler is a system that allows you to schedule commands to be run at certain times automatically. It can only be used via the GPORTAL | NITRADO console.

{% hint style="danger" %}
The following commands cannot be scheduled:&#x20;

* entity.spawn
* inventory.givedrop
* spawnitem
  {% endhint %}

### Setup

To create a Scheduler action, you must start the command with \
`CreateAction ConVarSchedulerAction`&#x20;

Then, there are several arguments you can adjust:

`StartTime EndTime RepeatTime RepeatAmount Command CommandParams`

> **📟**
>
> ### *CreateAction ConvarSchedulerAction `[0] [1] [2] [3] [4] [5]`*
>
> This command creates a scheduled action with the following parameters:

<table data-full-width="false"><thead><tr><th width="68.77783203125">#</th><th width="165.6666259765625">Argument</th><th width="304.2222900390625">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>[0]</code></td><td>StartTime</td><td>When this command can run from</td><td><code>"01/11/2024 10:30:00"</code></td></tr><tr><td><code>[1]</code></td><td>EndTime</td><td>When this command will stop running</td><td><code>"08/11/2024 10:30:00"</code></td></tr><tr><td><code>[2]</code></td><td>RepeatTime</td><td>The time interval between each time this command runs</td><td><code>"01:00:00"</code></td></tr><tr><td><code>[3]</code></td><td>RepeatAmount</td><td>How many times this command will run</td><td><code>24</code></td></tr><tr><td><code>[4]</code></td><td>Command</td><td>The command you want to run</td><td><code>say</code></td></tr><tr><td><code>[5]</code></td><td>CommandParams</td><td>The parameters for your chosen command</td><td><code>"Join our discord!"</code></td></tr></tbody></table>

{% hint style="warning" %}
Please note, all times used in The Scheduler commands are in UTC with date format DD/MM/YYYY and time format HH:MM:SS.
{% endhint %}

{% hint style="info" %}
If you make the command repeat, the end time will automatically adjust to when the command will be done repeating
{% endhint %}

#### Example

> ### **📟**
>
> ### CreateAction ConVarSchedulerAction "01/11/2024 10:30:00" "15/06/2025 19:55:00" "00:01:00" 10 say "Welcome"
>
> This will run the "say" command every minute (which will put the text "Welcome" in the game chat), 10 times, starting at 10:30 UTC on November 1st 2024.

### listactions

The `listactions`command will return all created Scheduler actions with their IDs

<figure><img src="https://3429851128-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F989RjbRw8ybjBIxJvMra%2Fuploads%2FnN0SE95lE6zS0rq1ousU%2Fimage.png?alt=media&#x26;token=c2837a5f-82bb-4cf8-9680-274d7b6a0ccf" alt=""><figcaption></figcaption></figure>

### removeaction

The `removeaction` command will delete the action whose ID you input

#### Example

> ### **📟**
>
> ### removeaction 3
>
> This will delete the action with the ID 3


---

# 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://rust-console-edition.gitbook.io/community-servers/feature-guides/command-scheduling.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.
