B2 Zombie Calculator Web UI

   v.1.0.5

Calculator meant to improve CoD Zombies speedrunning experience by providing players with information about best possible times they can get


Check out our work on B2ORG

Our partners

Inputs




Space or comma separated list

Results

Welcome to B2 Zombie Calculator

Enter necessary information for calculations, such as rounds, players, game and map. Fill up additional arguments if desired. Check readme for detailed info.

Introduction

Welcome to the 5th revision of the B2 Zombie Calculator (formerly known as ZM-Round-Calculator). This update finally moves the page to a properly hosted application as opposed to a bodged together GitHub website release and includes a complete rewrite of the logic, which will allow for more updates and features as time goes on.

This tool allows you to extract information about the best possible times for individual rounds as well as the best possible times for speedruns on certain zombies maps, by emulating the script logic from the game itself. The same numbers and formulas are used to provide the most accurate results.

As you can see, many features are still not enabled, stuff will be getting added whenever we have time to work on it, current release provides the base functionality - calculations for maps without special rounds other than dogs (for the time being)

Features

Currently the calculator has 2 scenarios, calculating best possible time for each round and calculating best possible time for a speedrun (that includes breaks between rounds etc).

Supported games are Call of Duty: World at War, Call of duty: Black Ops and Call of Duty: Black Ops II. See table below to check map availabiltiy for each of the games.

Game Map Availability
World at War Nacht Der Untoten
World at War Verrückt
World at War Shi No Numa
World at War Der Riese
Black Ops Kino Der Toten
Black Ops FIVE
Black Ops Ascension
Black Ops Call of the Dead
Black Ops Shangri-La
Black Ops Moon
Black Ops Nacht Der Untoten
Black Ops Verrückt
Black Ops Shi No Numa
Black Ops Der Riese
Black Ops II Green Run (currently Tranzit only, if needed, we'll split smaller maps)
Black Ops II Nuketown
Black Ops II Die Rise
Black Ops II Mob of the Dead
Black Ops II Buried
Black Ops II Origins

How to use

Overview of calculator interface

Mandatory arguments

Fill up Round, Players, Game and Map parameters, those are mandatory and no calculation can happen if one of them is not set. Fields are validated once filled up, so you'll be prompted upon entering a wrong value.

Calculator modifiers

Additionally, check out Calculator modifiers section, those are parameters that are passed directly to the calculator, and require re-calculating to take effect. Hover over each of the modifiers to read what it does. Some modifiers will provide additional input fields for data.

Mode selection and calculation

After filling out every element of the form, select which mode the calculator will be used in. Currently the calculator offers 2 modes, Round times and Perfect times. We're planning to add calculation for prenades at a later date. To obtain results, press Calculate

Visual modifiers

After calculation is done, results will be displayed in the middle window. Additionally, you'll see a new section called Visual modifiers. Those are used to modify how the page interprets data from the calculator and do not require additional calculations to take effect. Similar to Calculator modifiers, you may read what each modifier does by hovering on it.

Time formatting

You may change the time format using the dropdown menu placed in the upper right corner of the result window, by default time is displayed as hours:minutes:seconds. Use it alongside No Text visual argument to get pure time output

Copying results and switching between views

Next to time formatting option there are 3 buttons. Using them, you can copy the data as text to your clipboard, and also switch between friendly view and raw view, when in raw view, you'll see the raw JSON data from the calculator which was used to create the output in the friendly view.

Contribution

You can help the project by providing knowledge about how certain specific mechanisms are handled within CoD game scripts. We're looking to implement all missing maps, and perhaps venturing into newer games, but our current state of knowledge is not enough to achieve that, so any help there would be appreciated. Also feel free to share ideas about possible improvements to the tool on Discord.

Contact

You can contact us on our Discord server

Is this open source?

No, this version of the calculator is not open source, as it's part of a website that'll eventually also handle other things. You can check the old version implemented in Python in case you're curious or any of this knowledge would be useful to you. Fair warning tho, it will not be maintained anymore, and the code quality leaves a lot to be desired.

Is this project a competition to Zombacus

No, these 2 projects serve different purpose. Zombacus provides services based on statistics such as SPH, to perform calculations based on numbers provided by the player. Meanwhile B2 Calculator provides info about best theoritical results (which can and already have been achieved in some games) using strictly info derived from game logic. As there are some common elements, these two projects help each other to provide the best service to you, the end user.

Credits

Furret for helping factcheck math stuff and providing ideas

JezuzLizard for helping fill some knowledge gaps regarding GSC

BanMyXb0x for helping with analysis and interpretation of results while researching

Yojurt and Huth for testing accuracy against real games

Note

This application has open endpoints you can use for your own project. Please note, they're heavily rate limited so don't base any core functionality on them. Contact us if necessary.

Documentation

Documentation for calculator endpoints can be found here on Swaggerhub. For additional questions feel free to reach out on Discord

Changelog

Document listing changes applied to the calculator (internal processes are ommited, everything that has to do with how calculator functions is going to be listed)

Version 1.0.5 (10/30/2024)

  • Added version mark on the UI and to api responses

Version 1.0.4 (10/30/2024)

  • Added ability to prefill and afterfill special round argument. Add ... sign at the end and/or the beginning to prefill/afterfill rounds up until the specified round using the default algorithm.

Version 1.0.3 (10/27/2024)

  • Added changelog section
  • Changed how docs are displayed on the frontend (shouldn't be noticeable)

Version 1.0.2 (10/27/2024)

  • Interal update

Version 1.0.1 (10/26/2024)

  • Internal update (optimizations)