StaffHQ
Docs/Setup/Dashboard

Dashboard

A guide to every page in the StaffHQ dashboard, team roles, branding settings, and the free trial.

Dashboard pages

After logging in at dash.staffhq.net, you will see the following pages in the left navigation:

Core

Overview

Per-server status, TPS, memory, player counts, active staff sessions, and a recent activity feed across all connected servers.

Staff

Every detected staff member with their current online or offline state, current session duration, and LuckPerms group.

Punishments

Unified punishment log across all servers. Filter by type (ban, mute, kick, warn), player, or issuing staff member. Issue corrections inline.

Anti-cheat

Real-time flag feed from Grim, Vulcan, Matrix, AAC, Intave, Polar, and Themis. Sort and filter by check name, player, or severity.

Chat Logs

Searchable chat timeline across servers. Filter by server, player, or keyword. Admin role required.

Players

Search any player by username or UUID. Click through to a full profile with join history, playtime, punishments, and linked Discord account.

Investigate

A focused search entry that drops you onto a player's combined profile: punishments, chat history, anti-cheat flags, and session log side by side.

Staff tools

Leaderboard

Rank your team by punishments issued, chat reviewed, and time online over a chosen window. Moderator role and above.

Staff Commands

Searchable log of commands run by staff members. Useful for auditing config changes, op commands, and gamemode toggles.

Appeals

Inbox for punishment appeals submitted by banned or muted players. Approve, reject, or comment. Moderator role and above.

Analytics

Retention

Cumulative Day-1, Day-7, and Day-30 retention curves with a configurable cohort window. See the docs at /docs/analytics/retention.

Events

Stream of custom events your plugins fire (quest completions, shop purchases, level-ups). Filter by event name, player, or time range.

Funnels

Multi-step conversion funnels built on top of events. See where players drop off between join, first purchase, and beyond.

Setup

Discord

Configure your Discord bot: client ID, guild ID, bot token, and optional alert channel. Toggle managed hosting or self-host via the open-source bot repo.

Settings

Manage connected servers, plugin API keys, team members, branding, staff group list, appeals form, and your subscription.

Team members and roles

Invite team members from Settings so your administrators can access the dashboard without sharing your owner credentials. The role names below match what the dashboard uses internally.

super_admin

Full access including subscription and team management. Assigned to the account owner at signup and cannot be granted to invited members.

admin

Access to every page including Chat Logs and Settings. Can manage servers, team members, branding, and Discord config. Cannot change the subscription.

moderator

Access to Staff, Leaderboard, Staff Commands, Punishments, Appeals, Anti-cheat, Players, Investigate, and the Overview. Cannot read Chat Logs or change settings.

viewer

Read-only access to analytics (Retention, Events, Funnels) plus the Overview. Cannot take actions or read sensitive logs.

Note
Dashboard roles are separate from your Minecraft staff groups. A player can be listed as staff in the plugin without having dashboard access, and vice versa.

Staff groups

The Staff panel is populated by players who belong to the groups listed under staff-groups in your plugin config. Each entry maps to a LuckPerms group.

Group changes (promotions and demotions) are recorded when tracking.rank_changes is enabled in config.yml. They appear on each player's profile timeline.

Branding

Open Settings -> Branding to customize how the dashboard looks for you and your team. You can change:

  • +Network name shown in the dashboard title bar and emails
  • +Accent color used for buttons, links, and highlights
  • +Date format used across log pages (DD-MM-YYYY, MM/DD/YYYY, ISO, and others)

Each team member can set their own timezone under Settings -> Profile. Dates and times across the dashboard render in the timezone you pick, independent of the network-wide date format.

Preview features

Settings -> Preview Features lets admins opt into the preview channel to try in-progress features before general availability. Preview features may change, break, or be removed without notice. Leave it off if you need maximum stability.

Data retention

The dashboard keeps historical data (chat logs, sessions, commands, punishment history, anti-cheat flags) for a fixed window so older rows can be purged on a schedule. Pro plans include 90 days of retention. Custom plans negotiate retention separately.

Need to look further back? Extend retention from Settings -> Data retention. Each extension adds 30 days for £1.00/mo and is billed alongside your subscription. You can stack up to 12 extensions, which gives a maximum retention window of 450 days (~15 months).

Tip
Buying extensions during checkout, or later from the dashboard, takes effect immediately on the next webhook event from McSets. Lowering retention only affects future purges; data that has already been deleted cannot be brought back.

Free trial

Every new account starts on a 7-day free trial of the Pro plan. No payment information is required to start. When the trial ends, activate a paid license or top up credits from Settings -> Subscription to keep your servers connected.

Tip
Use the trial to test the Discord bot, anti-cheat integrations, retention curves, and team access before committing to a plan.
← PreviousPluginNext →Discord Bot