Archives/tobspr_shapez.io
1
0
Fork 0
mirror of https://github.com/tobspr/shapez.io.git synced 2025-12-09 16:21:51 +00:00
Code Issues Projects Releases Wiki Activity
2,352 Commits 6 Branches 26 Tags 674 MiB
JavaScript 88.9%
SCSS 10.1%
HTML 0.6%
CSS 0.2%
Python 0.1%
a2d1e434bb
Go to file
Thomas (DJ1TJOO) a2d1e434bb
Added information about community edition (#2) 
* Added information about community edition

* Update README.md

* README rewrite

---------

Co-authored-by: EmeraldBlock <yygengjunior@gmail.com>
2023-11-18 16:19:43 -06:00
.github/workflows Clean up and update workspace files 2023-10-25 08:05:56 +03:00
.vscode Clean up and update workspace files 2023-10-25 08:05:56 +03:00
electron Clean up and update workspace files 2023-10-25 08:05:56 +03:00
gulp Add support for JSX 2023-10-24 16:58:53 +03:00
mod_examples Rebranding and minor polishing, part 2 2022-06-02 14:06:33 +02:00
res Clean up and update workspace files 2023-10-25 08:05:56 +03:00
res_raw v1.5.5 - Rework tutorial and polishing 2022-06-20 10:21:13 +02:00
src Add Most Useful TS files (#13) 2023-11-17 16:02:08 -06:00
translations Add shapez 2 hint to the game 2022-10-09 13:09:31 +02:00
.editorconfig Added EditorConfig (#778) 2020-10-06 17:28:17 +02:00
.eslintignore add all GH Actions work 2020-05-27 08:17:25 -04:00
.eslintrc.yml Fixed dev and devStandalone script (#1503) 2022-12-29 09:57:34 +01:00
.gitignore Remove GOG/Wegame source roots 2023-10-06 11:13:26 +03:00
.prettierrc.yaml Update github actions 2020-05-28 09:37:57 +02:00
.yamllint Fix yaml errors in CI (#757) 2020-10-04 10:38:02 +02:00
Dockerfile Fix Dockerfile (#1409) 2022-04-04 08:56:29 +02:00
LICENSE Update license 2020-05-21 15:08:30 +02:00
package.json Fix build by re-adding a missing dev dependency 2023-11-07 18:19:43 +02:00
README.md Added information about community edition (#2) 2023-11-18 16:19:43 -06:00
sync-translations.js ES modules and config refactor 2023-03-04 00:46:55 -06:00
version Add shapez 2 hint to the game 2022-10-09 13:09:31 +02:00
yarn.lock Fix build by re-adding a missing dev dependency 2023-11-07 18:19:43 +02:00

README.md

shapez Community Edition shapez Logo

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.

Important

CE is different from the official game published on Steam and other platforms. CE was forked off of the official shapez, which has its own repository. No plans exist to merge the two versions of shapez.

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.

Contributing

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!

Tip

Be aware that pull requests to the official shapez repository are unlikely to get merged in the near future. Instead, submit them to CE! In fact, because the game is licensed under the GNU GPL v3.0, existing pull requests can be resubmitted to CE even if you aren't the author! This is not legal advice.

Code

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.

Building

Prerequisites

Development

  • 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.

Release

Caution

Release steps are currently unchecked and unmaintained and will likely be revised in the future.

  • 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.

Credits

Thanks to tobspr for creating this project!

tobspr Games