From 8d9652f0a6a1e1b9ad9764a2fa3e4d3da9f9806e Mon Sep 17 00:00:00 2001 From: Enricco Gemha Date: Tue, 19 Nov 2024 07:50:10 -0300 Subject: [PATCH 1/3] translate(pt/developer-docs/achievement-*): add files to sidebar --- docs/.vitepress/config/pt.ts | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/.vitepress/config/pt.ts b/docs/.vitepress/config/pt.ts index 482ed9b..bea4b99 100644 --- a/docs/.vitepress/config/pt.ts +++ b/docs/.vitepress/config/pt.ts @@ -300,10 +300,10 @@ function sidebarDeveloperDocs(): DefaultTheme.SidebarItem[] { text: "Design de Conquistas", link: "/pt/developer-docs/achievement-design", }, - // { - // text: "Pontuação de Conquistas", - // link: "/pt/developer-docs/achievement-scoring", - // }, + { + text: "Pontuação de Conquistas", + link: "/pt/developer-docs/achievement-scoring", + }, { text: "Escala de Dificuldade e Balanceamento", link: "/pt/developer-docs/difficulty-scale-and-balance", @@ -316,10 +316,10 @@ function sidebarDeveloperDocs(): DefaultTheme.SidebarItem[] { text: "Criação de Emblemas e Ícones", link: "/pt/developer-docs/badge-and-icon-creation", }, - // { - // text: "Visão Geral do Desenvolvimento de Conquistas", - // link: "/pt/developer-docs/achievement-development-overview", - // }, + { + text: "Visão Geral do Desenvolvimento de Conquistas", + link: "/pt/developer-docs/achievement-development-overview", + }, // { // text: "Versões Mínimas Requeridas para Funcionalidades de Lógica", // link: "/pt/developer-docs/minimum-required-versions-for-logic-features", From da7f765b9438aceb907d60cb7b14d586591d1a3a Mon Sep 17 00:00:00 2001 From: Enricco Gemha Date: Tue, 19 Nov 2024 07:50:53 -0300 Subject: [PATCH 2/3] translate(pt/developer-docs/achievement-*): translate `achievement-scoring.md` --- docs/pt/developer-docs/achievement-scoring.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/pt/developer-docs/achievement-scoring.md diff --git a/docs/pt/developer-docs/achievement-scoring.md b/docs/pt/developer-docs/achievement-scoring.md new file mode 100644 index 0000000..18380b9 --- /dev/null +++ b/docs/pt/developer-docs/achievement-scoring.md @@ -0,0 +1,63 @@ +--- +title: Diretrizes de Pontuação de Conquistas +description: Aprenda a pontuar conquistas de forma eficaz, considerando fatores como dificuldade, duração do jogo e distribuição de conquistas. Compreenda os níveis de pontos e diretrizes para repontuação e exceções. +--- + +# Pontuação de Conquistas + +## Pontuação + +Não há limite máximo de pontos definido. Ao pontuar conquistas, faça corresponder suas pontuações a um destes 5 níveis. + +| Níveis de Pontos | Dificuldade | Significância (Nível de Importância) | +| :--------------: | :---------: | :-----------------------------------------------------: | +| 0-5 | Fácil | Menor
- _Coletar um power-up_
- _Vencer uma fase_ | +| 10 | Médio | Intermediário
- _Derrotar um chefe_ | +| 25 | Difícil | Principal
- _Terminar o Jogo_ | +| 50 | Muito Difícil | Nível de Conclusão | +| 100 | "Impossível" | Tipicamente para Conjuntos Bônus | + +Existem outros [fatores](#fatores-a-considerar-ao-pontuar-conquistas) que você também deve considerar, como distribuição de conquistas e duração do jogo. + +A pontuação de um conjunto para outro nunca será perfeitamente igual, mas este sistema de pontuação permite que os pontos ganhos correspondam mais de perto à habilidade e ao esforço. + +## Fatores a Considerar ao Pontuar Conquistas + +### Dificuldade + +Considere para todo o conjunto: + +- Qual porcentagem de jogadores obteve a conquista? +- Quão difíceis foram as conquistas para você? +- Qual é a pontuação atual em comparação com outras conquistas? +- Quanto tempo, esforço e prática são necessários para aprender as habilidades necessárias para completar a conquista, o jogo e todo o conjunto? + +### Distribuição de Conquistas + +Imagine que você tem duas versões do mesmo conjunto, com a mesma dificuldade: + +- Se o conjunto tem muitas conquistas similares, cada uma deve ter uma pontuação menor. +- Se tem poucas, elas devem ter uma pontuação maior. + +### Duração do Jogo + +- Para jogos longos, as conquistas devem ter uma pontuação um pouco maior do que jogos curtos. +- RPGs costumam ser muito mais longos que outros gêneros. A duração do jogo deve ser um fator na pontuação, mas é menos importante que os outros três. +- [Exemplos](https://retroachievements.org/viewtopic.php?t=9050&c=47755). + +## Repontuação + +Até junho de 2019, o RetroAchievements tinha um limite de 400 pontos por conjunto, sem restrições para conquistas individuais. O limite do conjunto foi removido para dar menos foco aos totais do conjunto e mais às próprias conquistas. Esta iniciativa também teve como objetivo eliminar a ideia errônea de que um conjunto valendo 400 pontos é um conjunto "completo". + +Assim como com revisões e mudanças estéticas, uma repontuação geralmente requer aprovação da comunidade. Você pode encontrar mais informações sobre repontuações [aqui](/guidelines/content/achievement-set-revisions). + +## Exceções + +Alguns jogos podem surgir como exceções aos níveis normais de pontuação e serão listados aqui. + +- Conquistas de Picross e Sudoku se enquadram em uma categoria especial de pontuação da seguinte forma, com base na dificuldade: + - Fácil - 1 ponto + - Médio - 2-3 pontos + - Difícil - 4-5 pontos +- Picross 3D é uma exceção a esta regra e é pontuado normalmente +- Outras exceções podem ser solicitadas por Revisores de Código e/ou Administradores caso a caso From 24f8e91f34efd38f6737f3f65e15d72d22d5449d Mon Sep 17 00:00:00 2001 From: Enricco Gemha Date: Tue, 19 Nov 2024 08:05:24 -0300 Subject: [PATCH 3/3] translate(pt/developer-docs/achievement-*): translate `achievement-development-overview.md` --- .../achievement-development-overview.md | 159 ++++++++++++++++++ 1 file changed, 159 insertions(+) create mode 100644 docs/pt/developer-docs/achievement-development-overview.md diff --git a/docs/pt/developer-docs/achievement-development-overview.md b/docs/pt/developer-docs/achievement-development-overview.md new file mode 100644 index 0000000..fcadcb3 --- /dev/null +++ b/docs/pt/developer-docs/achievement-development-overview.md @@ -0,0 +1,159 @@ +--- +title: Guia Abrangente de Desenvolvimento de Conquistas +description: Mergulhe profundamente na arte da criação de conquistas com este guia detalhado cobrindo conceitos básicos, ferramentas do editor, métodos de proteção, dicas de lógica, recursos menos conhecidos e muito mais. +--- + +# Visão Geral do Desenvolvimento de Conquistas + +## Introdução + +A página está em intenso desenvolvimento (WIP), mas o objetivo é mergulhar profundamente na criação de conquistas. Provavelmente acabaremos mesclando os "Exemplos Reais" nesta seção de alguma forma. Cada flag, tipo, tamanho, comparação, etc. terá sua própria página para mostrar as várias maneiras como podem ser usados. Também incluirá várias dicas, estudos de caso, etc. + +## Conceitos Básicos + +- Adicionando Jogos ao Banco de Dados + - Tudo o que você sempre quis saber (mas tinha medo de perguntar) sobre hashes + - Guia de Patches +- Mineração de RAM + - Utilizando códigos do Game Genie, Game Shark, Codebreaker, Action Replay, etc. +- Notas de Código + - Convenções de formatação + +## Editor de Conquistas + +Existem várias ferramentas e opções disponíveis para um desenvolvedor. Saber como utilizá-las adequadamente melhorará a qualidade dos seus conjuntos. Estas ferramentas/opções podem ser usadas no Editor de Conquistas: + +![editor_de_conquistas](https://user-images.githubusercontent.com/45054151/128662028-74e64baf-46ff-4c9f-9837-3684bfb42ad8.png) + +### Flags + +- [Flag `PauseIf`](/developer-docs/flags/pauseif) + + - [`PauseIf` com contadores de acertos](/developer-docs/flags/pauseif#pauseif-with-hit-counts) + +- [Flag `ResetIf`](/developer-docs/flags/resetif) + + - [`ResetIf` com contadores de acertos](/developer-docs/flags/resetif#resetif-with-hit-counts) + +- [Flag `ResetNextIf`](/developer-docs/flags/resetnextif) + +- [Flag `AddSource`](/developer-docs/flags/addsource) + +- [Flag `SubSource`](/developer-docs/flags/subsource) + + - [Verificando um resultado negativo](/developer-docs/flags/subsource#checking-for-a-negative-result) + +- [Flags `AddHits` e `SubHits`](/developer-docs/flags/addhits-subhits) + +- [Flag `AddAddress`](/developer-docs/flags/addaddress) + +- [Flags `AndNext` e `OrNext`](/developer-docs/flags/andnext-ornext) + +- [Flags `Measured` e `MeasuredIf`](/developer-docs/flags/measured) + +- [Flag `Trigger`](/developer-docs/flags/trigger) + +### Tipos + +- Mem +- Value +- Delta + - Comparações `Mem > Delta` +- Prior +- BCD +- Float + +### Tamanhos + +- bit0 - bit7 +- 8-Bit +- 16-Bit +- 24-Bit +- 32-Bit +- Lower4 e Upper4 +- 16-Bit BE +- 24-Bit BE +- 32-Bit BE +- BitCount +- Float +- MBF32 + +### Comparações Gerais + +- `=` +- `<` +- `<=` +- `>` +- `>=` +- `!=` + +### Comparações Específicas de Flags + +- `*` +- `/` +- `&` + +### Outros Recursos do Kit de Ferramentas + +- Contadores de Acertos + - Usando com `ResetIf` + - Usando com `PauseIf` +- Grupos Alt + +## Proteções + +- Proteção contra Demo + - Encontrando e testando endereços de demo +- Proteção de Save + - Delta e Prior + - Usando temporizadores in-game + - Usando flags de eventos +- Proteção contra Senhas +- Proteção contra Trapaças +- Proteção para Multiplayer +- Outros + - Dipswitch + - BIOS (PlayStation e Saturn) + +## Dicas e Truques de Lógica + +- Hits de checkpoints +- Travas de Pausa +- Usando Contadores de Acertos como temporizador +- Usando Valores Delta e Contadores de Acertos para Detectar um Incremento +- Contornando o Problema de um Contador Incrementando Duas Vezes no Mesmo Frame + - `nota: precisa adicionar algo sobre como o kit de ferramentas ainda usa hex mesmo se o valor estiver em BCD` +- Vários tipos de cadeias +- Quando usar `ResetIf` ou `PauseIf` +- Quando usar Delta ou Prior +- Usando BitCount para colecionáveis +- Usando `AddSource` com comparações `Mem / Mem` +- Criando um Temporizador com hits do `ResetIf` baseado na velocidade do jogo +- Usando `bit0` para incluir ou excluir valores ímpares + +## Recursos Menos Conhecidos + +- Duplo clique em bitflags enquanto estiver na visualização de 8 bits +- Clique com o botão direito em endereços no editor para pular para eles no Inspetor de Memória (também funciona com offsets para pular para o endereço atual) +- Destacar condições e segurar CTRL enquanto clica para alterar um campo em várias condições de uma vez + +## Dicas de Fluxo de Trabalho + +- Usando Google Sheets e Notepad++ +- Editando arquivo local + +## Coisas a Evitar e Por Quê + +- `ResetIf`s redundantes +- Conquistas com condição única +- Endereços baseados em texto + +## Veja Também + +- Distribuição de Pontos +- Criação de Badges +- Rich Presence +- Tabelas de Classificação +- RATools +- Fazendo Vídeos Tutoriais +- Tabela de Sintaxe