gamemode-openmp

Uma gamemode base de código aberto, simples, porém completa e em dia com as boas práticas de código e segurança.

---

Estrutura do Projeto

Nome	Descrição
compiler/include/	Contém as bibliotecas necessárias
components/	Contém os componentes (plugins que foram migrados para o open.mp)
plugins/	Contém os plugins SA-MP (plugins legado que ainda não foram migrados para o open.mp)
gamemodes/	Contém o arquivo compilado e o código fonte do script
.env	Contém as variáveis de ambiente contendo as credenciais do banco de dados MySQL
config.json	Contém as configurações do servidor open.mp. Para mais informações, veja a documentação oficial
omp-server	Executável que inicia o servidor
scheme.sql	Contém a estrutura da tabela SQL de jogadores e suas colunas

---

Vantagens

• Escalabilidade
• Criptografia de todas as senhas utilizando bcrypt
• Código limpo e bem documentado
• Fácil de configurar, exigindo apenas conhecimento extremamente básico em gerenciamento de banco de dados e Pawn

Funções

• Tela de login simples em dialog
• Sistema de escolha de gênero do personagem
• Salvamento da última posição do jogador no servidor

Compilação

Pré-requisitos

As versões pré-compiladas podem ser encontradas na página de releases.

Nas versões distribuídas, o servidor inclui uma pasta chamada Qawno, que é o ambiente de desenvolvimento padrão do open.mp, equivalente ao Pawno do SA-MP.

Passo-a-passo para compilar usando Qawno:

Abra o Qawno

Execute o arquivo qawno.exe que está na pasta baixada.

Abra o arquivo do script

No menu superior, clique em File > Open e navegue até a pasta gamemodes/. Selecione o arquivo Main.pwn.

Compile o script

Clique em Build > Compile ou pressione F5 no teclado.

Nota sobre Warnings

Se você optar por usar Qawno e sampvoice, pode ignorar os dois warnings que surgirem devido à versão do compilador do open.mp.

Caso prefira, adicione a linha abaixo no topo do script para suprimir esses warnings (embora eu não recomende esta abordagem uma vez que encoraja más práticas):

#pragma warning disable 239

Para Desenvolvedores Avançados

Recomendamos o uso do Visual Studio Code como ambiente de desenvolvimento.

Confira este tutorial para configurar o Visual Studio Code para compilar scripts Pawn: https://youtu.be/jITcf95XGgA

Escolhendo a Versão da Gamemode

Se você está confuso sobre qual versão escolher para o seu sistema operacional, veja abaixo:

Versões Disponíveis

• gamemode-win-x86

  • Descrição: Esta versão é para sistemas Windows.
  • Detalhes: Roda o servidor e seus plugins na arquitetura x86, que é o padrão para a maioria dos plugins.

• gamemode-x86-centos

  • Descrição: Esta versão é destinada à distribuição CentOS.
  • Detalhes: Certifique-se de que seu servidor utiliza o CentOS antes de escolher esta versão.

• gamemode-x86-debian

  • Descrição: Esta versão é para a distribuição Debian e distribuições baseadas em Debian.
  • Detalhes: Inclui suporte para distribuições como Ubuntu (a mais popular) e outras variantes baseadas em Debian.

Como Identificar Sua Distribuição Linux

Se você não tem certeza sobre qual distribuição Linux seu servidor está utilizando:

1. Consulte seu provedor de hospedagem.
2. Rode o comando abaixo no terminal para obter informações:

lsb_release -a

Esse comando exibirá a distribuição e a versão do sistema operacional.

Estrutura SQL

Tabela jogadores

Nome	Descrição
ID	ID númerico único gerado pelo banco de dados ao jogador se registrar (segue começando a partir de 0)
Nome	Nome/apelido do jogador
Hash	Hash gerado a partir da senha do jogador pelo bcrypt
X_Pos	Eixo X da última posição salva do jogador antes de se desconectar
Y_Pos	Eixo Y da última posição salva do jogador antes de se desconectar
Z_Pos	Eixo Z da última posição salva do jogador antes de se desconectar
Angle	Último ângulo/rotação do jogador registrado antes de se desconectar
Skin	ID da skin/roupa do jogador
Genero	Gênero do jogador (0 para masculino / 1 para feminino)

Licença

Copyright © SA-MP Programming Community

Este software é licenciado sob os termos da Licença MIT ("Licença"); você pode utilizar este software de acordo com as condições da Licença. Uma cópia da Licença pode ser obtida em: MIT License

Termos e Condições de Uso

1. Permissões Concedidas

A presente licença concede, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e arquivos de documentação associados, os seguintes direitos:

• Utilizar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender cópias do software sem restrições
• Permitir que pessoas para as quais o software é fornecido façam o mesmo, desde que sujeitas às condições a seguir

2. Condições Obrigatórias

Todas as cópias ou partes substanciais do software devem incluir:

• O aviso de direitos autorais acima
• Este aviso de permissão
• O aviso de isenção de responsabilidade abaixo

3. Direitos Autorais

O software e toda a documentação associada são protegidos por leis de direitos autorais. A SA-MP Programming Community mantém a titularidade dos direitos autorais originais do software.

4. Isenção de Garantias e Limitação de Responsabilidade

O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO VIOLAÇÃO.

EM NENHUMA CIRCUNSTÂNCIA OS AUTORES OU TITULARES DOS DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER REIVINDICAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM AÇÃO DE CONTRATO, DELITO OU DE OUTRA FORMA, DECORRENTE DE, FORA DE OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.

---

Para informações detalhadas sobre a Licença MIT, consulte: https://opensource.org/licenses/MIT