Utvecklingsguide till KillbotsInnehållsförteckning
Intresserade personer kan anpassa Killbots på två huvudsakliga sätt: teman och regeluppsättningar.
Som för de flesta andra spel i KDE, består ett tema i Killbots av tre filer.
Skrivbordsfilen följer den vanliga INI-syntaxen, och används för att lagra information om temat och för att peka på andra filer. Det följande är ett exempel på ett tema.
Exempel 4.1. Ett exempel på temaskrivbordsfil
[KGameTheme]
Name=Example Theme
Name[sv]=Exempeltema
Description=An example theme used to demonstrate theme creation. This one features pirates.
Description[sv]=Ett exempeltema använt för att demonstrera hur teman skapas. Det här innehåller pirater.
Author=Mr. Artist
AuthorEmail=mrartist@example.com
Type=SVG
FileName=exempel.svg
Preview=exempel.png
De fyra första parametrarna innehåller metadata om temat och är rättframma nog. För teman i Killbots ska parametern Type alltid vara inställd till SVG. De sista två parametrarna innehåller filnamn på de andra två temafilerna. Även om det inte är helt nödvändigt, rekommenderas att alla tre filer delar samma basnamn, för att vara konsekvent.
Förhandsgranskningsfilen är helt enkelt en PNG-fil som innehåller en förhandsgranskning av temat. Förhandsgranskningen ska vara 240 gånger 140 bildpunkter och motsvara standardtemats layout så nära som möjligt, eftersom det gör det enklare att jämföra teman i temaväljaren.
SVG-filen är en bild i skalbar vektorgrafik som innehåller själva de grafiska element som används för att skapa temat. Filen kan antingen ha okomprimerat .svg eller komprimerat .svgz format. Varje spelelement identifieras av en unik identifierare i SVG-filen. När ett nytt tema skapas, är det i allmänhet enklast att starta med ett befintligt tema och ersätta elementen ett i taget till temat är fullständigt. SVG-filen måste innehålla följande element.
backgroundBilden som visas bakom rutnätet i spelets huvudområde.
statusRutan som används för att visa aktuell omgång, poäng, antal fiender och energi.
textcolorElementet ska vara en rektangel med en enda färg. Dess färg används för texten i statusrutorna.
cellEn individuell cell i rutnätet.
heroPersonen som styrs av spelaren.
enemyDen vanliga fienden.
fastenemyDen snabbare fienden.
junkheapÅterstoden av en kollision mellan fiender.
cursor0En markör som anger förflyttning åt höger.
cursor1En markör som anger diagonal förflyttning uppåt och åt höger.
cursor2En markör som anger förflyttning uppåt.
cursor3En markör som anger diagonal förflyttning uppåt och åt vänster.
cursor4En markör som anger förflyttning åt vänster.
cursor5En markör som anger diagonal förflyttning neråt och åt vänster.
cursor6En markör som anger förflyttning neråt.
cursor7En markör som anger diagonal förflyttning neråt och åt höger.
cursor8En markör som anger att förbli stillastående.
För att Killbots ska detektera och använda ett nytt tema måste filerna flyttas till en lämplig katalog. För att bara installera temat för nuvarande användare, kopiera skrivbordsfilen, förhandsgranskningen och SVG-filen till killbots/themes i den lokala katalogen qtpaths . För att göra regeluppsättningen tillgänglig i hela systemet, flytta filen till --paths GenericDataLocation killbots/themes i systemkatalogen (från föregående kommando, möjligtvis /usr/share eller liknande). Observera att det troligen kräver administratörsrättigheter.