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.
Invite VERTEXUse the official invite and choose a server where you can manage bots.
Place the VERTEX role correctlyMove it above every member role it must assign, remove, moderate, or verify.
Run /setupReview the readiness report. It identifies missing core systems and points to the commands that configure them; it does not change settings itself.
Configure protectionEnable logs, AutoMod, anti-raid, and verification before community extras.
Add support and community systemsCreate ticket panels, welcome messages, reaction roles, giveaways, levels, and creator alerts as needed.
Verify the stackRun /status, /health status, and /ping. Test one real workflow before opening it to everyone.
Open DashboardSign 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.
| Permission | Used by |
| Manage Server | Required from the human operator for setup, configuration, insights, and dashboard server access. |
| Manage Roles | Verification, reaction roles, level rewards, and automated role assignment. |
| Manage Channels | Tickets, lockdowns, channel configuration, and permission updates. |
| Manage Messages | Clear, AutoMod cleanup, and moderation workflows. |
| Moderate Members | Timeouts and automatic punishment escalation. |
| Kick / Ban Members | Manual moderation and configured AutoMod or anti-raid responses. |
| View Audit Log | Executor detection, security events, and server structure logs. |
| Send Messages / Embed Links / Attach Files | Panels, logs, transcripts, alerts, and rich command responses. |
| Connect / Speak | Music 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
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.