Documentação/Produtos

Sistema de Tutorial

Sistema de tutorial para orientar novos jogadores. Configure etapas, permissões e a integração opcional usada por outros scripts.

Pasta do resource
[TS]Tutorial
Arquivo de configuração
[TS]Tutorial/Config.lua

Antes de instalar

Se você está começando agora, siga esta ordem. Ela evita a maior parte dos erros de ativação, permissão e dependência.

1. Proteção pronta Instale o módulo MTAX:SA, cadastre o IP e coloque sua KEY no Config.lua.
2. Pasta correta Mantenha o resource com o nome esperado: [TS]Tutorial.
3. Dependências ligadas Inicie inventário, notificação, blur, banco ou utilitários citados nesta página antes do produto.
4. Debug limpo Reinicie o resource e confira o console. Se aparecer erro, corrija antes de liberar aos jogadores.
Permissão do resource Se o mod precisar de permissão no ACL, adicione o resource ao grupo correto usando o nome exato da pasta. Para este produto, a referência é resource.[TS]Tutorial.
Objeto ACL do resource
resource.[TS]Tutorial

Abrir guia completo de instalação e ativação

Como ler os códigos nesta página

Config.lua Arquivo principal onde você altera KEY, permissões, comandos, valores, cores, posições e integrações.
Blocos grandes Servem para localizar a parte correta no arquivo. Não cole o bloco inteiro por cima do seu arquivo sem revisar.
Trechos curtos Podem ser comandos, exports ou exemplos de ACL. Copie apenas quando a legenda disser que é para usar.
Video do produto Sistema de Tutorial na loja TioSam Scripts.

Visão geral

Use esta página para entender o que você pode alterar no Config.lua deste produto. As explicações abaixo indicam onde mexer em licença, permissões, comandos, valores, cores, posições do mapa e integrações comuns.

  • Defina os locais de tutorial
  • Defina a descrição de cada local
  • Adicione quantos locais desejar
  • Sem erros no Debug

Configuração inicial

Abra [TS]Tutorial/Config.lua, preencha sua licença em ConfigLicense.license e reinicie o script depois de salvar. Não publique a chave em prints, tickets ou arquivos enviados para terceiros.

Licença protegida
» CopyRight © 2026
            » Nosso website https://tiosamscripts.com.br/
            » Nosso discord discord.gg/tiosamscripts
]]--

ConfigLicense = {
    license = "SUA KEY" -- KEY DO USUARIO
}

Config = {

    ["IMPORTANTE"] = {
	
        ["TempoTutorial"] = 5, -- TEMPO NECESSARIO AGUARDAR, PARA PASSAR PARA O PROXIMO TUTORIAL
        ["ComandoCopiarPosicao"] = "copiar", -- COMANDO PARA PEGAR A POSICAO DO LOCAL QUE VOCE DESEJA QUE A CAMERA MOSTRE NO TUTORIAL		
        ["ACLPermissao"] = "Console", -- ACL COM PERMISSÃO PARA UTILIZAR O COMANDO ACIMA		
        ["UsarTecla"] = true, -- COLOQUE COMO true PARA O JOGADOR CONSEGUIR PULAR OU VOLTAR O TUTORIAL, USANDO AS TECLAS DE SETINHA DO TECLADO

O que você pode alterar

Comece por estes campos. Eles são os pontos mais comuns de personalização para cliente final: permissões, comandos, teclas, valores, cores e posições. Se uma opção não estiver clara, mantenha o valor padrão.

TempoTutorial
O que você pode alterar: Altere para definir quanto tempo o jogador precisa aguardar antes de avançar para a próxima etapa.
Valor atual no Config.lua: 5
ComandoCopiarPosicao
O que você pode alterar: Altere o nome do comando usado para copiar a posição da câmera enquanto você monta o tutorial.
Valor atual no Config.lua: copiar
ACLPermissao
O que você pode alterar: Altere os nomes das ACLs para decidir quais grupos podem usar esta função. Exemplo: Admin, Console ou Staff.
Valor atual no Config.lua: Console
UsarTecla
O que você pode alterar: Altere para escolher a tecla usada nessa ação. Use uma tecla livre, como F5, F6 ou F7, para evitar conflito com outros painéis.
Valor atual no Config.lua: true (ligado)
AparecerPosLogin
O que você pode alterar: Use true para abrir o tutorial automaticamente depois do login. Use false se outro sistema for iniciar o tutorial.
Valor atual no Config.lua: true (ligado)
IrPosicaoFinal
O que você pode alterar: Altere as coordenadas para mover o ponto no mapa. Use a posição do seu personagem ou uma ferramenta de copiar coordenadas.
Valor atual no Config.lua: true (ligado)
PosicaoFimTutorial
O que você pode alterar: Altere as coordenadas para escolher onde o jogador aparece ao finalizar o tutorial.
Valor atual no Config.lua: {1480.612, -1730.684, 13.383+0.5}
CorTempoHEX
O que você pode alterar: Altere a cor em formato HEX, como #ff7a00. Use um seletor de cor se não souber montar o código.
Valor atual no Config.lua: #2490DA
CorTituloRGB
O que você pode alterar: Altere os números de cor. Em RGB/RGBA, cada canal vai de 0 a 255; o último número geralmente controla transparência.
Valor atual no Config.lua: {36, 144, 218, 255}
Subtitulo
O que você pode alterar: Altere o texto que aparece para o jogador. Mantenha uma frase curta e clara.
Valor atual no Config.lua: Neste local você tira suas habilitações
PosicaoCamera
O que você pode alterar: Altere as coordenadas para mover o ponto no mapa. Use a posição do seu personagem ou uma ferramenta de copiar coordenadas.
Valor atual no Config.lua: {1093.6291503906, -1721.3515625, 26.805400848389, 1093.1408691406, -1720.5649414062, 26....

Trechos úteis do Config.lua

Os trechos abaixo mostram onde os campos ficam no arquivo. Copie apenas como referência: no seu servidor, edite o Config.lua original e mantenha sua licença real somente nele.

Bloco principal
ConfigLicense = {
    license = "SUA KEY" -- KEY DO USUARIO
}

Config = {

    ["IMPORTANTE"] = {
	
        ["TempoTutorial"] = 5, -- TEMPO NECESSARIO AGUARDAR, PARA PASSAR PARA O PROXIMO TUTORIAL
        ["ComandoCopiarPosicao"] = "copiar", -- COMANDO PARA PEGAR A POSICAO DO LOCAL QUE VOCE DESEJA QUE A CAMERA MOSTRE NO TUTORIAL		
        ["ACLPermissao"] = "Console", -- ACL COM PERMISSÃO PARA UTILIZAR O COMANDO ACIMA		
        ["UsarTecla"] = true, -- COLOQUE COMO true PARA O JOGADOR CONSEGUIR PULAR OU VOLTAR O TUTORIAL, USANDO AS TECLAS DE SETINHA DO TECLADO	
        ["IrPosicaoFinal"] = true, -- DEIXE COMO true CASO QUEIRA QUE O SISTEMA DE TUTORIAL, TE SPAWNE EM ALGUM LUGAR DESEJADO APÓS A CONCLUSÃO DO TUTORIAL, DEIXE COMO false CASO NÃO QUEIRA	
        ["PosicaoFimTutorial"] = {1480.612, -1730.684, 13.383+0.5}, -- POSIÇÃO QUE O SISTEMA IRÁ SPAWNAR O JOGADOR APÓS ELE FINALIZAR O TUTORIAL ( CASO A OPÇÃO ACIMA ESTEJA COMO true )		
	
    },
	
    ["CORES"] = {
	
        ["CorTempoHEX"] = "#2490DA", -- COR PRINCIPAL DO PAINEL ( ATUALMENTE EM AZUL ) NO FORMATO HEX - UTILIZE O SELETOR DE COR DO GOOGLE PARA PEGAR A COR DESEJADA: https://g.co/kgs/5bLo56y	
		["CorTituloRGB"] = {36, 144, 218, 255}, -- COR PRINCIPAL DO PAINEL ( ATUALMENTE EM AZUL ) NO FORMATO RGB - UTILIZE O SELETOR DE COR DO GOOGLE PARA PEGAR A COR DESEJADA: https://g.co/kgs/5bLo56y
	
    },	

    ["LocaisTutorial"] = {
	
        [1] = {
            ["Titulo"] = "AUTOESCOLA",
            ["Subtitulo"] = "Neste local você tira suas habilitações",
            ["Descricao"] = "Tire habilitações A, B, C e D. \n Algumas profissões de nossa cidade requerem Habilitação. \n Além de que, ao ser pego por uma patrulha sem carteira, \n você pode acabar sendo conduzido pra Delegacia.",
            ["PosicaoCamera"] = {1093.6291503906, -1721.3515625, 26.805400848389, 1093.1408691406, -1720.5649414062, 26.427526473999, 0, 70}   
        },

Integrações

Este produto usa os scripts abaixo em alguma parte do Config.lua. Antes de iniciar o servidor, confira se eles existem com exatamente o mesmo nome na sua base.

  • [TS]Tutorial
  • dxmessages

Integração opcional para outros scripts

As funções abaixo servem apenas quando outro script precisa conversar com este produto. Se você só vai instalar e configurar o mod, pode deixar esta parte como referência.

Iniciar tutorial para um jogador
exports['[TS]Tutorial']:iniciarTutorial(player)

Checklist rápido

  • Preencha ConfigLicense.license com a chave correta.
  • Confira ACLs, permissões e comandos antes de liberar em produção.
  • Revise coordenadas de markers, blips e áreas no mapa do seu servidor.
  • Se houver integração com inventário, banco ou Discord, confirme os nomes dos scripts usados no seu servidor.
  • Reinicie o script e acompanhe o debug para validar a configuração.
Documentação baseada no Config.lua e no meta.xml presentes na cópia local analisada.