Documentation

Your guide to using Sentinel in your Discord server.

Getting StartedAdd the bot and get going Add to Your ServerStep-by-step setup guide CommandsFull command reference Roles & PermissionsWho can do what FAQFrequently asked questions

Getting Started

Sentinel is a hosted Discord bot for monitoring Dune Awakening game servers. No installation or setup required — just invite the bot and configure your server through the web portal.

1. Add Sentinel to Your Server

Click Add to Discord and authorize the bot for your server. You need the "Manage Server" permission to add bots.

2. Configure Your Server

Open the Setup Portal Guide to connect your Discord server to Sentinel. Everything is configured through the browser — no .env file editing required. You'll need your Console URL and Adapter Token ready.

3. Link Your Character

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.

4. Start Using Commands

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 Sentinel role.

Commands

All commands are accessed via /dune. What you see depends on your assigned role.

Sietch Watch — Server Health

CommandDescriptionRole
/dune server healthCheck the Discord adapterObserver
/dune server statusDashboard card with server status, players, mapsObserver
/dune server summaryCompact text summary of server statusObserver
/dune server readinessReadiness and preflight checksObserver
/dune server servicesList all game services and their stateObserver

The Personal Ledger — Player Tools

CommandDescriptionRole
/dune player link <name>Link Discord to your in-game characterObserver
/dune player unlinkRemove the character linkObserver
/dune player meShow your linked character infoObserver
/dune player inventoryView your character's inventoryObserver
/dune player storageView items in your storage containersObserver
/dune player find <item>Search for an item across all storageObserver
/dune player faction <name>Set your faction for themed embedsObserver

Deep Desert Intel — Operations

CommandDescriptionRole
/dune ops activityPlayer activity statisticsObserver
/dune ops combatCombat and death statisticsObserver
/dune ops resourcesResource field data (spice, water, minerals)Observer
/dune ops economyCurrency, trading, and tax dataObserver
/dune ops dashboardAggregated operational summaryObserver

The Archives — Data

CommandDescriptionRole
/dune data populationAggregate player countObserver
/dune data backupsList recent backup metadataObserver
/dune data mapsShow active game maps with stateObserver
/dune data maintenanceMaintenance window metadataObserver

Kanly Council — Admin

CommandDescriptionRole
/dune admin doctorFull system diagnostic across all servicesAdmin
/dune admin cooldownsShow active command cooldownsAdmin
/dune admin latencyAdapter request latency historyAdmin
/dune admin eventsRecent server incidents and alertsAdmin
/dune admin broadcast <msg>Send a message to all in-game playersModerator+

Foundation Stones — Infrastructure

CommandDescriptionRole
/dune infra versionShow Dune stack versionObserver
/dune infra serversList game server partitionsObserver
/dune infra portsShow network port and listener statusObserver
/dune infra dbDatabase status and healthObserver

Sentinel Core

CommandDescriptionRole
/dune core aboutBot version, security info, connection detailsObserver
/dune core pingTest Discord and adapter latencyObserver
/dune core helpList all commands you have permission to useObserver

Roles & Permissions

Sentinel uses Discord roles to control access. Your server admin assigns you a role, and that role determines which commands you can use.

RoleAccess
ObserverRead-only commands — server status, player info, operations data, infrastructure checks
ModeratorEverything Observer can do, plus /dune admin broadcast to send messages to in-game players
AdminEverything above, plus diagnostics — doctor, cooldowns, latency, events

How to Get a Role

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.

How Roles Work Under the Hood

Sentinel 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.

FAQ

Why don't I see any /dune commands?

You likely don't have a Sentinel role 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.

How do I link my character?

Run /dune player link <your-character-name>. The name must match your in-game character exactly. After linking, you can use /dune player me, /dune player inventory, and other personal commands.

Is the bot read-only?

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.

Is my data safe?

Sentinel 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.

Can I self-host my own instance?

Sentinel 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.