Skip to content
Browse Docs and Help
how-to

Import a game from a zip

Bring existing game files into a new Studio project and check what needs adapting.

On this page

What you need

A zip containing your HTML5 game’s source files. Expect to adapt games that use unsupported libraries or different platform APIs.

Steps

  1. In Projects, choose Import a zip.
  2. Select the zip and enter a project name.
  3. Choose Import and wait for checking.
  4. On completion, read What didn’t come in and Renamed.
  5. Choose Open the project.
  6. Open llvls.json. If the import added a starter manifest, set its audience and check the main script in entry.
  7. If the original game starts from index.html, identify the game script that should be the entry.
  8. Update references to renamed assets and load them using llvls.assets.url().
  9. Choose Run, fix the reported problems and repeat until the preview works.
  10. Save a checkpoint after the imported game runs.

What changes during import

If all files are inside one folder, the import takes them out of that folder. Images become PNG and audio becomes WAV, which may change names. Fonts cannot come through this flow yet. The result lists omitted or refused files.

Importing does not automatically rewrite a game for the SDK.

If you leave during checking

Return to Projects to look for the finished project. Avoid immediately submitting another copy just because you left the status page.

Still stuck?

Email support@4rc4d3.com with the project or game name, if relevant, the action you tried and the exact error. Never include passwords, authenticator codes, backup codes or AI keys.