Universe

Represents a Roblox experience.

Atribut

pathstring

The resource path of the universe.

Format: universes/{universe_id}.

createTimestring

Hanya Output

The timestamp when the universe was created. String ini diformat sebagai Timestamp.

updateTimestring

Hanya Output

The timestamp when the universe was last updated. String ini diformat sebagai Timestamp.

displayNamestring

Hanya Output

The name of the universe.

This field can be updated by updating the root place's name.

descriptionstring

Hanya Output

The description of the universe.

This field can be updated by updating the root place's description.

Salah satu dari yang berikut untuk owner:

userstring

Hanya Output

The universe is user-owned.

groupstring

Hanya Output

The universe is group-owned.

visibilityEnum<string>

Hanya Output

Whether or not the universe is publicly accessible.

Possible values:

Value	Description
VISIBILITY_UNSPECIFIED	Updates using this value will throw an error on the backend.
PUBLIC	The universe is public.
PRIVATE	The universe is private. If a universe's visibility is set to PRIVATE, all active players will immediately be removed from all running servers.

facebookSocialLinkobject

The Facebook social link.

twitterSocialLinkobject

The Twitter social link.

youtubeSocialLinkobject

The Youtube social link.

twitchSocialLinkobject

The Twitch social link.

discordSocialLinkobject

The Discord social link.

robloxGroupSocialLinkobject

The Roblox group social link.

guildedSocialLinkobject

The Guilded social link.

voiceChatEnabledboolean

Whether or not voice chat is enabled for users in the Experience.

Updating this value will not affect active servers.

ageRatingEnum<string>

Hanya Output

The age rating of this universe.

Possible values:

Value	Description
AGE_RATING_UNSPECIFIED	The age rating is not set.
AGE_RATING_ALL	Supported for all users.
AGE_RATING_9_PLUS	Supported for users aged 9 and up.
AGE_RATING_13_PLUS	Supported for users aged 13 and up.
AGE_RATING_17_PLUS	Supported for users aged 17 and up.

privateServerPriceRobuxnumber

Represents the price in Robux of private servers.

If unset, private servers are not supported for this universe.

Can only be disabled when using a field mask.

Setting to null will disable all active private servers.

Changing the price will cancel all private server subscriptions.

desktopEnabledboolean

Whether or not players can join the Experience via Desktop.

mobileEnabledboolean

Whether or not players can join the Experience via Mobile.

tabletEnabledboolean

Whether or not players can join the Experience via Tablet.

consoleEnabledboolean

Whether or not players can join the Experience via Console.

vrEnabledboolean

Whether or not players can join the Experience via VR.

Base URL

https://apis.roblox.com

Resource Universe

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Get Universe

GET /cloud/v2/universes/{universe_id}

Gets the specified universe.

PermintaanParameter Jalur

universe_idstring

Diperlukan

The universe ID.

ResponsUniverse

GET /cloud/v2/universes/{universe_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}' \
  -H 'x-api-key: {your-api-key}'

Respons

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Update Universe

PATCH /cloud/v2/universes/{universe_id}

Updates the specified universe.

This method is guaranteed to return all updated fields. This method may additionally return the full resource.

Cakupan

universe:write

PermintaanParameter Jalur

universe_idstring

Diperlukan

The universe ID.

Parameter Kueri

updateMaskstring

The list of fields to update. String ini diformat sebagai FieldMask.

Request BodyUniverse

ResponsUniverse

PATCH /cloud/v2/universes/{universe_id}

curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}?updateMask={string}' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}'

Respons

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Publish Universe Message
Beta

POST /cloud/v2/universes/{universe_id}:publishMessage

Publishes a message to the universe's live servers.

Servers can consume messages via MessagingService.

Cakupan

universe-messaging-service:publish

PermintaanParameter Jalur

universe_idstring

Diperlukan

The universe ID.

Request Body

topicstring

The topic on which to publish the message.

messagestring

The message to publish.

POST /cloud/v2/universes/{universe_id}:publishMessage

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:publishMessage' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "topic": "my-topic",
  "message": "Hello, world!"
}'

Universe

Restart Universe Servers

POST /cloud/v2/universes/{universe_id}:restartServers

Restarts all active servers for a specific universe if and only if a new version of the experience has been published. Used for releasing experience updates.

Cakupan

universe:write

PermintaanParameter Jalur

universe_idstring

Diperlukan

The universe ID.

Request Body

Respons

POST /cloud/v2/universes/{universe_id}:restartServers

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:restartServers' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{}'

Respons

{}

Universe

Atribut

Universe

Get Universe

Universe

Update Universe

Universe

Publish Universe MessageBeta

Universe

Restart Universe Servers

Publish Universe Message
Beta