Your guide to using Sahir Venn in your Discord server.
Sahir Venn is a hosted Discord bot for monitoring Dune Awakening game servers — no Discord application to create, no bot process to run yourself. You will need SSH access to the machine running your Dune console for one step below.
Click Add to Discord and authorize the bot for your server. You need the "Manage Server" permission to add bots.
Open the Setup Portal Guide to connect your Discord server to Sahir Venn. Most of it is configured through the browser, but one step requires SSH access to your Dune console: enabling the Discord adapter and generating its token involves editing your console's .env file and restarting its container (the portal walks you through the exact commands). You'll need your Console URL and Adapter Token ready.
Run /dune player link <your-character-name> to connect your Discord account to your in-game character. This unlocks player-specific commands like inventory and storage lookups.
Type /dune in any channel and Discord will show you the commands you have access to. If you don't see any commands, ask a server admin to assign you a role for Sahir Venn.
All commands are accessed via /dune. What you see depends on your assigned role.
| Command | Description | Role |
|---|---|---|
/dune server health | Check the Discord adapter | Player |
/dune server status | Dashboard card with server status, players, maps | Player |
/dune server summary | Compact text summary of server status | Player |
/dune server readiness | Readiness and preflight checks | Player |
/dune server readiness-detail | Grouped readiness detail with issues | Player |
/dune server services | Show service container state | Player |
/dune server services-detail | Detailed service state with logs | Player |
/dune server maintenance | Show current maintenance note or window (read-only) | Player |
| Command | Description | Role |
|---|---|---|
/dune player link <name> | Link your Discord to your game character | Player |
/dune player verify <code> | Verify a pending character link with a code | Player |
/dune player characters | List your verified characters | Player |
/dune player enable <character> | Enable a character in this guild | Player |
/dune player disable <character> | Disable a character in this guild | Player |
/dune player default <character> | Set your default character for this guild | Player |
/dune player unlink <character> | Unlink a character from your Discord | Player |
/dune player whoami | Show your linked game character info | Player |
/dune player faction | Show your real, in-game faction | Player |
/dune player inventory | View your personal inventory | Player |
/dune player storage | View your storage containers grouped by map | Player |
/dune player find <item> | Search for items across your containers | Player |
| Command | Description | Role |
|---|---|---|
/dune ops activity | Player activity statistics (online counts, sessions, per-guild, per-map) | Player |
/dune ops combat | Combat and death statistics (PvP/PvE, deaths by cause, K/D) | Player |
/dune ops resources | Resource field data (spice, water, minerals, solar, organic) | Player |
/dune ops economy | Currency, trading, and tax data | Player |
/dune ops armory | Server-wide aggregate inventory/crafting stats (not personal — see /dune player inventory) | Player |
/dune ops location | Map location activity (markers, density, territories) | Player |
/dune ops soc | OPS bridge health and request statistics | Player |
/dune ops prometheus | Container and infrastructure metrics (CPU, memory, restarts) | Player |
/dune ops dashboard | Aggregated operational summary | Player |
/dune ops announcements | Recent server and game announcements | Player |
/dune ops alerts | Currently firing Prometheus/Alertmanager alerts | Player |
| Command | Description | Role |
|---|---|---|
/dune data population | Aggregate player count | Player |
/dune data backups | List recent backup metadata | Player |
/dune data maps | Show active game maps with state | Player |
| Command | Description | Role |
|---|---|---|
/dune logs dune-cache | Show dune-cache container logs | Player |
/dune logs dune-generated | Show dune-generated container logs | Player |
/dune logs dune-server | Show dune-server container logs | Player |
/dune logs dune-steam | Show dune-steam container logs | Player |
/dune logs dune-work | Show dune-work container logs | Player |
/dune logs orchestrator | Show orchestrator container logs | Player |
/dune logs redblink-dune-docker-console | Show console adapter logs | Player |
| Command | Description | Role |
|---|---|---|
/dune admin doctor | Comprehensive system diagnostic across all subsystems | Admin |
/dune admin sync-commands | Check Core's command catalog for drift against the bot's registry | Admin |
/dune admin cooldowns | Show active command cooldowns | Admin |
/dune admin latency | Adapter request latency history | Admin |
/dune admin events | Recent server incidents and events | Admin |
/dune admin roles | Show configured admin/player roles, with current Discord role names | Admin |
/dune admin broadcast <msg> | Send a message to all in-game players | Moderator+ |
| Command | Description | Role |
|---|---|---|
/dune infra version | Show Dune stack version | Player |
/dune infra servers | List game servers | Player |
/dune infra ports | Show network port and listener status | Player |
/dune infra db | Show database status and health | Player |
| Command | Description | Role |
|---|---|---|
/dune core about | Show safe bot and adapter metadata | Player |
/dune core ping | Measure Discord and adapter latency | Player |
/dune core help | Show available commands for your role | Player |
/dune core setup | How to add this bot to your own Discord server | Player |
Sahir Venn uses Discord roles to control access. Your server admin assigns you a role, and that role determines which commands you can use.
| Role | Access |
|---|---|
| Player | Read-only commands — server status, player info, operations data, infrastructure checks |
| Moderator | Everything Player can do, plus /dune admin broadcast to send messages to in-game players |
| Admin | Everything above, plus diagnostics — doctor, sync-commands, cooldowns, latency, events, roles |
| Owner | Everything above, plus the highest-risk write operations (server restarts, updates, cache clears). Not a role you assign — derived automatically from real Discord server ownership, so the server owner can never be locked out of it. |
Ask your server admin to assign you the appropriate role. Roles are configured per-server — having a role in one server doesn't grant access in another. The Owner tier is the one exception: it's tied to real Discord server ownership, not an assignable role.
Sahir Venn checks your Discord role membership before executing any command. If you don't have a recognized role, commands won't appear when you type /dune. This is by design — no unauthorized access, ever.
You likely don't have a role for Sahir Venn assigned yet. Ask a server admin to give you the Player role (or higher). Once assigned, commands should appear within a minute. If not, try logging out and back into Discord.
Run /dune player link <your-character-name>. The name must match your in-game character exactly. After linking, you can use /dune player whoami, /dune player inventory, and other personal commands.
Yes. All commands only read data from your game server — they cannot change anything. The only exception is /dune admin broadcast, which sends messages to in-game players, and it's restricted to Moderator+ roles.
Sahir Venn never accesses the Docker socket, game files, or database directly. All data flows through the console's API layer with bearer-token authentication. The bot cannot execute shell commands on any server.
Sahir Venn is designed so each Dune server operator can run their own instance connected to their own console. Reach out on Discord if you're interested in self-hosting.