Introdução
Embora a documentação oficial do KBEngine contenha todas essas informações, decidi criar este guia como parte dos meus estudos sobre a ferramenta. Vamos começar pelo processo de instalação.
- Obtendo o Código-Fonte
O primeiro passo é acessar o repositório no GitHub e baixar a versão mais recente do código-fonte em formato compactado.
Para usuários do Windows, baixe o arquivo ZIP. Após o download, extraia o conteúdo usando o botão direito do mouse.
Após a extração, você encontrará três diretórios principais dentro da pasta KBEngine:
- assets/ - Contém os recursos do projeto de jogo, local onde você escreverá seus scripts
- docs/ - Documentação do KBEngine, incluindo manuais de uso e referência de API
- kbe/ - Core do KBEngine, contendo código principal, bibliotecas, configurações e ferramentas
Para mais detalhes sobre a estrutura de diretórios, consulte a documentação oficial.
- Compilação
Navegue até o diretório kbe/src.
No Windows, abra o arquivo de solução (.sln) no Visual Studio e compile todos os projetos.
No Linux, utilize o comando make no terminal. Packages necessários podem incluir gcc-c++, mysql-devel e kernel-devel. Caso encontre erros durante a compilação, instale as dependências faltantes conforme indicado nas mensagens de erro.
- Instalação
Execute o instalador usando o comando abaixo e siga as instruções na tela:
python kbengine/kbe/tools/server/install/installer.py install
No meu caso, utilizei o CentOS da Alibaba Cloud com RDS-MySQL, portanto não precisei instalar o MySQL localmente. Durante a instalação, forneci o endereço IP do banco de dados, porta, nome de usuário, senha e nome do banco de dados.
As configurações podem ser alteradas manualmente no arquivo kbe/res/server/kbengine_defaults.xml.
- Verificação de Versão, Atualização e Desinstalação
Após a instalação, você pode verificar a versão instalada com:
python kbengine/kbe/tools/server/install/installer.py version
Para atualizar para uma versão mais recente:
python kbengine/kbe/tools/server/install/installer.py update
Caso precise desinstalar:
python kbengine/kbe/tools/server/install/installer.py uninstall
- Inicialização e Encerramento do Servidor
Com tudo configurado, navegue até o diretório kbengine/assets.
Os scripts start_server.bat (Windows) ou start_server.sh (Linux) iniciam o conjunto de servidores.
Para encerrar, utilize kill_server.bat/sh. Alternativamente, recomenda-se usar safe_kill.bat/sh para um encerramento mais seguro.
Se tudo correu bem, você está pronto para criar um novo projeto de jogo no próximo capítulo.
- Configuração do Webconsole
O webconsole requer o Django. Como Python já foi instalado anteriormente, podemos utilizar o pip para instalar o Django facilmente.
Acesse o site oficial do pip em https://pypi.python.org/pypi/pip, baixe o arquivo compactado e extraia-o. Abra o terminal no diretório extraído e execute:
python setup.py install
Isso instalará o pip no diretório Lib do Python e configurará automaticamente as variáveis de ambiente.
Agora, instale o Django:
pip install Django
Recomenda-se instalar a versão 1.8.9:
pip install django==1.8.9
Para verificar a versão instalada:
pip show django
Para desinstalar:
pip uninstall django
Agora, navegue até o diretório kbe/tools/server/webconsole dentro da pasta do KBEngine. Edite os scripts run_server.bat e sync_db.bat, removendo o caminho absoluto como c:/xxx/ - como as variáveis de ambiente já foram configuradas, basta manter o comando python.
Após as modificações, execute primeiro sync_db.bat para sincronizar o banco de dados, e então run_server.bat para iniciar o servidor web.
Abra o navegador e acesso http://localhost:8000/wc/. Use as credenciais padrão fornecidas na tela inicial e altere a senha após o primeiro login. Em seguida, crie uma conta de administrador para gerenciar o servidor através do webconsole.