Guia de desenvolvimento do KillbotsÍndice
Os indivíduos interessados poderão personalizar o Killbots de duas formas importantes: temas e conjuntos de regras.
Como na maioria dos outros jogos do KDE, um tema do Killbots consiste em três arquivos.
O arquivo 'desktop' segue a sintaxe-padrão do INI e é usado para guardar as informações sobre o tema e para apontar para os outros arquivos. Segue-se um tema de exemplo.
Exemplo 4.1. O Arquivo 'Desktop' de um Tema de Exemplo
[KGameTheme]
Name=Tema de Exemplo
Description=Um tema de exemplo para demonstrar a criação de temas. Este oferece piratas.
Author=Sr. Artista
AuthorEmail=senhor.artista@exemplo.com
Type=SVG
FileName=exemplo.svg
Preview=exemplo.png
Os primeiros quatro parâmetros contêm metadados sobre eles e são relativamente simples de entender. Para os temas do Killbots, o parâmetro Type deverá ser igual a SVG. Os dois últimos parâmetros contêm os nomes dos outros dois arquivos do tema. Embora não sejam estritamente necessários, por razões de consistência, todos os três arquivos compartilham o mesmo nome de base.
O arquivo de visualização é apenas um arquivo PNG que contém uma visualização do tema. A imagem de visualização deverá ter um tamanho de 240 por 1140 pixels e corresponder ao layout da visualização do tema padrão o mais possível, uma vez que isto facilita a comparação dos temas no seletor.
O arquivo SVG é um arquivo de gráficos vetoriais escaláveis que contém os elementos gráficos que são usados para compor o tema. O arquivo tanto poderá estar no formato não-comprimido .svg ou no formato comprimido .svgz. Cada elemento do jogo é identificado por um ID único no arquivo SVG. Ao criar um tema novo, normalmente é mais fácil começar com um tema existente e substituir os elementos um-a-um, até que o tema esteja completo. O arquivo SVG deverá conter os seguintes elementos.
plano de fundoA imagem apresentada atrás da grade na área de jogo principal.
statusA área usada para mostrar a rodada atual, a pontuação, o número de inimigos e a energia.
textcolorEste elemento deverá ser um retângulo com uma cor única. A sua cor é usada para o texto das áreas de estado.
célulaUma célula individual da grade.
heróiA personagem controlada pelo jogador.
inimigoO inimigo básico.
fastenemyO inimigo mais rápido.
junkheapO que resta de uma colisão entre inimigos.
cursor0Um cursor que indica um movimento para a direita.
cursor1Um cursor que indica um movimento para cima e para a direita.
cursor2Um cursor que indica um movimento para cima.
cursor3Um cursor que indica um movimento para cima e para a esquerda.
cursor4Um cursor que indica um movimento para a esquerda.
cursor5Um cursor que indica um movimento para baixo e para a esquerda.
cursor6Um cursor que indica um movimento para baixo.
cursor7Um cursor que indica um movimento para baixo e para a direita.
cursor8Um cursor que indica a permanência no mesmo lugar.
Para que o Killbots detecte e use um tema novo, os arquivos deverão ser movidos para uma pasta apropriada. Para instalar o tema apenas no usuário atual, copie os arquivos 'desktop', SVG e de visualização para killbots/themes na pasta local em qtpaths . Para disponibilizar o tema para todo o sistema, mova os arquivos para --paths LocalizaçãoDeDadosGenéricakillbots/themes na pasta do sistema (do comando anterior, possivelmente /usr/share). Neste caso será necessário ter privilégios de administração.