<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY killbots "<application
>Killbots</application
>">
<!ENTITY kappname "&killbots;">
<!ENTITY package "kdegames">
<!ENTITY kappversion "0.1.0">
<!ENTITY docupdate "2008-03-24">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Portuguese "INCLUDE">
]>
<book lang="&language;">
<bookinfo>
<title
>O Manual do &killbots;</title>
<authorgroup>
<author
><personname
> <firstname
>Parker</firstname
> <surname
>Coates</surname
> </personname
> <email
>parker.coates@gmail.com</email
> </author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
>
</authorgroup>
<copyright>
<year
>2008</year>
<holder
>Parker Coates</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>
<date
>&docupdate;</date>
<releaseinfo
>&kappversion;</releaseinfo>
<abstract>
<para
>O &killbots; é uma versão para o &kde; do jogo de consola clássico do BSD que é o <command
>robots</command
>.</para>
<para
>Este manual descreve o &killbots; na versão &kappversion;</para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>jogo</keyword>
<keyword
>Killbots</keyword>
<keyword
>Estratégia</keyword>
<keyword
>Um jogador</keyword>
<keyword
>Um jogador</keyword>
<keyword
>robots</keyword>
<keyword
>robot</keyword>
<keyword
>robot rápido</keyword>
<keyword
>monte de lixo</keyword>
<keyword
>tele-transporte</keyword>
<keyword
>energia</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title
>Introdução</title>
<note>
<title
>Tipo de jogo:</title>
<para
>Estratégia</para>
</note>
<note>
<title
>Número de jogadores:</title>
<para
>Um</para>
</note>
<para
>O &killbots; é um jogo simples onde poderá fugir de robots assassinos. Quem criou os robots e porque foram programados para destruir, ninguém o sabe. Tudo o que se sabe é que eles são numerosos e o objectivo deles é destruí-lo a si. Felizmente para o jogador, o seu criador focou-se na quantidade em vez da qualidade e, em função disso, os robots têm uma séria falta de inteligência. A sua disposição superior e um dispositivo de tele-transporte útil são as suas únicas armas contra a corrente interminável de autómatos sem mente.</para>
<note>
<title
>Nota:</title>
<para
>Esta documentação refere-se com frequência aos <quote
>robots</quote
>, <quote
>montes de lixo</quote
>, etc., mas o &killbots; pode ser altamente configurável a nível visual. Isto significa que as imagens do jogo que pode ver durante o jogo poderão não corresponder às futuristas que aqui se encontram. O tipo de jogo e as estratégias, contudo, manter-se-ão, mesmo que o seu herói seja uma cenoura a ser perseguida num jardim por coelhos esfomeados.</para>
</note>
<note>
<title
>Nota:</title>
<para
>O &killbots; suporta diversos conjuntos de regras que controlam os parâmetros do jogo e que determinam as funcionalidades do jogo incluídas. Esta documentação tenta ser genérica e não específica para um determinado conjunto de regras. Veja a descrição do seu conjunto de regras actual para informações mais detalhadas, nomeadamente sobre a mecânica do jogo, o tamanho da grelha, as jogadas, a pontuação, a energia, etc.</para>
</note>
</chapter>
<chapter id="howto">
<title id="howto-title"
>Como Jogar</title>
<sect1 id="gameplay-basics">
<title
>Regras Básicas do Jogo</title>
<note>
<title
>Objectivo:</title>
<para
>Sobreviva a diversas sequências de inimigos, acumulando ao mesmo tempo um recorde.</para>
</note>
<para
><screenshot
><mediaobject>
<imageobject
><imagedata fileref="grid.png" format="PNG"/></imageobject>
<textobject
><phrase
>Imagem da grelha do jogo</phrase
></textobject>
</mediaobject
></screenshot
></para>
<para
>O &killbots; é um jogo por turnos, jogado numa <firstterm
>grelha</firstterm
> rectangular de <firstterm
>células</firstterm
>. O número de linhas e colunas da grelha é baseado no conjunto de regras em uso. Cada célula poderá conter uma das seguintes imagens: <variablelist>
<varlistentry>
<term
><firstterm
>Herói</firstterm
> <inlinemediaobject
><imageobject
><imagedata fileref="hero.png" format="PNG"/></imageobject
></inlinemediaobject
></term>
<listitem>
<para
>O herói é a alma errante que se encontra presa num quarto com vários robots assassinos. Como jogador, o seu objectivo é garantir que permanece vivo durante o máximo de tempo possível.</para>
<para
>No início de cada <firstterm
>turno</firstterm
>, o herói poderá efectuar entre um de três tipos de acções: poderá ficar onde está, poderá ir para uma célula adjacente ou poderá ainda efectuar uma acção especial. Veja em <link linkend="movement-controls" endterm="movement-controls-title"
></link
> ou <link linkend="special-actions" endterm="special-actions-title"
></link
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><firstterm
>Robot</firstterm
> <inlinemediaobject
><imageobject
><imagedata fileref="enemy.png" format="PNG"/></imageobject
></inlinemediaobject
></term>
<listitem>
<para
>Os robots são homens mecânicos que apenas desejam esmagá-lo com a sua fúria metálica. Nunca ouviram falar das "Três Leis da Robótica" e, como tal, poderão provavelmente esmagar toda a gente que lhas tente explicar.</para>
<para
>Cada 'robot' irá fazer um movimento único em direcção ao herói em cada turno. Se o 'robot' estiver por cima do herói, irá começar a descer. Se estiver à esquerda, deslocar-se-á para a direita. Se estiver em baixo e à direita, deslocar-se-á na diagonal para cima e para a esquerda. Se o 'robot' vier a ocupar a mesma célula que o herói, este será esmagado e o jogo irá terminar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><firstterm
>Robot Rápido</firstterm
> <inlinemediaobject
><imageobject
><imagedata fileref="fastenemy.png" format="PNG"/></imageobject
></inlinemediaobject
></term>
<listitem>
<para
>Os 'robots' rápidos são uma versão muito mais acelerada do 'robot' básico. Por cada jogada que o herói faça, eles avançam dois passos. Felizmente, a sua mobilidade aumentada não foi associada a uma inteligência aumentada; muitas das vezes acabam por se destruir uns aos outros.</para>
<para
>Nem todos os conjuntos de regras incluem 'robots' rápidos.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><firstterm
>Monte de Lixo</firstterm
> <inlinemediaobject
><imageobject
><imagedata fileref="junkheap.png" format="PNG"/></imageobject
></inlinemediaobject
></term>
<listitem>
<para
>Quando dois ou mais inimigos colidem, eles são destruídos e os detritos resultantes produzem um monte de lixo. Os inimigos ignoram de forma cega os montes do lixo no seu caminho e são destruídos se chocarem com eles. Poderá achar os montes de lixo bastante úteis, dado que poderão servir de barreiras entre si e os seus atacantes.</para>
<para id="pushing-junkheaps"
>Alguns conjuntos de regras permitem que o herói <firstterm
>empurre</firstterm
> os montes de lixo na grelha. O herói poderá então usar os montes de lixo para construir "bunkers" ou abrigos que ofereçam protecção de vários lados. Os montes de lixo poderão inclusive ser usados de forma ofensiva, em alguns conjuntos de regras. Se empurrar um monte de lixo sobre um inimigo, irá esmagá-lo e isso poderá até resultar num bónus.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="rounds-scoring-energy">
<title
>Jogadas, Pontuação e Energia</title>
<para
><screenshot
><mediaobject>
<imageobject
><imagedata fileref="status.png" format="PNG"/></imageobject>
<textobject
><phrase
>Os indicadores de estado do jogo</phrase
></textobject>
</mediaobject
></screenshot
></para>
<sect2>
<title
>Jogadas</title>
<para
>A actuação em jogo no &killbots; está dividida por <firstterm
>rondas</firstterm
>. Cada ronda começa com o herói no meio e com inimigos dispostos de forma aleatória em torno dele. A ronda termina quando todos os inimigos tiverem sido destruídos. À medida que cada ronda vai terminando, o número de inimigos aumenta. O número e tipo de inimigos adicionados são dependentes do conjunto de regras.</para>
<para
>A grelha irá continuar a preencher-se com inimigos, até que uma de duas coisas aconteça: os inimigos ocuparem mais de 50 por cento das células ou for tentado um tele-transporte seguro e já não existam células seguras na grelha. Nessa altura, a ronda actual é abandonada, o número de inimigos é reposto com a quantidade da ronda 1 e é iniciada uma nova ronda.</para>
</sect2>
<sect2>
<title
>Pontuação</title>
<para
>Não existe propriamente o conceito de ganhar no &killbots;; o herói tenta sobreviver o máximo possível, mas a realidade depressiva é que, no fim, a sua sorte esgotar-se-á. Como tal, o objectivo do &killbots; é acumular a <firstterm
>pontuação</firstterm
> máxima possível, antes de acontecer o inevitável. As dez melhores pontuações (em conjunto com a ronda atingida) são registadas na tabela de recordes.</para>
<para
>Irá ganhar pontos no caso de destruir os inimigos. Os 'robots' rápidos normalmente valem mais que os 'robots' normais. Também pode ganhar pontos de bónus pelos inimigos destruídos enquanto <link linkend="wait-out-round"
>espera na ronda</link
> ou <link linkend="pushing-junkheaps"
>empurra um monte de lixo</link
>.</para>
</sect2>
<sect2 id="energy">
<title
>Energia</title>
<para
>Para além dos pontos, o herói também poderá recolher <firstterm
>energia</firstterm
> à medida que o jogo evolui. A energia permite ao herói efectuar <link linkend="teleport-safely"
>tele-transportes seguros</link
>. Dependendo do conjunto de regras, a energia poderá ser ganha por uma variedade de razões, inclusive a finalização de uma ronda, <link linkend="pushing-junkheaps"
>por empurrar um monte de lixo</link
> ou por destruir os inimigos enquanto <link linkend="wait-out-round"
>espera</link
>.</para>
<para
>A quantidade de energia máxima que o herói poderá armazenar é determinada por um valor do conjunto de regras. O estado da energia só é apresentado se o conjunto de regras incluir a energia e os tele-transportes seguros.</para>
</sect2>
</sect1>
<sect1 id="special-actions">
<title id="special-actions-title"
>Acções Especiais</title>
<para
>Para além dos simples movimentos de células para células, o herói tem três acções especiais à sua disposição.</para>
<sect2 id="teleport">
<title
>Tele-Transporte</title>
<para
>O herói conseguiu de alguma forma atingir um tele-transporte pessoal. Infelizmente, não é muito fiável. Se activar o tele-transporte, fará com que o herói seja transportado para uma célula qualquer, escolhida aleatoriamente na grelha. Não existe limite para o número de tele-transporte que o herói poderá efectuar.</para>
<para
>A célula de destino está garantida como estando desocupada, mas existe uma boa hipótese que esta esteja adjacente a um herói enfurecido. Devido ao risco inerente do tele-transporte, este deverá ser usado como manobra de último recurso, quando já não existirem mais jogadas seguras possíveis.</para>
</sect2>
<sect2 id="teleport-safely">
<title
>Tele-Transporte Seguro</title>
<para
>O tele-transporte tem de facto um segundo modo de operação, no qual irá transportar o herói para uma célula escolhida de forma aleatória mas segura. O tele-transporte seguro necessita de alguma energia, sendo que esta normalmente tem pouca disponível.</para>
<para
>Nem todos os conjuntos de regras permitem o tele-transporte seguro e os detalhes de como a energia é adquirida variam de conjunto de regras para conjunto.</para>
</sect2>
<sect2 id="wait-out-round">
<title
>Jogada de Espera</title>
<para
>Poderá haver uma altura em que a grelha está disposta de tal forma que todos os 'robots' poderão ser destruídos sem que o herói se tenha de mover sequer. Nessa situação, terá a opção de esperar nessa ronda.</para>
<example>
<title
>Uma Oportunidade de Espera no Jogo</title>
<para
><screenshot
><mediaobject>
<imageobject
><imagedata fileref="waitoutround.png" format="PNG"/></imageobject>
</mediaobject
></screenshot
></para>
</example>
<para
>A espera na jogada fará com que o herói fique quieto no lugar, enquanto os inimigos continuam o seu movimento normal. Isto continua até que uma de duas situações aconteça: os inimigos se destruam entre si e a ronda termine, ou então se um inimigo conseguir atingir o herói e o jogo termine, nesse caso. Logo que um comando de espera seja emitido, não poderá ser cancelado, pelo que deverá estar certo que o herói esteja, de facto, seguro.</para>
<para
>Então porque é que iria tomar uma acção que elimina a oportunidade de mudar de ideias? Bom, adiciona algum floreado e drama ao fim de uma ronda; porém, mais importante, existe um bónus que é ganho por cada inimigo destruído enquanto se espera na ronda. O tamanho e tipo (pontos ou energia) do bónus são determinados pelo conjunto de regras.</para>
</sect2>
</sect1>
</chapter>
<chapter id="interface-overview">
<title
>Apresentação à Interface</title>
<sect1 id="movement-controls">
<title id="movement-controls-title"
>Controlos de Movimento</title>
<para
>O jogador tem a opção de usar o teclado, o rato ou ambos para controlar o herói.</para>
<sect2 id="keyboard-movement">
<title id="keyboard-movement-title"
>Controlos de Movimento pelo Teclado</title>
<para
>Existem nove acções de movimento: esquerda, direita, cima, baixo, as quatro diagonais e parar. Cada uma destas acções poderá ter duas teclas diferentes atribuídas. Por omissão, estas nove acções estão atribuídas às nove teclas do teclado numérico e a um bloco de 3 por 3 letras no extremo esquerdo de um teclado QWERTY. Obviamente, os utilizadores que usem um teclado diferente ou que não tenham um teclado numérico poderão modificar estas combinações de teclas com a <link linkend="configure-shortcuts"
>janela para Configurar os Atalhos</link
>.</para>
<para
>Cada um dos comandos de movimentos especiais (como o tele-transporte) também poderão ser invocados a partir do teclado. Veja como em <link linkend="move-menu" endterm="move-menu-title"
></link
>.</para>
</sect2>
<sect2 id="mouse-movement">
<title id="mouse-movement-title"
>Controlos de Movimento com o Rato</title>
<para
>O rato (ou qualquer dispositivo semelhante) pode ser usado para navegar de forma mais natural e intuitiva. À medida que o cursor percorre a área de jogo, o mesmo cursor irá mudar para indicar a direcção relativa desde o cursor até ao herói. Por exemplo, se mover o cursor para o espaço por cima do herói, irá mudar o cursor para uma seta para cima. Se o cursor estiver colocado exactamente em cima do herói, o cursor muda para indicar que não haverá movimento.</para>
<para
>Ao carregar uma única vez com o rato, fará com que o herói avance na direcção indicada (desde que seja permitido um passo nesse sentido). Por conveniência, poderá associar acções adicionais aos botões do meio e direito do rato na <link linkend="configure-killbots"
>janela para Configurar o &killbots;</link
>. Estas acções incluem as apresentadas em <link linkend="move-menu" endterm="move-menu-title"
></link
>, assim como opções adicionais: Passo Repetido. Se efectuar um passos repetido, fará com que o herói se desloque na direcção indicada durante várias jogadas consecutivas, até que atinja um obstáculo ou até que o movimento contínuo se torne inseguro. Poderá também interromper um passo repetido em curso se carregar de novo no rato.</para>
<para
></para>
</sect2>
</sect1>
<sect1 id="game-menu">
<title
>O Menu <guimenu
>Jogo</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Novo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Inicia um jogo novo, esquecendo a evolução actual do jogo.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Mostrar os Recordes</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra a janela de recordes, contendo as pontuações anteriores.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sai do &killbots;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="move-menu">
<title id="move-menu-title"
>O Menu <guimenu
>Mover</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>R</keycap
></shortcut
> <guimenu
>Mover</guimenu
> <guimenuitem
>Tele-transporte</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Tele-transporta o herói para uma célula aleatória e vazia do campo de jogo.</action
> Veja como em <link linkend="teleport" endterm="special-actions-title"
></link
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>T</keycap
></shortcut
> <guimenu
>Mover</guimenu
> <guimenuitem
>Tele-transportar em Segurança</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Tele-transporta o herói para uma célula vazia e aleatória que se garanta como sendo segura de ataques nessa jogada.</action
> Veja em <link linkend="teleport-safely" endterm="special-actions-title"
></link
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>Espaço</keycap
></shortcut
> <guimenu
>Mover</guimenu
> <guimenuitem
>Tele-transportar em Segurança se Possível</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Uma acção de conveniência. <action
>Tele-transporta o herói em segurança, se isso for possível, caso contrário apenas o tele-transporta de forma aleatória.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>Y</keycap
></shortcut
> <guimenu
>Mover</guimenu
> <guimenuitem
>Esperar a Jogada de Saída</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Faz com que o herói fique fixo no lugar, até ao fim da jogada.</action
> Veja em <link linkend="wait-out-round" endterm="special-actions-title"
></link
>.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="settings-menu">
<title
>O Menu <guimenu
>Configuração</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Barra de Ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra ou esconde a barra de ferramentas principal da aplicação.</action
></para
></listitem>
</varlistentry>
<varlistentry id="configure-shortcuts">
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra a janela normal para Configurar os Atalhos do &kde;.</action
> Isto permite-lhe definir de novo todos os atalhos de teclado do &killbots;, incluindo os de movimento.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra a janela para Configurar as Barras de Ferramentas do &kde;.</action
> Isto permite ao utilizador escolher as acções que aparecem na barra de ferramentas do &killbots;.</para
></listitem>
</varlistentry>
<varlistentry id="configure-killbots">
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &killbots;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra a janela de configuração do &killbots;</action
>, onde poderá ajustar os parâmetros do jogo, escolher um conjunto de regras diferente ou alterar o tema do jogo.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="help-menu">
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect1>
</chapter>
<chapter id="developers">
<title
>Guia de Programação do &killbots;</title>
<para
>Os indivíduos interessados poderão personalizar o &killbots; de duas formas importantes: temas e conjuntos de regras.</para>
<sect1 id="creating-themes">
<title
>Criar Temas Personalizados do &killbots;</title>
<para
>Como na maioria dos outros jogos do &kde;, um tema do &killbots; consiste em três ficheiros.</para>
<sect2>
<title
>O Ficheiro 'Desktop'</title>
<para
>O ficheiro 'desktop' segue a sintaxe-padrão do <filename
>INI</filename
> e é usado para guardar as informações sobre o tema e para apontar para os outros ficheiros. Segue-se um tema de exemplo.</para>
<example>
<title
>O Ficheiro 'Desktop' de um Tema de Exemplo</title>
<programlisting
>[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
</programlisting>
</example>
<para
>Os primeiros quatro parâmetros contêm meta-dados sobre eles e são relativamente simples de entender. Para os temas do &killbots;, o parâmetro <varname
>Type</varname
> deverá ser igual a <literal
>SVG</literal
>. Os dois últimos parâmetros contêm os nomes dos outros dois ficheiros do tema. Embora não sejam estritamente necessários, por razões de consistência, todos os três ficheiros partilham o mesmo nome de base.</para>
</sect2>
<sect2>
<title
>O Ficheiro de Antevisão</title>
<para
>O ficheiro de antevisão é apenas um ficheiro <filename
>PNG</filename
> que contém uma antevisão do tema. A imagem de antevisão deverá ter um tamanho de 240 por 1140 pixels e corresponder à disposição da antevisão do tema predefinido o mais possível, dado que isto facilita a comparação dos temas no selector.</para>
</sect2>
<sect2>
<title
>O Ficheiro <acronym
>SVG</acronym
></title>
<para
>O ficheiro <acronym
>SVG</acronym
> é um ficheiro de gráficos vectoriais escaláveis que contém os elementos gráficos que são usados para compor o tema. Cada elemento do jogo é identificado por um ID único no ficheiro <acronym
>SVG</acronym
>. 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 ficheiro <acronym
>SVG</acronym
> <emphasis
>deverá</emphasis
> conter os seguintes elementos.</para>
<variablelist>
<varlistentry>
<term
><varname
>background</varname
></term>
<listitem
><para
>A imagem apresentada atrás da grelha na área de jogo principal.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>status</varname
></term>
<listitem
><para
>A área usada para mostrar a ronda actual, a pontuação, o número de inimigos e a energia.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>text</varname
></term>
<listitem
><para
>A cor usada para preencher este elemento no texto das áreas de estado.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cell</varname
></term>
<listitem
><para
>Uma célula individual da grelha.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>hero</varname
></term>
<listitem
><para
>A personagem controlada pelo jogador.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>enemy</varname
></term>
<listitem
><para
>O inimigo básico.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>fastenemy</varname
></term>
<listitem
><para
>O inimigo mais rápido.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>junkheap</varname
></term>
<listitem
><para
>O que resta de uma colisão entre inimigos.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor0</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para a direita.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor1</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para cima e para a direita.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor2</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para cima.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor3</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para cima e para a esquerda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor4</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para a esquerda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor5</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para baixo e para a esquerda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor6</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para baixo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor7</varname
></term>
<listitem
><para
>Um cursor que indica um movimento para baixo e para a direita.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>cursor8</varname
></term>
<listitem
><para
>Um cursor que indica a permanência no mesmo sítio.</para
></listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2>
<title
>Instalar os Temas Personalizados</title>
<para
>Para que o &killbots; detecte e use um tema novo, os ficheiros deverão ser movidos para uma pasta apropriada. Para instalar o tema apenas no utilizador actual, copie os ficheiros 'desktop', SVG e de antevisão para <filename
>$<varname
>KDEHOME</varname
>/share/apps/killbots/themes</filename
>. Para disponibilizar o tema para todo o sistema, mova os ficheiros para <filename
><command
>`kde-config --prefix`</command
>/share/apps/killbots/themes</filename
>. Este caso poderá necessitar de privilégios de administração.</para>
</sect2>
</sect1>
<sect1 id="creating-rulesets">
<title
>Criar Conjuntos de Regras Personalizados</title>
<sect2>
<title
>O Ficheiro 'Desktop' do Conjunto</title>
<para
>A criação de novos conjuntos de regras é incrivelmente simples para o &killbots;, especialmente quando se começa a partir de um conjunto de regras existente. Estes conjuntos são guardados como um único ficheiro 'desktop', onde os parâmetros e meta-dados são guardados como pares chave-valor simples.</para>
<example>
<title
>O Conjunto de Regras Predefinido do &killbots;</title>
<programlisting width="80"
>[KillbotsRuleset]
Name=&killbots;
Author=Parker Coates
AuthorContact=parker.coates@gmail.com
Description=<qt><p>The default Killbots ruleset.</p><p>A 16 by 16 cell grid. The game starts with 8 robots, 4 more are added each round. 2 fastbots are added each round after Round 2. Teleporting safely costs 1 energy, with a maximum energy cap or 12. Multiple junkheaps are pushabel at a time. 5 points for each robot destroyed and 10 for each fastbot. 1 bonus energy for each enemy destroyed with a junkheap or while waiting out the round.</p></qt>
Description[sv]=<qt><p>Regeluppsättningen som är standard i Killbots.</p><p>Ett 16 gånger 16 rutnät. Spelet börjar med 8 robotar, ytterligare 4 läggs till varje omgång. Två snabbotar läggs till varje omgång efter den andra. Säker teleportering kostar en energienhet, med ett maximal energitak på 12. Flera skrothögar går att knuffa samtidigt. 5 poäng för varje förstörd robot och 10 för varje snabbot. 1 bonusenhet energi för varje fiende som förstörs med en skrothög eller vid väntan på omgångens slut.</p></qt>
Rows=16
Columns=16
EnemiesAtGameStart=8
EnemiesAddedEachRound=4
FastEnemiesAtGameStart=-2
FastEnemiesAddedEachRound=2
EnergyAtGameStart=0
EnergyAddedEachRound=0
MaxEnergyAtGameStart=12
MaxEnergyAddedEachRound=0
CostOfSafeTeleport=1
PushableJunkheaps=Many
SquaskKillsEnabled=true
JunkheapsAtGameStart=0
JunkheapsAddedEachRound=0
PointsPerEnemyKilled=5
PointsPerFastEnemyKilled=10
WaitKillPointBonus=0
WaitKillEnergyBonus=1
SquashKillPointBonus=0
SquashKillEnergyBonus=1
</programlisting>
</example>
<para
>Lembre-se que todos os parâmetros de texto deverão ser introduzidos em Inglês. Como foi visto no exemplo acima, é possível adicionar novas traduções, repetindo para tal a chave e adicionando o código da língua entre parêntesis rectos. Repare também que pode indicar texto formatado no campo <varname
>Description</varname
>, envolvendo o valor entre marcas <qt>.</para>
<para
>Um ficheiro de conjunto de regras deverá conter todos os seguintes parâmetros.</para>
<variablelist>
<varlistentry>
<term
><varname
>Name</varname
></term>
<listitem
><para
>o nome do conjunto de regras, como irá aparecer no selector de regras e na janela de recordes.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>Author</varname
></term>
<listitem
><para
>O criador do conjunto de regras</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>AuthorContact</varname
></term>
<listitem
><para
>A informação de contacto do criador. Normalmente é um endereço de e-mail.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>Description</varname
></term>
<listitem
><para
>Uma descrição do conjunto de regras. Esta deverá ser bastante detalhada; caso contrário, o utilizador ficará sem saber nada, após escolher o conjunto de regras.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>Rows</varname
></term>
<listitem
><para
>O número de linhas na grelha do jogo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>Columns</varname
></term>
<listitem
><para
>O número de colunas na grelha do jogo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>EnemiesAtGameStart</varname
></term>
<listitem
><para
>O número de jogadores normais a adicionar à grelha, no início da primeira ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>EnemiesAddedEachRound</varname
></term>
<listitem
><para
>O número de jogadores normais a adicionar à grelha, no início de cada ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>FastEnemiesAtGameStart</varname
></term>
<listitem
><para
>O número de jogadores rápidos a adicionar à grelha, no início da primeira ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>FastEnemiesAddedEachRound</varname
></term>
<listitem
><para
>O número de jogadores rápidos a adicionar à grelha, no início de cada ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>EnergyAtGameStart</varname
></term>
<listitem
><para
>A quantidade de energia atribuída ao herói no início da primeira ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>EnergyAddedEachRound</varname
></term>
<listitem
><para
>A quantidade de energia atribuída ao herói no início de cada ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>MaxEnergyAtGameStart</varname
></term>
<listitem
><para
>A capacidade máxima de energia do herói no início da primeira ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>MaxEnergyAddedEachRound</varname
></term>
<listitem
><para
>A capacidade máxima de energia do herói no início de cada ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>CostOfSafeTeleport</varname
></term>
<listitem
><para
>A quantidade de energia consumida num tele-transporte seguro.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>PushableJunkheaps</varname
></term>
<listitem
><para
>O número de montes de lixo que se podem mover com um único empurrão. Os valores possíveis são <constant
>None</constant
>, <constant
>One</constant
> e <constant
>Many</constant
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>SquaskKillsEnabled</varname
></term>
<listitem
><para
>Se for verdadeiro, o herói pode esmagar os inimigos se empurrar os montes de lixo para cima deles.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>JunkheapsAtGameStart</varname
></term>
<listitem
><para
>O número de montes de lixo colocados na grelha, no início da primeira ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>JunkheapsAddedEachRound</varname
></term>
<listitem
><para
>O número de montes de lixo adicionais colocados na grelha, no início de cada ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>PointsPerEnemyKilled</varname
></term>
<listitem
><para
>O número de pontos ganhos por destruir um inimigo normal.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>PointsPerFastEnemyKilled</varname
></term>
<listitem
><para
>O número de pontos ganhos por destruir um inimigo rápido.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>WaitKillPointBonus</varname
></term>
<listitem
><para
>O número de pontos de bónus ganhos por destruir um inimigo enquanto se espera na ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>WaitKillEnergyBonus</varname
></term>
<listitem
><para
>O número de unidades de energia ganhos por destruir um inimigo enquanto se espera na ronda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>SquashKillPointBonus</varname
></term>
<listitem
><para
>O número de pontos de bónus ganhos por esmagar um inimigo com um monte de lixo.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>SquashKillEnergyBonus</varname
></term>
<listitem
><para
>O número de unidades de energia de bónus ganhas por esmagar um inimigo com um monte de lixo.</para
></listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2>
<title
>Instalar os Conjuntos de Regras Personalizados</title>
<para
>Para que o &killbots; detecte e use um novo conjunto de regras, o ficheiro deverá ser movido para uma pasta apropriada. Para instalar o conjunto de regras apenas no utilizador actual, copie o ficheiro para <filename
>$<varname
>KDEHOME</varname
>/share/apps/killbots/rulesets</filename
>. Para disponibilizar o conjunto de regras para todo o sistema, mova o ficheiro para <filename
><command
>`kde-config --prefix`</command
>/share/apps/killbots/rulesets</filename
>. Lembre-se que este último caso necessita de privilégios de administração.</para>
</sect2>
</sect1>
</chapter>
<chapter id="credits">
<title
>Créditos e Licença</title>
<para
>&killbots;</para>
<para
>Programa com 'copyright' 2007–2008 Parker Coates <email
>parker.coates@gmail.com</email
></para>
<para
>Documentação com 'copyright' © 2008 de Parker Coates <email
>parker.coates@gmail.com</email
></para>
<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
>
&underFDL; &underGPL; </chapter>
<appendix id="installation">
<title
>Instalação</title>
<sect1 id="getting-killbots">
<title
>Como obter o &killbots;</title>
&install.intro.documentation; </sect1>
<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>
</appendix>
&documentation.index;
</book>
<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
