Discord Bot

Bot user guide

Primostar Calculator helps players plan in-game progression, estimate resource needs, and look up game mechanics in Discord.

Get started

Type / in a Discord channel where you can use the bot, then select the Primostar Calculator command. The examples below show option names and example values. Enter values in Discord’s option fields and pick the actual character, season, fragment or dungeon from autocomplete.

Run /profile create with a name and season. In the editor, enter the inputs for the feature you want to use. Submit each form to save, then run the calculation command. Use /profile edit to update your inputs and /profile use to switch the default character.

Saves are shared across contexts for the same Discord account. Replies in servers and group conversations are normally visible only to you. In a direct message with the bot, it replies in that conversation. Some results can be shared with 公開結果 where permissions allow. Interactive controls expire after 14 minutes. Reopen the command to continue with your saved data.

Profile editor

Use /profile edit and select the matching editor category. The Discord labels are shown where they help you find a control.

Basic settings (基本設定)
Select your season, player number, server and class. The player number fills in the server from its first seven digits. Changing the server keeps the player number as entered, so resolve any mismatch. Changing class clears equipment selections that no longer fit.
EXP and speedups (角色經驗與目標時間)
Set current level, EXP earned at that level, hourly EXP and the target time. In 加速、累計原初與大礦, set today’s free speedup usage, speedup stones and accumulated Primordial Stars. The form shows the last recorded EXP at your current level. Update it with the value shown in the game. Changing only the target time keeps the original record. Changing only the hourly rate applies the old rate up to the time you save.
Current and target levels (目前等級 / 目標等級)
Enter five equipment, eight skill, four pet and twenty relic levels in batches or one at a time. Enter combat skills 1–4 before arcana 1–4. Pair relic targets from lowest to highest current relic level. A blank batch field keeps its existing value. A blank individual target clears that target.
Stock, hourly production and material dungeons
Under 持有資源 and 每小時產出, open a separate form for each material, including each of the three pet-food qualities. Enter character EXP under 角色經驗與目標時間. Under 素材秘境, enter each material’s average yield per run. The forecast uses the daily run count already stored in the profile, which defaults to zero for new saves.
Equipment and gifts
Pick the actual equipment for each slot under 裝備選擇. Under 禮物, pick 夥伴 or 星間之神, then 日用品, 花, 書 or 貴重品. Enter favor, currencies by kingdom and gifts by quality.

Units and time

Enter only the number in a numeric field. Where available, select its matching _unit option. No unit (無單位) is ×1, 千 and k are ×1,000, 萬 is ×10,000, m is ×1,000,000, 億 is ×100,000,000, and b is ×1,000,000,000. A slash command unit applies only when you also supply its paired number. Field limits still apply after conversion.

In the editor, hourly EXP and Rola fields default to 萬, and other fields with a unit selector default to raw numbers. Current level progress, speedup stones, Primordial Stars and level fields are raw numbers. The selected editor unit is saved with the season.

Enter times such as 2026-12-01 20:00 for UTC+8, or include an offset as in 2026-12-01T20:00:00+08:00. Results display in UTC+8.

Command reference

Each entry shows what the command returns and what each option changes. Required options must be filled in Discord. Some commands also require a character or at least one optional field.

/help In-Discord help

/help

Open the bot’s help. With no option, it shows the setup steps and command groups.

command Optional
Choose profile, primordial, exp, equipment, gift, world, ask, remember, or data to show help for that group.

Example /help command:equipment

/profile Characters and saves

/profile create

Create a character, make it active and open its editor.

name Required
Character label, 1–60 characters after trimming. Each of your characters needs a distinct name.
season Required
Select the character’s initial season from autocomplete. It determines the starting save and game data used for calculations.

Example /profile create name:Main season:s1

/profile list

List your characters and each character’s selected season.

No options.

/profile use

Make the selected character the default for later commands.

profile Required
Select the character you want to change from autocomplete.

Example /profile use profile:Main

/profile show

View the selected season, class, masked player number, server, character level, hourly EXP, item levels and save revision.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /profile show profile:Main

/profile edit

Open the editor for the selected character. Choose a category and section, then submit the form to save. The season selector opens that season’s separate save.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /profile edit

/profile rename

Change a character’s label. Its season saves stay attached to it.

profile Required
Select the character you want to change from autocomplete.
name Required
New character label. The same 1–60 character and uniqueness rules apply.

Example /profile rename profile:Main name:Alt

/profile delete

Remove the selected character and all its season saves after confirmation. If it was active, select or create another character before relying on the default again.

profile Required
Select the character you want to change from autocomplete.

Example /profile delete profile:Alt

/primordial Primordial Stars and upgrades

/primordial recommend

Preview the season’s recommended character, equipment, skill, pet and relic targets. Choose 套用目標 to save them. Your current levels and resources are kept.

tier Required
Choose 一般 (normal), 重課 (heavy) or 超重課 (super). Each tier looks up a different target set for the selected season. The bot reports missing recommendations for unsupported season and tier combinations.
profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /primordial recommend tier:一般

/primordial score

Use the saved target levels to show the score breakdown, this season’s Primordial Stars and the total including previously saved stars. Set targets first. Unset targets contribute zero.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /primordial score

/primordial resources

Compare saved current and target levels. Shows the required materials, stock, forecast gains and shortfall. Set a target time, hourly production and average dungeon yields in the editor. The EXP balance comes from the character EXP settings. Material dungeons are the extra source used. Pet food is shown in regular-food equivalents (regular 1, high-quality 8, premium 40). Missing cost ranges are flagged.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /primordial resources

/exp Experience and timing

/exp eta

Estimate the EXP still needed, arrival time and speedup hours. Enter your current level, earned EXP, hourly EXP and available speedups in the profile editor. If you still need EXP and your hourly rate is zero, an arrival time cannot be calculated.

target_level Optional
Level to reach. After unit conversion, it must be a whole number from 1 to 1,000. Omit it for the next level. A target at or below your saved current level is already reached.
target_level_unit Optional
Multiplier for target_level only. Omit for the raw number. For example, target_level:1 target_level_unit:k means level 1,000.
profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /exp eta target_level:100

/exp reachable

Forecast the level, available EXP and speedup hours at a given time using the same profile inputs as ETA. Results beyond known data are marked as estimates.

target_time Required
Forecast time in UTC+8 or ISO 8601 with a time zone. Enter a future time to include future EXP gains. A past time gives a zero-hour forecast from the current state.
profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /exp reachable target_time:2026-12-01 20:00

/exp hoard

Show when to start hoarding EXP for the next season, using the selected profile’s season rule. The result includes the season end and how many hours early to start.

season_end Optional
Supply the actual season end time to override the server schedule. If omitted, the bot looks up the saved server and season. Supply a time if that lookup has no schedule. This command returns the time only.
profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /exp hoard season_end:2026-12-01 05:00

/equipment Equipment, fragments and dungeons

/equipment fragment

Estimate dismantling output, pre-fee and post-fee sale value, and profit per group. A profile is required. Enter the trade inputs as command options. Omitted options use the profile’s existing values, with the fee-mode exception described below.

fragment Optional
Pick the fragment type from autocomplete. It determines which dismantling yield is used. You can omit this option if your profile already has a saved fragment.
quantity Optional
Total number of fragments to dismantle, a whole number after unit conversion. It changes total stone output, while the profit shown is per group.
fragment_price Optional
Purchase price per group of fragments. The calculator deducts it from post-fee sale value to find profit.
stone_price Optional
Sale price per group of refining stones. This changes the sale value before and after fees.
fee_mode Optional
正常 allows 10, 20, 30, 50 or 70%. 優惠 allows 5, 12, 20, 40 or 60%. If you set a mode and omit fee_rate, the bot uses that mode’s first rate (10% or 5%).
fee_rate Optional
Percentage taken from the sale. Enter 5 for 5%. The final number must be one of the rates allowed by the selected or saved mode.
quantity_unit Optional
Multiplier for quantity. For example, quantity:1.5 quantity_unit:k means 1,500 fragments.
fragment_price_unit Optional
Multiplier for fragment_price. For example, fragment_price:1.2 fragment_price_unit:萬 means 12,000 per group.
stone_price_unit Optional
Multiplier for stone_price. For example, stone_price:2 stone_price_unit:k means 2,000 per group.
fee_rate_unit Optional
Multiplier for fee_rate. Leave it unset for ordinary percentages. The converted rate must still be allowed by the fee mode.
profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example after selecting a fragment /equipment fragment quantity:1.5 quantity_unit:k fragment_price:500 stone_price:800 fee_mode:優惠 fee_rate:5

/equipment score

Score your saved main hand, off hand, helmet, armor and shoes for the selected season and class. Set the class and pick the individual equipment items in the editor. The result shows per-slot scores, total and rating where available.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /equipment score

/equipment dungeon

Look up the dungeon’s season, required level, power thresholds and refining-stone rewards by difficulty. You can use it without a profile.

dungeon Required
Select a dungeon from autocomplete. The selected entry includes its season, so check it when names repeat.

/gift Favor and gifts

/gift calculate

Compare the least-overflow and owned-gifts-first plans. Set recipient, gift category, current favor level and progress, target level, owned gifts and kingdom currencies in the editor. The result lists purchases by kingdom and quality, cost, favor and any shortfall. It is a preview, so your saved coins and gifts stay as they are.

profile Optional
Select a character you own from autocomplete. Omit it to use your active character.

Example /gift calculate

/gift reference

See favor and price by quality and which kingdoms sell each gift category. You can use it without a profile.

No options.

/world Servers, realms and rallies

/world server

Resolve a server’s name, realm code, world number and merge status. An explicit server or player number works without a profile.

player_number Optional
12-digit player number. The first seven digits identify the server. If you also supply server, it must match that prefix.
server Optional
Seven-digit server ID in 600XXYY form. The last two digits are the world number, from 01 to 16. Select a match from autocomplete when available.
season Optional
Discord offers this option, but this lookup returns the server’s recorded current state regardless of season.
profile Optional
Select a saved character. When both identifiers are omitted, the bot uses that character’s saved identifiers, or your active character’s if profile is also omitted. Explicit identifiers take priority over saved values.

Example /world server server:6002601

/world realm

List the known servers in the same realm. A star marks the requested server if it is in the list.

player_number Optional
12-digit player number. The first seven digits identify the server. If you also supply server, it must match that prefix.
server Optional
Seven-digit server ID in 600XXYY form. The last two digits are the world number, from 01 to 16. Select a match from autocomplete when available.
season Optional
This option has no effect on the list. The lookup uses the server’s realm code.
profile Optional
Select a saved character. When both identifiers are omitted, the bot uses that character’s saved identifiers, or your active character’s if profile is also omitted. Explicit identifiers take priority over saved values.

Example /world realm server:6002601

/world rally

Show the selected server’s World Rally group under that season’s rules. The bot reports when the feature is disabled or the season has no rule data.

player_number Optional
12-digit player number. The first seven digits identify the server. If you also supply server, it must match that prefix.
server Optional
Seven-digit server ID in 600XXYY form. The last two digits are the world number, from 01 to 16. Select a match from autocomplete when available.
season Optional
Select the season whose grouping rules you want. Omit it when using a profile to use that profile’s season. With an explicit identifier and no profile, supply season even if you have an active character.
profile Optional
Select a saved character. When both identifiers are omitted, the bot uses that character’s saved identifiers, or your active character’s if profile is also omitted. Explicit identifiers take priority over saved values.

Example /world rally server:6002601 season:s1

/ask Game knowledge

/ask

Search the game knowledge base. When configured, the bot may generate an answer from matching passages. It can also return a source excerpt or report no match. Requires an enabled knowledge base and works without a profile.

question Required
Ask in natural language, up to 500 characters. Include details such as season, class, dungeon and difficulty when they affect the answer. Leave personal information and credentials out of the question.

Example /ask question:二轉術士打競技場怎麼配?

/remember Private memories

/remember

Save one private memory and receive its ID. Provide at least one option. You can combine all three in one entry. Saved memories are separate from /ask and require no profile.

text Optional
Text or an image caption, up to 4,000 characters. A blank value counts as omitted.
url Optional
An HTTP or HTTPS URL up to 2,000 characters, without credentials in the address. The bot saves the link itself.
image Optional
Upload a Discord image attachment in PNG, JPEG, GIF or WebP, up to 8 MiB. The original file is saved.

Example /remember text:下季裝備規劃

/data Versions and supported data

/data

Show the bot and Discord library versions, game-data version and capture time, supported seasons, and server and dungeon counts. Include the data version, exact command and result trace ID when reporting an issue.

No options.