BoxRun: practice box routes and speedruns

Practice box routes on the real Deadlock map against a ghost, then make your own and share them as a short code.
This project was coded using AI assistance. 

Share / download routes and race each other's times in the BoxRun Discord: discord.gg/YHgbS2TBqu

---

IF THE CONSOLE DOESN'T SHOW UP WITH F7, ENABLE "Dev command console" IN SETTINGS.

To use: open the console (F7) and type "map boxrun_midtown".

Known issues: a dash or ability you tap inside the start gate isn't in your ghost yet (a held one is). The safe ghost covers Abrams, Holliday and Lady Geist for now. Other heroes race the old ghost, whose boxes come back in about half a second. The first GO TO START after you pick a route can show PREPARING for a few seconds while the safe ghost is built. Ghosts don't replay Mirage's ultimate. If you see anything else, tell me the route and hero in the Discord!

---

What you can do

• Make a route in game: walk to each spot and place a checkpoint, then test it and set the times to beat (Eternus, Oracle, Initiate).
• Mark boxes that have to be broken, add notes, split it into legs, or run it with the Soul Urn.
• Run it against the clock. Every checkpoint shows your split, and the finish card shows your tier.
• Race a ghost: the route's maker, or your own best, replayed as the real hero.
• Share it with one short code, and anyone with the code can paste it in and race your ghost. LIST IN COMMUNITY puts it in the in-game list for everyone.
• Comes with sample routes: guided ones with a checkpoint at each turn, and open ones with marked boxes to break in any order. Plus two movement challenges.

Why I made it I'm learning Deadlock, and box runs were hard to learn from videos. I learn better hands-on, and some of my friends are learning too, so I made a way to build routes in game and share them.

Is it safe?

• It's one map file you load on your own. Normal matches never load it, and it doesn't change anything in them.
• No DLLs, no injection, nothing running outside the game.
• Your routes and times are saved on your PC, through a small BoxRun page in the game's own browser. They stay there until you press SHARE, which publishes that route and its ghost under a short code, so people you give the code to can load it. LIST IN COMMUNITY also shows the route, with its name and maker, in the in-game COMMUNITY list.
• BoxRun sends anonymous counts so I can see where new players get stuck and which routes get played. Once each: the first time the map loads, the menu shows, you start a run, finish one, finish one that counts, make a route or load a code, with the days since your first day and the minutes since your first load. Once a day you play: the days since your first day, whether it's your first day this week, and whether you came back the day after your first day or in your second week. After you play: how many runs you started, finished and got counted, how many of the counted ones were on sample, creator, community or your own routes, and the short code of each of those routes that has one, with how many runs and whether this PC sent that code before. Every count also carries BoxRun's version number. Nothing else: there's no ID, and they never include your routes, times, name or Steam ID. You can turn them off in OPTIONS. The menu also asks BoxRun's server for the route of the week, which counts how many players opened the menu each day, and checks routes you loaded for updates. Details at boxrun.gg/privacy.
• It uses the game's own Midtown, so it's a small download.

Install

• With Grimoire (or another mod manager): install it from this page, start Deadlock with "Launch Modded", open the console (F7) and type map boxrun_midtown. (If the console doesn't show up, enable "Dev command console" in settings.)
• By hand: see "BoxRun - how to install.txt" in the download.
• Optional, no console needed: also install MapList, after BoxRun (MapList hides maps installed after it). Then press Esc in the hideout: BoxRun is under CUSTOM MAPS, at the bottom of the friends column on the right. Click it to load.
• Give it up to a minute after you spawn in: the mod loads and the BoxRun menu appears in front of you. It can take longer on some PCs, so wait for the menu.
• If you close the menu, press 0 to bring it back, or type boxrun in the console. 6 restarts your run. Both keys are on by default, and HELP turns them off.
• After a Deadlock update, Grimoire may ask you to press Fix again. That's true for every Deadlock mod. 

Questions, bugs, routes: the BoxRun Discord, discord.gg/YHgbS2TBqu, and https://boxrun.gg.

Made by greenlittleapple