mateusware/kainure-gamemode

kainure-gamemode

Gamemode Base para um Framework para o desenvolvimento moderno de SA-MP com JavaScript e TypeScript.

1. O que é o Kainure?

O Kainure é um framework que serve como uma ponte entre o tradicional San Andreas: Multiplayer (SA-MP) e o desenvolvimento de software moderno. Ele permite que você escreva toda a lógica do seu gamemode utilizando JavaScript ou TypeScript, abrindo um universo de possibilidades com ferramentas, pacotes e práticas de desenvolvimento atuais.

O plugin integra um ambiente Node.js diretamente no seu servidor SA-MP. A versão específica do Node.js utilizada é a v22.21.1, que traz consigo o poder de componentes de alta performance:

• Motor V8: O mesmo motor JavaScript de alta performance do Google Chrome, garantindo que seu código seja executado com velocidade e eficiência impressionantes.
• libuv: Uma biblioteca de suporte que gerencia o I/O (operações de entrada e saída) de forma assíncrona, permitindo que seu servidor lide com múltiplas operações simultaneamente sem travar, ideal para um ambiente de jogo dinâmico.

Com o Kainure, você pode deixar de lado as limitações do Pawn e abraçar um ecossistema robusto para criar gamemodes mais complexos, organizados e fáceis de manter.

2. Informações importantes

2.1- Para que um servidor ligue e funcione corretamente utilizando o Kainure, alguns arquivos e configurações são obrigatórios. Requisitos estes: O servidor não inicia sem um gamemode válido, ou seja é necessário existir no mínimo um arquivo compilado (.amx) dentro da pasta gamemodes/, contendo uma função main(){}.

Caso não tenha um arquivo contendo essa função, o server_log.txt terá essa mensagem:

I couldn't load any gamemode scripts. Please verify your server.cfg
It needs a gamemode0 line at the very least.

Vale ressaltar que não necessidade de se preocupar com isso, já que ESSA gamemode base deste repósitorio, contém main.amx incluso dentro da pasta gamemodes/.

2.2- Não há necessidade de compilação como tsc --build ou mesmo npm compile, o framework já faz isso AUTOMÁTICAMENTE. 2.3- Assim como qualquer outra gamemode, você precisa do samp-server e os outros arquivos derivados dele, não disponibilizamos os mesmos aqui, por questões éticas. baixe os executáveis em: https://sa-mp.mp/create-server/ 2.4- Caso não sabe como configurar corretamente os arquivos ou algo do gênero, clique aqui (DOCUMENTAÇÃO OFICIAL DO FRAMEWORK): Estrutura de Arquivos Configuração (config.json) API e Funcionalidades