Guía de Killbots para el desarrolladorTabla de contenidos
Los individuos que estén interesados pueden personalizar Killbots de dos formas principales: con temas y con reglas de juego.
Como la mayoría de juegos para KDE, un juego de Killbots consiste en tres archivos.
El archivo de escritorio sigue la sintaxis estándar INI. Los pares tecla-valor almacenan información sobre el tema y apuntan a los demás archivos incluidos en el tema. El siguiente ejemplo está tomado del tema predeterminado.
Ejemplo 4.1. Ejemplo de archivo de tema de escritorio
[KGameTheme]
Name=Tema de ejemplo
Description=Tema de ejemplo utilizado para demostrar la creación de temas. Este nos muestra piratas.
Author=Mr. Artist
AuthorEmail=mrartist@example.com
Type=SVG
FileName=example.svg
Preview=example.png
Los primeros cuatro parámetros contienen metadatos sobre el tema y son lo suficientemente sencillos. Para los temas de Killbots, el parámetro Tipo siempre debería establecerse en SVG. Los dos parámetros finales contienen los nombres de archivo de los otros dos archivos de tema. Si bien no es estrictamente necesario, es altamente recomendable que, por consistencia, los tres archivos compartan el mismo nombre.
El archivo de vista previa es sencillamente un archivo PNG que contiene una vista previa del tema. La imagen de vista previa debería ser de 240 por 140 píxeles y coincidir lo más posible con la distribución de la vista previa del tema predeterminado, ya que esto hace más fácil comparar los temas en el selector.
El archivo SVG es una imagen vectorial de gráficos escalable que contiene los elementos gráficos reales para realizar el tema. El archivo puede estar en formato sin comprimir .svg, o comprimido como .svgz. Cada elemento del juego se identifica con una id única en el archivo SVG Cuando cree un nuevo tema, generalmente es más fácil empezar con uno existente y reemplazar los elementos uno por uno hasta que el tema esté completo. El archivo SVG debe contener los siguientes elementos.
fondoLa imagen mostrada tras la rejilla en el área principal de juego.
estadoLa caja utilizada para mostrar la ronda actual, puntuación, recuento de enemigos y energía.
color del textoEste elemento debería ser un rectángulo de un solo color. Este color se usa para el texto de las cajas de estado.
celdaUna celda individual de la rejilla.
héroeEl personaje controlado por el jugador.
enemigoEl enemigo básico.
enemigo rápidoEl enemigo más rápido.
montón de chatarraLos restos de una colisión entre enemigos.
cursor0Un cursor que indica movimiento hacia la derecha.
cursor1Un cursor que indica movimiento en diagonal arriba a la derecha.
cursor2Un cursor que indica movimiento hacia arriba.
cursor3Un cursor que indica un movimiento en diagonal arriba a la izquierda.
cursor4Un cursor que indica movimiento hacia la izquierda.
cursor5Un cursor que indica movimiento en diagonal hacia abajo a la izquierda.
cursor6Un cursor que indica movimiento hacia abajo.
cursor7Un cursor que indica movimiento hacia abajo a la derecha.
cursor8Un cursor que indica quedarse en el mismo sitio.
Para que Killbots detecte y use un nuevo tema, los archivos deben moverse a un directorio apropiado. Para instalar el tema solo para el usuario actual, copie los archivos de escritorio, vista previa y SVG en killbots/themes dentro de la carpeta local qtpaths . Para hacer que el tema esté disponible para todo el sistema, mueva los archivos a --paths GenericDataLocation killbots/themes en la carpeta del sistema (de la orden anterior, posiblemente /usr/share/). Tenga en cuenta que esto requerirá probablemente privilegios de administrador.