Adicionado COmentários

bin/.gitignore

@@ -1,3 +1,6 @@
 /Models/
 /Controllers/
 /Classes/
+/Enumerations/
+/Views/
+/assets/

bin/config.json

@@ -442,9 +442,9 @@
     }
   ],
   "configuracaoJogo": {
-    "versao": "v1.1.0",
     "dificuldadeJogo": "dificil",
     "quantidadeMaximaPerguntas": 10,
-    "quantidadeMaximaInimigos": 10
+    "quantidadeMaximaInimigos": 10,
+    "versao": "v1.1.0"
   }
 }

src/Classes/Helper.java

@@ -18,41 +18,55 @@
 import javafx.scene.paint.Color;
 import javafx.stage.Stage;
 
+/*Essa classe é usada para literalmente SALVAR o programa abstraindo
+ *  aqui os métodos gerais que serão usados por todo o projeto
+ */
 public class Helper {
-
+
+	//Método responsável por Navegar entre as páginas
 	public void NavegarEntrePagina(ActionEvent event,String destino) throws IOException {
     	Scene pagina = new Scene(FXMLLoader.load(getClass().getResource(destino)));
     	Stage app_stage = (Stage) ((Node) event.getSource()).getScene().getWindow();
     	app_stage.setScene(pagina);
     	app_stage.show();
     }
 
+	/*Método reposnável por executar sons com base no caminho passado
+	 * recebe também um valor boleano que verifica se é loop ou não e o volume do som*/
 	public void ExecutaSom(SoundsEnum caminho, boolean deveSerLoop, Double volume) {
+		 //Cria um objeto do Tipo AudioClip e passa o caminho para ele
 		 AudioClip audio = new AudioClip(getClass().getResource(caminho.getSom()).toExternalForm());
+
+		 //se o boleano for verdadeiro, define o som como infinito
 	     if(deveSerLoop) audio.setCycleCount(javafx.scene.media.AudioClip.INDEFINITE);
+
+	     //define o volume do som e executa da play
 	     audio.setVolume(volume);
 	     audio.play();
 	}
-
-	public static void SomDeClique() {
-	   	new Helper().ExecutaSom(SoundsEnum.CLIQUE_BOTAO,false,1D);
-	}
 
+	//Usa o método de executar Som num método estático para ser chamado direto
 	public static void Reproduzir(SoundsEnum som) {
 	   	new Helper().ExecutaSom(som,false,1D);
 	}
 
 	public static void PintaBotao(Label btn,Color cor) {
+		//Seta uma nova cor para o botão
 		btn.setBackground(new Background(new BackgroundFill(cor, new CornerRadii(0), Insets.EMPTY)));
 	}
 
 	public static void ResetaCoresBotao(List<Label> listaButoes) {
 		for(Label btn: listaButoes) { PintaBotao(btn, Color.rgb(219, 219, 219));}
 	}
 
+	//define a versão do Jogo na Label
 	public static void SetaVersaoJogo(Label labelVersao) throws IOException {
 		RPG versao = new RPG();
+
+		//Pega a versão do jogo que está no JSON
 		versao = ConfiguracaoJogo.ConfiguraJogo();
+
+		//passa para a label o valor
 		labelVersao.setText(versao.getConfiguracaoJogo().getVersao());
 	}
 

src/Controllers/BatalhaController.java

@@ -254,7 +254,7 @@ public void SelecionaResposta(MouseEvent event) {
 
     	 if(respostaSelecionada.isRespostaCorreta()) {
     		 inimigos.get(0).SofrerDano(jogador);
-    		 
+
     		 AtualizaPersonagem(inimigos.get(0), 
     				            lblNumeroVidaInimigo,
     				 			prgVidaInimigo,
@@ -370,8 +370,7 @@ void AtualizaPersonagem(Personagem personagem,
     	nomePersonagem.setText(personagem.getNome());
     	barraVida.setProgress((double)(personagem.getVida()/(double)personagem.getVidaBase()));
 		textoVida.setText(String.valueOf(personagem.getVida()));
-		poderAtaque.setText(String.valueOf(personagem.getPoderAtaque()));
-
+		poderAtaque.setText(String.valueOf(personagem.getPoderAtaque()));		
     }
 
     @FXML

src/Controllers/CreditosController.java

@@ -13,13 +13,16 @@ public class CreditosController {
 	  private Button btnVoltar;
 
 	  @FXML
-	   private Label lblVersaoJogo;
+	  private Label lblVersaoJogo;
 
+	  //volta para a View Anterior
 	  @FXML
 	  public void voltarMenuView(ActionEvent event) throws Exception {
 		  Helper.Reproduzir(SoundsEnum.CLIQUE_BOTAO_VOLTAR);
 		  new Helper().NavegarEntrePagina(event, "../Views/MenuView.fxml");
 	   }
+
+	  //seta a Versão do jogo para a Label de versão
 	  @FXML
 	  public void initialize() throws Exception {   
 	   	Helper.SetaVersaoJogo(lblVersaoJogo);

src/Controllers/DificuldadeController.java

@@ -32,12 +32,24 @@ public class DificuldadeController {
     private Label btnDificuldadeDificil;
     List<Label> listaBotoes;
 
+    /*Esse método é chamado sempre um dos 3 botoes de dificuldade é pressionado.
+     * Quando isso ocorre, o botão pressionado retorna o valor da dificuldade clicada
+     * e atualiza o valor no arquivo JSON.*/
     @FXML
     public void alteraDificuldadeJogo(MouseEvent event) throws IOException {
     	Helper.Reproduzir(SoundsEnum.CLIQUE_BOTAO_DIFICULDADE);
+
+    	//converte explicitamente o parâmetro do evento uma Label para ser acessível
     	Label btn = (Label) event.getSource(); 	
+
+    	/*Chama o método de configuração de dificuldade que atualiza o
+    	JSON com uma dificuldade(String) passada.*/
     	ConfiguracaoJogo.ConfiguraDificuldade(btn.getAccessibleText());
+
+    	//Reseta as Labels com as cores padrões
     	listaBotoes.forEach(x -> x.setStyle("-fx-background-color: #C8C9CB;"));
+
+    	//Pinta a Label selecionada
     	PintaBotaoSelecionado();
     }
 
@@ -50,16 +62,29 @@ public void voltarMenuView(ActionEvent event) throws Exception {
     @SuppressWarnings("serial")
 	@FXML
     public void initialize() throws Exception {   	
+
+     //Instancia uma lista de botões quando é iniciado a View
      listaBotoes = new ArrayList<Label>(){{add(btnDificuldadeFacil);}
     									  {add(btnDificuldadeMedio);}
     									  {add(btnDificuldadeDificil);}};
+
+     //Pinta o botão com a dificuldade selecionada 									  
      PintaBotaoSelecionado();									 
   	 Helper.SetaVersaoJogo(lblVersaoJogo); 	
     }
+
+    //Esse método pinta a label que tiver o valor igual a dificuldade que está no JSON
     public void PintaBotaoSelecionado() throws IOException {
+
+    	/*Cria um objeto do Tipo RPG que é um modelo e 
+    	 * passa para ele um objeto convertido através do JSON */
     	RPG base = ConfiguracaoJogo.ConfiguraJogo();
+
+    	//Acessa a dificuldade do Objeto e passa para uma variável String
     	String config = base.getConfiguracaoJogo().getDificuldadeJogo();
 
+    	/*Percorre a lista de botões e verifica se o AcessibleText (propriedade do botão) 
+    	 * é igual ao valor da dificuldade do JSON */
     	for(Label lbl: listaBotoes) {
     		if(lbl.getAccessibleText().equals(config)) {
     			lbl.setStyle("-fx-background-color: #7AC043;");

src/Controllers/MenuController.java

@@ -13,7 +13,9 @@
 
 public class MenuController  {
 
-
+	/*propriedades que representam os Nodes que existe no arquivo da View,
+	 * através delas pode-se manipular os valores do componentes.
+	 */
     @FXML
     private Pane pnlGeneral;
 
@@ -36,9 +38,14 @@ public class MenuController  {
     private Label lblVersaoJogo;
 
 
+    //Métodos para acessar as opções na View de Menu
     @FXML
     public void dificuldadeView(ActionEvent event) throws IOException{
+
+    	//reproduz o som de Clique usando o método da classe Helper com o Enum de sons como parâmetro.
     	Helper.Reproduzir(SoundsEnum.CLIQUE_BOTAO);
+
+    	//Navega para a View passada como parâmetro
     	new Helper().NavegarEntrePagina(event,"../Views/DificuldadeView.fxml");
     }
 
@@ -66,6 +73,9 @@ public void BatalhaView(ActionEvent event) throws IOException {
     	new Helper().NavegarEntrePagina(event,"../Views/BatalhaView.fxml");
     }
 
+    /*O Initialize é um método que é executado sempre após o carregamento dos Nodes(componente)
+	    Nesse caso logo após da Label de versão ser carregada na View será passado o valor da versão
+	    contido no arquivo json*/
     @FXML
     public void initialize() throws Exception {   
     	Helper.SetaVersaoJogo(lblVersaoJogo);

src/Controllers/RegrasController.java

@@ -14,11 +14,14 @@ public class RegrasController {
 	  @FXML
 	  private Label lblVersaoJogo;
 
+	  //método para voltar para a tela anterior
 	  @FXML
 	  public void voltarMenuView(ActionEvent event) throws Exception {
 		 	Helper.Reproduzir(SoundsEnum.CLIQUE_BOTAO_VOLTAR);
 	    	new Helper().NavegarEntrePagina(event, "../Views/MenuView.fxml");
 	  }
+
+	  //seta a Versão do jogo para a Label de versão
 	  @FXML
 	  public void initialize() throws Exception {   
 	   	Helper.SetaVersaoJogo(lblVersaoJogo);

src/Main.java

@@ -12,18 +12,23 @@ public class Main extends Application {
     @Override
     public void start(Stage primaryStage) throws Exception{
 
-       new Helper().ExecutaSom(SoundsEnum.MUSICA_MENU,true,0.3D);
+    	//inicia o jogo executando método que irá tocar o som do menu inicial
+        new Helper().ExecutaSom(SoundsEnum.MUSICA_MENU,true,0.3D);
 
+        //Carrega a view inicial do Menu num Node Pai e define as configurações de tamanho, titulo e icone.
     	FXMLLoader loader = new FXMLLoader(this.getClass().getResource("Views/MenuView.fxml"));
     	Parent root = loader.load();
-    	primaryStage.setTitle("RPG");
+    	primaryStage.setTitle("Dev-Quest");
         primaryStage.setScene(new Scene(root, 1028, 682));
         primaryStage.setResizable(false);
         primaryStage.getIcons().add(new Image("/assets/icon-app-pixel.jpg"));
+
+        //Exibe a View
         primaryStage.show();
     }
 
     public static void main(String[] args) {
+    	//método responsável por iniciar o Jogo
         launch(args);
     }
 }

src/config.json

@@ -442,7 +442,7 @@
     }
   ],
   "configuracaoJogo": {
-    "dificuldadeJogo": "facil",
+    "dificuldadeJogo": "dificil",
     "quantidadeMaximaPerguntas": 10,
     "quantidadeMaximaInimigos": 10,
     "versao": "v1.1.0"