SC-Tool Discord Bot

SC-Tool is a comprehensive Discord bot designed for Star Citizen communities. It offers a wide range of features to enhance your Star Citizen gaming experience, track player information, manage bounties, record piracy operations, trade commodities, and much more.

Table of Contents

1. Introduction
2. Command Categories
   • Player Commands
   • Organization Commands
   • Ship & Fleet Commands
   • Contract Commands
   • Bounty Commands
   • Coin & Reward Commands
   • Kill Tracking
   • Booty (Piracy) Commands
   • UEC Trading Commands
   • Commodity Trading
   • UEX Marketplace
   • Bingo Commands
   • Polls, Rolls & Raffles
   • Events
   • Wikelo (Favor Contracts)
   • Signal Flare
   • Merit Calculator
   • Executive Hangar
   • News & Patch Watch
   • Context Menus
   • Administration
3. Configuration

Introduction

SC-Tool helps Star Citizen communities with:

• Looking up player information, stats, and threat assessments
• Browsing ship details and managing personal/org fleets
• Creating and managing contracts and bounty contracts
• Tracking piracy operations (booty) with leaderboards
• Recording PvP kills across multiple game modes
• Trading UEC and analyzing commodity markets
• Running community events: polls, raffles, rolls, bingo, and scheduled events
• Managing organizations with comparisons and threat assessments
• Monitoring Star Citizen patches and MOTD changes
• Browsing UEX marketplace listings
• Viewing Wikelo favor contract data

The bot uses Discord hybrid commands, supporting both slash commands (/command) and prefix commands (!command).

Command Categories

Player Commands

Commands are under the /plyr group.

/plyr info <player_name> [player_name2] [player_name3] [player_name4] [player_name5]

Retrieves detailed information about up to 5 Star Citizen players.

• Parameters:

  • player_name (required): Primary player to lookup
  • player_name2–5 (optional): Additional players

• Details: Displays nickname, display name, organization membership and rank, enlistment date, location, languages, Arena Commander/Star Marine stats, bio, and threat list status. Tracks player history and detects profile changes over time.

• Example: /plyr info MinMin

/plyr stats <nickname>

Shows leaderboard stats for a specific player.

• Parameters:

  • nickname: Player name to look up

• Example: /plyr stats MinMin

/plyr leaderboard

Displays the top 50 players for the current season. Includes a dropdown to select different game modes.

/plyr assessment <playername>

Shows a threat assessment for a player (hostile, friendly, or neutral).

• Example: /plyr assessment MinMin

/plyr remove <playername> <list_name> (Admin only)

Removes a player from a threat list.

• Parameters:
  • playername: Player to remove
  • list_name: Which list to remove from

Organization Commands

Commands are under the /org group.

/org info <org_name>

Retrieves information about a Star Citizen organization.

• Details: Shows organization name, tag, member count, primary/secondary activities, archetype, commitment level, recruiting status, and language.

• Example: /org info TEST

/org stats <org_symbol>

Shows leaderboard stats for an organization.

• Example: /org stats TEST

/org leaderboard

Displays the top 50 organizations for the current season with a game mode selector.

/org assessment <org_name>

Shows a threat assessment for an organization (hostile, friendly, or neutral).

• Example: /org assessment TEST

/org compare <org1> <org2>

Side-by-side comparison of two organizations.

• Example: /org compare TEST AVOCADO

/org remove <orgname> <list_name> (Admin only)

Removes an organization from a threat list.

Ship & Fleet Commands

/ship info <ship_name>

Retrieves detailed ship information with paginated display.

• Details: Manufacturer, pledge price, crew size, cargo capacity, purchase locations and in-game prices, rental availability, loaner ships, images, Executive Hangar status, and Wikelo trade info.

• Example: /ship info Cutlass Black

/fleet manager <action> [ship_name] [ship_name2–5]

Manage your personal fleet.

• Parameters:

  • action: Add, Remove, or Remove All
  • ship_name (optional): Ship to add/remove (up to 5 at once)

• Example: /fleet manager Add Cutlass Black

/fleet view <fleet_type>

View your personal fleet or your org's combined fleet.

• Choices: Personal Fleet or Org Fleet

/fleet stats <fleet_type>

Fleet statistics including total ships, cargo capacity, estimated value, and size breakdown.

/fleet upload <file>

Upload a fleet JSON exported from the SC-Tool Chrome extension.

/fleet download <fleet_type>

Download your fleet data as a JSON file.

/fleet extension

Information about the Chrome extension for fleet export.

Contract Commands

Commands are under the /contract group.

/contract create (Admin only)

Creates a new contract.

• Parameters:
  • name: Contract name
  • claimability: How many times it can be claimed (Once, Unlimited, Custom)
  • custom_limit: Custom claim limit (if claimability is Custom)
  • uec_worth: UEC value
  • allowed_role: Role allowed to claim
  • reward_roles: Additional reward roles
  • emoji: Contract emoji
  • description: Contract description
  • coins_per_claim: Coins awarded per claim
  • bonus_coins: Bonus coins for completing all claims
  • thumbnail / image: Optional attachments

/contract claim <name> [quantity]

Claim a contract. Autocomplete on contract name.

• Example: /contract claim "Weekly Patrol" 1

/contract claim_management (Admin only)

Approve or disapprove pending contract claims.

/contract pending_claims

View all pending claims awaiting approval.

/contract info <name>

View details about a specific contract.

/contract list

List all available non-bounty contracts.

/contract post

Post a contract announcement with interactive claim buttons.

/contract edit <contract_name> [...] (Admin only)

Edit an existing contract's parameters.

/contract admin (Admin only)

Remove claims for a specific user.

/contract remove (Admin only)

Remove a contract entirely.

Bounty Commands

Commands are under the /bounty group.

/bounty create (Admin only)

Creates a bounty contract targeting a player or organization.

• Parameters:
  • claimability: Once, Unlimited, or Custom
  • custom_limit: Custom claim limit
  • player_name / org_name: Target player or organization
  • uec_worth: UEC value of the bounty
  • allowed_role: Role allowed to claim
  • reward_roles: Additional reward roles
  • emoji: Bounty emoji
  • description: Bounty description
  • coins_per_claim / bonus_coins: Reward coins
  • thumbnail / image: Optional attachments

/bounty purchase

Purchase a bounty using coins.

• Parameters:

  • claimability: Once, Unlimited, or Custom
  • allowed_role: Role allowed to claim
  • emoji: Bounty emoji
  • description: Bounty description
  • custom_limit: Custom claim limit
  • player_name / org_name: Target
  • uec_worth: UEC value

• Example: /bounty purchase Once @Hunter "Attacked me unprovoked" MinMin 5000

/bounty claim

Claim an active bounty contract.

`/bounty