Aprenda FiveM Scripting (LUA): sua entrada no mundo do modding

Olá, aspirante a desenvolvedor!

Você já sonhou em criar suas próprias modificações de jogo em Grand Theft Auto V para criar? Você quer criar experiências de jogo únicas e compartilhar suas ideias com o mundo? Então você veio ao lugar certo! Neste guia mostrarei como Script FiveM em Lua começar. Não se preocupe, vou explicar tudo o que você precisa saber passo a passo.

O que é FiveM?

CincoM é uma modificação para GTA Vque permite que os jogadores joguem em servidores multijogador personalizados. Com o FiveM você pode criar seus próprios servidores, projetados exatamente do jeito que você quiser. A melhor parte? Você pode usar Scripts Lua personalize a jogabilidade, adicione novos recursos e mude completamente a experiência de jogo.

Por que Lua?

Lua é uma linguagem de script leve e fácil de aprender. É perfeito para iniciantes e é frequentemente usado em jogos para criar modificações e extensões. Com Lua, você pode ver resultados rapidamente sem ter que lidar com sintaxe complexa.

Requisitos

Antes de começar, certifique-se de ter o seguinte:

• Conhecimento básico de programação:Se você já programou antes, será mais fácil começar.
• GTA V instalado no seu PC.
• Cliente FiveM instalado.
• Um simples editor de texto (por exemplo, Notepad++, Visual Studio Code).

Seu primeiro script: “Olá Mundo”

Vamos começar com algo simples. Criamos um script que exibe uma mensagem no jogo.

Etapa 1: Criar estrutura de diretório

1. Acesse o diretório do seu servidor FiveM.
2. Crie uma nova pasta chamada Olá mundo.
3. Nesta pasta, crie um arquivo chamado __recurso.lua ou fxmanifest.lua (dependendo da versão do FiveM).

Etapa 2: Crie fxmanifest.lua

Para versões mais recentes do FiveM, usamos fxmanifest.lua.

-- fxmanifest.lua
fx_version 'cerúleo'
jogo 'gta5'

scripts_cliente {
    'cliente.lua'
}

Etapa 3: Crie client.lua

Crie um arquivo chamado cliente.lua e adicione o seguinte código:

-- cliente.lua
Cidadão.CreateThread(função()
    enquanto verdadeiro faça
        Cidadão.Espere(0)
        DrawTextOnScreen("Olá, mundo FiveM!", 0.5, 0.5)
    fim
fim)

função DrawTextOnScreen(texto, x, y)
    DefinirTextoFonte(4)
    DefinirEscalaDeTexto(0,0, 0,5)
    DefinirCorTexto(255, 255, 255, 255)
    DefinirCentroDeTexto(verdadeiro)
    DefinirEntradaDeTexto("STRING")
    AddTextComponentString(texto)
    DesenharTexto(x, y)
fim

Etapa 4: ativar o script

1. Abra isso servidor.cfg seu servidor FiveM.
2. Adicionar iniciar olá-mundo adicionado.

Etapa 5: iniciar e testar o servidor

Inicie seu servidor FiveM e conecte-se. Agora você deve ver a mensagem “Olá, mundo FiveM!” no meio da tela.

explicação do código

O código pode parecer um pouco intimidador no começo, mas não se preocupe, eu vou explicá-lo para você.

• Cidadão.CriarFio: Cria um novo thread que é executado em paralelo.
• enquanto verdadeiro faça: Um loop infinito que é executado continuamente.
• Cidadão.Espere(0): Aguarde 0 milissegundos para não bloquear o loop.
• DesenharTextoNaTela: Uma função que definimos para exibir texto na tela.

Scripts de cliente vs. servidor

Existem dois tipos de scripts no FiveM:

• scripts de cliente: Em execução no computador do jogador.
• scripts de servidor: Em execução no servidor.

Dependendo do que você deseja alcançar, você precisa posicionar seu roteiro adequadamente.

Exemplo: Enviar uma mensagem a todos os jogadores (script do servidor)

Crie um arquivo chamado servidor.lua e adicione-os em seu fxmanifest.lua adicionado:

fx_version 'cerúleo'
jogo 'gta5'

scripts_cliente {
    'cliente.lua'
}

scripts_do_servidor {
    'servidor.lua'
}

-- servidor.lua
AddEventHandler('playerConnecting', função(nome, setKickReason, adiamentos)
    print(nome .. " conecta ao servidor.")
    TriggerClientEvent('chat:addMessage', -1, {
        args = { "SERVIDOR", nome .. " entrou no servidor." }
    })
fim)

Agora, toda vez que um jogador entrar no servidor, uma mensagem será enviada a todos os jogadores.

Eventos e Nativos

O que são eventos?

Eventos são ações ou ocorrências que ocorrem no jogo, como quando um jogador entra, pressiona um botão ou entra em um veículo. Você pode reagir a esses eventos e fazer com que seu roteiro aja de acordo.

O que são nativos?

Nativos são funções fornecidas pelo FiveM para interagir com o jogo. Eles permitem que você manipule coisas como posições dos jogadores, dados do veículo e muito mais.

Exemplo: Teletransportando jogadores

-- cliente.lua
RegisterCommand('teleport', função(fonte, argumentos)
    local x = tonumber(args[1])
    local y = tonumber(args[2])
    local z = tonumber(args[3])
    se x e y e z então
        DefinirCoordenadasEntidade(PlayerPedId(), x, y, z)
    outro
        print("Por favor, insira coordenadas válidas.")
    fim
fim)

Com este comando /teletransporte xyz você pode teletransportar seu jogador para qualquer coordenada.

Criar recursos

No FiveM, Roteiros como recursos designado. Um recurso pode consistir em vários scripts, arquivos e ativos.

Exemplo: Gerador de Veículos

Vamos criar um script simples para gerar um veículo.

-- cliente.lua
RegisterCommand('spawncar', função(fonte, argumentos)
    local vehicleName = args[1] ou 'adder'

    RequestModel(nomedoveículo)

    enquanto não HasModelLoaded(vehicleName) faça
        Cidadão.Espere(0)
    fim

    jogadorPed local = PlayerPedId()
    posição local = GetEntityCoords(playerPed)

    veículo local = CreateVehicle(vehicleName, pos.x, pos.y, pos.z, GetEntityHeading(playerPed), true, false)
    SetPedIntoVehicle(jogadorPed, veículo, -1)
fim)

Agora você pode /spawncar [nome do veículo] gerar um veículo.

Dicas para seguir em frente

• Experimentar: Altere valores, adicione funções e veja o que acontece.
• Usar documentação: A documentação do FiveM e a Referência Nativa são seus melhores amigos.
• Junte-se à Comunidade: Participe dos fóruns FiveM e servidores Discord para obter ajuda e inspiração.

Palavra final

Parabéns! Você deu seu primeiro passo no mundo do script FiveM. Lembre-se de que todo especialista já foi um iniciante. Com paciência e prática você logo dominará técnicas complexas Roteiros que enriquecem a experiência de jogo para você e para os outros.

Então o que você está esperando? Mergulhe, experimente e divirta-se programando!