# /create-event

Creates and schedules a new event.

{% hint style="warning" %}

### Keep in Mind

A maximum of 3 active events can be created at a time.
{% endhint %}

***

## Command Options

\*required option

### name\*

* **Description:** The name of the event.
* **Maximum Length:** 64 characters.

***

### date-timestamp\*

* **Description:** The timestamp of the event.

{% hint style="warning" %}

### Option Requirements

You must use the plain code format, such as: `1734720120` (without the " < , :d, :t , > , etc " characters).  You can use tools such as [HammerTime](https://hammertime.cyou/en) to generate timestamps. The maximum allowed interval until the event date is one month.
{% endhint %}

***

### slots-amount\*

* **Description:** The number of slots, including intermissions, but NOT counting open decks.
* **Maximum Value:** 99

{% hint style="warning" %}

### Option Limitations

Due to Discord's character limitations, the bot will not be posting the event if it exceeds 18 slots.
{% endhint %}

***

### slots-duration\*

* **Description:** The duration of each individual slot in minutes.
* **Maximum Value:** 240

***

### location

* **Description:** The location of the event.
* **Maximum Length:** 64 characters.
* **Default:** "TBD"

***

### djs-type

* **Description:** The type(s) of DJ allowed to RSVP to this event.
* **Options:**\
  \- all-djs\
  \- dj-role-1\
  \- dj-role-2\
  \- dj-role-3\
  \- dj-role-1-2\
  \- dj-role-2-3\
  \- dj-role-1-3
* **Default:** all-djs

***

### description

* **Description:** The description of the event.
* **Maximum Length:** 256 characters.

***

### genres

* **Description:** The genre(s) of the event.
* **Maximum Length:** 128 characters.

***

### host

* **Description:** The host of the event.

***

### doors-open

* **Description:** The number of minutes the doors open before the event's date.
* **Default:** 0

***

### open-decks

* **Description:** Is there an open decks section after the event?
* **Default:** false

***

### post-event

* **Description:** Should the bot also post/announce the event?
* **Default:** true

{% hint style="warning" %}

## Option Requirements

This option will default to true only if an [events-role](/functionalities/commands/server-commands/setup.md#events-role) and [events-channel](/functionalities/commands/server-commands/setup.md#events-channel) were included in the setup of the server. Otherwise, it will automatically be set to false.
{% endhint %}

***

### rsvp-limit

* **Description:** The maximum amount of slots a DJ can RSVP to.
* **Default:** no limit

{% hint style="warning" %}

### Option Requirements

This option cannot exceed the [slots-amount](#slots-amount) of the event. It also cannot be used with the "First Come First Served" [slot assignment type](#slot-assignment-type).
{% endhint %}

***

### include-group-link

* **Description:** Whether to include the group link in the "Join via" field.
* **Default:** true

{% hint style="info" %}
This option will default to true **ONLY** if a VRC community group link was included in the setup, or provided in event-group-link command option.
{% endhint %}

***

### slot-assignment-type

* **Description:** The type of slot assignment system for this event. Will override the current setup.
* **Options:**\
  \- algorithm-based\
  \- first-come-first-served\
  \- hand-pick

***

### group-link

* **Description:** The VRC group link to include. Will override the setup.

***

### slot-opening-timestamp

* **Description:** The timestamp date the slots open. Will override the setup intervals.

***

### slot-closure-timestamp

* **Description:** The timestamp date the slots close. Will override the setup intervals.

***

### announcement-timestamp

* **Description:** The timestamp date the event will be announced. Will override the setup intervals.


---

# 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.vrave.app/functionalities/commands/server-commands/create-event.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.
