# /setup

First-time setup command for assigning channels and roles for the bot to use in RSVPs and posts within the server. It can also be used to update the current setup if one exists already.

{% hint style="danger" %}

### **Running this command while one or more events are scheduled will delete said events**

Please wait for said events to be posted or manually post them before attempting to edit the server's setup.
{% endhint %}

***

## Command Options

\*required option

### staff-channel\*

* **Description:** The channel where the bot will send messages regarding events and ask to upload the posters.

{% hint style="info" %}

## Option Recommandations

This channel is recommended to be private and accessible only to staff members as the bot will include event details that may not have been announced yet or sensitive event data.
{% endhint %}

***

### staff-role\*

* **Description:** The role that will be used to tag staff members.

***

### rsvp-channel\*

* **Description:** The channel where the bot will send event applications (RSVPs).

{% hint style="info" %}

### Option Recommandations

It is recommended that this channel be private and accessible only to all DJ roles.
{% endhint %}

***

### dj-role-1\*

* **Description:** The first role for DJs.

***

### events-channel

* **Description:** The channel where the bot will post and announce the events.

{% hint style="warning" %}

### Option Requirements

This option requires [events-role](#events-role) to be included. If either one is missing, the bot won't post events.
{% endhint %}

***

### events-role

* **Description:** The role the bot will tag when posting events.

{% hint style="warning" %}

### Option Requirements

This option requires [events-channel](#events-channel) to be included. If either one is missing, the bot won't post events.
{% endhint %}

***

### dj-role-2

* **Description:** The second role for DJs.

***

### dj-role-3

* **Description:** The third role for DJs.

{% hint style="warning" %}

### Option Requirements

This option requires [dj-role-2](#dj-role-2) to be included.
{% endhint %}

***

### promotion-1

* **Description:** The number of times a DJ must have played to be promoted from the first DJ Role to the second.

{% hint style="warning" %}

### Option Requirements

This option requires [dj-role-2](#dj-role-2) to be provided.
{% endhint %}

***

### promotion-2

* **Description:** The number of times a DJ must have played to be promoted from the second DJ Role to the third.

{% hint style="warning" %}

### Option Requirements

This option requires both [dj-role-2](#dj-role-2) and [dj-role-3](#dj-role-3) to be provided.
{% endhint %}

***

### [slot-assignment-type](/functionalities/slot-assignment-types.md#types-of-slot-assignments)

* **Description:** The default type of slot assignment system for each event. 
* **Options:**\
  \- algorithm-based\
  \- first-come-first-served\
  \- hand-pick
* **Default:** Algorithm-based

***

### vrc-group-link

* **Description:** The default VRC community group link.

{% hint style="warning" %}

### Link Format

The VRC community group link must have the following format:\
`https://vrchat.com/home/group/grp_...` and must be 70 characters long.
{% endhint %}

***

### slot-opening-interval

* **Description:** The number of days the slots open before each event.
* **Maximum Value:** 30
* **Minimum Value:** 2
* **Default:** 10

***

### slot-open-duration

* **Description:** The number of days the slots remain open.
* **Maximum Value:** 29
* **Minimum Value:** 1
* **Default:** 5

{% hint style="warning" %}

## Option Requirements

This value must be smaller than [slot-opening-interval](#slot-open-duration).
{% endhint %}

***

### event-announcement-interval

* **Description:** The number of days the event will be announced before its date.
* **Maximum Value:** 29
* **Minimum Value:** 1
* **Default:** 3

{% hint style="warning" %}

## Option Requirements

This value must be smaller than the difference between [slot-opening-interval](#slot-opening-interval) and [slot-open-duration](#slot-open-duration).

**Event Announcement Interval** < ( **Slot Opening Interval** - **Slot Open Duration** )
{% endhint %}

***

### logging-channel

* **Description:** The channel where the bot will log each interaction.


---

# 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/setup.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.