SA-MP Injector

SA-MP Injector é uma ferramenta versátil projetada para SA-MP (San Andreas Multiplayer) e OMP (Open Multiplayer), funcionando tanto como um executável de linha de comando quanto uma biblioteca para diferentes linguagens. Sua função principal é injetar samp.dll (para SA-MP) ou ambas samp.dll e omp-client.dll (para OMP) no processo do GTA:SA, permitindo que o jogo seja iniciado com parâmetros personalizados para conexão direta a um servidor.

Idiomas

Deutsch: README
English: README
Español: README
Français: README
Italiano: README
Polski: README
Русский: README
Svenska: README
Türkçe: README

Índice

SA-MP Injector

Executável

O executável samp-injector.exe oferece uma interface de linha de comando para iniciar o GTA:SA com SA-MP ou OMP, configurando automaticamente a conexão a um servidor. Ele encapsula a lógica de injeção de DLLs e a passagem de parâmetros do jogo.

Funcionalidade

O samp-injector.exe opera como um iniciador de jogo automatizado, abstraindo as complexidades de configuração e injeção de DLL:

Validação de Ambiente: Verifica a existência dos arquivos essenciais (gta_sa.exe, samp.dll, omp-client.dll) no diretório especificado, além de validar os parâmetros de conexão fornecidos.
Criação de Processo Suspenso: Inicia gta_sa.exe em estado suspenso, um pré-requisito para injetar as DLLs de forma segura antes que o processo principal do jogo seja executado.
Injeção Dinâmica de DLLs:
- Para o modo SA-MP, samp.dll é injetada.
- Para o modo OMP, samp.dll e omp-client.dll são injetadas. A injeção é facilitada pela invocação da função LoadLibraryA remotamente, permitindo que o GTA: SA carregue os módulos multiplayer e inicialize a conexão.
Configuração de Argumentos: Argumentos de linha de comando, como nickname, IP do servidor, porta e senha (se fornecida), são preparados e passados para o gta_sa.exe.
Retomada do Processo: Após a injeção bem-sucedida das DLLs, o processo do jogo é retomado para execução normal, levando o GTA:SA a conectar-se diretamente ao servidor.

Como Usar (Linha de Comando)

Para utilizar o executável, invoque-o a partir do Prompt de Comando (CMD), PowerShell ou terminal, fornecendo os parâmetros necessários.

O formato básico é:

samp-injector.exe <modo> <diretorio_jogo> <nickname> <IP_servidor> <porta_servidor> <senha_servidor (opcional)>

Modo SA-MP

Para injeção exclusiva de samp.dll:

samp-injector.exe "samp" "C:\Games\GTA San Andreas" "Nome" "127.0.0.1" "7777" "senha (opcional)"

Modo OMP

Para injeção de samp.dll e omp-client.dll:

samp-injector.exe "omp" "C:\Games\GTA San Andreas" "Nome" "127.0.0.1" "7777" "senha (opcional)"

Parâmetros

<modo>: Define o tipo de injeção.
- samp: Para SA-MP (samp.dll).
- omp: Para OMP (samp.dll e omp-client.dll).
<diretorio_jogo>: O caminho completo para o diretório do GTA:SA. Este diretório deve conter gta_sa.exe e os respectivos arquivos de DLL.
<nickname>: Seu apelido no jogo (máximo de 20 caracteres).
<IP_servidor>: O endereço IP ou nome de domínio do servidor.
<porta_servidor>: A porta de conexão do servidor (um valor numérico entre 1 e 65535).
<senha_servidor>: A senha necessária para conectar-se ao servidor (se o servidor não tiver senha, não é necessário adicionar esse parâmetro).

Caso os argumentos estejam incorretos ou insuficientes, uma mensagem de uso será exibida.

Como Usar (Embutido em Aplicações)

O samp-injector.exe é ideal para integração em aplicações de terceiros, como launchers personalizados, que desejam automatizar o processo de iniciar o jogo com configurações predefinidas.

Exemplo de invocação do samp-injector.exe a partir de uma aplicação C#:

using System;
using System.Diagnostics;
using System.Windows.Forms;

public class Launcher {
    public static void Main(string[] args) {
        string inject_mode = "omp"; 
        string folder = "C:\\Games\\GTA San Andreas";
        string nickname = "Nome";
        string ip = "127.0.0.1";
        string port = "7777";
        string password = "senha (opcional)";

        try {
            string arguments = $"{inject_mode} \"{folder}\" \"{nickname}\" \"{ip}\" {port}";

            if (!string.IsNullOrEmpty(password))
                arguments += $" \"{password}\"";

            ProcessStartInfo start_info = new ProcessStartInfo {
                FileName = "samp-injector.exe", 
                Arguments = arguments,
                UseShellExecute = false,
                CreateNoWindow = true 
            };

            using (Process process = Process.Start(start_info)) {
                process.WaitForExit(); 

                if (process.ExitCode != 0)
                    MessageBox.Show($"O SA-MP Injector retornou um erro (Código: {process.ExitCode}). O jogo pode não ter sido iniciado corretamente.", "Erro no Lançamento", MessageBoxButtons.OK, MessageBoxIcon.Error);
            }
        }
        catch (Exception ex) {
            MessageBox.Show($"Ocorreu um erro ao iniciar o jogo: {ex.Message}", "Erro", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

Utilizando a Biblioteca C++ no Executável

O executável samp-injector.exe é construído sobre a biblioteca SA-MP Injector C++, que reside no diretório libraries/cpp/. O main.cpp do executável invoca as funcionalidades dessa biblioteca para realizar a injeção e o lançamento do jogo.

O principal arquivo de cabeçalho da biblioteca C++ a ser incluído é libraries/samp-injector/cpp/injector.hpp. Como a biblioteca SA-MP Injector C++ é header-only, sua utilização requer apenas a inclusão desse cabeçalho no código-fonte, sem a necessidade de linkar um arquivo .lib.

O trecho relevante do main.cpp que demonstra a integração é o seguinte:

// Extrai os argumentos da linha de comando
int argc;
std::unique_ptr<LPWSTR[], decltype(&LocalFree)> argv(CommandLineToArgvW(GetCommandLineW(), &argc), &LocalFree);

// ... (validação do número de argumentos e modo de injeção) ...

// Extrai os parâmetros para as variáveis wide string
std::wstring folder = argv[2];
std::wstring nickname = argv[3];
std::wstring ip = argv[4];
std::wstring port = argv[5];
std::wstring password = (argc == 7) ? argv[6] : L"";

// Delega a lógica de injeção para a função "Initialize_Game" da biblioteca
// Observe que "injector.hpp" foi incluído previamente no "main.cpp"
if (!Initialize_Game(inject_type, folder, nickname, ip, port, password))
    return 1;

Sleep(10000); // Aguarda antes de finalizar o executável

A função Initialize_Game atua como a interface de alto nível da biblioteca, orquestrando todas as operações de validação, criação de processo e injeção de DLLs.

Como Compilar

Você pode compilar o samp-injector.exe a partir do código fonte. Se você não deseja compilar, pode baixar as versões pré-compiladas na seção de Releases.

Requisitos

Visual Studio: Recomenda-se Visual Studio 2022 ou superior com a workload "Desenvolvimento para desktop com C++" instalada.
Git: Para clonar o repositório (ou simplesmente fazer o download acessando este link: Donwload).

Passos de Compilação

Clone o Repositório:

git clone https://github.com/spc-samp/samp-injector.git
cd samp-injector

Abra a Solução:

Navegue até a pasta executable e abra o arquivo de solução .sln:
```
cd executable
start samp-injector.sln
```
Isso abrirá o projeto no Visual Studio.
Configurar Build:
- No Visual Studio, verifique a configuração da solução. Recomenda-se utilizar os modos Release e x86 (32 bits). No contexto do GTA:SA e SA-MP/OMP, a arquitetura x86 (32 bits) é obrigatória.
Compilar:
- No menu Compilation, clique em Compile Solution ou em Build samp-injector.
- Alternativamente, você pode usar os atalhos:
  - Ctrl + Shift + B para compilar a solução completa.
  - Ctrl + B (caso esteja configurado) para compilar o projeto atual.
- Se tudo estiver configurado corretamente, o executável samp-injector.exe será gerado no diretório executable\Release (ou executable\Debug, dependendo da sua configuração de build).

Bibliotecas

As bibliotecas são os componentes fundamentais do SA-MP Injector, contendo a lógica central para manipulação de processos, injeção de DLLs e validação de parâmetros. A principal vantagem de usar essas bibliotecas é a facilidade na inicialização e injeção, geralmente através de uma única função (ou chamadas com parâmetros específicos para linguagens de script).

Visão Geral

O projeto é construído sobre bibliotecas que encapsulam as funcionalidades críticas. Isso permite que outros projetos integrem facilmente a capacidade de iniciar o GTA:SA com os módulos multiplayer necessários.

Listagem de Bibliotecas

Linguagem	Nome	Link para Biblioteca/Documentação
C++	SA-MP Injector C++	Conferir Biblioteca
C	SA-MP Injector C	(Em breve)
C#	SA-MP Injector C#	(Em breve)
Java	SA-MP Injector Java	(Em breve)
Python	SA-MP Injector Python	(Em breve)
Go (Golang)	SA-MP Injector Go	(Em breve)
Rust	SA-MP Injector Rust	(Em breve)
Kotlin	SA-MP Injector Kotlin	(Em breve)
Scala	SA-MP Injector Scala	(Em breve)
Lua	SA-MP Injector Lua	(Em breve)
Ruby	SA-MP Injector Ruby	(Em breve)
Visual Basic	SA-MP Injector VB	(Em breve)
F#	SA-MP Injector F#	(Em breve)
Pascal/Delphi	SA-MP Injector P/D	(Em breve)
PowerShell	SA-MP Injector PS	(Em breve)
D (Dlang)	SA-MP Injector D	(Em breve)
Nim	SA-MP Injector Nim	(Em breve)
Zig	SA-MP Injector Zig	(Em breve)
V (VLang)	SA-MP Injector V	(Em breve)
Crystal	SA-MP Injector Crystal	(Em breve)
Perl	SA-MP Injector Perl	(Em breve)
Racket (Lisp)	SA-MP Injector Racket	(Em breve)
Haskell	SA-MP Injector Haskell	(Em breve)
OCaml	SA-MP Injector OCaml	(Em breve)

Tip

A documentação detalhada para cada biblioteca estará disponível em seu respectivo diretório.

Licença

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

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
executable		executable
libraries/cpp		libraries/cpp
translations		translations
LICENSE		LICENSE
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

SA-MP Injector

Idiomas

Índice

Executável

Funcionalidade

Como Usar (Linha de Comando)

Modo SA-MP

Modo OMP

Parâmetros

Como Usar (Embutido em Aplicações)

Utilizando a Biblioteca C++ no Executável

Como Compilar

Requisitos

Passos de Compilação

Bibliotecas

Visão Geral

Listagem de Bibliotecas

Licença

Termos e Condições de Uso

1. Permissões Concedidas

2. Condições Obrigatórias

3. Direitos Autorais

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

About

Uh oh!

Releases 1

Uh oh!

Languages

License

spc-samp/samp-injector

Folders and files

Latest commit

History

Repository files navigation

SA-MP Injector

Idiomas

Índice

Executável

Funcionalidade

Como Usar (Linha de Comando)

Modo SA-MP

Modo OMP

Parâmetros

Como Usar (Embutido em Aplicações)

Utilizando a Biblioteca C++ no Executável

Como Compilar

Requisitos

Passos de Compilação

Bibliotecas

Visão Geral

Listagem de Bibliotecas

Licença

Termos e Condições de Uso

1. Permissões Concedidas

2. Condições Obrigatórias

3. Direitos Autorais

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

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Uh oh!

Languages