SaltyChips-EightPlayers icon

EightPlayers

Online lobbies for up to 8 players with 8 teams and 8+ slime colors. Invite friends through Steam as usual. Everyone in the lobby needs the mod.

Last updated a week ago
Total downloads 203
Total rating 1 
Categories Mods
Dependency string SaltyChips-EightPlayers-1.2.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

EightPlayers

Play Bopl Battle online with up to 8 players, 8 teams and 8 slime colors through this lightweight mod.

Features

  • Steam lobbies hold 8 people instead of 4. Invite friends from the Steam overlay or the in-game invite button, or have them right-click you in Steam and choose Join Game.
  • 4 extra teams, so you can play free-for-all with 8, 4v4, 2v2v2v2, or any other split.
  • Extra slime colors are from the game's own colors, so every player can have a unique color.
  • The online lobby shows all 7 remote players and you can change the scale in the config.
  • Teams 5–8 get their own spawn points on each map's platforms, away from the other spawns.

Requirements

  • Everyone in the lobby must have this mod installed (same version). Players without the mod will crash or desync when they see a 5th player, team 5+ or one of the new colors.
  • BepInExPack (installed automatically by r2modman / Thunderstore Mod Manager).

Compatibility

  • Games with 4 or fewer players run the game's original network code unchanged.
  • The mod only uses Harmony patches (no files replaced), so it can be combined with other BepInEx mods. Avoid other mods that also change the player/team count
  • It turns off Bopl Battle's public matchmaking. Friend invites still work.
  • Map mods: extra spawn points are worked out from whatever platforms the level has, so maps added by other mods get them too. Aqua Maps is supported specifically.
  • Replays aren't saved for games with more than 4 players, because the game's replay format only has room for 4.

Config

BepInEx/config/com.eightplayers.boplbattle.cfg

Setting Default Description
Lobby UI / BoxScaleOverride 0 Scale of the character boxes in the online lobby. 0 picks a size automatically so the 7 remote player boxes fit next to yours.

How it works (for modders)

  • The 105-byte start packet only has room for players 1–4. The host sends an extra 59-byte packet with players 5–8 just before it, over the same reliable connection, so it always arrives first.
  • When a game has more than 4 players, the lockstep loop (Host.Update) switches to a port that stores 8 input slots per frame instead of the 4-slot InputPacketQuad.
  • The game reads in-game acknowledgements from players 5 and 6 as lobby ping/ack messages. Players 5–8 send theirs with the top bit of the player id set, and the receiver strips it again.
  • If a round ends at random for one player, search their BepInEx/LogOutput.log for Exception caught in simulation: the game ends the round locally when any code throws inside a simulation tick, and the line names the code that threw.