add full infra-as-code support for all experience assets

[blake-mealey]

(DRAFT)

~Experience icon:~

• ~Create: POST https://publish.roblox.com/v1/games/{gameId}/icon~ added in #12

~Experience thumbnails:~

• ~Create: POST https://publish.roblox.com/v1/games/{gameId}/thumbnail/image~ added in #12
• ~Change order: POST https://develop.roblox.com/v1/universes/{universeId}/thumbnails/order~ added in #12
• ~Delete: DELETE https://develop.roblox.com/v1/universes/{universeId}/thumbnails/{thumbnailId}~ added in #12

~Experience developer products:~

• ~Create: POST https://develop.roblox.com/v1/universes/{universeId}/developerproducts~ added in #32
  • ~Create does not return the ID required to update. The ID can be retrieved via the list endpoint:~ added in #32
  • ~GET https://api.roblox.com/developerproducts?universeId={}&page={}~ added in #32
• ~Update: POST https://develop.roblox.com/v1/universes/{universeId}/developerproducts/{productId}/update~ added in #32
• ~No way to delete products~ added in #32
• ~Icons are uploaded separately and their asset ID is passed to create/update:~ added in #44
  • ~Create: POST https://www.roblox.com/places/developerproduct-icon~ added in #44

~Experience badges:~ added in #59

• ~Create: POST https://badges.roblox.com/v1/universes/{universeId}/badges~
• ~Update config: PATCH https://badges.roblox.com/v1/badges/{badgeId}~
• ~Update icon: POST https://publish.roblox.com/v1/badges/{badgeId}/icon~
• ~No way to delete badges, but they can be marked as disabled with the update endpoint~
• ~Costs Robux so there should be a warning or something before creating~

~Experience game passes:~ added in #45

• ~Create: POST https://www.roblox.com/build/doverifiedupload~ added in #45
• ~Update config: POST https://www.roblox.com/game-pass/update~ added in #45
• ~Update icon: POST https://publish.roblox.com/v1/game-passes/{gamePassId}/icon~ added in #45
• ~No way to delete game passes~ added in #45

~Experiences:~

• ~Create (unverified): POST https://api.roblox.com/universes/create~ added in #39
• ~Update config: PATCH https://develop.roblox.com/v2/universes/{universeId}/configuration~ added in #12
• ~Delete: reconfigure to set isArchived: true~ added in #39

~Places:~

• ~Create: POST https://www.roblox.com/ide/places/createV2~ added in #39
• ~Update config: PATCH https://develop.roblox.com/v2/places/{placeId}~ added in #12
• ~Update file (Open Cloud): POST https://apis.roblox.com/universes/v1/{experienceId}/places/{placeId}/versions~ added in #12
• ~Update file (old): POST https://data.roblox.com/Data/Upload.ashx~ added in #39
• ~Delete: POST https://www.roblox.com/universes/removeplace~ added in #39

Assets (images, audio, etc):

• See comment below

[blake-mealey]

Reference for creating experiences:

axios({
            url: `https://api.roblox.com/universes/create?groupId=${groupId}`,
            method: "POST",
            headers: {
                Cookie: `.ROBLOSECURITY=${cookie}`,
                "User-Agent": "RobloxStudio/WinInet RobloxApp/0.461.0.416397 (GlobalDist; RobloxDirectDownload)",
                "X-CSRF-TOKEN": xcsrfToken || "",
            },
            data: {
                templatePlaceIdToUse: 95206881
            }
        })

Create from templates webpage: https://www.roblox.com/places/create

Better reference: https://devforum.roblox.com/t/create-universes-externally-documentation-of-universescreate/1392952 And for place creation: https://devforum.roblox.com/t/create-places-externally-documentation-of-ideplacescreatev2/1398462

[blake-mealey]

Game assets should be supported as well, specifically: images, audio, and meshes.

Game assets are created via two steps. First, they are uploaded to Roblox, then they are assigned an alias which can then be used by the rbxgameasset content data type.

Aliases:

• Create: POST https://develop.roblox.com/v1/universes/{universeId}/aliases
  • Note: "Type" is always "1"
• Update: POST https://api.roblox.com/universes/update-alias-v2?universeId={universeId}&oldName={oldName}
  • Note: the develop.roblox.com PATCH does not work (returns 404)
• Delete: POST https://api.roblox.com/universes/delete-alias?universeId={universeId}&name={name}
  • Note: the develop.roblox.com DELETE does not work (returns 404)

~Images:~ added in #66

• ~File types (from Roblox asset importer): bmp, gif, jpeg, jpg, png, tga~
• ~Create: POST https://data.roblox.com/data/upload/json?assetTypeId=13&name={}&description={}~
• ~Update: Re-create and update the alias to point to the new asset~
• ~Delete: We can archive the asset and delete the alias~
  • ~Archive: POST https://develop.roblox.com/v1/assets/{assetId}/archive~

~Audio:~ added in #67

• ~File types (from Roblox asset importer): ogg, mp3~
• ~Estimate cost: POST https://publish.roblox.com/v1/audio/verify~
  • ~Requires: name, duration (measured in seconds), and file size (measured in bytes)~
• ~Create: POST https://publish.roblox.com/v1/audio~
  • ~Requires: name (Audio/{name}), file (Base64 encoded)~
• ~Update: Re-create and update the alias to point to the new asset~
• ~Delete: We can archive the asset and delete the alias~
  • ~Archive: POST https://develop.roblox.com/v1/assets/{assetId}/archive~

Meshes (not fully understood):

• File types (from Roblox asset importer): fbx, obj
• Create: two endpoints:
  • POST: https://data.roblox.com/ide/publish/UploadNewMesh?name=RenderMesh&description=RenderMesh&genreTypeId=1&allowComments=False
  • Sends the file data somehow, perhaps already converted to a Roblox format? Maybe some of the Rojo devs understand this.
  • POST: https://data.roblox.com/ide/publish/UploadNewMeshPart?name=Meshes/{name}&description=MeshPart&genreTypeId=1&allowComments=False
  • Looks like it might be sending some .rbxmx data?
• Update: Re-create and update the alias to point to the new asset
• Delete: We can archive the asset and delete the alias
  • Archive: POST https://develop.roblox.com/v1/assets/{assetId}/archive

Configuration API:

templates;
  # or should we split them up by type?
  assets:
    # just a file path, uses file name without extension for alias
    - file/path
    # file paths with glob support
    - file/path/*
    # file path with custom alias, does not support globs
    - name: name
      file: file/path

There are some other features which we could provide APIs for but I don't see any obvious use-cases for them:

• Enable/disable copying
• Enable/disable comments
• Genre
• Description

[blake-mealey]

Does it make sense to support animations? I am not sure how that work (imported from .rbxmx files maybe?)

[blake-mealey]

Closing in favour of #122 as the rest of the resources have been added