The calculators

The ML Calculators are a web tool for two jobs: estimating a battle outcome before you commit, and working out what a city upgrade will cost. They live at ml-calculator.devgru-mc.org.

This page covers what each calculator takes in and what it gives back. It does not cover the math behind the numbers.

Battle calculator

Enter both sides and it estimates how the fight resolves.

You enter:

• Attacker: troop count (with a G / T / M magnitude selector), Striker %, and optionally Scavenger % and Fearless %.
• Defender: troop count (G / T / M), Guardian %, optionally Salvager % and Brave %, and the defending City Level (0 for no city).

It shows:

• The winner, plus each side’s combat power and a power breakdown.
• Survivors per side: troops started, lost, and remaining.
• Bonuses per side: gold gained, troops recovered, and net army.

City upgrade calculator

Work out the cost of leveling a city up.

You enter: current level, target level, and number of cities.

It shows:

• Total gold required.
• Your stats at the target level (defense bonus, wall HP, gold per hour, troops per hour), each with the change from where you are now.
• A cost-milestones table: per-level step cost and running cumulative.

Access

The calculators are gated to DEVGRU. You sign in with Discord, and the tool checks two things live on every request: that you are in the DEVGRU Discord server, and that you hold the access role (named “DEVGROUP” in the project README). If your role is removed, access stops immediately.

TODO (Ricky / admins): confirm the current Discord role name. The worker checks a numeric role ID, not a name, so “DEVGROUP” comes from the README and may have been renamed. Also add how a member gets that role granted.

TODO (Ricky / admins): when to use each calculator, the strategy and judgment side, is not in the source. Add guidance here.