These are the docs for 11.0, an old version of SpatialOS. The docs for this version are frozen: we do not correct, update or republish them. 14.5 is the newest →

The Java worker SDK is currently experimental. We’re very open to feedback — don’t hesitate to get in touch on the forums.

Java worker SDK

The Java worker SDK allows anyone to write a worker in Java to connect to a SpatialOS simulated world. Like any other worker, a Java worker can subscribe to information for a part of a simulated world, visualize it, and perform some computation on behalf of the simulated world.

A typical Java worker makes use of both the core API defined in the improbable.worker package, and Java generated code based on the user-specified simulated world schema.

If you’re using a game engine we don’t have an integration with, you can use this SDK (or one of the other language SDKs) to integrate that game engine with SpatialOS.


  • JDK 1.6 or later. We recommend using Oracle’s JDK 1.8.
  • Gradle 2.14 or later.
    • Please note that the Gradle Wrapper is not supported by provided build scripts.
    • We’ve tested against Gradle version 2.14, but later versions are expected to work too. To install it:
      • macOS: brew install gradle
      • Windows: choco install --yes gradle

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums