RoC VTS Toolkit - VTS 1097 (v16.6.19)

The community toolkit for Rise of Castles: Ice & Fire, built by and for State 1097. Find your best hero combos, plan research and specialization, prepare for Eden, and run alliance records, all in one place. It works on phones and is available in 13 languages.

Heroes and combos

Research and specialization

Battles, Eden and the Arcade

Made for phones

Everything else in the toolkit

Tool	What it's for
DM Materials	Dragon Master set planning: crafting routes, material totals and enhancement milestones
Class Development	Class leveling paths with skill priorities at each checkpoint
Strife over Dragon	Hero recommendations for Strife (S0–S4, X1–X2)
PDFs	14 printable references: heroes, combos, skins, research, towers, Eden and Dragon Master
VtsScore	Competition sign-ups, growth uploads and the growth board, unlocked with the member PIN
VTS Admin	Leadership tools: OCR leaderboards, roster, contributions, match results and roles

Member and admin tools need the right sign-in; opening a page doesn't grant access.

About the data

• Hero, skill and research facts carry their source and verification status. Unknown values are left blank, never guessed. To correct something, see data and evidence and the source package.
• Battle Simulator results are model output, not a guarantee of in-game outcomes.
• The artifact view currently covers Sword of Judgment only.

---

For contributors

gh-pages is production, and every change goes through a pull request. AGENTS.md is the authoritative workflow and release policy.

Quick start

Requires Node 22 (.nvmrc) and Python 3.11, the same as CI.

git fetch origin
git worktree add -b my-change ../hero-combo-my-change origin/gh-pages
cd ../hero-combo-my-change
npm ci
npm run dev

Use the URL Vite prints; don't open index.html from disk. Always npm ci, because a node_modules folder left over from another branch causes misleading size failures. Public pages run without credentials. For cloud features, copy .env.example to .env.local and run npm run dev -- --host 127.0.0.1 --port 5174. Never commit credentials, PINs or debug tokens.

Everyday commands

Command	Does
npm run dev	Development server
npm run check:fast	Version, lint, formatting, unit tests and translations: the usual pre-PR gate
npm run test:unit	Node unit suite only
npm run build	Production build (also refreshes generated stamps and payloads)
npm run size:check	Asset budgets against a fresh build
npm run check	Full gate including rules, build, size and browser smoke tests

Browser tests need Chromium once: npx playwright install chromium.

Where things live

Path	Contents
*.html, tabs/	Page entry points and lazily fetched tab templates
js/, css/	Feature code, models, catalogs, translations and styles
database/	Canonical source tables and evidence used by the data builders
functions/, workers/	Firebase Functions and the OCR/AI proxy (deployed separately)
scripts/, tests/	Build and validation tooling, unit and browser tests
docs/	Guides, source evidence and historical plans

Architecture covers feature ownership, data paths and caching. Operations covers troubleshooting.

Releasing

• User-visible changes bump the version and add a CHANGELOG entry. Patch releases run to .20 before the next minor.
• Small fixes need focused tests plus check:fast. Security, auth, Firebase rules and major upgrades need the full npm run check.
• Firebase rules, Functions and Workers deploy separately from the site; see the deploy runbook. Merging a PR does not deploy them.
• The owner merges. See the release guide.

README screenshots are captured from the live site with demo-safe public pages and stored in docs/media/readme/.

Support

Report bugs with the page, release, language, theme, device and steps to reproduce. Data corrections need a source. See CONTRIBUTING.md. Report security or private-data issues privately via SECURITY.md, never in a public issue.

Licensed under the terms in LICENSE. This is a free fan-made tool, not affiliated with Camel Games or Rise of Castles.