code-battles 1.3.0 → 1.5.0

package/dist/cjs/index.js

@@ -3,6 +3,7 @@
 require('@mantine/core/styles.css');
 require('@mantine/dates/styles.css');
 require('@mantine/notifications/styles.css');
+require('@mantine/dropzone/styles.css');
 var core = require('@mantine/core');
 var dates = require('@mantine/dates');
 var hooks = require('@mantine/hooks');
@@ -12,6 +13,7 @@ var auth = require('firebase/auth');
 var firestore = require('firebase/firestore');
 var React = require('react');
 var reactRouterDom = require('react-router-dom');
+var dropzone = require('@mantine/dropzone');
 var jsxRuntime = require('react/jsx-runtime');
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -409,21 +411,30 @@ const toPlacing = (n) => {
     }
     return n.toString() + DIGITS[n % 10];
 };
-const runNoUI = (map, apis, playerBots, verbose) => {
+const runNoUI = (map, apis, playerBots, seed, verbose) => {
     const players = playerBots.map((api) => (api === "None" ? "" : apis[api]));
-    tryUntilFailure(() => 
+    tryUntilSuccess(() => 
     // @ts-ignore
-    window._startSimulation(map, players, playerBots, true, false, verbose));
+    window._startSimulation(map, players, playerBots, true, false, verbose, seed));
 };
-const tryUntilFailure = (f, timeout = 500) => {
+const tryUntilSuccess = (f, timeout = 500) => {
     try {
         f();
     }
     catch (error) {
         console.log("Failed, waiting for timeout...", error === null || error === void 0 ? void 0 : error.message);
-        setTimeout(() => tryUntilFailure(f, timeout), timeout);
+        setTimeout(() => tryUntilSuccess(f, timeout), timeout);
     }
 };
+const downloadFile = (filename, mimeType, contents) => {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    document.body.appendChild(a);
+    a.href = `data:${mimeType};charset=utf-8,${encodeURIComponent(contents)}`;
+    a.download = filename;
+    a.click();
+    document.body.removeChild(a);
+};
 
 const useLocalStorage = ({ key, defaultValue, }) => {
     const [value, setValue] = React.useState(getLocalStorage(key, defaultValue !== null && defaultValue !== void 0 ? defaultValue : null));
@@ -2493,6 +2504,10 @@ const RunSimulationBlock = () => {
         key: "Player Bots",
         defaultValue: ["None", "None"],
     });
+    const [seed, setSeed] = useLocalStorage({
+        key: "Seed",
+        defaultValue: "",
+    });
     const [runningNoUI, setRunningNoUI] = React.useState(false);
     const [runningNoUIN, setRunningNoUIN] = React.useState({});
     const navigate = reactRouterDom.useNavigate();
@@ -2501,15 +2516,18 @@ const RunSimulationBlock = () => {
         remaining = Math.max(...Object.values(runningNoUIN));
     }
     const run = () => {
-        navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}`);
+        // @ts-ignore
+        window._isSimulationFromFile = false;
+        navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}?seed=${seed}`);
     };
     const startRunNoUI = () => {
         setRunningNoUI(true);
-        runNoUI(map, apis, playerBots, true);
+        runNoUI(map, apis, playerBots, seed.toString(), true);
     };
     const startRunNoUIN = (n) => {
+        setLocalStorage("Results", {});
         setRunningNoUIN({ [n.toString()]: n });
-        runNoUI(map, apis, playerBots, false);
+        runNoUI(map, apis, playerBots, seed.toString(), false);
     };
     React.useEffect(() => {
         // @ts-ignore
@@ -2563,7 +2581,7 @@ const RunSimulationBlock = () => {
                 setLocalStorage("Results", {});
             }
             else {
-                runNoUI(map, apis, playerBots, false);
+                runNoUI(map, apis, playerBots, seed.toString(), false);
             }
         }
     }, [runningNoUIN]);
@@ -2574,6 +2592,7 @@ const RunSimulationBlock = () => {
                 }
             } }),
         React.createElement(BotSelector, { playerCount: playerCount, setPlayerCount: setPlayerCount, playerBots: playerBots, setPlayerBots: setPlayerBots, apis: apis }),
+        React.createElement(core.NumberInput, { leftSection: React.createElement("i", { className: "fa-solid fa-dice" }), label: "Randomness Seed", min: 0, value: seed, onChange: setSeed }),
         React.createElement(core.Button.Group, { mt: "xs" },
             React.createElement(core.Button, { variant: "default", w: "50%", leftSection: React.createElement("i", { className: "fa-solid fa-play" }), onClick: run }, "Run"),
             React.createElement(core.Button, { variant: "default", w: "50%", leftSection: React.createElement("i", { className: "fa-solid fa-forward" }), onClick: startRunNoUI, loading: runningNoUI || loading }, "Run (No UI)")),
@@ -2583,7 +2602,31 @@ const RunSimulationBlock = () => {
         remaining !== 0 && (React.createElement("p", { style: { textAlign: "center", marginTop: 10 } },
             "Remaining Simulations: ",
             remaining)),
-        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" })));
+        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" }),
+        React.createElement(dropzone.Dropzone, { mt: "xs", multiple: false, onDrop: (files) => __awaiter(void 0, void 0, void 0, function* () {
+                if (files.length !== 1) {
+                    return;
+                }
+                const file = files[0];
+                const text = yield file.text();
+                // @ts-ignore
+                window._navigate = navigate;
+                // @ts-ignore
+                window._isSimulationFromFile = true;
+                tryUntilSuccess(() => {
+                    // @ts-ignore
+                    window._startSimulationFromFile(text);
+                });
+            }), style: {
+                textAlign: "center",
+                paddingTop: 20,
+                paddingBottom: 20,
+                paddingLeft: 10,
+                paddingRight: 10,
+            } },
+            React.createElement("span", null,
+                React.createElement("i", { className: "fa-solid fa-file-code", style: { marginRight: 10 } }),
+                "Drag a simulation file here or click to select a file to run a simulation from a file"))));
 };
 
 const TournamentBlock = ({ pointModifier, inline, title }) => {
@@ -15901,13 +15944,19 @@ const Simulation = () => {
     const [apis, loading] = useAPIs();
     let { map, playerapis } = reactRouterDom.useParams();
     const location = reactRouterDom.useLocation();
+    const [searchParams] = reactRouterDom.useSearchParams();
     const [winner, setWinner] = React.useState();
+    const [downloadBytes, setDownloadBytes] = React.useState(false);
     const navigate = reactRouterDom.useNavigate();
     const colorScheme = hooks.useColorScheme();
     const showcaseMode = location.search.includes("showcase=true");
     React.useEffect(() => {
         n((engine) => __awaiter(void 0, void 0, void 0, function* () { return yield loadFull(engine); }));
         // @ts-ignore
+        window.showDownload = () => {
+            setDownloadBytes(true);
+        };
+        // @ts-ignore
         window.showWinner = (winner, verbose) => {
             if (admin) {
                 setWinner(winner);
@@ -15937,10 +15986,16 @@ const Simulation = () => {
     const playerNames = (_a = playerapis === null || playerapis === void 0 ? void 0 : playerapis.split("-")) !== null && _a !== void 0 ? _a : [];
     const players = playerNames.map((api) => (api === "None" ? "" : apis[api]));
     React.useEffect(() => {
-        if (!loading && players && playerapis) {
-            tryUntilFailure(() => 
+        var _a;
+        if (!loading &&
+            players &&
+            playerapis &&
+            // @ts-ignore
+            window._isSimulationFromFile !== true) {
+            const seed = (_a = searchParams.get("seed")) !== null && _a !== void 0 ? _a : "";
+            tryUntilSuccess(() => 
             // @ts-ignore
-            window._startSimulation(map, players, playerNames, false, !showcaseMode, true));
+            window._startSimulation(map, players, playerNames, false, !showcaseMode, true, seed));
         }
     }, [loading]);
     const newRank = getRank(getLocalStorage("Cached tournament/info"), winner, getLocalStorage("Point Modifier")) + 1;
@@ -16023,7 +16078,11 @@ const Simulation = () => {
                             React.createElement("span", { id: "render-status", style: { marginRight: 10 } }),
                             React.createElement(core.NumberInput, { id: "breakpoint", label: "Breakpoint", min: 0, leftSection: React.createElement("i", { className: "fa-solid fa-stopwatch" }), display: "inline-block", maw: "35%", mr: "xs" }),
                             React.createElement(core.Button, { style: { flex: "none" }, my: "xs", w: 100, leftSection: React.createElement("i", { className: "fa-solid fa-wand-magic" }), color: "grape", id: "step", mr: "xs", radius: "20px" }, "Step"))),
-                        React.createElement(PlayPauseButton, null)),
+                        React.createElement(PlayPauseButton, null),
+                        downloadBytes && (React.createElement(core.Button, { ml: "xs", radius: "20px", leftSection: React.createElement("i", { className: "fa-solid fa-download" }), color: "blue", onClick: () => downloadFile(`${playerNames.join("-")}.btl`, "text/plain", 
+                            // @ts-ignore
+                            window.simulationToDownload) }, "Download Simulation"))),
+                    showcaseMode && React.createElement("span", { id: "render-status" }),
                     React.createElement("p", { style: { margin: 0 } }, "Playback Speed"),
                     React.createElement(core.Slider, { style: { flex: "none" }, mb: 30, w: 500, maw: "85%", min: -2, defaultValue: 0, marks: [
                             { value: -2, label: "1/4" },

package/dist/cjs/types/index.d.ts

@@ -2,6 +2,7 @@ import "@fortawesome/fontawesome-free/css/all.css";
 import "@mantine/core/styles.css";
 import "@mantine/dates/styles.css";
 import "@mantine/notifications/styles.css";
+import "@mantine/dropzone/styles.css";
 import "prismjs/plugins/line-numbers/prism-line-numbers.css";
 import "prismjs/themes/prism.css";
 import "./index.css";

package/dist/cjs/types/utilities.d.ts

@@ -10,5 +10,6 @@ export declare const getRank: (tournamentInfo: any, team: string, pointModifier:
 export declare const updatePointModifier: () => void;
 export declare const toPlacing: (n: number) => string;
 export declare const zeroPad: (s: string, l: number) => string;
-export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], verbose: boolean) => void;
-export declare const tryUntilFailure: (f: () => void, timeout?: number) => void;
+export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], seed: string, verbose: boolean) => void;
+export declare const tryUntilSuccess: (f: () => void, timeout?: number) => void;
+export declare const downloadFile: (filename: string, mimeType: string, contents: string) => void;

package/dist/code_battles/__init__.py

@@ -14,6 +14,9 @@ def run_game(battles: CodeBattles):
         from pyscript.ffi import create_proxy
 
         window._startSimulation = create_proxy(battles._start_simulation)
+        window._startSimulationFromFile = create_proxy(
+            battles._start_simulation_from_file
+        )
     elif is_worker():
         setattr(
             sys.modules["__main__"],

package/dist/code_battles/battles.py

@@ -1,19 +1,24 @@
 import asyncio
 import base64
+from dataclasses import dataclass
+import datetime
 import json
 import math
 import time
-import random
+from random import Random
 import sys
 import traceback
+import gzip
 
 from typing import Any, Dict, Generic, List, Optional, Tuple, TypeVar
 from code_battles.utilities import (
     GameCanvas,
     console_log,
     download_image,
+    navigate,
     set_results,
     show_alert,
+    show_download,
     web_only,
     is_web,
 )
@@ -29,6 +34,53 @@ APIType = TypeVar("APIType")
 PlayerRequestsType = TypeVar("PlayerRequestsType")
 
 
+@dataclass
+class Simulation:
+    map: str
+    player_names: str
+    game: str
+    version: str
+    timestamp: datetime.datetime
+    logs: list
+    decisions: List[bytes]
+    seed: int
+
+    def dump(self):
+        return base64.b64encode(
+            gzip.compress(
+                json.dumps(
+                    {
+                        "map": self.map,
+                        "playerNames": self.player_names,
+                        "game": self.game,
+                        "version": self.version,
+                        "timestamp": self.timestamp.isoformat(),
+                        "logs": self.logs,
+                        "decisions": [
+                            base64.b64encode(decision).decode()
+                            for decision in self.decisions
+                        ],
+                        "seed": self.seed,
+                    }
+                ).encode()
+            )
+        ).decode()
+
+    @staticmethod
+    def load(file: str):
+        contents: Dict[str, Any] = json.loads(gzip.decompress(base64.b64decode(file)))
+        return Simulation(
+            contents["map"],
+            contents["playerNames"],
+            contents["game"],
+            contents["version"],
+            datetime.datetime.fromisoformat(contents["timestamp"]),
+            contents["logs"],
+            [base64.b64decode(decision) for decision in contents["decisions"]],
+            contents["seed"],
+        )
+
+
 class CodeBattles(
     Generic[GameStateType, APIImplementationType, APIType, PlayerRequestsType]
 ):
@@ -60,6 +112,12 @@ class CodeBattles(
     """The current state of the game. You should modify this in :func:`apply_decisions`."""
     player_requests: List[PlayerRequestsType]
     """The current requests set by the players. Should be read in :func:`make_decisions` (and probably serialized), and set by the API implementation."""
+    random: Random
+    """A pseudorandom generator that should be used for all randomness purposes (except :func:`make_decisions`)"""
+    player_randoms: List[Random]
+    """A pseudorandom generator that should be used for all randomness purposes in a player's bot. Given to the bots as a global via :func:`configure_bot_globals`."""
+    make_decisions_random: Random
+    """A pseudorandom generator that should be used for all randomness purposes in :func:`make_decisions`."""
 
     background: bool
     """Whether the current simulation is occuring in the background (without UI)."""
@@ -77,6 +135,7 @@ class CodeBattles(
     _eliminated: List[int]
     _sounds: Dict[str, "js.Audio"] = {}
     _decisions: List[bytes]
+    _since_last_render: int
 
     def render(self) -> None:
         """
@@ -94,12 +153,12 @@ class CodeBattles(
         Use the current state and bots to make decisions in order to reach the next state.
         You may use :func:`run_bot_method` to run a specific player's method (for instance, `run`).
 
+        If you need any randomness, use :attr:`make_decisions_random`.
+
         This function may take a lot of time to execute.
 
         .. warning::
            Do not call any other method other than :func:`run_bot_method` in here. This method will run in a web worker.
-
-        Do NOT update :attr:`state` or :attr:`step`.
         """
 
         raise NotImplementedError("make_decisions")
@@ -188,12 +247,12 @@ class CodeBattles(
 
         return 1
 
-    def configure_map_image_url(self, map: str):
+    def configure_map_image_url(self, map: str) -> str:
         """The URL containing the map image for the given map. By default, this takes the lowercase, replaces spaces with _ and loads from `/images/maps` which is stored in `public/images/maps` in a project."""
 
         return "/images/maps/" + map.lower().replace(" ", "_") + ".png"
 
-    def configure_sound_url(self, name: str):
+    def configure_sound_url(self, name: str) -> str:
         """The URL containing the sound for the given name. By default, this takes the lowercase, replaces spaces with _ and loads from `/sounds` which is stored in `public/sounds` in a project."""
 
         return "/sounds/" + name.lower().replace(" ", "_") + ".mp3"
@@ -203,11 +262,19 @@ class CodeBattles(
 
         return "CodeBattlesBot"
 
-    def configure_bot_globals(self) -> Dict[str, Any]:
+    def configure_render_rate(self, playback_speed: float) -> int:
+        """
+        The amount of frames to simulate before each render.
+
+        For games with an intensive `render` method, this is useful for higher playback speeds.
+        """
+        return 1
+
+    def configure_bot_globals(self, player_index: int) -> Dict[str, Any]:
         """
         Configure additional available global items, such as libraries from the Python standard library, bots can use.
 
-        By default, this is math, time and random.
+        By default, this is math, time and random, where random is the corresponding :attr:`player_randoms`.
 
         .. warning::
            Bots will also have `api`, `context`, `player_api`, and the bot base class name (CodeBattlesBot by default) available as part of the globals, alongside everything in `api`.
@@ -218,9 +285,13 @@ class CodeBattles(
         return {
             "math": math,
             "time": time,
-            "random": random,
+            "random": self.player_randoms[player_index],
         }
 
+    def configure_version(self) -> str:
+        """Configure the version of the game, which is stored in the simulation files."""
+        return "1.0.0"
+
     @web_only
     def download_images(
         self, sources: List[Tuple[str, str]]
@@ -356,7 +427,16 @@ class CodeBattles(
         volume = window.localStorage.getItem("Volume") or 0
         s = self._sounds[sound].cloneNode(True)
         s.volume = volume
-        s.play()
+
+        async def p():
+            try:
+                await s.play()
+            except Exception:
+                print(
+                    f"Warning: couldn't play sound '{sound}'. Make sure the `sound` and `configure_sound_url` are correct."
+                )
+
+        asyncio.get_event_loop().run_until_complete(p())
 
     @property
     def time(self) -> str:
@@ -385,12 +465,19 @@ class CodeBattles(
 
         self._initialized = True
 
-    def _initialize_simulation(self, player_codes: List[str]):
-        self.step = 0
+    def _initialize_simulation(
+        self, player_codes: List[str], seed: Optional[int] = None
+    ):
+        if seed is None:
+            seed = Random().randint(0, 2**128)
         self._logs = []
         self._decisions = []
+        self._decision_index = 0
+        self._seed = seed
+        self.step = 0
         self.active_players = list(range(len(self.player_names)))
-        self.active_players = list(range(len(self.player_names)))
+        self.random = Random(seed)
+        self.player_randoms = [Random(self.random.random()) for _ in self.player_names]
         self.state = self.create_initial_state()
         self.player_requests = [
             self.create_initial_player_requests(i)
@@ -398,10 +485,15 @@ class CodeBattles(
         ]
         self._eliminated = []
         self._player_globals = self._get_initial_player_globals(player_codes)
-        self._webworker_frame = 0
+        self._since_last_render = 1
+        self._start_time = time.time()
 
     def _run_webworker_simulation(
-        self, map: str, player_names_str: str, player_codes_str: str
+        self,
+        map: str,
+        player_names_str: str,
+        player_codes_str: str,
+        seed: Optional[int] = None,
     ):
         from pyscript import sync
 
@@ -414,7 +506,7 @@ class CodeBattles(
         self.background = True
         self.console_visible = False
         self.verbose = False
-        self._initialize_simulation(player_codes)
+        self._initialize_simulation(player_codes, seed)
         while not self.over:
             self._logs = []
             decisions = self.make_decisions()
@@ -432,16 +524,17 @@ class CodeBattles(
                 self.step += 1
 
     def _run_local_simulation(self):
-        self.map = sys.argv[1]
-        self.player_names = sys.argv[2].split("-")
+        seed = None if sys.argv[1] == "None" else int(sys.argv[1])
+        self.map = sys.argv[2]
+        self.player_names = sys.argv[3].split("-")
         self.background = True
         self.console_visible = False
         self.verbose = False
         player_codes = []
-        for filename in sys.argv[3:]:
+        for filename in sys.argv[4:]:
             with open(filename, "r") as f:
                 player_codes.append(f.read())
-        self._initialize_simulation(player_codes)
+        self._initialize_simulation(player_codes, seed)
 
         while not self.over:
             self.apply_decisions(self.make_decisions())
@@ -469,6 +562,73 @@ class CodeBattles(
         loop = asyncio.get_event_loop()
         loop.run_until_complete(self._start_simulation_async(*args, **kwargs))
 
+    def _start_simulation_from_file(self, contents: str):
+        loop = asyncio.get_event_loop()
+        loop.run_until_complete(self._start_simulation_from_file_async(contents))
+
+    async def _start_simulation_from_file_async(self, contents: str):
+        from js import document
+
+        try:
+            simulation = Simulation.load(str(contents))
+            navigate(
+                f"/simulation/{simulation.map}/{'-'.join(simulation.player_names)}"
+            )
+            show_alert(
+                "Loaded simulation file!",
+                f"{', '.join(simulation.player_names)} competed in {simulation.map} at {simulation.timestamp}",
+                "blue",
+                "fa-solid fa-file-code",
+                0,
+            )
+            if simulation.game != self.__class__.__name__:
+                show_alert(
+                    "Warning: game mismatch!",
+                    f"Simulation file is for game {simulation.game} while the website is running {self.__class__.__name__}!",
+                    "yellow",
+                    "fa-solid fa-exclamation",
+                    0,
+                )
+            if simulation.version != self.configure_version():
+                show_alert(
+                    "Warning: version mismatch!",
+                    f"Simulation file is for version {simulation.version} while the website is running {self.configure_version()}!",
+                    "yellow",
+                    "fa-solid fa-exclamation",
+                    0,
+                )
+            while document.getElementById("loader") is None:
+                await asyncio.sleep(0.01)
+            if not hasattr(self, "_initialized"):
+                self._initialize()
+            self.map = simulation.map
+            self.map_image = await download_image(
+                self.configure_map_image_url(simulation.map)
+            )
+            self.player_names = simulation.player_names
+            self.background = False
+            self.console_visible = True
+            self.verbose = False
+            self._initialize_simulation(
+                ["" for _ in simulation.player_names], simulation.seed
+            )
+            self._decisions = simulation.decisions
+            self._logs = simulation.logs
+            self.canvas = GameCanvas(
+                document.getElementById("simulation"),
+                self.configure_board_count(),
+                self.map_image,
+                document.body.clientWidth - 440,
+                document.body.clientHeight - 280,
+                self.configure_extra_width(),
+                self.configure_extra_height(),
+            )
+            document.getElementById("loader").style.display = "none"
+            await self.setup()
+            self.render()
+        except Exception as e:
+            print(e)
+
     @web_only
     async def _start_simulation_async(
         self,
@@ -478,6 +638,7 @@ class CodeBattles(
         background: bool,
         console_visible: bool,
         verbose: bool,
+        seed="",
     ):
         from js import document
         from pyscript import workers
@@ -497,7 +658,7 @@ class CodeBattles(
             self.background = background
             self.console_visible = console_visible
             self.verbose = verbose
-            self._initialize_simulation(player_codes)
+            self._initialize_simulation(player_codes, None if seed == "" else int(seed))
 
             if not self.background:
                 self.canvas = GameCanvas(
@@ -507,7 +668,9 @@ class CodeBattles(
                     document.body.clientWidth - 440
                     if console_visible
                     else document.body.clientWidth - 40,
-                    document.body.clientHeight - 280,
+                    document.body.clientHeight - 280
+                    if console_visible
+                    else document.body.clientHeight - 160,
                     self.configure_extra_width(),
                     self.configure_extra_height(),
                 )
@@ -521,11 +684,11 @@ class CodeBattles(
                 document.getElementById("loader").style.display = "none"
                 self.render()
 
-                self._worker = await workers["worker"]
-                self._worker.update_step = self._update_step
-                self._worker._run_webworker_simulation(
-                    map, json.dumps(player_names), json.dumps(player_codes)
-                )
+            self._worker = await workers["worker"]
+            self._worker.update_step = self._update_step
+            self._worker._run_webworker_simulation(
+                map, json.dumps(player_names), json.dumps(player_codes), self._seed
+            )
 
             if self.background:
                 await self._play_pause()
@@ -533,22 +696,39 @@ class CodeBattles(
             traceback.print_exc()
 
     def _update_step(self, decisions_str: str, logs_str: str, is_over_str: str):
-        from js import document
+        from js import window, document
 
+        now = time.time()
         decisions = base64.b64decode(str(decisions_str))
         logs: list = json.loads(str(logs_str))
         is_over = str(is_over_str) == "true"
 
         self._decisions.append(decisions)
         self._logs.append(logs)
-        self._webworker_frame += 1
+
+        if is_over:
+            try:
+                simulation = Simulation(
+                    self.map,
+                    self.player_names,
+                    self.__class__.__name__,
+                    self.configure_version(),
+                    datetime.datetime.now(),
+                    self._logs,
+                    self._decisions,
+                    self._seed,
+                )
+                window.simulationToDownload = simulation.dump()
+                show_download()
+            except Exception as e:
+                print(e)
 
         render_status = document.getElementById("render-status")
         if render_status is not None:
             render_status.textContent = (
-                "Rendering: Complete!"
+                f"Rendering: Complete! ({int(now - self._start_time)}s)"
                 if is_over
-                else f"Rendering: Frame {self._webworker_frame}"
+                else f"Rendering: Frame {len(self._decisions)} ({int(now - self._start_time)}s)"
             )
 
     def _get_initial_player_globals(self, player_codes: List[str]):
@@ -565,8 +745,8 @@ class CodeBattles(
                 "context": context,
                 **self.get_api().__dict__,
             }
-            | self.configure_bot_globals()
-            for context in contexts
+            | self.configure_bot_globals(player_index)
+            for player_index, context in enumerate(contexts)
         ]
         for index, api_code in enumerate(player_codes):
             if api_code != "" and api_code is not None:
@@ -627,7 +807,9 @@ class CodeBattles(
             document.body.clientWidth - 440
             if self.console_visible
             else document.body.clientWidth - 40,
-            document.body.clientHeight - 280,
+            document.body.clientHeight - 280
+            if self.console_visible
+            else document.body.clientHeight - 160,
         )
         if not self.background:
             self.render()
@@ -638,19 +820,20 @@ class CodeBattles(
         from pyscript.ffi import create_proxy
 
         if not self.over:
-            if len(self._decisions) == 0:
+            if len(self._decisions) == self._decision_index:
                 print("Warning: sleeping because decisions were not made yet!")
                 setTimeout(create_proxy(self._step), 100)
                 return
             else:
-                logs = self._logs.pop(0)
+                logs = self._logs[self._decision_index]
                 for log in logs:
                     console_log(
                         -1 if log["player_index"] is None else log["player_index"],
                         log["text"],
                         log["color"],
                     )
-                self.apply_decisions(self._decisions.pop(0))
+                self.apply_decisions(self._decisions[self._decision_index])
+                self._decision_index += 1
 
         if not self.over:
             self.step += 1
@@ -661,9 +844,18 @@ class CodeBattles(
             set_results(
                 self.player_names, self._eliminated[::-1], self.map, self.verbose
             )
+            if not self.background:
+                self.render()
 
         if not self.background:
-            self.render()
+            if self._since_last_render >= self.configure_render_rate(
+                self._get_playback_speed()
+            ):
+                self.render()
+                self._since_last_render = 1
+            else:
+                self._since_last_render += 1
+
             if (
                 self.over
                 and "Pause" in document.getElementById("playpause").textContent

package/dist/code_battles/utilities.py

@@ -79,6 +79,28 @@ def set_results(player_names: List[str], places: List[int], map: str, verbose: b
             print(e)
 
 
+@web_only
+def show_download():
+    from js import window
+
+    if hasattr(window, "showDownload"):
+        try:
+            window.showDownload()
+        except Exception as e:
+            print(e)
+
+
+@web_only
+def navigate(route: str):
+    from js import window
+
+    if hasattr(window, "_navigate"):
+        try:
+            window._navigate(route)
+        except Exception as e:
+            print(e)
+
+
 @web_only
 def download_json(filename: str, contents: str):
     from js import window

package/dist/esm/index.js

@@ -1,6 +1,7 @@
 import '@mantine/core/styles.css';
 import '@mantine/dates/styles.css';
 import '@mantine/notifications/styles.css';
+import '@mantine/dropzone/styles.css';
 import { TextInput, Button, Alert, Slider, Box, Select, NumberInput, Table, Badge, Autocomplete, Loader, MantineProvider } from '@mantine/core';
 import { TimeInput, DatesProvider } from '@mantine/dates';
 import { useColorScheme, useViewportSize } from '@mantine/hooks';
@@ -9,7 +10,8 @@ import { initializeApp } from 'firebase/app';
 import { onAuthStateChanged, signInWithEmailAndPassword, signOut, getAuth } from 'firebase/auth';
 import { onSnapshot, refEqual, doc, getDoc, setDoc, Timestamp, getFirestore } from 'firebase/firestore';
 import React, { useEffect, useReducer, useCallback, useMemo, createContext, useContext, useState, useRef, cloneElement, Component, createElement } from 'react';
-import { useNavigate, useLocation, useParams, Routes, Route, BrowserRouter } from 'react-router-dom';
+import { useNavigate, useLocation, useParams, useSearchParams, Routes, Route, BrowserRouter } from 'react-router-dom';
+import { Dropzone } from '@mantine/dropzone';
 import { jsx } from 'react/jsx-runtime';
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
@@ -407,21 +409,30 @@ const toPlacing = (n) => {
     }
     return n.toString() + DIGITS[n % 10];
 };
-const runNoUI = (map, apis, playerBots, verbose) => {
+const runNoUI = (map, apis, playerBots, seed, verbose) => {
     const players = playerBots.map((api) => (api === "None" ? "" : apis[api]));
-    tryUntilFailure(() => 
+    tryUntilSuccess(() => 
     // @ts-ignore
-    window._startSimulation(map, players, playerBots, true, false, verbose));
+    window._startSimulation(map, players, playerBots, true, false, verbose, seed));
 };
-const tryUntilFailure = (f, timeout = 500) => {
+const tryUntilSuccess = (f, timeout = 500) => {
     try {
         f();
     }
     catch (error) {
         console.log("Failed, waiting for timeout...", error === null || error === void 0 ? void 0 : error.message);
-        setTimeout(() => tryUntilFailure(f, timeout), timeout);
+        setTimeout(() => tryUntilSuccess(f, timeout), timeout);
     }
 };
+const downloadFile = (filename, mimeType, contents) => {
+    const a = document.createElement("a");
+    a.style.display = "none";
+    document.body.appendChild(a);
+    a.href = `data:${mimeType};charset=utf-8,${encodeURIComponent(contents)}`;
+    a.download = filename;
+    a.click();
+    document.body.removeChild(a);
+};
 
 const useLocalStorage = ({ key, defaultValue, }) => {
     const [value, setValue] = useState(getLocalStorage(key, defaultValue !== null && defaultValue !== void 0 ? defaultValue : null));
@@ -2491,6 +2502,10 @@ const RunSimulationBlock = () => {
         key: "Player Bots",
         defaultValue: ["None", "None"],
     });
+    const [seed, setSeed] = useLocalStorage({
+        key: "Seed",
+        defaultValue: "",
+    });
     const [runningNoUI, setRunningNoUI] = useState(false);
     const [runningNoUIN, setRunningNoUIN] = useState({});
     const navigate = useNavigate();
@@ -2499,15 +2514,18 @@ const RunSimulationBlock = () => {
         remaining = Math.max(...Object.values(runningNoUIN));
     }
     const run = () => {
-        navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}`);
+        // @ts-ignore
+        window._isSimulationFromFile = false;
+        navigate(`/simulation/${map.replaceAll(" ", "-")}/${playerBots.join("-")}?seed=${seed}`);
     };
     const startRunNoUI = () => {
         setRunningNoUI(true);
-        runNoUI(map, apis, playerBots, true);
+        runNoUI(map, apis, playerBots, seed.toString(), true);
     };
     const startRunNoUIN = (n) => {
+        setLocalStorage("Results", {});
         setRunningNoUIN({ [n.toString()]: n });
-        runNoUI(map, apis, playerBots, false);
+        runNoUI(map, apis, playerBots, seed.toString(), false);
     };
     useEffect(() => {
         // @ts-ignore
@@ -2561,7 +2579,7 @@ const RunSimulationBlock = () => {
                 setLocalStorage("Results", {});
             }
             else {
-                runNoUI(map, apis, playerBots, false);
+                runNoUI(map, apis, playerBots, seed.toString(), false);
             }
         }
     }, [runningNoUIN]);
@@ -2572,6 +2590,7 @@ const RunSimulationBlock = () => {
                 }
             } }),
         React.createElement(BotSelector, { playerCount: playerCount, setPlayerCount: setPlayerCount, playerBots: playerBots, setPlayerBots: setPlayerBots, apis: apis }),
+        React.createElement(NumberInput, { leftSection: React.createElement("i", { className: "fa-solid fa-dice" }), label: "Randomness Seed", min: 0, value: seed, onChange: setSeed }),
         React.createElement(Button.Group, { mt: "xs" },
             React.createElement(Button, { variant: "default", w: "50%", leftSection: React.createElement("i", { className: "fa-solid fa-play" }), onClick: run }, "Run"),
             React.createElement(Button, { variant: "default", w: "50%", leftSection: React.createElement("i", { className: "fa-solid fa-forward" }), onClick: startRunNoUI, loading: runningNoUI || loading }, "Run (No UI)")),
@@ -2581,7 +2600,31 @@ const RunSimulationBlock = () => {
         remaining !== 0 && (React.createElement("p", { style: { textAlign: "center", marginTop: 10 } },
             "Remaining Simulations: ",
             remaining)),
-        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" })));
+        React.createElement("p", { style: { textAlign: "center", display: "none", marginTop: 10 }, id: "noui-progress" }),
+        React.createElement(Dropzone, { mt: "xs", multiple: false, onDrop: (files) => __awaiter(void 0, void 0, void 0, function* () {
+                if (files.length !== 1) {
+                    return;
+                }
+                const file = files[0];
+                const text = yield file.text();
+                // @ts-ignore
+                window._navigate = navigate;
+                // @ts-ignore
+                window._isSimulationFromFile = true;
+                tryUntilSuccess(() => {
+                    // @ts-ignore
+                    window._startSimulationFromFile(text);
+                });
+            }), style: {
+                textAlign: "center",
+                paddingTop: 20,
+                paddingBottom: 20,
+                paddingLeft: 10,
+                paddingRight: 10,
+            } },
+            React.createElement("span", null,
+                React.createElement("i", { className: "fa-solid fa-file-code", style: { marginRight: 10 } }),
+                "Drag a simulation file here or click to select a file to run a simulation from a file"))));
 };
 
 const TournamentBlock = ({ pointModifier, inline, title }) => {
@@ -15899,13 +15942,19 @@ const Simulation = () => {
     const [apis, loading] = useAPIs();
     let { map, playerapis } = useParams();
     const location = useLocation();
+    const [searchParams] = useSearchParams();
     const [winner, setWinner] = useState();
+    const [downloadBytes, setDownloadBytes] = useState(false);
     const navigate = useNavigate();
     const colorScheme = useColorScheme();
     const showcaseMode = location.search.includes("showcase=true");
     useEffect(() => {
         n((engine) => __awaiter(void 0, void 0, void 0, function* () { return yield loadFull(engine); }));
         // @ts-ignore
+        window.showDownload = () => {
+            setDownloadBytes(true);
+        };
+        // @ts-ignore
         window.showWinner = (winner, verbose) => {
             if (admin) {
                 setWinner(winner);
@@ -15935,10 +15984,16 @@ const Simulation = () => {
     const playerNames = (_a = playerapis === null || playerapis === void 0 ? void 0 : playerapis.split("-")) !== null && _a !== void 0 ? _a : [];
     const players = playerNames.map((api) => (api === "None" ? "" : apis[api]));
     useEffect(() => {
-        if (!loading && players && playerapis) {
-            tryUntilFailure(() => 
+        var _a;
+        if (!loading &&
+            players &&
+            playerapis &&
+            // @ts-ignore
+            window._isSimulationFromFile !== true) {
+            const seed = (_a = searchParams.get("seed")) !== null && _a !== void 0 ? _a : "";
+            tryUntilSuccess(() => 
             // @ts-ignore
-            window._startSimulation(map, players, playerNames, false, !showcaseMode, true));
+            window._startSimulation(map, players, playerNames, false, !showcaseMode, true, seed));
         }
     }, [loading]);
     const newRank = getRank(getLocalStorage("Cached tournament/info"), winner, getLocalStorage("Point Modifier")) + 1;
@@ -16021,7 +16076,11 @@ const Simulation = () => {
                             React.createElement("span", { id: "render-status", style: { marginRight: 10 } }),
                             React.createElement(NumberInput, { id: "breakpoint", label: "Breakpoint", min: 0, leftSection: React.createElement("i", { className: "fa-solid fa-stopwatch" }), display: "inline-block", maw: "35%", mr: "xs" }),
                             React.createElement(Button, { style: { flex: "none" }, my: "xs", w: 100, leftSection: React.createElement("i", { className: "fa-solid fa-wand-magic" }), color: "grape", id: "step", mr: "xs", radius: "20px" }, "Step"))),
-                        React.createElement(PlayPauseButton, null)),
+                        React.createElement(PlayPauseButton, null),
+                        downloadBytes && (React.createElement(Button, { ml: "xs", radius: "20px", leftSection: React.createElement("i", { className: "fa-solid fa-download" }), color: "blue", onClick: () => downloadFile(`${playerNames.join("-")}.btl`, "text/plain", 
+                            // @ts-ignore
+                            window.simulationToDownload) }, "Download Simulation"))),
+                    showcaseMode && React.createElement("span", { id: "render-status" }),
                     React.createElement("p", { style: { margin: 0 } }, "Playback Speed"),
                     React.createElement(Slider, { style: { flex: "none" }, mb: 30, w: 500, maw: "85%", min: -2, defaultValue: 0, marks: [
                             { value: -2, label: "1/4" },

package/dist/esm/types/index.d.ts

@@ -2,6 +2,7 @@ import "@fortawesome/fontawesome-free/css/all.css";
 import "@mantine/core/styles.css";
 import "@mantine/dates/styles.css";
 import "@mantine/notifications/styles.css";
+import "@mantine/dropzone/styles.css";
 import "prismjs/plugins/line-numbers/prism-line-numbers.css";
 import "prismjs/themes/prism.css";
 import "./index.css";

package/dist/esm/types/utilities.d.ts

@@ -10,5 +10,6 @@ export declare const getRank: (tournamentInfo: any, team: string, pointModifier:
 export declare const updatePointModifier: () => void;
 export declare const toPlacing: (n: number) => string;
 export declare const zeroPad: (s: string, l: number) => string;
-export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], verbose: boolean) => void;
-export declare const tryUntilFailure: (f: () => void, timeout?: number) => void;
+export declare const runNoUI: (map: string, apis: Record<string, any>, playerBots: string[], seed: string, verbose: boolean) => void;
+export declare const tryUntilSuccess: (f: () => void, timeout?: number) => void;
+export declare const downloadFile: (filename: string, mimeType: string, contents: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-battles",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "A library for building interactive competitive coding battles",
   "repository": "https://github.com/noamzaks/code-battles",
   "homepage": "https://code-battles.readthedocs.org",
@@ -38,11 +38,12 @@
     "tsparticles": "^3.5.0"
   },
   "peerDependencies": {
-    "@mantine/core": "^7.13.3",
-    "@mantine/dates": "^7.13.3",
-    "@mantine/hooks": "^7.13.3",
-    "@mantine/notifications": "^7.13.3",
-    "firebase": "^10.14.1",
+    "@mantine/core": "^7.13.4",
+    "@mantine/dates": "^7.13.4",
+    "@mantine/dropzone": "^7.13.4",
+    "@mantine/hooks": "^7.13.4",
+    "@mantine/notifications": "^7.13.4",
+    "firebase": "^11.0.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.27.0"
@@ -56,7 +57,7 @@
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "chokidar-cli": "^3.0.0",
-    "rollup": "^4.24.3",
+    "rollup": "^4.24.4",
     "rollup-plugin-copy": "^3.5.0",
     "rollup-plugin-dts": "^6.1.1",
     "rollup-plugin-import-css": "^3.5.6",