Sengoku Jidai — Player Command Guide

An HKCU game powered by Aornos Simulations, designed by Hobbes

Welcome to Sengoku Jidai! This guide explains how to use the Discord bot that powers the game. If you've never used a Discord bot before, start with Section 1 — it covers everything you need to know before touching any commands.

For game rules, mechanics, province effects, and strategy, see the Rules Guide.

Section 1: How Discord Slash Commands Work

Discord bots use slash commands, which means every command starts with a forward slash (/). You don't type these in regular chat — you type them in the message box, and Discord shows you a menu of available options.

How to use a slash command:

1. Click into any text channel's message box.
2. Type /. A menu will pop up listing available commands.
3. Start typing the command name (e.g., player) and the menu will filter down.
4. Click the command you want, or keep typing to narrow it further.
5. If the command needs extra information (like choosing a province), Discord will show you the required fields. Fill them in, then press Enter.

Important things to know:

• All responses from the bot are ephemeral — only you can see them. Nobody else in the channel sees your command responses. Use commands freely without worrying about cluttering the chat.
• Commands are organized into groups. All army-related commands are under /army, all economic commands are under /econ, and so on.
• Some fields offer autocomplete — as you type, the bot will suggest valid options. Always prefer to select from the autocomplete list rather than typing freehand, as the bot will reject options it doesn't recognize.
• You can only submit one order per turn. If you submit a second order, it will overwrite your first. Choose carefully before you submit.

Section 2: Getting Started — First Steps

Before you can use any order commands, you need to register your character.

/player register

Registers you on the game roster. The bot reads your Discord display name and your server roles to automatically assign your character name, clan, and title. Run this command once when you first join the game. You can run it again if your nickname or roles change and you need to update your entry.

After registering, use /player status to confirm everything looks correct.

Section 3: Checking Your Status

These commands let you look up information about yourself, your clan, and the game world. None of these submit an order — they are read-only.

/player status

Shows your full character sheet: character name, faction (clan), title, current location, current mission (if any), mission location, order details, Authority Score, and status.

/player current-location-information

Shows a detailed breakdown of the province you are currently located in, including terrain, RGO type, building slots, and stockpile stats in the format current / cap (+regen per turn).

/time

Shows the current turn number, season, and year. Use this to track where you are in the game cycle.

/clan treasury

Shows your clan's current Mon (currency) balance.

/clan members

Lists all characters in your clan, along with their current location and title.

/clan holdings

Lists all provinces owned by your clan, including terrain type, resource type, and province classification.

/clan mission-status

Daimyo only. Shows which members of your clan have submitted a mission for the current turn and which have not. Mission details are not revealed — only presence or absence. Use this before submitting orders to see who still needs to act.

/clan check-knowledge

Shows your clan's current Knowledge level and tech scores across all disciplines (Expansion, Development, Warfare, Piety, Learning).

/clan province-detail [province]

Shows the full stats for one of your clan's provinces — identical in detail to /player current-location-information, but lets you pick any province your clan owns rather than only the one you're standing in. Stockpile stats are shown as current / cap (+regen per turn).

/army known-armies

Lists all of your clan's armies with full unit breakdowns. Also shows foreign armies you can detect, in three tiers:

• Your Armies — all of your clan's armies, full detail everywhere (location, leader, unit composition).
• Armies in Your Province — foreign armies sharing your current location, full detail (location, clan, leader, unit composition). Only shown when such armies exist.
• Armies in Range — foreign armies located in or directly bordering your owned territory, limited detail (clan, location, total unit count only).

/army count-guns

Shows your clan's current gun stockpile. Guns are consumed when running Firearm Drill orders.

Section 4: Clan Management

These commands manage your clan's diplomatic relationships. Most are only usable by the Daimyo.

/clan designate-ally [target_clan] [ally: True/False] [secret: True/False]

Daimyo only. Free action. Set another clan as an ally (True) or remove their ally status (False). Use autocomplete to select the target clan. Set secret: True to make the change without publishing it to the server.

/clan execute [target] [murder: True/False] [secret: True/False]

Daimyo only. Free action. Order the execution of a character. Valid targets are any member of your own clan (regardless of location) and any foreign character currently at your capital. Set murder: False to cancel a pending execution order. Set secret: True to attempt a covert execution (lower success chance). The target must be selected from autocomplete — only eligible characters appear.

Section 5: Submitting Orders

The commands below submit your character's order for the current turn. You can only have one active order at a time. Submitting a new order will replace your previous one.

When you submit an order, the bot confirms what you set. You can check your current order at any time using /player status.

Each order also determines where your character moves during resolution — this is noted under each command.

Daimyo: Setting orders for clanmates Every mission command has an optional set_for parameter. When used, the Daimyo can submit a mission on behalf of a clan member who has not yet acted this turn. The set_for field autocompletes to clan members without an active mission. All normal command requirements still apply to the target — if a command requires a specific province, tech level, or title, the target must meet those requirements. The command will fail if the target already has a mission set. Use /clan mission-status to see who still needs an order before submitting.

Army Orders (/army)

/army lead-army [army] [province]

Command one of your clan's armies to move one province. Select the army from autocomplete (only your clan's armies appear), then select the destination province (only provinces connected to the army's current location appear).

Expansion 4: Your army may move up to two provinces in a single order, as long as every province along the path (including the intermediate one) is owned by your clan. Both intermediate and destination options appear in autocomplete.

Warfare 6: Your armies can cross mountain connections, which are otherwise impassable. Mountain-connected destinations will appear in autocomplete once your clan reaches Warfare 6.

Winter (Turn 9): Army movement is blocked. If you submit this order on turn 9, the army will not move and your character will stay at the army's current location.

Movement: Your character moves to the destination province along with the army.

/army hire-samurai [province] [count]

Recruit 1–3 Samurai at a province your clan owns, at a cost of 7 Mon each. Enter the number you want to hire (1, 2, or 3).

Movement: Your character moves to the selected province.

/army rally-samurai [province] [count]

Shogunate only. The Shogunate can recruit up to 5 Samurai per turn at 6 Mon each — a better rate than /army hire-samurai. Only available if your clan currently holds the Shogunate.

Movement: Your character moves to the selected province.

/army produce-siege-weapons [province]

Recruit one Siege Weapon for 10 Mon at a province that has a Siege Workshop building. Only provinces with a Siege Workshop will appear in autocomplete.

Movement: Your character moves to the selected province.

/army firearm-drill [army] [levy_type] [count]

Convert regular levies in one of your armies into Firearm Levies, consuming guns from your clan's stockpile. Select the army, choose which levy type to convert (e.g., Spear Levies, Sword Levies), and enter the number to convert (1–50). Check your gun stockpile first with /army count-guns.

Movement: Your character moves to the army's current location.

/army bribe-hostile-army [army] [bribe_amount]

Requires Learning 6. Attempt to bribe a foreign army with Mon. You bid an amount; if your bid meets or exceeds the army's strength threshold, the army is captured. If your bid is insufficient, the Mon is lost. Only foreign armies visible to your clan will appear in autocomplete.

Movement: Your character moves to the target army's current location.

Social Orders (/social)

/social move [province]

Move your character to any province. Your clan gains +1 Knowledge when this order resolves. Be cautious: moving into a province controlled by an enemy clan risks capture or death.

Movement: Your character moves to the selected province.

/social establish-relations [target_clan]

Open a private diplomatic channel between your clan and the target clan. At resolution, a new Discord channel is created (named "Your Clan - Target Clan") visible only to both clan roles, with a 2-hour slowmode. If a channel already exists between the two clans, the mission still completes with no duplicate created. The Shogunate already has channels with all clans.

Movement: Your character travels to the target clan's capital.

/social slander-opponent [target]

Reduce another character's Authority by 5. This is a political attack that weakens a rival's standing in their clan.

Movement: Your character operates from your own clan's capital.

/social bestow-praises [target]

Increase another character's Authority by 2. A goodwill gesture that boosts an ally's standing.

Movement: Your character operates from your own clan's capital.

/social promote-self

Increase your own Authority by 10. No additional options needed.

Movement: Your character operates from your own clan's capital.

/social claim-daimyo

Attempt to seize the Daimyo position within your clan. Only works if you are not already the Daimyo. See the Game Guide for the full rules on Daimyo succession.

Movement: Your character operates from your own clan's capital.

/social claim-shogunate

Daimyo only. Attempt to claim the Shogunate. Requires your clan to have at least 25% more provinces and units than the current Shogun, AND higher Authority than the Shogun.

Movement: Your character operates from your own clan's capital.

Economic Orders (/econ)

/econ tax-province [province]

Convert a province's tax stockpile into Mon (spendable currency). Only one character per faction can tax a given province per turn. Your primary source of income — use this on provinces with large tax stockpiles.

Okura Kyo title (Expansion 2): If you hold the Okura Kyo title, your clan also gains +1 Knowledge each time you tax a province.

Movement: Your character moves to the selected province.

/econ recruit-levies [province]

Convert a province's manpower stockpile into military units. The unit type depends on province buildings (Forge → Sword Levies, Bowyer → Archer Levies, Stables → Cavalry, default → Spear Levies). Only one character per faction can recruit in a given province per turn. Check buildings first with /clan province-detail.

Movement: Your character moves to the selected province.

/econ lead-trade-mission [province] [guns (optional)]

Conduct a trade mission at a coastal province your clan owns, gaining 1 Mon and 1 Knowledge. With Warfare 4, you may optionally purchase 0, 1, or 2 Guns for 2 Mon each. Only coastal provinces appear in autocomplete.

Movement: Your character moves to the selected province.

/econ oversee-construction [province] [building]

Build a structure in one of your provinces. Select the province, then select the building from autocomplete. Construction costs Mon from your treasury. Building availability depends on province type, RGO, and tech level.

Tech-locked buildings: Some buildings require a minimum tech level before they can be constructed: Customs House and Foreign Quarter require Development 1; Barracks requires Warfare 2; Sanctuary requires Piety 1; Library requires Learning 1; Firearm Maker requires Learning 5. Attempting to build one of these without the required tech level will fail.

Piety 2: Each successful construction also grants your clan +2 Knowledge.

Movement: Your character moves to the selected province.

/econ meditate [province]

Gain 1 Knowledge. Performed at one of your owned provinces. Use when you need Knowledge but don't have a coastal province available for a trade mission. Buildings in the province add further bonuses (Shrine: +1 Knowledge; Library: +1 Knowledge and +1 Mon; Sanctuary: +2 Knowledge).

Learning 3 (Shikibu Kyo): Meditating also gives your clan +1 Mon.

Movement: Your character moves to the selected province.

/econ administrate-province [province]

Requires Development 2. A combined action that converts a province's tax stockpile to Mon and its manpower stockpile to units in a single order — the equivalent of doing both /econ tax-province and /econ recruit-levies at once.

Movement: Your character moves to the selected province.

/econ conduct-experiments [province] [mon]

Requires a Laboratory building in the selected province. Enter the amount of Mon to spend (must be a multiple of 3 — 3 Mon = 1 Knowledge). Only provinces with a Laboratory will appear in autocomplete.

Movement: Your character moves to the selected province.

/econ recruit-character

Requires Learning 4. Costs 10 Mon. Recruit a new character for your clan, provided your clan is below its character limit. Your character must be at your clan's capital when submitting this order.

Character cap: 4 normally; 5 if your clan holds the Shogunate. Expansion 3 adds +1, and Expansion 6 adds another +1 (maximum 6 for a Shogun clan with Expansion 6).

Movement: Your character operates from your clan's capital.

Section 6: Letters (/letter)

Letters allow your character to send written messages to other clans. Letters are staged as "pending" and dispatched at turn resolution — they are not instant. Each clan has a private thread where their letters appear.

/letter write [to_clan]

Write a letter to another clan. Select the target clan from autocomplete, then fill in the letter content in the pop-up modal (up to 1900 characters). Once submitted, the letter appears in your clan's private thread with Pending status and will be dispatched at end of turn.

Dispatch rules at turn resolution:

• Learning < 3: Only one letter is sent per clan, per turn — the most recent letter written by the Daimyo, or the most recent letter overall if no Daimyo wrote one.
• Learning ≥ 3: All pending letters are sent.

Letters sent to another clan appear in that clan's private thread showing the sender's character name, title, and faction.

Section 7: Order Resolution Order

At the end of each turn, orders are resolved in a fixed sequence. Orders earlier in the sequence resolve before orders later in the sequence. This matters when two characters interact — for example, a character who moves first may arrive in a province before a slander order takes effect.

All orders of the same type resolve simultaneously. After all orders are processed, post-resolution checks run (battle resolution, hostile province encounters, tech selection prompts, etc.).

Section 8: Technology Selection

After each turn resolves, the bot automatically checks whether any clan has unallocated tech points — that is, whether Techs Unlocked (from the Knowledge Tracker) exceeds the sum of their current tree levels. If it does, the bot posts a prompt in that clan's capital channel.

The Selection Prompt

The bot sends an embed to the clan's capital channel showing:

• The current level in each of the five trees
• A footer indicating how many selections remain
• Five buttons: 🏯 Expansion, 🌾 Development, ⚔️ Warfare, ⛩️ Piety, 📜 Learning

Click the button for the tree you want to advance. The bot will increment that tree by one level and post a confirmation. If more selections are still available, a new prompt is posted immediately.

Who Can Click

Only the clan's Daimyo or Shikibu Kyo (Learning 3 title) may click a selection button. Clicking without an eligible title shows an error visible only to you.

Bot Restarts

Tech selection prompts are held in memory. If the bot restarts, any active prompts become inactive. If an old prompt's buttons don't work, ask an admin to run /tech-check to re-issue any pending selections.

Section 8: Tips for New Players

One order per turn. Each character can do exactly one thing per turn. Think about what matters most before committing. Check your current pending order with /player status.

Use autocomplete. When a command asks for a province name, army name, building, or character name, always use the dropdown suggestions. Freehand entries that don't match the list will be rejected.

Only you see your responses. Every bot response is private to you. Run status commands freely — they don't affect gameplay and no one else can see them.

Check your province before recruiting. Different buildings produce different unit types. Use /clan province-detail before submitting /econ recruit-levies so you know what you'll get.

Coordinate with your clanmates. Most orders have a conflict check — two characters from the same clan cannot submit the same order type targeting the same province in the same turn. Coordinate before submitting to avoid wasting actions.

If you get an error, read it carefully — it usually tells you exactly what went wrong (e.g., "You are not on the roster," "Only the Daimyo may do this," "Another character in your faction is already..."). If you're stuck, contact an admin.

Quick Reference — All Commands

Status & Information (no order submitted)

Clan Management (Daimyo only, free actions)

Letters

Army Orders

Social Orders

Economic Orders

Section 9: Admin Commands

These commands are restricted to game administrators and are not visible to regular players.

/state lock [locked: True/False]

Lock or unlock the game. When locked, all player-facing commands are blocked and players see a message that the game is currently locked. Use locked: True to lock, locked: False to unlock. The lock state persists across bot restarts.

/state recalculate

Recompute all derived sheet values from source data — province stats, season from turn number, building cost reductions, etc. Run this after making manual edits to the sheet to bring calculated columns back in sync.

/resolve

Run the full turn resolution pipeline. Processes all submitted player orders in the defined resolution order, applies results to the sheet, and logs outcomes. After resolution completes, automatically checks all clans for unallocated tech points and posts selection prompts as needed. Admin only.

/tech-check

Manually re-trigger the tech selection check for all clans. Fetches current Knowledge Tracker data and posts a selection prompt in the capital channel for any clan with unallocated tech points. Use this if tech prompts were missed after a resolution (e.g., due to a bot restart). Admin only.

Admin Quick Reference