Creación de activos en el juego

Con la función de creación de activos en el juego, puedes permitir que tus usuarios guarden las creaciones que hicieron en tu juego en sus inventarios. Tus usuarios pueden usar estas creaciones en el juego como cualquier otro activo. Además, estas creaciones atribuyen a tu juego cuando se muestran en la plataforma Roblox, así que cualquier usuario puede usar el enlace de atribución para llegar a tu juego y crear las suyas.

Por ejemplo, puedes habilitar a los usuarios para que creen criaturas personalizadas como mascotas en tu juego y permitirles guardar sus mascotas favoritas en sus inventarios. Tienes control total para especificar qué objetos pueden modificar y guardar los usuarios desde tu juego. Los usuarios, a su vez, pueden mostrar sus creaciones en sus perfiles con atribución a tu juego, aumentando la visibilidad de tu juego.

Tipos de activos compatibles y límites

Al igual que todos los activos en la plataforma, las creaciones en el juego están sujetas a moderación de activos. Actualmente, solo puedes permitir que los usuarios creen paquetes desde tu juego. Estos paquetes no pueden contener ningún script o activos privados, como audio, video y paquetes anidados. Si el sistema detecta scripts o activos privados en un paquete que puede ser guardado por los usuarios, bloquea la acción de guardar en el juego ocultando el aviso de guardado para los usuarios.

Cuando estés ejecutando o probando tu juego y agregues scripts o activos privados como parte de una creación en el juego, no se guardará y aparecerán mensajes de error en la ventana de Salida de Studio o en la Consola del Desarrollador.

Habilitando la creación de activos en el juego

Para habilitar la creación de activos en el juego para tus usuarios, utiliza el método de la API AssetService:PromptCreateAssetAsync() en un script del lado del servidor, junto con otra lógica de creación. Especifica qué instancias de tu juego quieres habilitar esta funcionalidad, configura un disparador personalizado (como un ícono de UI) para invocar el método y escucha los eventos remotos del cliente para guardar activos.

AssetService:PromptCreateAssetAsync() toma los siguientes parámetros:

• Un objeto Player que representa al usuario que envía la creación del activo.
• Un objeto Instance que representa el activo para la creación.
• El Enum.AssetType, que actualmente se limita a Enum.AssetType.Model.

Cuando el servidor invoca AssetService:PromptCreateAssetAsync(), se muestra un diálogo de Enviar Paquete en el cliente, de modo que el usuario que activa la acción de guardar puede ingresar un nombre y una descripción para el paquete. Roblox proporciona la interfaz de usuario del diálogo de forma predeterminada, ya que el flujo de trabajo de guardado es una funcionalidad a nivel de plataforma.

El siguiente script del lado del servidor solicita a los usuarios que guarden un coche que pintaron en un juego:

Script de Ejemplo para Creación de Activos en el Juego
-- Definir la variable AssetService
local AssetService = game:GetService("AssetService")

-- Configurar PromptCreateAssetAsync() para solicitar el diálogo de envío
local function CreateAsset(player, instance)
	local complete, result, assetId = pcall(function()
		return AssetService:PromptCreateAssetAsync(player, instance, Enum.AssetType.Model)
	end)

	if complete then
		if result == Enum.PromptCreateAssetResult.Success then
			print("subido con éxito, AssetId:", assetId)
		else
			print("Recibido resultado", result)
		end
	else
		print("error")
		print(result)
	end
end

-- Lógica de pintado del coche omitida

-- Agregar un controlador de eventos
local function onUserPublish(player, promptObject)
	-- El usuario guarda la instancia del coche con el color predeterminado del juego
	if promptObject.Name == "car" then
		CreateAsset(player, car)
	elseif promptObject.Name == "CarPaintYellow" or promptObject.Name == "CarPaintBlue" or promptObject.Name == "CarPaintBlack" or promptObject.Name == "CarPaintRed" then
		PaintCarColor(promptObject.Name)
	end
end

PublishEvent.OnServerEvent:Connect(onUserPublish)

Demo de Creación en Experiencia muestra un ejemplo de cómo puedes usar esta función. Puedes unirte a la demostración para recorrer el flujo de trabajo de creación en el juego como usuario, o editar el lugar en Studio para hacer referencia al diseño.

Post-creación y atribución

Después de que los usuarios crean y guardan un activo de tu juego, pueden encontrarlo en los siguientes lugares:

• Su página de Mi Inventario.
• La pestaña Creaciones de su página de Perfil.
• La pestaña Elementos de Desarrollo bajo la página de Creaciones de su Panel del Creador Creaciones.
• La pestaña Inventario de su Caja de Herramientas en Studio.

Cuando los usuarios ven creaciones en el juego en los perfiles o inventarios de sus amigos, ven atribución al juego original en el que se creó el activo. Los usuarios pueden hacer clic en el enlace de atribución para redirigirse a la página del juego, para que puedan unirse al juego y crear los suyos.