Helios Documentation Portal

Troubleshooting

Helios incident playbooks using problem, cause, fix, and prevention.

Overview

Use this page during live incidents. Work top to bottom and record command output in your ops channel.

Bot Is Online but Commands Fail

  • Problem: Slash commands return errors or no useful data.
  • Likely cause: Server connection details are wrong or target server is disabled.
  • Fix: Run /server list, then /cmd send command:"status" on the affected server. Correct values with /server edit.
  • Prevention: Revalidate every server after host migrations or wipe maintenance.

Commands Missing in Discord

  • Problem: Staff cannot see expected Helios commands.
  • Likely cause: Command sync delay or role permission mismatch.
  • Fix: Confirm role permissions, then restart bot command registration workflow if needed.
  • Prevention: Keep command registration steps in your deployment checklist.

Feed Channels Stay Silent

  • Problem: Kill or player feeds do not post to Discord.
  • Likely cause: Missing send/embed permissions or incorrect feed channel mapping.
  • Fix: Check /dcfeed list and /dcplayerfeed list, then verify channel permissions for the bot role.
  • Prevention: Validate feed output immediately after channel or role changes.

Premium Feature Not Available

  • Problem: Market, automation, or premium controls are blocked.
  • Likely cause: Premium not active on the target server.
  • Fix: Run /premium status server:"<SERVER>" and activate or switch premium as needed.
  • Prevention: Keep a premium ownership log with current server assignments.

Player Economy Command Fails

  • Problem: /bank, /deposit, or /withdraw fails for a player.
  • Likely cause: Player has not linked account or account link is stale.
  • Fix: Have player run /link and retest command.
  • Prevention: Put linking prerequisites in onboarding and FAQ channels.

Raid Alerts Missing

  • Problem: Users do not receive raid alert pings.
  • Likely cause: Raid alert channel not set, stale raid code, or wrong server nickname selection.
  • Fix: Confirm /set raid-channel, then regenerate player code using /raid link.
  • Prevention: Audit raid alert configuration weekly.

Incident Data to Capture

  • Affected server name
  • Exact command used
  • Timestamp
  • Output or error message
  • Last known successful action