Strumenti di terze parti

Per gli studi di sviluppo professionale, impostare strumenti di terze parti e investire nell'automazione può migliorare notevolmente la produttività degli sviluppatori. L'approccio cloud-first di Roblox ha molti vantaggi, ma spostare certe parti del flusso di lavoro di sviluppo fuori dal cloud può aiutare i team più grandi a tenere traccia delle modifiche nel tempo, rivedere il codice e utilizzare i linguaggi e gli strumenti con cui sono già familiari.

• Se desideri solo utilizzare un editor di testo esterno o tenere il codice nel controllo di versione, Script Sync è un'ottima scelta.
• Se vuoi gestire l'intero progetto come un insieme di file locali, questa pagina copre alcuni strumenti e strategie.

Il problema della sincronizzazione

Alla base, utilizzare strumenti esterni con Roblox è un problema di sincronizzazione:

• Vuoi che le tue istanze Roblox esistano come file su disco in modo da poter utilizzare i tuoi strumenti per lavorarci.
• Devi ripristinare i tuoi file nel progetto Roblox dopo aver finito di lavorarci.
• Se qualcun altro ha modificato quei file nel frattempo, devi gestire eventuali conflitti.

Affinché l'intera soluzione si senta senza soluzione di continuità e automatica, devi a) ascoltare le modifiche ai file e b) incorporare queste modifiche di nuovo in Studio.

Invece dell'approccio cloud-first di Roblox, Rojo consente un approccio "file system-first". Esegue un server sulla tua macchina che comunica con un plugin di Studio per sincronizzare i tuoi file e il modello di dati di Studio.

Installa Rojo con Rokit

Puoi scaricare e eseguire manualmente un file binario di Rojo, ma questo approccio comporta il rischio che diversi sviluppatori del tuo team utilizzino versioni diverse di Rojo. Una soluzione migliore è utilizzare un gestore della toolchain come Rokit, che utilizza un file di configurazione—un elenco di repository e versioni—per rendere il processo di installazione e aggiornamento coerente tra le macchine.

Poiché gestisce il tuo ambiente di sviluppo di base piuttosto che i pacchetti all'interno del tuo progetto, Rokit è più simile a nvm rispetto a npm, ma il confronto non è perfetto. Un semplice file rokit.toml appare così:

[tools]
rojo = "rojo-rbx/rojo@7.6.1"
wally = "upliftgames/wally@0.3.2"
lune = "lune-org/lune@0.10.4"

Poi installi questi strumenti con rokit install. Oltre a un file globale rokit.toml, Rokit supporta file per progetto, quindi puoi facilmente utilizzare diverse versioni di Rojo, Wally o qualsiasi altro strumento per diversi progetti e mantenere l'intero team su quelle stesse versioni.

Quando uno strumento rilascia una nuova versione, poi aumenti esplicitamente il numero di versione nel tuo file .toml, utilizzi Rokit per eseguire l'aggiornamento, testi la nuova versione e fai il downgrade se causa problemi. Per comandi e istruzioni di installazione, vedi Rokit.

Esegui Rojo

Dopo aver installato Rojo con Rokit, ciò che hai davvero installato è il server Rojo. Il passaggio successivo è installare il plugin Rojo per Roblox Studio.

Puoi installarlo dal Creator Store oppure installarlo localmente con questo comando:

rojo plugin install

Poi genera la struttura del progetto per il tuo nuovo gioco e costruiscilo:

rojo init my-new-experience
cd my-new-experience
rojo build -o my-new-experience.rbxl

In alternativa, puoi portare un gioco esistente. In entrambi i casi, dopo aver creato un progetto, avvia il server Rojo:

rojo serve

In Roblox Studio, apri il file .rbxl che hai appena costruito, apri il plugin Rojo e connettiti al tuo server ora in esecuzione, a quel punto puoi iniziare a fare modifiche nel tuo editor di testo preferito e vedere quelle modifiche sincronizzarsi automaticamente con Studio.

I progetti Rojo hanno determinati requisiti di denominazione per i file, numerose opzioni di configurazione e alcune limitazioni, tutte coperte nella documentazione di Rojo.

Gestori di pacchetti

Roblox ha una robusta serie di API incluse, ma se vuoi sfruttare i pacchetti software della community in modo coerente e riproducibile, hai bisogno di un gestore di pacchetti. Wally è un'opzione popolare. Puoi installarlo tramite Rokit, proprio come Rojo.

All'interno della directory Rojo del tuo gioco, esegui wally init. Poi aggiungi i pacchetti desiderati a wally.toml. Il file potrebbe apparire così:

[package]
name = "my-home-directory/my-new-experience"
version = "0.1.0"
registry = "https://github.com/UpliftGames/wally-index"
realm = "shared"

[dependencies]
react = "jsdotlua/react@17.2.1"
react-roblox = "jsdotlua/react-roblox@17.2.1"
cryo = "phalanxia/cryo@1.0.3"

Poi esegui wally install. Wally crea una directory Packages e scarica i pacchetti specificati lì. L'ultimo passaggio è aggiungere la directory Packages a Rojo in modo che i suoi contenuti vengano sincronizzati con Roblox. Apri default.project.json e aggiungi il percorso. Per semplicità, questo esempio aggiunge l'intera directory a ReplicatedStorage in modo che tutti i pacchetti siano disponibili per tutti gli script, ma potresti preferire aggiungere pacchetti specifici a ServerScriptService o StarterPlayerScripts:

{
  "name": "my-new-experience",
  "tree": {
    "$className": "DataModel",

    "ReplicatedStorage": {
      "Shared": {
        "$path": "src/shared"
      },
      "Packages": {
        "$path": "Packages"
      }
    },

    ...

  }
}

Poi puoi richiedere pacchetti all'interno dei tuoi script proprio come qualsiasi altro ModuleScript:

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local React = require(ReplicatedStorage.Packages.react)
local ReactRoblox = require(ReplicatedStorage.Packages["react-roblox"])

local handle = Instance.new("ScreenGui", Players.LocalPlayer.PlayerGui)
local root = ReactRoblox.createRoot(handle)

local helloFrame = React.createElement("TextLabel", {
	Text = "Ciao Mondo!",
	Size = UDim2.new(0, 200, 0, 200),
	Position = UDim2.new(0.5, 0, 0.5, 0),
	AnchorPoint = Vector2.new(0.5, 0.5),
	BackgroundColor3 = Color3.fromRGB(248, 217, 109),
	Font = Enum.Font.LuckiestGuy,
	TextSize = 24
})

root:render(helloFrame)

Come nella maggior parte degli altri progetti software, l'obiettivo è che i collaboratori possano clonare un repository, installare Rokit, eseguire alcuni comandi e avere lo stesso ambiente di sviluppo del resto del team.

Controllo delle versioni

Avere un insieme di file di testo semplice sul proprio computer sblocca una varietà di capacità, ma la principale è il controllo delle versioni. Puoi memorizzare i tuoi file in un repository Git o Mercurial; ospitare repository remoti e rivedere le modifiche al codice su GitHub, GitLab o Bitbucket; e utilizzare qualsiasi editor di testo ti piaccia.

Visual Studio Code e Cursor hanno il più grande ecosistema di estensioni, ma Sublime Text, Notepad++ e Vim sono tutte opzioni popolari. Qualsiasi editor tu scelga, abbinare le capacità dell'editor di script di Studio richiederà alcune estensioni.

Potresti anche considerare di aggiungere:

• Un linter come selene per catturare problemi comuni e far rispettare gli standard di codifica
• Un formattatore di codice come StyLua
• Un server linguistico come Luau Language Server per completamento automatico, controllo dei tipi e altro ancora
• Script Open Cloud (non sincronizzati con Studio) per aggiornare un gioco pubblicato o riavviare i server

Annulla tutto

Poiché gli strumenti di terze parti sincronizzano le modifiche di nuovo in Roblox Studio piuttosto che sostituirlo, nessuna parte di questo flusso di lavoro comporta alcun lock-in. In qualsiasi momento, puoi smettere di usare uno o tutti questi strumenti e tornare a modificare il tuo gioco esclusivamente in Studio. La mancanza di rischio rende particolarmente allettante sperimentare con strumenti di terze parti.