InSimDotNet
Instalação

Essa documentação foi baseada na versão 2.3.2 do InSimDotNet (opens in a new tab)

InSimDotNet

InSimDotNet é uma livraria compatível com o protocolo do InSim. Ela permite a comunicação com o jogo, através do envio de pacotes.
Você pode conferir o repositório oficial no GitHub clicando aqui (opens in a new tab).

Criando seu primeiro InSim

Primeiramente é necessário baixar e instalar o Visual Studio (opens in a new tab). Ele será a IDE (opens in a new tab) responsável pela codificação e criação do seu InSim.

Após baixar o Visual Studio Installer (disponibilizado pelo link acima), ele será o instalador responsável por gerenciar a instação da IDE, e dos pacotes que à complementam.

Ao abrir, quando perguntado sobre escolher as "Cargas de trabalho", selecione "Desenvolvimento para desktop com .NET", e clique em "Instalar".

Após a instalação, abra o Visual Studio e crie um novo projeto. Procure pela opção "Aplicação de Console (.NET Framework)", selecione o diretório do projeto e escolha a versão do .NET Framework.

⚠️

É importante que a versão do .NET Framework escolhida para o projeto seja a 4.5 ou acima.

Após a criação do projeto

Dentro do Visual Studio, procure pelo arquivo "Program.cs", ele será o arquivo responsável pelo código inicial do seu InSim.
Dentro dele provavelmente você encontrará um código semelhante à esse:

Program.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
 
namespace insim
{
    class Program
    {
        static void Main(string[] args)
        {
 
        }
    }
}
⚠️

É importante ter um conhecimento mínimo em C# (c-sharp) (opens in a new tab) antes de continuar o processo de criação do InSim.

Vamos começar adicionando o módulo do InSimDotNet, você pode baixar o zip clicando aqui (opens in a new tab).

Após baixar, extraia o arquivo InSimDotNet.dll para dentro da pasta do seu projeto (em qualquer pasta dentro do seu projeto).

Importe o módulo dentro do Visual Studio através do botão "Projeto" -> "Adicionar Referência" -> "Pequisar", escolha o arquivo que você baixou e clique em "OK".

Pronto! O módulo do InSimDotNet já está dentro do seu projeto, e está tudo pronto para seguir para a próxima etapa.

Inicializando o InSim

Importe o módulo do InSimDotNet para dentro do seu código, seguindo o exemplo:

using InSimDotNet;
// ... resto do código

Chame a função de inicialização do InSimDotNet dentro do void Main, passando alguns parametros:

InSim insim = new InSim();
 
insim.Initialize(new InSimSettings {
    Host = "127.0.0.1",
    Port = 29999,
    Admin = "",
    Prefix = '!',
    IName = 'insim'
});
 
insim.Send("/msg Hello, InSim!");

Host é o endereço IP do servidor em que você quer iniciar o InSim.
Port é a porta do InSim para conexão (a porta do InSim não é a mesma porta que você utiliza para ligar o servidor, geralmente ela é a porta 29999).
Admin é a senha de administrador do servidor, esse campo não é opcional caso o seu servidor possua senha de administrador.
Prefix é o prefixo para a recepção dos comandos.
IName é o nome do InSim (visivel apenas para o host ou jogador local), não pode conter mais de 16 caracteres.

Seu código final irá se assemelhar à esse:

Program.cs
using InSimDotNet;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
 
namespace insim
{
    class Program
    {
        static void Main(string[] args)
        {
            InSim insim = new InSim();
 
            while (true) // Esse while true serve para manter o programa aberto.
            {
                if (!insim.IsConnected) // Essa comparação serve para verficar se o InSim já está conectado. Sem ela o seu InSim iria iniciar infinitas vezes.
                {
                    insim.Initialize(new InSimSettings {
                        Host = "127.0.0.1",
                        Port = 29999,
                        Admin = "",
                        Prefix = '!',
                        IName = 'insim'
                    });
 
                    insim.Send("/msg Hello, InSim!");
                }
            }
        }
    }
}

Pronto! Compile seu projeto e abra o arquivo gerado.