https://github.com/spc-samp/gamemode-openmp
Gamemode open.mp (Open Multiplayer) scalable open source code base that follows best practices.
https://github.com/spc-samp/gamemode-openmp
client-server gamemode open-mp pawn sa-mp sa-mp-development sa-mp-gamemode sa-mp-server samp
Last synced: 3 months ago
JSON representation
Gamemode open.mp (Open Multiplayer) scalable open source code base that follows best practices.
- Host: GitHub
- URL: https://github.com/spc-samp/gamemode-openmp
- Owner: spc-samp
- License: mit
- Created: 2024-12-09T03:51:04.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-02-01T02:56:32.000Z (4 months ago)
- Last Synced: 2025-02-01T03:28:18.534Z (4 months ago)
- Topics: client-server, gamemode, open-mp, pawn, sa-mp, sa-mp-development, sa-mp-gamemode, sa-mp-server, samp
- Language: Pawn
- Homepage:
- Size: 31.5 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
[](https://opensource.org/license/mit)
---
## 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](https://www.open.mp/docs/server/config.json) |
| `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](https://github.com/spc-samp/gamemode-openmp/releases/latest).
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):
```pawn
#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](https://opensource.org/licenses/MIT)
### 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