Search Documentation

Search for pages and headings in the documentation

/list Command - View Active Objectives

The /list command displays all active objectives reported for your Discord server. All server members can use this command.

/list

Syntax

/list

This command takes no parameters.

Output

The bot responds with a message listing all active (non-expired) objectives, grouped into three categories:

Categories

CategoryIncludes
NodeFiber node, Hide node, Ore node, Wood node
CoreCore
VortexVortex

Entry Format

Each objective entry displays:

  • Index number — used with /remove to delete entries
  • Rarity and type — for nodes, the tier and type name (e.g., 7.4 Ore node); for cores and vortexes, an emoji and color name (e.g., 🟠 Gold)
  • Time — the calculated spawn time in UTC and as a Discord relative timestamp (e.g., “in 2 hours”)
  • Map name
  • Maintenance flag means no maintenance between now and spawn time (safe); means the 10:00 UTC maintenance falls in between (objective may be reset)
  • Reporter — the display name of the Discord user who added the objective

Example Output

## Node ##
- #1 — 7.4 Ore node —— 14:30 UTC (<t:...:R>) —— Murdergulch Ravine
-# Maintenance added: ✅ —— Objective added by PlayerName

## Core ##
- #2 — 🟠 Gold —— 09:15 UTC (<t:...:R>) —— Hightree Enclave
-# Maintenance added: ❌ —— Objective added by PlayerName

The <t:...:R> timestamps are rendered by Discord as live relative countdowns (e.g., “in 2 hours”). The -# lines appear as small subtext in Discord.

objectives
Full /list output showing objectives grouped by Node, Core, and Vortex
Live /list output in Discord

Behavior

Auto-Cleanup

When you run /list, the bot filters out any objectives whose spawn time has already passed. Expired objectives are not displayed.

Additionally, a background task runs every 30 minutes to clean up expired objectives from the database and refresh the displayed message.

Message Refresh

Each time /list is called or the cron task runs, the bot updates the existing message rather than posting a new one, keeping the channel clean.

Cooldown

This command has a 5-second cooldown per user — longer than other commands because it queries the database and updates a message.

  • /add — Report a new objective
  • /remove — Delete an objective by its index number