Back to all docs
QubizSDK.assets

Asset Pipeline

Upload reviewed source assets with a game and load them from the SDK asset library.

assetsmarketplaceuploadpreload

Upload assets with a build

The Upload page supports a project asset pack in addition to the build ZIP, cover, and banner. Asset files are stored under game-uploads/{uid}/{slug}/asset and attached to the game manifest as assets[].

Assets can represent sprites, images, audio, models, scripts, data, fonts, UI files, and other reviewed files. The manifest keeps file metadata, tags, inferred kind, storage path, and download URL.

  • Asset files: up to 30 files per upload draft.
  • Per-file asset UI limit: 50 MB.
  • Storage rule limit: 100 MB per uploaded object.
  • The assets:read scope gates SDK access to the project library.

List and preload assets

Use list to query reviewed assets and preload to warm the browser cache before a level, cutscene, or mode starts. Preload runs in the game frame; list is a host request.

Load sprites
await QubizSDK.requestPermissions(["assets:read"]);

const result = await QubizSDK.assets.list({
  kind: "sprite",
  tags: ["player"]
});

if (result.status === "granted") {
  await QubizSDK.assets.preload(result.assets);
}