Differences

This shows you the differences between two versions of the page.

--- commands [2025/02/23 20:15] – russell
+++ commands [2025/02/23 20:48] (current) – russell
@@ Line 1: / Line 1: @@
+====== Bot Commands ======
+===== Admin Commands =====
+===== Economy Commands =====
+==== buy ====
+Buy an item from the shop using JoxCoins
+**Usage**
+**''/buy item:<string> quantity:<integer>''**
+**Options**
+**''item:<string>''**
+* The name of the item you want to buy
+    Required: true
+    Autocomplete: true
+    Description: Select from available shop items
+**''quantity:<integer>''**
+* How many of the item you want to buy
+    Required: false (default: 1)
+    Min value: 1
+    Description: Number of items to purchase
+**Validation**
+  * Amount must be greater than 0
+  * User must have sufficient JoxCoins for purchase
+  * Quantity must be greater than 0
+**Examples**
+Buy a single item:
+<code>/buy item:Fishing Rod</code>
+Buy multiple items:
+<code>/buy item:Fishing Bait quantity:5</code>
+----
+==== futures ====
+Get real-time data for US futures markets
+**Usage**
+**''/futures''**
+**Examples**
+View futures data:
+<code>/futures</code>
+----
+==== inventory ====
+Displays a user's inventory items in a formatted table
+**Usage**
+**''/inventory''**
+**Validation**
+  * User must have at least one item in their inventory
+  * Only shows items with quantity > 0
+**Examples**
+View your inventory:
+<code>/inventory</code>
+----
+==== invest ====
+Manage your stock investments in the server economy
+**Usage**
+**''/invest ticker:<string> quantity:<integer> ticker:<string> quantity:<integer>''**
+**Options**
+**''ticker:<string>''**
+Stock ticker symbol (e.g., AAPL)
+**''quantity:<integer>''**
+Number of shares to buy (min: 1)
+**''ticker:<string>''**
+Stock ticker symbol (e.g., AAPL)
+**''quantity:<integer>''**
+Number of shares to sell (min: 1)
+**Subcommands**
+  * buy
+  * sell
+  * list
+**Validation**
+  * Stock price must be greater than 0 to purchase
+  * User must have sufficient currency for purchase
+  * User must own shares to sell them
+**Examples**
+Buy stocks:
+<code>/invest buy ticker:AAPL quantity:5</code>
+Sell stocks:
+<code>/invest sell ticker:AAPL quantity:3</code>
+View portfolio:
+<code>/invest list</code>
+----
+==== shop ====
+View the items available for purchase in the shop
+**Usage**
+**''/shop''**
+**Validation**
+  * Shop must contain at least one item
+  * Items are sorted by type first, then by cost
+**Examples**
+View the shop:
+<code>/shop</code>
+----
+==== stock ====
+Get a stock price chart from Finviz
+**Usage**
+**''/stock symbol:<string> timeframe:<string>''**
+**Options**
+**''symbol:<string>''**
+Stock symbol to look up (e.g., AAPL, TSLA)
+**''timeframe:<string>''**
+Chart timeframe
+**Validation**
+  * Symbol must be a valid stock ticker
+  * Timeframe must be one of the allowed options
+**Examples**
+View daily AAPL chart:
+<code>/stock symbol:AAPL timeframe:d</code>
+View monthly TSLA chart:
+<code>/stock symbol:TSLA timeframe:m</code>
+----
 ==== transfer ====
 Send JoxCoins to another user
-===== Usage =====
-**''/transfer user:<user> amount:<integer>''**
+**Usage**
+**''/transfer target:<user> amount:<integer>''**
 **Options**
-  * amount (integer): The amount of JoxCoins to transfer (min: 1)
+**''target:<user>''**
+The user to transfer JoxCoins to
+**''amount:<integer>''**
+The amount of JoxCoins to transfer (min: 1)
 **Validation**
   * Amount must be greater than 0
   * Sender must have sufficient JoxCoins balance
   * Cannot transfer to self
 **Examples**
-Transfer 100 JoxCoins
-<code>/transfer user:user amount:100</code>
+Transfer 100 JoxCoins:
-Transfer 1000 JoxCoins
+<code>/transfer target:@user amount:100</code>
-<code>/transfer user:user amount:1000</code>
+Transfer 1000 JoxCoins:
+<code>/transfer target:@user amount:1000</code>
+----
+===== Fun Commands =====
+==== cryptography ====
+Daily cryptography challenge with rewards
+**Usage**
+**''/cryptography answer:<string>''**
+**Options**
+**''answer:<string>''**
+Your solution to the active challenge
+**Subcommands**
+  * question
+  * answer
+**Validation**
+  * Only one active challenge per day
+  * Must complete current challenge before getting a new one
+  * Answer must match the expected solution
+**Examples**
+View current challenge:
+<code>/cryptography question</code>
+Submit an answer:
+<code>/cryptography answer solution:hello</code>
+----
+==== fish ====
+Go fishing to earn JoxCoins and rare items
+**Usage**
+**''/fish''**
+**Validation**
+  * Must have a Fishing Rod in inventory
+  * Must have at least 1 Fishing Bait
+  * Uses 1 bait per attempt
+**Examples**
+Go fishing:
+<code>/fish</code>
+----
+==== gfy ====
+Tell someone to go fuck themselves
+**Usage**
+**''/gfy target:<user>''**
+**Options**
+**''target:<user>''**
+The user you want to tell to go fuck themselves
+**Validation**
+  * Must specify a valid user
+  * Cannot tell yourself to go fuck yourself
+**Examples**
+Tell someone to GFY:
+<code>/gfy target:@user</code>
+----
+==== poker ====
+Play daily poker with a 5-card hand
+**Usage**
+**''/poker positions:<string>''**
+**Options**
+**''positions:<string>''**
+Card positions to redraw (comma-separated, e.g., 1,3,5)
+**Subcommands**
+  * view
+  * redraw
+  * leaderboard
+**Validation**
+  * One hand per day (resets at midnight)
+  * Limited number of redraws per hand
+  * Redraw positions must be valid (1 to 5)
+**Examples**
+View your hand:
+<code>/poker view</code>
+Redraw cards:
+<code>/poker redraw positions:1,3,5</code>
+View leaderboard:
+<code>/poker leaderboard</code>
+----
+==== roulette ====
+Bet your JoxCoins on roulette
+**Usage**
+**''/roulette amount:<integer> type:<string> number:<string>''**
+**Options**
+**''amount:<integer>''**
+Amount of JoxCoins to bet (min: 1, max: 500)
+**''type:<string>''**
+Type of bet to place
+    - RED: Red numbers (1,3,5,7,9,12,14,16,18,19,21,23,25,27,30,32,34,36)
+    - BLACK: Black numbers (2,4,6,8,10,11,13,15,17,20,22,24,26,28,29,31,33,35)
+    - GREEN: Green numbers (0,00)
+    - EVEN: Even numbers (2,4,6,...,36)
+    - ODD: Odd numbers (1,3,5,...,35)
+    - LOW: Numbers 1-18
+    - HIGH: Numbers 19-36
+    - NUMBER: Specific number bet
+**''number:<string>''**
+Specific number to bet on (0-36 or 00, only for NUMBER type)
+**Validation**
+  * Must have sufficient JoxCoins balance
+  * Bet amount must be between 1 and 500
+  * Must specify a number when betting on NUMBER type
+  * Number must be valid (0 to 36 or 00)
+**Examples**
+Bet on red:
+<code>/roulette amount:100 type:RED</code>
+Bet on specific number:
+<code>/roulette amount:50 type:NUMBER number:17</code>
+----
+===== User Commands =====
+==== leaderboard ====
+View various server leaderboards
+**Usage**
+**''/leaderboard''**
+----
+==== quotes ====
+Manage and view quotes in the server
+**Usage**
+**''/quotes''**
 ----