BattleBoxes_Multiplayer

BattleBoxes, but it's multiplayer! Large maps and free-for-all playing!

This repository has been archived!

How to Play

Installation

I cannot distribute node.js as I do not own any rights to it, but visiting their website you can download the latest (not LTS) and install it, checking the box "Automatically install necessary tools". Wait for the installation to finish, then download the code and unzip it into any folder. Run Config.bat or Config.sh (depending on system). Then simply double-click on Start.bat or Start.sh and the server is running!

To stop the server, type "stop" into the server console.

Joining the Game

Once the server is started, you can find your computer's name (available in Windows>System>About as "Device name"), or simply search what's my ip or click the link. The server console will tell you what port to visit and you can type either the ip address or computer name on the client side connected to the same network as the host and then followed by a ":" and then the port number. Example: 111.22.33.444:2000 or hostcomputer:1100

Gameplay

Visit the wiki for more information.

Troubleshooting

My Server Crashed

In the case that your server crashes, stop all other instances of the game and locate PORTS.txt in "/server/PORTS.txt", and set it to zero. Then go to the GitHub repository and submit a bug report with a screenshot of the console if applicable.

I can't Connect to the Server (ERROR_Connection_Refused)

If you can't connect to the server, verify that:

The server is running
You have entered the correct port number
You have entered the correct computer name or IP adress
You are connected to the same WiFi network as the server If you have verified all four of the above, try restarting the server. If your server is running on a dedicated server (like Heroku) check that your link is correct.
The Server is Slow

There is nothing we can do about this. It could be your connection speed or a slow server unable to run the game at full speed. Press "backslash" ("\") ingame and in the top-right corner it should list TPS and Ping. If your Ping is high then that is likely the source of your lag. If you TPS is low then the server is lagging. If you don't see a TPS or ping indicator it's probably because that feature hasn't been added yet. Check that there is nothing eating your computer's resources by opening Task Manager (Windows) by pressing Ctrl+Shift+Esc.

If you can't resolve your problem after trying these solutions or your problem is not on this page, go to the Issues page and submit a bug report.

Changelog

Version	Changes
0.1.0	Added menu with Start, Settings, Achievements, and Exit buttons Added basic code for server to get the ID of a player Implemented a login form, no accounts yet
0.1.1	Implemented a pixel font Added exit button when entering Settings/Achievements menu Moved menu script to menu.js Moved styling to style.css
0.2.0	Added multiplayer aspect to game Added player input and movement Added multiplayer display functionality Added entity.js for player functions
0.2.1	Added start files Replaced the old port setting system with automatic port setting system Updated SECURITY.md with the correct link
0.3.0	Added bullets Merged server and client code Added background music files Added map and collision map files Updated README.md Fixed PORTS.txt Other small tweaks
0.3.1	Fixed bug that prevented the server from sending information to clients Fixed Favicon.ico Added colors to Players and Bullets Limited player count to 16
0.3.2	Fixed README.md and SECURITY.md Fixed server version reporting Fixed PORTS.txt
0.4.0	Added map collisions to player Made camera scroll to keep player on screen Added maps Fixed a lot of version labels Added Config.bat and Config.sh to help setup Added debug screen Added framework for ingame menu Cleaned up code Many other tiny tweaks
0.4.1	Fixed bullet collisions and added player damage Fixed most player color dupes(leaving would cause new players to have duplicated colors) Updated maps Added community submission forms Fixed README.md Some changes to code formatting
0.4.2	Fixed player color dupe bug Patched major security vulnerability that allowed clients to see all other client socket ids Partially fixed collision glitching (Issue #14) Added friction to walls Added announcements Increased bullet visibility Updated maps again Updated debug screen Updated JavaScriptDisabled text Optimized some code (collisions were left unoptimized) Fixed some other bugs
0.5.0	Added a fade effect Created a round system Added a lobby Updated maps (fixed SUBSCRIBE floating bug) Added a lot of spawnpoints Added ingame music Added arrowkey support (and fixed CAPSLOCK bug) (Issue #21) Added volume sliders (kind of) Created index.js for general functions/handlers Added a LOT of semicolons
0.5.1	Added credits/license pages Fixed header shifting on debug Fixed map randomization Added another map Partially fixed canvas blurring (Issue #26) Other small changes
0.5.2	Gave player ability to leave game Sort of added game endings when a player reached 10 points Clamped camera to edges of map Formatted settings Replaced the earpain start sound with a much less painful one Fixed announcements double-posting (Issue #20) Fixed spawnpoints Removed a bunch of useless semicolons
0.5.3	Patched severe security vulnerability allowing code injection Fixed infinite one-player round loop bug (Issue #28) Mostly fixed invisible map issues (Pages are only slow to load now) (Issue #25) Fixed shooting during countdown Fixed waiting for server message Prevented whitespaces in names Fixed crashes from running out of spawnpoints by adding more spawnpoints (Issue #31) Improved corner collisions (Issue #15) Fixed multiple other mini-issues
0.5.4	Improved corner collisions again and reduced chances of glitching out of the lobby (Issue #15) Improved wall jumping (you no longer wall jump by walking into walls)
0.6.0	Added account system Fixed script double-loading Fixed aim offset Added collision debug Fixed player infinite death bug
0.6.1	Fixed debug rendering Fixed collision rubberbanding (Issue #15) Added a scoreboard Fixed random errors in client console Replaced black win screen with a more finished colored page
0.6.2	Added more settings Migrated to PostGreSQL database for login Added "change password" option Fixed some map blurring (Issue #26) Fixed some spelling mistakes Made server close when an error occurs
0.6.3	Fixed critical instant-crash on startup (Issue #43)
0.7.0	Added achievements system and some achievements Added ingame menus Improved login database system Fixed server crash when changing passwords (Issue #44) Fixed bullet damage spam (Issue #29) Centered the ingame menu (and added backshade) (Issue #42) Prevented double-sign-in Removed item focus highlight around buttons Tweaks to game code formatting
0.7.1	Fixed critical server lag and crash after many bullets are fired and BULLET_LIST is not cleared (Issue #46) Added ping counter Fixed a hyperlink in README.md Fixed server crash when something
0.7.2	Added UI for achievements Fixed typo that allowed players to sign up with the same username as another and soft-lock their account Fixed TPS counter being multiplied by the number of players Other small fixes and polishing tweaks
0.8.0	Fixed MAJOR security vulnerability allowing people to change other people's passwords (Issue #47) Temporarily fixed huge bug linking all players achievements with hardcoding, when a better solution is found it will be replaced and the issue closed (Issue #50) Added countdown text Added win screen Added "fullscreen" option (broken) Added "back" option when cannot join game Added another confirmation dialogue for deleting accounts. Other aesthetic improvements Fixed offset in score box Centered loading screen text
0.8.1	Compressed map images for better loading with lower bandwidth Added another achievement Added transition between login and menu Fixed lobby deaths Fixed game soft-locking when one player is in game and they die Fixed ingame achievements menu Fixed win screen glitching Improved win screen with winner's name Fixed signup with illegal characters Lowered maximum username character limit to 20 Added debug console
0.8.2	Added more maps Randomized spawn points Improved corner collisions (Issue #52) Added support for Heroku deploy Fixed typo disabling map loading when not run on localhost: Styled achievement banners Cleaned up code
1.0.0	RELEASE 1.0.0 - The game is now no longer incomplete and is ready to play with the full experience. Encrypted passwords and database login Fixed players getting stuck on corners (Issue #53) Fixed spawning outside of map
1.0.1	Fixed achievements not saving Fixed no fading between rounds
1.1.0	Added some sort of bot character (Currently does not pathfind) Added "quality" slider to settings (disabled currently) Moved drawing from server TPS to client (60 or 30 FPS) and added FPS option Fixed transparent scoreboard after playing a game (Issue #56) Centered winner name text Randomized spawnpoints on Platforms and Battlefield Fixed force leave on win screen (Issue #58) Fixed typo in achievements (Issue #63) Improved camera movement Minor optimizations
1.1.1	Added ingame debug console (Add your name to ops.json) Added Content Security Policy Added MeadowGuarder ad Fixed non-ingame players being displayed (Issue #68) Fixed username and password input alignment Fixed more minibugs and nuisances
1.1.2	Hid copyright disclaimer and github link during games Added chat Fixed non-ingame players displaying after leaving game (Issue #69) Fixed crashes after leaving and disconnecting too quickly (Issue #72) Added support for Heroku deploy Moved Meadow Guarder ad to "Meadow Guarder" section Updated server logging Fixed getting stuck in collisions Fixed PLAYER_LIST not clearing after rounds and resulting in "ghost players" (Issue #73)
1.2.0	Added lootboxes with placeholder images (can only be spawned via commands) Implemented local settings saving via cookies Removed right click menu Fixed non-updating statistics (Issue #85) Improved chat (and added anti-spam and anti-advertising) Synced bullets on client with server Optimized and rewrote some client-side code Removed random exclamation mark (Issue #80) Mass glitch-fix
1.2.1	Added map name display at round start Randomly spawned lootboxes Added textures to lootbox Added "slowness" effect to lootbox rng Added achievements for loot boxes Changed banner outline from dark grey to black Fixed win screen flashing when zooming in and out (Issue #102) Improved page loading Increased spam cooldown
1.2.2	Added secondary attacks (found in loot boxes) Added golden, super, laser, and smart variants of bullets Added "The Golden Bullet" achievement Added "yeet" attack Fixed win screens on players who are not in game (Issue #124) Fixed instant win caused by un-reset scoreboards (Issue #120) Hid play again button on game join (Issue #126) Fixed two players winning (Issue #125) Fixed broken divs when in win screen (Issue #121) Note: Pathfind bullets do not work
1.3.0	Added "Rain" map by The-God-Coder Added "The Labyrinth" map Cleared secondary attack each round (Issue #129) Improved buff timeouts
1.3.1	Re-enabled CSP Implemented pathfinding part of pathfinding bullets Fixed crashes when a player obtains an expireable effect Fixed loot boxes in lobby (Issue #131)
1.3.2	Fixed render quality slider Reduced "choppy" camera effect Fixed innaccurate FPS counter (NOTE:FPS counter counts your browser's fps, not the game fps. Use DFPS to count ingame framerate) Made debug draw on top of game Fixed duplicated player colors(Issue #134) Fixed multi-buff/debuff wierdness (Issue #135) Fixed bullets homing on dead players (Issue #137) Changed banners piling on top of one another
1.4.0	Implemented preliminary bot pathfinding Fixed incorrect collision rebound (Issue #150) Added loading bars Switched banners to divs Waited for images to load (Issue #144) Fixed blurry pixel ratio after zooming in (Issue #149) Fixed blurry canvas (Issue #26)
1.4.1	Fixed bots not broadcasting their deaths Fixed uncleared banners, bullets, and unreset maps when joining game (Issue #153) Changed lootbox stacking to effect stacking (Issue #155) Fixed autorespawn hack (Issue #154) Fixed tiny countdown text (Issue #152) Fixed random errors Added coloration to server logging A lot of minor tweaks
1.4.2	Fixed multiple bot-related issues Fixed bots violating 3-second no-move period (Issue #168) Fixed crashes when bots get lootboxes Optimized bots Fixed fullscreen
1.4.3	Added particles Added death flash and animations Fixed lootbox timers again (Issue #181) Fixed transparent win screen (Issue #180) Fixed double secondary banners (Issue #179) Fixed entities being drawn 1 tick ahead of map (Issue #179) Added timers to buff banners
1.4.4	Security Update (Old versions are now broken)
1.4.5	Added logfile

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Full license can be found in the LICENSE file.

Credits

Contributors:

Resources:

Various articles on the internet
ScriptersWar tutorial series

Want to Contribute?

If you would like to contribute to this game, visit the Github where you can send a pull request with an application request stating your reason to create a pull request in the "comments" section along with it. If you would like to submit a suggestion then submit it via this form. Please refrain from modifying any code that is related to the database, global data structure, or encryption. Modifying such code may and can result in: Account and/or database corruption; data loss; violation of the security policy.

Games by Radioactive64 and Maitian:

spsquared / BattleBoxes_Multiplayer

readme