!bind

Binds a governor ID to your Discord account for bio purposes or manages existing bindings.

Subcommands:

• No args: Lists your bound governors if any are bound.
• !bind : Binds a governor as Primary or Farm.
• !bind clear : Clears a specific binding.
• !bind purge: Removes all bindings.

Note: Using !bind alone will show all your bound accounts if you have any.

Example: !bind 36426080 - Binds governor ID 36426080 as Primary.

!bio

Generates a bio image for a governor.

Options:

• No args: Uses your Primary governor.
• !bio : Specific governor in your kingdom.
• !bio : Specific kingdom and governor.
• !bio clean: Generates a clean bio for your Primary governor.
• !bio <@user>: Bio for mentioned user's Primary governor.

Example: !bio 2906 36426080 - Generates bio for governor 36426080 in kingdom 2906.

!buy

Initiates the option to buy a Hero Scrolls package.

Example: !buy - Starts the purchase process.

[NEW] !commanders

Displays a list of commanders for your Primary governor, with details like level, skills, equipment, and talents. Use pagination to view multiple pages.

Usage: Specify a page number (default is 1).

Example: !commanders - Shows the first page of commanders.

Example: !commanders 2 - Shows the second page of commanders.

Note: Select a commander to view detailed stats. Report unknown or missing data using the "Report Data" button.

[NEW] !fortbio

Generates a fort bio image for a governor.

Options:

• No args: Uses your Primary governor.
• !fortbio <@user>: Generates fort bio for the mentioned user's Primary governor.
• !fortbio : Generates fort bio for the specified governor ID in your kingdom.

Example: !fortbio 36426080 - Generates fort bio for governor 36426080.

Example: !fortbio @user - Generates fort bio for the mentioned user's Primary governor.

!gifts

Generates a report of gift contributions in your kingdom over a specified number of hours.

Usage: Specify hours (e.g., 24 for last 24 hours, 240 for last 10 days).

Example: !gifts 24 - Shows gifts from the last 24 hours.

Example: !gifts 1 - Shows gifts from the last hour.

!grab

Fetches specific data (e.g., kingdom stats or KvK report) for self-bound governors with Hero Scrolls tokens.

Usage: Specify a 4-digit kingdom ID or KvK report ID (e.g., c12593).

Example: !grab 2906 - Grabs data for kingdom 2906.

Example: !grab kvk c12593 - Grabs KvK report c12593.

!helpme

Displays the default help menu for the Hero Scrolls bot, listing available commands.

Example: !helpme - Shows this help information.

!kvk

Generates a KvK leaderboard for a specified kingdom in a KvK event, based on a stat.

Stats: Power, Kills, Deads, KP, DKP

Usage: Pass a 4-digit kingdom ID (in a KvK) and a stat.

Example: !kvk 2906 power - Shows KvK power leaderboard for kingdom 2906.

Example: !kvk 1960 deads - Shows KvK deads leaderboard for kingdom 1960.

Example: !kvk 2377 kills - Shows KvK kills leaderboard for kingdom 2377.

!leader

Generates kingdom leaderboard reports for various stats.

Types:

• power: Top governors by power.
• kp: Total kill points.
• kills: Troop type kill rankings.
• deads: Dead troops rankings.
• chests: Chest contributors.
• forts: Fort launchers.
• pairs: Rally pairs.
• helpers: Alliance helpers.
• farmers: Resource farmers.
• givers: Resource givers.
• marauder: Fort stage progress.
• power kvk: KvK power lost (active KvK only).
• kills kvk: KvK T4/T5 kill progress.
• deads kvk: KvK dead troops progress.
• dkp kvk: KvK DKP rankings.
• kp kvk: KvK kill points progress.

Usage: Add a 4-digit kingdom ID (e.g., 2906) for another kingdom, or use alone for your kingdom.

Example: !leader power - Shows top power rankings for your kingdom.

Example: !leader kp 2906 - Shows kill points for kingdom 2906.

Example: !leader deads kvk - Shows KvK dead troops progress (if KvK active).

!progress

Shows your Ranked Badge progress for various categories.

Categories: Use !progress alone for a list (e.g., power, kp).

Example: !progress power - Shows power badge progress.

!season

Manages or displays Season dates and reports.

Subcommands:

• !season show: Displays current Season dates.
• !season chests: Generates chest report.
• !season forts: Generates fort report.
• [NEW] !season joined: Generates a report of rallies joined during the season.

Example: !season show - Shows Season dates.

Example: !season joined - Shows rallies joined report.

!selfbind

Allows binding of a Governor for a personal Hero Scrolls token account (not for bio binding). Use this on the official Hero Scrolls Discord server in the self-service channel.

Example: !selfbind 36426080 - Binds governor 36426080 for your token account.

!setlanguage

Opens a menu to set your Primary governor's language.

!setprimary

Sets a bound governor as your Primary governor.

Example: !setprimary 36426080 - Sets 36426080 as Primary.

!setrole

Opens a menu to set roles for your Primary governor.

!settitle or !title

Sets or clears a custom title for your Primary governor (max 22 characters).

Example: !title "The Great" - Sets title to "The Great".

!setutc

Opens a menu to set your Primary governor's UTC offset.

!setvip

Opens a menu to set your Primary governor's VIP level.

!showid

Finds the KvK ID and info for a specified kingdom if it’s in a KvK event.

Usage: Pass a 4-digit kingdom ID (e.g., 2906).

Example: !showid 2906 - Shows KvK ID and info for kingdom 2906 if in a KvK.

[UPDATED] !tokens

Shows the number of Hero Scrolls tokens available for your individual governor account.

Example: !tokens - Displays your personal token count.

Note: This is for bronze, silver, or non-tier members.

!feet

Manages feet badges for governors. Each kingdom has a maximum of 20 feet badges.

Subcommands:

• !feet man @mention/governor_id: Sends a Man Feet badge.
• !feet woman @mention/governor_id: Sends a Woman Feet badge.
• !feet wash: Removes your feet badge.
• !sendfeet @mention/governor_id: Sends your current feet badge to another governor.

Example: !feet man 36426080 - Sends a Man Feet badge to governor 36426080.

Example: !sendfeet @user - Sends your feet badge to the mentioned user.

[NEW] !winner

Displays winners of special holiday events (e.g., Easter). Only available during announced events.

Usage: Specify the holiday name.

Example: !winner easter - Shows Easter event winners (when active).

Note: Check official Hero Scrolls announcements for event availability.

[NEW] !acon

Generates an alliance contributions report for a specified week and optional year.

Usage:

• !acon: Shows help and current week.
• !acon : Generates report for the specified week of the current year (2025).
• !acon : Generates report for the specified week and year.

Example: !acon 42 - Generates report for week 42 of 2025.

Example: !acon 2025 42 - Generates report for week 42 of 2025.

!event

Manages kingdom events.

Subcommands:

• !event list: Lists active events.
• !event report: Pulls up buttons to generate reports for existing events.
• !event forts: Checks or creates a fort event.

Example: !event list - Lists current events.

[NEW] !herosettings

Displays and manages Hero Scrolls settings for the kingdom, which affect commands like !order.

Subcommands:

• No args: Shows current settings.
• !herosettings : Specific setting management (details vary).

Example: !herosettings - Displays current kingdom settings.

[UPDATED] !order

Requests data scans for specified kingdoms (4-digit IDs), filtered by settings in !herosettings.

Options:

• !order : Requests scans for the specified kingdoms.
• [NEW] !order cap: Limits the scan to chapter 25 cities only.

Example: !order 2906, 2907 - Orders scans for kingdoms 2906 and 2907.

Example: !order 2906 cap - Orders a scan for kingdom 2906, limited to chapter 25 cities.

[UPDATED] !rallies

Shows fort rally activity or statistics for your kingdom over a specified time period.

Usage: Specify hours (e.g., 24 for last 24 hours, 240 for last 10 days) or a date range (YYYY-MM-DD HH:MM).

Example: !rallies 24 - Shows rallies from the last 24 hours.

Example: !rallies 2025-05-01 00:00 2025-05-07 23:59 - Shows rallies for the specified date range.

!report

Generates specific reports based on type.

Types:

• !report kvk {kvk_id}: Generates a KvK summary report. Optional: Add number of days to look back (default: from KvK start).
• !report governor {governor_id}: Generates a governor background check (coming soon).

Example: !report kvk C12553 - Generates KvK summary for C12553.

Example: !report kvk 12553 7 - KvK summary for 12553, last 7 days.

Example: !report governor 12345678 - (Coming soon) Governor background check.

!scantype

Sets the preferred scan delivery type for your kingdom (CSV Combined, CSV Multi, Excel).

!season

Manages or displays Season dates and reports.

Subcommands:

• !season show: Displays current Season dates.
• !season chests: Generates chest report.
• !season forts: Generates fort report.
• !season start YYYY-MM-DD: Sets Season start date.
• !season end YYYY-MM-DD: Sets Season end date.
• [NEW] !season joined: Generates a report of rallies joined during the season.

Example: !season start 2025-01-01 - Sets start date to Jan 1, 2025.

Example: !season joined - Shows rallies joined report.

[NEW] !seasonreport

Generates detailed season reports for your kingdom, including export options.

Subcommands:

• !seasonreport fort: Generates a fort rally report.
• !seasonreport fort export: Exports a fort rally report as an Excel file.

Example: !seasonreport fort - Generates a fort rally report.

Example: !seasonreport fort export - Exports a fort rally report to Excel.

[UPDATED] !seasonstats

Displays Season statistics.

Types:

• No args: General stats.
• !seasonstats chest: Detailed chest stats.
• !seasonstats fort: Detailed fort stats.
• [NEW] !seasonstats joined: Detailed rally join stats.

Example: !seasonstats chest - Shows detailed chest stats.

Example: !seasonstats joined - Shows detailed rally join stats.

[NEW] !shop

Generates alliance shop reports for the kingdom.

Subcommands:

• !shop: Shows available commands.
• !shop show: Displays summary of shop transactions for the last 7 days (one embed per alliance).
• !shop show : Summary for a specific date range (YYYY-MM-DD HH:MM).
• !shop leader: Shows top 10 governors by items purchased for each alliance for the last 7 days.
• !shop leader : Leaderboard for a specific date range.
• !shop report: Generates Excel report of shop transactions for the last 7 days.
• !shop report : Excel report for a specific date range.

Example: !shop show - Shows shop transaction summary for the last 7 days.

Example: !shop leader 2025-05-01 00:00 2025-05-07 23:59 - Shows top spenders for the specified period.

[NEW] !store

Generates alliance storehouse reports for the kingdom.

Subcommands:

• !store: Shows available commands.
• !store show: Displays summary embed for the last 7 days.
• !store show : Summary embed for a specific date range (YYYY-MM-DD HH:MM).
• !store report: Generates Excel report for the last 7 days.
• !store report : Excel report for a specific date range.
• !store graph: Generates charts for the last 7 days.
• !store graph : Charts for a specific date range.
• !store project : Generates credits projection for the specified number of days.

Example: !store show - Shows storehouse summary for the last 7 days.

Example: !store report 2025-05-01 00:00 2025-05-07 23:59 - Generates Excel report for the specified period.

Example: !store project 7 - Projects credits for the next 7 days.