Browse Source

adicionados relatório e manual

JoaoHL 6 years ago
parent
commit
9db6bc4f4c
2 changed files with 77 additions and 14 deletions
  1. 57 14
      README.md
  2. 20 0
      manual.txt

+ 57 - 14
README.md

@@ -1,25 +1,68 @@
-Não roda no emuladador!
+/********************************************************************
+ *  Nomes: Gabriel Capella                       Números USP: 8962078 
+ *         João Herique Luciano                               8535957
+ * 
+ *  Tarefa:    RedCore - EP2 MAC0463
+ *  Arquivo:   README.md
+ *  Descrição: Pequeno relatório sobre o EP2
+ ********************************************************************/
+									REDCORE
 
-Antes de montar o arquivo você deve configurar o arquivo `proj.android-studio/local.properties`.
+O jogo desenvolvido nesse projeto foi um estilo brick-break onde o objetivo é
+avançar de fases atingindo o núcleo vermelho dentro das camadas de blocos.
+Os blocos em questão podem ser destrúidos ao serem atingidos pela(s) bola(s)
+em jogo.
 
-Para montar o APK do jogo:
+Satisfazendo alguns requisitos do trabalho, foram implementadas as seguin-
+tes funcionalidades:
+- Power ups-downs: aumento/diminuição da pá; bolas múltiplas (até 3);
+				   salvar o nível do jogo; super-bola, capaz de destruir
+				   qualquer tipo de bloco
 
-```
-./build
-```
+- Fases aleatórias: as fases são geradas aleatoriamente, no sentido de
+					variação do tamanho, cor e velocidade de rotação dos
+					blocos
+
+- Blocos móveis: os blocos se movem ao redor do núcleo
+
+- Mais de um tipo de bloco: existem dois tipos de blocos (normais e 
+							indestrutiveis)
+
+Alguns detalhes que devem ser mencionados sobre a implementação:
 
-# Manual
+- Os power ups colidem com a bola, podendo ser jogados para fora do mapa
+  (isso foi proposital para aumentar a dificuldade)
+- O nível salvo pelo jogo reduz em 1 para cada 12 horas sem jogar
+  (queremos que o jogador jogue sempre que possível)
+- O jogo não tem pausa (propositalmente, também), pois o objetivo
+  é conquistar o máximo de níveis possíveis numa jogatina
 
-## Power UPs
-### SuperBola
-ë o power up laranja o responsável por esse efeito. Qunado o usuário possui uma superbola, a bola fica laranja e tem capacidade de destruir os blocos indestritíveis (somente um toque).
+Sobre os power-ups:
+- Aumento/diminuição da pá (power-up azul): tem 50% de chance de aumentar
+  ou de diminuir a pá (diminuir pela metade e aumentar para o dobro do tamanho).
+  A pá volta ao seu tamanho normal depois de um tempo.
+- Bolas múltiplas (power-up rosa): aumenta o número de bolas no jogo para 3.
+- Salvamento do nível (power-up verde): salva o nível atual do jogo
+- Super-bola (power-up): a bola pode destruir tanto os blocos normais
+  quanto o bloco indestrutível. Ela volta ao normal depois de destruir
+  um bloco indestrutível.
 
 
-Esse script vai fazer o download do cocos2d-x (por volta de 350mb).
+Para o desenvolvimento do jogo, foi utilizada o framework cocos2d-x,
+em C++, e o DoxyDoc (para Sublime Text) para a documentação do código.
+O jogo foi desenvolvido para Android, e testado em um celular Motorola
+G4 com Android 7.0. O cocos2d foi utilizado devido à sua simplicidade
+de programação e entendimento da ferramenta.
 
-Quando uma raquete muda de tamanho, ela volta ao seu tamho original depois de certo tempo.
 
-Politica de redimencionamento.
+Algumas observações:
 
-No border policy will scale proportionally the container so that it fills up the entire frame. In this case, if the width/height ratio of the frame doesn't equal to your designed ratio, some area of your game will be cut off. In the meantime, under no border policy, cc.visibleRect represent the viewport of canvas in the game world, and it can be smaller than cc.winSize.
+- NÃO RODA NO EMULADOR!
 
+- Antes de montar o arquivo você deve configurar o arquivo `proj.android-studio/local.properties`.
+
+- Para montar o APK do jogo:
+
+```
+./build
+```

+ 20 - 0
manual.txt

@@ -0,0 +1,20 @@
+# Manual
+
+O jogo tem por objetivo avançar pelas fases, quebrando os blocos e
+atingindo o núcleo vermelho no topo da tela. Para tanto, serão usadas
+uma bolinha, que colidirá com os blocos, e uma pá, cuja movimentação
+será controlada com o toque do usuário (a pá se move para onde o
+usuário tocou pela última vez). Além disso, o usuário poderá contar com
+os seguintes power-ups:
+- Aumento/diminuição da pá (power-up azul): tem 50% de chance de aumentar
+  ou de diminuir a pá (diminuir pela metade e aumentar para o dobro do tamanho).
+  A pá volta ao seu tamanho normal depois de um tempo.
+- Bolas múltiplas (power-up rosa): aumenta o número de bolas no jogo para 3.
+- Salvamento do nível (power-up verde): salva o nível atual do jogo
+- Super-bola (power-up): a bola pode destruir tanto os blocos normais
+  quanto o bloco indestrutível. Ela volta ao normal depois de destruir
+  um bloco indestrutível.
+
+Ao atingir o núcleo com a bolinha, o usuário passará para a pŕoxima fase,
+mas caso a única bolinha em jogo colida com a parte inferior da tela, o
+jogo acabará.