Plugin di Studio

Un plugin è un'estensione che aggiunge funzionalità o caratteristiche aggiuntive a Studio. Puoi installare plugin creati dalla comunità dal Creator Store, oppure puoi creare e pubblicare i tuoi per il Toolbox da utilizzare nei tuoi giochi.

Se scegli di distribuire anche i tuoi plugin nel Creator Store, puoi offrirli gratuitamente o venderli per Dollari Statunitensi. Roblox offre una quota di ricavi leader di mercato per queste vendite, poiché vengono detratti solo le tasse e le spese di elaborazione dei pagamenti. Per ulteriori informazioni sulla vendita di plugin, consulta Creator Store - Distribuire e vendere risorse.

Crea nuovi plugin

Puoi creare i tuoi plugin per migliorare il tuo flusso di lavoro in Studio. Il seguente esempio di codice è un plugin chiamato AddEmptyScript che inserisce uno Script vuoto come figlio di un Instance o in ServerScriptService. Le sezioni seguenti spiegano le parti principali per creare questo plugin.

Per iniziare, dovresti abilitare Plugin Debugging Enabled nella sezione Studio delle impostazioni di Studio. Questo esporrà il PluginDebugService in Studio, che fornisce il debug in tempo reale per il codice del tuo plugin e rende più facile ricaricare e salvare il tuo plugin.

local ServerScriptService = game:GetService("ServerScriptService")
local Selection = game:GetService("Selection")

-- Crea una nuova sezione della barra degli strumenti e una cartella del menu Plugin intitolata "Custom"
local toolbar = plugin:CreateToolbar("Custom")

-- Aggiungi un pulsante della barra degli strumenti etichettato "Empty Script"
local newScriptButton = toolbar:CreateButton("Empty Script", "Crea uno script vuoto", "rbxassetid://14978048121")

-- Rendi il pulsante cliccabile anche se la vista 3D è nascosta
newScriptButton.ClickableWhenViewportHidden = true

local function onPluginButtonClicked()
	local selectedObjects = Selection:Get()
	local parent = selectedObjects[1] or ServerScriptService
	local newScript = Instance.new("Script")
	newScript.Source = ""
	newScript.Parent = parent
end

newScriptButton.Click:Connect(onPluginButtonClicked)

Salva lo script del plugin

Per creare un plugin, prima crea uno Script e salvalo localmente.

1. Inserisci un nuovo Script all'interno di ServerStorage e rinominalo in AddEmptyScript.

   

2. Copia e incolla il codice del Plugin AddEmptyScript sopra nel nuovo script.

3. Con il nuovo script selezionato nella finestra Explorer, seleziona Salva come Plugin Locale dal menu Plugin di Studio.

4. Nella finestra popup, fai clic su Salva per inserire lo script del plugin nella tua cartella Plugin locale dell'installazione di Studio.

5. Il plugin dovrebbe apparire in PluginDebugService e iniziare a funzionare.

6. IMPORTANTE

   Elimina lo script originale in ServerStorage e lavora dal plugin AddEmptyScript all'interno di PluginDebugService, altrimenti potresti finire per applicare modifiche allo script sbagliato.

   

Aggiungi pulsante alla barra degli strumenti

Per aggiungere un pulsante per il tuo plugin alla scheda Plugin della barra degli strumenti di Studio, utilizza i metodi Plugin:CreateToolbar() e PluginToolbar:CreateButton(). Nel codice per AddEmptyScript, la riga 5 crea una nuova sezione nella barra degli strumenti e una cartella del menu Plugin intitolata Custom, mentre la riga 8 crea un pulsante etichettato Empty Script.

Esegui codice al clic

Per far eseguire al plugin il codice quando un utente fa clic sul pulsante della barra degli strumenti, collega una funzione all'evento PluginToolbarButton.Click del pulsante. Nel codice per AddEmptyScript, la funzione di collegamento è onPluginButtonClicked().

Controlla la selezione dell'utente

Per modificare il comportamento di un plugin in base a ciò che l'utente ha selezionato, utilizza il servizio Selection. La funzione onPluginButtonClicked() controlla se l'utente ha qualcosa selezionato e crea il nuovo script come suo figlio invece di all'interno di ServerScriptService. Se l'utente non ha nulla selezionato, crea il nuovo script in ServerScriptService.

Supporta annullamento e ripetizione

Utilizza ChangeHistoryService per consentire agli utenti di annullare e ripetere le modifiche apportate da un plugin all'interno di un gioco. Nel tuo script, imposta il plugin per chiamare TryBeginRecording() e memorizza l'identificatore assegnato alla chiamata API prima di apportare modifiche. Quindi imposta il plugin per chiamare FinishRecording() dopo aver apportato modifiche, in modo che catturi eventuali modifiche apportate durante la sessione di registrazione per l'annullamento e la ripetizione.

Il seguente esempio di codice crea un plugin di esempio che può applicare il materiale neon alle parti selezionate. Utilizza ChangeHistoryService per registrare e gestire le modifiche apportate dal plugin:

local ChangeHistoryService = game:GetService("ChangeHistoryService")
local Selection = game:GetService("Selection")

-- Crea un plugin di esempio
local toolbar = plugin:CreateToolbar("Plugin Esempio")
local button = toolbar:CreateButton("Neon it up", "", "")

-- Collega una funzione all'evento di clic
button.Click:Connect(function()
	-- Prova a iniziare una registrazione con un identificatore specifico
	local recording = ChangeHistoryService:TryBeginRecording("Imposta selezione su neon")

	-- Controlla se la registrazione è stata avviata con successo
	if not recording then
		-- Questo indica che il tuo plugin ha iniziato una registrazione precedente e non l'ha mai completata
		-- Puoi avere solo una registrazione attiva per plugin alla volta
		return
	end

	-- Itera attraverso le istanze selezionate
	for _, instance in Selection:Get() do
		-- Controlla se l'istanza è un BasePart
		if instance:IsA("BasePart") then
			instance.Material = Enum.Material.Neon -- Imposta il materiale della parte su Neon
		end
	end

	-- Termina la registrazione, impegnando le modifiche nella cronologia
	ChangeHistoryService:FinishRecording(recording, Enum.FinishRecordingOperation.Commit)
end)

Carica plugin

Dopo aver terminato di creare un plugin, puoi caricarlo nel tuo inventario in modo che sia accessibile in tutti i tuoi progetti.

Per caricare un plugin:

1. Nella finestra Explorer, seleziona uno script del plugin.

2. Naviga nel menu Plugin di Studio, quindi seleziona Pubblica come Plugin.

3. OPZIONALE

   Nell'angolo in alto a sinistra della finestra di configurazione dell'asset, fai clic sull'immagine predefinita del pezzo di puzzle per caricare un'immagine in miniatura 512×512 per il tuo plugin.

4. Compila i seguenti campi:

   • Nome — Un titolo per il tuo plugin.
   • Descrizione — Una descrizione che spiega cosa può aspettarsi un potenziale utente dal plugin.
   • Creatore — Il creatore o il gruppo che desideri attribuire come creatore del plugin.

5. Fai clic sul pulsante Invia. Il tuo plugin è ora disponibile per te nel Toolbox sotto le schede Inventario e Creazioni.

Distribuisci e vendi plugin

Puoi distribuire pubblicamente e vendere i tuoi plugin nel Creator Store affinché altri li utilizzino nello sviluppo dei loro giochi. Questo metodo di monetizzazione ti consente di guadagnare il 100% dei proventi netti delle transazioni, bypassando le commissioni della piattaforma e le tariffe DevEx. Per ulteriori informazioni su questo processo, inclusi i dettagli su come impostare un account venditore per impostare i prezzi e ricevere pagamenti, consulta Creator Store - Distribuire e vendere risorse.