What is a shareable workspace?
A shareable workspace is a .zip file that allows you to easily share your project with friends or back up your work between releases. Shareable workspaces enable MCreator to restore your mod as a fully functional project from the exported files, making collaboration and version control more efficient.
Project security
Anyone with access to the shareable ZIP file will have full access to your project’s source code. It’s advised not to share these files online or with individuals you don’t trust, as this could lead to others distributing copies of your mod without your permission. A logical exception is of course if your project is open-source.
Exporting
- Open MCreator and load the workspace you want to export.
- In the top menu, click on File.
- Select Export workspace to a shareable ZIP file.
- Choose a location on your computer to save the file, name it, and click Save.
- MCreator will package your workspace into a ZIP file, which you can now share or store.
Importing
- Download or locate the ZIP file of the workspace you want to import.
- Open MCreator and click on File.
- Select Import workspace from shareable ZIP.
- Browse for the ZIP file on your computer and click Open.
- MCreator will import the workspace, and you can start working on it once the project is loaded.
GitHub bug reports
When opening an issue on MCreator's GitHub issue tracker, users are required to provide a minimal example workspace demonstrating the problem. "Minimal" means including only the necessary elements to reproduce the issue.
When submitting a bug report, there's a section labeled Example Workspace where users are required to drag and drop the shareable workspace file. This will upload the example project with the issue.
Keep in mind, that you should never upload your full mod to this section, as it could compromise your project’s security, making it vulnerable to unauthorized copying. Always create a minimal example workspace with only the essential elements and procedures needed to showcase the bug.