Documentation — Evamix

Introduction

Evamix is a Discord bot designed to manage availability polls for team matches and training sessions. This guide explains how to use all the bot's features.

For any questions or assistance, feel free to join our Discord server.

Permissions

The bot uses a role-based system to control access to commands:

Team Role: If configured via /config team-role, only members with this role can use basic commands
Manager Role: If configured via /config manager-role, required for management commands
Discord Admin: Discord administrators (ADMINISTRATOR permission) can use /config and /init even without a configured manager role

Note: If no roles are configured, basic commands are accessible to all server members.

Initial Setup

/init Command

The first time you use the bot, use /init to configure the bot via an interactive flow:

Language: Select the server language (English or French)
Team name and tag: Enter your team's full name and short tag
Channels: Select channels for polls and match requests
Rooms: Select available rooms for this server
Roles: Select manager and team roles (optional)

Permission: Discord Admin only

Note: All parameters are configured via interactive menus, no arguments to type.

/config Command

Use /config to modify bot settings:

/config language: Set server language (interactive flow)
/config team-role: Set or remove team role (interactive flow)
/config manager-role: Set or remove manager role (interactive flow)
/config channel-poll: Set the channel where match polls are published (interactive flow)
/config channel-request: Set the channel where match requests are sent (interactive flow)
/config rooms: Configure available rooms (interactive flow)
/config preferences: Configure team slot preferences (interactive flow)
/config profile: Set team name and tag (shown in polls) (interactive flow)
/config view: Display current configuration

Permission: Discord Admin only

Match Management

Create a match

Use /match create to create an availability poll:

Select a practice room
Choose the type (Competition or Training)
Select the match date
Choose the opposing team: the list includes Mix Eva plus teams configured via /init or /config profile that have rooms in common with your team (unless they are on break via /match break). The team's Discord server is automatically used for cross-server sync if the team has one (no server for Mix Eva).
Add time sessions with the "Add session" button
Publish the poll with the "Publish" button

Permission: Manager Role (if configured)

Note: automatic mirroring of the poll on the opponent server is implemented. Votes are synchronized between both servers.

List matches

Use the following commands to view matches (only those tied to this server: created here or where this server is the recorded opponent):

/match next: Lists upcoming matches
/match past: Lists past matches
/match list: Lists all matches

Permission: Team Role or Manager (if configured)

Delete or cancel a match

Use the following commands to manage matches:

/match delete: Permanently removes a match (no notification)
/match abort: Sets the match to cancelled and notifies the team; the record is kept
/match poll: Republishes the poll messages for a match if they were manually deleted in Discord by mistake. The messages (header and sessions) are recreated in the configured poll channel.

Matches, votes, and statuses (planned, completed, cancelled) are stored and persisted on the bot server.

Permission: Manager Role (if configured)

Opponent pool (manager)

Teams are automatically registered in the opponent pool when configured via /init or /config profile. To manage your team's availability:

/match break: Pause — the team is no longer offered as an opponent until /match engage.
/match engage: End the pause — the team is selectable again. If not on pause, you get an error message.

Permission: Manager Role (if configured)

💡 Removing a team from the pool

To completely remove a team from the pool, simply remove the bot from the Discord server. The team will be automatically archived and will no longer be offered as an opponent. Cleanup occurs automatically approximately 1 hour after the bot is removed.

Voting on Polls

Once a poll is published, you can vote on each session:

✅ Registered: You are registered for this session on the EVA.gg platform
🟢 Present: You will be present
🟡 Maybe: You are not sure
❌ Unavailable: You will not be available

Limit: Maximum 4 people per team per session for "Registered" and "Present" (so 8 people total if two teams participate).

Permission: Team Role (if configured)

/team Commands

/team list

Use /team list to list teams that have rooms in common with your team, along with their slot preferences.

This command displays only teams that share at least one room with your server, allowing you to see which teams are available to organize matches with.

Permission: Team Role or Manager (if configured)

/team list-all

Use /team list-all to list all teams registered in the system, along with their slot preferences.

This command displays all teams, even those that do not have rooms in common with your team.

You can use the preferences option to show or hide slot preferences (default: shown).

Permission: Team Role or Manager (if configured)

Notifications

The bot automatically sends notifications:

Response reminders: Daily, if you haven't voted on all sessions of a poll
Match reminders: 24h and 1h before a match if you voted "Present" or "Registered" on at least one session

You can test notifications with /notification test (Manager Role or Discord Admin).

Permissions Summary

Summary table of permissions:

Command	Team Role	Manager Role	Discord Admin
`/match create`	❌	✅ (if configured)	❌
`/match next/past/list`	✅ (if configured)	✅ (if configured)	❌
`/match delete/abort/poll`	❌	✅ (if configured)	❌
`/match break`, `/match engage`	❌	✅ (if configured)	❌
`/config preferences`	❌	✅ (if configured)	❌
`/config *`	❌	❌	✅ (only)
`/init`	❌	❌	✅ (only)
`/notification test`	❌	✅ (if configured)	✅
Voting on polls	✅ (if configured)	❌	❌

Tips and Tricks

Configure roles from the start with /init to secure access
Teams are automatically added when servers configure their team
Use /match list to see all past and upcoming matches
Notifications are sent automatically, no need to trigger them manually

Support

For any questions or issues, you can join our Discord server or contact the administrator of the Discord server where the bot is installed.