The sandbox game that allows you to manipulate physics objects. Widely considered to be the best Source Engine game in the world!
JBMod is available for free on Steam. Make sure to use the github branch for the latest updates.
JBMod uses Github as its official bug tracker and request tracker.
- If you have a bug, crash, or other issue, create a new Bug report.
- If you have a suggestion or request, create a new Feature request.
- Or if you want to fix it yourself, keep reading below!
Requirements:
- JBMod installed via Steam, on the
githubbranch - Visual Studio 2022 with the following workload and components:
- Desktop development with C++
- MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
- Windows 11 SDK (10.0.22621.0) or Windows 10 SDK (10.0.19041.1)
- Python 3.13 or later
Steps:
- Navigate to the
srcdirectory. - Run
createallprojects.batto generate the Visual Studio solution. - Open
everything.slnand build the solution (Build > Build Solution). - To run, set the client project (e.g.,
Client (JBMod)) as the startup project and start the debugger.
Requirements:
- JBMod installed via Steam, on the
githubbranch - Podman
Steps:
- Navigate to the
srcdirectory. - Run
./buildallprojectsto build against the Steam Runtime. - Launch the game from the
gamedirectory using the generated launcher (e.g.,./jbmod.sh).
This project uses GitHub Actions for continuous integration and deployment. The pipeline automatically builds for Windows and Linux and handles packaging and deployment to Steam.
Some external dependencies are not open source and are not included in the repository, so if you are building from source you will need to install the Steam version of the game to obtain these dependencies.
We welcome contributions! Please refer to the following documents before submitting a pull request:
This project is distributed under a multi-license structure because it incorporates elements from Valve's Source SDK.
All original source code and assets created by The JBMod Authors are licensed under the Apache License, Version 2.0. You may obtain a copy of the license in the LICENSE_APACHE file included in this repository or at http://www.apache.org/licenses/LICENSE-2.0.
Original contributions will be clearly marked with a permissive license header.
This project contains code and/or headers derived from Valve's Source SDK. These specific files remain subject to the Source 1 SDK License.
The Source SDK components are restricted to use solely in connection with Valve products. You can find the full text of Valve's license in the LICENSE file included in this repository or at https://github.com/ValveSoftware/source-sdk-2013/blob/master/LICENSE.
While the original code in this repository is provided under the permissive Apache 2.0 terms, any compiled binaries or derivative works that link against the Source SDK are legally bound by the restrictions of the Source 1 SDK License.