Gids voor ontwikkelaars van KillbotsInhoudsopgave
Geïnteresseerde personen kunnen Killbots op twee manieren aanpassen : thema´s en regelsets.
Zoals bij de meeste andere KDE-spellen, bestaat een thema voor Killbots uit drie bestanden.
Het desktop-bestand volgt de standaard INI-syntax. De trefwoord-paren slaan informatie op over het thema en wijzen naar andere bestanden die bij het thema horen. Het volgende voorbeeld komt van het standaard thema.
Voorbeeld 4.1. Een thema desktop bestand als voorbeeld
[KGameTheme]
Name=Voorbeeld Thema
Description=een voorbeeld thema gebruikt om de creatie van een thema demonstreren. Deze heeft piraten.
Author=Mr. Artist
AuthorEmail=mrartist@example.com
Type=SVG
FileName=example.svg
Preview=example.png
De eerste vier parameters zijn metadata over het thema en spreken voor zich. Voor Killbots thema´s, moet de Type parameter ingesteld zijn op SVG. De laatste twee parameters zijn de bestandsnamen van de andere twee thema-bestanden. Alhoewel het niet echt noodzakelijk is, is het toch verstandig om consistent te blijven en al de drie bestanden dezelfde bestandsnaam te geven.
Het voorbeeld-bestand is eenvoudig een PNG-bestand dat een voorbeeld geeft van het thema. Het voorbeeld moet 240 bij 140 pixels zijn en zo goed mogelijk overeenkomstig de layout de voorbeeld standaard thema, omdat dit het makkelijker maakt om de thema´s te vergelijken in de thema-selector.
Het SVG-bestand is een schaalbare grafische vector afbeelding waarin de eigenlijke grafische elementen zitten waarmee het thema is getekend. Het bestand mag zowel het niet gecomprimeerde .svg of het wel gecomprimeerde .svgz formaat zijn. Elk spel element heeft als identificatie een unieke ID in het SVG-bestand. Bij het creëren van een nieuw thema is het meestal makkelijker om te beginnen met een bestaand thema en de elementen stuk voor stuk te vervangen totdat het thema compleet is. Het SVG-bestand moet de volgende elementen hebben.
achtergrondDe achter het raster getoonde afbeelding in het speelveld.
statusHet vak in gebruik voor het tonen van de score in deze ronde, aantal vijanden en energie.
tekstkleurDit element moet een rechthoek met een enkele kleur zijn. De kleur is in gebruik voor de tekst in de statusvakken.
celEen individuele cel in het raster.
heldHet karakter bestuurt door de speler.
vijandDe standaard vijand.
fastenemyDe snellere vijand.
junkheapDe overblijfselen van een botsing tussen vijanden.
cursor0De cursor voor de beweging naar rechts.
cursor1De cursor voor de beweging rechtsboven.
cursor2De cursor voor de beweging omhoog.
cursor3De cursor voor de beweging linksboven.
cursor4De cursor voor de beweging naar links.
cursor5De cursor voor de beweging linksonder.
cursor6De cursor voor de beweging omlaag.
cursor7De cursor voor de beweging rechtsonder.
cursor8De cursor voor op de plaats blijven.
Om Killbots een nieuw thema te laten vinden en gebruiken, moeten de bestanden in een geschikte map zijn geplaatst. Als het thema alleen voor de huidige gebruiker beschikbaar hoeft te zijn, kopieert u de desktop, voorbeeld en SVG-bestanden naar het lokale bestand killbots/themes in qtpaths . Om het thema systeembreed beschikbaar te laten zijn, verplaatst u de bestanden naar --paths GenericDataLocation killbots/themes in de systeemmap (uit het vorige commando, mogelijk /usr/share of zoiets). Merk op dat hiervoor waarschijnlijk administratieve beheerdersrechten nodig zijn.