BYOND Build Mirror

Overview

This repository mirrors the downloadable installers and portable files from the official BYOND website, hosted on Cloudflare R2.

Mission Statement

This repository aims to mirror BYOND versions that are relevant to the larger SS13 community. For example, having a link for your players to download the recommended version of BYOND to play your servers on. This repository does not aim to provide an archive of every BYOND version ever.

'BYOND versions that are relevant' is defined as:

• The current version.txt, denoting the latest major.minor version and possibly the latest beta version on the next line.
• The last 2 stable major versions, including all minor versions.
• If there is a current beta version, all minor versions.

Additional versions are not supported due to:

• Maintainer overhead.
• I don't really want to encourage people to use ancient BYOND versions.

The files available are: XXX.YYYY_byond.exe, XXX.YYYY_byond.zip, XXX.YYYY_byond_linux.zip.

XXX and YYYY being the major and build versions, respectively. For example, 515.1647_byond.exe

YYYY can also be latest for the highest minor version of the major. For example, 515.latest_byond.exe.

_byondexe.zip and _byond_setup.zip are deemed not relevant.

Accessing the Mirrored Files

The files are available at:

https://byond-builds.dm-lang.org/{version}/{filename}

For example:

https://byond-builds.dm-lang.org/515/515.1647_byond.exe

This follows the same format as BYOND does.

Disclaimer & Warranty

• This README describes the supported offerings of the service.
• This repository may be force-pushed to and/or squashed at any time.
• A minimum of one month of notice will be given for any breaking changes.
  • This includes removing any prior BYOND version.
  • Notices will be given in the following:
    • coderbus's #tooling-questions discord channel.
    • A GitHub Discussion post in the Announcements category.
    • The root index.html page.
• It's common for BYOND versions to be completely broken. This mirror does not differentiate between broken versions in any way.
• Some BYOND versions lack linux releases, as they're client-only. These can be identified by the lack of the byond_linux.zip.
• I reserve the right to deal with malicious abuse of the mirror as I see fit.
• All these policies can change at any time, please contact ZeWaka on Discord if you seek changes.

For additional warranty and disclaimer information, please see the LICENSE.

License & Attribution

This project only provides a mirror of officially released software.

This mirror is not affiliated with nor endorsed by BYOND Software.

All .zip and .exe files served by this project are the property of BYOND Software.

All rights to these files belong to their respective owners.

All other project files are licensed under the MIT license.

---

Internal

To set the BYOND major versions targeted:

1. MAJOR_VERSIONS in scripts/sync_byond_to_r2.py
2. The version sections in public/index.html
3. The checked-in template file for each version, like public/516/index.html

Secrets:

• R2_ENDPOINT - Cloudflare R2 S3 endpoint, for example https://<account_id>.r2.cloudflarestorage.com
• R2_ACCESS_KEY_ID - R2 access key ID
• R2_SECRET_ACCESS_KEY - R2 secret access key
• R2_BUCKET - Bucket name to upload into
• TRACY_WORKFLOW_DISPATCH_TOKEN - GitHub token with perms to dispatch to spacestation13/byond-tracy-offset-extractor