bsManager

This is an unofficial Python API for BombSquad making stuff easier to do.

Usage

Here is a small example to get started:

>>> from manager import BsManager

# Connect to BombSquad's telnet session.
# Note that the port is for your telnet server and not for the actual game instance.
>>> man = BsManager(("127.0.0.1", 43250))

# Return a list of player dictionaries currently playing the game round.
>>> man.getPlayers()
[{'account': 'Android12345678',
  'name': 'Willy',
  'playerID': 5,
  'profiles': {'__account__': {'color': [1, 1, 0],
    'highlight': [1, 0.15, 0.15],
    'global': False,
    'character': 'Zoe',
    'icon': '\ue01e'},
   'Willy': {'color': [1, 0.15, 0.15],
    'highlight': [1, 1, 1],
    'global': False,
    'character': 'Zoe',
    'icon': '\ue01e'}},
  'clientID': 192,
  'team': 1},

 {'account': 'PC123456',
  'name': 'Rico',
  'playerID': 9,
  'profiles': {'Chikoo': {'color': [0.1, 0.1, 1],
    'highlight': [0.4, 0.2, 0.1],
    'global': False,
    'character': 'Kronk',
    'icon': '\ue01e'},
   '__account__': {'color': [1, 1, 1],
    'highlight': [0.13, 0.13, 0.13],
    'global': False,
    'character': 'Spaz',
    'icon': '\ue01e'},
   'Rico': {'color': [1, 0.15, 0.15],
    'highlight': [1, 1, 0],
    'global': False,
    'character': 'Spaz',
    'icon': '\ue01e'}},
  'clientID': 217,
  'team': 1},

 {'account': 'VagrantPie123123',
  'name': 'Jack',
  'playerID': 15,
  'profiles': {'Jack': {'color': [0.13, 0.13, 0.13],
    'highlight': [1, 0.15, 0.15],
    'global': False,
    'character': 'Spaz',
    'icon': '\ue01e'},
   '__account__': {'color': [0.5, 0.25, 1.0],
    'highlight': [0.5, 0.25, 1.0],
    'character': 'Spaz'}},
  'clientID': 219,
  'team': 0},

 {'account': 'GamerUltraHundred',
  'name': 'Magua',
  'playerID': 20,
  'profiles': {'Magua': {'color': [0.13, 0.13, 0.13],
    'highlight': [1, 0.15, 0.15],
    'global': False,
    'character': 'Spaz',
    'icon': '\ue01e'},
   '__account__': {'color': [0.5, 0.25, 1.0],
    'highlight': [0.5, 0.25, 1.0],
    'character': 'Spaz'}},
  'clientID': 219,
  'team': 0}]

# I don't like Willy.
>>> man.kickByPlayerID(5)
# `kickByPlayerID()` takes an integer as playerID and kicks
# out the player.
# Note that if multiple controllers are attached to the
# same game from same client, all of the clients will be kicked.

# `kickByClientID()` on other hand takes the clientID to kick someone.
# Note that PlayerID and ClientID are different.

# Rico would do better with ice bombs.
>>> man.setBombType(9, "ice")
# All the powerups (player status effects) take in an integer which
# is the PlayerID.

# Increase blast radius to 6.5 for Jack's bombs.
>>> man.setBlastRadius(15, 6.5)

# Make Magua move around faster.
>>> man.speedup(20, True)

# Let's turn on slow motion for the current game round.
>>> man.slomo(True)

Documentation

Currently there is no proper documentation online. You can however, take a look in manager.py to understand what all various methods are available and what purpose they serve.