# 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: 

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

### Setup

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

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