VERTEX 1.0 documentation

Run VERTEX without guessing.

This guide explains what to configure first, where daily work happens, and which tool to use when something needs attention. Start small, verify each system, then add the features your server needs.

Bot Online operations Dashboard Version 1.0 Storage Server-scoped SQLite Audio Lavalink
Choose the right surface

Discord for the moment. Dashboard for the workspace.

Both surfaces operate on the same VERTEX systems and the same selected server data.

Inside Discord

Use slash commands for immediate actions.

Moderate a member, play music, open a setup flow, inspect status, or configure a feature while you are already in the server.

  • Fast staff actions
  • Member-facing commands
  • Voice and channel context

On the web

Use Dashboard for focused operational work.

Review state, change configuration, work through tickets, manage giveaways, and inspect live bot or Lavalink health.

  • One active server workspace
  • History and guarded actions
  • Live operational visibility
Read dashboard guide
One source of truth. Dashboard does not create a second configuration database. It uses the live bot data for the selected server.
First deployment

A setup order that avoids rework.

Do these steps in order. Role hierarchy and channel permissions are easier to solve before members start using the systems.

  1. Invite VERTEX

    Use the official invite and choose a server where you can manage bots.

  2. Place the VERTEX role correctly

    Move it above every member role it must assign, remove, moderate, or verify.

  3. Run /setup

    Review the readiness report. It identifies missing core systems and points to the commands that configure them; it does not change settings itself.

  4. Configure protection

    Enable logs, AutoMod, anti-raid, and verification before community extras.

  5. Add support and community systems

    Create ticket panels, welcome messages, reaction roles, giveaways, levels, and creator alerts as needed.

  6. Verify the stack

    Run /status, /health status, and /ping. Test one real workflow before opening it to everyone.

  7. Open Dashboard

    Sign in with an approved Discord account and confirm the correct server appears as the active workspace.

Do not grant permissions blindly. VERTEX can work with granular Discord permissions. Start with what your enabled systems require.
Discord access

Permissions and role hierarchy.

A permission allows an action. Role hierarchy decides whether Discord will actually let that action succeed.

PermissionUsed by
Manage ServerRequired from the human operator for setup, configuration, insights, and dashboard server access.
Manage RolesVerification, reaction roles, level rewards, and automated role assignment.
Manage ChannelsTickets, lockdowns, channel configuration, and permission updates.
Manage MessagesClear, AutoMod cleanup, and moderation workflows.
Moderate MembersTimeouts and automatic punishment escalation.
Kick / Ban MembersManual moderation and configured AutoMod or anti-raid responses.
View Audit LogExecutor detection, security events, and server structure logs.
Send Messages / Embed Links / Attach FilesPanels, logs, transcripts, alerts, and rich command responses.
Connect / SpeakMusic playback through Lavalink.
Most common failure: VERTEX cannot manage a role or member positioned above its own Discord role, even when the permission is enabled.
Dashboard 1.0

A live workspace for authorized operators.

Open dashboard.botvertex.pro, sign in with Discord, and select a server you own or can manage.

Overview

Bot, database, Lavalink, service readiness, recent activity, and a full /serverinfo profile.

Welcome

Design the welcome message and preview, then review the latest five deliveries with member context.

Verify

Configure panel and DM copy, CAPTCHA routing, verified roles, logs, and recent verification activity.

Leveling

Set the level-up message and channel, then add reward roles for specific levels.

Twitch

Monitor multiple creators with routing, resolver status, and a custom message per creator.

YouTube

Monitor multiple channels with routing, resolver status, and a custom message per channel.

Tickets

Review, claim, reply, close, reopen, delete, and download transcripts.

Moderation

Warnings, timeouts, kicks, bans, unbans, logs, health monitoring, history, and snapshot recovery.

Giveaways

Create in a real Discord channel, monitor, end, and reroll winners.

AutoMod

Edit core rules, escalation, anti-raid settings, presets, and history.

Music

See Lavalink readiness, current playback, queue, loop, volume, voice channel, and runtime statistics.

Global search

Jump between modules, servers, and operational records without hunting through menus.

Access and safety

  • Discord OAuth protects the operator session.
  • Only manageable servers are available to the signed-in account.
  • Sensitive operations use a second confirmation.
  • Tokens, database paths, and VPS details stay hidden from the interface.
  • Bot and Lavalink telemetry use private VPS endpoints.
Music in 1.0: Dashboard provides live visibility. Playback commands remain in Discord unless a control is explicitly shown in the web panel.

Read the full dashboard guide

Daily staff work

Moderation that leaves a readable trail.

Use reasons consistently. The next staff member should understand what happened without reconstructing the conversation.

/warnAdd a persistent warning and moderation record.
/unwarnDeactivate an active warning by ID.
/warnsReview a member's active warnings.
/historySee a member's moderation history.
/caseOpen a specific moderation case.
/timeoutTemporarily restrict communication.
/kickRemove a member from the server.
/banBan a member with a recorded reason.
/clearRemove a controlled number of channel messages.
/lock / /unlockClose or restore channel messaging.
/slowmodeSet channel message rate limits.
Dashboard option: warnings, timeouts, kicks, bans, unbans, and warning removal are also available from the selected server workspace.

Read the full moderation guide

Protection

Layer rules instead of making one filter do everything.

Start with logging and mild enforcement. Add escalation only after watching how real members behave.

Content controls

Anti-links, anti-invites, caps filtering, blocked words, and configurable ignored roles or channels.

Spam controls

Message limits and time windows tuned to the pace of the server.

Escalation

Automatic warnings with configurable timeout, kick, and ban thresholds.

Anti-raid

Join and audit-action thresholds, lockdown, emergency verification, owner alerts, and dangerous permission detection.

/automod statusReview the current configuration.
/automod wordsAdd, remove, list, clear, enable, or disable blocked words.
/automod spamSet anti-spam limits.
/automod punishmentSet automatic escalation thresholds.
/automod antiraidEnable integrated anti-raid protection.
/automod antiraid_unlockRelease lockdown and restore emergency verification state.

Read the full AutoMod guide

Support workflow

Give every request an owner and an ending.

Ticket panels create private channels. Staff can claim work, reply, preserve transcripts, close cleanly, and reopen when necessary.

Member opensStaff claimsConversationTranscriptClose

Discord

Build and run the member flow.

Use /ticket to configure panels and work with ticket controls in the server.

Dashboard

Work through the support queue.

Claim, reply, close, reopen, delete, and download transcripts from one server-scoped view.

Before launch: test category permissions, staff visibility, transcript delivery, and the close/delete policy with a real ticket.

Read the full tickets guide

Member experience

Enable only the systems your community will use.

Verification

Captcha-based access with role assignment, expiry, logging, session reset, and emergency anti-raid integration.

/verification

Welcome

Custom welcome channel, message, image, member count, optional role, preview, and test flow.

/welcome

Reaction roles

Create panels or connect emoji-to-role assignments to existing messages, with add/remove behavior.

/reactionrole

Giveaways

Create timed giveaways, choose winner count, track participants, end early, and reroll.

/giveaway
Dashboard option: Giveaways can be created, ended, and rerolled from the web using real Discord channel selectors.

Read the full verification guide

Engagement

Reward activity without turning the server into noise.

Levels

Member profiles, leaderboard, role rewards, level-up channel, resets, and staff adjustments.

/level

Karma

Member reputation, leaderboard, controlled staff adjustments, role rewards, and configuration.

/karma

Twitch

Live notifications with channel, optional mention role, custom message, status, and manual check.

/twitch

YouTube

Upload notifications with channel, optional mention role, custom message, status, and manual check.

/youtube
Voice

A complete queue built on Lavalink.

Join a voice channel, run /music play, and use the same command group for queue control.

playskipstoppauseresumedisconnectclearshuffleremovequeuenowplayingvolumeloopstatusconfig
  • Users must be in a voice channel for playback actions.
  • VERTEX needs Connect and Speak in the target channel.
  • Music command channels and blocked voice channels can be configured.
  • Dashboard shows live player and Lavalink state but does not replace every Discord playback command in 1.0.

Read the full music guide

Visibility

Keep enough context to make better decisions.

Advanced logs

Moderation, messages, members, voice activity, server structure, roles, channels, and configured system events.

/logs

Server insights

Activity, joins, leaves, staff actions, support load, and operational trends collected per server.

/insights

Identity tools

Quick server and member context for staff and support work.

/serverinfo /userinfo
Empty insights are not always broken. A new server needs real activity before useful trends exist.
Reliability

Know whether VERTEX is ready before users report a problem.

/pingDiscord latency, bot response, memory, SQLite, and Lavalink signals.
/statusCurrent service, manager, database, and runtime overview.
/healthOwner health checks, alert channel, memory threshold, and service alerts.
/backupOwner-only manual backup, status, and recent backup list.
Owner scope: health administration and database backups are deliberately restricted. They are infrastructure controls, not everyday staff commands.
Reference

Every top-level command in the current bot.

Type a command in Discord to see its current subcommands and required options.

Configuration

/automod /backup /health /logs /reactionrole /setup /status /twitch /verification /welcome /youtube

Moderation

/ban /case /clear /history /kick /lock /slowmode /timeout /unlock /unwarn /warn /warns

Music

/music

Platform and community

/about /giveaway /guide /help /insights /invite /karma /level /ping /serverinfo /support /ticket /userinfo

Common questions

Fast answers for setup and daily operations.

These are the checks staff usually need before opening a support request.

Why does a VERTEX slash command not appear?

Confirm commands were deployed and the bot was invited with the applications.commands scope.

Why cannot VERTEX assign a Discord role?

Move the VERTEX role above the target role and confirm Manage Roles is enabled.

Why does the dashboard not list a server?

Use an approved Discord account and confirm that account owns the server or has Manage Server.

Why is music not connecting?

Confirm the user is in voice, the bot can Connect/Speak, Lavalink reports ready, and the channel is not blocked.

When something fails

Check the smallest dependency first.

A slash command does not appear

Confirm commands were deployed and the bot was invited with the applications.commands scope.

VERTEX cannot assign a role

Move the VERTEX role above the target role and confirm Manage Roles is enabled.

A moderation action fails

Check the staff member, target member, bot role hierarchy, and the exact Moderate/Kick/Ban permission required.

Ticket channels are not created

Check Manage Channels, category permission overwrites, staff roles, and the configured ticket category.

Transcripts do not arrive

Check Attach Files, Send Messages, Embed Links, and the transcript or ticket log channel.

Music does not connect

Confirm the user is in voice, the bot can Connect/Speak, Lavalink reports ready, and the channel is not blocked.

AutoMod is too strict

Reduce thresholds and add intentional ignored roles or channels. Avoid disabling every layer at once.

Dashboard does not list a server

Use an approved Discord account and confirm that account owns the server or has Manage Server.

Dashboard data or selectors are empty

Confirm VERTEX is in the selected server, your account can manage it, and the relevant channels or roles still exist. Re-authenticate after permission changes; if the problem remains, share the affected module and approximate time in the official support server.

Dashboard shows music service waiting

Run /music status and /ping. If the service remains unavailable, no server setting can repair the managed audio service; report the time and server in official support.

Keep it healthy

Simple habits make the platform easier to trust.

Configure protection before promotion.

Logs, AutoMod, verification, and backups should exist before a growth push.

Use dedicated channels.

Separate logs, tickets, health, welcome, giveaways, and creator notifications.

Write reasons for future staff.

A good moderation trail is understandable days later, not only in the moment.

Test with real workflows.

Open a ticket, verify a test member, create a giveaway, and join voice before launch.

Review status after every deployment.

Check bot, SQLite, managers, Lavalink, dashboard, and one Discord-backed selector.

Enable less, then expand.

A smaller configuration your team understands is better than every feature turned on.

Current product boundary: VERTEX does not currently provide a goodbye-message system, general-purpose embed builder, polls, suggestions, or voice management outside music. Do not look for undocumented commands for these features.
Need the product?Invite VERTEX or continue in Dashboard.