Entwicklerhandbuch zu KillbotsInhaltsverzeichnis
Interessierte Spieler können eigene Designs und Regeln für Killbots erstellen.
Wie die meisten anderen KDE-Spiele bestehen die Designs von Killbots aus drei Dateien.
Die .desktop-Datei folgt der INI-Syntax. In ihr werden die Informationen zum Design und die Verweise auf die dazu gehörenden Dateien gespeichert. Das folgende Beispiel stammt vom standardmäßigen Design.
Beispiel 4.1. Ein Beispiel für eine .desktop-Datei
[KGameTheme]
Name=Beispiel für ein Design
Description=Ein Beispiel für ein Designs mit Piraten.
Author=Der Verfasser
AuthorEmail=verfasser@beispiel.de
Type=SVG
FileName=beispiel.svg
Preview=beispiel.png
Die ersten vier Parameter enthalten die Metadaten zum Design und sind selbsterklärend. Bei Designs für Killbots sollte der Parameter Type immer auf SVG gesetzt werden. Die beiden letzten Parameter enthalten die Dateinamen der beiden anderen Dateien für das Design. Es ist nicht unbedingt notwendig allen Dateien den gleichen Basisnamen zuzuordnen und ist somit nur aus Gründen der Einheitlichkeit empfehlenswert.
Die PNG-Datei enthält die Vorschau des Designs. Sie sollte eine Größe von 240 x 140 Pixel haben und der Vorschau des standardmäßigen Designs entsprechen, damit die Designs im Auswahldialog leichter verglichen werden können.
Die SVG-Datei ist eine skalierbare Vektorgrafik mit den grafischen Elementen für das Design und kann entweder im unkomprimierten .svg- oder komprimierten .svgz-Format verwendet werden. Jedes Element wird durch ein einzigartige Identifikationsnummer in der SVG-Datei bestimmt. Beim Erstellen eines neuen Designs ist es der einfachste Weg die Elemente eines bestehenden Designs nacheinander auszutauschen bis das neue Design fertig gestellt ist. Die SVG-Datei muss die folgenden Elemente enthalten:
backgroundDas hinter dem Spielfeld angezeigte Bild.
statusDer Kasten für die Anzeige der Runde, Punkte, Gegneranzahl und Energie.
textcolorDieses Element sollte ein einfarbiges Rechteck sein und wird für den Text in der Statusanzeige verwendet.
cellEine einzelne Zelle des Spielfeldes.
heroDie vom Spieler kontrollierte Figur.
enemyDie Figur für den einfachen Gegner.
fastenemyDie Figur für den schnellen Gegner.
junkheapDie Figur für die Reste zerstörter Gegner (= Müllhalde).
cursor0Der Cursor für die Bewegung nach rechts.
cursor1Der Cursor für die schräge Bewegung nach rechts-oben.
cursor2Der Cursor für die Bewegung nach oben.
cursor3Der Cursor für die schräge Bewegung nach links-oben.
cursor4Der Cursor für die Bewegung nach links.
cursor5Der Cursor für die schräge Bewegung nach links-unten.
cursor6Der Cursor für die Bewegung nach unten.
cursor7Der Cursor für die schräge Bewegung nach rechts-unten.
cursor8Der Cursor für das Stehenbleiben.
Damit Killbots neue Designs erkennen und verwenden kann, müssen sich die Dateien in einem geeigneten Ordner befinden. Um das Design nur einem bestimmten Benutzer zugänglich zu machen, müssen die .desktop-, .png- und .svg-Datei in den lokalen Ordner killbots/themes in qtpaths installiert werden. Für die Bereitstellung für alle Benutzer des Systems müssen die Dateien in den Systemordner --paths GenericDataLocation killbots/themes aus dem vorherigen Befehl wie zum Beispiel /usr/share oder ähnlich installiert werden. Dazu sind Rechte als Systemverwalters notwendig.