Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- editor_de_ladrilhos [2025/04/02 19:05] – [Editor de Ladrilhos] admin
+++ editor_de_ladrilhos [2025/04/15 16:34] (atual) – edição externa 127.0.0.1
@@ Linha 1: / Linha 1: @@
 ====== Editor de Ladrilhos ======
-No sBotics, o editor de ladrilhos oferece a capacidade de personalizar cada ladrilho da arena, permitindo um controle minucioso sobre o ambiente de simulação. Cada ladrilho possui um conjunto de configurações padrão, que podem ser ajustadas para criar cenários únicos e desafiadores.
+No sBotics, o editor de ladrilhos oferece a capacidade de personalizar cada ladrilho da arena, permitindo um controle minucioso sobre o ambiente de simulação. Além disso, é possível importar e exportar ladrilhos para arquivos ''sTiles'' ou ''json'', para utilizar em outras arenas. Cada ladrilho possui um conjunto de configurações padrão, que podem ser ajustadas para criar cenários únicos e desafiadores.
 {{ editor-ladrilhos.png?750 }}
@@ Linha 26: / Linha 26: @@
   * ''"is_endgoal"'': Indica se o ladrilho é o objetivo final da arena.
   * ''"rescue_zone"'': Indica se o ladrilho faz parte de uma sala de resgate.
-  * ''"exits"'': Define as saídas do ladrilho, controlando a direção em que o robô pode se mover.
+  * ''"exits"'': Define as saídas do ladrilho, controlando a direção em que o robô pode se mover **(ler mais sobre abaixo)**.
   * ''"enter_score"'': [[Editor de Arenas#entendendo_o_tipo_json_de_pontuacao|Objeto de Pontuação]] da pontuação ao entrar no ladrilho pela primeira vez.
   * ''"exit_score"'': [[Editor de Arenas#entendendo_o_tipo_json_de_pontuacao|Objeto de Pontuação]] da pontuação ao sair do ladrilho pela primeira vez.
@@ Linha 35: / Linha 35: @@
 No arquivo JSON de configuração do ladrilho, existe uma configuração **extremamente importante** para arenas com percurso/caminho: As saídas do ladrilho. As saídas do ladrilho informam aonde o simulador deve buscar o próximo ladrilho para seguir o percurso.
-Todo ladrilho tem 4 lados e 4 saídas possíveis: **''a''**, **''A''**, **''b''** e **''B''**.
+Todo ladrilho tem 4 lados de entrada e 5 saídas possíveis: **''a''**, **''A''**, **''b''**, **''B''** e **''blocked''** (sem saída naquele lado).
 <code javascript>
@@ Linha 46: / Linha 46: @@
 </code>
-===== Objetos =====
+**No sBotics, a linha formada pela arena começa pelo ladrilho final em direção a "ladrilhos-checkpoint", sendo o último checkpoint encontrado o ladrilho que o robô vai iniciar.**
+> Desta forma, os ''"side_"'' representam o lado do ladrilho que o robô deve sair e ''"exit_"'' o lado que o robô é suposto de entrar para sair daquele lado (já que a referência side e exit começam "ao contrário").
+Em um exemplo clássico deste sistema, é possível ver como um beco sem saída deve ser configurado pelo simulador:
+{{  beco.png?400  }}
+Pode parecer confuso pensar que entrando por ''"A"'' se sai em ''"a"'' no ladrilho antes do beco, porém considerando que estamos seguindo a linha ao contrário faz bastante sentido.
+> **Aviso:** No Ladrilho de Início, todos os ''"side_"'' devem ser ''"blocked"'';
+===== Objetos =====
+{{ painel-objetos.png?250}}
+{{ objetos.png?250}}
 Além das configurações de ladrilhos, o editor também permite adicionar objetos à arena. Esses objetos podem ter diferentes tipos, pontuações de resgate e a capacidade de servir como pontos de evacuação (''evacuation_bonus'').
 As propriedades dos objetos incluem:
-material (''m''): Define a cor do objeto, utilizando as cores disponíveis no sBotics:
+  * **Material (''m'')**: Define a cor do objeto, utilizando as cores disponíveis no sBotics:
-Black (Preto)
+    * ''Branco'', ''Cinza'', ''Cinza Escuro'', ''Preto'', ''Verde'', ''Lima'', ''Verde-azulado'', ''Ciano'', ''Azul'', ''Roxo'', ''Magenta'', ''Rosa'', ''Vermelho'', ''Marrom'', ''Laranja'' e ''Amarelo''.
-White (Branco)
+  * **Tipo (''t'')**: Define o formato do objeto.
-Green (Verde)
+  * **Peso (''w'')**: Define a massa do objeto (objetos com massa diferente de 0 são afetados pela gravidade).
-Red (Vermelho)
+  * **Reiniciar Posição**: Permite ativar se o objeto será reiniciado a sua posição inicial a cada nova tentativa (válido apenas para objetos não estáticos).
-Blue (Azul)
+  * **Posição (''X'', ''Y'', ''Z'')**: Define a posição do objeto na arena.
-Yellow (Amarelo)
+  * **Rotação (''X'', ''Y'', ''Z'')**: Define a rotação do objeto (em graus).
-Magenta
+  * **Escala (''X'', ''Y'', ''Z'')**: Define o tamanho do objeto.
-Cyan
+  * **Pontuação de Resgate**: Define a pontuação por resgatar o objeto.
-Tipo (''t''): Define o formato do objeto.
-Peso (''w''): Define a massa do objeto (objetos com massa diferente de 0 são afetados pela gravidade).
-Reiniciar Posição: Permite ativar se o objeto será reiniciado a sua posição inicial a cada nova tentativa (válido apenas para objetos não estáticos).
-Posição (X, Y, Z): Define a posição do objeto na arena.
-Rotação (X, Y, Z): Define a rotação do objeto (em graus).
-Escala (X, Y, Z): Define o tamanho do objeto.
-Pontuação: Define a pontuação do objeto.
-Se o objeto for do tipo "Evacuation Point" (área de resgate), é possível especificar bônus para alguns tipos de resgate usando um [[Editor de Arenas#entendendo_o_tipo_json_de_pontuacao|Objeto de Pontuação]] para um tipo de objeto dentro de "evacuation_bonus":
-<code javascript>
+> //Se o objeto for do tipo "Evacuation Point" (área de resgate), é possível especificar bônus para alguns tipos de resgate usando um [[Editor de Arenas#entendendo_o_tipo_json_de_pontuacao|Objeto de Pontuação]] para cada tipo de objeto a ser bonificado dentro de "evacuation_bonus"//:
+>
+> //Exemplo abaixo retirado da área de resgate vermelha de arenas OBR://
+> <code javascript>
 "evacuation_bonus": {
-"ObjectDeadVictim": {
+    "ObjectDeadVictim": {
-"points": 0,
+        "points": 0,
-"multiplier": 1.4,
+        "multiplier": 1.4,
-"attempt_points": [],
+        "attempt_points": [],
-"attempt_multipliers": []
+        "attempt_multipliers": []
+    }
 }
+</code>
+Para referenciar tipos de objetos a serem resgatados, utilize o esquema de nomeação do nome do objeto em inglês, com as iniciais em maiúsculo, precedido por "Object": ''ObjectCuboid'', ''ObjectRescueKit'', ''ObjectLiveVictim'', etc...
+Se o objeto for de qualquer outro tipo, é possível definir uma pontuação que será concedida por resgatar o objeto em qualquer área de resgate, utilizando um [[Editor de Arenas|objeto de pontuação]]:
+<code javascript>
+"rescue_score": {
+    "points": 0,
+    "multiplier": 1,
+    "attempt_points": [],
+    "attempt_multipliers": []
 }
 </code>
-Para referenciar tipos de objetos a serem resgatados, utilize o esquema de nomeação do nome do objeto em inglês, com as iniciais em maiúsculo, precedido por "Object":
+--------
-ObjectCuboid
+**Para alterar arenas como um todo, veja [[Editor de Arenas]].**
-ObjectRescueKit
-ObjectLiveVictim
-etc...
-Se o objeto for de qualquer outro tipo, é possível definir uma pontuação que será concedida por resgatar o objeto em qualquer área de resgate, utilizando um [[Editor de Arenas|objeto de pontuação]].