wardogs-calculator

WARDOGS Artillery Calculator

A lightweight, open-source L81 Mortar and SPH-2 artillery calculator, live team map, and tactical planning tool for WARDOGS.

Live app: https://wardogs-artillery.com/
Mobile UI: https://wardogs-artillery.com/mobile/

Desktop	Mobile

---

Interfaces

The project ships two interfaces from the same repository and GitHub Pages deployment:

• Desktop — /
• Mobile — /mobile/

Phones are automatically routed from the desktop entry pages to the matching mobile route. The mobile UI is a separate map-first interface with touch panning, pinch zoom, touch-friendly point placement, Map Tools, and a bottom-sheet calculator.

Both interfaces reuse the same calculator logic, maps, tile pyramid, configuration, translations, saved targets, drawings, browser storage, and optional live team lobbies.

Live Team Lobbies

Create a lobby and share its invite link or code to plan on the same tactical map. Drawings, zones, polygons, and user markers synchronise live. Every player keeps a separate weapon, artillery point, target, and range circle; teammates see labelled player positions without duplicate range circles.

Lobby traffic starts only after a player creates or joins a room. See Collaborative lobbies for deployment, privacy, recovery, limits, and Cloudflare configuration.

Localization

The shared locale system supports English, Russian, Ukrainian, German, French, Spanish, Polish, Portuguese, Simplified Chinese, Korean, Japanese, Czech, and the non-indexed Cat locale.

Documentation

Detailed documentation is split into focused files to keep this README concise.

• Features & weapons — calculator features, Map Tools, weapons, touch controls, and coordinate system
• Maps — map configuration, tile structure, bounds, marker zoom visibility, and adding new maps
• Mobile interface — mobile routes, automatic routing, touch controls, and deployment architecture
• Localization — supported languages, shared translations, automatic language selection, localized URLs, and SEO metadata
• Development — project structure, local development, unified build process, and GitHub Pages deployment
• Analytics — GoatCounter setup, bounded usage events, local testing, and privacy
• Message of the Day — MOTD configuration, localization, and behavior
• Collaborative lobbies — live team map behaviour, Cloudflare deployment, limits, privacy, and recovery
• Security hardening — public-source threat model, Cloudflare headers, secrets, CI, and residual risks
• CDN & hosted assets — permitted use of the project-funded CDN and requirements for forks and self-hosted deployments
• Asset delivery — CDN usage boundaries, contributor checks, privacy, and security reporting
• Contributing — contribution guidelines
• License & Disclaimer — MIT scope, third-party assets, and project disclaimer

Quick Start

[!WARNING] The application shell can be run locally, but the official protected map and Terrain3D assets will not load in an independent local or self-hosted deployment. The source-code license does not include access to the project-funded CDN. To display maps, host assets you are entitled to use on your own infrastructure and replace the configured asset URLs. See Forks and self-hosted deployments.

npm run build
cd dist
python -m http.server 8000

Then open:

Desktop:            http://localhost:8000/
Mobile:             http://localhost:8000/mobile/

Contributing

Corrections, map data improvements, localization updates, bug fixes, and QoL improvements are welcome.

See Contributing for details.

Support the Project

WARDOGS Artillery Calculator is free, open source, and does not place features behind a paywall. If the project is useful to you, voluntary support helps cover hosting, asset delivery, analytics, and other infrastructure costs.

• Support via Ko-fi
• Support via Boosty

License

Original project source code is licensed under the MIT License.

WARDOGS assets and other third-party materials are not covered by the MIT License. See License & Disclaimer for details.

The hosted map and terrain CDN is privately operated and funded for the official application. The MIT source-code license does not grant permission to use the CDN as infrastructure for forks, third-party applications, mirrors, bulk downloaders, or asset redistribution. See CDN & hosted assets.