Skip to main content
This repository contains the s&box engine source. Contributions here affect the engine itself — things like the scene system, physics, networking, and scripting infrastructure. If you found a bug in a game or addon, report it to the author of that project, not here.

Ways to contribute

Report a bug

Open an issue on GitHub. Be thorough — steps to reproduce, what you expected, and what happened.

Request a feature

Propose a feature by opening an issue. Explain what it adds and why it’s needed before starting work.

Submit a fix

Fix a bug or implement an accepted feature request. Reference the related issue in your pull request.

Write unit tests

Unit tests are welcomed alongside bug fixes and new features wherever applicable.

Security issues

Do not open a public GitHub issue for security exploits. Report them privately at facepunch.com/security.

Before you open a pull request

  • Check that the issue or feature hasn’t already been reported or requested.
  • For new features, make sure there’s an accepted proposal issue before you start coding.
  • Read the contribution guidelines for code style, commit, and PR standards.

Build docs developers (and LLMs) love