🧭 Guided Workflow
Recommended order: Inventory → Officer → Stars → Development → XP → Planner → Save Progress. You can still use any tab at any time.
Start by saving your Inventory.
📦 Inventory Readiness
Save Inventory to see a readiness summary.
Badge resources
—
—
Star value
—
—
XP held
—
—
Individual Officer Badges
—
—
🧠 Officer Readiness Intelligence
Select an Officer to see what your saved Inventory can achieve now.
Readiness is calculated from the selected Officer's saved progress plus the resources currently available from Inventory.
🎯 Smart Dashboard
Readiness: Select an Officer and enter your resources.
Development
—
—
Stars
—
—
XP
—
—
Can I Max This Officer?
—
—
Next Upgrade Plan
No saved plan selected.
No saved plan selected.
Upcoming Release
—
—
Enter resources to see planning guidance.
S7 Liora
0.0%
⭐ Stars
Held0
Required98,000
🏅 Development
Badges from held Officer Readiness Vouchers (ORV)0
Required1,600
📘 Officer XP
Held0
Required199,646,700
📊 Officer Progress
All Officers are shown automatically. Officers with no saved development are classified as NOT STARTED. Held shared resources do not increase an Officer's progress percentage.
Save Officer progress to build this dashboard.
Show:
| Officer | Overall progress | Development | Stars | XP | Badge shortfall | Star shortfall | XP shortfall | Status |
|---|
🔎 Compare Officer Progress
Choose any saved Officers to compare their actual saved progress. Shared inventory is not counted as completed progress.
Compare:
👤 Officer Experience
👤
Portrait not added yet
Add a file named to the repository.
💾 Officer Progress Profile
Each Officer keeps their own upgrade progress. Shared resource inventories stay populated when you switch Officers.
Profile—
Saved statusNot saved yet
Changing Officer saves/loads Officer-specific progress only. Shared Stars, vouchers, Universal Badges, Selection Chests and XP Books remain unchanged.
📈 Officer Upgrade Summary
Live summary for the selected Officer using the resources currently entered in the calculator.
Select an Officer and enter resources to see the current upgrade position.
⭐ Star Planner
Legendary Stars: Star Readiness Vouchers (SRV) are available only for eligible Legendary seasonal Officers from S2 onward. Original Legendary Officers cannot use SRV.
Exclusive Stars from held SRV0
Officer Stars from held SRV0
Star Readiness Vouchers (SRV) remaining0
Stars used0
Stars held0
Stars required98,000
🏅 Officer Development
Skill Promotion costs follow the selected Officer rarity.
Training badge cost follows Officer rarity.
Each Legendary Officer Badge Selection Chest gives 1 specific Legendary Officer Badge for an Officer currently available in the chest. It does not convert to a Universal Legendary Badge or ORV.
Each Legendary Officer Badge Chest can be used as either 1 Universal Legendary Badge or 600 Officer Readiness Vouchers. A chest cannot count as both.
Badges used0
Universal Legendary Badges available0
ORV generated from Legendary Officer Badge Chests0
Badges from held Officer Readiness Vouchers (ORV)0
Officer Readiness Vouchers (ORV) remaining after whole badges0
Badges required1,600
Officer Readiness Vouchers (ORV) required0
📘 Officer XP
1–40: 5,806,700 · 41–50: 16,960,000 · 51–60: 53,430,000 · 61–70: 123,450,000
XP held in books0
XP required for selected levels199,646,700
XP shortfall199,646,700
🎯 Future Officer Targets & Saved Scenarios
Create a reusable future-Officer target without changing Inventory. Saved scenarios are stored on this device.
Choose a target session and calculate the scenario.
Saved Planning Scenarios
No planning scenarios saved yet.
v4.4.0
📈 Planning Readiness Dashboard
Turns saved future-Officer scenarios into a release-readiness view and highlights the next resource to prioritise.
Save a Planning Scenario above to see readiness percentages and a suggested next action.
🎯 Goals Planner
| Resource | Required | Held | Shortfall |
|---|
🧮 Resource Optimiser — Preview
Preview of shared badge resources against the selected Officer. It does not spend or alter resources.
Choose another Officer to compare badge efficiency.
Enter resources and select an Officer to see the optimiser preview.
👥 Multi-Officer Upgrade Planner
Build a priority list and preview how shared badge resources could be allocated. This planner does not spend or alter your normal saved resources.
| Priority | Officer | Badges Needed | Held | ORV / Badge | Shared Allocated | Status | Order |
|---|
Add Officers to build an upgrade plan.
🧠 Advanced Multi-Officer Planning
Preview-only recommendations. This tool never spends or changes Inventory.
Future Officers are planning placeholders only. The session can suggest a type, or Future Officer Type can override it manually.
Save progress for the Officers you are considering, then run the analysis.
📋 Officer Database
| Name | Season | ORV | SRV | Notes | Actions |
|---|
❓ Help & Instructions
✨ What’s New — v4.6.0 LIVE
LIVE RELEASE. v4.6.0 adds Upgrade Targets & Recommendations, Dynamic Officer Data and database-driven Future Officer Cost Forecasting while retaining the stable planning, Inventory, Progress, backup and Officer development features.
💾 Native working-state persistence
A normal browser refresh should keep the working interface where you left it instead of returning key controls to defaults.
- Selected Officer and current app tab/page.
- Officer Search, Season, Rarity and Role filters.
- Officer Progress MAXED / IN PROGRESS / NOT STARTED filters.
- Compare Officer Progress filters and selected Officers.
- Multi-Officer Planner rows, Officer selections, badge requirements and working resource fields.
- Advanced Planner/session selections, future scenario fields and Resource Optimiser comparison Officer.
Saved Officer profiles, saved plans and Central Inventory remain separate from this temporary working-interface state.
📦 Correct Legendary chest rules
- Legendary Officer Badge Chest: each chest can be used as either 1 Universal Legendary Badge or 600 Officer Readiness Vouchers (ORV). It cannot count as both.
- Legendary Officer Badge Selection Chest: each chest gives 1 specific Legendary Officer Badge for an Officer currently available in the Selection Chest pool. It does not convert to ORV or a Universal Legendary Badge.
- Original Legendary Officers remain ineligible for ORV/SRV seasonal conversion routes.
🧮 Resource Optimiser — Preview
Select a second Officer under Compare with Officer to compare badge efficiency, including ORV cost per Officer Badge where applicable. The Optimiser is preview-only and does not spend or alter saved resources.
👥 Multi-Officer Upgrade Planner
Create a priority list of Officers and preview how shared badge resources could be allocated without changing normal saved Inventory. The Planner supports named plans, multiple Officer rows, per-Officer badge requirements, priority/order controls, ORV, Universal Legendary Badges, Badge Chests, Selection Chests and selectable Badge Chest strategy.
📋 Central Inventory order
The Inventory now follows the approved Order in List sequence rather than spreadsheet row order:
- Legendary Officer Badge Chest
- Legendary Officer Badge Selection Chest
- Officer Readiness Voucher (ORV)
- Star Readiness Voucher (SRV)
- Legendary Officer Badge
- Epic Officer Badge
- Elite Officer Badge
- Individual Officer Badges in the approved numbered order
- Elite Stars I–III
- Epic Stars I–III
- Legendary Stars I–III
- XP Books: 100, 500, 1,000, 5,000, 10,000, 20,000 and 50,000
The non-game 50 XP Book entry has been removed.
📊 Progress and Compare
Officer Progress continues to classify Officers as MAXED, IN PROGRESS or NOT STARTED. Shared Inventory does not artificially increase an Officer's saved progress percentage. Compare Officer Progress uses actual saved Officer progress.
🏅 Confirmed Officer Badge totals
- Legendary: 10 unlock + 690 Skills + 900 Training = 1,600 badges to MAX.
- Epic: 10 unlock + 440 Skills + 4,500 Training = 4,950 badges to MAX.
- Elite: 10 unlock + 440 Skills + 18,000 Training = 18,450 badges to MAX.
🧭 v4.4.0 planning retained
Planning Readiness Dashboard, Badge/Star/XP readiness, Priority Target, Suggested Next Action, future October/January/April/July sessions, Season + Officer Type reports, projected future Legendary resources, ORV/SRV forecasting and MAXED-Officer exclusions remain available.
🔮 Dynamic Future Officer Cost Forecast
The forecast now uses the latest confirmed Legendary seasonal Officer release in the Officer Database as its baseline. Example: at the v4.6.0 release, the latest confirmed baseline is S7 Tank Destroyers — 600 ORV per Badge / 300 SRV per Exclusive Star. When a newer confirmed release is published, the baseline automatically advances.
Future ORV/SRV figures are planning estimates only until actual release costs are confirmed.
Recommended workflow: start with Inventory and save the resources you currently hold, then work through Officer → Stars → Development → XP → Planner → Save Progress. Use Backup & Restore in Settings before major changes or when you want a portable copy of locally saved app data.
1. Inventory
Start here. Enter the resources you currently hold and press Save Inventory. Inventory is shared throughout the app, so you only need to maintain these resource totals in one place.
Inventory includes Officer Readiness Vouchers (ORV), Star Readiness Vouchers (SRV), Universal Legendary/Epic/Elite Badges, Legendary Officer Badge Chests and Selection Chests, Legendary/Epic/Elite Stars, XP Books, and individual Officer Badges.
For individual Officer Badges, enter quantities against the appropriate Officer. Each Officer's badge quantity is stored separately. Update Inventory whenever your in-game resources change, then save it before planning upgrades.
2. Officer
Use Search, Season and Officer Type / Role filters to narrow the Officer list. Select the Officer you want to calculate. A matching portrait is displayed automatically when its file is available in the officer-portraits folder.
The selected Officer determines the cost of an Officer Badge in Officer Readiness Vouchers (ORV) and the cost of an Exclusive Star in Star Readiness Vouchers (SRV).
The Officer Upgrade Summary shows the remaining Officer Badges, Officer Stars and Officer XP for the currently selected Officer.
Original Officers: Officer Readiness Vouchers (ORV) and Star Readiness Vouchers (SRV) cannot be used for Original Officers.
3. Stars
Set the Officer's current and target Star level. The Stars tab automatically follows the selected Officer rarity: Legendary, Epic or Elite Star I / II / III. Star Readiness Vouchers (SRV) are shown only for Legendary Officers and cannot be used by Epic or Elite Officers.
4. Development
Enter unlock status, the four independent Skill Strand levels and Training Level. Development uses the relevant saved Inventory resources when calculating what is available for the selected Officer.
Each Universal Legendary Badge is worth 1 Officer Badge for a Legendary Officer.
Each Legendary Officer Badge Selection Chest gives 1 specific Legendary Officer Badge for an Officer currently available in that chest. It does not convert to ORV. Each Legendary Officer Badge Chest can instead be used as either 1 Universal Legendary Badge or 600 ORV.
5. XP
Enter current and target Officer Level. Saved XP Book quantities from Inventory are used to calculate XP held, XP required and the remaining shortfall.
6. Planner & Resource Optimiser
Use Planner after entering Inventory and the Officer's Stars, Development and XP progress. Select a goal such as Max Officer, Next Star, Reach 5★, Max Skills or Max Training to see requirements, resources held and shortfalls.
The Resource Optimiser lets you select a second Officer in Compare with Officer. It compares the Officer Readiness Voucher (ORV) cost per Officer Badge for the two Officers.
How to interpret the recommendation: where both Officers can use ORV, the optimiser recommends favouring ORV on the Officer with the lower ORV cost per badge and favouring shared Universal Legendary Badges / Legendary Officer Badge Chests on the Officer with the higher ORV cost per badge. This protects the more expensive Officer from unnecessary ORV spending.
The optimiser is preview only. It does not automatically spend, allocate or change your saved resources.
7. Multi-Officer Upgrade Planner
The Multi-Officer Planner lets you create a priority list of several Officers, set the Officer Badges still needed for each, and preview how shared ORV, Universal Legendary Badges and Legendary Officer Badge Chests could cover the plan.
Plans are preview-only and do not spend or alter the saved Inventory. Named plans can be saved locally in the browser and loaded again later.
8. Save Progress
MAX Officer: use the ⭐ MAX Officer button to set the selected Officer to 5 Stars, Level 70, Unlocked, all 4 Skill Strands at Level 5 and Training Level 180. The Officer profile is saved immediately. Shared inventory is not spent or changed.
Use Save Progress after entering or changing Officer progress information. Progress is stored locally in the browser on the current device. Save Progress does not publish your personal data to other users.
9. Database
The Database Manager controls the Officer master list. Use it to add or edit Officers and export the database. Export CSV exports the Officer database; it is different from Save Progress and App Backup.
To publish new or edited Officers for everyone, update the published officers.json and officers.csv files in the GitHub repository.
10. Recurring Release Calendar
The Releases tab shows the recurring annual KoW release cycle in calendar order (January → December). The current month and next scheduled release are highlighted automatically, so the calendar does not require a yearly reset.
11. Settings, Backup & Restore
Settings contains the app name, portrait and landscape backgrounds, update controls and Backup & Restore.
Export App Backup creates a JSON backup of KoW Companion data stored locally by the browser. Keep this file somewhere safe. Restore App Backup loads a previously exported JSON backup and reloads the app.
Check for Updates compares the installed version with the published version. Refresh Latest Version refreshes the KoW Companion application cache without intentionally deleting saved calculator progress.
Terminology
ORV = Officer Readiness Voucher
SRV = Star Readiness Voucher
Universal Legendary Badge = 1 Officer Badge for a Legendary Officer
Exclusive Star = 110 Officer Star value
🔮 Future Officer Cost Forecast
Forecast future Officer costs from the established Officer-release sequence. The model uses the latest known S7 Tank Destroyer release (600 ORV / 300 SRV) and compounds approximately 20% for each future Officer release.
Forecast ORV / Badge
—
—
Forecast SRV / Exclusive Star
—
—
Estimated ORV to fund Badges
—
—
Estimated SRV to fund Stars
—
—
Forecast only — actual release costs should replace the estimate when published.
Advanced Future Officer Planning: Use the Planner to compare your current saved Officers and Inventory against projected future Officer sessions, including expected resources for one or two future Officers.
📅 Recurring Release Calendar
KoW releases follow this recurring annual cycle, displayed in calendar order from January → December. The current month is highlighted automatically.
📦 Central Inventory
Enter resources once and press Save Inventory. The saved inventory is then used throughout the app. Items are displayed in the game list order defined by the Inventory master list.
Inventory not yet saved.
Individual Officer Badges
Enter badge quantities for any Elite, Epic or Legendary Officer, then press Save Inventory. Every Officer is listed even when the player currently holds 0 badges. Each value is stored separately for that Officer and is used throughout the app.
No individual Officer Badges entered.
Officer Stars
Officer XP Books
⚙ Settings
Responsive Backgrounds
The app automatically uses the Portrait background on portrait screens and the Landscape background on landscape/PC screens.
Active portrait backgroundBuilt-in default portrait
Active landscape backgroundBuilt-in default landscape
App Updates
Installed version:
Tap Check for Updates to compare with the latest GitHub Pages version.
About
KoW Companion
Created by FireStorm (371)
Version Integrity
Checking build version consistency…
Help & Instructions
Open the in-app User Guide for the recommended setup order, explanations of every tab, saving, database publishing, vouchers, badges and Original Officer restrictions.
Backup & Restore
Export all locally saved KoW Companion browser data, or restore a previous JSON backup.
No backup created yet.
v4.6.0 LIVE
🎯 Upgrade Targets & Recommendations
Choose a target for the currently selected Officer. This first v4.6.0 test build compares the saved current position with your target and gives a clear next-step recommendation. It does not spend or alter Inventory.
Ready: select an Officer and calculate a target.