Formats de ressources personnalisés et créations des joueurs

Une spécification de ressource se déclare dans la liste assetSpecs de catalogue.json, à côté de apps :

{
  "assetSpecs": [{
    "name": "moon-level",
    "version": "1.0.0",
    "displayName": "Moon Jump level",
    "symbol": "specs/moon-level.svg",
    "contract": "specs/moon-level.contract.json"
  }]
}

Le contrat nomme les fichiers de chaque ressource et indique comment les vérifier :

{
  "primaryRole": "level",
  "roles": [
    { "name": "level", "required": true, "contentTypes": ["application/json"], "mode": "TEXT",
      "jsonSchema": { "type": "object", "required": ["tiles"], "properties": { "tiles": { "type": "array" } } } },
    { "name": "thumbnail", "required": false, "contentTypes": ["image/png"], "mode": "BINARY" }
  ]
}

Les rôles peuvent comporter un schéma JSON, que PlayDrop vérifie à chaque enregistrement. Publiez une nouvelle version de la spécification quand le format change ; les anciennes ressources conservent leur version.

{
  "assetSpecSupport": [
    { "assetSpec": "asset-spec:your-name/moon-level", "versionRange": "^1.0.0", "capabilities": ["READ", "WRITE"] }
  ]
}

Les capacités possibles sont READ, WRITE, EDIT, PREVIEW et IMPORT.

const levels = sdk.assets.custom.forSpec("asset-spec:your-name/moon-level");

await levels.saveDraft({ assetName: "crater-run", displayName: "Crater run",
  files: { level: new Blob([JSON.stringify(level)], { type: "application/json" }) } });
await levels.publish({ assetName: "crater-run", displayName: "Crater run", files: { level: levelBlob, thumbnail: pngBlob } });

const mine = await levels.listMine();
const latest = mine[0]?.latestPublicVersion;
if (latest) startLevel(await levels.loadJson({ assetRef: latest.assetRef, role: "level" }));

const community = await levels.listPublic({ limit: 20 }); // { assets, pagination }

• saveDraft conserve un brouillon privé ; publish le rend public. Les deux exigent l’ensemble complet des fichiers.
• Les références de ressources ressemblent à asset:creator/name@r2. loadJson, loadText et downloadFile lisent les ressources publiées ; loadOwned, loadOwnedJson et loadOwnedFile lisent celles du joueur, brouillons compris.
• supports(versionRef, capability) vérifie la compatibilité avant d’ouvrir une ressource d’une autre version.
• Les erreurs utilisent des codes comme custom_asset_capability_unsupported et custom_asset_role_type_mismatch.

Les joueurs doivent être connectés pour enregistrer. Vérifiez ce que publient les joueurs comme n’importe quel contenu d’utilisateur : la politique de contenu de PlayDrop s’y applique.

Les ressources personnalisées et les spécifications composées uniquement de données s’envoient comme les autres fichiers. Les modèles exécutables, c’est-à-dire les ressources MODEL_3D de sous-catégorie procedural ou au format CUSTOM, sont refusés par le connecteur, car l’API n’exécute pas le code des créateurs ; figez-les en modèle statique ou référencez une version publiée. Consultez ressources de jeu.