Skip to main content

Tools and interfaces for interacting with the BYOND game engine, adapted to Python 3.

Project description


A set of tools for BYOND-based games.


This is a toolkit for developers of BYOND-based games intended to do common, complex tasks that the engine itself does not currently possess. It also exposes common interfaces for developers wishing to obtain information from the BYOND object tree, maps, and DMIs.


  • Python 3

  • Pillow (fork of PIL)

  • numpy


The previous documentation is taking shape at This may be out of step with the newest version.

API Status

API Component






Object Tree





No commercial or official support is provided, but you are free to submit bug reports or harass Comic (ComicVG/ComicIronic) in #vgstation.

0.1.4 - 12/05/2020

  • Fixed use of deprecated & removed clock() function in the DMM library.

0.1.3 - 19/11/2016

  • Fixed an issue with the script-copying helper not forming bangs correctly on Windows.

0.1.2 - 19/11/2016

  • Modified get-dmi-data to output the PIL image’s md5 instead of Python’s default to-string behaviour.

0.1.1 - 19/11/2016

  • Fixed issue with binary strings preventing dmi header extraction.

  • Added single version value to setup.dmi for ease of use.

0.1.0 - 18/11/2016

  • Split get-dmi-data into two utilities - old header extraction is now under get-dmi-header, and get-dmi-data now produces a generated header.

0.0.1 - 18/11/2016

  • Started new fork of ByondTools with breaking changes planned.

  • Changed DMI’s get-dmi-data to write to stdout.

  • Updated code to compile under Python 3 - functionality not tested.

0.1.7 - 3/6/2015

  • Added pyparsing-based list() parser to DMM system

  • DMMFix lives again!

  • Move from print() to logging for console logging.

  • Renamed ss13_makeinhands to dmi_compile, now uses a dmi_config.yml file.

  • Fixed dmindent duplicating proc contents, cleaned out excessive newlines.

0.1.6 - 12/24/2014

  • Fixed completely broken map rendering system.

  • Repaired object tree generation

  • Fixed color support

0.1.5 - 6/18/2014

  • Emergency path fix for Linux

0.1.4 - 6/18/2014

  • Added dmm diff and patch commands for patching maps.

  • Added color name support to BYOND2RGBA. Should fix rendering maps on TG/NT/Bay.

  • Proper handling of nulls.

0.1.3 - 6/17/2014

  • Fixed broken post-install operation on Linux (sorry)

The following people have helped to make ByondTools possible:

  • NEXIS (N3X15)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BYONDToolsv3-0.1.4.tar.gz (64.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page