Chapter 5
Forge, the build runner
Put a machine to work: it claims commits, packages them, tests them, and publishes the result without anyone sitting there.
4 sections · Chapter 5 of 8
Chapter 4 got a build out of the machine in front of you. That is the right first step and it stops scaling at roughly the moment two people need a build on the same afternoon, or the moment someone notices that the build always happens on the same person's computer and always while they wanted to be doing something else.
Forge is a separate application you install on a machine you own. It polls for work, materializes the exact committed state of a project, runs the packaging toolchain, and publishes the result. It is what continuous integration means for a game project, without a CI service that charges by the minute for compute you already own.
This chapter covers what it is, how to enroll a machine, the three kinds of pipeline and the tests you can turn on without writing any, and what happens when you let it build every commit.
In this chapter
- 5.1What Forge isA standalone app for a build machine, so packaging stops being something a person does.
- 5.2Enrolling a runnerName the machine, copy the token once, install the app, paste it in.
- 5.3PipelinesThree kinds — package, compile check, editor binaries — plus validation and tests that need no code.
- 5.4Building every commitTurn a pipeline's auto-build on and every push becomes a build.
Summary
Forge is a machine you own, running the engine you already have, doing the packaging nobody wants to do by hand. Enrolling one is a name and a token; the runner reports what it can build so you never configure something that cannot run.
Workspaces persist and transfer only the delta since the last build, with hash verification and a full-download fallback, so repeat builds are fast without being occasionally wrong.
Start with a compile check on auto-build and a package pipeline you press yourself. Turn on data validation, the Blueprint sweep, and the boot smoke test — they cost you nothing and they catch the failures that otherwise reach players.
Next: shipping more than one version of the same game.