Para muitos desenvolvedores, o desafio fundamental de se adaptar à programação no Roblox é a importância da localização do arquivo e da propriedade Script.RunContext. Dependendo do tipo de script, da localização no Explorer e do contexto de execução, os scripts podem se comportar de maneira muito diferente. Certas chamadas de método podem falhar, objetos no seu jogo podem estar inacessíveis ou os scripts podem não ser executados.
A razão para essa complexidade é que os jogos do Roblox são multiplayer por padrão. Os scripts precisam ter a capacidade de serem executados apenas no servidor, apenas no cliente ou serem compartilhados entre ambos. A evolução da plataforma Roblox ao longo do tempo complicou ainda mais a situação.
Tipos de script
O Roblox possui três tipos de scripts:
- Script - Código que é executado no servidor ou no cliente, dependendo de sua localização e da propriedade Script.RunContext.
- LocalScript - Código que é executado apenas no cliente. Não possui um contexto de execução.
- ModuleScript - Código que você pode reutilizar em outros scripts. Não possui um contexto de execução.
Quando você cria um Script, seu contexto de execução padrão é Legacy, o que significa que a) é um script do lado do servidor e b) só é executado se estiver em um contêiner de servidor, como ServerScriptService ou Workspace.
- Se você mudar o contexto de execução do script para Server, ele agora também pode ser executado em ReplicatedStorage, mas não recomendamos isso. O conteúdo dessa localização é replicado para os clientes, então é um local ruim para scripts do lado do servidor.
- Se você mudar o contexto de execução do script para Client, ele pode ser executado em ReplicatedStorage. Ele também pode ser executado em StarterCharacterScripts e StarterPlayerScripts. Os contêineres de inicialização são copiados para os clientes, portanto, o script original e a cópia são executados, o que não é desejável.
Para mudar o contexto de execução de um script, selecione-o no Explorer e altere o valor na janela Properties.

Recomendações
Coloque um único Script com um RunContext de Client em ReplicatedStorage.
Coloque um único Script com um RunContext de Server em ServerScriptService.
Use ModuleScripts para o máximo de código do cliente e do servidor possível. Requeira esses módulos do seu script do cliente e do seu script do servidor.
Essa abordagem dá ao seu código um único ponto de entrada nos lados do cliente e do servidor, o que simplifica a organização e facilita isolar ou desativar módulos problemáticos. Adicione uma função start() a cada ModuleScript para que todos os módulos possam ser carregados antes de você começar a executar seu código:
Exemplo de script do servidor--!strictlocal ServerScriptService = game:GetService("ServerScriptService")local SampleModule = require(ServerScriptService.SampleModule)local AnotherSampleModule = require(ServerScriptService.AnotherSampleModule)SampleModule.start()AnotherSampleModule.start()Exemplo de módulo--!strictlocal CollectionService = game:GetService("CollectionService")local NPC_TAG = "npc"local SampleModule = {}local function setUpNpc(npc: Instance)-- inicializar cada NPCendlocal function cleanUpNpc(npc: Instance)-- executar quando o evento dispararendfunction SampleModule.start() -- adicione a função à tabela-- exemplo de loop para configuração com base em tagsfor _, npc in CollectionService:GetTagged(NPC_TAG) dosetUpNpc(npc)end-- executar funções quando eventos dispararemCollectionService:GetInstanceAddedSignal(NPC_TAG):Connect(setUpNpc)CollectionService:GetInstanceRemovedSignal(NPC_TAG):Connect(cleanUpNpc)endreturn SampleModulePara compartilhar código, use ModuleScripts em ReplicatedStorage e requeira-os tanto no seu script do cliente quanto no seu script do servidor.
Se necessário para o seu jogo, repita o mesmo padrão em ReplicatedFirst com um único script do cliente e um número mínimo de ModuleScripts para implementar uma tela de carregamento. Para saber mais sobre ReplicatedFirst, veja Ordem de replicação.
Use LocalScripts com moderação. Se você precisar usá-los, coloque-os em StarterCharacterScripts, StarterPlayerScripts, StarterGui ou StarterPack.
Scripts nesses contêineres são clonados para contêineres de jogadores em vez de serem executados de um único local, o que pode complicar a depuração. Usar ReplicatedStorage para código do cliente permite que você clique em linhas na janela Output e vá para ReplicatedStorage.YourScript (a localização estável do script) em vez de Players.YourName.PlayerScripts.YourLocalScript (a localização efêmera para a qual o script foi copiado em tempo de execução).
Evite anexar scripts diretamente a instâncias em Workspace. Em vez disso, tague instâncias e use CollectionService para trabalhar com elas a partir de um único ModuleScript.
A exceção chave é se você distribuir modelos ou pacotes na Creator Store. Nesse caso, você pode precisar incluir scripts dentro da hierarquia de instâncias; especifique um RunContext para cada script para remover a ambiguidade sobre como ele é executado. Definir explicitamente essa propriedade torna modelos e pacotes mais propensos a funcionar corretamente a partir de uma variedade de locais.
Estrutura de projeto de exemplo
O projeto de referência Plant mostra como você pode organizar seu código em um jogo grande e complexo. Ele armazena a vasta maioria de seu código como ModuleScripts reutilizáveis.
Locais de script
| Localização | Descrição |
|---|---|
| Workspace | Representa o mundo 3D do jogo. Pode executar scripts do servidor que se conectam diretamente a objetos e controlam seu comportamento. |
| ReplicatedFirst | Contém objetos que se replicam para o cliente antes de qualquer outra coisa. Esta localização é ideal para o conjunto mínimo absoluto de objetos e scripts do cliente necessários para exibir uma tela de carregamento. |
| ReplicatedStorage | Contém objetos que são replicados tanto para o cliente quanto para o servidor. Esta localização é ideal para Scripts com um RunContext de Client, ModuleScripts do cliente e ModuleScripts que você deseja usar tanto no servidor quanto no cliente. LocalScripts não são executados a partir desta localização. |
| ServerScriptService | Contém scripts do servidor. Esta localização é ideal para scripts que precisam acessar funcionalidades ou objetos do lado do servidor, como lógica de jogo e armazenamento em nuvem. |
| ServerStorage | Contém objetos do lado do servidor. Esta localização é ideal para objetos grandes que não precisam ser replicados imediatamente para os clientes quando eles entram em um jogo. Scripts não são executados a partir desta localização, mas você pode armazenar ModuleScripts do lado do servidor aqui. |
| StarterPlayer ⟩ StarterCharacterScripts | Contém LocalScripts que são executados quando o personagem aparece. |
| StarterPlayer ⟩ StarterPlayerScripts | Contém LocalScripts que são executados quando o jogador entra no jogo. |
| StarterGui | Contém elementos de GUI que o cliente exibe quando carrega o jogo. LocalScripts podem ser executados a partir desta localização. |
| StarterPack | Geralmente contém apenas Tools, mas também pode incluir LocalScripts para configurar mochilas de jogadores. |
Esta imagem mostra quais locais da janela Explorer podem conter scripts do cliente. Lembre-se, ReplicatedFirst e ReplicatedStorage podem conter Scripts com um RunContext de Client, enquanto os contêineres Starter[] devem usar LocalScripts.
