Commands and permissions
Player commands #
| Command | What it does |
|---|---|
/referral | Opens the personal referral hub. |
/referral <code or friend's name> | Gives the source or inviter. Alias: /referred. |
/referral code | Shows your permanent invite code. |
/referral stats | Shows your own invite results. |
/referral top | Shows the ranking for the configured period. |
/referral inventory | Always opens the standalone inventory menu, even when the hub would open as a dialog. |
Staff commands #
/referraltrack (alias /rtrack) accepts: dashboard, install, theme, reload, doctor, validate, analytics, growth, campaign, review, rescue, discord, lookup, remove and export. /referralstats (alias /refstats) opens the stats menu.
| Command | What it does |
|---|---|
/referraltrack dashboard | Opens the staff dashboard. |
/referraltrack install <preset> [confirm] | Previews a preset; applies it with confirm. See Presets and themes. |
/referraltrack theme <theme> [confirm] | Previews a theme; applies it with confirm. |
/referraltrack reload | Reloads configuration and language files. Database settings need a restart; the reload tells you when. |
/referraltrack doctor | Health report for the database, rewards and integrations. |
/referraltrack validate | Read-only configuration check. Reports paths and expectations, never secret values. |
/referraltrack analytics [1-365 days] | Referral analytics. |
/referraltrack growth [1-100] | Quality ranking of sources (VeloGrowth). |
/referraltrack campaign <list|inspect|preflight|create|enable|disable|clone|engine|archive|archived> | Campaign administration. See Campaigns. |
/referraltrack review <list [page]|show <player>|approve|reject|revoke|rollback <player> confirm <reason>> | Fraud-review queue and decisions. See Fraud review. |
/referraltrack rescue [list|retry <id> confirm <reason>|cancel <id> confirm <reason>] | Reward Rescue. |
/referraltrack discord preview <join|claim|validated|milestone|snapshot|daily|weekly> | Previews a Discord card. |
/referraltrack lookup <player> | Shows a player's referral record. |
/referraltrack remove <player> | Removes a referral record. |
/referraltrack export [csv|json] [campaign|source <id>] | Exports referral data. |
Permissions #
ReferralTrack uses plain Bukkit permission nodes, so LuckPerms and similar plugins work without a hard dependency. referraltrack.admin is the parent of every administrative node.
| Permission | Access |
|---|---|
referraltrack.use | Player /referral commands. Granted by default. |
referraltrack.admin | Every administrative area and /referralstats. Operators by default. |
referraltrack.admin.stats | /referralstats. |
referraltrack.admin.dashboard | Staff dashboard. |
referraltrack.admin.install | Preset preview and install. |
referraltrack.admin.theme | Theme preview and install. |
referraltrack.admin.reload | Configuration reload. |
referraltrack.admin.doctor | Health report. |
referraltrack.admin.validate | Configuration validation. |
referraltrack.admin.analytics | Analytics. |
referraltrack.admin.growth | Growth rankings. |
referraltrack.admin.campaign | Campaign inspection and management. |
referraltrack.admin.review | Fraud-review queue and decisions. |
referraltrack.admin.rescue | Reward Rescue operations. |
referraltrack.admin.discord | Webhook snapshots and previews. |
referraltrack.admin.lookup | Player referral lookup. |
referraltrack.admin.remove | Referral removal. |
referraltrack.admin.export | CSV and JSON export. |
referraltrack.ignore | Excludes the player from all tracking and stats. For bot and test accounts. |
The Reward Rescue node can be replaced with reward-rescue.permission in config.yml; referraltrack.admin always keeps access.
/lp group analyst permission set referraltrack.admin.stats true
/lp group analyst permission set referraltrack.admin.dashboard true
/lp group analyst permission set referraltrack.admin.analytics true
/lp group analyst permission set referraltrack.admin.growth true