shapez Community Edition (abbreviated as CE) is a community-maintained version of shapez!

CE was created as the tobspr Games team moved away from shapez to work full-time on the upcoming Shapez 2. CE aims to:

• Continue the development of shapez as guided by the community.
• Allow contributors to continue submitting new features and improvements to the game.
• Provide an experimental and forgiving environment for faster development.

As of now, CE must be built from source and supports only a standalone build, with no plans for re-supporting a web version. In the future, builds of CE may provided for owners of the full version of shapez.

We communicate on the official shapez Discord server. For historical reasons, we have communicated in a private channel, but we are moving to the public #contributing channel. If you would like to contribute to CE, feel free to share your ideas, plans, etc. there.

In our current workflow, we (the "collaborators" of the repository) create internal branches and corresponding pull requests to work on a feature, refactor, etc. We discuss changes in the Discord, and when 2 collaborators (including the PR creator) approve of a change, it can be merged. See our existing pull requests for examples.

If you are not a collaborator and want to submit a change, you can fork our repo and make a pull request. Note that because of plans to overhaul many parts of the game, unless you are improving translations, you should probably communicate with us on Discord!

The game uses a custom engine originally based on the YORG.io 3 game engine. The code within the engine is relatively clean with some code for the actual game on top being hacky.

We are in the process of migrating to TypeScript and JSX/TSX. New changes should be implemented in TypeScript if possible, but because we are planning on overhauling many parts of the game, there is no need to convert existing code to TypeScript.

This project is fine with using cutting-edge and bleeding-edge features and does not intend to provide compatibility for older clients.

• ffmpeg
• Node.js 16 (not 17+, see tobspr-games#1473)
• Yarn 1 (not 2, we haven't migrated yet)
• Java (or OpenJDK) (to run texture packer)

• Run yarn in the root folder and in electron/.
• Run yarn gulp in the root folder to build and serve files. Ignore the browser tab that opens.
• Open a new terminal and run yarn startDev in electron/ to open an Electron window.
  • Tip: If you open the Electron window too early, you can reload it when focused on DevTools.

• Run yarn in the root folder and in electron/.
• In the root folder, run yarn gulp build.standalone-steam.
• Run yarn gulp standalone.standalone-steam.prepare.
• Run yarn gulp standalone.standalone-steam.package.$PLATFORM where $PLATFORM is win64, linux64, or darwin64 depending on your system.
• The build will be found under build_output/standalone-steam as shapez-...-x64.

Thanks to tobspr for creating this project!