diff --git a/Handling-Tickets/index.html b/Handling-Tickets/index.html
index edbae882..7defcf77 100644
--- a/Handling-Tickets/index.html
+++ b/Handling-Tickets/index.html
@@ -4644,14 +4644,19 @@ <h3 id="claiming-a-ticket">Claiming a Ticket<a class="headerlink" href="#claimin
 </ul>
 <h2 id="if-a-developer-becomes-active-again">If a Developer Becomes Active Again<a class="headerlink" href="#if-a-developer-becomes-active-again" title="Permanent link">link</a></h2>
 <p><em>Who handles tickets for achievements edited while the developer is Inactive?</em></p>
-<p>If an inactive developer becomes active again, they are still responsible for their achievements that have been fixed by other developers.
-* It is strongly recommended that the newly active dev review any tickets that were resolved during their inactivity period so they can understand the changes made to their achievements.
-* If necessary, reach out to the developer who made the updates that resolved the tickets.
-* If the newly active developer no longer wants to be the owner of the achievements, they can reach out to the Developer Compliance team to inquire about a reauthor of said achievements.
-  * Note that an accepted reauthor will be handled on a case-by-case basis, depending on the developers in question as well as the changes made to the achievements. This rule will be reevaluated if the implementation of a set or achievement maintainer is introduced.</p>
+<p>If an inactive developer becomes active again, they are still responsible for their achievements that have been fixed by other developers.</p>
+<ul>
+<li>It is strongly recommended that the newly active dev review any tickets that were resolved during their inactivity period so they can understand the changes made to their achievements.</li>
+<li>If necessary, reach out to the developer who made the updates that resolved the tickets.</li>
+<li>If the newly active developer no longer wants to be the owner of the achievements, they can reach out to the Developer Compliance team to inquire about a reauthor of said achievements.<ul>
+<li>Note that an accepted reauthor will be handled on a case-by-case basis, depending on the developers in question as well as the changes made to the achievements. This rule will be reevaluated if the implementation of a set or achievement maintainer is introduced.</li>
+</ul>
+</li>
+</ul>
 <h2 id="changelog">Changelog<a class="headerlink" href="#changelog" title="Permanent link">link</a></h2>
 <p>Last 10 changes on this page:</p>
 <ul>
+<li><code>[2024-03-11 14:11] Andrew Comer:</code> Updated Handling Tickets (markdown)</li>
 <li><code>[2024-03-11 14:08] Andrew Comer:</code> Updated Handling Tickets (markdown)</li>
 <li><code>[2024-03-11 14:03] Andrew Comer:</code> Bullet formatting fixes.</li>
 <li><code>[2024-03-11 13:57] Andrew Comer:</code> Bullet formatting fixes.</li>
@@ -4661,7 +4666,6 @@ <h2 id="changelog">Changelog<a class="headerlink" href="#changelog" title="Perma
 <li><code>[2024-01-13 23:04] The Mystical One:</code> Updated Handling Tickets (markdown)</li>
 <li><code>[2024-01-13 23:03] The Mystical One:</code> Updated Handling Tickets (markdown)</li>
 <li><code>[2024-01-13 22:57] The Mystical One:</code> Updated Handling Tickets (markdown)</li>
-<li><code>[2024-01-13 22:55] The Mystical One:</code> Changed the Set Claims &amp; Tickets heading to be a question so that it is much more eye-catching.</li>
 </ul>
 
 
diff --git a/search/search_index.json b/search/search_index.json
index 01a54663..286766c7 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en","pt","es"],"separator":"[\\s\\-\\.]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Index","text":"<p>Welcome to the RetroAchievements documentation!</p> <p>The docs are currently under heavy construction so be sure to check back often! Each section appears in the sidebar, but here is a brief explanation of the categories:</p> <ul> <li>Guidelines: Details community, user/player, developer, and content policies.</li> <li>General: FAQ, getting started, support/troubleshooting, and other info that can be useful to all members of the community.</li> <li>Achievement Development: Extensive information on both the conceptual and technical aspects of making achievements.</li> </ul> <p>We encourage all community members to join our Discord Server; we use this for most communication.</p> <p>Translations</p> <ul> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 14:29] televandalist:</code> Removed the RA logo from the top since the link was broken</li> <li><code>[2023-06-30 12:36] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-30 12:14] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-06 10:35] televandalist:</code> Fix broken link</li> <li><code>[2023-04-13 15:08] televandalist:</code> Removed the links to pages that deal with specific support questions. They should/will be merged with a support section or the FAQ to declutter the home page.</li> <li><code>[2023-04-13 14:51] televandalist:</code> Removed link to \"Free Games\" section. While they are free homebrews, the downloads are typically on site if they actually have a set. If they aren't, they should be.</li> <li><code>[2022-08-23 20:22] Jazerus:</code> grammar fixes</li> <li><code>[2022-02-18 21:24] televandalist:</code> Add Event page link</li> <li><code>[2021-04-21 10:23] meleu:</code> french docs are yet incomplete</li> <li><code>[2020-09-07 09:06] meleu:</code> add Manifesto</li> </ul>"},{"location":"A-message-for-Achievement-Hunters-and-Completionists-about-revisions/","title":"A message for Achievement Hunters and Completionists about revisions","text":"<p>Let's start jumping directly to the conclusion:</p> <p>If you mastered a game and then it received a revision, don't feel frustrated! Keep in mind that changes come for a better quality.</p> <p>Now let's elaborate why we are saying that.</p> <p>RetroAchievements is a \"young\" project and is constantly evolving. It was launched in the late 2012, and in the early days the emulators and the site (database stuff, PHP, HTML, CSS, JavaScript, etc.) were developed by a single person: Scott. Therefore the evolution occurred slowly.</p> <p>Another thing that was occurring very slowly in the early days was the diffusion of knowledge about achievement creation. Specially about good practices when creating achievements. There wasn't documentation at that time (RADocs only started in November/2017). People were learning to create achievements by sharing knowledge on forum threads and/or by personal messages.</p> <p>In the early days the community didn't have a very clear a concept of what a good achievement design is. And it resulted in many poorly designed sets compared to our current standards (e.g. sets with only progress-based achievements). We also didn't have much experience of how achievements could be protected against in-game cheats or battery save abusing. That's why from time to time some achievement sets receive revisions. We make set revisions with quality in mind, and to show actual respect for the game.</p> <p>When a revision is going to happen, we try to involve the community by discussing on our forums (usually the official game's topic) and/or on our discord server. We are aware that this is insufficient to reach all interested people, but it is the way we are currently using.</p> <p>We are working on new ways to discuss revisions with the community by implementing some new social features on the RA website, but while those features are not implemented, we'll keep using the forums and discord.</p> <p>If you would like to propose new methods for discussing revisions, we are open to suggestions.</p>"},{"location":"About-Us/","title":"About Us","text":""},{"location":"About-Us/#ra-staff","title":"RA Staff","text":"<p>The RetroAchievements project started as a personal project of Scott Breen and in the early days the project had only administrators, achievement creators, and regular users (and it's still like that on the website). At that time administrators were responsible to do things like:</p> <ul> <li>keep an eye on the quality of achievements</li> <li>keep an eye if someone is changing other people's achievements (accidentally or intentionally)</li> <li>welcome new achievement creators and show them the information they need to start contributing</li> <li>review the work of new achievement creators</li> <li>get rid of trolls</li> <li>get rid of cheaters</li> <li>avoid legal problems related to piracy</li> <li>sometimes host gaming events</li> <li>besides all those chores, RAdmins also have interest in playing old games, you know...</li> </ul> <p>As the community continues to grow, the amount of work, time, and energy required to keep it running also grows. In order to assure the project thrives, without administrators having burnouts and ragequitting the project, various roles with specific tasks were created.</p> <p>These roles are not really visible in the website, but they are on discord and here in this page we list the roles and their responsibilities.</p> <ul> <li>Team Accounts</li> <li>Root</li> <li>Administrators</li> <li>Moderators</li> <li>Developer Compliance Team</li> <li>Quality Assurance Team</li> <li>Code Reviewer Team</li> <li>Tech Team</li> <li>Sub-Team Leads</li> </ul>"},{"location":"About-Us/#team-accounts","title":"Team Accounts","text":"<p>Shared accounts used by their respective team members:</p> <ul> <li>DevCompliance</li> <li>DevQuest</li> <li>QATeam</li> <li>RAdmin</li> <li>RAEvents</li> <li>RANews</li> <li>TheUnwanted</li> </ul>"},{"location":"About-Us/#root","title":"Root","text":"<p>Members who have direct access to the webserver.</p> <ul> <li>KickMeElmo</li> <li>luchaos</li> <li>MrOwnership</li> <li>Scott</li> </ul>"},{"location":"About-Us/#administrators","title":"Administrators","text":"<p>A group of dedicated and trusted users with varied responsibilities, the heaviest being decision-making regarding the direction of the project and community:</p> <ul> <li>AuburnRDM</li> <li>Hotscrock</li> <li>Jamiras</li> <li>KickMeElmo</li> <li>luchaos</li> <li>MrOwnership</li> <li>Scott</li> <li>Snow</li> <li>SporyTike</li> <li>televandalist</li> </ul>"},{"location":"About-Us/#moderators","title":"Moderators","text":"<p>The team responsible to keep the this community a healthy place (at least for those who adhere to the User's Code of Conduct and agree with the RetroAchievements Manifesto):</p> <ul> <li>AuburnRDM</li> <li>BahamutVoid</li> <li>Hotscrock</li> <li>KickMeElmo</li> <li>pinguupinguu</li> <li>Searo</li> <li>Snow</li> <li>SporyTike</li> <li>Suffa28</li> </ul>"},{"location":"About-Us/#developer-compliance-team","title":"Developer Compliance Team","text":"<p>The team responsible for the adherance and driving updates to the Developer's Code of Conduct.</p> <ul> <li>Bryan1150</li> <li>DoctorV</li> <li>Etron</li> <li>GalacticSpear</li> <li>Hotscrock</li> <li>malasdair</li> <li>MrOwnership</li> <li>pinguupinguu</li> <li>psyduck</li> <li>televandalist</li> <li>TheMysticalOne</li> <li>timenoe</li> </ul>"},{"location":"About-Us/#quality-assurance-team","title":"Quality Assurance Team","text":"<p>The team responsible for ensuring the overall quality of achievement sets: including logic, correct titles and descriptions, working leaderboards, working rich presence and hash compatibility:</p> <ul> <li>Bartis1989</li> <li>DoctorV</li> <li>Falcus</li> <li>Hotscrock</li> <li>MrOwnership</li> <li>psyduck</li> <li>Searo</li> <li>Soulsderfuchs</li> <li>StingX2</li> <li>televandalist</li> <li>xnaivx</li> </ul>"},{"location":"About-Us/#code-reviewer-team","title":"Code Reviewer Team","text":"<p>The team responsible for helping Jr. Devs learn how to make achievements sets and review their work to ensure their understanding is enough to make sets on their own:</p> <ul> <li>blendedsea</li> <li>Brandovsky</li> <li>Bryan1150</li> <li>DarkyAndreas</li> <li>DoctorV</li> <li>Etron</li> <li>Falcus</li> <li>Fridge</li> <li>gollawiz</li> <li>LogicalFallacy</li> <li>MrOwnership</li> <li>Ryudo</li> <li>Searo</li> <li>Shmelyoff</li> <li>SlashTangent</li> <li>SporyTike</li> <li>suspect15</li> <li>thegotoguyy</li> <li>TheMysticalOne</li> <li>xnaivx</li> </ul>"},{"location":"About-Us/#tech-team","title":"Tech Team","text":"<p>The team that is more involved with the tech side of things, whether it be the website, emulators, Discord bots, etc.:</p> <ul> <li>AlmightyXor</li> <li>amine456</li> <li>clymax</li> <li>DanielARP</li> <li>drisc</li> <li>Jamiras</li> <li>KickMeElmo</li> <li>Krylan</li> <li>LootusMaximus</li> <li>luchaos</li> <li>[meleu](https://retroachievements.org/user/meleu</li> <li>mosquitobird11</li> <li>MrOwnership</li> <li>oddgoo</li> <li>Scott</li> <li>Searo</li> <li>TeddyWestside</li> <li>televandalist</li> <li>WCopeland</li> <li>Xymjak</li> </ul>"},{"location":"About-Us/#sub-team-leads","title":"Sub-Team Leads","text":"<p>Users who oversee one of the QA sub-teams:</p> <ul> <li>Bendyhuman - Events Team lead</li> <li>Nydaxn - Art Team lead</li> </ul>"},{"location":"About-Us/#short-history","title":"Short History","text":"<p>The RetroAchievements project was created by Scott Breen in 2012. He hacked some open source emulators to add the RetroAchievements feature and coded all the backend/website mostly alone.</p> <p>By January 2014, there were 4 RA emulators, over 5000 achievements to earn (thanks to the devotion of many passionate achievement developers) and over 1000 players registered. After a couple of years Scott was called by the real life the website development went into a period of hiatus with just a few sporadic improvements (the achievement developers were continually working on more and more games, though).</p> <p>In late 2015 leiradel started to work to integrate the RetroAchievements feature into RetroArch. And, as RetroArch is able to run on a wide variety of platforms (such as Mac and Linux) and devices (such as Android phones and Raspberry pi), it helped a lot to increase the popularity of the RetroAchievements project.</p> <p>As the site slowly grew, so did the bandwidth costs, so in late 2016, Scott reached out to the community and they suggested doing a Patreon to keep the site going. After implementing it, the community response was fantastic, which allowed the site to continue completely ad-free.</p> <p>Mid 2017 the RetroAchievements Discord server was started and it made communication across the community much easier. Since then, many knowledgeable members (coders, web developers, etc.) joined the scene volunteering to contribute to the project.</p> <p>Up to this point all the achievement creation knowledge was scattered in several forum posts, making it very tough for a newbie to learn how to create achievements. Then in the late 2017 meleu started the RADocs project and thanks to contributions from many experienced achievement creators it is now a reasonably solid resource of information. Helping dozens of Jr. Developers (and even the experienced ones) to create content for our community.</p> <p>In the early 2018 Scott opened the source of the back-end/website, which was a turning point in the history of the development of the whole RetroAchievements project (see us at github).</p> <p>Later in the same year a more concise staff began to take shape and is now an awesome team. These talented guys keep the ball rolling and make it very clear that the RA community is alive and stronger than ever.</p> <p>In some areas the project may still look like a beta version, but we are continually working hard to make things better.</p>"},{"location":"About-Us/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-08-04 23:23] Snow:</code> Updated users in roles</li> <li><code>[2023-04-13 14:37] televandalist:</code> Updated the list.</li> <li><code>[2022-06-09 19:04] Searo:</code> Swap QA and DevComp descriptions</li> <li><code>[2022-06-09 18:45] Searo:</code> Add DevComp, Update QA after the split, Add CR, Suffa28 to Mods, SnowPin to Admins</li> <li><code>[2022-04-16 12:07] snowpin:</code> Updated Staff &amp; Tech Team members</li> <li><code>[2022-03-21 15:08] ScottFromDerby:</code> I am now Breen instead of Davies :)</li> <li><code>[2022-03-13 21:11] televandalist:</code> Updated according to current roles.</li> <li><code>[2022-01-28 18:40] SporyTike:</code> added RAdmin and QATeam as contacts to the lists, I got feedback from users that it might be good to put them here</li> <li><code>[2021-11-28 14:14] televandalist:</code> Update team lists</li> <li><code>[2021-06-01 09:19] meleu:</code> add missing human being to be listed in the mod team</li> </ul>"},{"location":"Achievement-Design-es/","title":"Dise\u00f1o de Logros","text":"<p>Esta es una gu\u00eda en como pensar en un buen dise\u00f1o de logros. No el lado t\u00e9cnico sino el conceptual.</p> <p>Este contenido es un resumen de lo que originalmente escribi\u00f3 el usuario de RA cirellio en un tema del foro.</p>"},{"location":"Achievement-Design-es/#logros-basados-en-progresion","title":"Logros basados en Progresi\u00f3n","text":"<p>Hay 3 tipos de logros basados en progresi\u00f3n: progresi\u00f3n simple, progresi\u00f3n basada en historia, y logros de progresi\u00f3n/colecci\u00f3n.</p>"},{"location":"Achievement-Design-es/#progresion-simple","title":"Progresion Simple","text":"<p>Logros basados en progresi\u00f3n son usualmente los mas simples, especialmente si el juego que estas haciendo es nada mas que eso. O no tiene mucho que ver con una trama/historia o algo parecido. En este caso, veamos algunos BUENOS y MALOS ejemplos sobre esto:</p> <ul> <li>Bueno: Completa el stage 1. </li> <li>Malo: Llega al stage 2. </li> </ul> <p>Toma ligeramente mas trabajo programar un logro donde el jugador necesita completar un stage en vez de simple llegar al siguiente. Pero es aparte mas satisfactorio para el jugador, y se ve mucho mas profesional. Aparte tambi\u00e9n es menos susceptible a problemas donde los jugadores cargan partidas de guardado o estados de guardado (savestates) para logros gratis. </p> <ul> <li>Bueno: Completa el juego. </li> <li>Malo: Empieza el juego. </li> </ul> <p>Es cierto que los logros basados en progresi\u00f3n son usualmente logros regalados, pero generalmente todos estamos de acuerdo en que un logro sobre empezar el juego es demasiado f\u00e1cil, y no del todo memorable para el jugador. Es simplemente es una norma, sin embargo es muchas veces la parte mas memorable de un juego para el jugador, y completar un juego es definitivamente un logro en si. Es correcto hacer un logro que funcione de la siguiente manera \"Completa el ultimo mundo y completa el juego\".</p> <ul> <li>Bueno: Completa los stages con tem\u00e1tica de nieve, Completa los primeros cinco stages, o Completa los primeros diez stages. </li> <li>Malo: Completa el Stage 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (todos los logros por separado) </li> </ul> <p>Una de las peores cosas que puedes hacer es spammear logros. Juegos de Puzzle son notorios por tener ese tipo de problemas, porque los stages son cortos y por lo regular, hay cientos o hasta mas. Como resultado, el feed de la pagina principal termina con un mont\u00f3n de micro-actualizaciones, y sacan a los logros de otros usuarios r\u00e1pidamente del feed. La manera de corregir esto de la manera mas profesional posible es espaciar los logros un poco mas, en grupos de stages. Por ejemplo, si los stages 1-10 todos tienen tem\u00e1tica de fuego, y los stages 11-20 todos tienen tem\u00e1tica del espacio, puedes crear logros basados en esas tem\u00e1ticas. Se creativo. </p>"},{"location":"Achievement-Design-es/#progresion-basada-en-historia","title":"Progresion Basada en Historia:","text":"<p>Los momentos mas memorables en la historia de los videojuegos usualmente no est\u00e1n relacionados a coleccionar un \u00edtem o a misiones secundarias, sino a escenas especificas relacionadas con la historia. </p> <p>Ejemplos:</p> <ul> <li>Primer encuentro con Pyramid Head en la serie de Silent Hill. </li> <li>Encontrando la verdad sobre Darth Revan en Knights of the Old Republic. </li> <li>Encontrando que es lo que va a pasar en el futuro en Chrono Trigger. </li> <li>Lanzando la Vaca en Earthworm Jim. </li> <li>Casi cualquier muerte de alg\u00fan personaje. </li> </ul> <p>La cosa es de ser extremadamente cuidados con los spoilers. Si encuentras alg\u00fan logro relacionado con historia y cuenta con un spoiler, contacta al desarrollador responsable. Y a los desarrolladores, por favor sean comprensivos cuando se trate de critica constructiva, el numero y el porcentaje de este tipo de logros varia de juego en juego--Esto realmente se vasa en que tan fuertemente el juego esta enfocado en su historia. </p>"},{"location":"Achievement-Design-es/#progresioncoleccion","title":"Progresi\u00f3n/Colecci\u00f3n","text":"<p>Progresi\u00f3n/Colecci\u00f3n es com\u00fanmente un h\u00edbrido. No solo estas coleccionando un \u00edtem, sino tambi\u00e9n sale una memorable (y mandataria) escena.</p> <p>Ejemplos:</p> <ul> <li>Obtener la Master Sword en A Link to the Past, que levanta la maldici\u00f3n en Lost Woods. </li> <li>Encontrar la espada en la playa en Link's Awakening, y sale la primer escena en el que el sabio b\u00faho habla contigo. </li> <li>Escoger tu Pokemon, el cual sucede en escena del principio, pero b\u00e1sicamente es 'un ritual' para la mayor\u00eda de jugadores.</li> </ul> <p>Logros en esta categor\u00eda h\u00edbrida tipicamente mas satisfactorios ya que hacen doble-trabajo. El jugador no esta solamente obteniendo un \u00edtem, sino tambi\u00e9n viendo una escena memorable y obteniendo un logro a la vez. Bastante dosis de endorfinas! </p>"},{"location":"Achievement-Design-es/#progresion-pros-y-contras","title":"Progresion Pros y Contras","text":"<p>Logros basados en progresi\u00f3n son garantizados que le van a salir al jugador en un play-through normal. Entonces para que tenerlos en primer lugar? </p>"},{"location":"Achievement-Design-es/#pros","title":"Pros","text":"<ul> <li>Un jugador merece puntos por jugar un jugar! A si lo es! Recuerda, bastantes usuarios estan jugando estos juegos por primera vez, y la mayor\u00eda de los juegos son algo dif\u00edciles de pasar. Porque no deber\u00edamos de recompensarlos por un buen y cl\u00e1sico play-through? </li> </ul> <ul> <li>Logros de progresi\u00f3n constantes a largo plazo motivan a los jugadores a completar el juego. </li> </ul> <ul> <li>Algunos jugadores en este sitio web son mas casuales y no intentan hacer muchos mas que pasar juegos. No todos sienten la necesidad de Masterizar cada juego en Hardcore mode. Muchos son perfectamente felices agarrando uno que otro logro aparte durante su play-through normal, y no hay nada malo con eso. </li> </ul> <ul> <li>Algunas escenas son memorables, y merecen sus propio logros! Gente que creci\u00f3 con estos juegos mueren por ver esas escenas en la lista de logros, y tal vez les llegue un poco al coraz\u00f3n cuando vean que ya consiguieron ese logro. </li> </ul> <ul> <li>Los Logros basados en progresi\u00f3n ayudan a otros usuarios a medir que tan lejos esta un jugador en el juego, un poco como  Rich Presence. Podemos decirle algo al jugador como, \"Buena suerte!\" porque sabemos que la siguiente secci\u00f3n sera bastante complicada. Motiva a la comunidad a interactuar. </li> </ul> <ul> <li>El orden importa! Logros de Progresion nos pueden decir sobre un play-through simplemente con el orden en el que salieron. Si sacaste un logro por ese jefe opcional y te ahorraste un mill\u00f3n de dolares DESPU\u00c9S de a ver hecho todas las  sidequests, ese es mucho meno impresionante si conseguiste hacerlo antes de la mitad del juego. En otras palabras, Logros de Progresion nos dan la oportunidad de mostrar un poco como jugamos! Podemos mostrarle al mundo que vencimos al ultimo jefe antes de llegar al nivel 10, o que pudimos vence el modo experto en nuestra primera pasada sin a ver intentado anteriormente F\u00e1cil o Normal. Incluso puede revelar si utilizamos glitches o trucos para saltarnos cierta parte del juego. As\u00ed que, como puedes ver, Logros de Progresion tienen una gran SINERGIA con otros tipos de logros.</li> </ul> <ul> <li>Este tipo de logros son los mas f\u00e1ciles de programar y est\u00e1n generalmente libre de errores. </li> </ul>"},{"location":"Achievement-Design-es/#contras","title":"Contras","text":"<ul> <li>Demasiados logros de progresi\u00f3n pueden sobre-saturar un juego con logros 'regalados', y eso es algo Muy Malo. </li> </ul> <ul> <li>Si tu juego tiene nada mas que este tipo de logros, es simplemente otro play-through aburrido para los jugadores. Llega al stage 2, Llega al stage 3, Llega al stage 4, Completa el Juego. Esta es una buena 'base' para agregar logros de otras categor\u00edas, pero no dejes tu lista en solamente logros de Progresion. De otra manera simplemente estas regalando puntos por algo que los jugadores han hecho un mill\u00f3n de veces anteriormente. </li> </ul>"},{"location":"Achievement-Design-es/#logros-de-sidequestsopcionales","title":"Logros de Sidequests/Opcionales","text":"<p>Los juegos de anta\u00f1o, por lo general, ofrecen de muy poco a nada por vencer un modo extra, mas all\u00e1 de simplemente hacerlo en un d\u00eda lluvioso despu\u00e9s de pasar el juego. Los juegos viejos no contaban con una conexi\u00f3n a Internet. Y no contaban con aspectos sociales mas all\u00e1 del modo de 2-jugadores, y tal vez decirle a tus amigos que pasaste algo. Pero ahora, con RetroAchievements.org, podemos mostrar nuestros logros de anta\u00f1o (incluso si implica volver a hacer lo que hicimos hace a\u00f1os atr\u00e1s). Estos Trofeos son medallas de honor. Puedes observar con ver los logros de otro compa\u00f1ero y empezar a entender que tan lejos a llegado, que tanta habilidad tiene. Junto con eso tambi\u00e9n viene el respeto hacia otros compa\u00f1eros. Socializamos, felicitamos a cualquiera que hubiera hecho un buen trabajo. Sentimos como si perteneci\u00e9ramos, y estuvi\u00e9ramos en buena compa\u00f1\u00eda.</p>"},{"location":"Achievement-Design-es/#misiones-secundarias","title":"Misiones Secundarias","text":"<p>A menudo hay cosas que el jugador puede hacer, pero no son necesarias de completar. En otras palabras, un reto hecho por los desarrolladores. Usualmente son divertidas, o algunas veces no tanto, pero merecen un precio porque requieren de trabajo duro y persistencia para lograrlos. Tienes que caminar por una cuerda floja entre si los jugadores dedicados har\u00e1n algo al respecto, vs. si la meta es algo est\u00fapido. La gente simplemente le va a dar la vuelta, as\u00ed que ten eso en mente.</p> <p>Algunas veces, este tipo de logros son incluso Easter Eggs o cosas que el jugador en toda su vida jam\u00e1s supo que exist\u00edan! Muchos jugadores adoran este tipo de logros. Yo pienso porque aprenden algo nuevo de un juego con el que crecieron, o pensaban que eran los \u00fanicos que saben sobre ello y se emocionan al verlo como un logro aqu\u00ed. Es realmente importante para nosotros los desarrolladores REALMENTE conocer el juego por dentro y por fuera antes de crear un set de logros.</p> <p>Ejemplos de Misiones Secundarias:</p> <ul> <li>Entregar colas al Colector de Colar en Final Fantasy IV. </li> <li>Encontrar el due\u00f1o del \u00cdtem Insignificante en Earthbound. </li> <li>Entregar el Jerky a el Rey en el Castillo de Guardia. </li> <li>La misi\u00f3n de Anju en Majora's Mask. </li> <li>Saber mas del pasado de Wrex en Mass Effect. </li> <li>Las misiones de escolta de Diplomacia/VIP en Flashback: The Quest for Identity. </li> <li>Descubrir un cuarto secreto. </li> </ul> <p>Las misiones secundarias son mas com\u00fanmente encontradas en RPGs, pero especialmente en estos d\u00edas, las sidequests se encuentra pr\u00e1cticamente en cualquier genero. Manten los ojos bien abiertos - Incluso el plataformero que menos piensas podr\u00eda tener una o dos sidequests. La serie de Kirby, en algunos casos, cuenta con \u00e1reas y cuartos escondidos. Algunas veces, las sidequests terminan otorgando un \u00edtem, que cae en un hibrido de: Misiones Secundarias/Colleccionables.</p>"},{"location":"Achievement-Design-es/#logros-opcionales","title":"Logros Opcionales","text":"<p>Ejemplos de Logros Opcionales:</p> <ul> <li>Jefes opcionales. </li> <li>Completar un calabozo de reto (que es un h\u00edbrido de una Sidequest). </li> <li>Completar el Modo Experto (que es un h\u00edbrido de Progresion). </li> <li>Completar un nivel de reto secreto. </li> <li>Conseguir un \u00edtem bastante raro de un monstruo. </li> <li>Completar el juego con un personaje opcional. </li> <li>Obtener alguna puntuaci\u00f3n. </li> <li>Completar caracter\u00edsticas que solo se desbloquean en la segunda pasada. </li> <li>Modos de juego que solo se desbloquean en m\u00faltiples pasadas. </li> <li>Finales del juego opcionales. </li> <li>C\u00f3digos que puedes introducir en la pantalla de t\u00edtulo para hacer el juego mas dificil. </li> </ul> <p>Estos son los desarrolladores del juego esperando a que te guste su juego lo suficiente para que vuelvas a el aun mas, incluso despu\u00e9s que hubieran rodado los cr\u00e9ditos. Ellos intentan recompensar al jugador por completar su juego, y crear un poco mas de re-jugabilidad. Si los desarrolladores del juego se dieron la molestia de hacer cosas como estas una parte integral del juego, nosotros como desarrolladores de logros deber\u00edamos de reconocer estos retos y crear los logros adecuados tan siquiera para algunos de ellos.</p> <p>Chrono Trigger, Chrono Cross, y Star Ocean: The Second Story son famosos por hacer esto. Las entregas para el Game Boy Advance de Castlevania tambi\u00e9n hacen esto. En efecto, muchos juegos lo hacen. Si no estas completamente seguro de que tu juego cuente con modos extras o retos, procura hacer un poco de research y checar algunos FAQs. O tambi\u00e9n puedes preg\u00fantale a la comunidad de aqu\u00ed, varios de nosotros somo expertos en varios juegos de aqu\u00ed. </p>"},{"location":"Achievement-Design-es/#sidequestsopcionales-pros-y-contras","title":"Sidequests/Opcionales Pros y Contras","text":"<p>Los logros de Sidequests/Opcionales son fant\u00e1sticos suplementos para los logros de Progresion. </p>"},{"location":"Achievement-Design-es/#pros_1","title":"Pros","text":"<ul> <li>Esta es el pan-y-mantequilla de los logros. Chances hay de que, una buena cantidad de tus logros vengan de esta categor\u00eda. Todos los juegos tienen cosas opcionales que hacer. Colecciona todas las monedas en un nivel! Consigue 9 vidas! Crear logros de este tipo es f\u00e1cil, y recompensa al jugador por su dedicaci\u00f3n. </li> </ul> <ul> <li>Los desarrolladores de juegos aman a los jugadores que aprecian las cosas. Les gusta cuando los jugadores se toman la molestia de adentrarse profundamente en sus juegos, apreciando su trabajo duro, de otra manera no mirar\u00edamos  cosas 'divertidas' escondidas en juegos como Easter Eggs, escenas bonus, etc. Si los desarrolladores de juegos recompensan al jugador por hacerlo, porque nosotros no? Nosotros desarrolladores tambi\u00e9n tenemos que reconocer cuando el jugador a recorrido una milla extra.</li> </ul> <ul> <li>Los jugadores aman decirle a sus amigos cuando encuentran algo inusual y fuera de lo com\u00fan en un juego. Con este sitio, ellos pueden mostrarle a sus amigos que si mataron a la 'rana amarilla' que rara vez se ve en el pantano, o encontraron el transportador a la 'dimensi\u00f3n desconocida'. Si incluimos estas curiosidades en nuestras listas de logros, le estamos demostrando a los jugadores que 'estamos informados', que crea confianza en que podemos guiarlos completamente por el juego. </li> </ul> <ul> <li>Logros de Sidequests/Opcionales le dan a los jugadores algo por lo que esforzarse despu\u00e9s de haber pasado el juego.</li> </ul> <ul> <li>Estos tipos de logros pueden ser com\u00fanmente conseguidos en cualquier momento. Los jugadores sienten un llegue mas fuerte de endorfinas cuando un logro sale cuando ellos no esperaban conseguirlo, pero se le fue premiado. </li> </ul> <ul> <li>Estos tipos de logros son por lo general f\u00e1ciles de programar, despu\u00e9s de los logros tipo progresi\u00f3n. </li> </ul>"},{"location":"Achievement-Design-es/#contras_1","title":"Contras","text":"<ul> <li>A algunos jugadores no les interesa explorar mas all\u00e1 de lo que ofrece el t\u00edpico play-through, as\u00ed que un set con un gran porcentaje de este tipo de logros pueden sentir al jugador como si no se le hubiera premiado lo suficiente. (Por supuesto, este tipo de jugador es un poco raro en un sitio web centrado en logros.) </li> </ul> <ul> <li>Alguna gente podr\u00eda sentir que un reto en especifico es muy complicado, incluso si es algo que originalmente los desarrolladores incluyeron para que los jugadores lo consigan. </li> </ul> <ul> <li>Cuando creas un logro de Sidequests/Opcional digamos, por ejemplo, escapa de 999 batallas (u otro logro de llegar a un  nivel-m\u00e1ximo), te arriesgas a que la gente del sitio tal vez sientan que el logro no ofrece realmente un reto sino que  simplemente es un 'grind-fest'. Logros de este tipo son muy probables que sean dados de baja al menos que tenga un segundo prop\u00f3sito, como en Final Fantasy V donde el hecho escapar de batallas le da energ\u00eda a un arma que se llama 'Chicken Knife'. Esto tiene una SINERGIA con el juego, en comparaci\u00f3n a crear un logro en el que se basa solamente en llegar al x nivel mas alto sin ning\u00fan otro prop\u00f3sito.</li> </ul>"},{"location":"Achievement-Design-es/#logros-basados-en-coleccionables","title":"Logros Basados en Coleccionables","text":"<p>La mayor\u00eda de los logros basados en coleccionables son opcionales, al menos que los items sean MacGuffins, que en ese caso ya cae en Progresi\u00f3n/Colecci\u00f3n.</p> <p>Ejemplos:</p> <ul> <li>Encontrar los sombreros de Mickey escondidos para conseguir 1-ups en Aladdin de Genesis. </li> <li>Encontrar items excepcionalmente escondidos. </li> <li>Bestiarios. </li> <li>Desbloquear un personaje opcional. </li> <li>Llegar al M\u00e1ximo de Dinero/Bajas/Habilidades. </li> <li>Encontrar todas las diferentes maneras de morir en juegos como Prince of Persia o Shadowgate. </li> <li>Abrir todos los cofres en un juego/encontrar cada powerup. </li> <li>Todos los items/Coleccionar 99 o 255 (etc.) un \u00edtem en particular. </li> <li>Atrapar todos los Pokemon (cualquier colecci\u00f3n de monstruos, en general.) </li> </ul> <p>Si el juego almacena cierta stat/habilidad, los desarrolladores pr\u00e1cticamente te est\u00e1n motivando a que lo maximices. Ahora, podr\u00edas ser ese tipo de jugador, o tal vez no. Eso tienes que pregunt\u00e1rtelo a ti mismo, como un desarrollador, como quieras o no, otros jugadores si podr\u00edan ser capaz de conseguir esas 9999 bajas de murci\u00e9lagos vampiro por ejemplo, incluso si tu no lo hicieras. Las ventajas de esto es que la gente que no lo haria normalmente ahora tiene algo por lo que volver cuando tengan ganas de volver a jugar el juego. La desventaja es que hay otros jugadores que no llegarian tan lejos como para hacerlo, pero tambi\u00e9n sienten que tienen que MASTERIZAR cada juego r\u00e1pidamente (algo un poco raro), al final se van a quejar. Y si consigues bastantes quejas, tal vez quieras dar de baja ese logro de haz 9999 o a algo un poco mas razonable, como 500. Si nadie se divierte haciendo alg\u00fan logro, ese simplemente no es el esp\u00edritu de jugar juegos y de hacer logros. </p> <p>Tienes que utilizar tu criterio y pensar que es lo que el jugador disfrutar\u00eda mas. Como una regla de oro, es mejor tener algunos logros sobre Sidequests/Opcionales que ni siquiera ninguno. Pero con un poco de empe\u00f1o extra, estos logros pueden hacer tu lista mucho mas memorable. </p> <p>Siguiente, a llegado el momento de que nos subamos nuestras mangas como desarrolladores y nos pongamos MUY creativos, hemos llegado cuando el desarrollador reta al jugador a retos que van mucho mas all\u00e1 de las reglas del juego.</p>"},{"location":"Achievement-Design-es/#logros-por-diversion","title":"Logros por Diversi\u00f3n","text":"<p>Este tipo de logros usualmente otorgan solamente algunos puntos, pero siguen siendo divertidos</p> <p>Ejemplos de Por Diversi\u00f3n:</p> <ul> <li>Deja que el reloj llega a las 99:59 en Valkyrie Profile. </li> <li>Fondos Interactivos, as\u00ed como el cad\u00e1ver colgando en el stage 1 de Castlevania: Bloodlines. </li> <li>Cocinar el hamster en el micro-ondas en Maniac Mansion. </li> <li>Ver el apocal\u00edpsis en Majora's Mask. </li> <li>Encontrar a John Romero en Doom 2. </li> </ul> <p>Algunas veces, los desarrolladores dejan divertidos easter eggs. Ellos se van la milla extra para entrener al jugador con \u00a8que pasar\u00eda si...\u00a8. De nuevo, es nuestro trabajo identificar este tipo de casos y as\u00ed darles soporte como desarrolladores.</p>"},{"location":"Achievement-Design-es/#retos","title":"Retos","text":"<p>Una cosa que tienes que recordar sobre jugadores retro - y los juegos que juegan - es que la mayor\u00eda de las veces nosotros hemos jugado estos juegos un mill\u00f3n de veces anteriormente. Esta es la misma vieja canci\u00f3n y baile para la mayor\u00eda de nosotros, e inclusive a veces necesitamos algo de motivaci\u00f3n para hacerlo de nuevo. Algunos de nosotros hemos terminado Contra sin perder una sola vida. Bueno, a llegado la hora que lo demostremos! </p> <p>A lo que me refiero es que, pi\u00e9nsalo: Antes de este sitio web, la \u00fanica manera de demostrarle a alguien que te pasaste Contra perfectamente era invitar a un amigo para que lo viera, o moverle a un software de grabaci\u00f3n de v\u00eddeo y subir un a YouTube. Pero incluso hay, muchos de esos v\u00eddeos est\u00e1n modificados para que se vean que fue un playthrough perfectos. En cambio, este sitio, cuenta con Hardcore mode, que te ayuda a indicar que nadie esta haciendo trampa. </p> <p>Tal vez ya cuentes con logros de progresi\u00f3n y logros sobre Sidequests/Opcionales, pero si tu quieres crear una lista de logros que sea realmente grandiosa, necesitas al menos algunos logros sobre Retos. Intenta pensar atr\u00e1s a cerca de todos los juegos que haz jugado en este sitio web. Cuales son algunos de los logros mas memorables? Te puedo garantizar que son Logros sobre Retos. Hay excepciones en la regla, claro, pero el jugador tipico no va a realmente recordar un logro sobre, 'Completa el Stage 2-6', o 'Llega al Nivel 30'. Es mas probable que recuerden logros que convirtieron a su playthrough en una experiencia \u00fanica, as\u00ed como...</p> <ul> <li>completa todo el juego sin nunca haber recogido un power-up o moneda</li> <li>derrota a un jefe sin nunca haber recibido un golpe</li> <li>completa un stage sin perder una sola vida</li> </ul> <p>Esto es lo que hace a este sitio tan especial, y lo que hace a los logros algo mucho mas de simplemente completar el juego. </p> <p>Incluso los jugadores que odian la simple idea de los Logros podr\u00edan decir, \"Bueno, excepto por ESTE. Este si estaba bien.\" y te puedo garantizar que el ejemplo del que ESE ejemplo del que estaban hablando fue un logro sobre un reto, algo que reta al jugador mas all\u00e1 del juego en si. </p> <p>Un buen desarrollador de logros va a mantener sus ojos bien abiertos, y sus sentidos al m\u00e1ximo cuando se trate de desarrollar un juego, buscando buenos e inusuales retos. Tal vez notes algo en el juego que seria una haza\u00f1a bastante complicada y que vale la pena.</p>"},{"location":"Achievement-Design-es/#retos-de-speedruns","title":"Retos de Speedruns","text":"<p>Los Timers introducen una presi\u00f3n a los jugadores en sus juegos favoritos que tal vez jamas hubieran sentido. Muy pocas cosas hacen que el coraz\u00f3n se acelere tanto que un reloj haciendo tik-tok. A\u00f1ade un timer, y un juego que era anteriormente tan f\u00e1cil que se poda completar con los ojos cerrados se va a convertir transformar de repente en la prueba jugabilista definitiva de sus vidas. </p> <p>Ejemplos de Retos de Speedruns:</p> <ul> <li>Completa un juego en menos de una hora. </li> <li>Completa un nivel en especifico en menos de tres minutos. </li> <li>Completa un nivel antes de que el contador llega a ciertos segundos. </li> <li>Derrota a 30 murci\u00e9lagos vampiro durante la secuencia de escape. </li> <li>Colecciona 99 monedas bonus antes que termine la secuencia bonus. </li> <li>Llega al punto A a el punto B antes de que el d\u00eda cambie a noche. </li> <li>Tabla de Clasificaci\u00f3n - Completa el juego en el tiempo mas r\u00e1pido posible. </li> <li>Tabla de Clasificaci\u00f3n - Completa un Stage en el tiempo mas r\u00e1pido posible. </li> </ul> <p>Un desarrollador tal vez quiera ir a YouTube o Twitch y ver que tan r\u00e1pido la gente esta terminando un juego (Y por favor ignora v\u00eddeos que utilicen TAS - \"Tool Assisted Speedruns\"). Algunos pro speed-runners son muy r\u00e1pidos que el jugador t\u00edpico no tendr\u00eda la posibilidad de lograrlo en ese tiempo establecido, tienes que encontrar una manera que sea un buen balance. Y si no puedes encontrar un buen tiempo el cual retar a los jugadores, para eso est\u00e1n las tablas de clasificaci\u00f3n - Convi\u00e9rtelo en una competici\u00f3n! De hecho, algunos de tus celebridades favoritas del mundo del speedrun podr\u00edan venir a este sitio y meter uno que otro tiempo. </p> <p>Tu sabes cuando un logro te esta metiendo presi\u00f3n cuando te empiezan a sudar las manos y te encuentras nervioso mientras observas y observas el reloj. Como dije anteriormente, nada grita mas fuerte, \"Despierta!\" que un timer, especialmente cuando los desarrolladores empiezan a\u00f1adir este tipo de logros con OTROS tipos de logros (e incluso tablas de clasificaci\u00f3n) durante una secci\u00f3n contrarreloj del juego. Los Retos de Tiempo tienen una sinergia muy grande con otros tipos de logros. </p>"},{"location":"Achievement-Design-es/#retos-de-limitaciones","title":"Retos de Limitaciones","text":"<p>Ejemplos de Retos con Limitaciones:</p> <ul> <li>Completa un combate o inclusive el juego completo solamente con los personajes de cierta clase en especifico. (Un famoso ejemplo es completar Final Fantasy con un grupo de Magos Blancos.) </li> <li>Vence al jefe final sin equipo puesto. </li> <li>Completa un stage sin brincar. </li> <li>Completa un puzzle con solo dos movimientos. </li> <li>One-hit KOs. </li> <li>Low level games (LLGs). </li> <li>Logros sin que te peguen. </li> <li>Nunca presiones cierto bot\u00f3n(es) durante un reto. </li> <li>Nunca pierdas invisibilidad en un nivel completo de Mario 3, encontrando los suficientes Starmen. </li> <li>Derrota a cierto enemigo sin utilizar cierto movimiento. </li> <li>Llega con Ganon en The Legend of Zelda, sin espada. </li> <li>Derreto a cierto enemigo utilizando SOLAMENTE cierto movimiento. </li> <li>Completa un laberinto mientras estas ebrio/confundido. </li> <li>Completa el juego mientra te encuentras en un estado alterado. </li> </ul> <p>Sitios web basados en juegos en especifico son un recurso fant\u00e1stico para encontrar estos tipos de logros ellos tienen una muy buena idea de que es posible y que es imposible, e inclusive han asta escrito FAQs discutiendo retos alternos y maneras diferente de jugar el juego. </p> <p>Algunas veces, pasara de que no hay en si una comunidad. No FAQs. No tablas de mensajes. E inclusive tal vez no all\u00e1 v\u00eddeos \u00fatiles. En esos casos, tu necesitas ser una persona con la idea de crear nuevos e interesantes retos para el jugador. Ten en cuenta que ese tipo de logros toman mucha practica, tiempo, y experiencia para ser creados. </p> <p>La clave de esto es que SEAS CREATIVO! Y recuerda mantenerlo DIVERTIDO! </p>"},{"location":"Achievement-Design-es/#retos-de-puntuacion","title":"Retos de Puntuaci\u00f3n","text":"<p>Ejemplos de Retos de Puntuaci\u00f3n:</p> <ul> <li>Completa un juego o un nivel con la puntuaci\u00f3n mas baja posible. </li> <li>Completa un minijuego con la puntuaci\u00f3n perfecta (no simplemente le ganas al CPU en las tablas de clasificaci\u00f3n). </li> <li>Tablas de Clasificaci\u00f3n - Completa el juego con la puntuaci\u00f3n mas alta/mas dinero/mejor cantidad de bajas/etc. posible. </li> <li>Tablas de Clasificaci\u00f3n - Completa un nivel en especifico con la puntuaci\u00f3n mas alta/mas dinero/mejor cantidad de bajas/etc. posible.</li> </ul>"},{"location":"Achievement-Design-es/#retos-pros-y-contras","title":"Retos Pros y Contras","text":"<p>Logros sobre retos son tu oportunidad para mostrarle a los jugadores como jugar sus juegos favoritos de una manera diferente, \u00fanica, y inclusive en maneras alucinantes. A pesar de que este tipo de logros le dan un respiro de vida a un set aburrido, tu generalmente solo quieres que una peque\u00f1a parte de este tipo de logros est\u00e9n en tu lista final. </p>"},{"location":"Achievement-Design-es/#pros_2","title":"Pros","text":"<ul> <li>A los jugadores Hardcore les encantan esforzarse en este tipo de logros. </li> </ul> <ul> <li>Si algunos jugadores son bastante hardcore, puedes encontrar un buen punto medio implementando tablas de clasificaci\u00f3n, que satisface a los dos a la vez al cazador de logros casual y los jugadores hardcore. </li> </ul> <ul> <li>Esta es tu oportunidad para ponerte bastante creativo y venir con nuevos retos que los jugadores jamas se esperar\u00edan. Esta puede ser una grata sorpresa y podr\u00eda hacer tus listas verdaderamente memorables. </li> </ul>"},{"location":"Achievement-Design-es/#contras_2","title":"Contras","text":"<ul> <li>Estos tipos de logros requiere una cantidad justa de creatividad, aunque hay muchas maneras de encontrar maneras inusuales de completar juegos como por ejemplo viendo cosas como speed runs. </li> </ul> <ul> <li>Podr\u00eda requerir bastante b\u00fasqueda previa. </li> </ul> <ul> <li>Estos logros son notoriamente complicados de codificar. Estos requieren que hagas bastantes notas de c\u00f3digo, hacer bastante observaciones en las mec\u00e1nicas del juego, e inclusive a veces requieren testear bugs incluso antes que funcionen correctamente. De hecho, tal vez no te encuentres listo para hacer este tipo de logros asta que cuentes con bastantes bastantes sets de logros hechos. Afortunadamente, Logros sobre Retos siempre pueden ser agregados despu\u00e9s. </li> </ul>"},{"location":"Achievement-Design-es/#recursos-externos","title":"Recursos Externos","text":"<ul> <li>Gu\u00eda en las Mejores practicas en la creaci\u00f3n de logros escrito por  Jeff Sullivan, Desarrollador en Administraci\u00f3n de Cuentas de XNA Developer Connection (XDC) respecto a los logros de Xbox 360.</li> <li>Hazlos trabajar por eso una gu\u00eda de dise\u00f1o de logros escrita por Darran Jamieson el 1 de Enero del 2013.</li> <li>La Maquina de Logros: Entendiendo los Logros de Xbox 360 en practicas videojugables - de Mikael Jakobsson</li> </ul>"},{"location":"Achievement-Design-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 13:11] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-11 18:54] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-10 17:08] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-10 11:58] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-08 17:30] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-25 19:25] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-24 16:49] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-23 17:38] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-22 17:12] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-17 17:45] eldexterr:</code> Updated but still not finished</li> </ul>"},{"location":"Achievement-Design-pt_BR/","title":"Design de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Achievement Design</p> <p>Este \u00e9 um guia de como pensar sobre e desenvolver boas conquistas. N\u00e3o o lado t\u00e9cnico, mas o lado conceitual.</p> <p>Este conteudo \u00e9 um resumo do que foi originalmente escrito pelo usu\u00e1rio cirellio em um forum.  <code>texto em ingl\u00eas</code></p>"},{"location":"Achievement-Design-pt_BR/#conquistas-baseadas-em-progresso","title":"Conquistas Baseadas em Progresso","text":"<p>H\u00e1 3 tipos de conquistas baseadas em progresso: progresso simples, progresso baseado na hist\u00f3ria, e conquistas baseadas em progresso/coletagem.</p>"},{"location":"Achievement-Design-pt_BR/#progresso-simples","title":"Progresso Simples","text":"<p>Conquistas baseadas em Progresso s\u00e3o geralmente mais simples, especialmente se o jogo que voc\u00ea est\u00e1 fazendo n\u00e3o passa de fases lineares. Ou n\u00e3o tem muita coisa acontecendo na hist\u00f3ria. Neste caso, vamos dar uma olhadas em alguns exemplos BONS e RUINS disto:</p> <ul> <li>Bom: Clear Stage 1. (Conclua o 1 estagio)</li> <li>Ruim: Reach Stage 2. (Chegue o 2 estagio)</li> </ul> <p>\u00c9 preciso um pouco mais de trabalho para codificar uma conquista em que o jogador precisa concluir a fase, em vez de simplesmente chegar a pr\u00f3xima. Mas tamb\u00e9m \u00e9 muito mais satisfat\u00f3rio para o jogador, e tem muito mais um olhar profissional. Tamb\u00e9m \u00e9 menos suscet\u00edvel a problemas com jogadores que carregam save games ou savestates para ganhar conquistas em massa <code>Nota do tradutor: Em outras palavras: Evitar Cheats</code></p> <ul> <li>Bom: Complete o jogo.</li> <li>Ruim: Inicie o jogo.</li> </ul> <p>Enquanto as conquistas baseadas em progresso s\u00e3o frequentemente brindes, geralmente \u00e9 concordado aqui que uma conquista para come\u00e7ar o jogo \u00e9 um pouco f\u00e1cil demais, e n\u00e3o \u00e9 nada memor\u00e1vel para o jogador. \u00c9 apenas uma formalidade. E finalizando o jogo, no entanto, \u00e9 frequentemente a parte do jogo mais memor\u00e1vel para um jogador, e completar um jogo \u00e9 definitivamente uma conquista em si. \u00c9 uma boa pr\u00e1tica fazer essas conquistas como \"Derrote o ultimo chefe/fase e conclua o jogo\"</p> <ul> <li>Bom: Conclua as fases tem\u00e1ticas de gelo, ou Conclua as cinco primeiras fases, ou Conclua as dez primeiras fases.</li> <li>Ruim: Complete a fase 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (todas as conquistas separadas)</li> </ul> <p>Uma das piores coisas que voc\u00ea pode fazer \u00e9 criar spams de conquistas. Jogos de Puzzles s\u00e3o not\u00e1veis por esses tipos de problemas, porque as fases s\u00e3o curtas e existem centenas delas ou mais. Como um resultado, o feed da p\u00e1gina principal fica com muitas micro-atualiza\u00e7\u00f5es, que \"spama\" as conquistas das outras pessoas para baixo e pra fora da p\u00e1gina principal rapidamente. A maneira de se mostrar mais profissional nessa quest\u00e3o \u00e9 ampliar um pouco mais as conquistas, em grupos de fases. Por exemplo, se os est\u00e1gios 1-10 s\u00e3o todas tem\u00e1ticas de fogo, e as fases 11-20 s\u00e3o tem\u00e1ticas de espa\u00e7o sideral, voc\u00ea pode criar conquistas ao redor desses temas. Seja criativo.</p>"},{"location":"Achievement-Design-pt_BR/#progresso-baseado-na-historia","title":"Progresso Baseado na hist\u00f3ria:","text":"<p>Os momentos mais memor\u00e1veis na hist\u00f3ria dos jogos muitas vezes n\u00e3o est\u00e3o relacionados \u00e0 cole\u00e7\u00e3o de itens ou sidequests, mas para cenas espec\u00edficas relacionadas \u00e0 hist\u00f3ria</p> <p>Exemplos: - O primeiro encontro com Pyramid Head na s\u00e9rie Silent Hill - Encontrar a verdade sobre Darth Revan em Knights of the Old Republic - Encontrar o que ir\u00e1 acontecer no futuro em Chrono Trigger - Lan\u00e7ar a vaca em Earthworm Jim. - Praticamente qualquer morte de personagem.</p> <p>A coisa que voc\u00ea tem que ter cuidado extra \u00e9 com os spoilers. Se voc\u00ea pegar uma conquista baseada em progresso que tem um spoiler, contacte um desenvolvedor sobre isso. E os desenvolvedores, por favor, seja receptivo quando vier cr\u00edticas construtivas! Al\u00e9m disso, o n\u00famero e at\u00e9 a porcentagem deles ir\u00e3o variar de jogo para jogo--E depende muito de como o jogo \u00e9 baseado na hist\u00f3ria.</p>"},{"location":"Achievement-Design-pt_BR/#progressocoletagem","title":"Progresso/Coletagem","text":"<p>Progresso/Coletagem \u00e9 um h\u00edbrido comum. N\u00e3o apenas em voc\u00ea coletar um item, mas tamb\u00e9m inicia uma cena memor\u00e1vel (e obrigat\u00f3ria).</p> <p>Exemplos - Obter a Master Sword em Link to the Past, que sustenta a maldi\u00e7\u00e3o em Lost Woods - Encontrar a espada na praia em Link's Awakening, na primeira cena em que a coruja s\u00e1bia fala com voc\u00ea. - Pegar o seu Pokemon inicial, que acontece durante uma cena inicial, mas \u00e9 um \"ritual de passagem\" para a maioria dos jogadores.</p> <p>Conquistas nesta categoria h\u00edbrida podem oferecer muito mais satisfa\u00e7\u00e3o porquer eles s\u00e3o Conquistas nesta categoria h\u00edbrida geralmente s\u00e3o mais satisfat\u00f3rios pois eles desempenham um papel duplo. O jogador n\u00e3o est\u00e1 apenas pegando um item, mas tamb\u00e9m assistindo uma cena memor\u00e1vel e farturando uma conquista, tudo de uma vez. Que enxurrada de endorfina!</p>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-em-progresso","title":"Pr\u00f3s e Contras em Progresso","text":"<p>Conquistas em Progresso s\u00e3o garantidos ao jogador em uma jogada normal. Ent\u00e3o, por que t\u00ea-los?</p>"},{"location":"Achievement-Design-pt_BR/#pros","title":"Pr\u00f3s","text":"<ul> <li>Um jogador merece os pontos por jogar! Fa\u00e7a eles! Lembre, um monte de pessoas estar\u00e3o jogando esses jogos pela primeira vez, e muitos jogos s\u00e3o um pouco dificeis para se zerar. Por que n\u00e3o devemos recompensar os jogadores por uma boa e normal jogada?</li> </ul> <ul> <li>Pr\u00eamios de progress\u00e3o peri\u00f3dicos ajudam a encorajar os jogadores a completar um jogo.</li> </ul> <ul> <li>Alguns jogadores s\u00e3o mais casuais e n\u00e3o pretendem fazer muito mais do que zerar jogos neste site. Nem todo mundo sente a necessidade de platinar todos os jogos no modo Hardcore. Muitos ficam perfeitamente felizes em conseguir qualquer conquista que possam ter durante uma jogada normal, e n\u00e3o h\u00e1 nada de errado com isso.</li> </ul> <ul> <li>Algumas cenas s\u00e3o t\u00e3o memor\u00e1veis que merecem conquistas pr\u00f3prias! As pessoas que cresceram com esses jogos e os amam, tem o costume de procurar essas cenas em listas de conquistas, e isso pode apenas aquecer seu cora\u00e7\u00e3o quando elas perceberem que isso foi reconhecido.</li> </ul> <ul> <li>Conquistas de progresso ajudam outras pessoas no site a avaliar a dist\u00e2ncia de um jogador em um jogo, parecido com o Estado de Presen\u00e7a. N\u00f3s podemos \"soltar uma linha\" para o jogador e dizer: \"Boa sorte!\" porque sabemos que a pr\u00f3xima parte \u00e9 bem complicada. Encoraja a comunidade a interagir.</li> </ul> <ul> <li>A ordem importa! Conquistas em Progresso podem nos dizer muito sobre o progresso apenas pela ordem que elas ocorram. Se voc\u00ea ativar aquela conquista de boss opcional e conseguiu um milh\u00e3o de dolares, ent\u00e3o voc\u00ea est\u00e1 fazendo todas as sidequests, isso \u00e9 muito menos impressionante do que se voc\u00ea conseguir tir\u00e1-lo bem antes do meio do jogo. Em outras palavras, conquistas em progresso nos permite mostrar um pouco! Podemos mostrar ao mundo que podemos vencer o chefe final antes de chegarmos ao n\u00edvel 10, ou que podemos finalizar o Expert Mode antes de ir primeiro no Facil e Normal. Pode at\u00e9 revelar se usamos falhas ou truques para pular certas partes do jogo. Ent\u00e3o, como voc\u00ea pode ver, conquistas em progresso tem grande SINERGIA com outros tipos de conquistas.</li> </ul> <ul> <li>Esses tipos de conquistas s\u00e3o as mais faceis de codificar e s\u00e3o geralmente livres de erros.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#contras","title":"Contras","text":"<ul> <li>Muitas Conquistas em Progresso podem saturar um jogo com 'brindes', e isto \u00e9 uma Coisa Muito Ruim.</li> </ul> <ul> <li>Se todo o seu jogo n\u00e3o \u00e9 nada alem do que esses tipos de conquistas, entao \u00e9 apenas uma jogatina chata para os jogadores. Chegue a fase 2, Chegue a fase 3, Chegue a fase 4, Complete o Jogo. Estas as uma grande 'base' para voc\u00ea come\u00e7ar a adicionar conquistas de outras categorias, mas n\u00e3o deixe que listas apenas com conquistas em progresso se voc\u00ea pode ajudar com isso. Outra coisa al\u00e9m disso voc\u00ea apenas estar\u00e1 recompensando jogadores por fazer coisa que eles j\u00e1 fizeram um milh\u00e3o de vezes antes.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#sidequestconquistas-opcionais","title":"Sidequest/Conquistas Opcionais","text":"<p>Os jogos antigos, por si s\u00f3, oferecem pouco ou nenhum incentivo para zerar um bonus, al\u00e9m de que \u00e9 algo para fazer em um dia chuvoso depois de voc\u00ea ter zerado o jogo. Jogos antigos n\u00e3o tinham conectividade com a Internet. E eles n\u00e3o tinham aspectos sociais al\u00e9m de 2 jogadores, e talvez dizendo a seus amigos da escola que voc\u00ea vencesse alguma coisa. Mas agora, com o Retroachievements.org, nos podemos mostrar seus trof\u00e9is antigos (mesmo que isso nos obrigue a refazer o que provavelmente j\u00e1 fizemos h\u00e1 muitos anos). Estes trof\u00e9is s\u00e3o emblemas de honra. Voc\u00ea pode olhar as conquistas de outros membros e come\u00e7ar a entender o qu\u00e3o longe eles foram, o qu\u00e3o h\u00e1beis eles s\u00e3o. Junto com isso vem o respeito dos outros membros. N\u00f3s socializamos, n\u00f3s parabenizamos uns aos outros por um trabalho bem feito. E n\u00f3s somos uma boa compania.</p>"},{"location":"Achievement-Design-pt_BR/#sidequests","title":"Sidequests","text":"<p>Muitas vezes h\u00e1 coisas que o jogador pode fazer que est\u00e3o confinados \u00e0s regras do jogo, mas n\u00e3o s\u00e3o necess\u00e1rias para complet\u00e1-lo. Em outras palavras, um desafio contruido para o jogo pelos desenvolvedores originais do jogo. Geralmente elas s\u00e3o divertidos, mas merecem ser ganhos porque elas requerem trabalho duro e pesistencia para ganhar. Voc\u00ea tem que caminhar em uma corda bamba bem entre se jogadores dedicados s\u00e3o propensos a fazer algo, vs. se o objetivo \u00e9 estupido. As pessoas ter\u00e3o vis\u00f5es diferentes sobre isso, ent\u00e3o fortale\u00e7a-se.</p> <p>Muitas vezes, esses tipos de conquistas s\u00e3o at\u00e9 Easter Eggs ou coisas que o jogador nunca soube que existiam em toda a sua vida! Muitos jogadores adoram esses tipos de conquistas. Provavelmente porque eles acabam conhecendo algo novo  sobre um jogo que eles cresceram jogando, ou talvez por perceber que aquele segredo do jogo que \"s\u00f3 ele conhece\" est\u00e1 sendo suportado aqui. \u00c9 muito importante para n\u00f3s desenvolvedores conhecer MUITO BEM o jogo antes de criar um set de conquistas.</p> <p>Exemplos de Sidequests:</p> <ul> <li>Entregando caudas para o Coletor de Caudas em Final Fantasy IV.</li> <li>Encontrar ao dono do Item Insignificante em Earthbound.</li> <li>Entregar o \"Jerky\" para o Rei em Guardia Castle.</li> <li>Fazer a sidequest do Anju em Majora's Mask.</li> <li>Aprender sobre o passado de Wrex em Mass Effect</li> <li>Escoltar Uma pessoa muito Importante em Flashback: The Quest for Identity.</li> <li>Descobrir uma sala secreta.</li> </ul> <p>Sidequests s\u00e3o mais frequentemente encontrados em RPGs, mas especialmente nesses dias, sidequests s\u00e3o encontrandas em quase todos os g\u00eaneros. Mantenha seus olhos abertos, jogos de plataforma pode tem uma ou tr\u00eas sidequests. Os jogos da s\u00e9rie Kirby por exemplo, tem muitas salas e \u00e1reas escondidas. Muitas vezes, sidequests acabam com \"ganhando um item\" no qual acaba sendo um hibrido: Sidequest/Coletagem.</p>"},{"location":"Achievement-Design-pt_BR/#conquitas-opcionais","title":"Conquitas Opcionais","text":"<ul> <li>Chefes Opcionais</li> <li>Concluir o desafio de uma dungeon (Que \u00e9 um h\u00edbrido de Sidequest)</li> <li>Completar o Modo Expert (que \u00e9 um h\u00edbrido de progress\u00e3o)</li> <li>Completar um desafio secreto.</li> <li>Conseguir a exce\u00e7\u00e3o de de conseguir pegar um item de um monstro. (Pegar um item raro)</li> <li>Completar o jogo com um personagem opcional.</li> <li>Conseguir uma pontua\u00e7\u00e3o alta</li> <li>Conseguir coisas que apenas s\u00e3o desbloqueadas em uma segunda jogatina</li> <li>Modos de jogos que s\u00e3o apenas desbloqueadas em multiplas jogatinas</li> <li>Ver finais opcionais</li> <li>Colocar c\u00f3digos para deixar o jogo mais dificil (Passwords e senhas)</li> </ul> <p>Estes s\u00e3o os criadores do jogo esperando que voc\u00ea goste de seu jogo o suficiente para continuar voltando para mais, mesmo depois que esses cr\u00e9ditos terminarem. Eles est\u00e3o tentando recompensar o jogador por completar seu jogo e criar alguma forma de satisfazer uma segunda jogatina. Se os criadores do jogo tem problemas de fazer essas coisas como parte integral do jogo, nos como desenvolvedores de conquistas devemos reconhecer esses desafios e criar conquistas apropriadas para pelo menos alguns deles.</p> <p>Chrono Trigger, Chrono Cross, and Star Ocean: The Second Story s\u00e3o famosos por isso. De fato, muitos jogos fazem isso. Se voc\u00ea n\u00e3o tem certeza se o seu jogo tem modos extras ou desafios, tenha certeza de fazer alguma pesquisa e chegar alguns FAQs. Ou perguntar na nossa comunidade, muitos de n\u00f3s somos experts nos jogos que s\u00e3o suportados aqui.</p>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-de-sidequestsopcionais","title":"Pr\u00f3s e Contras de Sidequests/Opcionais","text":"<p>Conquistas de Sidequests/Opcional fazem complementos fant\u00e1sticos para Conquistas de Progresso.</p>"},{"location":"Achievement-Design-pt_BR/#pros_1","title":"Pr\u00f3s","text":"<ul> <li>Isto \u00e9 uma m\u00e3o-na-roda de fazer conquistas. As chances s\u00e3o, uma boa parte das conquistas que voc\u00ea ir\u00e1 fazer ser\u00e3o desta categoria. Todos os jogos tem coisas opcionais para se fazer. Como coletar todas as moedas em uma fase! Ganhar 9 vidas! Criar conquistas com esse tipo de conte\u00fado \u00e9 facil, e recompensar o jogar pela sua dedica\u00e7\u00e3o.</li> </ul> <ul> <li>Criadores de jogos amam jogadores apreciativos. Eles adoram quando os jogadores se incomodam em procurar fundo em seus jogos, apreciam seu trabalho duro, caso contr\u00e1rio, n\u00e3o ver\u00edamos coisas 'divertidas' escondidas em jogos como Easter Eggs, cenas bonus, etc. Se um criador de jogos recompensa os jogadores por fazer isso, por n\u00f3s n\u00e3o? Nos desenvolvedores devemos reconhecer que o jogador foi al\u00e9m.</li> </ul> <ul> <li>Os jogadores adoram contar aos seus amigos quando encontram algo incomum e fora do comum em um jogo. Neste site, eles podem mostrar aos seus amigos que eles realmente mataram o 'sapo amarelo' raramente visto no p\u00e2ntano, ou encontar o portal para a 'dimens\u00e3o misteriosa'. Se nos incluimos essas curiosidade em nossa lista de conquistas, n\u00f3s mostramos aos jogadores que estamos \"no conhecimento\" que cria confian\u00e7a de que podemos gui\u00e1-los competentemente atrav\u00e9s do jogo.</li> </ul> <ul> <li>Conquistas de Sidequests/Opcionais d\u00e3o aos jogadores algo para se esfor\u00e7ar por depois que eles zerarem o jogo.</li> </ul> <ul> <li>Esses tipos de conquistas podem frequentemente serem ganhados em qualquer tempo e n\u00e3o est\u00e3o em um cronograma programado. Jogadores sentem uma corrida extra de endorfinas quando aparece uma conquista que eles n\u00e3o esperavam, mas foi conquistada.</li> </ul> <ul> <li>Esses tipos de conquistas s\u00e3o geralmente faceis de fazer, segundo, apenas para conquistas de estilo de progresso</li> </ul>"},{"location":"Achievement-Design-pt_BR/#contras_1","title":"Contras","text":"<ul> <li>Alguns jogadores n\u00e3o se importam em explorar al\u00e9m de uma jogatina t\u00edpica do que ofecere, ent\u00e3o uma alta porcentagem desses tipos de conquistas em um jogo pode deixar o jogador abaixo da recompensa. (Este tipo de jogador \u00e9 um pouco raro em um site concentrado em conquistas.)</li> </ul> <ul> <li>Algumas pessoas podem sentir um desafio espec\u00edfico muito dif\u00edcil, mesmo se \u00e9 algo que os desenvolvedores do jogo original incluiram no jogo para os jogadores conseguirem.</li> </ul> <ul> <li>Quando voc\u00ea cria uma conquista de Sidequest/Opcional para, digamos, fugir de 999 batalhas (ou outras conquistas de maximizar o status), voc\u00ea corre o risco de que as pessoas neste site n\u00e3o sintam que essa conquista em particular ofere\u00e7a um desafio e \u00e9 apenas um grind (grind \u00e9 quando se h\u00e1 repeti\u00e7\u00e3o de uma parte para se ganhar experi\u00eancia). Conquistas como essas podem muito bem acabar sendo envias para o \"N\u00e3o-oficial\", a menos que sirvam a um segundo prop\u00f3sito como em Final Fantasy V quando correr de batalhas pode melhor uma arma chamada 'Chicken Knife'. Isto tem SINERGIA com o jogo, ao contr\u00e1rio de criar uma conquista baseada no aumento de n\u00edvel que n\u00e3o tem utilidade.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#conquistas-baseadas-em-coletas","title":"Conquistas baseadas em coletas","text":"<p>A maioria das conquistas baseadas em coleta s\u00e3o opcionais, a menos que os itens em si sejam MacGuffins, que, nesse caso, cairiam diretamente em Progress\u00e3o / Cole\u00e7\u00e3o.</p> <p>Exemplos:</p> <ul> <li>Encontrar os chap\u00e9us de Mickey escondidos no cen\u00e1rio para obter 1 vida em Aladdin (Mega Drive).</li> <li>Encontrar itens excepcionalmente bem escondidos</li> <li>Besti\u00e1rios.</li> <li>Desbloquear um personagem opcional.</li> <li>Maximizar dinheiro / kills / status.</li> <li>Encontrar todas as maneiras diferentes de morrer em jogos como Prince of Persia ou Shadowgate.</li> <li>Abrindo todos os ba\u00fas do tesouro em um jogo / encontrando cada powerup.</li> <li>Todos os itens / Coletando 99 ou 255 (etc.) de um item.</li> <li>Capturando todos os Pokemon (qualquer cole\u00e7\u00e3o de monstros, na verdade.)</li> </ul> <p>Se o jogo acompanhar uma estat\u00edstica, o desenvolvedor do jogo est\u00e1 praticamente desafiando voc\u00ea a maximiz\u00e1-lo. Agora, voc\u00ea pode ser esse tipo de jogador, e voc\u00ea pode n\u00e3o ser. Voc\u00ea tem que perguntar a si mesmo, como um desenvolvedor, se os outros jogadores provavelmente obter\u00e3o 9999 mortes de um inimigo, mesmo que voc\u00ea n\u00e3o o fa\u00e7a. As vantagens disso s\u00e3o que as pessoas que normalmente n\u00e3o fazem isso sempre t\u00eam algo para voltar e trabalhar quando sentem vontade de jogar novamente. A desvantagem \u00e9 que outros jogadores que normalmente n\u00e3o ir\u00e3o t\u00e3o longe e talvez n\u00e3o o fa\u00e7a, mas tamb\u00e9m sentem que precisam PLATINAR rapidamente todos os jogos (raros de encontrar), v\u00e3o reclamar. Se voc\u00ea receber reclama\u00e7\u00f5es suficientes, voc\u00ea pode querer reduzir 9999 algo mais razo\u00e1vel, como 500. Se ningu\u00e9m est\u00e1 se divertindo com uma conquista, n\u00e3o \u00e9 no esp\u00edrito de jogar ou fazer uma conquista.</p> <p>Voc\u00ea tem que usar seu melhor julgamento aqui e pensar no que o jogador mais gosta. Como regra geral, \u00e9 melhor ter algumas conquistas paralelos / opcionais do que nenhuma. Mas com um pouco de esfor\u00e7o extra, essas conquistas podem tornar sua lista muito memor\u00e1vel.</p> <p>Em seguida, \u00e9 hora de arrega\u00e7ar as mangas como desenvolvedores e ser REALMENTE criativos quando os pr\u00f3prios desenvolvedores desafiam o jogador al\u00e9m das regras do jogo.</p>"},{"location":"Achievement-Design-pt_BR/#conquistas-divertidas","title":"Conquistas divertidas","text":"<p>Este tipo de conquistas geralmente vale apenas alguns pontos, mas eles ainda s\u00e3o divertidos</p> <p>Exemplos de divers\u00e3o:</p> <ul> <li>Deixando o rel\u00f3gio marcar 99:59 em Valkyrie Profile.</li> <li>Fundos interativos, como cutucar o cad\u00e1ver pendurado no est\u00e1gio 1 de Castlevania: Bloodlines.</li> <li>Cozinhando o hamster no microondas em Maniac Mansion.</li> <li>Assistindo o apocalipse em Majora's Mask.</li> <li>Encontrando John Romero em Doom 2.</li> <li>\u00c0s vezes, criadores de jogos adicionam easter eggs (segredos) divertidos. Para entreter o jogador com 'e se isso estivesse ali?'. Mais uma vez, \u00e9 nosso trabalho, como desenvolvedores, reconhec\u00ea-los e apoi\u00e1-los o m\u00e1ximo que pudermos.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#desafios","title":"Desafios","text":"<p>Uma coisa que voc\u00ea deve lembrar sobre os jogadores retr\u00f4 - e os jogos que eles jogam - \u00e9 que a maioria de n\u00f3s j\u00e1 jogou esses jogos um milh\u00e3o de vezes antes. Esta \u00e9 a mesma velha m\u00fasica e dan\u00e7a para a maioria de n\u00f3s, e muitas vezes precisamos de motiva\u00e7\u00e3o para faz\u00ea-lo novamente. Alguns de n\u00f3s podem terminar o Contra sem perder uma \u00fanica vida. Bem, agora \u00e9 a nossa chance de provar isso!</p> <p>Quero dizer, pense nisso: antes deste site, a \u00fanica maneira de provar que voc\u00ea pode fazer uma corrida impec\u00e1vel de Contra era convidar um amigo, sentar e mostrar a ele, ou descobrir software de grava\u00e7\u00e3o e fazer um v\u00eddeo no YouTube. Mas mesmo assim, muitos desses v\u00eddeos s\u00e3o manipulados para se parecer com jogos perfeitos. Este site, no entanto, tem o modo Hardcore, que ajuda a indicar que ningu\u00e9m est\u00e1 trapaceando.</p> <p>Voc\u00ea pode ter Conquistas progressivas e Sidequest / Conquistas Opcionais, mas se voc\u00ea quiser criar uma lista de conquistas que seja realmente \u00f3tima, voc\u00ea precisa de pelo menos algumas Conquistas de Desafio. Tente pensar em todos os jogos que voc\u00ea jogou aqui neste site. Quais s\u00e3o algumas das realiza\u00e7\u00f5es mais memor\u00e1veis? Eu quase posso garantir que eles eram Conquistas de Desafio. Existem exce\u00e7\u00f5es \u00e0 regra, \u00e9 claro, mas o jogador t\u00edpico n\u00e3o vai se lembrar com carinho, Concluir a fase 2-6', ou 'Chegar ao nivel 30'. Eles s\u00e3o mais propensos a se lembrar com carinho de realiza\u00e7\u00f5es que fizeram de seus jogatinas uma experi\u00eancia \u00fanica, como ...</p> <ul> <li>passar o jogo inteiro sem nunca pegar um powerup ou moeda</li> <li>derrotar um chefe sem ser atingido</li> <li>terminar um est\u00e1gio sem perder uma vida</li> </ul> <p>Isso \u00e9 o que torna este site t\u00e3o especial, e o que faz das conquistas algo mais do que apenas vencer um jogo.</p> <p>Mesmo os cr\u00edticos mais contundentes que odeiam a id\u00e9ia de realiza\u00e7\u00f5es podem dizer: \"Bem, exceto por este. Esse foi bom\". E eu garanto que UM exemplo de que eles est\u00e3o falando \u00e9 uma conquista de desafio, algo que desafiou o jogador al\u00e9m do pr\u00f3prio jogo.</p> <p>Um bom desenvolvedor de realiza\u00e7\u00f5es manter\u00e1 seus olhos abertos, sua intelig\u00eancia sobre eles e seus sentidos afiados ao desenvolver um jogo, procurando por desafios bons e incomuns. Eles podem perceber algo no jogo que \u00e9 um feito dif\u00edcil.</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-speedrun","title":"Desafios de Speedrun","text":"<p>Os timers apresentam uma press\u00e3o adicional que os jogadores podem nunca ter sentido antes enquanto jogam seus jogos favoritos. Poucas coisas fazem o cora\u00e7\u00e3o bombear mais do que um rel\u00f3gio imponente. Adicione um elemento de temporizador, e um jogo que anteriormente era t\u00e3o f\u00e1cil que eles poderiam venc\u00ea-lo de olhos vendados poderia de repente ser transformado no maior desafio de jogo de suas vidas.</p> <p>Exemplos de desafios do Speedrun:</p> <ul> <li>Concluindo um jogo em menos de uma hora.</li> <li>Limpando um est\u00e1gio espec\u00edfico em menos de tr\u00eas minutos.</li> <li>Passe o temporizador em um certo n\u00famero de segundos.</li> <li>Mate 30 morcegos durante a sequ\u00eancia de fuga.</li> <li>Colete 99 moedas b\u00f4nus antes que a tela b\u00f4nus desapare\u00e7a.</li> <li>V\u00e1 do ponto A ao ponto B antes que o dia mude para a noite.</li> <li>Leaderboard - Complete o jogo com o menor tempo poss\u00edvel.</li> <li>Leaderboard - Complete um determinado est\u00e1gio com o menor tempo poss\u00edvel.</li> </ul> <p>Um desenvolvedor pode querer ir ao YouTube ou Twitch e ver o qu\u00e3o r\u00e1pido as pessoas est\u00e3o terminando um jogo (E, por favor, ignore o TAS - \"Tool Assisted Speedruns\"). Alguns corredores profissionais de velocidade s\u00e3o t\u00e3o r\u00e1pidos que o jogador t\u00edpico n\u00e3o ter\u00e1 a menor chance de competir, mas voc\u00ea deve ser capaz de encontrar um ponto m\u00e9dio entre o melhor tempo dele e o seu. E se voc\u00ea n\u00e3o consegue descobrir um bom momento para desafiar os jogadores aqui, \u00e9 para isso que os Leaderboards s\u00e3o - Transforme isso em uma competi\u00e7\u00e3o! Na verdade, alguns de seus favoritos speed-runners podem vir a este site e colocar seus tempos.</p> <p>Voc\u00ea saber\u00e1 quando voc\u00ea est\u00e1 enfrentando uma conquista de press\u00e3o quando as palmas das m\u00e3os est\u00e3o suando e voc\u00ea se v\u00ea nervosamente olhando para o cron\u00f4metro. Como eu disse antes, nada grita: \"Aten\u00e7\u00e3o!\" mais alto que um cron\u00f4metro, especialmente quando os desenvolvedores come\u00e7am a tecer esse tipo de conquista com OUTROS tipos de conquistas (e at\u00e9 placares de l\u00edderes) durante uma parte cronometrada de um jogo. Os Desafios Temporizadores t\u00eam uma quantidade insana de sinergia com outros tipos de conquistas.</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-limitacao","title":"Desafios de Limita\u00e7\u00e3o","text":"<p>Exemplos de Desafios de Limita\u00e7\u00e3o:</p> <ul> <li>Limpar uma batalha ou at\u00e9 mesmo um jogo inteiro com todos os personagens de uma classe espec\u00edfica. (Um exemplo famoso disso \u00e9 terminar o Final Fantasy original com um grupo de White Mages.)</li> <li>Derrote um chefe final sem equipamento.</li> <li>Conclua um est\u00e1gio sem nunca saltar.</li> <li>Resolva um quebra-cabe\u00e7a em apenas dois movimentos.</li> <li>One-hit KOs.</li> <li>Jogos de baixo n\u00edvel (LLGs).</li> <li>Nenhuma conquista de sucesso.</li> <li>Nunca aperte em determinado bot\u00e3o durante um desafio.</li> <li>Nunca perca a invencibilidade atrav\u00e9s de uma etapa inteira do Mario 3 encontrando estrelas suficientes.</li> <li>Derrote um certo inimigo sem usar um certo movimento.</li> <li>Alcan\u00e7ando Ganon em Legend of Zelda, sem espada.</li> <li>Derrote um certo inimigo SOMENTE usando um certo movimento.</li> <li>Trope\u00e7ar no caminho atrav\u00e9s de um labirinto, enquanto b\u00eabado / confuso.</li> <li>Limpe o jogo com uma doen\u00e7a no status.</li> </ul> <p>Os sites da comunidade constru\u00eddos em torno de determinados jogos s\u00e3o um recurso fant\u00e1stico para esses tipos de realiza\u00e7\u00f5es. Eles ter\u00e3o uma boa id\u00e9ia sobre o que \u00e9 poss\u00edvel e imposs\u00edvel, e provavelmente escreveram perguntas frequentes discutindo maneiras alternativas e desafiadoras de jogar o jogo inteiro.</p> <p>Muitas vezes, por\u00e9m, n\u00e3o haver\u00e1 comunidade. N\u00e3o h\u00e1 perguntas frequentes. Nenhum quadro de mensagens. E talvez nem v\u00eddeos \u00fateis. Nesses casos, voc\u00ea precisar\u00e1 ser uma pessoa de ideias para criar maneiras novas e interessantes de desafiar o jogador. Esteja ciente de que esse tipo de conquista requer muita pr\u00e1tica, tempo e experi\u00eancia para criar.</p> <p>O jeito aqui \u00e9 ser criativo! E lembre-se de mant\u00ea-lo divertido!</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-pontuacao","title":"Desafios de pontua\u00e7\u00e3o","text":"<p>Exemplos de desafios de pontua\u00e7\u00e3o:</p> <ul> <li>Completando um jogo ou n\u00edvel com a menor pontua\u00e7\u00e3o poss\u00edvel.</li> <li>Complete um minigame com uma pontua\u00e7\u00e3o perfeita (n\u00e3o apenas no topo do ranking da CPU).</li> <li>Leaderboard - Complete o jogo com a maior pontua\u00e7\u00e3o / mais dinheiro / melhor contagem de mortes / etc. poss\u00edvel.</li> <li>Leaderboard - Complete um estagio com a maior pontua\u00e7\u00e3o / mais dinheiro / melhor contagem de mortes / etc. poss\u00edvel.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-dos-desafios","title":"Pr\u00f3s e Contras dos desafios","text":"<p>As conquistas de desafio s\u00e3o a sua chance de mostrar aos jogadores como jogar seus jogos favoritos de maneiras diferentes, \u00fanicas e at\u00e9 alucinantes. Embora essas conquistas possam dar vida a um conjunto de realiza\u00e7\u00f5es que, de outra forma, \u00e9 mon\u00f3tono, voc\u00ea geralmente quer que apenas um pequeno grupo delas esteja na sua lista final.</p> <p>Pr\u00f3s</p> <ul> <li>Jogadores hardcore amam deixar suas marcas nesses tipos de conquistas.</li> </ul> <ul> <li>Se alguns jogadores s\u00e3o muito hardcore, voc\u00ea pode encontrar um meio feliz implementando o Leaderboards, que satisfaz tanto os ca\u00e7adores de conquistas ocasionais quanto os jogadores hardcore de uma s\u00f3 vez.</li> </ul> <ul> <li>Esta \u00e9 a sua chance de ser muito criativo e criar novos desafios para jogadores que eles nunca esperaram. Isso pode ser uma surpresa agrad\u00e1vel e realmente tornar suas listas memor\u00e1veis.</li> </ul> <p>Contras</p> <ul> <li>Esses tipos de realiza\u00e7\u00f5es exigem uma boa quantidade de criatividade, embora haja muitas maneiras de pesquisar, maneiras incomuns de jogar, observando coisas como corridas de velocidade.</li> </ul> <ul> <li>Pode exigir uma pesquisa profunda.</li> </ul> <ul> <li>Estes podem ser notoriamente dif\u00edceis de codificar. Eles exigem que voc\u00ea fa\u00e7a muitas anota\u00e7\u00f5es de c\u00f3digo, fa\u00e7a toneladas de observa\u00e7\u00f5es mec\u00e2nicas do jogo e, muitas vezes, eles exigem testes de erros antes mesmo de funcionar. Na verdade, voc\u00ea pode nem estar pronto para enfrentar conquistas como essa at\u00e9 ter alguns jogos em seu curr\u00edculo com um conjunto de conquistas b\u00e1sicas. Felizmente, as Conquistas do Desafio sempre podem ser adicionadas mais tarde.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#fontes-externas","title":"Fontes externas","text":"<ul> <li>Best practices achievement creation guide escrito por Jeff Sullivan, gerente de contas de desenvolvedor do XNA Developer Connection (XDC) sobre Conquistas do XBox 360. <code>texto em ingl\u00eas</code></li> <li>Make them Work for it , um guia de design de conquistas escrito por Darran Jamieson em 1\u00ba de janeiro de 2013. <code>texto em ingl\u00eas</code></li> <li>The Achievement Machine: Understanding Xbox 360 Achievements in Gaming Practices - por Mikael Jakobsson <code>texto em ingl\u00eas</code></li> </ul>"},{"location":"Achievement-Design-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-25 12:10] meleu:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-04-01 00:18] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-31 15:03] meleu:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 22:15] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 22:08] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 21:25] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 21:16] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 20:59] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 18:50] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 18:47] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Design/","title":"Achievement Design","text":"<p>This is a guide on how to think about and design good achievements. Not the technical side, but the conceptual.</p>"},{"location":"Achievement-Design/#progression-based-achievements","title":"Progression Based Achievements","text":"<p>There are 3 types of progression-based achievements: simple progression, story-based progression, and progression/collection achievements.</p>"},{"location":"Achievement-Design/#simple-progression","title":"Simple Progression","text":"<p>Progression-based achievements are usually simplest ones, especially if the game you are doing is nothing but linear stages. Or doesn't have much going on in the way of storylines. In this case, let's look at some GOOD and BAD examples of this:</p> <ul> <li>Good: Clear stage 1. </li> <li>Bad: Reach stage 2. </li> </ul> <p>It takes slightly more work to code an achievement where the player is required to clear the stage rather than simply reach the next one. But it is also much more satisfying for the player, and it is much more professional-looking. It is also less susceptible to problems with players loading save games or save states for freebie achievements en masse. </p> <ul> <li>Good: Complete the game. </li> <li>Bad: Start the game. </li> </ul> <p>While it is true progression-based achievements are often freebies, it is generally agreed upon here that an achievement to start the game is a bit too easy, and not at all memorable for the player. It's just a formality. The ending of the game, however, is often the most memorable part of a game for a player, and completing a game is definitely an achievement in itself. It's a good practice to make such achievement work like \"Beat last stage and beat the game\".</p> <ul> <li>Good: Cleared the ice theme stages, or Cleared the first five stages, or Cleared the first ten stages. </li> <li>Bad: Complete Stage 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (all separate achievements) </li> </ul> <p>One of the worst things you can do is create achievement spam. Puzzle games are notorious for these kinds of problems, because the stages are short and often, there are one-hundred of them or more. As a result, the main page feed ends up with a lot of micro-updates, which spams other folks' achievements down and off the front page quickly. The way to come off as more professional in this matter is to space out the achievements a bit more, into groups of stages. For instance, if stages 1-10 are all fire themed, and stages 11-20 are all outer-space themed, you can create achievements around these themes. Be creative. </p>"},{"location":"Achievement-Design/#story-based-progression","title":"Story Based Progression:","text":"<p>The most memorable moments in gaming history are often not related to item collection or sidequests, but to specific scenes relating to the story. </p> <p>Examples:</p> <ul> <li>First encounter with Pyramid Head in the Silent Hill series. </li> <li>Finding out the truth about Darth Revan in Knights of the Old Republic. </li> <li>Finding out what will happen in the future in Chrono Trigger. </li> <li>Launching the Cow in Earthworm Jim. </li> <li>Pretty much any character death. </li> </ul> <p>The thing you have to be extra-careful with here is spoilers. If you catch a progression-based achievement that has a spoiler in it, by all means contact the dev about it. And devs, please be receptive when it comes to constructive criticism! Also, the number and even percentage of these will vary from game to game--The dependence lies heavily upon how story-driven the game is. </p>"},{"location":"Achievement-Design/#progressioncollection","title":"Progression/Collection","text":"<p>Progression/Collection is a common hybrid. Not only are you collecting an item, but it also launches into a memorable (and mandatory) scene. </p> <p>Examples:</p> <ul> <li>Obtaining the Master Sword in Link to the Past, which lifts the curse in the Lost Woods. </li> <li>Finding the sword on the beach in Link's Awakening, which launches into the first scene where the wise owl speaks to you. </li> <li>Picking your starter Pokemon, which happens during a beginning scene, but is a 'rite of passage' for most gamers. </li> </ul> <p>Achievements in this hybrid category are often more satisfying because they are pulling double-duty. The player is not only obtaining an item, but watching a memorable scene and nabbing an achievement all at once. Quite the rush of endorphins! </p>"},{"location":"Achievement-Design/#progression-pros-and-cons","title":"Progression Pros and Cons","text":"<p>Progression Achievements are guaranteed to the player on a normal play-through. So why even have them? </p>"},{"location":"Achievement-Design/#pros","title":"Pros","text":"<ul> <li>A player deserves points for playing through a game! They do! Remember, a lot of folks are playing through these games for the very first time, and most games are quite hard to beat. Why shouldn't we reward players for a good ol' normal play-through? </li> </ul> <ul> <li>Periodic progression awards go a long way to encourage players to complete a game. </li> </ul> <ul> <li>Some players are more casual and don't intend to do much more than beat games on this website. Not everyone feels the need to Master every game in Hardcore mode. Many are perfectly happy grabbing whatever convenient side-achievements they can during a normal play-through, and there's nothing wrong with that. </li> </ul> <ul> <li>Some scenes are so memorable, they deserve achievements all their own! People who grew up with these games and love them look for these scenes in achievement lists, and it might just warm their heart when they see it was acknowledged. </li> </ul> <ul> <li>Progression Achievements help other people on the website gauge how far along a player is in a game, a bit like Rich Presence. We can drop a line to the player and say, \"Good luck!\" because we know the next section is pretty tricky. It encourages the community to interact. </li> </ul> <ul> <li>Order matters! Progression Achievements can tell us a lot about a play-through just by the order they occurred. If you pop that optional boss achievement and saved up a million dollars AFTER you've already done all the sidequests, that's much less impressive than if you manage to pull it off well before the mid-point of the game. In other words, Progression Achievements allow us to show-off a bit! We can show the world that we can beat that final boss before we've reached level 10, or that we can beat Expert mode on our first go before Easy and Normal. It can even reveal if we've used glitches or cheats to skip certain portions of the game. So, as you can see, Progression Achievements have great SYNERGY with other kinds of achievements.</li> </ul> <ul> <li>These kinds of achievements are the easiest to code and are generally error-free. </li> </ul>"},{"location":"Achievement-Design/#cons","title":"Cons","text":"<ul> <li>Too many Progression Achievements can over-saturate a game with 'freebies', and that's a Very Bad Thing. </li> </ul> <ul> <li>If your entire game has nothing but these kinds of achievements, it's just another boring run through the game for players. Reach stage 2, Reach stage 3, Reach stage 4, Complete the Game. This is a great 'base' for you to start adding achievements from the other categories, but don't leave your list at just Progression Achievements if you can help it. Otherwise you're just rewarding players full points for going through the motions like they've done a million times before. </li> </ul>"},{"location":"Achievement-Design/#sidequestoptional-achievements","title":"Sidequest/Optional Achievements","text":"<p>Vintage games, on their own, offer little-to-no incentive to beat a bonus mode, other than that it's something to do on a rainy day after you've beaten the game. Old games didn't have internet connectivity. And they had no social aspects other than 2-player mode, and maybe telling your friends at school that you beat something. But now, with RetroAchievements.org, we can display our vintage trophies (even though it requires us to redo what we've probably already done many years ago). These trophies are badges of honor. You can look at another member's Challenge Achievements and begin to understand how far they went, how skilled they are. Along with that comes respect from the other members. We socialize, we congratulate each other on a job well done. We feel like we belong, and we are in good company.</p>"},{"location":"Achievement-Design/#sidequests","title":"Sidequests","text":"<p>There are often things the player can do that are confined to the rules of the game, but aren't necessary to complete it. In other words, a challenge built into the game by the original game developers. Usually they are fun, or sometimes not so fun, but deserve an award because they require hard work and persistence to achieve. You have to walk a fine tightrope between if dedicated players are likely to do something, vs. if the goal is stupid. People will have differing views over this, so steel yourself.</p> <p>Often times, these types of achievements are even Easter Eggs or things the player never knew existed in their entire lives! Many players adore these types of achievements. I think it's because they learn something new about a game they grew up with, or feel like maybe they were the only ones who knew about a given secret and were excited to see it supported here. It's important for us developers to REALLY know a game inside-and-out before creating an achievement set.</p> <p>Examples of Sidequests:</p> <ul> <li>Delivering tails to the Tail Collector in Final Fantasy IV. </li> <li>Finding the owner of the Insignificant Item in Earthbound. </li> <li>Giving the Jerky to the King in Guardia Castle. </li> <li>Anju sidequest in Majora's Mask. </li> <li>Learning about Wrex's past in Mass Effect. </li> <li>Diplomat/VIP escort missions in Flashback: The Quest for Identity. </li> <li>Discovering a secret room. </li> </ul> <p>Sidequests are most often found in RPGs, but especially these days, sidequests are finding their way into just about every genre. Keep your eyes peeled - Even the unsuspecting platformer may have a sidequest or three. The Kirby series, for instance, has many hidden rooms and areas. Often times, sidequests end up awarding an item, which falls under a hybrid: Sidequest/Collection.</p>"},{"location":"Achievement-Design/#optional-achievements","title":"Optional Achievements","text":"<p>Examples of Optional Achievements:</p> <ul> <li>Optional bosses. </li> <li>Clearing a challenge dungeon (which is a hybrid of Sidequest). </li> <li>Completing Expert Mode (which is a hybrid of Progression). </li> <li>Completing a secret challenge level. </li> <li>Getting an exceptionally rare drop off of a monster. </li> <li>Clearing the game with an optional character. </li> <li>Getting a high score. </li> <li>Completing features only unlocked on a second playthrough. </li> <li>Game modes that are only unlocked on multiple playthroughs. </li> <li>Optional game endings. </li> <li>Codes you can enter during the title screen to make the game harder. </li> </ul> <p>This is the game makers hoping you'll like their game enough to keep coming back for more, even after those ending credits scroll by. They are trying to reward the player for completing their game, and create some form of satisfying re-playability. If the game makers went to the trouble making things like this an integral part of the game, we as achievement developers should recognize these challenges and create appropriate achievements for at least a few of them.</p> <p>Chrono Trigger, Chrono Cross, and Star Ocean: The Second Story are famous for this. The Game Boy Advance Castlevania entries also do this. In fact, many games do this. If you aren't sure if your game has any extra modes or challenges, be sure to do some research and check out some FAQs. Or ask the community here, many of us are experts on the games supported here. </p>"},{"location":"Achievement-Design/#sidequestoptional-pros-and-cons","title":"Sidequest/Optional Pros and Cons","text":"<p>Sidequest/Optional Achievements make fantastic supplements to Progression Achievements. </p>"},{"location":"Achievement-Design/#pros_1","title":"Pros","text":"<ul> <li>This is the bread-and-butter of achievement making. Chances are, a good deal of your achievements will come from this category. All games have optional things to do. Collect all the coins in a stage! Gain 9 lives! Creating achievements for this stuff is easy, and it rewards the player for their dedication. </li> </ul> <ul> <li>Game makers love appreciative players. They like it when players bother to dig deeper into their games, appreciating their hard work, otherwise we wouldn't see hidden 'fun' things in games like Easter Eggs, bonus scenes, etc. If game makers reward the players for doing it, why shouldn't we? Us devs should also recognize that the player has gone the extra mile.</li> </ul> <ul> <li>Game players love telling their friends when they find something unusual and off the beaten path in a game. With this site, they can show their friends that they did indeed slay the elusive 'yellow frog' rarely seen in the marsh, or found the warp to the 'mystery dimension'. If we include these curiosities in our achievement lists, we show the players that we are 'in the know', which builds confidence that we can competently guide them through the game. </li> </ul> <ul> <li>Sidequest/Optional Achievements give players something to strive for after they've beaten the game.</li> </ul> <ul> <li>These kinds of achievements can often be earned at any time and are not on a predictable schedule. Players feel an extra rush of endorphins when an achievement pops that they weren't expecting, but it was earned. </li> </ul> <ul> <li>These kinds of achievements are usually easy to code, second only to progression-style achievements. </li> </ul>"},{"location":"Achievement-Design/#cons_1","title":"Cons","text":"<ul> <li>Some players don't care to explore beyond what a typical play-through has to offer, so a high percentage of these types of achievements in a game can leave a player under-rewarded. (Granted, this type of gamer is a bit of a rare bird on a website centered around achievements.) </li> </ul> <ul> <li>Some people may feel a specific challenge is too hard, even if it's something the original game developers included in-game for players to achieve. </li> </ul> <ul> <li>When you create a Sidequest/Optional Achievement for, say, running away from 999 battles (or other stat-maxing achievements), you risk that the people on this website may not feel this particular achievement offers a challenge and is just a 'grind-fest'. Achievements like this may very well end up getting demoted unless they serve a second purpose, like in Final Fantasy V where running away from battles actually powers up a weapon called the 'Chicken Knife'. This has SYNERGY with the game, as opposed to creating an achievement based upon raising a stat that has no other use.</li> </ul>"},{"location":"Achievement-Design/#collection-based-achievements","title":"Collection Based Achievements","text":"<p>Most collection-based achievements are optional, unless the items themselves are MacGuffins, which in that case they would fall squarely under Progression/Collection.</p> <p>Examples:</p> <ul> <li>Finding the Mickey hats hidden in the background to obtain 1-ups in Genesis Aladdin. </li> <li>Finding exceptionally well-hidden items. </li> <li>Bestiaries. </li> <li>Unlocking an optional character. </li> <li>Maxing out Money/kills/stats. </li> <li>Finding all the different ways to die in games like Prince of Persia or Shadowgate. </li> <li>Opening every treasure chest in a game/finding every powerup. </li> <li>All items/Collecting 99 or 255 (etc.) of an item. </li> <li>Catching them all in Pokemon (any monster collection, really.) </li> </ul> <p>If the game keeps track of a stat, the game developer is practically daring you to max it out. Now you might be that kind of player, and you might not. You have to ask yourself, as a dev, whether or not other players are likely to get 9999 vampire bat kills, even if you wouldn't. The advantages to this are that people who wouldn't normally do this always have something to come back and work for when they feel like playing the game again. The disadvantage is that other players who wouldn't normally go that far and never would, but also feel like they have to MASTER every game quickly (a rare breed), will complain. If you get enough complaints, you might want to bring down that 9999 to something more reasonable, like 500. If no one's having fun with an achievement, it's not in the spirit of playing games or making achievements. </p> <p>You have to use your better judgment here and think of what the player would enjoy the most. As a rule of thumb, it's better to have a few Sidequest/Optional Achievements than none at all. But with a little extra effort, these achievements can make your list very memorable. </p> <p>Next, it's time to roll up our sleeves as devs and get REALLY creative when the devs themselves challenge the player beyond the rules of the game.</p>"},{"location":"Achievement-Design/#for-fun-achievements","title":"For-Fun achievements","text":"<p>This kind of achievements usually worths just a few points, but they are still fun</p> <p>Examples of For Fun:</p> <ul> <li>Letting the clock hit 99:59 in Valkyrie Profile. </li> <li>Interactive backgrounds, such as poking the hanging dead body in stage 1 of Castlevania: Bloodlines. </li> <li>Cooking the hamster in the microwave in Maniac Mansion. </li> <li>Watching the apocalypse in Majora's Mask. </li> <li>Finding John Romero in Doom 2. </li> </ul> <p>Sometimes, game makers add fun easter eggs. They went the extra mile to entertain the player with 'what if's'. Again, it is our job as devs to recognize and support these as much as we can.</p>"},{"location":"Achievement-Design/#challenges","title":"Challenges","text":"<p>One thing that you have to remember about retro gamers - and the games they play - is that most of us have played these games a million times before. This is the same old song and dance for most of us, and we often need motivation to do it again. Some of us can clear Contra without losing a single life. Well, now is our chance to prove it! </p> <p>I mean, think about it: Before this website, about the only way to prove you can do a flawless run of Contra was to invite a friend over, sit him down, and show him, or figure out recording software and make a YouTube video. But even then, a lot of those videos are doctored to look like flawless playthroughs. This site, however, has Hardcore mode, which help to indicate no one is cheating. </p> <p>You may have Progression Achievements and Sidequest/Optional Achievements, but if you want to create an achievement list that's truly great, you need at least a few Challenge Achievements. Try to think back to all the games you've played here at this website. What are some of the most memorable achievements? I can almost guarantee you that they were Challenge Achievements. There are exceptions to the rule, of course, but the typical player isn't going to fondly recall, 'Cleared Stage 2-6', or 'Reached Level 30'. They are more likely to fondly remember achievements that made their play-throughs a unique experience, such as...</p> <ul> <li>get through the entire game without ever picking up a powerup or coin</li> <li>defeat a boss without getting hit</li> <li>finish a stage without losing a life</li> </ul> <p>That is what makes this website so special, and what makes achievements something more than just beating a game. </p> <p>Even the most vocal critics who hate the idea of Achievements may say, \"Well, except for THIS one. This one was okay.\" And I guarantee you that ONE example they're talking about is a Challenge Achievement, something that challenged the player beyond the game itself. </p> <p>A good achievement developer will keep their eyes peeled, their wits about them, and their senses sharp when developing a game, looking for good, unusual challenges. They may notice something in the game that's a difficult feat.</p>"},{"location":"Achievement-Design/#speedrun-challenges","title":"Speedrun Challenges","text":"<p>Timers introduce an added pressure players may have never felt before while playing their favorite games. Few things get the heart pumping more than an imposing ticking clock. Add a timer element, and a game that was previously so easy they could beat it blindfolded could suddenly be transformed into the ultimate gaming challenge of their lives. </p> <p>Examples of Speedrun Challenges:</p> <ul> <li>Completing a game in under one hour. </li> <li>Clearing a specific stage in under three minutes. </li> <li>Undercut the timer by a certain number of seconds. </li> <li>Kill 30 vampire bats during the escape sequence. </li> <li>Collect 99 bonus coins before the bonus screen fades away. </li> <li>Go from point A to point B before day changes to night. </li> <li>Leaderboard - Complete the game with the fastest time possible. </li> <li>Leaderboard - Complete a given stage with the fastest time possible. </li> </ul> <p>A dev may want to head out to YouTube or Twitch and see how fast people are finishing a game (And please ignore TAS - \"Tool Assisted Speedruns\"). Some pro speed-runners are so fast, the typical player here won't stand a chance at the times being posted, but you should be able to find a happy medium. And if you can't figure out a good time to challenge the players here, that's what Leaderboards are for - Turn it into a competition! In fact, some of your favorite celebrity speed-runners may come to this very site and submit a time or two. </p> <p>You'll know when you're facing a pressure achievement when your palms are sweating and you find yourself nervously glancing at the timer. Like I said before, nothing screams, \"Wake up!\" louder than a timer, especially when developers start weaving this kind of achievement with OTHER kinds of achievements (and even leaderboards) during a timed portion of a game. Timer Challenges have an insane amount of synergy with other types of achievements. </p>"},{"location":"Achievement-Design/#limitation-challenges","title":"Limitation Challenges","text":"<p>Examples of Limitation Challenges:</p> <ul> <li>Clear a battle or even an entire game with all characters of a specific job class. (One famous example of this is clearing the original Final Fantasy with a group of White Mages.) </li> <li>Beat a final boss with no equipment on. </li> <li>Clear a stage without ever jumping. </li> <li>Solve a puzzle in only two moves. </li> <li>One-hit KOs. </li> <li>Low level games (LLGs). </li> <li>No hit achievements. </li> <li>Never hit certain button(s) during a challenge. </li> <li>Never lose invincibility through an entire Mario 3 stage by finding enough Starmen. </li> <li>Defeat a certain enemy without using a certain move. </li> <li>Reaching Ganon in Legend of Zelda, sword-less. </li> <li>Defeat a certain enemy ONLY using a certain move. </li> <li>Stumble your way through a maze while drunk/confused. </li> <li>Clear the game with a status ailment. </li> </ul> <p>Community websites built around certain games are a fantastic resource for these kinds of achievements They'll have a good idea about what's possible and impossible, and have likely written up FAQs discussing alternative and challenging ways to play the entire game. </p> <p>Often times, though, there will be no community. No FAQs. No Message Board. And maybe even no useful videos. In these cases, you'll need to be an idea person to come up with new and interesting ways to challenge the player. Be aware that these kinds of achievements take a lot of practice, time, and experience to create. </p> <p>The takeaway here is to BE CREATIVE! And remember to keep it FUN! </p>"},{"location":"Achievement-Design/#score-challenges","title":"Score Challenges","text":"<p>Examples of Score Challenges:</p> <ul> <li>Completing a game or level with the lowest possible score. </li> <li>Complete a minigame with a perfect score (not just topping the CPU leaderboard). </li> <li>Leaderboard - Complete the game with the highest score/most money/best kill count/etc. possible. </li> <li>Leaderboard - Complete a given stage with the highest score/most money/best kill count/etc. possible. </li> </ul>"},{"location":"Achievement-Design/#challenge-pros-and-cons","title":"Challenge Pros and Cons","text":"<p>Challenge Achievements are your chance to show players how to play their favorite games in different, unique, and even mind-bending ways. While these achievements can breathe life into an otherwise dull achievement set, you generally only want a small handful of these to be in your final list. </p>"},{"location":"Achievement-Design/#pros_2","title":"Pros","text":"<ul> <li>Hardcore players love sinking their teeth into these kinds of achievements. </li> </ul> <ul> <li>If some players are too hardcore, you can find a happy medium by implementing Leaderboards, which satisfies both the casual achievement hunters and the hardcore players all at once. </li> </ul> <ul> <li>This is your chance to be very creative and come up with new challenges for players they never expected. This can be a pleasant surprise and really make your lists memorable. </li> </ul>"},{"location":"Achievement-Design/#cons_2","title":"Cons","text":"<ul> <li>These types of achievements require a fair amount of creativity to dream up, though there are many ways to research unusual ways to play games by watching things like speed runs. </li> </ul> <ul> <li>May require a deep research. </li> </ul> <ul> <li>These can be notoriously difficult to code. They require you to make a lot of code notes, make tons of game mechanic observations, and often times they require bug testing before they even work. In fact, you may not even be ready to tackle achievements like this until you've had a few games under your belt with a set of baseline achievements. Fortunately, Challenge Achievements can always be added later. </li> </ul>"},{"location":"Achievement-Design/#external-resources","title":"External Resources","text":"<ul> <li>Best practices achievement creation guide written by Jeff Sullivan, Developer Account Manager of XNA Developer Connection (XDC) regarding XBox 360 Achievements.</li> <li>Make them Work for it an achievement design guide written by by Darran Jamieson on 1 Jan 2013.</li> <li>The Achievement Machine: Understanding Xbox 360 Achievements in Gaming Practices - by Mikael Jakobsson</li> </ul>"},{"location":"Achievement-Design/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-02 19:40] televandalist:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-05-08 16:36] meleu:</code> fixed some lists formatation</li> <li><code>[2018-02-01 17:29] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-30 23:04] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-28 18:50] meleu:</code> removed \"unique achievements\" section - it's the same thing as for-fun achievements</li> <li><code>[2018-01-28 14:57] meleu:</code> added one more link to an external resource and put them at the end of the doc</li> <li><code>[2018-01-28 11:42] meleu:</code> changed link to jeff sullivan article (better formatation)</li> <li><code>[2018-01-27 18:25] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-27 13:22] Kvon:</code> added two links to guilds</li> <li><code>[2018-01-27 13:12] meleu:</code> summing up the cirellio's posts</li> </ul>"},{"location":"Achievement-Development-Overview/","title":"Achievement Development Overview","text":""},{"location":"Achievement-Development-Overview/#intro","title":"Intro","text":"<p>Page is heavily WIP, but the goal is to dive deep into achievement creation. Will probably end up merging the \"Real Examples\" into this section somehow. Each flag, type, size, comparison, etc. will have its own page to show the various ways they can be used. Will also include several tips, case studies, etc. </p>"},{"location":"Achievement-Development-Overview/#basics","title":"Basics","text":"<p>- Adding Games to the Database     - Everything you ever wanted to know (but were too scared to ask) about hashes     - Patch Guide   - RAM digging     - Utilizing Game Genie, Game Shark, Codebreaker, Action Replay, etc. codes    - Code Notes     - Formatting conventions</p>"},{"location":"Achievement-Development-Overview/#achievement-editor","title":"Achievement Editor","text":"<p>There are several tools and options available to a developer. Knowing how to properly utilize them will improve the quality of your sets. These tools/options can be used in the Achievement Editor:</p> <p></p>"},{"location":"Achievement-Development-Overview/#flags","title":"Flags","text":"<ul> <li><code>PauseIf</code> Flag     - <code>PauseIf</code> with hit counts</li> </ul> <ul> <li><code>ResetIf</code> Flag     - <code>ResetIf</code> with hit counts</li> </ul> <ul> <li><code>ResetNextIf</code> Flag</li> </ul> <ul> <li><code>AddSource</code> Flag</li> </ul> <ul> <li><code>SubSource</code> Flag     - Checking for a negative result</li> </ul> <ul> <li><code>AddHits</code> and <code>SubHits</code> Flag</li> </ul> <ul> <li><code>AddAddress</code> Flag</li> </ul> <ul> <li><code>AndNext</code> and <code>OrNext</code> Flags</li> </ul> <ul> <li><code>Measured</code> and <code>MeasuredIf</code> Flags</li> </ul> <ul> <li><code>Trigger</code> Flag</li> </ul>"},{"location":"Achievement-Development-Overview/#types","title":"Types","text":"<p>- Mem   - Value   - Delta     - <code>Mem &gt; Delta</code> Comparisons   - Prior   - BCD   - Float</p>"},{"location":"Achievement-Development-Overview/#sizes","title":"Sizes","text":"<p>- bit0 - bit7   - 8-Bit   - 16-Bit   - 24-Bit   - 32-Bit   - Lower4 and Upper4   - 16-Bit BE   - 24-Bit BE   - 32-Bit BE   - BitCount   - Float   - MBF32</p>"},{"location":"Achievement-Development-Overview/#general-comparisons","title":"General Comparisons","text":"<p>- <code>=</code>   - <code>&lt;</code>   - <code>&lt;=</code>   - <code>&gt;</code>   - <code>&gt;=</code>   - <code>!=</code></p>"},{"location":"Achievement-Development-Overview/#flag-specific-comparisons","title":"Flag Specific Comparisons","text":"<p>- <code>*</code>   - <code>/</code>   - <code>&amp;</code></p>"},{"location":"Achievement-Development-Overview/#other-toolkit-features","title":"Other Toolkit Features","text":"<p>- Hit Counts     - Using with Reset If     - Using with Pause If   - Alt Groups</p>"},{"location":"Achievement-Development-Overview/#protections","title":"Protections","text":"<p>- Demo Protection     - Finding and testing demo addresses   - Save Protection     - Delta and Prior     - Using in-game timers     - Using event flags   - Password Protection   - Cheat Protection   - Multiplayer Protection   - Other     - Dipswitch     - BIOS (PlayStation and Saturn)</p>"},{"location":"Achievement-Development-Overview/#logic-tips-and-tricks","title":"Logic Tips and Tricks","text":"<p>- Checkpoints hits   - Pause Locks   - Using Hit Counts as a timer   - Using Delta Values and Hit Counts to Detect an Increment   - Circumvent the Problem of a Counter Incrementing Twice in the Same Frame     - <code>note: need to add something about how the toolkit still uses hex even if the value is in BCD</code>   - Various types of chains   - When to use Reset If or Pause If   - When to use Delta or Prior   - Using BitCount for collectables   - Using Add Source with <code>Mem / Mem</code> comparisons   - Creating a Timer with Reset If hits based on the speed of the game   - Using <code>bit0</code> to include or exclude odd-numbered values</p>"},{"location":"Achievement-Development-Overview/#lesser-known-features","title":"Lesser-Known Features","text":"<p>- Double-Clicking bitflags while in 8-bit view   - Right-Clicking addresses in the editor to jump to them in the Memory Inspector (also works with offsets to jump to the current address)   - Highlighting conditions and holding CTRL while clicking to change a field in multiple conditions at once</p>"},{"location":"Achievement-Development-Overview/#workflow-tips","title":"Workflow Tips","text":"<p>- Using Google Sheets and Notepad++   - Editing local file</p>"},{"location":"Achievement-Development-Overview/#things-to-avoid-and-why","title":"Things to Avoid and Why","text":"<p>- Redundant Reset Ifs   - Single-Condition achievements   - Text-Based addresses</p>"},{"location":"Achievement-Development-Overview/#see-also","title":"See Also","text":"<p>- Point Distribution   - Badge Creation   - Rich Presence   - Leaderboards   - RATools   - Making Tutorial Videos   - Syntax Table</p>"},{"location":"Achievement-Development-Overview/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-02 20:08] televandalist:</code> Updated Achievement Development Tutorials (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features-es/","title":"Intro","text":"<p>Estas son algunas severas herramientas y opciones disponibles para el desarrollador. Saber como utilizarlas apropiadamente mejorara la calidad en tus sets. Estas herramientas/opciones pueden ser utilizadas en el Editor de Logros (Achievement Editor):</p> <p></p> <p>Para mas ayuda relacionada con esto, nuestro servidor de Discord esta siempre abierto para ayuda.</p> <p>Aqui hay una lista de funciones disponibles:</p> <ul> <li>Hit Counts (contador de golpes)</li> </ul> <ul> <li>Valores Delta</li> </ul> <ul> <li>Bandera <code>ResetIf</code>     - <code>ResetIf</code> con hit counts (contador de golpes)</li> </ul> <ul> <li>Bandera <code>PauseIf</code>     - <code>PauseIf</code> con hit counts (contador de golpes)</li> </ul> <ul> <li>Bandera  <code>AddSource</code></li> </ul> <ul> <li>Bandera <code>SubSource</code>     - Buscando un resultado negativo</li> </ul> <ul> <li>Bandera <code>AddHits</code></li> </ul> <ul> <li>Combinando Banderas</li> </ul> <ul> <li>Alt Groups (Grupos Alternos)</li> </ul> <ul> <li>Versiones Minimas para Funciones de Logica</li> </ul>"},{"location":"Achievement-Logic-Features-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:30] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Achievement Logic Features ES (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features-pt_BR/","title":"Recursos de l\u00f3gica para achievements","text":"<p>Link para o texto em ingl\u00eas: Achievement Logic Features</p> <p>Existem v\u00e1rias ferramentas e op\u00e7\u00f5es dispon\u00edveis para o desenvolvedor, saber como utiliz\u00e1-las adequadamente melhorar\u00e1 a qualidade de seus sets. Essas ferramentas/op\u00e7\u00f5es podem ser usadas no Achievement Editor:</p> <p></p> <p>Para ajuda sobre esses, o nosso servidor do Discord estar\u00e1 sempre aberto para ajudar.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#valores-delta","title":"Valores Delta","text":"<p>Um valor <code>Delta</code> \u00e9 o valor do frame anterior.</p> <p>Exemplos de como ele pode ser usado:</p> <ul> <li>Detectar se o n\u00edvel foi aumentado: <code>level &gt; delta level</code>. Significa que \"o n\u00edvel atual \u00e9 maior que o n\u00edvel do frame anterior\".</li> <li>Detectar danos: <code>health &lt; delta health</code>. Significa que \"a sa\u00fade atual \u00e9 menor do que a sa\u00fade do frame anterior\". Ou voc\u00ea pode apenas tornar o valor do frame anterior um requisito. <code>delta health = 1</code> significa que \"o valor do frame anterior para a sa\u00fade deve ser 1\". Voc\u00ea pode ver como isso funciona no Exemplos Reais</li> </ul>"},{"location":"Achievement-Logic-Features-pt_BR/#hit-counts","title":"Hit Counts","text":"<p>No Achievement Editor, o campo do lado direito \u00e9 Hit Count.</p> <p>Zero \u00e9 o valor padr\u00e3o. Isso significa que a condi\u00e7\u00e3o deve ser verdadeira quando a conquista aparecer.</p> <p>Se voc\u00ea definir manualmente uma contagem (hit), por exemplo 1, significa que a condi\u00e7\u00e3o deve ser verdadeira por pelo menos 1 frame e, uma vez que a contagem de hits seja atendida, ela n\u00e3o precisa ser atendida novamente em outro momento.</p> <p>ATEN\u00c7\u00c3O: se uma condi\u00e7\u00e3o tiver uma contagem de hits e atingir o n\u00famero necess\u00e1rio, esta condi\u00e7\u00e3o n\u00e3o \u00e9 mais testada. Ela \u00e9 verdadeira e permanece verdadeira, A MENOS que voc\u00ea tenha um <code>Reset If</code>, o qual discutiremos abaixo.</p> <p>Voc\u00ea pode ver como isso funciona no Exemplos Reais</p>"},{"location":"Achievement-Logic-Features-pt_BR/#special-flags","title":"Special Flags","text":"<p>No Achievement Editor, \u00e9 o campo intitulado como Special?.</p> <p>Essas flags condicionais s\u00f3 funcionam se voc\u00ea definir uma contagem de hits para uma condi\u00e7\u00e3o.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#pauseif","title":"<code>PauseIf</code>","text":"<p>Isso pausar\u00e1 a atividade para todas as condi\u00e7\u00f5es no mesmo grupo.</p> <p>Nota: tenha em mente que isso n\u00e3o ir\u00e1 pausar as condi\u00e7\u00f5es em outros grupos.</p> <p>O <code>PauseIf</code> \u00e9 usado para pausar a contagem de hits em uma situa\u00e7\u00e3o espec\u00edfica (como pausar o jogo). \u00c9 usado quando voc\u00ea deseja manter a contagem de hits previamente conquistada, mas n\u00e3o deseja reinici\u00e1-la quando algu\u00e9m simplesmente faz uma pausa no jogo, por exemplo.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#resetif","title":"<code>ResetIf</code>","text":"<p>Isso ir\u00e1 zerar a contagem de hits para todas condi\u00e7\u00f5es em que voc\u00ea definiu uma contagem de hits. Ele \u00e9 muito mais comum de usar do que <code>PauseIf</code></p> <p>Nota: Ao contr\u00e1rio do <code>PauseIf</code>, le ir\u00e1 zerar as condi\u00e7\u00f5es em todos os grupos</p> <p>Voc\u00ea pode ver como isso funciona no Real Examples</p>"},{"location":"Achievement-Logic-Features-pt_BR/#add-source","title":"<code>Add Source</code>","text":"<p>Quando uma condi\u00e7\u00e3o tem a flag <code>Add Source</code> o valor daquele endere\u00e7o de mem\u00f3ria \u00e9 adicionado ao valor do endere\u00e7o na condi\u00e7\u00e3o logo abaixo, e a compara\u00e7\u00e3o \u00e9 feita na condi\u00e7\u00e3o abaixo daquela com o <code>Add Source</code>. Isso pode soar um pouco confuso, mas o exemplo a seguir vai esclarecer como funciona:</p> <p></p> <p>Neste exemplo o valor em <code>0x8010</code> ser\u00e1 adicionado ao valor em <code>0x8020</code> e a compara\u00e7\u00e3o \u00e9 se esta soma \u00e9 maior ou igual a zero.</p> <p>Se o valor em <code>0x8010</code> \u00e9 <code>1</code> e o valor em <code>0x8020</code> \u00e9 <code>2</code>, a compara\u00e7\u00e3o ser\u00e1 <code>1 + 2 &gt; 0</code>, ou <code>3 &gt; 0</code>.</p> <p>Nota: todos os campos de compara\u00e7\u00e3o na condi\u00e7\u00e3o com a flag <code>Add Source</code> s\u00e3o ignorados.</p> <p>Tentando resumir esta explica\u00e7\u00e3o com uma imagem:</p> <p></p> <p>Nota: voc\u00ea pode usar <code>Add Source</code> para somar mais endere\u00e7os, como no exempo abaixo:</p> <p></p>"},{"location":"Achievement-Logic-Features-pt_BR/#sub-source","title":"<code>Sub Source</code>","text":"<p>Funciona muito semelhante ao <code>Add Source</code>, por\u00e9m o <code>Sub Source</code> faz o valor naquele endere\u00e7o de mem\u00f3ria ser negativo.</p> <p>Nota 1: <code>Sub Source</code> N\u00c3O \u00e9 um flag de subtra\u00e7\u00e3o. Ele apenas torna o valor negativo.</p> <p>Nota 2: A linha final (sem <code>Add Source</code> ou <code>Sub Source</code>) ainda \u00e9 adicionada para a compara\u00e7\u00e3o final.</p> <p>Usando aquele exemplo de uso de <code>Add Source</code> example, se n\u00f3s o substitu\u00edssemos por <code>Sub Source</code> e com os mesmos valores (<code>valor(0x8010) = 1</code> e <code>valor(0x8020) = 2</code>), a compara\u00e7\u00e3o seria <code>-1 + 2 &gt; 0</code>, or <code>1 &gt; 0</code>.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#add-hits","title":"<code>Add Hits</code>","text":"<p>Tamb\u00e9m funciona de maneira de similar ao <code>Add Source</code>, por\u00e9m relacionado aos hitcounts.</p> <p>O <code>Add Hits</code> adiciona o hitcount da condi\u00e7\u00e3o atual \u00e0 pr\u00f3xima condi\u00e7\u00e3o. O hitcount total a ser checado ser\u00e1 aquele definido na condi\u00e7\u00e3o logo ap\u00f3s a \u00faltima condi\u00e7\u00e3o com <code>Add Hits</code>. Se a condi\u00e7\u00e3o logo ap\u00f3s o \u00faltimo <code>Add Hits</code> n\u00e3o tiver um hitcount definido, todas as condi\u00e7\u00f5es com <code>Add Hits</code> ser\u00e3o ignoradas.</p> <p>Diferentemente do <code>Add Source</code>, todos os campos s\u00e3o usados numa condi\u00e7\u00e3o <code>Add Hits</code>, inclusive os campos de compara\u00e7\u00e3o. Se uma condi\u00e7\u00e3o \u00e9 verdadeira, o hitcount para esta condi\u00e7\u00e3o \u00e9 incrementada (e parar\u00e1 de incrementar se assim que o n\u00famero de hitcount definido for atingido).</p> <p>As condi\u00e7\u00f5es com <code>Add Hits</code> n\u00e3o precisam ser verdadeiras para a conquista disparar. Por\u00e9m primeira condi\u00e7\u00e3o ap\u00f3s o \u00faltimo <code>Add Hits</code>, sim, precisa ser verdadeira.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#groups","title":"Groups","text":"<p>Os achievements podem ter grupos adicionados a eles que podem atuar como requisitos alternativos para desbloquear um achievement. Estes s\u00e3o chamados de  Alt Groups.</p> <p>Uma coisa extremamente importante a notar: para uma conquista desbloquear, deve ter o Core group E pelo menos um Alt group ser verdadeiro. Se n\u00e3o houver nenhum grupo Alt presente, apenas as condi\u00e7\u00f5es do Core group's precisam ser verdadeiras.</p> <p>Dica: devido ao grupo Core sempre precisar ser verdadeiro, normalmente voc\u00ea colocaria l\u00e1 condi\u00e7\u00f5es que sejam \u00e0 todos os requisitos alternativos. No entanto, um truque que voc\u00ea pode usar para basicamente para ignorar a necessidade de um grupo Core \u00e9 dar-lhe uma condi\u00e7\u00e3o que \u00e9 sempre verdadeira, como:</p> <p><code>Mem 0x0001 = Mem 0x0001</code></p> <p>Como o grupo Core agora \u00e9 sempre verdadeiro, agora voc\u00ea pode se concentrar em diferenciar os grupos Alt.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-07-14 13:33] meleu:</code> melhorando explica\u00e7\u00f5es sobre AddSource/SubSource e afins</li> <li><code>[2018-07-14 13:17] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-28 19:57] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-28 19:56] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-25 11:46] KingDice001:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-23 01:17] meleu:</code> Updated Achievement Logic Features.pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features/","title":"Achievement Logic Features","text":"<p>There are several tools and options available to a developer. Knowing how to properly utilize them will improve the quality of your sets. These tools/options can be used in the Achievement Editor:</p> <p></p> <p>For more help regarding these, our Discord server is always open for assistance.</p> <p>Here is the list of features available:</p> <ul> <li>Hit Counts</li> </ul> <ul> <li>Delta Values</li> </ul> <ul> <li><code>ResetIf</code> Flag     - <code>ResetIf</code> with hit counts</li> </ul> <ul> <li><code>PauseIf</code> Flag     - <code>PauseIf</code> with hit counts</li> </ul> <ul> <li><code>AddSource</code> Flag</li> </ul> <ul> <li><code>SubSource</code> Flag     - Checking for a negative result</li> </ul> <ul> <li><code>AddHits</code> and <code>SubHits</code> Flag</li> </ul> <ul> <li>Combining Flags</li> </ul> <ul> <li>Alt Groups</li> </ul> <ul> <li>Minimum Required Versions for Logic Features</li> </ul>"},{"location":"Achievement-Scoring/","title":"Achievement Scoring","text":""},{"location":"Achievement-Scoring/#scoring","title":"Scoring","text":"<p>There is no set point cap. When scoring achievements match your scores to one of these 5 tiers.</p> Point Tiers Difficulty Significance (Level of Importance) 0-5 Easy Minor- Collecting a power-up- Beating a stage 10 Medium Intermediate- Beating a boss 25 Hard Major - Beating the Game 50 Very Hard Completion Level 100 \"Impossible\" Typically for Bonus Sets <p>There are other factors you should consider as well, such as achievement spread and game length.</p> <p>Scoring from set to set will never perfectly match up, but this scoring system allows the points earned to more closely match skill and effort.</p>"},{"location":"Achievement-Scoring/#factors-to-consider-while-scoring-achievements","title":"Factors to Consider While Scoring Achievements","text":""},{"location":"Achievement-Scoring/#difficulty","title":"Difficulty","text":"<p>Consider for the whole set:</p> <ul> <li>What percent of players earned the achievement?</li> <li>How hard were the achievements for you?</li> <li>What is the current score compared to others achievements?</li> <li>How much time, effort and practice does it take to learn the necessary skills to complete the achievement, game and entire set?</li> </ul>"},{"location":"Achievement-Scoring/#achievement-spread","title":"Achievement Spread","text":"<p>Imagine you had two versions of the same set, with the same difficulty:</p> <ul> <li>If the set has many similar achievements they should each be scored lower.</li> <li>If it has few they should be scored higher.</li> </ul>"},{"location":"Achievement-Scoring/#game-length","title":"Game Length","text":"<ul> <li>For long games achievements should be scored somewhat higher than short games.</li> <li>RPGs are often much longer than other genres. Game length should be a factor in scoring but is lesser than the other three.</li> <li>Examples.</li> </ul>"},{"location":"Achievement-Scoring/#rescoring","title":"Rescoring","text":"<p>Up until June 2019, RetroAchievements had a 400-point cap per set, with no restrictions on individual achievements. The set cap was removed to put less focus on set totals and more on the achievements themselves. This initiative was also meant to eliminate the misconception that a set worth 400 points is a \"complete\" set. </p> <p>As with revisions and aesthetic changes, a rescore typically requires community approval. You can find more information on rescores here.</p>"},{"location":"Achievement-Scoring/#exceptions","title":"Exceptions","text":"<p>Some games may come up as exceptions to the normal scoring tiers and will be listed here.</p> <ul> <li>Picross and Sudoku achievements fall under a special scoring category as follows based on difficulty:<ul> <li>Easy - 1 point,</li> <li>Medium - 2-3 points,</li> <li>Hard - 4-5 points</li> </ul> </li> <li>Picross 3D is an exception to this rule and is scored normally</li> <li>Further exceptions can be requested by Code Reviewers and/or Admins on a case by case basis</li> </ul>"},{"location":"Achievement-Scoring/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-29 22:14] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2023-06-02 19:21] televandalist:</code> Changed the point tiers to a table format. Got rid of the \"Significance\" section and put the info into the table.</li> <li><code>[2022-05-07 14:33] Searo:</code> Update Achievement Scoring with section noting exceptions such as picross and sudoku</li> <li><code>[2021-08-20 06:44] meleu:</code> fix markdown format (lists)</li> <li><code>[2020-03-23 06:37] televandalist:</code> Removed most info regarding rescores and redirected to the revision page.</li> <li><code>[2019-08-08 03:19] Kvon:</code> Achievement Scoring: typo</li> <li><code>[2019-08-08 03:18] Kvon:</code> Achievement Scoring: Added details for phase four of rescoring</li> <li><code>[2019-07-11 08:44] Kvon:</code> create page</li> </ul>"},{"location":"Achievement-Set-Requirements/","title":"Achievement Set Requirements","text":""},{"location":"Achievement-Set-Requirements/#every-achievement-set-must-have","title":"Every Achievement Set MUST Have","text":"<ul> <li>All game page information filled out, and game images uploaded (if you're not a full-dev, send the images to the code-reviewers).</li> <li>Game Badges for each achievement (they don't need to be distinct from each other, just don't leave them blank).</li> <li>Content covering up to completion so long as the game can be beaten. Whether it be defeating the final boss, completing a first loop, or completing all puzzles, achievement sets that do not cover at least beating the game are deemed unfinished and therefore subject to demotion. Arcade-style games where the focus is on high scores (such as Pac-Man and Crystal Castles) are exempt from this rule.<ul> <li>Regarding compilation games, such as Intellivision Classic Games (PlayStation), it is not required for every game in the compilation to have achievements. However, those that do have achievements must adhere to the above policy.</li> </ul> </li> <li>Progression and Win Conditions marked on applicable achievements. See Progression and Win Condition Typing for full guidelines</li> <li>Protection for situations where the players can get achievements without effort, such as:<ul> <li>Demo mode;</li> <li>In-game cheat codes;</li> <li>Battery saves;</li> <li>Passwords.</li> <li>See also: Achievement Templates and Real Examples for some well known protection techniques.</li> </ul> </li> </ul>"},{"location":"Achievement-Set-Requirements/#recommended-but-not-required","title":"Recommended but Not Required","text":"<ul> <li>Basic Rich Presence (only available for full-devs).</li> <li>Leaderboards for scores and time challenges.</li> <li>Adding the Missable Type to applicable achievements, especially for RPGs and long games.     - Avoid overuse. If most of an achievement set is marked as missable, the mark becomes meaningless for that set.     - Prior to the addition of Missable-Typing, the use of <code>[m]</code> in the end of achievement's title was the standard format to mark missables. Do Not mark missable achievements in this way. Use the achievement-type system instead.</li> <li>An achievement guide. Guides can be created and posted here. </li> <li>For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</li> </ul>"},{"location":"Achievement-Set-Requirements/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-06 08:48] The Mystical One:</code> Updated Achievement Set Requirements (markdown)</li> <li><code>[2024-02-06 08:47] The Mystical One:</code> Updated to clarify that [m] should no longer be used to mark missables.</li> <li><code>[2023-11-03 08:11] The Mystical One:</code> Adds requirement to mark progression and win conditions</li> <li><code>[2023-06-05 20:54] televandalist:</code> Added the note about compilation games</li> <li><code>[2023-06-03 02:16] televandalist:</code> Updated Achievement Set Requirements (markdown)</li> <li><code>[2023-06-02 20:27] televandalist:</code> Updated WIP Achievement Set Requirements (markdown)</li> </ul>"},{"location":"Achievement-Set-Revisions-es/","title":"Revisiones en Set de Logros","text":""},{"location":"Achievement-Set-Revisions-es/#revisiones-trabajando-con-sets-con-logros-existentes","title":"Revisiones -Trabajando con Sets con logros existentes","text":"<p>Revisiones, osea trabajar en un set el cual ya cuenta con logros existentes tipicamente requiere aprovacion por la comunidad, presentando tu plan en el foro y en el canal de #revision-voting channel en Discord. No todos los cambios requieren aprovacion.</p>"},{"location":"Achievement-Set-Revisions-es/#preparando-tu-plan","title":"Preparando tu plan","text":"<p>Cualquier desarrollador que quiera revisar un set necesita:</p> <ol> <li> <p>Preparar un plan para cada uno de los siguientes puntos (cuando tu no eres el autor original)     - Adicci\u00f3n     - Eliminaci\u00f3n     - Retrabajo de Logros     - Posibilidad de cambiar las tablas de clasificaci\u00f3n     - Actualizaci\u00f3n de rich presence</p> </li> <li> <p>Resuelve los tickets abiertos de todos los logros que quedan en el set.</p> </li> <li> <p>Presenta tu plan     - Tu plan completo en el foro del juego     - En #revision-voting publica un link al post del foro</p> </li> </ol>"},{"location":"Achievement-Set-Revisions-es/#obtener-aprobacion-de-la-comunidad","title":"Obtener aprobaci\u00f3n de la comunidad","text":"<p>Cualquiera en la comunidad puede expresar sus preocupaciones u objeciones. Permitiendo tiempo para discutirlo y para el desarrollador ajustar su plan si es que as\u00ed lo decide. Si cualquier queja u objeciones son expresadas, de acuerdo al desarrollador ajustando el plan, una votaci\u00f3n se tiene que llevar acabo.</p> <p>Una vez que la discusi\u00f3n se all\u00e1 terminado, la votaci\u00f3n tiene que ser publicada por un desarrollador en el canal de #revision-voting . </p> <p>La votaci\u00f3n es aprobada/rechazada despu\u00e9s de 72 horas. Si pasa/falla por la mayor\u00eda de la gente.</p>"},{"location":"Achievement-Set-Revisions-es/#cuando-haces-una-revision","title":"Cuando haces una revisi\u00f3n","text":"<ul> <li>No hagas copias de logros existentes, o clona y elimina copias existentes. Si hay problemas con logros actuales haz las correcciones a los que ya est\u00e1n creados.</li> </ul> <ul> <li>Si estas agregando un concepto similar a uno que ya se encuentra en el set y donde es posible re-utilizar el antiguo concepto y actualizarlo en vez de hacer uno nuevo, simplemente actualiza el antiguo.</li> </ul> <p>Esto previene que los jugadores necesiten innecesariamente volver a conseguir los logros, restringe cambios que no son necesarios a sets, y preserva una buena calidad de desarrollador en tu trabajo y en tus conceptos.</p>"},{"location":"Achievement-Set-Revisions-es/#despues-de-la-aprobacion","title":"Despu\u00e9s de la Aprobaci\u00f3n","text":"<p>Si producir la revisi\u00f3n esta tomando tiempo mucho mas largo, cada dos meses (+/- 2 semanas) haz un nuevo post en la pagina del juego explicando el progreso actual de la revisi\u00f3n. No hacer esto invalida tu revisi\u00f3n; el plan de revisi\u00f3n necesitar\u00eda volver a tener una nueva aprobaci\u00f3n.</p>"},{"location":"Achievement-Set-Revisions-es/#no-se-necesita-aprobacion","title":"No se necesita aprobaci\u00f3n","text":"<ul> <li>A\u00f1adir rich presence a un juego que no cuenta con una.</li> </ul> <ul> <li>Hacer cambios a un logro donde tu eres el autor original.</li> </ul> <ul> <li>Resolver tickets o bugs en logros hechos por otros desarrolladores que cuentan con 10 o mas tickets abiertos y llevan 2 o mas meses abiertos (puedes ver sus tickets abiertos de el Administrador de Tickets (Ticket Manager)). Este desarrollador se le considera como inactivo en sus tickets. En esos caso tu solo tienes el permiso de corregir que el logro haga lo que esta en su descripci\u00f3n; no cambies la intenci\u00f3n de logro sin antes pasar por el proceso de revisi\u00f3n de arriba. Si encuentras un problema con un logro que cuenta con un desarrollador activo ya sea puedes crear un ticket  o contactarlo para que te ayude en una soluci\u00f3n.</li> </ul> <ul> <li>A\u00f1adir protecci\u00f3n contra archivos de guardado, c\u00f3digos, o passwords a logros donde el desarrollador es inactivo. (percatate de testear apropiadamente tus cambios). Si es activo, puedes crear un ticket o contactarlo para que te ayude a aplicar las mejoras.</li> </ul> <ul> <li>Haciendo cambios a la informaci\u00f3n y screenshots de la pagina del juego (pero haz un respaldo de las im\u00e1genes previas en el foro del juego. De acuerdo al icono del juego, checa el proceso de Game Icon Gauntlet)</li> </ul> <ul> <li>Actualizando badges (ten en cuenta las reglas de aqu\u00ed)</li> </ul>"},{"location":"Achievement-Set-Revisions-es/#haciendo-cambios-a-iconostrofeos-de-juegos","title":"Haciendo cambios a iconos/trofeos de juegos","text":"<p>De acuerdo a la importancia en los iconos de juegos hacer cambios a estos son tomados por votaci\u00f3n de la comunidad. Mira Game Icon Gauntlet.</p>"},{"location":"Achievement-Set-Revisions-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 14:28] eldexterr:</code> Created Achievement Set Revisions es (markdown)</li> </ul>"},{"location":"Achievement-Set-Revisions/","title":"Achievement Set Revisions","text":""},{"location":"Achievement-Set-Revisions/#revision-types","title":"Revision Types","text":"<p>Any changes to a set with existing achievements is considered a revision. They typically happens after someone present a plan in the game's forum topic and in the <code>#revision-voting</code> channel on Discord and the plan is approved by the achievement creators community.</p> <p>There are three types of revisions:</p> <ul> <li>Standard Revisions - Changes to an achievement set that affect another developer's work. These include adding achievements, removing achievements, and reworking existing achievements, and adding progression and win condition types to achievements.</li> <li>Rescores - Changes to the point value of an achievement.</li> <li>Icon-Gauntlet - Changes to a game page's icon that is awarded upon mastering a set and changes to the individual achievement badges.</li> </ul> <p>Each are assigned their own Discord role:</p> Type Role Getting the role Who can get the role Standard Revisions <code>@revision-voting</code> React with \ud83d\uddf3\ufe0f here achievement creators Rescores <code>@rescore</code> React with \ud83d\udcaf here achievement creators Icon Gauntlet <code>@icon-gauntlet</code> React with \ud83c\udfa8 here any verified discord user"},{"location":"Achievement-Set-Revisions/#standard-revisions","title":"Standard Revisions","text":"<p>Any developer wanting to revise a set need to:</p> <ol> <li> <p>Prepare a plan for each (where you're not the original author)     - Addition     - Demotion     - Achievement rework</p> </li> <li> <p>Contact each active author of the set. They may have valuable insight or resources that you can utilize to help your revision. Wait for a response (after 72 hours have passed, you may proceed without a response).     - Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</p> </li> <li> <p>Post the plan in the game's forum topic. NOTE: Be as specific as possible, but if you have only a vague plan, provide a general idea of what you want to do and don't go too far from that idea.</p> </li> <li> <p>Start a vote by posting a link to that topic in <code>#revision-voting</code>. If you're not on Discord, another developer can do it for you. Whomever creates the vote must ping <code>@revision-voting</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</p> </li> <li> <p>Address concerns: Once a revision vote is posted, the developer can address any comments, concerns, and objections the community may have to the plan.</p> </li> <li> <p>The vote is approved/rejected after 24 hours and is pass/fail by simple majority.</p> </li> </ol> <p>Note: Anonymous revision proposals - If desired, a developer can choose to propose a revision plan while remaining anonymous throughout the voting process.  Simply contact a mod or admin to request that the plan be presented on your behalf.</p>"},{"location":"Achievement-Set-Revisions/#when-making-a-revision","title":"When Making a Revision","text":"<ul> <li>Making a revision should always be done with the goal of it being the final revision, with the set fully realized upon completion of the revision.</li> </ul> <ul> <li>Avoid making a revision claim on a set after releasing it 'just in case' you missed anything. Research the game thoroughly before release. Check online resources and consider reaching out to knowledgeable players who may know of hidden content.</li> </ul> <ul> <li>Making a revision in order to attain a higher rank on the mastery leaderboard is prohibited.</li> </ul> <ul> <li>Do not make copies of existing achievements and demote existing equivalent achievements. Doing this is a reauthor and requires permission of Developer Compliance. If there are issues with current achievements make fixes to the existing ones.</li> </ul> <ul> <li>Resolve any open tickets for achievements that will be kept in the set. Tickets for achievements that are being demoted can simply be closed with the demotion cited. In cases where the revision is simply the demotion of one or more achievements, the developer does not need to handle the tickets for other achievements in the set.</li> </ul> <ul> <li>If you are adding a similar concept to one found in the set, where possible reuse the old concept and update it rather than make a new one. This prevents players from having to unnecessarily re-earn achievements, restricts needless changes to sets, and preserves good quality developer work and concepts.</li> </ul> <ul> <li>Since revisions vary in the amount of adjusted content, they are treated the same as an achievement set reservation. If three months have passed since your revision plan was approved, you will need to provide an update that details the current progress. Not doing so will invalidate the revision and the plan will need to be approved again with a new vote.</li> </ul>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote","title":"No Need for Approval Vote","text":"<ul> <li>Making changes to an achievement or to an achievement set where you are the original author and no other developer has revised it; it is still a good idea to post the plan for your changes in the forum.</li> <li>Adding achievements where all revision authors are already authors on the set and all other active authors on the set agree.</li> <li>Resolving tickets or bugs on achievements made by developers who are listed as inactive in the list of developers. <ul> <li>Changing the description to clarify or correct it to match the logic that is already present does NOT require a revision vote</li> <li>Altering the achievement's objective in any way DOES require a revision vote as always. In these cases you're only allowed to fix the achievement to match the description; do not change the intention of the achievement without going through the revision process above. If you find a problem with an achievement that has an active developer either create a ticket or contact them to assist in resolution.</li> </ul> </li> <li>Adding battery save, cheat code, or password protections to achievements where the developer is inactive. (be sure to properly test your changes). If they are active, either create a ticket or contact them to assist applying the improvements.</li> <li>Fixing misspellings, grammatical errors, and other typos in the achievement names or descriptions. In some cases, these are intentional, so be sure to make note of it in the forum. </li> <li>Making updates to game page information and title / screenshot / box art images.</li> <li>Adding a standard \"beat the game\" achievement if one is missing and there are no active developers on the set. A standard \"beat the game\" achievement is an achievement for completing the game at its normal/default difficulty without additional requirements. Plan for adding the beat the game achievement must still be posted on the forum. If uncertain how to proceed, please contact DevCompliance</li> <li>Setting an achievement's type to Missable when it is otherwise indicated as missable in the title or description.<ul> <li>All other additions of a missable mark on a set with all inactive authors shall require a revision vote.</li> <li>The revising developer shall note the changes in the forum for the set.</li> </ul> </li> <li>Adding progression and win condition types to an inactive developer's set if the set is missing progression and win conditions<ul> <li>Make a post in the forum with the details of your change</li> <li>Any developer who changes the 'Type' of an achievement becomes responsible for the typing of that achievement and is treated as the author for purposes of type revision only.</li> </ul> </li> </ul>"},{"location":"Achievement-Set-Revisions/#not-allowed","title":"Not Allowed","text":"<ul> <li>Adding missable types to an active author's achievements without their permission. This rule shall be revisited if and when user-preference hiding of missable indicators is implemented. </li> </ul>"},{"location":"Achievement-Set-Revisions/#merging-sets","title":"Merging Sets","text":"<p>In the event that a revision includes merging two sets together (e.g. the Pokemon Red/Blue merge), the developer who does the revision needs to keep track of achievements in the demoted set and their equivalent achievements in the set it is being merged with. If the revision vote passes, this information must be sent to an admin so the achievements from the merged set can be manually awarded to the earners of the demoted set.</p>"},{"location":"Achievement-Set-Revisions/#respecting-revision-plans","title":"Respecting Revision Plans","text":"<p>If you are one of or the original set developer(s) for a set that is currently undergoing a revision, you must communicate with the developer carrying out the revision before making changes to the set. This is to prevent potential extra work for the revision, overlapping or redundant changes, etc. </p>"},{"location":"Achievement-Set-Revisions/#rescores","title":"Rescores","text":"<p>Up until June 2019, RetroAchievements sets had a cap of 400 points, with no restrictions on individual achievements. The set cap was removed to focus less on overall set totals and more on the achievements themselves. This initiative was also meant to eliminate the misconception that a set worth 400 points is a \"complete\" set, but is also an ongoing community effort to promote fairness across the board. Information on the scoring process can be found here.</p> <p>Anyone wanting to rescore a set needs to:</p> <ol> <li> <p>Prepare a rescore plan that shows the original scores and the proposed scores. A quick and easy way to do this is by utilizing this sheet; you can enter the Game ID in F2 to bring up a full list of that game's achievements and scores.</p> </li> <li> <p>Contact each active author of the set. They may have valuable insight into the chosen scores. You do not need to wait for a response.</p> </li> </ol> <ul> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul> <ol> <li> <p>Post the plan in the game's forum topic.</p> </li> <li> <p>Start a vote by posting a link to the topic in the <code>#revision-voting</code> channel on Discord. Whomever creates the vote must  ping <code>@rescore-voting</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</p> </li> <li> <p>Address concerns: Prepare to do some negotiating with other users and try to find a good middle-ground.</p> </li> <li> <p>Voting will be active for 24 hours. If a rescore passes, you can make the necessary changes.</p> </li> </ol>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote_1","title":"No Need for Approval Vote","text":"<p>Some achievement sets can be rescored without going through the voting process:</p> <ul> <li>If you are the only credited author of an achievement set being rescored and no other developer has rescored it. </li> </ul> <ul> <li>If a co-author you collaborated with on an achievement set gives you their blessing to do a rescore and no other developer has rescored it. </li> </ul>"},{"location":"Achievement-Set-Revisions/#icon-gauntlet","title":"Icon Gauntlet","text":"<p>The Icon Gauntlet is used to vote for new game icons or new badges for a set. With the vote it is checked which version is preferred by the community.</p> <p>Any user wanting to change the game icon or badges of a set need to:</p> <ol> <li>Contact each active author or claimant of the set. Wait for a response (after 72hours have passed, you may proceed without a response).</li> </ol> <ul> <li>They may have design considerations for the icon or badges to best fit the set.</li> <li>Doing this might also avoid needing a gauntlet vote if your icon or badges are preferred by them.</li> <li>Ideally Both parties should work together to come to a satisfactory proposal.</li> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul> <ol> <li> <p>Create the game icon or new badges. For more info, see Badge and Icon Creation.</p> </li> <li> <p>Upload the work on an image sharing site.</p> </li> <li> <p>Consider sharing samples of your badges or icons in <code>#gauntlet-discussion</code> prior to starting the revision vote. This will help polish any issues and avoid multiple updates to the gauntlet.</p> </li> <li> <p>Start a vote by posting links to the old icon/badges and their contenders in the <code>#icon-gauntlet</code> channel on Discord.</p> </li> </ol> <ul> <li>Whomever creates the vote must ping <code>@icon-gauntlet</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</li> <li>Use the a template to create the poll:        Discord Templates       \ud83d\udcca 1 vs. 1 proposal: <code>?quickpoll (game/hub page link) | Current (current icon/badges link) | Contender (contender icon/badges link)</code>        \ud83d\udcca 1 vs. 2 or 3 proposal: <code>?quickpoll (game/hub page link) | Current (current icon link) | Contender 1 (contender 1 icon link) | Contender 2 (contender 2 icon link) | Contender 3 (contender 3 icon link)</code>        Discord only embeds 4 images at maximum in a single post (current icon vs. 3 contenders), so if there's at least 5 images required (current icon vs. 4+ contenders), you'll have to do a montage with all icons:       \ud83d\udcca 1 vs. 4+ proposal: <code>?quickpoll (game/hub page link) | Current | Contender 1 | Contender 2 | Contender 3 | Contender 4 | Contender 5 | Contender 6 (single image montage link with all icons)</code> </li> </ul> <ol> <li>Voting will be active for 24 hours.</li> </ol> <ul> <li>If the voting passes, the Art Team or Gauntlet Helpers will handle replacing the images and logging the change.</li> <li>If you created a badge set, upload the badge set to <code>#icon-gauntlet-uploads</code><ul> <li>Badges should be named using numbers (1.png, 2.png, 3.png, etc) based on the order of the achievements in the set, or named using the achievement titles</li> </ul> </li> </ul> <p>Notes:</p> <ul> <li>In cases where there are several designs, the contender list can be extended. Remember to add the letter emojis, in alphabetical order, as soon as you post the proposal so people can vote by clicking on them. </li> <li>If you are not active on Discord, you may have someone else post the vote on your behalf. </li> </ul>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote_2","title":"No Need for Approval Vote","text":"<ol> <li> <p>The game does not have an achievement set, nor is it reserved by a developer.</p> </li> <li> <p>The entry has no game icon or badges.</p> </li> <li> <p>The new icon/badge(s) display the same content, but are of better quality.</p> </li> <li> <p>You are the existing set's sole developer and no other developer has changed the icon/badge(s).</p> </li> <li> <p>You are one of the existing set's original developers as part of a collaborative set, all parties agree to the change, and no other developer has changed the icon/badge(s).</p> </li> </ol>"},{"location":"Achievement-Set-Revisions/#voting-and-discussion","title":"Voting and Discussion","text":"<p>Revision voting is currently dev-only. While voting is exclusive to Discord, please remember that anyone can express their comments, questions, concerns, criticisms, etc. in the forum thread in which the plan was posted. The issues regarding Discord exclusivity will be addressed in a future version of the website.</p> <ul> <li>If you vote against changes in an achievement set, please state your reasoning in the discussion channel. This is so potential compromises can be made for a broader acceptance of the changes.</li> </ul> <ul> <li>Hijacking revision, rescore, or icon-gauntlet votes will not be tolerated. Votes from alt accounts will be discarded if discovered and repeated occurrences will result in the alt account being removed from the server. If the alt's primary account is confirmed, they will have their vote(s) discarded and may face suspension from future votes.</li> </ul> <ul> <li>If a revision plan that involves the demotion of achievements is proven to contain misleading or false information regarding the in-game requirements, the current proposal will be considered invalid. If evidence of this is found after a vote has already passed, the demoted achievements must be reinstated until a new vote is held.</li> </ul>"},{"location":"Achievement-Set-Revisions/#contacting-an-active-author","title":"Contacting an Active Author","text":"<ul> <li>All revision types require you to contact active authors of the set and any developer with an active claim.</li> <li>You may contact them in any manner in which you can be reasonably certain they will see it (DMs preferred)</li> <li>If you believe you may be blocked by the user, send a message to DevCompliance asking them to contact the author on your behalf. The 72hr maximum wait time will begin upon sending the message to DevCompliance. When doing so, state the user's name, type of revision, and the brief description of what your revision entails as if you were contacting the author directly.</li> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of the revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul>"},{"location":"Achievement-Set-Revisions/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-02 12:33] The Mystical One:</code> Reordered the 'reauthor' clause so it's clearer.</li> <li><code>[2024-01-26 08:41] The Mystical One:</code> Added additional new revision guidelines to the 'When Making a Revision' section to clarify what is expected from a revision. Updated section on achievement clones to clearly indicate that reauthoring requires Developer Compliance Permission.</li> <li><code>[2023-12-07 14:05] The Mystical One:</code> Updated rules for missable types now that there is a missable typing.</li> <li><code>[2023-11-06 18:20] Andrew Comer:</code> Formatting updates.</li> <li><code>[2023-11-03 08:18] The Mystical One:</code> Added rules for progression and win typing to Standard Revisions</li> <li><code>[2023-08-15 10:28] The Mystical One:</code> Reduces requirements for when to ping active authors at vote start.</li> <li><code>[2023-08-01 13:47] The Mystical One:</code> Adjusted bullet list formatting.</li> <li><code>[2023-07-14 10:35] The Mystical One:</code> Fix a minor capitalization typo. Add the word 'Vote' after 'No Need for Approval' just for extra clarification.</li> <li><code>[2023-07-13 09:59] The Mystical One:</code> Added opt-out form and public sheet. Added section about contacting an active author.</li> <li><code>[2023-07-11 10:46] The Mystical One:</code> Clarify \"No Need for Approval\" for revisions that are collaborations. Add in revision rule alignment changes (contact, waiting for response, pinging authors). Add bold highlights for the main ideas of each step. Add post-vote process to icon gauntlet.</li> </ul>"},{"location":"Achievement-Templates-es/","title":"Plantillas para Logros","text":""},{"location":"Achievement-Templates-es/#precaucion-cada-juego-es-diferente","title":"PRECAUCI\u00d3N: CADA JUEGO ES DIFERENTE!","text":"<p>Aqu\u00ed encontraras varios ejemplos de varios logros t\u00edpicos. Puedes utilizarlo como una inspiraci\u00f3n para crear tu propio logro. Pero ten en mente lo siguiente:</p> <p>CADA JUEGO ES DIFERENTE! La memoria tiene un comportamiento diferente de juego en juego.</p> <p>A si que NO tomes estas plantillas como una regla. Simplemente son para motivos educativos.</p> <p>En estos ejemplos utilizamos la siguiente definici\u00f3n, 0xNIVEL es el valor en memoria que representa el ID del Nivel; 0xVIDA es el valor utilizado para la vida de nuestro personaje; 0xTIEMPO para el tiempo, 0xITEM por obtener un item, etc...</p>"},{"location":"Achievement-Templates-es/#coleccionando-un-item-n-veces","title":"Coleccionando un Item N veces","text":"<p>Abra situaciones en las que quieras otorgar un logro por coleccionar un item (como una moneda o anillo) N numero de veces. Vas a necesitar encontrar el valor en memoria responsable en contar cuantas veces tienes un item. Una vez que tengas la variable, esta l\u00f3gica usualmente hace el trabajo:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCONTADOR &gt; Delta 0xCONTADOR (N) <p>Pero es mas probable que quieras ser mas especifico, por ejemplo \"obt\u00e9n el item N veces sin morir\". Entonces tendr\u00edas que utilizar otra condici\u00f3n con un <code>ResetIf</code>, de la siguiente manera:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCONTADOR &gt; Delta 0xCONTADOR (N) 2 ResetIf 0xVIDAS &lt; Delta 0xVIDAS <p>La condici\u00f3n del <code>ResetIf</code> podr\u00eda ser \"mientras est\u00e9s en el nivel X\", \"sin utilizar una bomba\", etc.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n","title":"Termina el Nivel N","text":"<p>En este ejemplo queremos otorgar el logro cuando el jugador termino el nivel <code>N</code> y pasa al nivel <code>N+1</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO <p>Requisitos</p> <ul> <li>1: En el nivel <code>N</code> m\u00ednimo una vez</li> <li>2: Actualmente en el nivel <code>N+1</code></li> <li>3: El nivel a incrementado</li> <li>4: Resetea el contador de hit cuando se vuelva a la pantalla de titulo</li> </ul> <p>El valor 0xTITULO significa \"en la pantalla de titulo del juego\". Tu necesitas poner un <code>ResetIf</code> en la pantalla de titulo para evitar que se dispare en el momento equivocado.</p> <p>Aqui hay un ejemplo de una situacion de un juego en el que podria hacer que el logro se dispare en el momento equivocado si no estuviera el ResetIf:</p> <ol> <li>Empieza el juego y llega al nivel 2 (esto hace que el contador valla a 1)</li> <li>Obtiene un game over mientras estaba en el nivel 2</li> <li>Vuelve a la pantalla de titulo</li> <li>Utiliza una contrase\u00f1a para llegar al nivel 3</li> </ol> <p>Si no utilizamos el ResetIf tendr\u00edamos estas condiciones:</p> <ol> <li>Hit nivel 2: VERDADERO</li> <li>Nivel actual = nivel 3: VERDADERO</li> <li>Nivel incrementado (de pantalla de titulo/passwords a nivel 3): VERDADERO</li> </ol> <p>Y seria lo suficiente para que el logro se dispare (en un momento equivocado). Por eso estamos utilizando el ResetIf en este ejemplo.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-antes-de-que-el-tiempo-llegue-a-t","title":"Termina el Nivel N antes de que el tiempo llegue a T","text":"<p>En este ejemplo vamos a considerar un juego en el que el tiempo decrementa  (ej.: Super Mario Bros). Adapta el logro de acuerdo al comportamiento del tiempo de tu juego.</p> <p>Queremos premiar el logro si el jugador termina el nivel <code>N</code> mientras el tiempo es mayor que <code>T</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xTIEMPO &gt;= Value T <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que la plantilla Termina el Nivel N.</p> <ul> <li>5: el contador es mas grande que <code>T</code>.</li> </ul> <p>Ten en cuenta que mas all\u00e1 de saber como funciona el contador en tu juego tambi\u00e9n necesitas saber como se maneja en la memoria del juego.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-sin-morir-o-sin-que-te-peguen-usar-un-arma-etc","title":"Termina el Nivel N sin Morir (o sin que te peguen, usar un arma, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xPANTALLA = Value NVL_N_INTRO (1) 6 ResetIf 0xVIDA &lt; Delta 0xVIDA <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que los de la plantilla Termina el Nivel N.</p> <ul> <li>5: un checkpoint para representar el punto donde el jugador se supone que empieza el reto sin perder una vida. Si el nivel tiene una pantalla de intro por nivel, este puede ser un buen checkpoint.</li> <li>6: se resetea el hit count si la vida se decrementa.</li> </ul> <p>El requisito 6 tambi\u00e9n puede ser utilizado para resetear el si se utiliza un arma, se recibe da\u00f1o, o cualquier otra cosa que NO quieras que el jugador haga.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-con-un-item","title":"Termina el Nivel N con un Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xITEM = Value VERDADERO <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que los de la plantilla Termina el Nivel N.</p> <ul> <li>5: el jugador tiene un item</li> </ul>"},{"location":"Achievement-Templates-es/#colecciona-un-item-en-un-nivel-en-especifico","title":"Colecciona un item en un nivel en especifico","text":"<p>Esta plantilla es para salvados de bater\u00eda o protecci\u00f3n contra passwords para items. Evita premiar \"obten x item\" cargando cuando el jugador ya cuenta con ese item. Checa que el item se obtenga en nivel/habitacion donde se supone que tenga que ser obtenido, y solo lo premia cuando se hace de esa manera.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSO (1) 2 0xITEM = Value VERDADERO 3 ResetIf 0xNIVEL != Value nivel donde se colecciona <p>Requisitos</p> <ul> <li>1: No tener el item cuando se entra al nivel en el que se obtiene, el hit es un checkpoint asi que 1&amp;2 pueden ser verdaderos al mismo tiempo.</li> <li>2: Tener el item</li> <li>3: Resetea el hit counter si se esta en un nivel diferente del cual se obtiene el item</li> </ul> <p>Los Requisitos 1 y 3 juntos significan \"llego al ID de nivel/habitacion sin el item\".</p> <p>Incluso si el jugador carga un estado de guardado y va al nivel requerido el no seria capaz de a\u00f1adir hits a la condici\u00f3n 1, ya que no se pueden conseguir solamente por gameplay normal.  </p> <p>No necesita ser necesariamente un ID de nivel/habitaci\u00f3n. Hay otros m\u00e9todo para enfrentar este problema, por ejemplo ejemplo un valor en memoria \u00fanico que solo ocurre cuando lo coleccionas. Etc.</p>"},{"location":"Achievement-Templates-es/#colecciona-100-en-algo","title":"Colecciona 100% en algo","text":"<p>Esta es proteccion limitada de salvado de bateria /proteccion de password cuando el jugador coleccione 100% de algo como pasar cada stage en Super Mario world, u obtener 100% en el porcentaje de coleccionables en Super Metroid. Es necesario que el jugador no pueda simplemente cargar un save con 100% y obtener el logro de a gratis. (Como siempre hay otras maneras de enfrentar este problema tambi\u00e9n.)</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xPorcentajeColeccionado &lt; Value valor 100% 2 Mem 0xPorcentajeColeccionado = Value valor 100% 3 PauseIf Mem 0xEstadoJugador != Value Modo especifico/punto donde % es incrementado <p>Usar la variable y el valor indicado en la condici\u00f3n 3 es especialmente importante. Necesitas encontrar una variable que represente un momento \u00fanico en el juego cuando este porcentaje aumenta. Tu no quieres que el logro salte cuando el jugador cargue su archivo de guardado, que quiere decir que el logro tiene que ser pausado en ese momento.</p> <p>Ejemplo: En Super Mario World este cambio pasa cuando el jugador observa el mapa del mundo despu\u00e9s de a ver completado un stage.</p> <p>Nota: Este comportamiento es similar y el resultado a Colecciona un item en un nivel en especifico.</p>"},{"location":"Achievement-Templates-es/#evitando-el-problema-de-que-un-contador-se-incremente-dos-veces-en-el-mismo-frame","title":"Evitando el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame","text":"<p>En Coleccionando un item N veces estamos contando que tantas veces este contador aumenta. Pero en algunos juegos hay algunas situaciones en el que el contador aumenta al doble en el mismo frame, y el hit counter se incremente solo por uno. Este comportamiento, obviamente, arruina nuestra l\u00f3gica. Vamos a ver una manera para evitar este problema.</p> <p>La t\u00e9cnica utilizada aqu\u00ed se baza en otras dos:</p> <ul> <li>Utilizando SubSource para Contar Incrementos Especificos</li> <li>Bandera <code>AddHits</code></li> </ul> <p>Aqu\u00ed esta el truco:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 SubSource Delta 0xCONTADOR 2 AddHits Mem 0xCONTADOR = Value 0x02 3 Mem 0xCONTADOR &gt; Delta 0xCONTADOR (N) 4 ResetIf Mem 0xVIDAS &lt; Delta 0xVIDAS <p>Podr\u00eda verse un poco confuso a primera vista, pero talvez utilizando un ejemplo de verdad pueda ser todo mas claro. Checa Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame.</p>"},{"location":"Achievement-Templates-es/#checar-el-cambio-de-un-valor-especifico-a-otro-valor-especifico-diez-veces","title":"Checar el cambio de un valor especifico a otro valor especifico diez veces","text":"<p>En este ejemplo queremos detectar que un valor cambie de <code>V1</code> a <code>V2</code> diez veces:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xADDRESS = Value 0xV1 (10) 2 Mem 0xADDRESS = Value 0xV2 (10) 3 PauseIf Mem 0xADDRESS = Delta 0xADDRESS <p>Requisitos</p> <ul> <li>1: Si el valor en <code>0xADDRESS</code> en el frame anterior es <code>0xV1</code>, aumenta el hitcount (hasta  10).</li> <li>2: Si el valor en <code>0xADDRESS</code> es igual a <code>0xV1</code>, aumenta el hitcount (hasta 10).</li> <li>3: No aumente los hitcounts en 1 y 2 si cambian en <code>0xADDRESS</code>.</li> </ul>"},{"location":"Achievement-Templates-es/#resets-condicionales","title":"Resets Condicionales","text":"<p>Resets Condicionales se pueden utilizar para muchas cosas.</p> <p>Digamos que quieres tener un reset si el jugador entra a cierta zona X e Y del nivel:</p> <p>CORE </p> <ul> <li>En el Core ira cualquier condiciones que necesites para que el logro sea verdadero. Tambien puede contener un Reset   con comportamiento normal.</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xNIVEL = Value NIVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONE 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONE 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONE 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONE <ul> <li>El reset solo va a pasar si todas las condiciones Pauseif no son verdaderas.</li> <li>El pause es local en el alt pero el reset resetea todo el logro.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Cualquier condici\u00f3n que sea verdadera. (para satisfacer el comportamiento de un alt teniendo una condici\u00f3n que siempre es verdadera es necesaria)</li> </ul> <ul> <li>Nota: Puedes utilizar m\u00faltiples resets condicionales, cada uno en su propio alt group para tener un control mas grande del comportamiento de los reseteos.</li> </ul>"},{"location":"Achievement-Templates-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 19:57] meleu:</code> fix broken link</li> <li><code>[2019-04-16 11:16] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Achievement-Templates-pt_BR/","title":"Modelos de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Achievement Templates</p>"},{"location":"Achievement-Templates-pt_BR/#atencao-todo-jogo-e-diferente","title":"ATEN\u00c7\u00c3O: TODO JOGO \u00c9 DIFERENTE!","text":"<p>Aqui voc\u00ea ir\u00e1 ver exemplos de algumas conquistas tip\u00edcas. Voc\u00ea pode usar elas como inspira\u00e7\u00e3o para criar suas conquistas. Mas mantenha em mente o seguinte:</p> <p>TODO O JOGO \u00c9 DIFERENTE! A mem\u00f3ria tem uma diferen\u00e7a de comportamento de jogo para jogo.</p> <p>Ent\u00e3o N\u00c3O fa\u00e7a desses exemplos como regras. Elas est\u00e3o aqui apenas para fins educacionais.</p> <p>Nesses exemplos n\u00f3s usamos a seguinte conven\u00e7\u00e3o  0xNIVEL \u00e9 o endere\u00e7o de mem\u00f3ria (memory address) com o ID de n\u00edvel; 0xVIDA \u00e9 o endere\u00e7o usado para a vida do personagem; 0xTEMPO para obter um item, etc...</p>"},{"location":"Achievement-Templates-pt_BR/#termine-nivel-n","title":"Termine N\u00edvel N","text":"<p>Neste exemplo n\u00f3s queremos premiar quando o jogador terminar o n\u00edvel <code>N</code> e v\u00e1 para o n\u00edvel <code>N+1</code></p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO <p>Requerimentos</p> <ul> <li>1: No n\u00edvel <code>N</code> pelo menos uma vez</li> <li>2: Atualmente no n\u00edvel <code>N+1</code></li> <li>3: O n\u00edvel foi aumentado</li> <li>4: Resete o contador de hits quando voltar para a tela de titulo</li> </ul> <p>O valor 0xTITULO significa \"na tela de t\u00edtulo do jogo\". Voc\u00ea precisa do <code>ResetIf</code> indo para a tela de t\u00edtulo para evitar uma premia\u00e7\u00e3o na hora errada</p> <p>Aqui est\u00e1 um exemplo do fluxo de jogo que poderia fazer a conquista ser ativada em uma hora errada se n\u00e3o fosse pelo ResetIf:</p> <ol> <li>Inicie o jogo e chegue ao n\u00edvel 2 (isso far\u00e1 o contador de hits ir para 1)</li> <li>Obtenha um game over enquanto estiver no n\u00edvel 2</li> <li>Volte para a tela de t\u00edtulo</li> <li>Use um password para o n\u00edvel 3</li> </ol> <p>Se n\u00e3o estiver usando o ResetIf, teremos estas condi\u00e7\u00f5es:</p> <ol> <li>N\u00edvel de Hit 2: VERDADEIRO</li> <li>N\u00edvel Atual = n\u00edvel 3: VERDADEIRO</li> <li>N\u00edvel aumentado (Do titulo/tela de password para o n\u00edvel 3): VERDADEIRO</li> </ol> <p>E seria o suficiente para ativar a conquista (no momento errado). \u00c9 por isso que nos estamos usando o <code>ResetIf</code> neste exemplo</p>"},{"location":"Achievement-Templates-pt_BR/#termine-nivel-n-antes-que-o-tempo-atinja-t","title":"Termine N\u00edvel N antes que o Tempo atinja T","text":"<p>Neste exemplo vamos considerar um jogo quando o tempo diminuir (ex: Super Mario Bros). Adaptar-lo de acordo com o tempo no seu jogo tem um comportamento diferente.</p> <p>N\u00f3s queremos premiar se o jogardor finalizar o n\u00edvel <code>N</code> enquanto o tempo for maior que <code>T</code></p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xNIVEL &gt;= Value T <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: O tempo \u00e9 maior que <code>T</code>.</li> </ul> <p>Mantenha em mente que por tr\u00e1s de al\u00e9m saber como o tempo se comporta no jogo, al\u00e9m disso voc\u00ea precisa pesqusar como se comporta na mem\u00f3ria</p>"},{"location":"Achievement-Templates-pt_BR/#terminar-nivel-n-sem-morrer-ou-ser-atingido-usando-uma-arma-etc","title":"Terminar N\u00edvel N sem Morrer (ou ser atingido, usando uma arma, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITLE 5 0xTELA = Value NVL_CM_INTRO (1) 6 ResetIf 0xVIDA &lt; Delta 0xVIDA <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: um checkpoint para representar o ponto de onde o jogador supostamente iniciar\u00e1 o desafio de n\u00e3o perder uma vida. Se o jogo tem um n\u00edvel na tela de introdu\u00e7\u00e3o, isto pode ser um bom checkpoint.</li> <li>6: resete o contador de hits se a vida diminuir.</li> </ul> <p>O requerimento 6 pode tamb\u00e9m ser usando para resetar o contador de hits se uma arma for usada, tomado dano, ou qualquer coisa al\u00e9m daquilo que voc\u00ea n\u00e3o quer que o jogador fa\u00e7a</p>"},{"location":"Achievement-Templates-pt_BR/#termine-o-nivel-n-com-item","title":"Termine o N\u00edvel N com Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xITEM = Value VERDADEIRO <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: o jogador tem o item</li> </ul>"},{"location":"Achievement-Templates-pt_BR/#colete-o-item-em-um-nivel-especifico","title":"Colete o Item em um n\u00edvel espec\u00edfico","text":"<p>Aqui est\u00e1 uma forma de checar se o item foi coletado em um n\u00edvel/sala que deve ser coletado. Isto evita a premia\u00e7\u00e3o \u00e0 \"consiga item X\" por carregando um savestate onde o jogador j\u00e1 tem o item.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSO (1) 2 0xITEM = Value VERDADEIRO 3 ResetIf 0xNIVEL != Value nivl de coleta <p>Requerimentos</p> <ul> <li>1: N\u00e3o tenha o item quando entrou no n\u00edvel de coleta, o hit \u00e9 um checkpoint ent\u00e3o o 1&amp;2 podem ser verdadeiro ao mesmo tempo</li> <li>2: Tenha o item</li> <li>3: Reseta o contador de hits se estiver em uma fase diferente daquela que o item deve ser obtido</li> </ul> <p>Requerimentos 1 e 3 juntos significa \"chegou ao n\u00edvel/sala sem o item\"</p> <p>Mesmo se o jogador carregar um savestave e for para o n\u00edvel requerido eles n\u00e3o poder\u00e3o adicionar hits para a condi\u00e7\u00e3o 1, portanto eles n\u00e3o podem conseguir exceto em gameplay normal</p> <p>N\u00e3o precisa ser necessariamente n\u00edvel/sala. H\u00e1 outras maneiras de abordar esse problema, por exemplo uma \u00fanica Mem\u00f3ria/Valor que apenas ocorre na coletagem. Etc</p>"},{"location":"Achievement-Templates-pt_BR/#cheque-por-um-valor-especifico-mudando-para-outro-valor-especifico-dez-vezes","title":"Cheque por um valor espec\u00edfico mudando para outro valor espec\u00edfico dez vezes","text":"<p>Neste exemplo n\u00f3s queremos para detectar uma mudan\u00e7a de valor de <code>V1</code> para <code>V2</code> dez vezes:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Mem 0xENDERE\u00c7O = Value 0xV1 (10) 2 Delta 0xENDERE\u00c7O = Value 0xV2 (10) 3 PauseIf Mem 0xENDERE\u00c7O = Delta 0xENDERE\u00c7O"},{"location":"Achievement-Templates-pt_BR/#resets-condicionais","title":"Resets Condicionais","text":"<p>Resets Condicionais podem ser usado para muitas coisas.</p> <p>Vamos dizer que voc\u00ea quer para resetar se um jogador entrar ema certa zona X e Y de um n\u00edvel:</p> <p>CORE </p> <ul> <li>O Core \u00e9 qualquer condi\u00e7\u00e3o que voce precisa para a sua conquista ser verdadeira. Isto pode tambem incluir comportamentos normais de resets</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xNIVEL = Value NIVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONA 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONA 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONA 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONA <ul> <li>O reset ir\u00e1 acontecer apenas se todas as condi\u00e7\u00f5es Pauseif n\u00e3o forem verdadeiras.</li> <li>O pause \u00e9 local para o alt mas o reset reseta a conquista inteira.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Qualquer condi\u00e7\u00e3o que seja sempre verdadeira (isso \u00e9 necess\u00e1rio para que o Alt1 tenha o comportamento que desejamos)</li> </ul> <ul> <li>Nota: Voc\u00ea pode usar multiplos resets condicionais, cada um em seu pr\u00f3prio grupo alt para ter um controle muito maior do comportamento de reset. </li> </ul>"},{"location":"Achievement-Templates-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:07] KingDice001:</code> Updated Achievement Templates pt_BR (markdown)</li> <li><code>[2018-03-25 11:51] KingDice001:</code> Updated Achievement Templates pt_BR (markdown)</li> <li><code>[2018-03-24 04:22] KingDice001:</code> Created Achievement Templates pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Templates/","title":"Achievement Templates","text":""},{"location":"Achievement-Templates/#warning-every-game-is-different","title":"WARNING: EVERY GAME IS DIFFERENT!","text":"<p>Here you'll see examples of some typical achievements. You can use them as inspiration to create your own achievement. But keep in mind the following:</p> <p>EVERY GAME IS DIFFERENT! The memory has a different behavior from game to game.</p> <p>So do NOT take these templates as a rule. They are here just for educational purposes.</p> <p>In these examples we use the following convention 0xLEVEL is the memory address with the level ID; 0xLIFE is the address used for the character life; 0xTIME for time, 0xITEM for getting an item, etc...</p> <ul> <li>Collecing an Item N Times</li> <li>Finish Level N</li> <li>Finish Level N Before Time Reaches T</li> <li>Finish Level N without Dying (or getting hit, using a weapon, etc.)</li> <li>Finish Level N with Item</li> <li>Collect an Item in a Specific Level</li> <li>Collected 100 Percent of Something</li> <li>Circumvent the Problem of a Counter Incrementing Twice in the Same Frame</li> <li>Check for a Specific Value Changing to Another Specific Value Ten Times</li> <li>Conditional Resets</li> </ul>"},{"location":"Achievement-Templates/#collecting-an-item-n-times","title":"Collecting an Item N times","text":"<p>There are some situations where you want to award an achievement for collecting an item (like a coin or a ring) N times. You'll need to find in the memory the address responsible to count how much of the item you have. Once you have the address, this logic usually does the job:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCOUNT &gt; Delta 0xCOUNT (N) <p>But you most likely will want to be more specific, for example \"get item N times without dying\". Then you should use another condition with a <code>ResetIf</code>, like this:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCOUNT &gt; Delta 0xCOUNT (N) 2 ResetIf 0xLIVES &lt; Delta 0xLIVES <p>The <code>ResetIf</code> condition could be \"while in level X\", \"without using a bomb\", etc.</p>"},{"location":"Achievement-Templates/#finish-level-n","title":"Finish Level N","text":"<p>In this example we want to award when the player finish the level <code>N</code> and goes to level <code>N+1</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE <p>Requirements</p> <ul> <li>1: On level <code>N</code> at least one time</li> <li>2: Currently at level <code>N+1</code></li> <li>3: The level has been increased</li> <li>4: Reset the hit counter when back to title screen</li> </ul> <p>The value 0xTITLE means \"at game's title screen\". You need to <code>ResetIf</code> going to the title screen to avoid the awarding at a wrong time.</p> <p>Here is an example of game flow that could make the achievement trigger at a wrong time if it wasn't for that ResetIf:</p> <ol> <li>Start the game and reach level 2 (this make the hit counter goes to 1)</li> <li>Get a game over while on level 2</li> <li>Go back to the title screen</li> <li>Use a password for level 3</li> </ol> <p>If not using the ResetIf we will have these conditions:</p> <ol> <li>Hit level 2: TRUE</li> <li>Current level = level 3: TRUE</li> <li>Level increased (from title/password screen to level 3): TRUE</li> </ol> <p>And it would be enough to trigger the cheevo (at a wrong time). That's why we're using the <code>ResetIf</code> in this example.</p>"},{"location":"Achievement-Templates/#finish-level-n-before-time-reaches-t","title":"Finish Level N Before Time Reaches T","text":"<p>In this example we consider a game where the time decreases (e.g.: Super Mario Bros). Adapt it accordingly the time on your game has a different behavior.</p> <p>We want to award if the player finishes the level <code>N</code> while time is greater than <code>T</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xTIME &gt;= Value T <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: timer is greater than <code>T</code>.</li> </ul> <p>Keep in mind that besides knowing how the time behaves in game you also need to research how it behaves in memory.</p>"},{"location":"Achievement-Templates/#finish-level-n-without-dying-or-getting-hit-using-a-weapon-etc","title":"Finish Level N without Dying (or getting hit, using a weapon, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xSCREEN = Value LVL_N_INTRO (1) 6 ResetIf 0xLIFE &lt; Delta 0xLIFE <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: a checkpoint to represent the point from where the player is suposed to start the chalenge of not losing a life. If the game has a level intro screen, it can be a good checkpoint.</li> <li>6: reset hit count if life decreased.</li> </ul> <p>The requirement 6 can also be used to reset hit count if a weapon was used, damage taken, or anything else that you want the player to NOT do.</p>"},{"location":"Achievement-Templates/#finish-level-n-with-item","title":"Finish Level N with Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xITEM = Value TRUE <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: the player have the item</li> </ul>"},{"location":"Achievement-Templates/#collect-an-item-in-a-specific-level","title":"Collect an Item In a Specific Level","text":"<p>This template is for battery save or password protection for items. It avoids awarding \"get item X\" by loading to where player already has the item. It checks that an item is collected in the level/room ID it is supposed to be collected, and only allows it be earned at that time.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSE (1) 2 0xITEM = Value TRUE 3 ResetIf 0xLEVEL != Value collect level <p>Requirements</p> <ul> <li>1: Do not have the item when entered the collect level, the hit is a checkpoint so 1&amp;2 can both be true at once.</li> <li>2: Have the item</li> <li>3: Reset hit counter if in a level different than the one where the item must be obtained</li> </ul> <p>Requirements 1 and 3 together mean \"arrived the level/Room ID without the item\".</p> <p>Even if the player loads a savestate and goes to the required level they will not be able to add hits to condition 1, thus they can't get it except in normal gameplay.  </p> <p>It does not necessarily have to be level/Room ID. There are other ways to approach this problem, for example a unique Mem/Val that only occurs on collection. Etc.</p>"},{"location":"Achievement-Templates/#collected-100-percent-of-something","title":"Collected 100 Percent of Something","text":"<p>This is limited battery save /password protection for when a player will collect 100% of something like clearing each stage in Super Mario world, or getting a 100% collection rate in Super Metroid. It's necessary so that a player cannot just load a save at 100% and get the achievement for free. (As usual there are other ways to approach this problem too.)</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xCollectPercent &lt; Value 100% value 2 Mem 0xCollectPercent = Value 100% value 3 PauseIf Mem 0xPlayerState != Value Specific mode/point in game where % is increased <p>Using the correct address value for condition 3 is especially important. You need to find an address that represents a unique time in the game where this percent increases. You'd not want the achievement to trigger when the player is loading their in game save file, which means this achievement must be paused at that time.</p> <p>Example: In Super Mario World this change happens while the player sees the world map after completing a stage.</p> <p>Note: This is similar in behavior and result to Collect an Item in a specific Level.</p>"},{"location":"Achievement-Templates/#circumvent-the-problem-of-a-counter-incrementing-twice-in-the-same-frame","title":"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame","text":"<p>In the Collecting an Item N times we are counting how many times the counter goes up. But in some games there are situations where the counter goes up twice in the same frame, and the hit counter is incremented only by one. This behavior, obviously, ruins our logic. We're going to see a way to circumvent this issue.</p> <p>The technique used here relies on two other ones:</p> <ul> <li>using <code>SubSource</code> to count specific increments</li> <li><code>AddHits</code> Flag</li> </ul> <p>Here's the trick:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 SubSource Delta 0xCOUNT 2 AddHits Mem 0xCOUNT = Value 0x02 3 Mem 0xCOUNT &gt; Delta 0xCOUNT (N) 4 ResetIf Mem 0xLIVES &lt; Delta 0xLIVES <p>It can looks a bit confusing at a first sight, but maybe using a real example it can be more clear. Check the Circumvent the Problem of a Counter Incrementing Twice in the Same Frame.</p>"},{"location":"Achievement-Templates/#check-for-a-specific-value-changing-to-another-specific-value-ten-times","title":"Check for a Specific Value Changing to Another Specific Value Ten Times","text":"<p>In this example we want to detect a value changing from <code>V1</code> to <code>V2</code> ten times:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 AndNext Delta 0xADDRESS = Value 0xV1 2 Mem 0xADDRESS = Value 0xV2 (10) <p>Requirements</p> <ul> <li>1: If value in <code>0xADDRESS</code> in the previous frame is <code>0xV1</code></li> <li>2: AND If the current value in <code>0xADDRESS</code> is <code>0xV2</code>, increases the hitcount (up to 10).</li> </ul>"},{"location":"Achievement-Templates/#conditional-resets","title":"Conditional Resets","text":"<p>Conditional resets can be used for many things.</p> <p>Lets say you want to have a reset if a player enters a certain X and Y zone of a level:</p> <p>CORE </p> <ul> <li>The Core is whatever condition(s) you need for your achievement to be true. It can also include normal reset behavior.</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xLEVEL = Value LEVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONE 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONE 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONE 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONE <ul> <li>The reset will only happen if all of the Pauseif conditions are not true.</li> <li>The pause is local to the alt but the reset resets the entire achievement.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Any true condition. (to satisfy alt behavior having an always true alt is needed)</li> </ul> <ul> <li>Note: You can use multiple conditional resets, each one in their own alt group to have far greater control of reset behavior.</li> </ul>"},{"location":"Achievement-Templates/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:17] televandalist:</code> Added ToC</li> <li><code>[2021-05-01 07:24] meleu:</code> fix link to AddHits page</li> <li><code>[2020-09-01 09:50] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:31] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:28] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:23] Brandon D:</code> Updated as per feedback from Keltron</li> <li><code>[2020-09-01 09:04] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 08:47] Brandon D:</code> Took a real usage case from my game Dicing Knight Period and condensed it down to something more manageable. The AddHits docs are also a bit vague on some things and this hopefully will help out there.</li> <li><code>[2019-12-02 11:25] Searo:</code> Updating \"Check for a specific value changing to another specific value ten times\" to use AndNext to simplify the logic</li> <li><code>[2019-02-17 21:19] meleu:</code> add \"Collecting an Item N times\" and \"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame\"</li> </ul>"},{"location":"Achievements-for-ROM-hacks-es/","title":"Logros para ROM hacks","text":"<p>\u00bfEste hack que encontr\u00e9/Que hice puede tener un set en RetroAchievements?</p> <p>RetroAchievements abre la puerta a todos esos divertidos hacks para el disfrute de los jugadores.  Pero esto tambi\u00e9n abre el tema de \"Que es permitido, y que no esta permitido que tenga un set en RetroAchievements?\"</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-para-game-trainers","title":"Parches Para Game Trainers","text":"<p>No est\u00e1n permitidos sobre cualquier circunstancia</p> <p>Hacks que incluyan \"game trainers\" o funciones de integradas de cheats (por razones obvias) no est\u00e1n permitidos.</p>"},{"location":"Achievements-for-ROM-hacks-es/#hacks-de-dificultad-e-historia","title":"Hacks de Dificultad e Historia","text":"<p>Posiblemente Permitido</p> <p>Si un hack tiene suficiente diferencias que la versi\u00f3n licenciada del juego, tanto que incluso el juego puede ser considerado un juego completamente diferente, usualmente la creaci\u00f3n de un set es usualmente aceptable.  Consulta con un administrador para una aprobaci\u00f3n mas especifica.</p> <p>Ejemplo: Metroid - Rogue Dawn</p>"},{"location":"Achievements-for-ROM-hacks-es/#lanzamiento-beta-prototipo-correccion-de-un-bug-re-balanceo-y-hacks-para-testing","title":"Lanzamiento Beta, prototipo, correcci\u00f3n de un bug, re-balanceo, y hacks para \"testing\"","text":"<p>No est\u00e1n permitidos</p> <p>Hacks para corregir un bug, parches de balance, versiones prototipo, hacks que est\u00e1n a nivel desarrollador y que cuentan con herramientas integradas (Selecci\u00f3n de Niveles f\u00e1cil de accesar, menus de debuging, menus que muestran informaci\u00f3n o proveen funciones de prueba y que no son normalmente accesibles en el juego normal), no pueden ser agregadas a un set core, y son tipicamente no permitidas que cuenten con su propio set de logros.</p> <p>Si un rom hack esta en un estado de beta con potenciales glitches que puedan romper el juego, crasheos, o bugs, intactos siendo un resultado del hack, esto no esta permitido.</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-de-traduccion","title":"Parches de Traducci\u00f3n","text":"<p>Posiblemente Permitidos</p> <p>Ingles es el Lenguaje Primario en RetroAchievements. Parches de traducci\u00f3n son algunas veces aplicados por los desarrolladores a t\u00edtulos que no son en Ingles cuando en el MD5 principal de un set de logros no existe un versi\u00f3n licenciada en ingles. En este tipo de casos instrucciones de como parchear el juego tienen que ser agregadas al foro del juego.  Proveer una traducci\u00f3n completa a un titulo existente es posiblemente permitido para que as\u00ed un juego sea mas accesible a gente que hable otros idiomas.  Recuerda que tienes que inspeccionar profundamente la memoria del juego entre el parche y el set core y meter una solicitud de aprobaci\u00f3n antes de que esta se entregue al desarrollador del set para que la postee en el foro junto con el parche.</p> <p>Algunas veces los parches de traducci\u00f3n pueden diferir cr\u00edticamente de como trabaja la memoria de acuerdo al MD5 del desarrollador.  Antes de linkear estos parches checa con el desarrollador original o haz algunas pruebas profundas en memoria para asegurarte que sea completamente compatible. Puedes agregar parches de traducci\u00f3n que encuentres en linea siempre y cuanto todos los logros core funcionen de manera correcta y estos no se hagan mas o menos dif\u00edciles.</p>"},{"location":"Achievements-for-ROM-hacks-es/#hacks-cosmeticos-sprites","title":"Hacks Cosm\u00e9ticos / Sprites","text":"<p>Posiblemente permitidos</p> <ul> <li>Hacks Cosm\u00e9ticos / Sprites que no hacen nada mas que cambiar las gr\u00e1ficas del juego no est\u00e1n permitidos que tengan su propio set.  Tal vez sean un experiencia algo divertida pero siguen siendo el mismo juego.</li> </ul> <ul> <li>Recuerda que:  Si un rom hack tiene suficientes diferencias del juego licenciado tantas que el juego puede ser considerado como un juego completamente diferente, es usualmente aceptable.  Consulta con un administrador para una aprobaci\u00f3n mas especifica.  Un simple hack de sprites no es suficiente para que tenga su propio set entero.</li> </ul> <p>Ejemplo: Roll-chan Evolution, Episode I - Roll-chan Gaiden</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-para-sets-bonus","title":"Parches para Sets Bonus","text":"<p>Hacks Cosm\u00e9ticos que producen un MD5 \u00fanico para un Set Bonus son usualmente permitidos para que sean agregados al proceso de revisi\u00f3n.  Inclusive este tipo de parches tienen que ser testeada profundamente la memoria con el set core para asegurarte que todos los logros funcionan de manera correcta.  Esto envuelve artas ediciones a la pantalla de titulo para que pueda conseguir los requisitos de los lineamientos. Para parches cosmeticos para Sets Bonus para que permitan que el jugador pueda jugar el Set Bonus en vez del juego original, por favor habla con Salsa si necesitas ayuda en el proceso de creaci\u00f3n.  Salsa maneja la sub-comunidad de creaci\u00f3n de parches IPS para desarrollo de Sets Bonus de RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks-es/#consultando","title":"Consultando","text":"<p>Consulta a la comunidad por medio del foro y/o Discord para meter tu solicitud de aprobaci\u00f3n.  Puedes darte una buena idea de que es lo que le gusta ver a la comunidad preguntando.  Preguntar por una aprobaci\u00f3n antes de agregar un parche es una practica integra de un Desarrollador, y cae en tu c\u00f3digo de conducta como desarrollador aqu\u00ed en RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-21 11:56] eldexterr:</code> Created Achievements for ROM hacks es (markdown)</li> </ul>"},{"location":"Achievements-for-ROM-hacks/","title":"Achievements for ROM hacks","text":"<p>RetroAchievements opens the doorway to include fun hack sets for players to enjoy.  The issue arising in such a broad category open to world of creativity being \"What is allowed, and what is not allowed to have a set at RetroAchievements?\" This page will go over the various types of hacks that are not allowed to have their own set and whether or not they are allowed to be linked to a base set.</p> <ul> <li>Game Trainer Patches</li> <li>Difficulty and Story Hacks</li> <li>Bug-fix, Re-balancing and Utility Hacks</li> <li>Beta Release, Prototype and \"Testing\" Hacks</li> <li>Cosmetic Hacks</li> <li>Consultation</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#game-trainer-patches","title":"Game Trainer Patches","text":"<ul> <li>These are hacks that have integrated cheat features. For those familiar with GoodTool's naming scheme, ROMs with <code>[t1]</code>, <code>[t2]</code>, etc. in the title are examples of this.</li> <li>These are not allowed to have their own sets or be linked to base sets under any circumstance. In fact, thousands of known hashes for these are linked to dummy game entries, such as this one.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#difficulty-and-story-hacks","title":"Difficulty and Story Hacks","text":"<ul> <li>If a hack has sufficient enough differences from the base game insomuch that the hack can be considered an entirely different game, then yes, a unique set is usually acceptable. Linking these to the base set is not recommended since they will likely break the set.<ul> <li>Examples include Metroid - Rogue Dawn, Castlevania: The Holy Relics, Super Mario 64: Last Impact, and Super Metroid: Redesign.</li> </ul> </li> <li>If the hack does not have enough differences from the base game, but there are good achievement ideas exclusive to the hack, then consider doing a compilation of hacks or incorporating them into a bonus set.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#bug-fix-re-balancing-and-utility-hacks","title":"Bug-fix, Re-balancing and Utility Hacks","text":"<ul> <li>Hacks that include development-level integrated utilities such as easily accessible level select, debug menus, menus that display information or provide testing features not normally accessible via the normal game, are almost never allowed to be linked to core sets or get their own set.<ul> <li>Example: Metroid + Saving for Metroid</li> </ul> </li> <li>Hacks that offer gameplay utilities where it doesn't exist in the release version are allowed at the discretion of the active developer (or Revision vote if the developer is inactive). Utilities such as easy weapon select, in game maps, new minor upgrades or abilities, improved controls, faster movement.<ul> <li>Example: Castlevania 2: Improved Controls for Castlevania 2: Simon's Quest</li> </ul> </li> <li>Utilities and bug-fix hacks that improve or patch glitches found in the released version of games are allowed at the discretion of the active developer (or Revision vote if the developer is inactive).<ul> <li>Example: Sonic 1 Bugfix for Sonic the Hedgehog</li> <li>Example: Double Dragon III - Difficulty Fix for Double Dragon III - The Sacred Stones</li> </ul> </li> <li>Cosmetic bug fixes which don't alter gameplay might be allowed, see cosmetic/sprite hacks.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#beta-release-prototype-and-testing-hacks","title":"Beta Release, Prototype and \"Testing\" Hacks","text":"<p>Usually not allowed</p> <p>If a rom hack is incomplete or in a beta/prototype/testing state with potential game-breaking glitches, crashes, or bugs, intact as a result of hacking, it is usually not allowed.</p> <p>Examples:</p> <ul> <li>List of abandoned incomplete hacks</li> <li>Pokemon LeafYellow Beta 1.3 for Pokemon FireRed</li> <li>Fire Emblem TSS Hack INCOMPLETE testing for Fire Emblem: The Sacred Stones</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#translation-patches","title":"Translation Patches","text":"<p>Usually allowed</p> <p>English is the Primary language of RetroAchievements. Translation Patches are sometimes applied by developers to non-English titles as the main MD5 for an achievement set where no licenced English version exists. In these cases patching instructions will be provided in the forum thread of that title.  Providing an up-to-spec translation patch for an existing title is usually allowed to make a game more accessible to other native language speakers.  You must deep-memory inspect your translation contribution against the core set and submit it for approval before handing it over to the developer of the set for posting in their thread along with the game.</p> <p>Sometimes translation patches may critically differ from the developer MD5 in memory differences that you may find online.  Before linking these patches check with the original developer or do deep memory tests to ensure total compatibility. You can link translation patches you find online to core sets as long as the game's core achievements all function correctly and do not make the game more or less difficult.</p> <p>Tip: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</p> <p>Examples:</p> <ul> <li>Bahamut Lagoon, T+Eng1.3-Copier_DeJap; Japanese to English translation for Bahumut Lagoon</li> <li>Clock Tower, T+Eng1.01_Aeon Genesis; Japanese to English translation for Clock Tower</li> <li>Chrono Trigger, T+Rus_Chief-NET; English to Russian Translation for Chrono Trigger</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#cosmetic-hacks","title":"Cosmetic Hacks","text":"<p>Usually allowed</p> <ul> <li>Cosmetic / Sprite hacks that do nothing to change the original game other than its graphics are not allowed to become their own set. They may be a little fun experience but they are still the same game. When linked they will be linked to the primary set.</li> </ul> <p>Examples:</p> <ul> <li>Castlevania - High Budget Remake for Castlevania (NES)</li> <li>Super Waluigi 64 for Super Mario 64</li> <li>Chrono Trigger MSU-1 (with FMV's) for Chrono Trigger</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#consultation","title":"Consultation","text":"<p>Consult the community via the forum and Discord for review and approval.  You can get a good view-port of what the community likes to see by asking.  Asking for approval before linking is an integral Developer practice, and falls within your code of conduct as a developer here at RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-03 20:09] televandalist:</code> Updated Achievements for ROM hacks (markdown)</li> <li><code>[2023-06-05 21:43] televandalist:</code> Updated Achievements for ROM hacks (markdown)</li> <li><code>[2021-03-01 01:06] televandalist:</code> Removed section about using cosmetic patches for Bonus sets. It's not a good practice and should have been in the Bonus set guide anyway.</li> <li><code>[2020-07-06 09:53] meleu:</code> markdown fix</li> <li><code>[2020-02-17 05:32] meleu:</code> speak with BenGhazi for bonus set patches</li> <li><code>[2019-08-13 19:45] Kvon:</code> Achievements for Romhacks, text hooking tip</li> <li><code>[2019-07-22 17:14] Kvon:</code> minor edit. Changed capitalization</li> <li><code>[2019-07-22 14:38] Kvon:</code> Achievements for romhacks: Added much clarification, more examples, split out \"Beta Release...\" into is own section. Updated what might be allowed to match status quo.</li> <li><code>[2018-09-09 20:27] Kvon:</code> Listed translation patches as possibly allowed</li> <li><code>[2018-02-03 22:10] meleu:</code> changed the title</li> </ul>"},{"location":"AddAddress-Flag/","title":"AddAddress Flag","text":"<p><code>AddAddress</code> modifies the memory address(es) of the following condition by the calculated value. It works similar to <code>AddSource</code>, but modifies the address, not the resulting value. Additionally, it affects addresses on both sides of the condition.</p> <p><code>AddAddress</code> only affects the next condition. If multiple <code>AddAddress</code> lines are chained together, each lookup in the chain will be altered; the values won't all be added to the final lookup.</p> <p></p> <p>The 32-bit value at 0x0112F8 is a pointer to the data for the first character in the party. When the party order changes, the pointer will point at a different block of memory, but data within the block will have the same structure.</p> <ul> <li>The value is an address in the actual system representation and differs from the addresses provided by the memory inspector. However, you can rely on the fact that the memory inspector represents the same memory, so while the actual address may differ, the sequence of bytes does not.</li> </ul> <p>To translate the real pointer to a memory inspector address, we compare the two values. For example:</p> <ul> <li>The 32-bit value at 0x0112F8 is 0x800110B8.</li> <li>The memory we're interested in is at 0x011114 in the memory inspector.</li> <li>Using a 24-bit read instead of a 32-bit read gives us 0x0110B8</li> <li>0x011114 - 0x0110B8 = 0x00005C, so that becomes the \"base address\" in the second condition.</li> </ul>"},{"location":"AddAddress-Flag/#types-of-pointers","title":"Types of Pointers","text":"<p><code>AddAddress</code> is how RAIntegration handles pointers. There are four major types of pointer support:</p> <p>Direct Pointer: The pointer contains another address that is referenced without modification. These are most commonly used for string pointers. To use a direct pointer, the base address to which the pointer is added would be 0.</p> <p>Indirect Pointer: The pointer contains another address that indicates the start of some block of data. The data of interest is a fixed number of bytes into the block of data. These are commonly used for attributes of a character/object.</p> <p>For both Direct and Indirect Pointers, the <code>AddAddress</code> line should reference the pointer, and the address in the following line should be the offset into the block of data for the information relevant to the condition. While you would typically use 0 for a Direct Pointers, the following line would also contain any value necessary to convert between a real address and a memory inspector address.</p> <p>The example above is an Indirect Pointer, where the data is 0x5C bytes into a block of data. The conversion from a real address to a memory inspector address is handled by using a 24-bit read instead of a 32-bit read.</p> <p>Array Index: The pointer contains an offset to apply to a fixed pointer.</p> <p>Scaled Array Index: The pointer contains an offset to apply to a fixed pointer after it has been scaled.</p> <p>For Array Indices, the <code>AddAddress</code> line should reference the offset to apply, and the following line should contain the address of the first element of the array (index 0). For example:</p> <pre><code>AddAddress 16-bit Mem 0x1234\n           8-bit  Mem 0x4567\n</code></pre> <p>Would read a 16-bit number from 0x1234 and read the single byte that is that many bytes after 0x4567.</p> <p>To scale an array index, click on the space in the Cmp column for the array index address and select the <code>*</code> symbol. Then enter the size of each array item in the second mem/val column. For example:</p> <pre><code>AddAddress 16-bit Mem 0x1234 * Value 4\n           8-bit  Mem 0x4567\n</code></pre> <p>Would read a 16-bit number from 0x1234, multiply it by 4, and read the single byte that is that many bytes after 0x4567.</p>"},{"location":"AddAddress-Flag/#chaining-pointers","title":"Chaining Pointers","text":"<p><code>AddAddress</code> can be chained to perform multi-step lookups, but only one step at a time. As such, you can reference data pointed at by a pointer that's pointed at by another pointer, but you can't reference data in an array that's pointed at by another pointer unless either the array or the array index is at a fixed address.</p>"},{"location":"AddAddress-Flag/#using-delta-with-chained-pointers","title":"Using Delta with Chained Pointers","text":"<p>To do a delta check on an <code>AddAddress</code> chain, you should only put the delta on the final condition. You want to use the current value for each step of the chain to derive the final result, and you only care about the changes in the final value. Using previous values for the pointers will have you reading invalid memory and will likely cause problems.</p> <pre><code>A) AddAddress Mem   0000\nB) AddAddress Mem   0000\nC)            Delta 0000\n</code></pre> <p>Assuming Mem: $0000=0, $0001=2, and $0002=4, this will evaluate to 0 for the first few frames, and when Mem 0 changes to 1, the following happens:</p> <pre><code>Frame N  : A = Mem[0] = 1 (delta[0] = 0), B = Mem[A] = Mem[1] = 2 (delta B = 0), C = Mem[B] = Mem[2] = 4 (delta C = 0)\nFrame N+1: A = Mem[0] = 1 (delta[0] = 1), B = Mem[A] = Mem[1] = 2 (delta B = 2), C = Mem[B] = Mem[2] = 4 (delta C = 4)\n</code></pre> <p>You can see the entire delta chain updates in the same frame (one frame after the change occurs).</p> <p>If you use Delta for A and B, something different happens:</p> <pre><code>A) AddAddress Delta 0000\nB) AddAddress Delta 0000\nC)            Delta 0000\n</code></pre> <pre><code>Frame N  : Mem[0] = 1 (delta[0] = 0), B = Mem[deltaA] = Mem[0] = 1 (delta B = 0), C = Mem[deltaB] = Mem[0] = 1 (delta C = 0)\nFrame N+1: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 1), C = Mem[deltaB] = Mem[1] = 2 (delta C = 1)\nFrame N+2: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 2), C = Mem[deltaB] = Mem[2] = 4 (delta C = 2)\nFrame N+3: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 2), C = Mem[deltaB] = Mem[2] = 4 (delta C = 4)\n</code></pre> <p>Not only does it take two extra frames for delta C to be correct, it has two intermediate values that are not correct. The value went from 0 to 4 in a single frame and never was 1 or 2. </p>"},{"location":"AddAddress-Flag/#calculating-your-offset","title":"Calculating your offset","text":"<p>Once you think that you've found your data and something that points at (or near) your data, you need to calculate the offset to use to read that data. * 32-bit data at <code>0x821448</code> (RetroAchievements address) * Pointer at <code>0xA1CA14</code> (RetroAchievements address) (value is <code>0x8C821440</code>)</p> <p>First, determine how much of the pointer you need. For a system with 16MB of RAM, you need 24-bits to address it all (2^24 = 16777216). For 32MB, you'd need 25-bits. For 8MB, you'd only need 23-bits.</p> <p>For the data provided above, we have 16MB of memory, so we only need 24-bits of the pointer (<code>0x8C821440</code> &amp; <code>0x00FFFFFF</code> = <code>0x821440</code>)</p> <p>Then, subtract that value from the data address to calculate the offset: <code>0x821448</code> - <code>0x821440</code> = <code>0x000008</code></p> <p>Now, you can construct the logic. Place the pointer address and size/mask in the <code>AddAddress</code> condition and the offset/logic in the second line:</p> <pre><code>AddAddress Mem 24-bit 0x00A1CA14\n           Mem 32-bit 0x00000008 &lt; 1000\n</code></pre> <p>Executing this example with the provided data: * Read 24-bit data at <code>0x00A1CA14</code>: <code>0x00821440</code> * Add the offset: <code>0x00821440</code> + <code>0x00000008</code> = <code>0x00821448</code> * Read 32-bit data at new address (<code>0x00821448</code>)</p>"},{"location":"AddAddress-Flag/#second-example","title":"Second example","text":"<ul> <li>16-bit data at <code>0x1B385E0</code> (RetroAchievements address)</li> <li>Pointer at <code>0xE7B054</code> (RetroAchievements address) (value is <code>0x09B42F0C</code>)</li> <li>System has 32MB of RAM (25 bits needed) <code>0x09B42F0C</code> &amp; <code>0x01FFFFFF</code> = <code>0x1B42F0C</code></li> <li>Calculate offset: <code>0x1B385E0</code> - <code>0x1B42F0C</code> = <code>0xFFFFFFFFFFFF56D4</code> (truncate to 32-bits: <code>0xFFFF56D4</code>)</li> <li>Construct the logic:   <code>AddAddress Mem 32-bit 0x00E7B054 &amp; 0x1FFFFFF              Mem 16-bit 0xFFFF56D4 = 0x0E</code></li> </ul> <p>In this case, the pointer is actually pointing backwards, so the offset is a really big number. That's how computers represent negative values. Due to the rules of twos-compliment and overflow, you can add the really big number to perform subtraction. Executing this example with the provided data: * Read 32-bit data at <code>0x00E7B054</code>: <code>0x09B42F0C</code> * Mask off 25-bits: <code>0x09B42F0C</code> &amp; <code>0x01FFFFFF</code> = <code>0x01B42F0C</code> * Add the offset: <code>0x1B42F0C</code> + <code>0xFFFF56D4</code> = <code>0x101B385E0</code> (truncated to 32-bits: <code>0x01B385E0</code>) * Read 16-bit data at new address (<code>0x01B385E0</code>)</p>"},{"location":"AddAddress-Flag/#video-tutorial","title":"Video Tutorial","text":"<p>The experienced achievement creator wilhitewarrior made a nice video showing how to work with pointers and AddAddress flag.</p> <p>You can check it here: https://www.youtube.com/watch?v=_gk0vYYlm-E.</p>"},{"location":"AddAddress-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-01-26 08:53] Jamiras:</code> add calculating offset section</li> <li><code>[2021-10-06 19:35] Jamiras:</code> Updated AddAddress Flag (markdown)</li> <li><code>[2021-08-08 18:59] Jamiras:</code> update for scaled array index support</li> <li><code>[2020-08-05 02:06] meleu:</code> cosmetic</li> <li><code>[2020-08-05 01:58] meleu:</code> add link to wilhitewarrio's video tutorial</li> <li><code>[2019-11-17 22:18] meleu:</code> fix markdown formats</li> <li><code>[2019-11-16 07:53] Jamiras:</code> Updated AddAddress Flag (markdown)</li> <li><code>[2019-11-14 20:25] Jamiras:</code> Created AddAddress Flag (markdown)</li> </ul>"},{"location":"AddHits-Flag-es/","title":"Bandera AddHits","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>La bandera de <code>AddHits</code> puede ser seleccionada en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Cuando una condicion con la bandera de <code>AddHits</code> es verdadera, el contador de hits (hit count) de la siguiente condicion sin el <code>AddHits</code> es incrementada.</p> <p>Si la siguiente condicion si el <code>AddHits</code> no tiene un numero de hits especificos (hit target), la condicion <code>AddHits</code> no tiene un efecto en el logro.</p> <p>La condicion <code>AddHits</code> no tiene que ser verdadera para el logro se dispare, pero la siguiente condicion sin el <code>AddHits</code> si tiene que serlo, que es afectada por la condicion que si tiene el <code>AddHits</code>.</p>"},{"location":"AddHits-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:01] meleu:</code> Updated AddHits Flag ES (markdown)</li> </ul>"},{"location":"AddHits-and-SubHits-Flag/","title":"AddHits and SubHits Flag","text":"<p>NOTE: This technique is not needed for simple games, so it is not mandatory for jr-devs.</p> <p><code>AddHits</code> and <code>SubHits</code> can be chosen in the Flag column of the Achievement Editor.</p> <p>The <code>AddHits</code>/<code>SubHits</code> conditions do not have to be true for the achievement to trigger. They modify the hit count of another condition, which does have to be true for the achievement to trigger. The sequence of conditions is referred to as a <code>AddHits</code> chain (even if it contains <code>SubHits</code>).</p> <p>When a condition with the <code>AddHits</code>/<code>SubHits</code> flag is true, the hit count for that condition is incremented. A hit target may be placed on the condition to keep it from tallying too many times.</p> <p>The total hit count of the final condition in a chain is incremented by the hit counts of any <code>AddHits</code> conditions in the chain, and decremented by any <code>SubHits</code> conditions in the chain. If the total hit count meets or exceeds the target hit count of the final condition, it's considered true.</p> <p>If the final condition of the chain does not have a hit target, the <code>AddHits</code>/<code>SubHits</code> conditions have no effect on the achievement. The final condition will be true if, and only if, it is true by itself.</p> <p>NOTE: The hit target on the final condition of the chain serves as both the overall target hit count and the maximum hit count for that condition. As a result, it is impossible to use <code>SubHits</code> without <code>AddHits</code>, as any hits subtracted by the <code>SubHits</code> could not be recovered without a separate <code>AddHits</code>. Similarly, if you need to put a condition-specific limit on the final condition of the chain, you should pull it out as an <code>AddHits</code> condition with the appropriate limit and use a dummy final condition with the overall hit target (i.e. <code>0=1 (10)</code>). The dummy condition would never accumulate any hits of its own, and only serve to tally the other values in the chain.</p>"},{"location":"AddHits-and-SubHits-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-30 12:40] Jamiras:</code> Updated AddHits Flag (markdown)</li> </ul>"},{"location":"AddSource-Flag-es/","title":"Bandera AddSource","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>Un <code>AddSource</code> puede ser seleccionado en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Cuando una condicion tiene la bandera de <code>Add Source</code>, el valor de esa variable es a\u00f1adido al valor de la variable de la condicion de abajo, y la comparacion es hecha en la condicion que se encuentra abajo de la que si tiene la bandera de  <code>Add Source</code>. Puede sonar un poco confuso, pero el ejemplo de aqui abajo va a aclarar como funciona:</p> <p></p> <p>En este ejemplo el valor en <code>0x8010</code> va a ser agregado a el valor en <code>0x8020</code> y la comparacion es si la suma es mas grande que cero.</p> <p>Si el valor en <code>0x8010</code> es <code>1</code> y el valor en <code>0x8020</code> is <code>2</code>, la comparacion seria <code>1 + 2 &gt; 0</code>, o <code>3 &gt; 0</code>.</p> <p>Nota:  Todo lo que este en los campos de comparacion (Cmp) en una condicion con una bandera de <code>Add Source</code> son ignorados.</p> <p>Intentando resumir la explicacion con una imagen:</p> <p></p> <p>Nota: puedes utilizar la bandera <code>Add Source</code> para sumar mas variables, como en el siguiente ejemplo:</p> <p></p>"},{"location":"AddSource-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:00] meleu:</code> Updated AddSource Flag ES (markdown)</li> </ul>"},{"location":"AddSource-Flag/","title":"AddSource Flag","text":"<p>Note: most likely this technique is not needed for simple games. So, it's not mandatory for jr-devs.</p> <p>The <code>AddSource</code> can be chosen in the Flag column of the Achievement Editor</p> <p>When a condition has the <code>Add Source</code> flag, the value on that memory address is added to the accumulator. When a condition is reached that does not modify the accumulator, the accumulator is added to value of the address on that condition before the comparison is made, and the accumulator will be reset to 0. It may sound a bit confusing, but the example below will clarify how this works:</p>"},{"location":"AddSource-Flag/#simple-example","title":"Simple example","text":"ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>In this example the value in <code>0x8010</code> will be added to the value in <code>0x8020</code> and the comparison will check is if this sum is greater than four.</p> <p>If the value in <code>0x8010</code> is <code>1</code> and the value in <code>0x8020</code> is <code>2</code>, the comparison will be <code>1 + 2 &gt; 4</code>, or <code>3 &gt; 4</code>.</p> <p>Trying to summarize the explanation in an image:</p> <p></p>"},{"location":"AddSource-Flag/#chaining","title":"Chaining","text":"<p>You can use the <code>Add Source</code> flag to sum more addresses, like in the example below:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 AddSource Mem 8-bit 0x8011 3 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>This represents <code>value(0x8010) + value(0x8011) + value(0x8020) &gt; 4</code>.</p>"},{"location":"AddSource-Flag/#independence","title":"Independence","text":"<p>The accumulator is reset after its used, so you can have multiple <code>AddSource</code> chains in one trigger without having to worry about them interfering with each other.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) 3 AddSource Mem 8-bit 0x8030 4 Mem 8-bit 0x8040 &lt; Value 0x80 0 (0) <p>This represents <code>value(0x8010) + value(0x8020) &gt; 4 AND value(0x8030) + value(0x8040) &lt; 0x80</code>.</p>"},{"location":"AddSource-Flag/#overflow","title":"Overflow","text":"<p>The accumulator and all logic being performed is limited to 32-bits. If the total value exceeds 0xFFFFFFFF, there will be an overflow and only the 32 least significant bits will be used in the comparison.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 32-bit 0x8010 2 Mem 32-bit 0x8020 &gt; Value 0x30000000 0 (0) <p>If 0x8010 is 0xC0000000 and 0x8020 is 0x54321ABC, then the total will be 0x114321ABC, which is more than 32-bits and will be truncated to 0x14321ABC, which is not more then 0x30000000, so the logic will evaluate false.</p>"},{"location":"AddSource-Flag/#using-modifiers","title":"Using Modifiers","text":"<p>Additionally, you can use AddSource to modify a value. By clicking on the \"Cmp\" column, a dropdown will open with three operators: <code>*</code>, <code>/</code>, and <code>&amp;</code>. This allows you to modify the value before adding it to the accumulator.</p> <p><code>*</code>: Multiply the left side by the right side.   - <code>AddSource 8-bit Mem 0x8010 * Value 0x14</code> would read the 8-bit value from $8010, multiply it by 20 (0x14 hex) and then add that to the accumulator.</p> <p><code>/</code>: Divide the left side by the right side.   - <code>AddSource 8-bit Mem 0x8010 / Value 0x14</code> would read the 8-bit value from $8010, divide by 20 (rounding down) and then add that to the accumulator.</p> <p><code>&amp;</code>: Bitwise-mask the left side with the right side.   - <code>AddSource 8-bit Mem 0x8010 &amp; Value 0x3f</code> would read the 8-bit value from $8010, discard bits 6 and 7 (0x3f is 00111111 in binary) and then add that to the accumulator.</p> <p>You can use memory references on the right side as well. <code>AddSource 8-bit Mem 0x8010 * 8-bit Mem 0x8011</code> would read the two 8-bit values, multiply them together, and add that to the accumulator.</p>"},{"location":"AddSource-Flag/#interaction-with-floats","title":"Interaction with floats","text":"<p>The accumulator is typed based on the first thing added to it. If the first <code>AddSource</code>/<code>SubSource</code> of a chain is an integer, the accumulator will be an integer and any floats added to the accumulator will be floored before they're added to the accumulator. If the first <code>AddSource</code>/<code>SubSource</code> of a chain is a float, the accumulator will be a float and any integers added to the accumulator will be converted to floats before they're added to the accumulator.</p> <p>Note that when the accumulator is added to the final condition, the type of the final condition is used. So if the final condition is float and the accumulator is an integer, the accumulator will be converted to a float before it's added to the final condition.</p> <p>To force all floats in an <code>AddSource</code> chain to be floored, you need an extra first and last condition:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Value 0 2 AddSource Mem Float 0x1000 3 AddSource Mem Float 0x1004 4 AddSource Mem Float 0x1008 5 Value 0 &gt; Value 12 0 (0) <p>Line 1 primes the accumulator as an integer, so lines 2-4 will be floored before they're added to the accumulator. Line 5 ensures the final value is an integer before doing the comparison. Without line 1, lines 2-4 would be accumulated as floats. Without line 5, the accumulator would be added to the last float without it being floored.</p>"},{"location":"AddSource-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-02 07:13] Jamiras:</code> add interaction with floats section</li> <li><code>[2021-11-27 08:38] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:20] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:17] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:14] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2019-02-12 09:37] meleu:</code> Updated AddSource (markdown)</li> </ul>"},{"location":"Alt-Groups-es/","title":"Alt Groups","text":"<p>Un logro puede tener grupos agregados a el que permiten requisitos alternativos para que el logro se desbloquee. A esto se le conoce como Alt Groups, (Grupos Alternativos)</p> <p>Cuando utilizamos Alt groups, para que se dispare un logro, todas las condiciones en Core group TIENEN que ser verdaderas. Y as\u00ed tambi\u00e9n todas las condiciones de CUALQUIER Alt group tienen que ser verdaderas. En otras palabras, cada Alt group utiliza la logica <code>OR</code>.</p>"},{"location":"Alt-Groups-es/#ejemplo","title":"Ejemplo","text":"<p>En este simple ejemplo para Contra (NES) el logro requiere, \"En un Stage mira hacia arriba o ag\u00e1chate.\" Veamos que hay en el Core group y en los Alt groups: </p> <p> En el grupo core: <code>0x18 = 5</code>. Esto checa si el jugador se encuentra en un Stage.</p> <p> En <code>Alt 01</code>: <code>0xbc = 1</code>. Esto checa si el jugador esta viendo hacia arriba.</p> <p> En <code>Alt 02</code>: <code>0xbc = 2</code>. Esto checa si el jugador esta agachado.</p> <p>Mientras el jugador se encuentre en un stage. El grupo core es verdadero. Si el jugador mira hacia arriba, Alt 01 es verdadero. Si el jugador se agacha, Alt 02 es verdadero. Si core + Alt 01 \u00d3 Alt 02 es verdadero, este logro se dispararia.</p>"},{"location":"Alt-Groups-es/#datos-sobre-los-alt-groups","title":"Datos sobre los Alt Groups","text":"<ul> <li>Para a\u00f1adir o remover Alt groups haz click en el boton <code>+</code> o <code>-</code> en la parte inferior izquierda del editor de logros (achievement editor). </li> </ul> <ul> <li>Si quieres simplemente checar ESTE <code>O</code> ESO puedes dejar el core group en blanco y a\u00f1adir ESTE en <code>Alt 01</code>, y ESO en <code>Alt 02</code>.</li> </ul> <ul> <li>No importa cuantos <code>Alt groups</code> tenga un logro, si el grupo Core es verdadero, solo un Alt tiene que ser verdadero para que el logro se dispare.</li> </ul> <ul> <li>Cuando utilizamos un ResetIf y PauseIf, el PauseIf solo pausa el grupo en el que se encuentre, pero el ResetIf resetea los hit counts en todos los grupos e impide que el logro se dispare mientras el reset se encuentre activado.</li> </ul>"},{"location":"Alt-Groups-es/#utilizando-alt-groups-para-resets-condicionales","title":"Utilizando Alt Groups para Resets Condicionales","text":"<p>Avanzado: Un Alt group puede ser utilizado para crear una condici\u00f3n ResetIf que solo se activa por cierto tiempo.</p> <p>Si tu creas un Alt group que contenga una condici\u00f3n PauseIf y una condicion ResetIf, puedes utilizar la condici\u00f3n PauseIf para pausar la condici\u00f3n ResetIf sobre ciertas circunstancias y sin deshabilitar todo el logro. - Un Reset afecta a todos los grupos, incluyendo el grupo core. El Pause solo pausara el Alt group que contenga el PauseIf. - Esta l\u00f3gica puede ser aplicada a m\u00faltiples Alt groups en el mismo logro para proteger varios Reset de ser disparados por separado.  - Ten en cuenta de tener m\u00ednimo un Alt group que sea verdadero o el logro no se disparara. La manera mas facil de hacer esto es crear un alt group extra que tenga una condici\u00f3n que sea <code>Valor 1 = Valor 1</code>. - Cuidado: Si tu condici\u00f3n Pause es falsa, y la condici\u00f3n Reset tambi\u00e9n es falsa, el grupo va a ser considerado como verdadero al menos que tengas otra condici\u00f3n falsa en el grupo. Cuando utilizamos un Alt group para segregar un PauseIf, ten en cuenta de incluir siempre una condici\u00f3n que sea falsa como <code>Valor 1 = Valor 0</code>.</p>"},{"location":"Alt-Groups-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Alt-Groups/","title":"Alt Groups","text":"<p>Achievements can have groups added to them that allow for alternative requirements to unlock an achievement. These are called Alt Groups,</p> <p>When using Alt groups, for the achievement to trigger, all the conditions in the Core group MUST be true. And then all the conditions of ANY Alt group must be true. In other words, each Alt group uses <code>OR</code> logic.</p>"},{"location":"Alt-Groups/#example","title":"Example","text":"<p>In this dummy example for Contra (NES) the achievement requires, \"While on stage look up or crouch.\" Lets look at what's in the Core group and in the Alt groups: </p> <p> In the core group: <code>0x18 = 5</code>. This checks that the player is on stage.</p> <p> In <code>Alt 01</code>: <code>0xbc = 1</code>. This checks that the player is looking up.</p> <p> In <code>Alt 02</code>: <code>0xbc = 2</code>. This checks that the player is crouching.</p> <p>As long as the player is on stage. The core group is true. If the player looks up, Alt 01 is true. If the player crouches, Alt 02 is true. If core + Alt 01 OR Alt 02 are true, the achievement will trigger.</p>"},{"location":"Alt-Groups/#facts-about-alt-groups","title":"Facts about Alt Groups","text":"<ul> <li>To add or remove Alt groups click the <code>+</code> or <code>-</code> button in the bottom left of the achievement editor. </li> </ul> <ul> <li>If you want to simply test for this <code>OR</code> that you can leave the core group blank and add this in <code>Alt 01</code>, and that in <code>Alt 02</code>.</li> </ul> <ul> <li>No matter how many <code>Alt groups</code> an achievement has, if the Core group is true, only one Alt has to be true for the achievement to trigger.</li> </ul> <ul> <li>When using ResetIf and PauseIf, PauseIf only pauses the group that it's in, but ResetIf resets hit counts in all groups and prevents achievements from triggering so long as the reset is active.</li> </ul>"},{"location":"Alt-Groups/#using-alt-groups-for-conditional-resets","title":"Using Alt Groups for Conditional Resets","text":"<p>Advanced: An Alt group can be used to create a ResetIf condition that is only active some of the time.</p> <p>If you create an Alt group containing a PauseIf condition and a ResetIf condition, you can use the PauseIf condition to disable the ResetIf condition under certain circumstances without disabling the entire achievement.</p> <ul> <li>The Reset will still affect all groups, including your core group. The Pause will only pause the Alt group containing the PauseIf.</li> </ul> <ul> <li>This logic can be applied to multiple Alt groups in the same achievement to protect several separate Reset statements.</li> </ul> <ul> <li>Make sure that you have at least one Alt group that will be true or the achievement won't trigger. The easiest way to do this is to create an extra alt group that has one condition that is <code>Value 1 = Value 1</code>.</li> </ul> <ul> <li>Beware: If your Pause condition is false, and the Reset condition is also false, the group will be considered true unless you have another always false condition in the group. When using an Alt group to segregate a PauseIf, make sure to include an always false condition like <code>Value 1 = Value 0</code>.</li> </ul>"},{"location":"Alt-Groups/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-06-18 15:48] Jamiras:</code> add whitespace so bullets are joined when document is published</li> <li><code>[2019-03-07 21:00] Jamiras:</code> Updated Alt Groups (markdown)</li> <li><code>[2019-02-12 09:38] meleu:</code> Created Alt Groups (markdown)</li> </ul>"},{"location":"AndNext-and-OrNext-Flags/","title":"AndNext and OrNext Flags","text":"<p><code>AndNext</code> and <code>OrNext</code> are used to associate more than one condition to a ResetIf, PauseIf, or Hit Count.</p> <p><code>AndNext</code> and <code>OrNext</code> can be chosen in the Flag column of the Achievement Editor</p> <p>When a condition has the <code>AndNext</code> flag, the condition must be true in addition to the following condition for the following condition to be considered true. </p> <p>When a condition has the <code>OrNext</code> flag, the condition or the following condition must be true for the following condition to be considered true.</p> <p>You can chain multiple <code>AndNext</code> and <code>OrNext</code> conditions to create complex requirements for a single <code>ResetIf</code>, <code>PauseIf</code>, or <code>Hit Count</code>.</p> <p>When evaluating a combination of <code>AndNext</code> and <code>OrNext</code> conditions, each line is evaluated individually.</p> <pre><code>AndNext A=1\nOrNext  B=1\nAndNext C=1\nOrNext  D=1\nAndNext E=1\nResetIf F=1\n</code></pre> <p>Represents the following logical statement:</p> <pre><code>reset if (((((A = 1 &amp;&amp; B = 1) || C = 1) &amp;&amp; D = 1) || E = 1) &amp;&amp; F = 1)\n</code></pre> <p>Alt Groups are still preferred over <code>OrNext</code> for most use cases. They allow for multiple conditions to be present in each clause of the OR, and support more than two clauses.</p> <p><code>AndNext</code> is not required for simple logic. All conditions in a group are automatically AND'd together. <code>AndNext</code> just allows for two or more conditions to affect a single <code>PauseIf</code>, <code>ResetIf</code>, or <code>Hit Count</code>.</p>"},{"location":"AndNext-and-OrNext-Flags/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-01-25 13:18] meleu:</code> fix markdown links</li> <li><code>[2020-05-17 14:01] Jamiras:</code> update title</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/","title":"Creaci\u00f3n de Iconos y Badges","text":"<p>Tabla de Contenidos - Iconos de Juegos    - Dise\u00f1ando mis nuevos iconos - gu\u00eda est\u00e9tica       - Flexibilidad para la gu\u00eda est\u00e9tica       - Tengo que seguir esta gu\u00eda de est\u00e9tica?    - Otros Tips de Dise\u00f1o de Iconos       - Archivo y Tama\u00f1o del Icono - mejores practicas    - Subiendo Iconos de juegos (Desarrollador)    - Subiendo Iconos de Juegos (no-Desarrollador)    - Game Icon Gauntlet       - Reglas para proponer un nuevo icono de juego       - La votaci\u00f3n en Icon Gauntlet    - Que pasa con la imagen cuando subes el icono de un juego    - Servidores de los Archivos de Iconos - Badges de Logros    - Gu\u00edas y Tips en la Creaci\u00f3n de Badges       - Tama\u00f1o y Archivo del Badge - mejores practicas    - Subiendo un Badge (Desarrollador)    - Subiendo un Badge (No-Desarrollador)    - Que pasa con la imagen cuando subes un Badge    - Servidor de los archivos de Badges - Donde se muestran los Badges e Iconos</p>"},{"location":"Badge-and-Icon-Creation-es/#iconos-de-juegos","title":"Iconos de Juegos","text":"<p>Los Iconos son im\u00e1genes subidas por el usuario que sirven para representar a un juego por medio de la pagina. Debido a la prominencia en las pagina de juego y de usuarios estas reciben una atenci\u00f3n especial.</p> <ul> <li> <p>Icono en Sonic the Hedgehog's </p> <p> </p> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#disenando-mis-nuevos-iconos-guia-estetica","title":"Dise\u00f1ando mis nuevos iconos - gu\u00eda est\u00e9tica","text":"<p>Cuando dise\u00f1es el nuevo icono de un juego considera los siguientes puntos: La mayor\u00eda de la comunidad prefiere que los iconos utilicen el artwork original del juego; - que se encuentre dentro del juego,  - o en documentos del juego,  - o en el manual,  - o material promocional, - y un sin fin; arte creado por el equipo original.</p> <p>Utilizar dise\u00f1os mas actuales (o fan art) para personajes cl\u00e1sicos de v\u00eddeo juegos tal vez parezca prudente. Pero varios podr\u00edan encontrar esto como irrespetuoso al material original.</p> <p></p>"},{"location":"Badge-and-Icon-Creation-es/#flexibilidad-para-la-guia-estetica","title":"Flexibilidad para la gu\u00eda est\u00e9tica","text":"<ul> <li>Para juegos no licenciados o <code>~hacks~</code>donde hay muy poco material original disponible, utilizar arte no-official podr\u00eda ser razonable.</li> <li>Hacer modificaciones a los assets de arte disponibles usualmente es razonable.</li> <li>Utilizar assets de fuera o hechos a mano, digamos un titulo o un borde, mientras tanto el tema principal sea el arte oficial tambi\u00e9n es razonable.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#tengo-que-seguir-esta-guia-de-estetica","title":"Tengo que seguir esta gu\u00eda de est\u00e9tica?","text":"<p>El estilo que escoges para tus dise\u00f1os ya depende de ti. Puedes romper estas reglas siempre y cuando no rompas alguna lei de copyright, o subas algo vulgar, ofensivo o pornogr\u00e1fico.</p>"},{"location":"Badge-and-Icon-Creation-es/#otros-tips-de-diseno-de-iconos","title":"Otros Tips de Dise\u00f1o de Iconos","text":"<ul> <li>Checa la lista de juegos, para encontrar iconos que resuenen contigo. Simulalos e innova los estilos de tus favoritos.</li> <li>Mucho de los tips de creaci\u00f3n de Medallas aplican aqu\u00ed tambi\u00e9n.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#archivo-y-tamano-del-icono-mejores-practicas","title":"Archivo y Tama\u00f1o del Icono - mejores practicas","text":"<ul> <li>Los logros que se suban tienen que ser cuadrados (tener las misma dimensiones X y Y), de otra manera la imagen resultar\u00eda distorsionada y fea.</li> <li>Sube im\u00e1genes en formato PNG que no est\u00e9n entrelazadas; evita utilizar capaz de transparencia ya que al final va a salir con un fondo blanco.</li> <li>Dise\u00f1a im\u00e1genes en 96x96 (preferido), 64x64, 48x48 o 32x32 para una calidad mas marcada. Iconos y badges tienen que ser hechos de una manera que sean claros en 32x32 ya que son normalmente reducidas a este tama\u00f1o, como en el feed global de notificaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-iconos-de-juegos-desarrollador","title":"Subiendo Iconos de Juegos (Desarrollador)","text":"<p>Los desarrolladores de logros tienen permitido cambiar iconos de juegos en entradas que no cuenten con logros. Como desarrollador si tu quieres postear un respaldo de la antigua imagen eres libre de hacerlo pero no es realmente un requisito. Mientras creas un nuevo set de logros tu eres libre de crear o escoger que icono quieres para el juego.</p> <p>Para cambiar el Icono de un juego primero ve a la pagina del juego y haz click en Dev tools: </p> <p>Luego haz click en el bot\u00f3n de choose file que se encuentra resaltado. Encuentra el archivo en tu PC, y luego presiona el bot\u00f3n resaltado de submit: </p> <p>Si un juego que ya cuenta con logros el cambio de Icono tiene que pasar por medio de Icon Gauntlet.</p>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-iconos-de-juegos-no-desarrollador","title":"Subiendo Iconos de Juegos (no-Desarrollador)","text":"<p>Si, absolutamente puedes, pero recuerda leer las regla de Icon Gauntlet. Tambien seria bueno darle un vistazo a las reglas de dise\u00f1o para nuevos iconos de juegos.</p>"},{"location":"Badge-and-Icon-Creation-es/#game-icon-gauntlet","title":"Game Icon Gauntlet","text":"<p>El game Icon Gauntlet enfrenta un icono posteado por un usuario en una pelea cara-a-cara con el icono actual. El voto popular es lo que toma lugar en #Icon-Gauntlet este canal de Discord es lo que determina que se queda y que se va. Todos los usuarios verificados de Discord son elegibles de ingresar su voto. Spawncalibur es el administrador en todos los aspectos de esta din\u00e1mica.</p>"},{"location":"Badge-and-Icon-Creation-es/#reglas-para-proponer-un-nuevo-icono-de-juego","title":"Reglas para proponer un nuevo icono de juego","text":"<ul> <li>Cualquier usuario verificado de RetroAchievments puede subir un nuevo icono de juego.</li> <li>Solo proponer iconos para juegos que ya cuentan con logros.</li> <li>Propuestas de iconos tienen que estar relacionadas con el juego, no gr\u00e1ficos nuevos.</li> <li>Recomendado: Iconos se ven mejor creados en 96x96, 64x64 o 32x32. Crea una imagen PNG en formato para mejores resultados.</li> <li>Posteala en este tema del foro.<ul> <li>Para mostrar la imagen apropiadamente posteala utilizando el tag de foro <code>[img=http://YourImageURL.png]</code></li> <li>Deja en claro cual es el juego el cual quieres que tu icono quiere remplazar. (Incluso mejor si utilizas el tag del foro de <code>[game=GameID]</code>. Puedes encontrar el ID del juego viendo el URL de la pagina de este)</li> </ul> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#la-votacion-en-icon-gauntlet","title":"La votaci\u00f3n en Icon Gauntlet","text":"<ul> <li>El voto toma lugar en el canal de Discord de #Icon-Gauntlet y esta abierto a todos los usuarios de Discord Verificados (usuarios de Discord con (nombre verde))</li> <li>Nuevas votaciones son posteadas semanalmente y duran una semana.</li> <li>Se gana por mayor\u00eda de votos.</li> <li>Si pasa un empate van a suceder unas re-votaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#que-pasa-con-la-imagen-cuando-subes-el-icono-de-un-juego","title":"Que pasa con la imagen cuando subes el icono de un juego","text":"<p>Cuando se sube, tu imagen es reducida a un PNG de 32-bits colores y a un tama\u00f1o de 96x96. Si subes un icono que sea mas peque\u00f1o que 96x96 la imagen va a retener su tama\u00f1o original. </p> <p>Lo mismo pasa para los Badges, excepto que el tama\u00f1o maximo para los badges es de 64x64. (El de Imagenes de Perfil es de   128x128.)</p>"},{"location":"Badge-and-Icon-Creation-es/#servidores-de-los-archivos-de-iconos","title":"Servidores de los Archivos de Iconos","text":"<p>Los Iconos son almacenados en el sitio de la siguiente manera y lugar: <code>i.retroachievements.org/Images/000705.png</code>. Ellos son almacenados en el mismo folder donde se almac\u00e9n todas las dem\u00e1s im\u00e1genes como las caratulas y las screenshots por ejemplo. </p>"},{"location":"Badge-and-Icon-Creation-es/#badges-de-logros","title":"Badges de Logros","text":"<p>Los Badges (Emblemas) son las imagenes creadas por el usuario para cada logro en individuo de un juego.</p> <ul> <li>Sonic the Hedgehog's primer Badge - #00199)   ## </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#guias-y-tips-en-la-creacion-de-badges","title":"Gu\u00edas y Tips en la Creaci\u00f3n de Badges","text":"<ul> <li>Los Badges tienen que estar relacionados con lo que se trate el logro - por ejemplo: la foto de un jefe, nivel o coleccionable que requiere que el jugador consiga. </li> <li>Checa dise\u00f1os de varios de tus juegos favoritos. Algunos usuarios ponen un gran esfuerzo en crear badges realmente atractivos:</li> </ul> <ul> <li>Aqu\u00ed esta un tema del foro lleno de grandes tips. </li> <li>En el caso de logros de juegos de muy baja-resoluci\u00f3n, puede ser dificil conseguir que un badge que se mire bien y que este no se mira tosco o borroso, en estos casos un look mas tosco es mucho mas preferible, ya que las im\u00e1genes tiene esa sensaci\u00f3n retro en ellas.</li> <li>Puedes hacer que cada Badge tengan un peque\u00f1os bordes pandeados como un Badge/Emblema actual o algunos bordes extras punteados para mas \u00e9nfasis o una corona de rey para los mas dif\u00edciles.  Es tu dise\u00f1o.  Deber\u00eda de presentar el logro de una manera visual, o que sea una pista para evadir secretos del juego.</li> <li>Estar a la par con el estilo de arte del juego tambi\u00e9n funciona bien. Buscar en Google Image \"Sprite Sheets\" es tambi\u00e9n otro \u00fatil tip para incluir alg\u00fan arte del juego.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#tamano-y-archivo-del-badge-mejores-practicas","title":"Tama\u00f1o y Archivo del Badge - mejores practicas","text":"<ul> <li>Los badges que se suban tienen que ser cuadrados (tener las misma dimensi\u00f3n X y Y), de otra manera la imagen resultar\u00eda distorsionada y fea.</li> <li>Subir im\u00e1genes PNG en formato no-entrelazado; evita utilizar una capa de transparencia ya que va a salir un fondo blanco en el.</li> <li>Dise\u00f1a im\u00e1genes en 64x64, 48x48 o 32x32 por la mejor calidad. Los logros se tienen que hacer de una manera que la tem\u00e1tica se sea clara incluso en 32x32, ya que son reducidas a este tama\u00f1o com\u00fanmente en el sitio, como en el feed global de notificaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-badges-desarrollador","title":"Subiendo Badges (Desarrollador)","text":"<p>Si te encuentras creando logros eres libre de subir badges para ellos. </p> <p>Los Badges se suben con las herramientas de desarrollador del emulador por medio del editor de logros: </p> <p>O tambi\u00e9n puedes seleccionar una imagen prefabricada o encontrar otras im\u00e1genes que haz subido por medio de la lista desglosable: </p> <p>Subir archivos <code>.jpg</code>, <code>.jpg</code> o <code>.gif</code>. No es completamente importante el formato, pero si es completamente recomendable que la imagen sea cuadrada.</p> <p>Si el juego ya cuenta con badges existentes \u00e9chale una checada y sigue el procedimiento para Subiendo Badges (No-Desarrollador).</p>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-badges-no-desarrollador","title":"Subiendo Badges (No-Desarrollador)","text":"<p>Postea todas las im\u00e1genes nuevas que quieres remplazar en el foro oficial del juego. Tambi\u00e9n enlista cuales badges quieres remplazar. Un desarrollador o un moderador va a evaluar tu trabajo y decidir si, s\u00ed ser\u00e1n remplazados. Si as\u00ed lo deciden se posteara un respaldo de los iconos actuales en el foro, y tambi\u00e9n se remplazaran por los nuevos.</p> <p>Este respaldo es necesario si llega a existir el caso en el que hay desacuerdos con los nuevos badges. En estos casos algunos o todos los badges podr\u00edan ser revertidos a los anteriores.</p> <p>Es mas f\u00e1cil hacer una referencia a los viejos y nuevos badges como links de <code>img</code>: - ejemplo: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code> - (Dev) percatate de capturar los antiguos ID de los badges del Editor de Logros antes de subir los nuevos - El ID de los nuevos badges aparecer\u00e1n en el Editor de Logros despu\u00e9s de que sean subidos. - ambos valores tambi\u00e9n pueden ser capturados desde el sitio web, pero tienes que copiar el link de la imagen como el hover link del logro.</p> <p>Aqu\u00ed hay un ejemplo perfecto de como hacer un respaldo apropiado de Badges reci\u00e9n cambiados.</p>"},{"location":"Badge-and-Icon-Creation-es/#que-pasa-con-la-imagen-cuando-subes-un-badge","title":"Que pasa con la imagen cuando subes un Badge","text":"<p>Cuando se sube, tu archivo es convertido a lo siguiente: - 64x64 PNG de 32-bit de color. Ejemplo:</p> <pre><code>![00136](https://user-images.githubusercontent.com/8508804/37221161-b9b0bb02-23a7-11e8-81b2-3d09fa7456af.png)\n</code></pre> <ul> <li>64x64 PNG borroso y con escala de grises. Ejemplo:<p></p> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#servidor-de-los-archivos-de-badges","title":"Servidor de los Archivos de Badges","text":"<p>Estos se almacenan en el sitio de la siguiente manera y lugar: <code>i.retroachievements.org/Badge/00136.png</code>; el numero coincide con el ID de Badges que se encuentra con el Editor de Logros.</p>"},{"location":"Badge-and-Icon-Creation-es/#donde-se-muestran-los-badges-e-iconos","title":"Donde se muestran los Badges e Iconos","text":"<ul> <li>En tablas de Clasificacion: 96x96 (Solamente Iconos)</li> <li>En emuladores de RA: 64x64</li> <li>Paginas de Juego: 64x64</li> <li>Paginas de Usuarios: 48x48</li> <li>Actualmente jugando/Rich Presence y en el Feed Global: 32x32</li> </ul> <p>La im\u00e1genes actuales no se les cambia el tama\u00f1o. La imagen es escalada por el navegador al tama\u00f1o correspondiente. Algunos navegadores como el de Android muestran de una manera mas clara las im\u00e1genes mas grandes. Tambi\u00e9n puedes aumentar el zoom de tu navegador para ver aun mas claro.</p> <p>Se espera que en la versi\u00f3n futura del sitio, los Iconos y Badges se muestren en tama\u00f1o completo en otros lugares.</p>"},{"location":"Badge-and-Icon-Creation-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-15 10:10] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-15 10:06] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-15 09:58] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-12 16:01] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-04-18 17:26] eldexterr:</code> Document created but still not finished</li> </ul>"},{"location":"Badge-and-Icon-Creation-pt_BR/","title":"Cria\u00e7\u00e3o de \u00cdcones e Emblemas","text":"<p>Link para o texto em ingl\u00eas: Badge and Icon Creation</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#introducao","title":"Introdu\u00e7\u00e3o","text":"<p>Emblemas e \u00edcone s\u00e3o usados em todo o site e s\u00e3o uma boa maneira de representar a conquista no jogo.</p> <p>Emblemas s\u00e3o as imagens para os achievements de um jogo. Eles s\u00e3o armazenados no site da seguinte maneira e local: <code>i.retroachievements.org/Badge/00136.png</code>; o n\u00famero coincide com o ID do emblema encontrado no Achievement editor.</p> <p>Os \u00edcones s\u00e3o armazenados no site da seguinte maneira e colocam: <code>i.retroachievements.org/Images/000705.png</code>, armazenados na mesma pasta que outras imagens do jogo, como a caixa do jogo (game box) e screenshots do jogo.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#formato-de-emblema","title":"Formato de Emblema","text":"<p>Quando carregado, seu arquivo \u00e9 convertido no seguinte:</p> <ul> <li>PNG em cores de 32 bits 64x64. Exemplo:</li> </ul> <p></p> <ul> <li>64x64 em escala de cinza e PNG desfocado. Exemplo:</li> </ul> <p></p> <p>N\u00e3o \u00e9 totalmente importante como o arquivo \u00e9 formatado antes do upload, mas, desde que seja quadrado, o arquivo ser\u00e1 carregado e convertido facilmente. Naturalmente, \u00e9 importante n\u00e3o infringir nenhuma lei de direitos autorais ou fazer upload de algo vulgar, ofensivo ou pornogr\u00e1fico, com as poss\u00edveis consequ\u00eancias de ser advertido, potencialmente reportado e potencialmente removido da RetroAchievements.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#formato-de-icone","title":"Formato de \u00edcone","text":"<p>Quando carregadas, as imagens do seu \u00edcone s\u00e3o reduzidas para um PNG em cores de 32 bits 96x96 no m\u00e1ximo. Se voc\u00ea fizer o upload de um \u00edcone menor que 96x96, a imagem enviada manter\u00e1 seu tamanho original.</p> <p>O mesmo vale para os emblemas, exceto que o tamanho m\u00e1ximo dos emblemas \u00e9 64x64. (O m\u00e1ximo de imagens do perfil \u00e9 128x128.)</p> <p>Lugares e tamanhos Os \u00edcones s\u00e3o exibidos:</p> <ul> <li>Nas tabelas de classifica\u00e7\u00e3o: 96 x 96</li> <li>P\u00e1ginas de Jogo: 64x64</li> <li>P\u00e1ginas de Usu\u00e1rio: 48x48</li> <li>Jogando Atualmente e Feed Global: 32x32</li> </ul> <p>A mesma coisa que com os emblemas, a imagem real n\u00e3o est\u00e1 sendo redimensionada apenas o tamanho da tela, se voc\u00ea usar o Android ou aumentar o zoom do seu navegador, voc\u00ea ver\u00e1 as imagens com mais clareza.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#diretrizes-e-dicas","title":"Diretrizes e Dicas","text":"<ul> <li>As imagens enviadas para emblemas devem ser quadradas, como um n\u00famero igual de x e y, caso contr\u00e1rio, a imagem resultante ser\u00e1 distorcida e feia.</li> </ul> <ul> <li>O formato PNG n\u00e3o-entrela\u00e7ado (Non-interlaced PNG) recomendado, evite usar uma camada de transpar\u00eancia, pois ela sair\u00e1 no final com uma caixa branca e plana.</li> </ul> <ul> <li>\u00c9 recomendado fazer emblemas em 64x64 para maior clareza. Os \u00edcones devem ser feitos de maneira que o tema seja claro mesmo quando dimensionado em 32x32.</li> </ul> <ul> <li>Os emblemas devem se referir de alguma forma ao que \u00e9 o achievement, ou seja, uma imagem do chefe, n\u00edvel ou colecion\u00e1vel que o achievement requer que o jogador alcance.</li> </ul> <ul> <li>Nos casos de achievements de jogos de baixa resolu\u00e7\u00e3o, pode ser dif\u00edcil conseguir um distintivo com boa apar\u00eancia sem que ele pare\u00e7a muito colorido ou emba\u00e7ado. Nesses casos, o visual de blocos \u00e9 geralmente prefer\u00edvel, de modo que as imagens tenham uma apar\u00eancia retr\u00f4.</li> </ul> <ul> <li>Voc\u00ea pode fazer com que cada distintivo tenha pequenas bordas arredondadas, como um distintivo real ou alguns cantos pontiagudos extras para dar \u00eanfase ou uma coroa do rei para os mais dif\u00edceis. \u00c9 o seu design. Deve representar visualmente o achievement em si, ou sugerir a localiza\u00e7\u00e3o no jogo em busca de segredos.</li> </ul> <ul> <li>Combinar com o estilo de arte do jogo funciona bem. Pesquisas de imagens do Google para \"Sprite Sheets\" \u00e9 outra dica \u00fatil para incluir algumas artes do jogo.</li> </ul>"},{"location":"Badge-and-Icon-Creation-pt_BR/#mudancas-e-rebaixamentos","title":"Mudan\u00e7as e Rebaixamentos","text":"<p>Como o site n\u00e3o tem, na maioria dos casos, um rollback permanente / estilo git-rollback / estilo wiki para todas as a\u00e7\u00f5es tomadas em um conjunto, \u00e9 recomendado que quando um desenvolvedor faz altera\u00e7\u00f5es de qualquer tipo em um conjunto dele no f\u00f3rum para esse jogo.</p> <p>Em rela\u00e7\u00e3o aos emblemas, publique na p\u00e1gina do f\u00f3rum do jogo uma das seguintes op\u00e7\u00f5es:</p> <ul> <li>Deixando uma c\u00f3pia antiga do crach\u00e1 no t\u00f3pico do jogo (exemplo: <code>[img = \"https://retroarchievement.org/badge/1234]</code>)</li> </ul> <ul> <li>Anota\u00e7\u00e3o do antigo ID do emblema (n\u00famero exibido no URL da imagem do emblema)</li> </ul> <p>Aqui est\u00e1 um exemplo perfeito de como fazer o backup corretamente de emblemas alterados.</p> <p>\u00e9 recomendado, para ajudar a manter tudo em ordem, de modo que, nos casos em que as revers\u00f5es ou altera\u00e7\u00f5es sejam adequadas, \u00e9 muito mais f\u00e1cil faz\u00ea-las.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-10-11 00:45] CoolCanuck:</code> https</li> <li><code>[2018-03-26 23:01] meleu:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-26 02:52] KingDice001:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-26 02:52] KingDice001:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-25 23:13] 7Mogami7:</code> Created Badge and Icon Creation pt_BR (markdown)</li> </ul>"},{"location":"Badge-and-Icon-Creation/","title":"Badge and Icon Creation","text":""},{"location":"Badge-and-Icon-Creation/#game-icons","title":"Game Icons","text":"<p>Icons are user uploaded images that are used throughout the site to represent a game. Due to their prominence on game and user pages they are worth special attention. These icons should be representative of the game and its common themes, and therefore should be instantly recognizable.</p> <ul> <li> <p>Sonic the Hedgehog's game Icon </p> <p> </p> </li> </ul>"},{"location":"Badge-and-Icon-Creation/#designing-new-game-icons-styling-guide","title":"Designing New Game Icons - Styling Guide","text":""},{"location":"Badge-and-Icon-Creation/#game-mastery-icons-must-represent-the-associated-game-by-using-official-art-only","title":"Game Mastery Icons must represent the associated game by using 'Official' art only.","text":"<ul> <li>Sprites from the game (or models)</li> <li>Box Art / Regional Box Art</li> <li>Concept Art</li> <li>CD / OST Art</li> <li>Manual Art</li> <li>Guidebook Art</li> <li>Advertisements</li> <li>Or any other 'Official' Source of artwork.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#mastery-icons-must-not","title":"Mastery Icons must not","text":"<ul> <li>Use art from a different port</li> <li>Use fan art sourced from external sources</li> <li>Contain anything vulgar, offensive or pornographic</li> </ul>"},{"location":"Badge-and-Icon-Creation/#mastery-icons-may","title":"Mastery Icons may","text":"<ul> <li>Add in custom borders or other adornments</li> <li>Stylize official art or combine different official art sources</li> <li>Use official art from a different regional release on the same console, unless that regional release has its own game page entry</li> <li>Use fan art created by the icon creator, but it must be approved by the art team prior to uploading or any icon gauntlet vote.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#exceptions","title":"Exceptions","text":"<ul> <li>If two different ports use the same key art, that art may be used for either port.</li> <li>Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.</li> <li>Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#other-icon-design-tips","title":"Other Icon Design Tips","text":"<ul> <li>Browse the games list, to find Icons that speak to you. Mimic and innovate on the style of your favorites.</li> <li>Many of the Badge creation tips apply here as well.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#icon-file-and-size-best-practices","title":"Icon File and Size - Best Practices","text":"<ul> <li>Upload using non-interlaced PNG format; avoid using a transparency layer for the background as it will come out in the end with a flat white box.</li> <li>Design mastery Icons images at 96x96</li> <li>Icons should be made in a way that the subject is clear even when sized at 32x32 as they are often reduced to this size, like on the global feed.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#uploading-game-icons-developer","title":"Uploading Game Icons (Developer)","text":"<p>Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.</p> <p>To change a game icon first go to the game page and click on the Dev tools: </p> <p>Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted: </p> <p>If a game has existing achievements, game icon changes need to go through revision process.</p>"},{"location":"Badge-and-Icon-Creation/#uploading-game-icons-non-developer","title":"Uploading game icons (non-Developer)","text":"<p>Yes, you absolutely can, but they are subject to revisions. It will also be good to review the guidelines for designing new game icons.</p>"},{"location":"Badge-and-Icon-Creation/#what-happens-to-the-image-when-you-upload-a-game-icon","title":"What happens to the image when you upload a game Icon","text":"<p>When uploaded, your Icon images will be rejected unless they are a 96x96 32-bit colour PNG. If you upload an Icon that is smaller than 96x96 the image uploaded will retain its original size.</p> <p>The same is true for Badges, except Badge size is 64x64. (Profile images maximum is 128x128.)</p>"},{"location":"Badge-and-Icon-Creation/#icon-server-files","title":"Icon server files","text":"<p>Icons are stored on the site in the following manner and place: <code>i.retroachievements.org/Images/000705.png</code>. They are stored in the same server folder as other game images such as the game box and game screenshots. </p>"},{"location":"Badge-and-Icon-Creation/#achievement-badges","title":"Achievement Badges","text":"<p>Badges are the user created images for individual achievements of a game.</p> <ul> <li>Sonic the Hedgehog's first Badge - #00199) </li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-creation-guidelines-and-tips","title":"Badge creation guidelines and tips","text":"<ul> <li>Badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to. </li> <li>Check out the designs of some of your favorite games. Some users go to great effort to make visually appealing badges:</li> </ul> <ul> <li>Here's a forum topic full of great tips. </li> <li>In the cases of low-resolution games' achievements, it can be hard to get a Badge looking good without it looking blocky or blurry, in these cases the blocky look is often preferable, so that the images have a retro feel to them.</li> <li>You can make each Badge have little rounded borders like an actual Badge or some extra spiky corners for emphasis or a king's crown for difficult ones.  Its your design.  It should visually represent the achievement itself, or hint at the location in the game for secrets.</li> <li>Matching to the game's art style works well. Google Image searches for \"Sprite Sheets\" is another useful tip to include some game art.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-file-and-size-best-practices","title":"Badge file and size - best practices","text":"<ul> <li>Upload using non-interlaced PNG format; avoid using a transparency layer as it will come out in the end with a flat white box.</li> <li>Design images at 64x64. You may wish to check them at 48x48 and 32x32 just to see how they will look in contexts where the site resizes them to those smaller sizes.</li> <li>Badges should be made in a way that the subject is clear even when sized at 32x32, as they are often reduced to this size, like on the global feed.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#uploading-a-badge-for-new-achievements-developer","title":"Uploading a Badge for new achievements (Developer)","text":"<p>If you are creating new achievements you are free to upload badges for them. </p> <p>Badges are uploaded from within the emulator developer tools while in the achievement editor: </p> <p>Or you can select a prefabricated image or find other images you've uploaded in the drop down box: </p> <p>Upload <code>.png</code> file types.</p> <p>If the game has existing badges review and follow the procedure for Uploading Badges (Non-Developer).</p>"},{"location":"Badge-and-Icon-Creation/#making-new-badges-for-existing-achievements","title":"Making new Badges for existing achievements","text":"<p>If you'd like to make improved badges for existing achievements, you can. Your images will go through the revision process, which will put your creations to a community vote.</p> <p>Post all the new images you'd like to replace current ones in the Icon Gauntlet Forum Topic. Also post all the badges that the new images are meant to replace. They will be placed for a community review by as a single vote. After a community vote is complete if you are a dev you can replace the Badges or if you are not, ask for help in the #help-me channel on Discord or in the Icon Gauntlet Forum Topic.</p> <p>It's easiest to just reference the old and new Badges as <code>img</code> links:</p> <ul> <li>Example: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code></li> <li>(Dev) Make sure to capture the old Badge ID from the Achievement Editor before uploading the new Badge</li> <li>The new Badge ID will appear in the Achievement Editor after uploading it.</li> <li>Both values can also be captured from the web site, but you have to copy the image links as the hover link is for the achievement.</li> </ul> <p>Here is a perfect example of how to effectively post new and old Badges.</p>"},{"location":"Badge-and-Icon-Creation/#what-happens-to-the-image-when-you-upload-a-badge","title":"What happens to the image when you upload a Badge","text":"<p>When uploaded, your file is converted into the following: - 64x64 32-bit colour PNG. Example:</p> <pre><code>![00136](https://user-images.githubusercontent.com/8508804/37221161-b9b0bb02-23a7-11e8-81b2-3d09fa7456af.png)\n</code></pre> <ul> <li>64x64 greyscale and blurred PNG. Example:<p></p> </li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-server-files","title":"Badge Server Files","text":"<p>They are stored on site in the following manner and place: <code>i.retroachievements.org/Badge/00136.png</code>; the number coincidences with the badge ID found in the Achievement.</p>"},{"location":"Badge-and-Icon-Creation/#where-youll-see-badges-and-icons-are-displayed","title":"Where you'll see Badges and Icons are displayed","text":"<ul> <li>On leaderboards: 96x96 (Icon only)</li> <li>In RA Emulators 64x64</li> <li>Game Pages: 96x96</li> <li>User Pages: 48x48</li> <li>Currently Playing (front page), New Achievements, Similar Games: 32x32</li> </ul> <p>The actual images are not being resized. The image is scaled by the browser to the display size. Some browsers such as Android's browser will display larger images more clearly. You can also increase your browser zoom to see them more clearly.</p> <p>It's anticipated that in a future website version, Icons and Badges will be displayed at full size in other places.</p>"},{"location":"Badge-and-Icon-Creation/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-21 07:59] The Mystical One:</code> Removed jpg and gif references.</li> <li><code>[2023-06-13 13:05] The Mystical One:</code> Added new rules about game icons as proposed by art team and approved by DevCompliance. Cleaned up a few other details.</li> <li><code>[2023-05-31 10:21] The Mystical One:</code> Fixing badge and icon size design rules.</li> <li><code>[2021-07-01 09:00] StingX2:</code> Added \"These icons should be representative of the game and its common themes, and therefore should be instantly recognizable.\"</li> <li><code>[2021-05-10 21:09] HolyShinx:</code> Updated Badge and Icon Creation (markdown)</li> <li><code>[2021-04-26 13:26] meleu:</code> fix links</li> <li><code>[2020-10-25 18:30] meleu:</code> Updated Badge and Icon Creation (markdown)</li> <li><code>[2020-03-23 06:31] televandalist:</code> Fixed several typos. Removed Game Icon Gauntlet information (going to merge it with revisions) and linked to the revision page where applicable.</li> <li><code>[2019-11-17 22:14] meleu:</code> remove Table of Contents (it was bad formatted)</li> <li><code>[2019-08-08 04:05] Kvon:</code> Badge and Icon Creation; minor typo</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/","title":"Badge and Icons","text":"<ul> <li>Overview</li> <li>Badge Format and Sizes</li> <li>Designing New Badges</li> <li>Uploading Game Icons</li> <li>Uploading Badges</li> <li>Badge Server Files</li> <li>Making New Badges for Existing Achievements</li> <li>To Do</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#overview","title":"Overview","text":"<p>When someone mentions badges, they could be talking about one of two things: - Achievement badges, which are user-created images associated with the individual achievements of a set.   - Sonic the Hedgehog's first Badge - #00199)     -  - Game icons, also known as mastery badges, which is a single image used to represent an achievement set.   - Sonic the Hedgehog's game icon     - </p>"},{"location":"Badge-and-Icon-Guidelines/#badge-format-and-sizes","title":"Badge Format and Sizes","text":"<ul> <li>For best results, game icons and achievement badges should be in 32-bit non-interlaced PNG format.<ul> <li>JPG and GIF are also supported.</li> </ul> </li> <li>Avoid using transparency in the background layer since it will not display properly on the site and emulators.</li> <li>Achievement badges must be 64x64.</li> <li>Game icons must be 96x96.</li> <li>Badges should be made in a way that the subject is clear even when scaled down to 48x48 or 32x32, as they often are on various pages on the site.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#designing-new-badges","title":"Designing New Badges","text":"<p>Achievement badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to. </p>"},{"location":"Badge-and-Icon-Guidelines/#designing-new-game-icons","title":"Designing New Game Icons","text":""},{"location":"Badge-and-Icon-Guidelines/#game-mastery-icons-must-represent-the-associated-game-by-using-official-art-only","title":"Game Mastery Icons must represent the associated game by using 'Official' art only.","text":"<ul> <li>Sprites from the game (or models)</li> <li>Box Art / Regional Box Art</li> <li>Concept Art</li> <li>CD / OST Art</li> <li>Manual Art</li> <li>Guidebook Art</li> <li>Advertisements</li> <li>Or any other 'Official' Source of artwork.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#mastery-icons-must-not","title":"Mastery Icons must not","text":"<ul> <li>Use art from a different port</li> <li>Use fan art sourced from external sources</li> <li>Contain anything vulgar, offensive or pornographic</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#mastery-icons-may","title":"Mastery Icons may","text":"<ul> <li>Add in custom borders or other adornments</li> <li>Stylize official art or combine different official art sources</li> <li>Use official art from a different regional release on the same console, unless that regional release has its own game page entry</li> <li>Use fan art created by the icon creator, but it must be approved by the art team prior to uploading or any icon gauntlet vote.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#exceptions","title":"Exceptions","text":"<ul> <li>If two different ports use the same key art, that art may be used for either port.</li> <li>Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.</li> <li>Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#uploading-game-icons","title":"Uploading Game Icons","text":"<p>Developers: - Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.   - To change a game icon first go to the game page and click on the Dev tools:      - Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted: </p> <p>If a game has existing achievements, game icon changes need to go through revision process.</p> <p>Non-Developers: - Yes, you absolutely can, but they are subject to revisions. It will also be good to review the guidelines for designing new game icons.</p>"},{"location":"Badge-and-Icon-Guidelines/#uploading-badges","title":"Uploading Badges","text":"<p>For Developers:</p> <p>If you are creating new achievements you are free to upload badges for them. </p> <p>Badges are uploaded from within the emulator developer tools while in the achievement editor: </p> <p>Or you can select a prefabricated image or find other images you've uploaded in the drop down box: </p>"},{"location":"Badge-and-Icon-Guidelines/#badge-server-files","title":"Badge Server Files","text":"<ul> <li>Game icons are stored on the site in the following manner and place: <code>i.retroachievements.org/Images/000705.png</code>. They are stored in the same server folder as other game images such as the game box and game screenshots.</li> <li>Achievement badges are stored on site in the following manner and place: <code>i.retroachievements.org/Badge/00136.png</code>; the number coincidences with the badge ID found in the Achievement.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#making-new-badges-for-existing-achievements","title":"Making New Badges for Existing Achievements","text":"<p>If you'd like to make improved badges for existing achievements, you can. Your images will go through the revision process, which will put your creations to a community vote.</p> <p>Post all the new images you'd like to replace current ones in the Icon Gauntlet Forum Topic. Also post all the badges that the new images are meant to replace. They will be placed for a community review by as a single vote. After a community vote is complete if you are a dev you can replace the Badges or if you are not, ask for help in the #help-me channel on Discord or in the Icon Gauntlet Forum Topic.</p> <p>It's easiest to just reference the old and new Badges as <code>img</code> links: - Example: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code> - (Dev) Make sure to capture the old Badge ID from the Achievement Editor before uploading the new Badge - The new Badge ID will appear in the Achievement Editor after uploading it. - Both values can also be captured from the web site, but you have to copy the image links as the hover link is for the achievement.</p> <p>Here is a perfect example of how to effectively post new and old Badges.</p>"},{"location":"Badge-and-Icon-Guidelines/#to-do","title":"To Do","text":"<ul> <li>Needs info on adding achievement badges via the website.</li> <li>Add \"collager\" info.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-21 09:42] The Mystical One:</code> Adding the Mastery Icon to these guidelines.</li> <li><code>[2023-06-03 03:55] televandalist:</code> Created Badge and Icon Guidelines (markdown)</li> </ul>"},{"location":"BitCount-Size/","title":"BitCount Size","text":"<p><code>BitCount</code> is a shortcut for counting the number of bits set in a byte.</p> <pre><code>BitCount Mem 0x1234 == Value 6\n</code></pre> <p>is the same as</p> <pre><code>AddSource Bit0 Mem 0x1234\nAddSource Bit1 Mem 0x1234\nAddSource Bit2 Mem 0x1234\nAddSource Bit3 Mem 0x1234\nAddSource Bit4 Mem 0x1234\nAddSource Bit5 Mem 0x1234\nAddSource Bit6 Mem 0x1234\n          Bit7 Mem 0x1234 == Value 6\n</code></pre> <p>and would be true for <code>0x3F</code> (00111111), <code>0xDB</code> (11011011), <code>0xEE</code> (11101110), etc.</p> <p>Its most common use is counting collectibles for a Measured condition.</p> <p>It can be combined with other flags like Delta.</p> <pre><code>BitCount Mem 0x1234 != BitCount Delta 0x1234\n</code></pre> <p>If you just want to make sure all the bits are set and don't need to worry about some subset of bits being set, you should check for concrete values (i.e. <code>Eight Bit 0x1234 = 0xFF</code> or <code>Lower4 0x1234 = 0x0F</code>).</p> <p>WARNING: BitCount always counts all eight bits in a byte. If you only need 6 or 7 bits, you should use the AddSource chain in case the other bits are used for something else.</p>"},{"location":"BitCount-Size/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-07-09 15:18] RALordAndrew:</code> Double-bracket links do not work on docs.retroachievements.org</li> <li><code>[2021-04-22 09:12] Jamiras:</code> Updated BitCount Size (markdown)</li> <li><code>[2021-04-22 09:06] Jamiras:</code> Updated BitCount Size (markdown)</li> <li><code>[2020-05-17 14:09] Jamiras:</code> add BitCount</li> </ul>"},{"location":"Bonus-Sets-es/","title":"Gu\u00eda para Sets Bonus","text":"<p>Tema Avanzado para Desarrolladores</p>"},{"location":"Bonus-Sets-es/#que-es-un-set-bonus","title":"\u00bfQue es un Set Bonus?","text":"<p>\u00bfSe te ocurren algunos verdaderos retos para retar al jugador mas masoquista mientras dise\u00f1as un set?  O tal vez \u00bfalgunos extras que no est\u00e1n incluidos en el set core?  \u00bfTuviste muchas solicitudes de algo que no encajaba del todo en el set core? RetroAchievements da la bienvenida y motiva todos esos retos y diversi\u00f3n, pero como siempre nos gusta hacerlo de una manera organizada. Puntos Bonus para sets populares es una grandiosa idea!</p>"},{"location":"Bonus-Sets-es/#que-deberia-de-incluir-en-un-set-bonus","title":"\u00bfQue deber\u00eda de incluir en un Set Bonus?","text":"<p>Sets dise\u00f1ados para probar la maestr\u00eda en un juego y proveer nuevos y divertidos retos. Siempre deber\u00edas seguir el estandarte de \"\u00bfEs esto realmente diferente?\" cuando te encuentres haciendo Sets Bonus.</p> <ul> <li>Extras Divertidos: Algunas veces un juego simplemente necesita mas diversi\u00f3n! \u00bfTienes cosas que no se ajustar\u00edan muy bien en un set core?  Un Set Bonus es un buen lugar para ellos.</li> </ul> <ul> <li>Muy retadores: Si generalmente se a escuchado que un logro es demasiado dificil para el jugador casual, este es un candidato principal para un Set Bonus. Ten en cuenta que tambi\u00e9n necesitas limitar la dificultad de un modo que un humano puede obtenerlo. La mayor\u00eda de los jugadores expertos aun no son calidad speed-runners.</li> </ul> <ul> <li>Super Secretos o Secciones de Grindeo: Estos usualmente frustran al jugador casual asta el final. Pero un jugador de un Set Bonus va a disfrutar el reto. Ejemplos:  \"Consigue que todos los personajes llegan hasta el m\u00e1ximo nivel\", \"M\u00e1xima Fuerzo, M\u00e1xima Defensa, Magia en todos los jugadores\", \"P\u00e9gale al objeto X numero de veces\", \"Gana # Mini-Juegos\", \"Consigue X items raros\".</li> </ul>"},{"location":"Bonus-Sets-es/#como-creo-un-set-bonus","title":"\u00bfComo creo un Set Bonus?","text":"<p>Tu obviamente deber\u00edas comentar la idea primero .  Es tu trabajo y una regla que se tiene que cumplir.</p> <p>Actualmente, crear un set Bonus no es f\u00e1cil.  Tienes que b\u00e1sicamente aplicar un hack que no destruya el ROM a una copia de la ROM original y lanzar el parche IPS que incluye las diferencias para que la gente lo pueda disfrutar.  Parchear un ROM con el parcheador IPS es relativamente f\u00e1cil.  Un jugador que disfrute de muchos ROM hacks para probar retos adicionales a de estar bastante acostumbrado.  Sin embargo es algo que tienes que aceptar para lanzar tu Set Bonus, crear un parche no-destructivo.</p> <p>Algunas veces un administrador (as\u00ed como Salsa, que es la cabecilla del proyecto de los Sets Bonus y del creado de parches) puede ser capaz de guiarte por la direcci\u00f3n correcta.  Si tu solamente desarrollas logros, adentrarte en la creaci\u00f3n del parche puede llegar a ser algo complicado y confuso.</p> <p>Si tu eres un programador o un artista y ya estas consiente del uso apropiado de las herramientas de hacking, los pasos se encuentras mas abajo para como generar un parche IPS cosmetico.  Recuerda seguir los lineamientos!</p> <p>NOTA</p> <p>Este meto cambiara cuando los Sets Bonus sea una funci\u00f3n integrada de RetroAchievements.  Mientras tanto puede proveer parches IPS mientras esta funci\u00f3n aun es agregada.</p>"},{"location":"Bonus-Sets-es/#paso-1-obten-el-juego-original","title":"Paso 1 - Obt\u00e9n el juego original","text":"<p>El primer paso para dise\u00f1ar un Set Bonus es conseguir el ROM original del juego.  Recuerda que nosotros no podemos proveer un m\u00e9todo descarga para eso.  \u00bfYa tienes tu Dumpeador/Extractor de ROMs a la mano?</p>"},{"location":"Bonus-Sets-es/#paso-2-crea-una-copia-del-rom-original","title":"Paso 2 - Crea una copia del ROM original","text":"<p>Este es el archivo que vas a utilizar para editar para convertirlo en el ROM para tu set Bonus</p>"},{"location":"Bonus-Sets-es/#paso-3-agarra-un-editor-hexadecimal-o-una-herramienta-de-modificacion-de-sprites-sprite-hacking-tool","title":"Paso 3 - Agarra un editor hexadecimal o una herramienta de modificaci\u00f3n de sprites (sprite-hacking tool).","text":"<p>Puedes saltarte este paso si es que ya cuentas con uno.  Algunos juegos ya cuenta con herramientas de hackeo especializadas.  Algunas de ellas se encuentran aqu\u00ed disponibles en github, y tambi\u00e9n hay bastantes de ellas en  ROMHacking.net, que esto aria tu trabajo aun mas f\u00e1cil.  Vas a necesitar un editor mas gen\u00e9rico si el juego no cuenta con una herramienta.  La edici\u00f3n tiene que ser lo suficiente para que se puede crear un nuevo MD5sum para el archivo del ROM.  Herramientas para editar tu ROM pueden ser encontradas en la Pagina de Utilidades de ROMHacking.net's. </p> <p>Aqu\u00ed hay algunas b\u00fasquedas que te podr\u00edan resultar \u00fatiles:</p> <ul> <li>Sprite Hacking tools - ROMHacking.net Filtered Search</li> <li>Texto y Editores Hex - ROMHacking.net Filtered Search</li> </ul>"},{"location":"Bonus-Sets-es/#paso-4-siguiendo-las-reglas-y-editando","title":"Paso 4 - Siguiendo las Reglas y Editando!","text":"<p>Por favor \u00e9chale a la sesi\u00f3n de Parches Cosm\u00e9ticos para Sets Bonus de los lineamientos del Linkeado de ROMs para mas informaci\u00f3n.</p> <p>ESTE PASO REQUIERE PEDIR APROBACI\u00d3N ANTES DE SEGUIR AVANZANDO</p> <p>Es algo integro que solicites una aprobaci\u00f3n antes de agregar/linkear cualquier cosa a RetroAchievements.  Es tu trabajo y es parte del C\u00f3digo de Conducta del Desarrollador de RetroAchievements.</p>"},{"location":"Bonus-Sets-es/#paso-5-agrega-el-md5-al-nuevo-set-bonus","title":"Paso 5 - Agrega el MD5 al nuevo Set Bonus","text":"<p>Despu\u00e9s de recibir la aprobaci\u00f3n, carga tu ROM parcheado en un Emulador de RA, y sigue las instrucciones de como linkear tu nuevo Set Bonus a tu ROM en el sitio web.  Si tu juego produce un MD5 igual al de otro juego, procura hacer mas modificaciones al ROM para que este genere un MD5 nuevo otra vez y lo cargue como un juego nuevo.</p>"},{"location":"Bonus-Sets-es/#paso-6-modifica-la-pagina-de-detalles-del-set","title":"Paso 6 - Modifica la pagina de detalles del set","text":"<p>Navega por tu perfil de usuario y procede a la nueva pagina de tu juego que deber\u00eda de aparecer ahora.  Puedes editar los detalles del juego, capturas de pantalla, e informaci\u00f3n desde el panel de Dev Options en la nueva pagina del set.</p> <p>PREG\u00daNTALE A UN ADMINISTRADOR PARA QUE RESE\u00d1E TU TRABAJO DESPU\u00c9S QUE HUBIERAS COMPLETADO ESTE PASO</p>"},{"location":"Bonus-Sets-es/#paso-7-crea-logros-para-el-set-anuncialo-y-lanzalo","title":"Paso 7 - Crea logros para el set, an\u00fancialo y l\u00e1nzalo.","text":"<p>Ahora ya puedes empezar a desarrollar logros para tu Set Bonus.  Cuando termines, anuncia tu set e incluye tu parche IPS en el tema del foro despu\u00e9s de a ver pasado los logros a Core.  Actualmente los miembros necesitan aplicar tu parche al juego original as\u00ed como lo hiciste en tus pruebas para que ellos puedan jugar tu Set Bonus.  No esta permitido lanzar el ROM parcheado en si.  Tu tienes que SOLAMENTE lanzar el Parche IPS para cumplir con los lineamientos del sitio de no compartir p\u00fablicamente material con derechos de autor/copyright en RetroAchievements).</p>"},{"location":"Bonus-Sets-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-21 11:01] eldexterr:</code> Updated Bonus Sets es (markdown)</li> <li><code>[2019-05-21 11:00] eldexterr:</code> Created Bonus Sets es (markdown)</li> </ul>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame-es/","title":"Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame","text":"<p>En este ejemplo veras como evitar el problema de que un contador se incremente dos veces en el mismo frame combinando un SubSource y AddHits.</p> <p>En la libreria del Game Boy Advance hay un plataformero Navide\u00f1o conocido como Santa Claus Jr. Advance. Hay algunos logros de coleccionar varios dulces en cada uno de los Stages Bonus.</p> <p>Esos logros se suponen que tendrian que ser algo simple, como esto:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xDULCES != Delta 0xDULCES (N) 2 ResetIf 0xSTAGE != Value 0xBONUS <p>Esto se traducir\u00eda \"checa si el contador de dulces cambio <code>N</code> veces en el stage bonus\".</p> <p>Nota: estamos utilizando <code>0xDULCES != Delta 0xDULCES</code> (utilizando <code>!=</code>, y no <code>&gt;</code>) porque cuando el jugador cuenta con 99 dulces y colecciona uno mas el contador se va a cero.</p> <p>Sin embargo, hay un aspecto en este juego (y muchos otros) donde si el jugador colecciona 2 dulces a la vez el contador va a aumentar por 2 en el mismo frame. Cuando pasa el contador de hits es aumentado por uno mientras que el contador de dulces aumento en dos. Esto, obviamente, arruina la l\u00f3gica que utilizamos arriba.</p> <p>En manera que podamos evitar este problema tenemos que utilizar la t\u00e9cnica de utilizar <code>SubSource</code> para contar incrementos espec\u00edficos combinado con una   <code>AddHits</code> flag.</p> <p>Echemos un vistazo a la l\u00f3gica del logro y as\u00ed poder ver la explicaci\u00f3n:</p> <p>Variables (Addresses)</p> <ul> <li><code>0x80dc</code>: Contador de Dulces.</li> <li><code>0x809c</code>: ID de Stage.</li> </ul> <p>As\u00ed que ahora la estructura de logro seria de esta manera:</p> <p></p> <p>Condiciones</p> <ol> <li> <p>Junto con la condici\u00f3n 2, es un truco para ver si <code>0xDULCES - Delta 0xDULCES = 2</code>. En otras palabras, el contador de dulces fue incrementado por dos.</p> </li> <li> <p>Utilizando a la vez con la condici\u00f3n 1 (como se explica arriba) y 3. Como se explica en su respectiva pagina, cuando la condici\u00f3n de <code>AddHits</code> es verdadera, el hit counter en la siguiente condici\u00f3n es incrementado. Entonces , en nuestro ejemplo de aqu\u00ed, cuando condici\u00f3n 2 es verdadera, el hitcounter en condici\u00f3n 3 es incrementado.</p> </li> <li> <p>Contador cuando el contador de dulces cambia.</p> </li> <li> <p>Resetear contador si no se encuentra en un Stage Bonus.</p> </li> </ol> <p>Todas esta condiciones se pueden traducir como \"mientras est\u00e9s en un stage bonus, salta el logro si el contador de dulces cambia 99 veces, y si el contador de dulces es incrementado por 2 en el mismo frame, a\u00f1ade un cambio extra al contador de dulces.\"</p>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:33] meleu:</code> fix broken links</li> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame/","title":"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame","text":"<p>In this example you'll see how to circumvent the problem of a counter incrementing twice in the same frame by combining SubSource and AddHits.</p> <p>In the Game Boy Advance library there's a Christmas platformer game called Santa Claus Jr. Advance. There are some achievements for collecting all candy canes in each one of the bonus stages.</p> <p>Such achievements were supposed to be quite simple, like this:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCANDIES != Delta 0xCANDIES (N) 2 ResetIf 0xSTAGE != Value 0xBONUS <p>This translates into \"check if the candy canes counter changed <code>N</code> times in the bonus stage\".</p> <p>Note: we're using <code>0xCANDIES != Delta 0xCANDIES</code> (using <code>!=</code>, and not <code>&gt;</code>) cause when the player has 99 candies and collect one more, the counter goes to zero.</p> <p>However, there is an aspect in this game (and many others) where if the player collect 2 candy canes simultaneously the counter is increased by 2 in the same frame. When it happens the hit counter is increased by one while the candy counter is increased by two. This, obviously, ruins the logic used above.</p> <p>In order to circumvent this issue we have to use that technique of using <code>SubSource</code> to count specific increments combined with the <code>AddHits</code> flag.</p> <p>Let's take a look at the achievement logic and then we'll see the explanation:</p> <p>Addresses</p> <ul> <li><code>0x80dc</code>: Candy Canes counter.</li> <li><code>0x809c</code>: Stage ID.</li> </ul> <p>So now the structure of the achievement is going to be like this:</p> <p></p> <p>Conditions</p> <ol> <li> <p>Together with condition 2, is a trick used to check if <code>0xCANDIES - Delta 0xCANDIES = 2</code>. In other words, the candy counter was incremented by two.</p> </li> <li> <p>Used together with condition 1 (as explained above) and 3. As explained in its respective page, when the <code>AddHits</code> condition is true, the hit counter in the next condition is incremented. Therefore, in our example here, when condition 2 is true, the hitcounter in condition 3 is incremented.</p> </li> <li> <p>Count when the candy counter changes.</p> </li> <li> <p>Reset the counter if not in the Bonus stage.</p> </li> </ol> <p>All these conditions could be translated as \"while in the bonus stage, trigger the achievement if the candy counter changes 99 times, and if the candy counter is incremented by 2 in the same frame, count an extra change in the candy counter.\"</p> <p>So, now it is 100% solved, right? Well, actually, almost. There is still a very minor exception. Remember it was said before that <code>!=</code> was being used instead of <code>&gt;</code> because <code>when the player has 99 candies and collect one more, the counter goes to zero</code>?</p> <p>This means that, if we get two canes in the same frame (which is already rare), there's a very small possibility that this change will be from <code>98 -&gt; 00</code> or from <code>99 -&gt; 01</code>. In these only two cases our code won't work, because <code>00 - 98</code> is not 2, it is <code>-98</code>. Same thing for <code>01 - 99</code>, it is not 2, it is also <code>-98</code>.</p> <p>Despite being a very unlikely possibility, we should treat this case too. So we're gonna add two more requirements to the code, and it will end up looking like this:</p> <p></p> <p>It is the same as before, with the only changes being lines 3 and 4, which represents an extra <code>SubSource + Add Hits</code> to check if <code>0xCANDIES - Delta 0xCANDIES = -98</code>, only to take care of this very minor exception just mentioned.</p> <p>And now it is solved!</p>"},{"location":"Claims-System/","title":"Claims System","text":"<ul> <li>Claims System Guidelines</li> <li>Making a Claim</li> <li>Dropping a Claim</li> <li>Extending a Claim</li> <li>How to Complete a Claim</li> <li>Collaboration Claims</li> <li>Viewing Claim Info</li> <li>Claim Allotment</li> <li>Important Notes</li> </ul>"},{"location":"Claims-System/#claims-system-guidelines","title":"Claims System Guidelines","text":"<ul> <li>The right to work on a set is made by utilizing the site's Claim System. This is the only valid way to reserve a set. Posting plans in the forum, leaving code notes, telling everyone you want to work on it, or any other forms of declaration are not considered valid claims.</li> <li>Claims should be made as soon as you want to start working on a set, not as you are finishing your work.</li> <li>Do not claim sets that you are not actually interested in working on and especially do not do it just to block others from working on it.</li> <li>Only claim games when you are free of unaddressed tickets. If you are not, a prompt will appear when attempting to claim a set.</li> </ul>"},{"location":"Claims-System/#making-a-claim","title":"Making a Claim","text":"<p>To make a claim, go to the Developer panel of a game entry, which will contain one of the following links: - Make Claim - Make Claim and Forum Topic (Junior Developers require a forum topic to be made on their behalf) - Make Revision Claim - Make Collaboration Claim - Make Collaboration Revision Claim</p>"},{"location":"Claims-System/#dropping-a-claim","title":"Dropping a Claim","text":"<p>Dropping a claim is as simple as selecting the \"Drop Claim\" link in the Developer panel.</p>"},{"location":"Claims-System/#extending-a-claim","title":"Extending a Claim","text":"<ul> <li>When a claim is within a week of expiring, an \"Extend Claim\" link will become available. Selecting it will extend the claim an additional three months.</li> <li>Progress Reporting: Prior to extending a claim, post your progress in a new forum post. Progress should comment on RAM digging/code notes, a roadmap of achievements and your progress towards them. As further extensions are made, reports are expected to become more detailed and development priority is expected to increase.<ul> <li>At Developer Compliance discretion, additional requirements may be given if there is insufficient progress during a claim period, including claim drop. Game length, total claim duration, and other considerations will factor into any decision.</li> <li>Prior to the 3rd extension (the one-year mark) and all subsequent extensions, a thorough progress report must be made and the progress report must also be sent to Developer Compliance for consideration in allowing the extension.</li> <li>Any claim with no progress during the standard claim duration (3 months since claim/extension) may be subject to a claim drop.</li> </ul> </li> <li>Once a claim has expired, the set is available to be claimed by another developer.</li> <li>If a reservation reaches the point where it's more than a year old, a detailed progress report must be sent to <code>Developer Compliance</code> for subsequent renewals. The report should provide an overview of the development situation and include details such as:<ul> <li>List of planned achievements</li> <li>List of achievements already coded (local or unofficial)</li> <li>Memory digging status</li> <li>Progress of badges creation</li> <li>Rich Presence and Leaderboards Status (if applicable)</li> </ul> </li> <li>If the renewal is denied or dropped due to no-progress, a cooldown of one month will be applied. After this period, the developer may reserve the set again, if available. Detailed progress reports will continue to be required for any further renewals.</li> <li>If a claim is dropped and resumed in within a month, the initial claim date before dropping the set will be maintained.</li> </ul>"},{"location":"Claims-System/#how-to-complete-a-claim","title":"How to Complete a Claim","text":"<p>To mark a claim as complete, you can select the \"Complete Claim\" link in the Developer panel. Doing so will free the claim slot and notify users who have a set request for the game, via email, that new achievements have been added for that game.</p> <p>When selecting \"Complete Claim\" within 24 hours of making the claim, a prompt will inform the developer that they should have approval before marking it as complete. Approval must be from someone on the Developer Compliance team.</p>"},{"location":"Claims-System/#collaboration-claims","title":"Collaboration Claims","text":"<p>Collaboration claims are made when there is already a primary claim on a game and acts as a \"child\" of said primary claim. It will inherit the primary claim's expiration date. Extending or completing a collaboration claim can only be done by the developer with the primary claim.</p> <ul> <li>Let others know if you welcome collaborators.</li> <li>If you have claimed a set and someone expresses desire to work on it beyond suggesting ideas, consider ways in which you can collaborate with them.</li> <li>If someone claims a set that you were interested in, do not get frustrated. You are encouraged to contact the developer and request a collaboration. If denied, you have the option of presenting a revision plan after the set is published.</li> </ul>"},{"location":"Claims-System/#viewing-claim-info","title":"Viewing Claim Info","text":"<p>There are several ways to view claim information: - Every game entry will show if it has a claim or not - A developer's profile will show which claims they currently have active. - The site navbar contains <code>New Sets &amp; Revisions</code>, <code>Sets in Progress</code>, <code>My Claims</code>, and <code>Expiring Claims</code>. - The set request list will show if a game has an active claim.</p>"},{"location":"Claims-System/#claim-allotment","title":"Claim Allotment","text":"<p>Each developer is allowed four primary claims. Junior developers are allowed one primary claim. However, the following claim types can be marked as free claims and therefore will not take up a slot: - Claims made specifically for console rollouts. This is due to the unpredictable nature of rollouts as well as a way to reduce stress/pressure on developers. - If a developer makes a revision or subset claim, the claim can be set to \"Own Revision\" depending on criteria I haven't copy-pasted into this section yet. - Collaboration claims.</p>"},{"location":"Claims-System/#important-notes","title":"Important Notes","text":"<ul> <li>It is recommended that you post a complete plan in the forum topic. When doing so, be open to suggestions; you can get excellent input and suggestions this way.</li> </ul>"},{"location":"Claims-System/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-07 16:40] The Mystical One:</code> Updated Claims System (markdown)</li> <li><code>[2024-02-02 13:08] The Mystical One:</code> Updated emphasis on new forum post.</li> <li><code>[2024-02-02 13:07] The Mystical One:</code> Removed a redundancy where the 'one month' cooldown unnecessarily appeared twice.</li> <li><code>[2024-01-26 09:08] The Mystical One:</code> Updated Claims System (markdown)</li> <li><code>[2024-01-26 08:56] The Mystical One:</code> Added new claims enforcement rules, including requirement to comment on progress prior to extending a claim, and clearer guidelines for what to do at the one-year mark.</li> <li><code>[2023-06-05 18:08] televandalist:</code> Typos</li> <li><code>[2023-06-04 19:37] televandalist:</code> Added the notes under the section for collaboration claims. These were taken from the DevCoC and slightly reworded.</li> <li><code>[2023-06-03 04:56] televandalist:</code> Updated Claims System (markdown)</li> <li><code>[2023-06-03 04:39] televandalist:</code> Updated Claim System (markdown)</li> </ul>"},{"location":"Code-Notes/","title":"Code Notes","text":""},{"location":"Code-Notes/#code-notes","title":"Code Notes","text":"<p>Code notes are a vital part of achievement development. They provide valuable context to memory addresses used in achievement creation. Good code notes can make future achievement troubleshooting a breeze for developers, while bad code notes can make it a nightmare. This guide will help developers create clear, helpful, and consistent code notes that can be used by any developer looking at their sets in the future.</p>"},{"location":"Code-Notes/#how-to-make-code-notes","title":"How to Make Code Notes","text":"<p>Code notes are made by the developer in the Memory Inspector as they are RAM digging a game. This allows for easily seeing where sizes of notable addresses as well as areas in the RAM that hold important values. Code notes can be added, deleted and updated from the Memory Inspector. Code notes that are already created can be updated or deleted from the games' \"Code Notes\" page on the website. This is intended for quick fixes to notes and not intended as the main form of code note modification.</p> <ul> <li>Developers are free to add any code notes to any game without declaring intentions to work on the game. Just be careful to not delete previous notes added by someone else unless you are certain they are incorrect.</li> <li>Junior Developers shall limit their code notes to the game they have claimed. Juniors are unable to delete or overwrite notes made by other users.</li> </ul>"},{"location":"Code-Notes/#recommendations","title":"Recommendations","text":"<ul> <li>Be Clear and Informative: Code notes should clearly document what the address represents such that it can easily be understood by other developers.</li> <li>Specify the Address Size: Code notes should specify the size of the address being noted. This helps to easily know the address size during achievement logic creation and also to correctly color the address values within the Memory Inspector.</li> <li>Include Important Values: Code notes should include all values that are used within the achievement logic. Undocumented values make debugging much more complicated, especially if you didn't create the note.</li> <li>Document Extensively: It's better to document any useful addresses that you find, even if you know you won't need them in the achievement logic. You never know what addresses may be needed later on if the set is revised.</li> </ul>"},{"location":"Code-Notes/#specifying-memory-addresses-size","title":"Specifying Memory Addresses Size","text":"<p>There are multiple ways to specify a memory address that will be recognized by the Memory Inspector highlighting. Any code note that does not specify a valid size will cause the Memory Inspector to highlight the byte the note is for. Any number of bit and byte lengths will be recognized by the Memory Inspector highlighting. Many developers will enclose the address size in square brackets (<code>[]</code>) to make it more noticeable in the full note.</p> <ul> <li><code>[Lower4]</code>, <code>[Upper4]</code></li> <li><code>[8-bit]</code>, <code>[16-bit]</code>, <code>[24-bit BE]</code>, <code>[32-bit]</code>, <code>[Float]</code></li> <li><code>[1 byte]</code>, <code>[2 bytes]</code>, <code>[4 bytes]</code>, <code>[8-bytes]</code></li> <li><code>[128 bits]</code>, <code>[78 bytes]</code>, <code>[428 bits]</code>, <code>[1024 bytes]</code></li> </ul>"},{"location":"Code-Notes/#bit-fields-and-bit-flags","title":"Bit Fields and Bit Flags","text":"<p>Very often you will run into an address that uses each bit within the address to store data. Noting the individual bits won't affect any Memory Inspector highlighting, though each bit should be properly noted in the code note. Some people choose to mark the size for these as [Bitfield] or [Bitflags] instead of [8-Bit].</p>"},{"location":"Code-Notes/#adding-values-and-labels","title":"Adding values and labels.","text":"<p>When you need to label specific values or bit meanings in a note, here are some things to keep in mind.</p> <ul> <li>Always prefix hexadecimal values with <code>0x</code> so that it is clear the value is in hex. This is especially important if none of your values use characters A-F.</li> <li>If values are in decimal, consider putting a note in the description to this effect: <code>(Values below are decimal)</code></li> <li>Put each value on a separate line - This is usually the easiest way to visually distinguish each value. You should usually use this when there are more than two values to label.</li> <li>If there are only two values (Example: Yes/No), consider placing them inline with the description, if the description and labels are short.</li> <li>Put a separator between the value and its label. This can be an equals sign, a colon, or a dash, and you may put whitespace as needed. Tip: Using an equals sign without spaces lets you easily copy the value list into a Rich Presence lookup.</li> </ul>"},{"location":"Code-Notes/#examples","title":"Examples","text":""},{"location":"Code-Notes/#simple-types","title":"Simple Types","text":"<p>Simple address types cover the very basic address that are needed for nearly every achievement set and are often the some of first addresses noted when RAM digging. Often easily described in a line or two. These may include health, lives, in game currency, level, X/Y positions, etc...</p>"},{"location":"Code-Notes/#good-examples","title":"Good Examples","text":"<p>Good examples here include size, description, and different values or affects on the values.</p> <pre><code>[8-bit] Difficulty\n0x01 - Easy\n0x02 - Normal\n0x03 - Hard\n</code></pre> <pre><code>[16-bit] Player Health\nMax health is 0x1200, each hit reduces it by 0x8\n</code></pre>"},{"location":"Code-Notes/#bad-examples","title":"Bad Examples","text":"<pre><code>Difficulty\n</code></pre> <pre><code>health\n</code></pre>"},{"location":"Code-Notes/#map-or-screen-id-types","title":"Map or Screen ID Types","text":"<p>Map and Screen ID type code notes are very often used to determine location within the game and commonly used in level completion or item collection achievements.</p>"},{"location":"Code-Notes/#good-example","title":"Good Example","text":"<p>Good examples here include the various values that the address can take throughout the game. All addresses used in the achievement logic are noted in detail.</p> <pre><code>[8-bit] Screen ID\nChapter I\n0x36 - Initial Screen with woman's face\n0x0b - Taxi ride opening scene\n0x07 - Outside of apartment (Day 1)\n0x04 - Apartment main hall (Day 1)\n0x16 - Apartment main hall (Day 2)\n\nChapter II\n0x37 - Driving intro cutscene\n0x2b - Outside of Inn (Day 1)\n0x2c - Inn main room (Day 1)\n</code></pre>"},{"location":"Code-Notes/#bad-example","title":"Bad Example","text":"<pre><code>screen id\n</code></pre>"},{"location":"Code-Notes/#scores","title":"Scores","text":"<p>There are numerous way a game can store the players scores with memory, as such there are numerous ways to write the score code note out.</p>"},{"location":"Code-Notes/#good-examples_1","title":"Good Examples","text":"<p>Good examples here will specify the size, which digits of the score are being represented, how the on screen score is calculated from the value in memory, Binary Coded Decimal (BCD) notation if applicable, as well any any other important details.</p> <pre><code>[1 byte] 1P display score, digits 0000XX00 in BCD\n</code></pre> <pre><code>[16bit][DEC] P2 Score XXXX0000\n</code></pre> <pre><code>Score [24-Bit BE BCD] (Determines Rank)\n0-9=Pauper\n0-99=Peasant\n100-999=Prosperous\n1000+=Professional\n</code></pre>"},{"location":"Code-Notes/#bad-example_1","title":"Bad Example","text":"<pre><code>Player 1 score\n</code></pre>"},{"location":"Code-Notes/#bits","title":"Bits","text":"<p>It's very common to run into games that need to store event or item flags. Often these will be stored as individual bits rather than taking up an entire byte per flag. It's assumed that a bit value of 0 is off/no/false, if this is not the case then that should be noted.</p>"},{"location":"Code-Notes/#good-examples_2","title":"Good Examples","text":"<p>Good examples here will specify each bit as well as what they represent.</p> <pre><code>[Bitflags] Requests completed\nBit1 = No. 01 - Retrieve 1 Beetle Shell.\nBit2 = No. 02 - Retrieve the first old document.\nBit3 = No. 03 - I'd like to sip a Muscle Drink.\nBit4 = No. 04 - Retrieve 3 Old Lanterns.\nBit5 = No. 05 - Retrieve the second old document.\nBit6 = No. 06 - Create Jack Frost with Dia.\nBit7 = No. 07 - Retrieve 1 Lead Metal.\n</code></pre> <pre><code>Bonuses Unlocked\nbit0 - All Replay Items\nbit1 - Unlimited Ammo (Mission 1)\nbit2 - Silver Bullets (Mission 3)\nbit3 - Bullet Shield (Mission 4)\nbit4 - Rubber Grenades\nbit5 - Men With Hats (Mission 5)\nbit6 - Always Sniper\nbit7 - Achilles Head (Mission 6)\n</code></pre> <pre><code>[Treasure Flags 03]\nBit0=[Altair - Rebel Hideout] Potion\nBit1=[Fynn - Pub Basement] Scott's Ring\nBit2=[Castle Deist 1F - South Treasure Room] Stun Tome\nBit3=[Castle Deist 1F - South Treasure Room] Stop Tome\nBit4=[Castle Deist 1F - South Treasure Room] Curse Tome\nBit5=[Cave of Mysidia B4 - Treasure Room] Bell of Silence\nBit6=[Castle Deist 1F] Phoenix Down\nBit7=[Castle Deist 1F - NW Treasure Room] Gold Needle\n</code></pre>"},{"location":"Code-Notes/#bad-example_2","title":"Bad Example","text":"<pre><code>The bits here represent the unlocked bonuses\n</code></pre>"},{"location":"Code-Notes/#pointers","title":"Pointers","text":"<p>Pointers are more commonly found in newer consoles and their notes typically include information for various addresses that the pointer can point to. The pointer notes will typically include numerous offset values to the important addresses used by the developer.</p> <ul> <li>If offsets with labels are written correctly, the memory inspector and assets editor will generate indirect code notes at the pointer address + offset of the correct size.</li> <li>Use a plus sign <code>+</code> before the offset value.<ul> <li>For pointers with multiple layers, many people will use additional pluses to indicate that it is an offset of a pointer being pointed to by the original pointer. However, this will break all indirect code notes for that pointer. Consider using a vertical pipe before these layered offsets instead to allow for the top layer to generate indirect code notes.</li> </ul> </li> <li>Use <code>0x</code> to indicate a hexadecimal offset value; the memory inspector will treat it as a decimal offset if this is not present.</li> <li>You can separate the offset value and its label with any number of spaces, and a separator character like an equals sign, a colon, or a vertical pipe.</li> <li>You should specify the size of the data at the offset like any normal code note. Indirect notes and highlighting will use this.</li> <li>If multiple lines are present after the offset value, they will all be part of the indirect note for that address.</li> </ul>"},{"location":"Code-Notes/#good-examples_3","title":"Good Examples","text":"<p>Good examples here will include various address offsets, each of which including details and size of the address being pointed to.</p> <pre><code>Pointer to P1 Data [16-Bit]\n+0x68 P1 Character ID [8-Bit]\n+0xba P1 Health [8-Bit]\n+0xc4 P1 Move ID [16-Bit]\n</code></pre> <pre><code>[32-bit] Data Pointer\n+0x638 | Pointer to pointer to smells pointer\n++0x6d0 | Pointer to woofs\n+++0xb8 | Total Woofs [32-bit]\n+++0x380 | Sniff Level [32-bit]\n0x00 = Sniff Apprentice\n0x01 = Sniff Artisan\n0x02 = Sniff Expert\n0x03 = Sniff Master\n0x04 = Grand Sniff Master\n+++0x3c8 | Pointer to Racing Data [32-bit]\n++++0x15a8 | Checkpoint Count [32-bit]\n++++0x15ac | Frame Timer [32-bit]\n++0x13d8 | Pointer to smells pointer\n+++0x04 | Total Smells [32-bit]\n</code></pre> <pre><code>*US* Pointer [32-bits]\n\n--Player Kratos--\n+0x97898=Health [Float]\n+0x6f570=Combo [32-bits]\n+0x977a0=Coordinates Y [Float]\n+0x977a4=Coordinates Z [Float]\n+0x977a8=Coordinates X [Float]\n\n--Unlockables (Alternative)--\n+0x6f594=Poseidon's Trident [Bit0]\n+0x6f598=Poseidon's Rage [Bit0]\n+0x6f59c=Medusa's Gaze [Bit0]\n+0x6f5a0=Zeus' Fury [Bit0]\n+0x6f5a4=Army of Hades [Bit0]\n+0x6f5a8=Blade of Artemis [Bit0]\n</code></pre>"},{"location":"Code-Notes/#bad-example_3","title":"Bad Example","text":"<pre><code>Pointer for player information. Includes player data and unlockables.\n</code></pre>"},{"location":"Code-Notes/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:08] Andrew Comer:</code> Updated Code Notes (markdown)</li> <li><code>[2024-03-11 14:03] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:57] Andrew Comer:</code> Updated Code Notes (markdown)</li> <li><code>[2024-03-11 13:53] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:14] Andrew Comer:</code> Removed WIP header</li> <li><code>[2024-01-15 13:27] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-10 07:05] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 16:36] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 16:33] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 15:29] The Mystical One:</code> Added another score example to replace the one that was removed.</li> </ul>"},{"location":"Code-Review-Checklist/","title":"Code Review Checklist","text":"<p>This is a list of things that code reviewers usually check when someone submits a set to be reviewed.</p>"},{"location":"Code-Review-Checklist/#code-notes","title":"Code Notes","text":"<ul> <li>[ ] Clearly written. Example</li> <li>[ ] For all addresses used in logic</li> <li>[ ] Describing appropriate values used where applicable</li> </ul>"},{"location":"Code-Review-Checklist/#achievement-logic","title":"Achievement Logic","text":"<ul> <li>[ ] No achievements with only one condition.</li> <li>[ ] Demo mode protection (when applicable).</li> <li>[ ] Cheat codes protection (when applicable).</li> <li>[ ] No redundant logic (like <code>0xADDRESS = 1</code> and <code>ResetIf 0xADDRESS != 1</code>).</li> <li>[ ] Understanding the difference and the right use of PauseIf and ResetIf.</li> <li>[ ] On a \"get 100 coins\" like achievement, use <code>&gt;= 100</code> rather than <code>= 100</code>.</li> </ul>"},{"location":"Code-Review-Checklist/#achievement-design","title":"Achievement Design","text":"<ul> <li>[ ] No unwelcome concepts.</li> <li>[ ] Achievements for \"Finish level N\" rather than \"Reach level N+1\".</li> <li>[ ] No \"two for one\" achievements (like one for defeating a boss and another one for getting the dropped item).</li> </ul>"},{"location":"Combining-Flags-es/","title":"Combinando Banderas","text":"<p>Un <code>ResetIf</code> y <code>PauseIf</code> pueden ser aplicados al numero que sea de condiciones <code>Add Hits</code>, <code>Add Source</code>, y <code>Sub Source</code>.</p> <p>Volviendo al ejemplo del <code>Add Source</code> de arriba, si un <code>ResetIf</code> se aplicara a la condicion 2, el logro se reiniciar\u00eda porque <code>1 + 2 &gt; 0</code>.</p>"},{"location":"Combining-Flags-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:34] meleu:</code> fix broken link</li> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Combining-Flags/","title":"Combining Flags","text":"<p><code>ResetIf</code> and <code>PauseIf</code> can be applied to a condition following any number of <code>Add Hits</code>, <code>Add Source</code>, or <code>Sub Source</code> conditions. </p> <p>Going back to the <code>Add Source</code> example above, if <code>ResetIf</code> were applied to condition 2, the achievement would reset because <code>1 + 2 &gt; 0</code>.</p>"},{"location":"Condition-Syntax/","title":"Condition Syntax","text":""},{"location":"Condition-Syntax/#memory-sizes","title":"Memory sizes","text":"Size Prefix Example Bit0 <code>0xM</code> <code>0xM01234</code> Bit1 <code>0xN</code> <code>0xN01234</code> Bit2 <code>0xO</code> <code>0xO01234</code> Bit3 <code>0xP</code> <code>0xP01234</code> Bit4 <code>0xQ</code> <code>0xQ01234</code> Bit5 <code>0xR</code> <code>0xR01234</code> Bit6 <code>0xS</code> <code>0xS01234</code> Bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x 01234</code> 24bit <code>0xW</code> <code>0xW01234</code> 32bit <code>0xX</code> <code>0xX01234</code> 16bit BE <code>0xI</code> <code>0xI01234</code> 24bit BE <code>0xJ</code> <code>0xJ01234</code> 32bit BE <code>0xG</code> <code>0xG01234</code> BitCount <code>0xK</code> <code>0xK01234</code> Float <code>fF</code> <code>fF01234</code> MBF32 <code>fM</code> <code>fM01234</code>"},{"location":"Condition-Syntax/#prefixes","title":"Prefixes","text":"Modifier Prefix Example Delta <code>d</code> <code>d0xH1234</code> Prior <code>p</code> <code>p0xH1234</code> BCD <code>b</code> <code>b0xH1234</code> Invert <code>~</code> <code>~0xH1234</code>"},{"location":"Condition-Syntax/#logical-flags","title":"Logical Flags","text":"Flag Prefix Example ResetIf <code>R:</code> <code>R:0xH1234=1</code> ResetNextIf <code>Z:</code> <code>Z:0xH1234=1</code> PauseIf <code>P:</code> <code>P:0xH1234=1</code> AndNext <code>N:</code> <code>N:0xH1234=1</code> OrNext <code>O:</code> <code>O:0xH1234=1</code> AddSource <code>A:</code> <code>A:0xH1234=1</code> SubSource <code>B:</code> <code>B:0xH1234=1</code> AddHits <code>C:</code> <code>C:0xH1234=1</code> SubHits <code>D:</code> <code>D:0xH1234=1</code> AddAddress <code>I:</code> <code>I:0xH1234=1</code> Measured <code>M:</code> <code>M:0xH1234=1</code> Measured% <code>G:</code> <code>G:0xH1234=1</code> MeasuredIf <code>Q:</code> <code>Q:0xH1234=1</code> Trigger <code>T:</code> <code>T:0xH1234=1</code>"},{"location":"Condition-Syntax/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-03-05 08:16] Jamiras:</code> Updated Condition Syntax (markdown)</li> <li><code>[2022-02-04 17:32] Jamiras:</code> Created Condition Syntax (markdown)</li> </ul>"},{"location":"Console-ID-List/","title":"Console ID List","text":"Console ID Name Supported? 001 Mega Drive Yes 002 Nintendo 64 Yes 003 SNES Yes 004 Game Boy Yes 005 Game Boy Advance Yes 006 Game Boy Color Yes 007 NES Yes 008 PC Engine Yes 009 Sega CD Yes 010 32X Yes 011 Master System Yes 012 PlayStation Yes 013 Atari Lynx Yes 014 Neo Geo Pocket Yes 015 Game Gear Yes 016 GameCube 017 Atari Jaguar Yes 018 Nintendo DS Yes 019 Wii 020 Wii U 021 PlayStation 2 Yes 022 Xbox 023 Magnavox Odyssey 2 Yes 024 Pokemon Mini Yes 025 Atari 2600 Yes 026 DOS 027 Arcade Yes 028 Virtual Boy Yes 029 MSX Yes 030 Commodore 64 031 ZX81 032 Oric 033 SG-1000 Yes 034 VIC-20 035 Amiga 036 Atari ST 037 Amstrad CPC Yes 038 Apple II Yes 039 Saturn Yes 040 Dreamcast Yes 041 PlayStation Portable Yes 042 Philips CD-I 043 3DO Interactive Multiplayer Yes 044 ColecoVision Yes 045 Intellivision Yes 046 Vectrex Yes 047 PC-8000/8800 Yes 048 PC-9800 049 PC-FX Yes 050 Atari 5200 051 Atari 7800 Yes 052 X68K 053 WonderSwan Yes 054 Cassette Vision 055 Super Cassette Vision 056 Neo Geo CD 057 Fairchild Channel F 058 FM Towns 059 ZX Spectrum 060 Game &amp; Watch 061 Nokia N-Gage 062 Nintendo 3DS 063 Watara Supervision Yes 064 Sharp X1 065 TIC-80 066 Thomson TO8 067 PC-6000 068 Sega Pico 069 Mega Duck Yes 070 Zeebo 071 Arduboy Yes 072 WASM-4 Yes 073 Arcadia 2001 074 Interton VC 4000 075 Elektor TV Games Compueter 076 PC Engine CD 077 Atari Jaguar CD Yes 078 Nintendo DSi Yes 079 TI-83 080 Uzebox 100 Hubs N/A 101 Events N/A"},{"location":"Console-Specific-Tips-es/","title":"Tips Espec\u00edficos por Consola","text":"<p>Cuando escavamos en memoria en estas viejas consolas ayuda saber que los creadores originales de estos juegos trabajaron en ellos alguna vez. Si te familiarizas bien en la manera en la que trabaja tu consola favorita entonces hacer un set va a resultar mas sencillo y preciso.</p>"},{"location":"Console-Specific-Tips-es/#nes-ranes","title":"NES (RANes)","text":""},{"location":"Console-Specific-Tips-es/#duplicado-de-direcciones","title":"Duplicado de Direcciones","text":"<p>Cuando utilices el inspector de memoria para encontrar variables en juegos de NES, va a ver 4 copias de todo lo que encuentres. Si te estas preguntando \"cual deber\u00eda de utilizar?\" o \"deberia probar cada una de ellas?\" no es tan complicado como parece.</p> <p>Esta es una caracter\u00edstica que el NES le da a los desarrolladores para encontrar mas maneras para buscar en memoria. Porque el NES en si solo tiene 2KB de RAM, el primer resultado (el que va abajo de 0x800) tiene que ser usado para consistencia, y aplicar condiciones adicionales en los otros realmente no hace nada.</p> <p>Esto tambi\u00e9n aplica para RPS y tablas clasificatorias tambi\u00e9n.</p>"},{"location":"Console-Specific-Tips-es/#game-boy-ravba","title":"Game Boy (RAVBA)","text":""},{"location":"Console-Specific-Tips-es/#mapa-de-memoria","title":"Mapa de Memoria","text":"<p>Algunos rangos de valores significan diferentes cosas en el contexto del hardware del Game Boy, as\u00ed que tener un mapa de lo que te puede resultar \u00fatil puede ayudar a eliminar esos valores que no sirven. As\u00ed es como se desplaya:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: Informaci\u00f3n del ROM (No hay raz\u00f3n para utilizarlo. Esta \u00e1rea contiene informaci\u00f3n del header que solamente la leen algunos emuladores.)</li> <li>\u274c 0x8000 - 0x9FFF: Informaci\u00f3n de Gr\u00e1ficos (Algunas veces algunas cosas tal vez tengan sentido si lo que estas buscando es el ID de mapa o animaci\u00f3n , pero siempre va a ver otras maneras mejores de hacer las cosas as\u00ed intenta evitar el uso de cualquiera de estas)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: RAM del Cartucho (Ej. archivos de guardado. Algunas veces utilizar estas direcciones puede ser inevitable porque entonces tu set seria vulnerable a trampas cargando archivos de guardado de 100%. Mas informaci\u00f3n de como proteger tus logros contra archivos de guardado mas adelante)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: RAM de trabajo (Aqu\u00ed esta la bueno; casi todo lo que necesitas se encuentra en este rango)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (No la utilices, mira mas abajo)</li> <li>\u274c 0xFE00 - 0xFE9F: Mas Informaci\u00f3n de Gr\u00e1ficos (lo mismo que informaci\u00f3n de gr\u00e1ficos de arriba)</li> <li>\u274c 0xFEA0 - 0xFFFF: Variado (No lo utilices)</li> </ul> <p>Para mas informaci\u00f3n mira: http://gameboy.mongenel.com/dmg/asmmemmap.html</p>"},{"location":"Console-Specific-Tips-es/#echo-ram","title":"ECHO RAM","text":"<p>Similar que el NES, algunas variables tal vez se muestren mas de una vez cuando te encuentres buscando en el inspector de memoria. El segundo resultado es lo que se le conoce como ECHO RAM, que es un espejo de la memoria actual. Aunque algunos emuladores tienden a ignorar esta \u00e1rea o a emularla incorrectamente, se recomienda NO utilizarla para nada y siempre utilizar el primer resultado.</p> <p>El Game Boy tiene 8KB de RAM empezando en 0xC000. La ECHO RAM empieza en 0xE000, as\u00ed que si tus direcciones empiezan con una E vas a tener que remplazar el primer car\u00e1cter que no tenga un cero con una C. Recuerda: C es lo correcto, E es la echo!</p>"},{"location":"Console-Specific-Tips-es/#gbc","title":"GBC","text":"<p>En el GBC, los 4KB de memoria de 0xD000-0xDFFF son un banco para un bloque de memoria mas grande de 32kb que no es directamente accesible por el procesador. Los Bits 0-2 de 0xFF70 indican cual banco esta cargado en el bloque de memoria 0xD000-0xDFFF. Es una \"funci\u00f3n\" utilizada para expandir el almacenamiento de los ROMs del GBC mientras aun se tiene el soporte para ROMs del GB original.</p> <p>Cambiar de Banco (cambiar el valor de 0xFF70) provoca que la memoria en el rango 0xD000-0xDFFF se actualice. Esto aparece como un flickering/parpadeando en el Visor de Memoria y provoca que la b\u00fasqueda de memoria sea mas complicada. Si estas escribiendo condiciones dependiendo de la memoria que se encuentra en ese bloque, tambi\u00e9n vas a requerir que 0xFF70 tenga un valor en especifico para asegurarte que estas utilizando el banco correcto. Los 4KB de memoria de 0xC000-0xCFFF no se cambian como el banco y pueden ser utilizados sin preocupaciones sin condiciones adicionales.</p> <p>No es muy recomendable que utilices estas direcciones en tus logros si es que cuentas con al menos una alternativa para no utilizarnos. Desde Enero del 2018, RALibretro solamente muestra el banco de 0x00 a 0xFF70. RetroArch a estado fluctuando los bancos de memoria, pero algunos valores no funcionan de la misma manera que en RAVisualBoyAdvance. Al menos asta que RetroArch reciba una inspector de memoria, logros que utilicen direcciones en 0xD000-0xDFFF solamente van a funcionar en RAVisualBoyAdvance.</p>"},{"location":"Console-Specific-Tips-es/#gbgbc-bios","title":"GB/GBC BIOS","text":"<p>RALibRetro y RetroArch cuenta con soporte para el BIOS de GB/GBC, que muestra los logos de \"Nintendo\" y \"GameBoy\" antes de empezar el juego. Esto provee aproximadamente cuatro segundo donde la memoria principal ($C000-$DFFF) aun no a sido inicializada, y podr\u00eda provocar que algunos logros se disparen cuando se cargue el juego por algunos usuarios que tienen el BIOS habilitado.</p> <p>Para habilitar esta caracter\u00edstica, pon el archivo del bios (de nombre <code>gb_bios.bin</code> o <code>gbc_bios.bin</code>) en el folder del directorio del sistema ya sea el de RALibRetro o RetroArch. Cuando empieces el juego, vas a ver los logos de \"Nintendo\" y \"GameBoy\" antes de proceder al juego actual.</p> <p>Si esto te esta causando problemas, tal vez necesites agregar un poco de l\u00f3gica para prevenir que los logros salten cuando se encuentre el jugador en el BIOS, pero seria preferible que agregues l\u00f3gica del juego si es posible (ej. cuando se muestra una pantalla en especifico).</p> <p>El c\u00f3digo del BIOS es cargado en $0000-$00FF, as\u00ed que identifica ese pedazo de memoria cuando est\u00e9s en el BIOS y haz que lo ignore tu logro. Por ejemplo, los \u00faltimos cuatro bytes del bloque del BIOS del GBC son <code>3E 11 E0 50</code>, asi que podr\u00edas agregar esta condici\u00f3n al logro para prevenir que el logro salte cuando el BIOS se encuentra corriendo.</p> <pre><code>32-bit 0x00FC != 0x50E0113E\n</code></pre> <p>Despu\u00e9s de que el BIOS se termina, el bloque es rellenado con puras FF's, y es re-asignado para vectores de interrupci\u00f3n. Para mas detalles, mira Un vistazo a la pantalla de inicio del GameBoy.</p> <p>NOTA: Los \u00faltimos cuatro bytes del BIOS del GB son <code>3E 01 E0 50</code>. As\u00ed que la condici\u00f3n para el BIOS seria:</p> <pre><code>32-bit 0x00FC != 0x50E0013E\n</code></pre>"},{"location":"Console-Specific-Tips-es/#nintendo-64-rap64","title":"Nintendo 64 (RAP64)","text":""},{"location":"Console-Specific-Tips-es/#utilizando-codigos-gameshark-para-direcciones","title":"Utilizando c\u00f3digos GameShark para Direcciones","text":"<p>Los c\u00f3digos de GameShark pueden ser un valioso recurso para encontrar direcciones que no puedes o sientes que no las puedes encontrar. Estos cuentan con 12 caracteres por linea y son sencillamente f\u00e1ciles de compilar.</p> <p><code>[AA][BBBBBB] [CCCC]</code></p> <p>[AA] es el tipo de c\u00f3digo. Esta es una peque\u00f1a instrucci\u00f3n para el GameShark que define que hacer con el siguiente valor. Si entiendes que es lo que hace ese c\u00f3digo GameShark puedes utilizar como ayuda para crear una condici\u00f3n.</p> <ul> <li>80, 88: La direcci\u00f3n es de 8-bit. Pone el valor en [00CC] en la direcci\u00f3n [BBBBBB].</li> <li>81, 89: La direcci\u00f3n es de 16-bit. Pone el valor en [CCCC] en la direcci\u00f3n [BBBBBB].</li> <li>D0: La direcci\u00f3n es de 8-bit. Checa si [00CC] es igual al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D2: La direcci\u00f3n es de 8-bit. Checa si [00CC] es DIFERENTE al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D1: La direcci\u00f3n es de 16-bit. Checa si [CCCC] es igual al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D3: La direcci\u00f3n es de 16-bit. Checa si [CCCC] es DIFERENTE al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> </ul> <p>Aqu\u00ed est\u00e1n algunos ejemplos: * Paper Mario: HP Infinito:</p> <p><code>[80][10F292] [0032]</code></p> <p>Cambia el valor de 8-bit en 0x10F292 a 0x32 (50). Entonces esto significa que el HP de Mario es un valor de 8-bit en 0x10F292.</p> <ul> <li>Donkey Kong 64: Juega como Rambi: </li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Cambia el valor de 8-bit en 0x74E77C a 6. Entonces esto significa que el personaje el cual estas utilizando ahora es un valor de 8-bit en 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Deja presionado L para hacer el Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Estamos revisando este</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Checa si el valor de 8-bit en 0x18BAB5 es igual a 0x20. Esto significa que 0x18BAB5 contiene una variable de presionado de bot\u00f3n y el Bit5 (0x20) corresponde a la L.</p> <p>Anti-GSC y GameHacking los dos son buenos recursos para encontrar c\u00f3digos de GameShark.</p>"},{"location":"Console-Specific-Tips-es/#neo-geo","title":"Neo Geo","text":""},{"location":"Console-Specific-Tips-es/#proteccion-obligatoria-del-unibios","title":"Protecci\u00f3n Obligatoria del UniBIOS","text":"<p>UniBIOS permite severas opciones de desarrollador, y tambi\u00e9n accesa a la base de datos de cheats de cada juego. Por eso mismo todos los logros para Neo Geo necesitan estar protegidos de esto. La soluci\u00f3n mas simple para hacer esto es desabilitar el uso del UniBIOS completamente, directamente desde el c\u00f3digo de logro.</p> <p>Afortunadamente la parte de la data del UniBIOS parece ser reflejada en dos cadenas de direcciones en la RAM: <code>0x00fe30</code> y <code>0x00fe50</code>. Mientras el UniBIOS este activo <code>0x00fe30</code> en 32-bit parece mostrar siempre el mismo valor (para cada uno de los juegos de Neo Geo game) que es <code>80025632</code>, y no parece que cambie despu\u00e9s que el ROM ya fue cargado. Para cualquier otro BIOS, el valor siempre es 0, (excepto en el momento en el que la RAM es cargada de nuevo en el programa de diagnostico, despu\u00e9s de haber cargado el ROM).</p> <p>Para proteger tus logros del uso completo del UniBIOS lo \u00fanico que necesitamos hacer es incluir una simple protecci\u00f3n que se va resetear cuando el valor de 32-bit en <code>0x00fe30</code> no sea igual a <code>0</code>. Esto adicionalmente protege, al logro de que salte durante el proceso de diagnostico de RAM.</p> <p>As\u00ed es como se deber\u00eda de ver la protecci\u00f3n (seleccionada en el Editor de Logros): </p> <p>As\u00ed es como se ve la misma regi\u00f3n de la RAM cuando se utilizan otros BIOS (utilizando MSV): </p>"},{"location":"Console-Specific-Tips-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-23 10:07] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-23 09:59] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-23 09:59] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-22 14:57] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-22 11:42] eldexterr:</code> Created Console Specific Tips es (markdown)</li> </ul>"},{"location":"Console-Specific-Tips-pt_BR/","title":"Dicas Espec\u00edficas de Console","text":""},{"location":"Console-Specific-Tips-pt_BR/#dicas-especificas-do-console","title":"Dicas Espec\u00edficas do Console","text":"<p>Link para texto em ingl\u00eas: Console Specific Tips</p> <p>Ao escavar a mem\u00f3ria desses antigos consoles, ajuda saber em primeiro lugar com o que os criadores originais dos jogos estavam trabalhando. Se voc\u00ea se familiarizar com as peculiaridades do seu console favorito, a configura\u00e7\u00e3o ser\u00e1 mais f\u00e1cil e precisa.</p>"},{"location":"Console-Specific-Tips-pt_BR/#nes-ranes","title":"NES (RANes)","text":""},{"location":"Console-Specific-Tips-pt_BR/#game-boy-ravba","title":"Game Boy (RAVBA)","text":""},{"location":"Console-Specific-Tips-pt_BR/#mapa-de-memoria","title":"Mapa de mem\u00f3ria","text":"<p>Determinadas variedades de valores significam coisas diferentes no contexto do hardware do Game Boy, portanto, ter um mapa  pode ajud\u00e1-lo a eliminar endere\u00e7os in\u00fateis. Aqui est\u00e1 o resumo:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: Dados da ROM (normalmente n\u00e3o h\u00e1 raz\u00e3o para usar. Se voc\u00ea for um desenvolvedor super dedicado, poder\u00e1 usar o valor de 16 bits em 0x14E junto com os grupos alt para oferecer suporte a v\u00e1rias vers\u00f5es / regi\u00f5es da ROM)</li> <li>\u274c 0x8000 - 0x9FFF: Dados gr\u00e1ficos (algumas coisas aqui podem estar correlacionadas com o que voc\u00ea est\u00e1 procurando, se voc\u00ea estiver tentando encontrar uma ID ou anima\u00e7\u00e3o de mapa, mas sempre haver\u00e1 uma maneira melhor de lidar com o que voc\u00ea est\u00e1 fazendo do que usando qualquer um deles)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: Cartridge RAM (ou seja, salvar dados. \u00c0s vezes, usar esses endere\u00e7os ser\u00e1 inevit\u00e1vel, mas o seu conjunto pode ser propenso a fazer batota ao carregar arquivos salvos em 100%. Mais informa\u00e7\u00f5es sobre como proteger contra arquivos salvos)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: RAM de trabalho (as coisas boas; quase tudo que voc\u00ea deve usar cair\u00e1 dentro deste intervalo)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (n\u00e3o use, veja abaixo)</li> <li>\u274c 0xFE00 - 0xFE9F: Mais dados gr\u00e1ficos (igual aos dados gr\u00e1ficos acima)</li> <li>\u274c 0xFEA0 - 0xFFFF: Diversos (n\u00e3o use)</li> </ul> <p>Para mais informa\u00e7\u00f5es, consulte: http://gameboy.mongenel.com/dmg/asmmemmap.html <code>texto em ingl\u00eas</code></p>"},{"location":"Console-Specific-Tips-pt_BR/#echo-ram","title":"ECHO RAM","text":"<p>Similarmente ao NES, certas vari\u00e1veis podem aparecer duas vezes ao pesquisar no Memory Inspector. O segundo resultado est\u00e1 no que \u00e9 chamado de RAM ECHO, que \u00e9 um espelho da mem\u00f3ria real. Como alguns emuladores tendem a ignorar essa \u00e1rea ou emular incorretamente, recomenda-se N\u00c3O us\u00e1-la e sempre usar o primeiro resultado.</p> <p>O Game Boy tem 4KB de RAM a partir de 0xC000. ECHO RAM come\u00e7a em 0xE000, ent\u00e3o se o seu endere\u00e7o come\u00e7ar com um E voc\u00ea vai querer substituir o primeiro caractere diferente de zero por um C. Lembre-se: C est\u00e1 correto, E \u00e9 echo!</p>"},{"location":"Console-Specific-Tips-pt_BR/#nintendo-64-rap64","title":"Nintendo 64 (RAP64)","text":""},{"location":"Console-Specific-Tips-pt_BR/#usando-codigos-gameshark-para-enderecos","title":"Usando c\u00f3digos GameShark para endere\u00e7os","text":"<p>Os c\u00f3digos GameShark podem ser um recurso valioso para encontrar endere\u00e7os que voc\u00ea n\u00e3o pode ou n\u00e3o deseja encontrar. Eles t\u00eam 12 caracteres por linha e s\u00e3o f\u00e1ceis de analisar.</p> <p><code>[AA] [BBBBBB] [CCCC]</code></p> <p>[AA] \u00e9 o tipo de c\u00f3digo. Esta \u00e9 uma breve instru\u00e7\u00e3o para o GameShark que define o que fazer com o pr\u00f3ximo valor. Se voc\u00ea entende o c\u00f3digo do GameShark, voc\u00ea pode us\u00e1-lo para ajudar na cria\u00e7\u00e3o de condi\u00e7\u00f5es.</p> <ul> <li>80, 88: O endere\u00e7o \u00e9 de 8 bits. Define o valor [00CC] para o endere\u00e7o [BBBBBB].</li> <li>81, 89: O endere\u00e7o \u00e9 de 16 bits. Define o valor [CCCC] para o endere\u00e7o [BBBBBB].</li> <li>D0: o endere\u00e7o \u00e9 de 8 bits. Verifica se [00CC] \u00e9 igual ao valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> <li>D2: o endere\u00e7o \u00e9 de 8 bits. Verifica se [00CC] \u00e9 DIFERENTE para o valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> <li>D1: o endere\u00e7o \u00e9 de 16 bits. Verifica se [CCCC] \u00e9 igual ao valor no endere\u00e7o [BBBBBB] e executa a pr\u00f3xima linha, se for.</li> <li>D3: o endere\u00e7o \u00e9 de 16 bits. Verifica se [CCCC] \u00e9 DIFERENTE para o valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> </ul> <p>aqui est\u00e3o alguns exemplos:</p> <ul> <li>Paper Mario: HP infinito:</li> </ul> <p><code>[80] [10F292] [0032]</code></p> <p>Define o valor de 8 bits em 0x10F292 para 0x32 (50). Ent\u00e3o, isso significa que o HP de Mario \u00e9 um valor de 8 bits em 0x10F292.</p> <ul> <li>Donkey Kong 64: Jogando com Rambi:</li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Define o valor de 8 bits em 0x74E77C para 6. Portanto, isso significa que o caractere que voc\u00ea est\u00e1 jogando \u00e9 um valor de 8 bits em 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Seguro L para Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Looking at this one</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Verifica se o valor de 8 bits em 0x18BAB5 \u00e9 igual a 0x20. Isso significa que 0x18BAB5 cont\u00e9m uma vari\u00e1vel de pressionamento de bot\u00e3o e Bit5 (0x20) corresponde a L.</p> <p>Anti-GSC e GameHacking ambos s\u00e3o bons recursos para encontrar c\u00f3digos de GameShark.</p>"},{"location":"Console-Specific-Tips-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-10-11 00:47] CoolCanuck:</code> https</li> <li><code>[2018-03-29 18:29] KingDice001:</code> Updated Console Specific Tips pt_BR (markdown)</li> <li><code>[2018-03-28 21:13] 7Mogami7:</code> Updated Console Specific Tips pt_BR (markdown)</li> <li><code>[2018-03-28 20:45] 7Mogami7:</code> Created Console Specific Tips pt_BR (markdown)</li> </ul>"},{"location":"Console-Specific-Tips/","title":"Console Specific Tips","text":"<p>When excavating the memory of these old consoles it helps to know what the original creators of the games were working with in the first place. If you familiarize yourself with the quirks of your favorite console then set making will be easier and more accurate.</p> <ul> <li>NES<ul> <li>Memory Mirroring</li> </ul> </li> <li>Game Boy<ul> <li>Memory Map</li> <li>ECHO RAM</li> <li>GBC</li> <li>GB and GBC BIOS</li> </ul> </li> <li>Game Boy Advance<ul> <li>Memory Map</li> </ul> </li> <li>Nintendo 64<ul> <li>Using GameShark Codes for Addresses</li> </ul> </li> <li>Nintendo DS</li> <li>Nintendo DSi (Bizhawk)</li> <li>Neo Geo<ul> <li>Mandatory UniBIOS protection</li> </ul> </li> <li>PlayStation</li> <li>PlayStation Portable</li> </ul>"},{"location":"Console-Specific-Tips/#nes","title":"NES","text":""},{"location":"Console-Specific-Tips/#memory-mirroring","title":"Memory Mirroring","text":"<p>When using the memory inspector to find variables for NES games, there will be 4 copies of everything you find. If you're wondering \"which one do I use?\" or \"should I check for all of them?\" it's not as complicated as it seems.</p> <p>This is a feature of the NES that gave developers more ways of looking at memory. Because the NES itself only has 2KB of RAM, the first result (the one below 0x800) should be used for consistency, and applying additional conditions on the others will do nothing.</p> <p>This applies to RPS and leaderboards as well.</p>"},{"location":"Console-Specific-Tips/#game-boy","title":"Game Boy","text":""},{"location":"Console-Specific-Tips/#memory-map","title":"Memory Map","text":"<p>Certain ranges of values mean different things in the context of the Game Boy hardware, so having a map of what's where can help you with eliminating useless addresses. Here's the lowdown:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: ROM Data (No reason to use. This area contains header information that's only read on certain emulators.)</li> <li>\u274c 0x8000 - 0x9FFF: Graphics Data (Some things here might correlate with what you're looking for if you're trying to find a map ID or animation, but there will always be a better way of going about what you're doing than using any of these)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: Cartridge RAM (IE. save data. Sometimes using these addresses will be unavoidable but then your set could be prone to cheating by loading 100% save files. More info on protecting against save files to come)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: Work RAM (The good stuff; almost everything you should use will fall inside this range)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (Do not use, see below)</li> <li>\u274c 0xFE00 - 0xFE9F: More Graphics Data (same as Graphics Data above)</li> <li>\u274c 0xFEA0 - 0xFF7F: Miscellaneous (Do not use)</li> <li>\u2714\ufe0f 0xFF80 - 0xFFFF: Miscellaneous (Okay to use)</li> </ul> <p>For more info see: http://gameboy.mongenel.com/dmg/asmmemmap.html</p>"},{"location":"Console-Specific-Tips/#echo-ram","title":"ECHO RAM","text":"<p>Similarly to the NES, certain variables may show up twice when searching in the Memory Inspector. The second result is in what's called the ECHO RAM, which is a mirror of the actual memory. Since some emulators tend to ignore this area or emulate it incorrectly, it's recommended to NOT use it at all and always use the first result.</p> <p>The Game Boy has 8KB of RAM starting at 0xC000. ECHO RAM starts at 0xE000, so if your address begins with an E you'll want to replace the first non-zero character with a C. Remember: C is correct, E is echo!</p>"},{"location":"Console-Specific-Tips/#gbc","title":"GBC","text":"<p>On the GBC, the 4KB of memory from 0xD000-0xDFFF is a bank from a larger 32KB memory block not directly accessible by the processor. Bits 0-2 of 0xFF70 indicate which bank is loaded into the 0xD000-0xDFFF memory block. It's a \"feature\" used to expand the storage available to GBC ROMs while still supporting GB ROMs.</p> <p>Bank switching (changing the value of 0xFF70) causes the memory in the 0xD000-0xDFFF range to update. This appears as flickering in the Memory Viewer and makes tracking down values in that memory range difficult. If you are writing conditions dependent on memory in that block, you should also require that 0xFF70 have a specific value to ensure you are looking at the correct bank. The 4KB of memory from 0xC000-0xCFFF is not bank-switched and can be used safely without additional conditions.</p> <p>It is not advisable to use these addresses for achievements if there is any alternative to doing so. As of January 2018, RALibretro will only display bank 0x00 at 0xFF70. RetroArch has fluctuating memory banks, but the various addresses do not function in the same manner as RAVisualBoyAdvance. At least until RetroArch receives a memory inspector, achievements using addresses from 0xD000-0xDFFF will only work within RAVisualBoyAdvance.</p>"},{"location":"Console-Specific-Tips/#gb-and-gbc-bios","title":"GB and GBC BIOS","text":"<p>RALibRetro and RetroArch support the GB/GBC BIOS, which shows the \"Nintendo\" and \"GameBoy\" logo before starting the game. This provides approximately four seconds where the main memory ($C000-$DFFF) hasn't been initialized and can't be trusted, and may cause achievements to trigger while loading the game for a subset of users who have the BIOS enabled.</p> <p>To enable this feature, put the bios file (named <code>gb_bios.bin</code> or <code>gbc_bios.bin</code>) into the system directory of either RALibRetro or RetroArch. When you start the game, you will see the \"Nintendo\" and \"GameBoy\" logos before proceeding into the actual game.</p> <p>If this is causing you problems, you may need to add logic to prevent the achievements from triggering while the BIOS is executing, but it would be preferable to use in-game logic if possible (i.e. a specific screen is being displayed).</p> <p>The BIOS code is loaded from $0000-$00FF, so identify some chunk of that memory that's unique while the BIOS is running and ignore it. For example, the last four bytes of the GBC BIOS block are <code>3E 11 E0 50</code>, so you could add this condition to the achievement to prevent it from triggering while the BIOS is running.</p> <pre><code>32-bit 0x00FC != 0x50E0113E\n</code></pre> <p>After the BIOS completes, the block is blanked out with FF's, and repurposed for interrupt vectors. For more detail, see A Look at the GameBoy bootstrap.</p> <p>NOTE: The last four bytes of the GB BIOS are <code>3E 01 E0 50</code>. So the GB condition would be:</p> <pre><code>32-bit 0x00FC != 0x50E0013E\n</code></pre>"},{"location":"Console-Specific-Tips/#game-boy-advance","title":"Game Boy Advance","text":""},{"location":"Console-Specific-Tips/#gba-memory-map","title":"GBA Memory Map","text":"Name Physical Address Range Virtual Address Range Offset (Virtual to Physical) On-chip Working RAM (WRAMC) 0x00000000 - 0x00007fff 0x03000000 - 0x03007fff -0x03000000 On-board Working RAM (WRAMB) 0x00008000 - 0x00047fff 0x02000000 - 0x0203ffff -0x01ff8000 Game Pak SRAM (SRAM) 0x00048000 - 0x00057fff 0x0e000000 - 0x0e00ffff -0x0dfb8000"},{"location":"Console-Specific-Tips/#nintendo-64","title":"Nintendo 64","text":""},{"location":"Console-Specific-Tips/#using-gameshark-codes-for-addresses","title":"Using GameShark Codes for Addresses","text":"<p>GameShark codes can be a valuable resource for finding addresses you can't or don't feel like finding. They have 12 characters per line and are fairly easy to parse.</p> <p><code>[AA][BBBBBB] [CCCC]</code></p> <p>[AA] is the codetype. This is a short instruction to the GameShark that defines what to do with the next value. If you understand what the GameShark code does you can use it to help with condition-making.</p> <ul> <li>80, 88: The address is 8-bit. Sets the value [00CC] to the address [BBBBBB].</li> <li>81, 89: The address is 16-bit. Sets the value [CCCC] to the address [BBBBBB].</li> <li>D0: The address is 8-bit. Checks if [00CC] is equal to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D2: The address is 8-bit. Checks if [00CC] is DIFFERENT to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D1: The address is 16-bit. Checks if [CCCC] is equal to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D3: The address is 16-bit. Checks if [CCCC] is DIFFERENT to the value at address [BBBBBB] then executes the next line if it is.</li> </ul> <p>Here are some examples: * Paper Mario: Infinite HP:</p> <p><code>[80][10F292] [0032]</code></p> <p>Sets the 8-bit value at 0x10F292 to 0x32 (50). So this means Mario's HP is an 8-bit value at 0x10F292.</p> <ul> <li>Donkey Kong 64: Play as Rambi: </li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Sets the 8-bit value at 0x74E77C to 6. So this means the character you're playing as is an 8-bit value at 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Hold L to Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Looking at this one</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Checks if the 8-bit value at 0x18BAB5 is equal to 0x20. This means 0x18BAB5 contains a button press variable and Bit5 (0x20) corresponds to L.</p> <p>Anti-GSC and GameHacking are both good resources for finding GameShark codes.</p>"},{"location":"Console-Specific-Tips/#nintendo-ds","title":"Nintendo DS","text":"<p>Pointers always start with a <code>0x02</code>. For example, a pointer pointing directly to <code>0x13f944</code> will be <code>0x0213f944</code>.</p>"},{"location":"Console-Specific-Tips/#nintendo-dsi-bizhawk","title":"Nintendo DSi (Bizhawk)","text":"<ul> <li>0xfffe00: DSi Mode String ASCII String that identifies the DSi Game being played. Can be used to check if you are in the game rather than on the DSi home screen, etc.</li> </ul>"},{"location":"Console-Specific-Tips/#neo-geo","title":"Neo Geo","text":""},{"location":"Console-Specific-Tips/#mandatory-unibios-protection","title":"Mandatory UniBIOS protection","text":"<p>UniBIOS allows several debugging options, and also access the database of individual cheats for every game. Therefore all achievements for Neo Geo need to be protected from abusing it. The simpliest solution here is disallowing UniBIOS usage completely, directly from the level of achievement code.</p> <p>Fortunately part of UniBIOS data seems to be reflected in two address strings in the RAM: <code>0x00fe30</code> and <code>0x00fe50</code>. While UniBIOS is active <code>0x00fe30</code> in 32-bit size seems to always brings the same value (for every Neo Geo game) which is <code>80025632</code>, and it doesn't seem to change after the ROM was loaded. For any other BIOS, the value is always 0, (except for the moment the RAM is overloaded by the diagnostic program, after the ROM was loaded).</p> <p>To protect achievements from using UniBIOS all we need to do is to include a simple protection which will reset when <code>0x00fe30</code> in 32-bit size is not equal to <code>0</code>. This additionally, eventually protect the achievement from unlocking during RAM diagnostic process.</p> <p>Here is how the protection should look alike (selected in the Achievement Editor): </p> <p>Here is how the same RAM region looks when other BIOS are used (here MSV): </p>"},{"location":"Console-Specific-Tips/#playstation","title":"PlayStation","text":"<p>NOTE: If a core doesn't require a BIOS, this memory may not be initialized.</p> <p>The RAM from $0000-$FFFF is reserved for the kernel. The boot executable name appears to reliably be placed at $9E18 AND $B8B0. The boot executable name almost always contains the disc serial, which is unique per region, so this can often be used to determine which version of a game the player is using. </p> <pre><code>Spyro the Dragon                         SCUS_942.28\n\n9E18 5C 53 43 55 53 5F 39 34 32 2E 32 38 3B 31\n      \\  S  C  U  S  _  9  4  2  .  2  8  ;  1\n\nB8B0 63 64 72 6F 6D 3A 5C 53 43 55 53 5F 39 34 32 2E 32 38 3B 31\n      c  d  r  o  m  :  \\  S  C  U  S  _  9  4  2  .  2  8  ;  1\n</code></pre>"},{"location":"Console-Specific-Tips/#playstation-portable","title":"PlayStation Portable","text":"<p>When working with PSP make sure to check if your game has any DLC as this form of content is able to be accessed by players without altered saves or patched versions of the game and will need to be accounted for and in some cases protected against if it provides advantages that you don't want players to exploit.</p>"},{"location":"Console-Specific-Tips/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-26 13:40] Biendeo:</code> Added a memory map reference for the GBA.</li> <li><code>[2023-06-06 10:58] televandalist:</code> Added ToC</li> <li><code>[2023-05-30 01:46] Riley Nielsen:</code> Add info about Nintendo DS pointers</li> <li><code>[2023-05-04 11:44] The Mystical One:</code> Added information about Nintendo DSi's DSi Mode String.</li> <li><code>[2023-04-14 11:24] The Mystical One:</code> Adjusted the miscellaneous GB section because the upper end of that range is okay to use (and some game devs put some data only there).</li> <li><code>[2023-03-24 20:29] LiquifiedSnow:</code> Updated Console Specific Tips (markdown)</li> <li><code>[2023-03-04 14:25] televandalist:</code> Updated Console Specific Tips (markdown)</li> <li><code>[2023-03-04 13:58] televandalist:</code> Added note about US BIOS for PSX Beetle</li> <li><code>[2020-04-25 09:30] Jamiras:</code> add note about disc serial for PSX games</li> <li><code>[2019-05-13 22:03] Jamiras:</code> small difference in gb vs gbc bios</li> </ul>"},{"location":"Contributing-with-the-docs-es/","title":"Contribuyendo con los documentos","text":"<p>Resumiendo las cosas:</p> <ol> <li>Inicia sesi\u00f3n en tu cuenta de github (o crea una cuenta si no cuentas con una).</li> <li>Edita una pagina (o crea una nueva) en la RAwiki. Tienes que utilizar el lenguaje de marcado Markdown (mas informaci\u00f3n mas abajo).</li> <li>Tarde o temprano un moderador va a generar las paginas para RAdocs.</li> </ol> <p>La diferencia entre RAwiki y RAdocs es explicada en Como funciona la documentaci\u00f3n de RA.</p>"},{"location":"Contributing-with-the-docs-es/#markdown","title":"Markdown","text":"<p>Markdown es un lenguaje de marcado extremadamente ligero y f\u00e1cil de aprender con una sintaxis de formateado de texto simple. Para contribuir en nuestro proyecto tienes que m\u00ednimo conocer los b\u00e1sicos de markdown. Aqui hay una buena pagina de referencia: http://commonmark.org/help/, y aqu\u00ed puedes probar 10 minutos del tutorial.</p> <p>Ademas, esta wiki necesita ser escrita en cierto formato para que as\u00ed se puedan convertir en las bonitas paginas est\u00e1ticas de ya conoces. Esto es debido a que utilizamos mkdocs) y este utiliza el markdown de python y github utiliza el markdown de github, entonces hay algunos peque\u00f1os problemas de formato que se tienen que tomar en cuenta.</p>"},{"location":"Contributing-with-the-docs-es/#encabezados","title":"Encabezados","text":"<p>Los t\u00edtulos (definidos por un <code>#</code>) necesitan seguir una progresi\u00f3n natural de la jerarqu\u00eda del contenido de la pagina. Pero tu NO PUEDES dos encabezados de titulo (esos que tienen solamente un s\u00edmbolo de <code>#</code>). De otra manera no se mostraran en la tabla de contenidos a la derecha de la pagina</p> <p>Ej.</p> <pre><code># Titulo\n## Encabezado principal uno\n### Sub Encabezado uno\n### Sub Encabezado dos\n## Encabezado Principal dos\n</code></pre> <p>etc.</p>"},{"location":"Contributing-with-the-docs-es/#enlaces","title":"Enlaces","text":"<p>Los enlaces tienen que seguir la siguiente sintaxis</p> <pre><code>[Enlace](ruta del enlace.md)\n</code></pre> <p>Nota: Si este es un enlace a otra pagina de la wiki esto se hace con una ruta relativa:</p> <pre><code>[Tips y Trucos](Tips-and-Tricks-es.md)\n</code></pre> <p>NO utilices el URL completo cuando est\u00e9s linkeando a otra pagina de la wiki, como esto (si, este es un ejemplo de lo que NO tienes que llegar a hacer):</p> <pre><code>[Tips y Trucos](https://github.com/RetroAchievements/docs/wiki/Tips-and-Tricks-es)\n</code></pre>"},{"location":"Contributing-with-the-docs-es/#imagenes","title":"Im\u00e1genes","text":"<p>Enlaces para im\u00e1genes tienen que seguir la misma sintaxis que el ejemplo de abajo:</p> <pre><code>![Imagen](http://url/a.png) \n</code></pre> <p>Nota:: Si quieres llegar a almacenar im\u00e1genes para este proyecto de documentaci\u00f3n, puedes publicarlas en este tema de aqu\u00ed y utilizar el hack de almacenamiento de im\u00e1genes de github.</p>"},{"location":"Contributing-with-the-docs-es/#tablas","title":"Tablas","text":"<p>Una tabla simple se mira de esta manera:</p> <pre><code>Primer Encabezado     | Segundo Encabezado     | Tercer Encabezado\n--------------------- | ---------------------- | ---------------------\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\n</code></pre> <p>Y se deber\u00eda de renderizar de esta manera:</p> Primer Encabezado Segundo Encabezado Tercer Encabezado Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda <p>Puedes especificar una formaci\u00f3n en especifico por cada columna agregando dos puntos a las lineas del separador:</p> <pre><code>Primer Encabezado      | Segundo Encabezado       | Tercer Encabezado\n:--------------------- | :----------------------: | ---------------------:\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\n</code></pre> <p>Resultado:</p> Primer Encabezado Segundo Encabezado Tercer Encabezado Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda"},{"location":"Contributing-with-the-docs-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 13:43] eldexterr:</code> Created Contributing with the docs es (markdown)</li> </ul>"},{"location":"Contributing-with-the-docs/","title":"Contributing with the docs","text":""},{"location":"Contributing-with-the-docs/#summing-up","title":"Summing up","text":"<ol> <li>Log into your github account (or create an account if you don't have one).</li> <li>Edit a page (or create a new one) on the RAwiki. You must use the Markdown markup language. Just check the Markdown caveats below.</li> <li>Sooner or later a maintainer will generate the pages for RAdocs.</li> </ol>"},{"location":"Contributing-with-the-docs/#rawiki-and-radocs","title":"RAWiki and RADocs","text":"<p>The RetroAchievements Documentation is divided into two parts:</p> <ol> <li>RetroAchievements wiki</li> <li>RetroAchievements docs</li> </ol> <p>The wiki is where these documents are created and edited. Anyone (with a github account) is able to edit the wiki's content. Then, if you have something to share, please edit the wiki!</p> <p>The RetroAchievements docs website has (almost) the same content as the wiki, but with a more pleasant look. The content of this website is generated by its maintainers using the wiki's content as input.</p> <p>When a change is made in the wiki this change is NOT instantaneously reflected in the docs. The conversion is performed by a maintainer from time to time.</p>"},{"location":"Contributing-with-the-docs/#markdown-caveats","title":"Markdown caveats","text":"<p>Markdown is a lightweight and extremely easy to learn markup language with plain text formatting syntax. In order to contribute in our project you must know at least the basics of markdown. Here is a good one-page reference: http://commonmark.org/help/, and here you can try a 10 minutes tutorial.</p> <p>Moreover, this wiki needs to be written in a certain format in order to convert cleanly to the pretty static pages. It's because we use mkdocs) and it uses python markdown and github uses github flavoured markdown, so there are some minor issues of formatting that will need to be addressed.</p>"},{"location":"Contributing-with-the-docs/#headings","title":"Headings","text":"<p>The headings (defined by <code>#</code>) should follow a natural progression of the hierarchy of the page contents. But you CANNOT have two title headings (those with only one <code>#</code> symbol). Otherwise they won't show up on the table of contents on the right side of the page</p> <p>E.G.</p> <pre><code># Title\n## Main heading one\n### Sub Heading one\n### Sub heading two\n## Main heading two\n</code></pre> <p>etc.</p>"},{"location":"Contributing-with-the-docs/#links","title":"Links","text":"<p>Links should follow this syntax</p> <pre><code>[Link](path to link)\n</code></pre> <p>Note: If it is a link to another wiki page it should be a relative path:</p> <pre><code>[Tips and Tricks](Tips-and-Tricks)\n</code></pre> <p>Do NOT use complete a full URL when linking to another wiki page, like this (yeah, this is an example of you should NOT do):</p> <pre><code>[Tips and Tricks](https://github.com/RetroAchievements/docs/wiki/Tips-and-Tricks)\n</code></pre>"},{"location":"Contributing-with-the-docs/#images","title":"Images","text":"<p>Links to images should follow the same syntax as the example below:</p> <pre><code>![Image](http://url/a.png) \n</code></pre> <p>Note:: In order to host images for this documentation project, you can post them in this issue thread here and use the github image hosting hack.</p>"},{"location":"Contributing-with-the-docs/#tables","title":"Tables","text":"<p>A simple table looks like this:</p> <pre><code>First Header | Second Header | Third Header\n------------ | ------------- | ------------\nContent Cell | Content Cell  | Content Cell\nContent Cell | Content Cell  | Content Cell\nContent Cell | Content Cell  | Content Cell\n</code></pre> <p>It should render like this:</p> First Header Second Header Third Header Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell <p>You can specify alignment for each column by adding colons to separator lines:</p> <pre><code>First Header | Second Header | Third Header\n:----------- |:-------------:| -----------:\nLeft         | Center        | Right\nLeft         | Center        | Right\nLeft         | Center        | Right\n</code></pre> <p>Results:</p> First Header Second Header Third Header Left Center Right Left Center Right Left Center Right"},{"location":"Contributing-with-the-docs/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-29 12:15] meleu:</code> merging \"How RA Documentation Works\" page here</li> <li><code>[2019-02-14 10:53] meleu:</code> fix broken link</li> <li><code>[2018-04-25 07:12] meleu:</code> new link for radocs</li> <li><code>[2018-04-04 15:55] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-04 15:53] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-03 15:20] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-03 15:02] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-02 18:52] meleu:</code> Updated Editing the Wiki (markdown)</li> </ul>"},{"location":"Creating-Entries/","title":"Creating Entries","text":"<p>WIP Page</p> <ul> <li>Naming Conventions<ul> <li>Regional Titles</li> <li>Tags<ul> <li>Multiple Tags</li> <li>Unlicensed vs Hack</li> </ul> </li> <li>Articles and Pipe Separators</li> </ul> </li> <li>Hubs<ul> <li>Linking Bootlegs</li> </ul> </li> </ul>"},{"location":"Creating-Entries/#naming-conventions","title":"Naming Conventions","text":""},{"location":"Creating-Entries/#regional-titles","title":"Regional Titles","text":"<p>When both English and Japanese titles are used in an RA entry's title, the Japanese title should only be first when the game was never officially released in English, making whatever English title used an unofficial title.  - Example: <code>Trials of Mana | Seiken Densetu 3</code>, which is fine because an official English release came much later. Before that, everyone used Secret of Mana 2 as the English title, in which case the RA entry's title would have been <code>Seiken Densetsu 3 | Secret of Mana 2</code>.</p>"},{"location":"Creating-Entries/#tags","title":"Tags","text":"<ul> <li><code>~Demo~</code></li> <li><code>~Hack~</code></li> <li><code>~Homebrew~</code></li> <li><code>~Prototype~</code></li> <li><code>~Test Kit~</code></li> <li><code>~Unlicensed~</code></li> </ul>"},{"location":"Creating-Entries/#multiple-tags","title":"Multiple Tags","text":"<p>In cases where <code>~Demo~</code> or <code>~Prototype~</code> are used alongside <code>~Hack~</code> or <code>~Homebrew~</code>, they are to be listed after the latter. - Example: <code>~Homebrew~ ~Demo~ Bob's Game</code> instead of <code>~Demo~ ~Homebrew~ Bob's Game</code>.  The reason for this is that no matter what stage the game is in, it will always be a homebrew or a hack; therefore, those tags should take priority.</p>"},{"location":"Creating-Entries/#unlicensed-vs-hack","title":"Unlicensed vs Hack","text":"<p>In cases where a game is unlicensed and is actually just a hack of another game, then <code>~Hack~</code> would be used instead of <code>~Unlicensed~</code> - Example: Final Fantasy VII on NES, which is a bootleg/pirate release, but it's actually just a hack of Final Fantasy III that was put on a cartridge. So the RA entry would be Hack Final Fantasy VII.</p>"},{"location":"Creating-Entries/#articles-and-pipe-separators","title":"Articles and Pipe Separators","text":"<p>Since the A/An/The articles are moved to the back of a title (but BEFORE a subtitle), then we should also do this when there is a pipe separator between regional titles.  - Example: instead of <code>Garfield Labyrinth | The Real Ghostbusters | Mickey Mouse IV</code>, which is what it is currently, we use <code>Garfield Labyrinth | Real Ghostbusters, The | Mickey Mouse IV</code>. The reason for this is because we may eventually have a way to set which titles we view by default.</p>"},{"location":"Creating-Entries/#hubs","title":"Hubs","text":""},{"location":"Creating-Entries/#linking-bootlegs","title":"Linking Bootlegs","text":"<p>Bootleg/Pirate games are NOT to be linked to hubs for the series they're ripping off.</p>"},{"location":"Creating-Entries/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-04 20:34] televandalist:</code> Updated Creating Entries (markdown)</li> <li><code>[2023-06-04 20:24] televandalist:</code> Created Creating Entries (markdown)</li> </ul>"},{"location":"Creating-a-Timer-with-Reset-If-Hits-based-on-the-Speed-of-the-Game/","title":"Creating a Timer with Reset If Hits based on the Speed of the Game","text":"<p>In this example you will learn how to create an ingame Timer based on the framerate speed of the game.</p> <p>Every game has an address which is constantly increasing, it functions like a engine in a car which is constantly moving despite what you do and starts as soon you start the game, the game itself is your car and some cars are faster than others.</p> <p>Please note that PAL Games (50hz) have a lower framerate than NTSC Games (60hz) and aren't compatible with this method. It is recommended to create every Timer based on the NTSC version of the game, unless PAL version is the only version existing and there is no NTSC Patch available.</p> <p>Addresses</p> <ul> <li><code>0x19</code>: Demo Mode: <code>01</code>=Active, <code>00</code>=Inactive</li> <li><code>0x1a</code>: Game Engine (speed based on framerate)</li> <li><code>0x25</code>: Game Paused: <code>01</code>=Yes. <code>00</code>=No</li> <li><code>0x2c</code>: Game Progression: <code>03</code>=Before Stage starts, <code>04</code>=Stage started, <code>08</code>=Stage finished</li> <li><code>0x30</code>: Stage ID (in this example, Stage 1)</li> </ul> <p></p> <p>Link to Cheevo: Contra Speedrun</p> <p>YouTube: ResetIfHits Demo: Contra Stage 1 60 seconds Speedrun </p> <p>Conditions</p> <ol> <li> <p>Activates the Cheevo's 'Hit' when entering a Stage (<code>03</code>only appears once in each Stage).</p> </li> <li> <p>Triggers the Cheevo when a Stage has been finished.</p> </li> <li> <p>Current Stage (in this example, Stage 1).</p> </li> <li> <p>Paused the Cheevo if the Game is 'Paused' (Stops the Timer in the Cheevo).</p> </li> <li> <p>Resets the Cheevo if <code>60</code> seconds <code>3600</code> Hits are reached. <code>1</code> second = <code>60Hits</code> (NTSC 60fps), <code>50Hits</code> (PAL 50fps).</p> </li> <li> <p>Resets the Cheevo if <code>Demo Mode</code> is active.</p> </li> <li> <p>Resets the Cheevos Timer when entering a new Stage.</p> </li> </ol>"},{"location":"Creating-a-Timer-with-ResetIf-Hits-based-on-the-Speed-of-the-Game-es/","title":"Creando un Temporizador con un ResetIf Hits bas\u00e1ndote en la Velocidad de un Juego","text":"<p>En este ejemplo vas a aprender como crear un temporizador dentro del juego en base a la velocidad del framerate speed del juego.</p> <p>Cada juego tiene una variable que esta constantemente aumentando, esta funciona como el motor de un carro, se esta constantemente moviendo sin importar lo que est\u00e9s haciendo y empieza tan pronto como inicias el juego, el juego en si es tu carro y varios carros son mas r\u00e1pidos que otros.</p> <p>Ten en cuenta que juegos PAL (50hz) tiene un framerate mas bajo a los juegos NTSC (60hz) y no son compatibles con este m\u00e9todo. Es recomendable crear cada temporizador utilizando la versi\u00f3n NTSC  del juego, a menos que la versi\u00f3n PAL sea la uncia versi\u00f3n existente y no exista un parche NTSC disponible.</p> <p>Variables (Addresses)</p> <ul> <li><code>0x19</code>: Modo Demo: <code>01</code>=Activo, <code>00</code>=Inactivo</li> <li><code>0x1a</code>: Motor del Juego (velocidad basada en el framerate)</li> <li><code>0x25</code>: Juego Pausado: <code>01</code>=Si. <code>00</code>=No</li> <li><code>0x2c</code>: Progresion del Juego: <code>03</code>=Antes que empiece el Stage, <code>04</code>=Stage iniciado, <code>08</code>=Stage terminado</li> <li><code>0x30</code>: ID de Stage (en este ejemplo, Stage 1)</li> </ul> <p></p> <p>Link al Logro: Contra Speedrun</p> <p>YouTube: ResetIfHits Demo: Contra Stage 1 60 segundos Speedrun </p> <p>Condiciones</p> <ol> <li> <p>Se activa el Hit del Logro cuando se entra al Stage (<code>03</code>solo aparece una vez por cada Stage).</p> </li> <li> <p>Salta el Logro cuando un Stage a sido terminado.</p> </li> <li> <p>Stage Actual (en este ejemplo, Stage 1).</p> </li> <li> <p>Pausa el logro si el juego esta Pausado' (Pausa el Temporizador en el Logro).</p> </li> <li> <p>Resetea el logro si se alcanzan <code>60</code> segundos (<code>3600</code> Hits). <code>1</code> segundo = <code>60Hits</code> (NTSC 60fps), <code>50Hits</code> PAL 50fps).</p> </li> <li> <p>Resetea el logro si el <code>Modo Demo</code> esta activo.</p> </li> <li> <p>Resetea el Temporizador del Logro cuando se entra a un nuevo Stage.</p> </li> </ol>"},{"location":"Creating-a-Timer-with-ResetIf-Hits-based-on-the-Speed-of-the-Game-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:16] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Delta-Values-es/","title":"Valores Delta","text":"<p>Un valor <code>Delta</code> es el valor del fotograma (frame) pasado. Nota: cuando utilizas <code>Delta</code> es implicito que te refieras a una direccion y no a un valor.</p> <p>Ejemplos de como puede ser utilizado:</p> <ul> <li>Detectar si el nivel a sido incrementado: <code>nivel &gt; nivel delta</code>. A lo que significas \"el nivel actual es mas grande que el nivel encontrado en el fotograma pasado\".</li> <li>Detectar da\u00f1o: <code>salud &lt; salud delta</code>. Que significa \"la salud actual es mas peque\u00f1a la salud encontrada en el fotograma pasado\". O simplemente puedes poner el antiguo valor del fotograma como un requisito. <code>salud delta = 1</code> que significa \"el valor de salud tiene que ser 1 en el fotograma pasado para que salte el logro.\"</li> </ul> <p>En la seccion de Ejemplos Reales hay algunos buenos ejemplos:</p> <ul> <li>Utilizando Hit Counts como un Contador</li> <li>Utilizando Valores Delta y Hit Counts para detectar un Incremento</li> <li>Simple ejemplo de como evadir el abuso en Estados de Guardado (Load States)</li> </ul>"},{"location":"Delta-Values-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:38] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Delta Values ES (markdown)</li> </ul>"},{"location":"Delta-Values/","title":"Delta Values","text":"<p>A <code>Delta</code> value is the previous frame's value. Note: when you use <code>Delta</code> it is implicit that you are referring to an address and not a value.</p> <p>Examples of how it can be used:</p> <ul> <li>Detect if the level has been increased: <code>level &gt; delta level</code>. It means \"current level  is greater than the previous frame's level\".</li> <li>Detect damage: <code>health &lt; delta health</code>. It means \"current health is smaller than the previous frame's health\". Or you can just make the previous frame's value a requirement. <code>health delta = 1</code> means \"the previous frame's value for health must be 1 when the achievement pops up.\"</li> </ul> <p>In the Real Examples section there are some good examples:</p> <ul> <li>Using Hit Counts as a Timer</li> <li>Using Delta Values and Hit Counts to Detect an Increment</li> </ul>"},{"location":"Delta-Values/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 10:37] televandalist:</code> Removed link to a page that doesn't exist</li> <li><code>[2019-02-18 16:53] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:22] meleu:</code> Created Delta Values (markdown)</li> </ul>"},{"location":"Dev-CoC---Frequently-Asked-Questions/","title":"Dev CoC   Frequently Asked Questions","text":"<p>This page is intended to address questions asked about the Dev CoC, as well as expand on points made, usually to clarify guidelines concerning \"special cases.\" It's a brand new page, so give it some time!</p>"},{"location":"Dev-CoC---Frequently-Asked-Questions/#unwelcome-concepts","title":"Unwelcome Concepts","text":""},{"location":"Dev-CoC---Frequently-Asked-Questions/#regarding-unfinished-sets","title":"Regarding Unfinished Sets","text":"<ul> <li>Q: How does the policy about unfinished sets affect compilation games, such as Intellivision Classic Games (PlayStation)?</li> <li>A: If at least one game in the compilation adheres to said policy, then there's no need to worry. A \"proper\" compilation set would take a long time to develop, so adding achievements for one or two games at a time seems like an expected workflow. </li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/","title":"DevJam I \u2010 SG\u20101000","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2023-07-01</li> <li>Launch Date: 2023-09-30</li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#point-system","title":"Point System","text":"<p>Max Earnable Points: 6</p> <p>This table details earnable points for the SG-1000 DevJam:</p> Points Set Submission 2 Licensed Games 1 Collaboration\u2022 1 point per dev\u2022 Must be evenly split 1 Subsets, Homebrews, Unlicensed Games 1 Hacks, Prototypes, Demos 1 Late Submissions\u2022 Sets can still qualify up until the following DevJam's launch date!"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#quarterly-goals","title":"Quarterly Goals","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Current quarterly goals:</p> Point Value Quarterly Goal Details 2 Double the amount of existing sets 26 sets 1 Develop sets for all SG-1000 games with set requests \u2022 Bomb Jack\u2022 Elevator Action\u2022 Flicky\u2022 Q-Bert\u2022 Rock N' Bolt\u2022 Sinbad Mystery\u2022 Yie Ar Kung-Fu\u2022 Yie Ar Kung-Fu II 1 Develop sets for all SG-1000 games released in 1983 \u2022 Borderline\u2022 Champion Baseball\u2022 Champion Golf\u2022 Champion Tennis\u2022 ~Congo Bongo~\u2022 Exerion\u2022 Mahjong\u2022 Monaco GP\u2022 N-Sub\u2022 <sub>Pacar</sub>\u2022 Pachinko\u2022 Pop Flamer\u2022 Safari Hunting\u2022 ~Sega Flipper~\u2022 <sub>Sega-Galaga</sub>\u2022 ~Serizawa Hachidan no Tsume Shougi~\u2022 Sindbad Mystery\u2022 ~Space Slalom~\u2022 Star Jacker\u2022 Yamato\u2022 Zippy Race 1 Develop sets for all Othello Multivision Games \u2022 007 James Bond\u2022 Challenge Derby\u2022 Guzzler\u2022 Okamoto Ayako no Match Play Golf\u2022 Othello\u2022 Q-Bert\u2022 San-nin Mahjong\u2022 Space Armor\u2022 Space Mountain"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#stats","title":"Stats","text":"<p>as of 2023-07-01 (start date) - Current number of sets: 26   - 18 licensed games, 4 homebrews, and 4 unlicensed games. - Current number of achievements: 660 worth 5912 points. - Current number of leaderboards: 168</p> <p>as of 2023-09-30 (end date) - Current number of sets: 88   - 63 licensed games, 1 subset, 14 homebrews, and 10 unlicensed games. - Current number of achievements: 1,644 worth 14,511 points. - Current number of leaderboards: 272</p>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/","title":"DevJam II \u2010 Sega Saturn","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2023-10-01</li> <li>Launch Date: 2024-01-31</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#point-system","title":"Point System","text":"<p>Max Earnable Points: 8</p> <p>This table details earnable points for the Saturn DevJam:</p> Points Set Submission 4 Licensed RPGs 3 Other Licensed Games 2 Collaboration\u2022 2 points per dev\u2022 Must be evenly split 2 Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed Games 2 Late Submissions (Licensed Games)\u2022 Sets can still qualify up until the following DevJam's launch date! 1 Late Submissions (Collabs, Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed)"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#quarterly-goals","title":"Quarterly Goals","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Goals that are focused on getting the number of sets to a certain number will grant bonus points to everyone who does a set, even after that goal is met. See the Sega Saturn goals here.</p>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#stats","title":"Stats","text":"<p>as of 2023-10-01 (start date) - Current number of sets: 65   - 61 licensed games, 1 subset, 2 homebrews, and 1 demo. - Current number of achievements: 3,505 worth 29,853 points - Current number of leaderboards: 348</p> <p>as of 2024-01-31 (end date) - Current number of sets: 128   - 117 licensed games, 7 subsets, 2 homebrews, 1 prototype, and 1 demo. - Current number of achievements: 6,370 worth 53,047 points - Current number of leaderboards: 869</p>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/","title":"DevJam III \u2010 PC Engine and PC Engine CD","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2024-02-01</li> <li>Launch Date: 2024-04-30</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#point-system","title":"Point System","text":"<p>Max Earnable Points: 6</p> <p>This table details earnable points for the Saturn DevJam:</p> Points Set Submission 3 Licensed Games 2 Collaboration\u2022 2 points per dev\u2022 Must be evenly split 2 Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed Games 2 Late Submissions (Licensed Games)\u2022 Sets can still qualify up until the following DevJam's launch date! 1 Late Submissions (Collabs, Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed)"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#quarterly-goals-wip","title":"Quarterly Goals (WIP)","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Goals that are focused on getting the number of sets to a certain number will grant bonus points to everyone who does a set, even after that goal is met. See the PC Engine and PC Engine CD goals here.</p>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#stats","title":"Stats","text":"<p>as of 2024-02-01 (start date) - Current number of sets:     - PC Engine: 94 (85 licensed games, 1  unlicensed game, 2 subsets, and 6 homebrews)     - PC Engine CD: 38 (35 licensed games, 1 unlicensed game, and 2 homebrews) - Current number of achievements:     - PC Engine: 3,222 achievements worth 33,103 points     - PC Engine CD: 1,782 achievements worth 15,663 - Current number of leaderboards:     - PC Engine: 225     - PC Engine CD: 91 - Current number of open tickets: 4     - PC Engine: 15     - PC Engine CD: 4</p>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam/","title":"DevJam","text":"<ul> <li>Basic Info</li> <li>Time and Duration</li> <li>Guidelines</li> <li>The Badge</li> <li>FAQ</li> <li>DevJam List</li> <li>Planned DevJams</li> <li>See Also</li> </ul>"},{"location":"DevJam/#basic-info","title":"Basic Info","text":"<p>DevJam is an ongoing developer event that is heavily inspired by our console rollouts: Developers sign up, get locked into developing sets for a specific console, get signed off once completed, and then we release all the sets at once on the launch date. However, with DevJam, the primary focus will be rollouts for supported consoles that did not get them. Some DevJams will focus on a single console. Others may focus on two consoles.</p> <p>Once we \"break even\" and run out of consoles, the focus will shift to quarterly goals, completing sets for hubs, genre-specific crunch times, etc.</p>"},{"location":"DevJam/#time-and-duration","title":"Time and Duration","text":"<p>DevJams will take place quarterly. The first one started July 1st, 2023 with a launch date of September 30th, 2023, the second one will be October 1st, 2023 through December 31st, 2023, etc.</p>"},{"location":"DevJam/#guidelines","title":"Guidelines","text":"<ul> <li>Notify the event host(s) when you make a claim!</li> <li>Sets claimed for the event will be marked as \"Free Rollout\" claims so they will not count against a developer's claim total. However, they will only be \"free\" during that quarter! Early and existing claims won't be marked as \"free\" until the start of the quarter. If a set isn't done in time for launch, it will become a standard claim. Also, like rollouts, devs can only have one free claim at a time!</li> <li>Once a set has been signed off, it will be marked as \"Release Scheduled\" and is to be promoted on the launch date.</li> <li>Event host(s) may request permission to promote your set(s) to core on the launch date in case you are unavailable.</li> <li>If a set is promoted early, it will be disqualified from DevJam. The developer may make another submission if they wish.</li> </ul>"},{"location":"DevJam/#the-badge","title":"The Badge","text":"<ul> <li>The event badge consists of 24 achievements and each achievement will be unlocked for every point earned at the end of the quarter.</li> <li>There will be at least 6 earnable achievements per quarter. These can be split up, which allows for devs to take part in the event at their own pace, but will require some dedication. They could get 1 achievement in the first quarter, 3 in the second quarter, 2 in the third quarter, etc.</li> <li>Point values may vary between quarters depending on the console(s) selected.</li> <li>A chart detailing the current quarter's point system is at the bottom of this page.</li> </ul>"},{"location":"DevJam/#faq","title":"FAQ","text":"<p>Are late submissions still eligible for bonus points from Quarterly Goals? - They wouldn't be quarterly goals then, would they? No.</p> <p>Can I double-dip with DevQuest, CL100, and other events? - Yes.</p> <p>Will there be a second badge? - If this goes well and there's enough demand for a 'Round Two' badge, sure.</p> <p>Can Junior Devs participate? - The nature of the event goes against several aspects of the Junior Dev program so as of now, no. - Junior Devs may feel encouraged to rush a set. - The promotion of Junior Dev sets is a big part of the process so having a set be \"Release Scheduled\" would waste a lot of time. - Code Reviewers would need to work around the DevJam schedule. - The amount of Junior Devs that end up losing the role due to inactivity or do 1-2 sets and disappear far outnumber those who stick around to get full dev. This could result in locked claims!</p>"},{"location":"DevJam/#devjam-list","title":"DevJam List","text":"<p>Check the links here for console-specific guidelines and info:</p> Number Quarter Console(s) Number of Participants Sets Promoted 01 2023-07-01 - 2023-09-30 Sega SG-1000 30 60 02 2023-10-01 - 2024-01-31 Sega Saturn 28 56 03 2024-02-01 - 2024-04-30 PC Engine/PC Engine CD TBA TBA 04 TBA TBA TBA TBA"},{"location":"DevJam/#planned-devjams","title":"Planned DevJams","text":"<p>Solo Console DevJams: - 3DO - PC-8001/8801 - Apple II - MSX - Arcade - Famicom Disk System</p> <p>Multi-Console DevJams: - Sega CD | Sega 32X - Master System | Game Gear - Neo Geo Pocket | WonderSwan | Atari Lynx - Atari 2600 | Atari 7800 | Atari Jaguar - ColecoVision | Intellivision</p> <p>End of the Line for Console-Specific DevJams: - \"Bottom of the Barrel\" (Pokemon Mini, Virtual Boy, Magnavox Odyssey2, PC-FX) - \"The Magnificent Seven\" (Mega Drive, Nintendo 64, SNES, Game Boy, Game Boy Advance, Game Boy Color, NES)</p>"},{"location":"DevJam/#see-also","title":"See Also","text":"<ul> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevQuests/","title":"DevQuests","text":""},{"location":"DevQuests/#what-are-devquests","title":"What are DevQuests?","text":"<p>They're achievement development-related quests that developers can take part in at any time. Each one has a specific goal and upon reaching that goal, the achievement developer will earn the badge. </p>"},{"location":"DevQuests/#general-rules","title":"General Rules","text":"<ul> <li>All work done for for DevQuests must adhere to the Developer CoC. </li> <li>Put effort into what you do. Submitting shoddy work for the sake of getting a badge ASAP will result in penalties that could lead to disqualifications. </li> <li>All sets submitted for DevQuest must be full sets. No progression-only!</li> <li>By default, hacks, homebrews, prototypes, unlicensed, and subsets do not count. Exceptions vary per DevQuest and will be explicitly stated.</li> <li>Be respectful and responsible. The overall point to DevQuests is to improve existing work as well as generate new content. Let's stick to that.</li> <li>DevQuests do not stack with each other, but may stack with other events such as The Unwanted, Challenge League, or Daily DistRActions. So far, the only exceptions are DevQuest 004 - Veteran Developer and DevQuest 015 - Console Conqueror.</li> </ul>"},{"location":"DevQuests/#reporting","title":"Reporting","text":"<ul> <li>DevQuests that involve making new sets are generally reported by contacting the DevQuest team on site or on Discord. </li> <li>If a DevQuest has a specific contact point, they will be stated. </li> </ul>"},{"location":"DevQuests/#schedule-and-announcements","title":"Schedule and Announcements","text":"<ul> <li>DevQuests do not have a specific release schedule. Typically, they are announced shortly after their badge has been completed. </li> <li>New DevQuests and any updates to existing DevQuests will be announced in <code>#developer-news</code> on the RetroAchievements Discord and site news </li> </ul>"},{"location":"DevQuests/#the-quests","title":"The Quests","text":"Badge Number Name Info 001 Ticket Massacre(Badge-Based) Resolve/close 50 tickets\u2022 Falsifying ticket closures will result in disqualification\u2022 The following do not count toward the total: Network issues, tickets for achievements you developed, tickets you opened, tickets closed on behalf of Junior Developers, and tickets closed as a result of ticket spamming. 002 Summer Set Repair(Badge-Based) Repair 3 sets from provided batch\u2022 Upon selecting a game, you will be presented with a list of repairs that need to be made for the set\u2022 This DevQuest follows standard revision procedures\u2022 Resolve any open tickets for achievements that are kept in the set. Tickets for achievements being left demoted can simply be closed with the reason for demotion cited.\u2022 Revisions must fix all broken logic of kept achievements, fix broken challenges, etc. 003 Singles In Your Area(Badge-Based) Tighten up the logic for 20 single-condition achievements\u2022 Do not just add a bad and/or redundant condition and call it a day. They will be checked.\u2022 These do not require a revision vote since it is only tightening logic\u2022 Achievements cannot be your own; you should fix those anyway! 004 Veteran Developer(Achievement-Based) This DevQuest consists of several passive goals, each one being their own achievement, which are as followed:1. Has published at least 1000 achievements and worked on at least 25 sets as the sole or majority developer2. Has created achievements for at least ten different console IDs3. Has been an active developer for at least two years4. At least 85% of sets have dynamic rich presence (Vet Dev I required)5. Yielded unlocks have exceeded 50,0006. As a sole developer, submitted one or more sets for code review and received an overall grade of at least 207. Has used at least 75% of all currently available flags and features (Vet Dev I and VI required)8. Has obtained at least two DevQuest badges\u2022Note: A constantly evolving toolkit means that these requirements are subject to change at any time 005 Trigger Happy(Badge-Based) Update 20 sets with the Trigger and Measured flags\u2022 They need to actually make sense\u2022 You can do your own sets, but each one counts as half a set. 006 The Unwanted(Badge-Based) Develop a set for an unpopular system assigned to you at random\u2022 Eligible systems: PC Engine, PC Engine CD, Sega CD, 32X, Atari Lynx, Neo Geo Pocket, Neo Geo Pocket Color, Game Gear, Atari Jaguar, Virtual Boy, MSX/MSX2, SG-1000, Apple II, Saturn, 3DO, ColecoVision, Intellivision, Vectrex, PC-8800, Atari 7800, WonderSwan, and WonderSwan Color\u2022 No hacks or homebrew unless those are the only types of games left without sets.There are two ways to be able to re-spin:1. If your selected console is Atari Jaguar, Sega 32X, or Sega Saturn. The first two are fairly problematic to dev for and the last is a resource hog that many people have trouble running just to play, much less dev to set2. If your claim expires or you drop your claim. The penalty for dropping a set is still having to wait until the claim would have expired before getting a re-spin. For example, if you claim a set on September 1st and drop it on November 1st, you'll still need to wait until December 1st before the re-spin. You can only do this once 007 Most Wanted(Badge-Based) Develop a set for one of the most requested games. Must be in RANews at the time of claiming it\u2022 If you already have one claimed you must be under 50% progress for it to count 008 World Traveler(Badge-Based) Develop two sets for games that were never officially released in English\u2022 Games with translation patches DO count!\u2022 Hacks and hombrew do not count. Unlicensed titles may count as long as they are not blatant bootleg ports or hacks of another game. If you're unsure then ask!\u2022 If a game was released in English on another platform with RetroAchievements support, half credit may be granted. Games that only released in English on unsupported platforms will receive full credit. 009 Launch Party!(Badge-Based) Develop a set for a newly supported console within 6 months of RA support\u2022 PSP window: 2021-10-01 through 2022-04-01\u2022 Dreamcast window: 2022-02-12 through 2022-08-12\u2022  Amstrad CPC window: 2022-03-28 through 2022-09-28\u2022 Arduboy and WASM-4 window: 2022-05-08 through 2022-11-08 010 It Takes Two(Badge-Based) Join forces with other developers to publish two collab sets\u2022 Sets must have a fair share of the work done by each dev involved\u2022 Each developer must publish at least 20 achievements to countAchievements must make sense; no fluff to fulfill requirement! 011 Happy Birthday RA!(Badge-Based) Develop a set for the Mega Drive/Genesis to celebrate the anniversary of RA's first achievement\u2022 Must be either full sets or a major/significant revision\u2022 Sega CD and Sega 32X games are not eligible.\u2022 Neither are those Sega 32X CD games (nice try!)\u2022 If you already have one claimed, you must be under 50% progress for it to count\u2022 Collabs are allowed so long as the work is visibly split. 012 Hacker's Habit(Badge-Based) Create two new sets for robust hacks.\u2022 Sets intended for this quest must be complete and encompass all notable content specific to the hack.\u2022 Acceptable hacks must be either complete overhauls that drastically change the level design, or introduce new mechanics that greatly change how you progress through the game.\u2022 Meme hacks, single-level hacks, and other small modifications aren't eligible.\u2022 You're limited to one hack per franchise. As an example, if you create a set for an SMW or Mega Man 2 hack, you can't make a second one for SM64 or Mega Man 3. 013 complete.me(Badge-Based) Provide significant content to three sets that are progression-only or were demoted due to being incomplete.\u2022 Choose from a provided list or grab one from a hub, just make sure you let us know when you start so we can mark it!\u2022 Must go through the revision process as per usual!\u2022 Make sure you take care with the set and don't just throw in a bunch of filler\u2022 Don't hesitate to contact us with any questions or suggestion 014 Laudable Leaderboards(Badge-Based) Create leaderboards for 10 games that currently do not have any!\u2022 Cover different game modes/difficulties when applicable.\u2022 Try to cover leaderboards that make sense for the game. Some examples:- For Arcade-type games it is fine to just add High Score leaderboards, possibly highest in a single life- For Racing games time trials for tracks are pretty standard- Speedruns for Platformers- Minigames that track high scores or time are good candidates- And so on. Reach out if you have any questions about a specific game\u2022 You can do your own sets for half-credit as long as they were published prior to this DevQuest (2022-03-02)\u2022 Please leave comments on set page for what you added for log purposes 015 Console Conqueror(Achievement-Based) Publish a set for every supported console on RetroAchievements\u2022 Each console ID will have an achievement associated with it. Newly supported console IDs means new achievements!\u2022 Contact us to opt-in to being tracked for this. There will generally be no need for reports.\u2022 The only requirement for an unlock is that you are the sole or majority developer of a set on that console ID. Collabs require at least 20 achievements made. For the more dire consoles, specific requirements are in the achievements themselves.\u2022 This DevQuest is 100% retroactive! Potential future revisions of your work will not count against you, so no worries about losing eligibility for an unlock."},{"location":"DevQuests/#suggestions","title":"Suggestions","text":"<ul> <li>If you have suggestions for a DevQuest, send a message to the DevQuest account with the following info:<ul> <li>Quest Name</li> <li>Award Type - If there is one specific goal then you would want a badge-based award. If there are multiple goals then you would want an achievement-based award. </li> <li>Game Type - State whether hacks, homebrews, prototypes, unlicensed, and/or subsets are allowed.</li> <li>Goal(s) - A brief description of the DevQuest. Examples: \"Develop a set for such-and-such console,\" \"Develop a Holiday-Themed Set,\" \"Create Dynamic Rich Presence for 10 Games,\" etc.</li> <li>Rules - List any specific guidelines and criteria that submissions must meet. Is there a minimum achievement count? Are there minor exceptions that result in half-credit? Do submissions need to be pre-approved? The more simple they are, the better!</li> </ul> </li> </ul>"},{"location":"Developer-Docs/","title":"Developer Docs","text":"<p>If you want to be an achievement developer, check here how to become a developer.</p> <p>Every Developer must know and adhere the Developer's Code of Conduct.</p> <p>Now a brief description some pages you'll see in this section.</p> <ol> <li> <p>How to Become an Achievement Developer: overview of the steps required in obtaining developer status</p> </li> <li> <p>Getting Started as an Achievement Developer: it's for the very first contact with cheevos development tools (Memory Inspector and other Achievements dialogs). IF YOU ARE A COMPLETE NEWBIE, START HERE!</p> </li> <li> <p>Achievement Scoring: a guide to deciding point totals for achievements</p> </li> <li> <p>Memory Inspector Overview: detailed look at one of an achievement developer's most used tools.</p> </li> <li> <p>Achievement Logic Features: describes the available tools a developer have in order to improve the logic behind the achievements, such as delta values, hit counts, ResetIf, PauseIf, Alt groups, etc.</p> </li> <li> <p>Real Examples: showing real examples and breaking down the logic behind them. AWESOME LEARNING RESOURCE!</p> </li> <li> <p>Achievement Templates: some generic templates to get inspiration.</p> </li> <li> <p>Tips and Tricks: general tips and tricks about memory digging and achievement creation.</p> </li> <li> <p>Difficulty Scale and Balance: guidelines/suggestions on how to balance the difficulty of your achievement set.</p> </li> <li> <p>Achievement Design: a guide on how to think about and design good achievements, not the technical side but the conceptual.</p> </li> <li> <p>Set Development Roadmap: suggestions of steps to take in order to create a really neat achievement set.</p> </li> <li> <p>Achievement Set Revisions: information on revisions, rescores, and the icon gauntlet.</p> </li> <li> <p>Subsets: an advanced topic on creating special challenge sets and how to release them.</p> </li> <li> <p>Badge and Icon Creation: some guidelines and tips about badge/icon creation.</p> </li> <li> <p>Leaderboards: instructions on how to create Leaderboards for a game.</p> </li> <li> <p>Rich Presence: how to write Rich Presence Scripts.</p> </li> <li> <p>Working with the Right ROM: information on using correct ROMs and hashes.</p> </li> <li> <p>Game Identification: details on the hashing methods used for each system.</p> </li> <li> <p>Emulator Support and Issues: details on both supported and unsupported cores, testing progress, etc.</p> </li> <li> <p>Achievements for ROM Hacks:  a detailed guide for developers on the proper inclusion (and approval) of ROM Hacks.</p> </li> <li> <p>Console Specific Tips: knowing the peculiarities of your favorite console can help you with memory digging.</p> </li> </ol>"},{"location":"Developer-Docs/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-08 03:08] televandalist:</code> Updated Developer Docs (markdown)</li> <li><code>[2023-06-08 03:07] televandalist:</code> Updated Developer docs (markdown)</li> <li><code>[2017-11-28 08:41] meleu:</code> Destroyed Developer Docs (markdown)</li> <li><code>[2017-11-28 08:36] meleu:</code> Created Developer Docs (markdown)</li> </ul>"},{"location":"Developer-Projects/","title":"Developer Projects","text":""},{"location":"Developer-Projects/#entries-that-have-been-re-linked-or-checked-by-developers","title":"Entries that have been re-linked or checked by Developers","text":"<p>Dev Checked and Relinked MD5s list</p> <p>Recently game linking has been restricted to developers only. (Something many of us have been requesting for some time.) This creates new solutions, problems and responsibilities for all of us developers.</p> <p>What needs to happen over time is that every entry is checked that is only has supported ROMs linked to it. Many entries have unsupported ROMs and Trainers linked to them which cause bugs and allow for cheating.</p> <p>This Shared document linked is how we will keep track of the entries that have been reviewed by a developer, unlinked and then relinked with the correctly entries, when necessary.</p>"},{"location":"Developer-Projects/#battery-savecode-protection","title":"Battery Save/Code Protection","text":"<p>The goal is implement protections so that no one can unlock groups of achievements from a save file or by using passwords. A list of games that need save protection: Open gSheet master list</p>"},{"location":"Developer-Resources/","title":"Developer Resources","text":""},{"location":"Developer-Resources/#helpful-website-links","title":"Helpful Website Links","text":"<ul> <li>https://datacrystal.romhacking.net/wiki/Main_Page  - Defined RAM maps of many games.  </li> </ul> <ul> <li>http://www.thealmightyguru.com/Games/Hacking/Wiki/index.php?title=Category:Games - Defined RAM maps of many NES games.  </li> </ul> <ul> <li>https://gamehacking.org/ - Action Replay codes can be used to get defined memory address:  </li> </ul> <p>Y \u2013 Address, X \u2013 Value 1-2 digit value will always be 8 bit \u2013 use 2 in front \u2013 22YYYYYY 000000XX 3-4 digit value will always be 16 bit \u2013 use 1 in front \u2013 12YYYYYY 0000XXXX 5-8 digit value will always be 32 bit \u2013 use 0 in front \u2013 02YYYYYY XXXXXXXX This will work for Action replay codes.  </p> <p>For getting addresses out of GameGenie codes use this: (outdated link, getting 404) http://www.d.umn.edu/~bold0070/projects/game_genie_codes/javascript_game_genie_encoders-decoders.html</p> <ul> <li>https://www.romhacking.net/ - biggest repository of hacked roms.  </li> </ul> <ul> <li>https://tcrf.net/The_Cutting_Room_Floor - Great place to find Easter Eggs for your set plans.</li> </ul> <ul> <li>https://www.gamefaqs.com/ - Great place to find game guides, finding almost all you could want to know about game content, find cheat codes, for development utility and also for making proper protections against the codes.</li> </ul> <ul> <li>https://wiki.nesdev.com/w/index.php/CPU_memory_map - Shows sections of the NES memory so you'll know what area of the memory you're examining. For nes most useful addresses will be between 0x0000--0x07FF.</li> </ul> <ul> <li>https://datacrystal.romhacking.net/wiki/Hashes - Explains what hashes are. If you don't know what they are you should probably read this.</li> </ul> <ul> <li>https://emn178.github.io/online-tools/crc32_checksum.html - Drag and drop checksum checker utility. You can also get the checksum from the rom you have loaded from the retroachievements menu in the emulators.</li> </ul> <ul> <li>https://www.getpaint.net/ - Excellent freeware image editor. You can use it for making badges and icons.</li> </ul> <ul> <li>https://www.marcrobledo.com/RomPatcher.js/ - An online ROM patcher utility.</li> </ul> <ul> <li>https://gregstoll.dyndns.org/~gregstoll/floattohex/ - Floating point to decimal converter</li> </ul> <ul> <li>http://jsonviewer.stack.hu/ - Excellent for viewing raw achievements</li> </ul> <p>Turns this: </p> <p>Into this: </p> <p>Or get a plugin for Notepad++: - http://jsminnpp.sourceforge.net/ to do similar</p> <p>Speaking of Notepad++ - https://notepad-plus-plus.org/download/ - One of the best text editors and it's freeware (Windows only).</p>"},{"location":"Developer-Resources/#achievement-syntax","title":"Achievement Syntax","text":"<p>This is a good reference sheet, it's especially useful for Rich Presence and Leaderboards, getting your deltas and bit labels right.  For full size, right click an save image.</p> <p>A 32bit requires the prefix \"X\" as in 0xX63</p>"},{"location":"Developer-docs-es/","title":"Intro","text":"<p>Si estas interesado en ser desarrollador, deberias checar aqui, como convertirme en desarrollador.</p> <p>Todo desarrollador tiene que conocer el codigo de conducta del desarrollador.</p> <p>Ahora una breve descripcion de algunas de las paginas que encontraras en esta seccion</p> <ol> <li> <p>Empezando como un desarrollador de Logros: el primer contacto con las herramientas de desarrollo de logros (Inspector de Memoria y otros cuadros de dialogos). SI ERES COMPLETAMENTE UN NOVATO, EMPIEZA AQUI!</p> </li> <li> <p>Caracteristicas en la Logica de Logros: describe las herramientas disponibles con las que un desarrollador cuenta para trabajar la logica detras de un logro, como valores deltas, hit counts, ResetIf, PauseIf, Alt groups, etc.</p> </li> <li> <p>Ejemplos-Reales: mostrando resultados verdaderos y desglosando la logica detras de los logros. RECURSO INDISPENSABLE PARA APRENDER!</p> </li> <li> <p>Tips y Trucos: tips generales y trucos sobre como navegar en la memoria y creacion de logros.</p> </li> <li> <p>Tips especificos por Consola: conociendo las peculiaridades de tu consola favorita puede ayudar mientras nadas en la memoria.</p> </li> <li> <p>Plantillas para Logros: algunas plantillas genericas para que te inspires.</p> </li> <li> <p>Escala de Dificultad y Balance: guias/sugerencias en como balancear la dificultad de un set de logros.</p> </li> <li> <p>Creacion de Medallas e Iconos: algunas guias y tips sobre creacion de medallones/iconos.</p> </li> <li> <p>Tablas de Clasificaci\u00f3n: instrucciones en como crear tablas de clasificacion para un juego.</p> </li> <li> <p>Rich Presence: como escribir Scripts para Rich Presence.</p> </li> <li> <p>Mapa de desarrollo de un Set: pasos a considerar para crear realmente un gran set de logros.</p> </li> <li> <p>Dise\u00f1o de logros: una guia en como pensar y dise\u00f1ar buenos logros, no el lado tecnico sino el conceptual.</p> </li> <li> <p>Guia para Set Bonus: un tema avanzado para crear sets con retos especiales y como lanzarlos.</p> </li> <li> <p>Logros para Hacks de ROMs:  una guia detallada para desarrolladores en la inclusion apropiada (y el aprovamiento) para Hacks de ROMs.</p> </li> </ol>"},{"location":"Developer-docs-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 14:54] meleu:</code> Updated Developer docs pt_ES (markdown)</li> </ul>"},{"location":"Developer-docs-pt_BR/","title":"Introdu\u00e7\u00e3o","text":"<p>Estas s\u00e3o as p\u00e1ginas que todos os desenvolvedores novatos deveriam ler e entender primeiro:</p> <ol> <li>Come\u00e7ando como um desenvolvedor de conquistas</li> <li>Caracter\u00edsticas de L\u00f3gicas de Conquistas</li> <li>Exemplos Reais</li> <li>Modelos de Conquistas</li> </ol> <p>Agora uma breve descri\u00e7\u00e3o de cada p\u00e1gina que voc\u00ea ver\u00e1 nesta se\u00e7\u00e3o:</p> <ol> <li> <p>Come\u00e7ando como um desenvolvedor de conquistas: Est\u00e1 aqui para todo primeiro contato com as ferramenta de desenvolvimento de conquistas (Memory Inspector e outros Di\u00e1logos de conquistas). SE VOCE \u00c9 UM COMPLETO INICIANTE, INICIE AQUI!</p> </li> <li> <p>Recursos de L\u00f3gica para Achievements: Descreve as ferramentas dispon\u00edveis para um desenvolvedor tem em ordem para melhorar a l\u00f3gica por tr\u00e1s das conquistas como os valores desta, contador de Hits, ResetIf, PauseIf, Grupos Alt, etc.</p> </li> <li> <p>Exemplos Reais: mostrando exemplos reais e quebrando a l\u00f3gica por tr\u00e1s delas. RECURSO DE APRENDIZAGEM INCR\u00cdVEL!</p> </li> <li> <p>Dicas e Truques: Dicas e truques gerais sobre a escava\u00e7\u00e3o de mem\u00f3ria e cria\u00e7\u00e3o de conquistas.</p> </li> <li> <p>Dicas espec\u00edficas do Console: sabendo as peculiariedades do seu console (video-game) favorito pode ajudar voc\u00ea com a escava\u00e7\u00e3o de mem\u00f3ria</p> </li> <li> <p>Modelos de Conquistas: Alguns modelos gen\u00e9ricos para ganhar inspira\u00e7\u00e3o</p> </li> <li> <p>Escala de Dificuldade e Equilibrio: Sugest\u00f5es de como balancear a dificuldade da conquista de seu set.</p> </li> <li> <p>Cria\u00e7\u00e3o de \u00cdcone e Emblemas: Algumas sugest\u00f5es e dicas sobre a cria\u00e7\u00e3o de icone</p> </li> <li> <p>Leaderboards: Instru\u00e7\u00f5es de como criar Leaderboards para um jogo.</p> </li> <li> <p>Rich Presence: Como criar Scripts Rich Presence</p> </li> <li> <p>Roteiro de Desenvolvimento do Set: Sugest\u00f5es de passos para conduzir em ordem como criar um set arrumado</p> </li> <li> <p>Design de Conquistas: Um guia de como pensar e desenvolver boa conquistas, n\u00e3o a parte t\u00e9cnica, mas a parte conceitual.</p> </li> <li> <p>Guia de Bonus Set: Um t\u00f3pico avan\u00e7ado em criar set especiais de desafios e como lan\u00e7ar eles.</p> </li> <li> <p>Conquistas para Hack ROM: Um guia detalhado para desenvolvedores sobre a inclus\u00e3o apropriada (e aprova\u00e7\u00e3o) de Hack ROMs</p> </li> </ol>"},{"location":"Developer-docs-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-14 14:12] meleu:</code> typo</li> <li><code>[2018-05-14 14:11] meleu:</code> fixed achievement design link</li> <li><code>[2018-03-28 20:01] meleu:</code> Revert 3fbd6b9a6ffb69506933a1b1ab0940463f76256c...dfa2f71466a52945a73853134bea13c0068224ad on Developer docs pt_BR</li> <li><code>[2018-03-28 20:00] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-28 11:08] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-28 11:08] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-24 23:39] meleu:</code> Created Developer docs pt_BR (markdown)</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/","title":"C\u00f3digo de Conducta del Desarrollador","text":"<p>Este documento expone los derechos, responsabilidades y reglas para desarrolladores.</p> <p>Si tu no eres un desarrollador deberias checar aqui, como me convierto en un desarrollador.</p> <p>Checa tambien: Codigo de conducta del usuario.</p>"},{"location":"Developers-Code-of-Conduct-es/#reglas-de-oro","title":"Reglas de Oro","text":"<ol> <li>Respeta a tu compa\u00f1ero desarrollador y comunica cualquier problema que tengas civilmente.</li> <li>Haz espacio para otros desarrolladores puedan trabajar en juegos que ellos tambien quieren, en su propia manera.</li> <li>Cualquiera puede convertirse en desarrollador si hace el suficiente esfuerzo.</li> <li>Todos los sets de logros estan abiertos para mejoras.</li> </ol>"},{"location":"Developers-Code-of-Conduct-es/#resumen-los-desarrolladores-tienen-que-seguir-lo-siguientes-puntos-para-estar-en-buenos-terminos","title":"Resumen - Los Desarrolladores tienen que seguir lo siguientes puntos para estar en buenos terminos","text":"<ul> <li>Cuando planees trabajar en un nuevo juego reservalo anunciando el plan basico en el foro del juego en un nuevo post.</li> <li>Solo anuncia nuevos planes cuando tu estes libre de tickets. Sigue las reglas de reservacion tambien.</li> <li>Espera 3 dias despues que hubieras posteado tus planes para promober cualquiera de los logros a core.</li> <li>Manten tu trabajo libre de conceptos-no bienvenidos.</li> <li>Usa codigo protectivo para prevenir cheating y exploits potenciales.</li> <li>Deja notas de codigo precisas para cada condicion de logro que utilices.</li> <li>Para revisiones de set, sigue la politica de revision.</li> <li>Resuelve tickets, y deja notas cada vez que lo hagas.</li> <li>Una vez que publiques tu trabajo, estas dejando que la comunidad rese\u00f1e y lo retrabaje a traves del tiempo.</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#antes-de-empezar","title":"Antes de empezar","text":""},{"location":"Developers-Code-of-Conduct-es/#estas-libre-de-tickets","title":"Estas libre de tickets?","text":"<p>Antes que trabajes en nuevos juegos tienes que resolver todos los tickets con los que cuentes. Una vez que estes libre tickets, entonces adelante.</p>"},{"location":"Developers-Code-of-Conduct-es/#el-juego-esta-presente-en-la-base-de-datos","title":"El juego esta presente en la base de datos?","text":""},{"location":"Developers-Code-of-Conduct-es/#no","title":"No","text":"<p>Entonces pregunta para que sea agregado por medio de Discord #help-me o en nuestros foros para que algun desarrollador lo agregue por ti. Es esencial que tu elijas el ROM(s) correcto para trabajar. Si quieres trabajar en un hack, checa logros para hacks de ROM doc first.</p>"},{"location":"Developers-Code-of-Conduct-es/#si","title":"Si","text":"<p>Bien! adelante.</p>"},{"location":"Developers-Code-of-Conduct-es/#el-juego-ya-cuenta-con-un-set-de-logros","title":"El juego ya cuenta con un set de logros?","text":""},{"location":"Developers-Code-of-Conduct-es/#yes","title":"Yes","text":"<p>Si existe un set, no te rindas. Aun lo puede mejorar, agregando/removiendo/re-trabajando logros, o haz cambios a titulos e imagenes, etc. Sin embargo tendras que pasar por el proceso de revision de tu set.</p>"},{"location":"Developers-Code-of-Conduct-es/#no_1","title":"No","text":"<p>Busca delicadamente. Algunas veces hay multiples entradas en la base de datos para el mismo juego con diferente titulos. Una vez que este seguro, ahora necesitas checar si hay otro desarrollador trabajando en el juego.</p> <p>Nota: Solo un set de logros es permitido por el mismo juego y consola. Para detalles mira trabajando con el ROM correcto.</p>"},{"location":"Developers-Code-of-Conduct-es/#hay-otros-desarrollor-trabajando-en-el-juego","title":"Hay otros desarrollor trabajando en el juego?","text":"<p>Para estar seguro que no hay otro desarrollador trabajando en ese juego, checa el foro oficial del juego (esa es la manera oficial de reservar el juego en el que quieres trabajar). Esto es necesario para evadir conflictos entre multiples desarrolladores trabajando en el mismo juego.</p>"},{"location":"Developers-Code-of-Conduct-es/#si_1","title":"Si","text":"<p>Podria ser posible que el desarrollor hubiera dejado de trabajar en ellos. Se espera que el desarrollador renueve su reservacion cada dos meses. Mira en las etiquetas de tiempo para ver cuando el desarrollador postio su reservacion de desarrollo. Si el desarrollador no a clarificado o renovado su reservacion despues de que hubieran pasado dos meses puedes asumir que fue abandonado y asi postear tus planes de trabajo.</p>"},{"location":"Developers-Code-of-Conduct-es/#no_2","title":"No","text":"<p>Perfecto! Adelante! El siguiente paso es anunciar tus planes para desarrollar logros para el juego.</p>"},{"location":"Developers-Code-of-Conduct-es/#anunciando-tus-planes-para-trabajar-en-un-juego","title":"Anunciando tus planes para trabajar en un juego","text":"<p>Anunciar tus planes para el set de logros se hace en el foro oficial del juego del que tienes en mente crear el set.</p> <p>Postear tus planes es tu manera de reservar oficialmente un juego, sin embargo hay algunas reglas sobre el apartado sets que tienes que tener en cuenta.</p>"},{"location":"Developers-Code-of-Conduct-es/#notas-importantes","title":"Notas Importantes","text":"<ul> <li>No hay necesidad de que dejes un plan completo y detallado! Simplemente una idea general de cuales son tus intenciones (tus planes son muy probables que cambien una vez que hubieras investigado la memoria del juego). Haz esto para que la comunidad pueda dejar recomendaciones y puede proveer retroalimentacion.</li> </ul> <ul> <li>Intenta estar abierto a recomendaciones. Si no estas de acuerdo con la retroalimentacion recivida, puedes continuar con tu concepto. Pero recuerda tener lo siguiente en mente:     - Tienes que aderirte al Reglamento de Dise\u00f1o Basico de Logros, de otra manera tu set no sera aprovado.     - Cuando tu publicas tu trabajo estas dejando a la comunidad para que sea rese\u00f1ado y re-trabajado sobre el paso del tiempo.</li> </ul> <ul> <li>Si alguien escogio un juego del cual tu estas interesado antes que tu, no te desesperes. Te animamos a solicitar una colaboraci\u00f3n. Puedes publicar tu deseos de colaborar en el foro o mandar un mensaje al desarrollador para obtener permiso para que publique tus contribuciones. Tambien puedes esperar e ir por una Revision de Set after the set is published.</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#reglas-para-reservar-juegos-para-desarrollo","title":"Reglas para reservar juegos para desarrollo","text":"<p>Las siguientes reglas existen para saber facilmente quien esta trabajando en que, definir que es aceptable, prevenir que el desarrollo de juegos no se estanque, proteger a los desarrolladores de indebida presion social.</p> <ol> <li> <p>La unica manera de reservar un juego es posteando tu plan en el foro oficial del juego en un nuevo post.     - No otros planes o listas posteadas en cualquier otro luegar son consideradas en esto.     - Notas de codigo no reservan un juego (si agregaste notas pero no reservaste el juego en el foro, cualquier desarrollador es libre de trabajar en el).</p> </li> <li> <p>Numero maximo de juegos reservados a la vez:     - Desarrollador Junior: 1.     - Desarrollador: 4.     - Desarrollador Veterano: 8 (un Desarrollador Veterano es alguien que a sido un desarrollador por minimo 18 meses y a publicado un minimo de 20 sets de logros).     - Nota: Trabajar en una revision aprovada o unirte con otro desarrollador en un esfuerzo cooperativo no cuenta para este total.</p> </li> <li> <p>Solo reserva un juego para desarrollo cuando realmente ya vaz a empezar a trabajar en el. En otras palabras, no reserves juegos simplemenete para blockear otros usuarios en trabajar en ellos.</p> </li> <li> <p>Puedes renovar tu reservacion cada dos meses (+/- 2 semanas) si no haz terminado tu set aun.     - Para renovar tu reservacion, postealo en el foro oficial del juego.     - No edites tus antiguas declaraciones, haz un nuevo post hablando del progreso actual.     - Evita ignorar un set indefinidamente. Si parece que un desarrollador continua retrasando el desarrollo de un set con poco o sin progreso el staff puede intervenir.</p> </li> <li> <p>No pidas, presiones o desalentes a nadie en trabajar en cualquier juego, en publico o en privado (claramente, asumiendo que la persona esta siguiendo todos los otros estandartes de este Codigo de Conducta).</p> </li> <li> <p>Una vez que hubieras posteado tu plan, espera un minimo de 72 hours antes de promover cualquier logro a Core. Esto le da tiempo a la comunidad de renovar tu plan y dar retro-alimentacion. Este periodo de espera empieza despues que tu plan este presente y esta en su forma completa (o mayormente completa).</p> </li> </ol>"},{"location":"Developers-Code-of-Conduct-es/#reglamento-de-diseno-basico-de-logros","title":"Reglamento de Dise\u00f1o Basico de Logros","text":""},{"location":"Developers-Code-of-Conduct-es/#conceptos-no-bienvenidos","title":"Conceptos No-Bienvenidos","text":"<p>Tu puedes (y deberias) se lo mas creativo que puedas, pero hay algunos conceptos que NO estan bienvenidos para logros, como: - Requirir el uso de glitches (aceptable en Sets Bonus). - Requieren dos jugadores. - Requiere perfeccion por todo el juego (talvez aceptable in Sets Bonus). - Morir (simplemente), o juega mal sin ningun proposito. - Contenido no apropiado (NSFW) en la imagen o texto. - Logros saltando frecuentemente con poco esfuerzo del jugador (incluyendo multiples logros por hacer la misma tarea, como vencer al jefe y otro por conseguir el item que dejo el jefe , etc.) - Logros obtenibles con zero esfuerzo sin razon alguna (ejemplo: empieza el juego con x personaje, colecciona una moneda). Es acceptable si hay algo divertido/historico/interesante que quieres tocar. - Se requiere grinding repetitivo y excesivo, asi como llega a level 99 en un RPG, sin razon alguna (talvez aceptable en Sets Bonus). - Se basa completamente en suerte, especialmente cuando hay probabilidades realmente bajas. Sin embargo, para juegos que el factor aleatorio es un aspecto importante, podria ser apropiado. - \"Logros Secretos\", cuando los jugadores no tiene indicacion de que es lo que tienen que hacer. Si quieres prevenir spoilers da minimo una pista en el titulo o descripcion. De otra manera los jugadores van a empezar a buscar en la web o van a moverle al editor de Logros/Inspector de Memoria, y en el proceso pueden incluso toparse con peores spoilers.</p> <p>Con cada regla, hay un excepcion. Esta es especialmente verdad con conceptos no-bienvenidos. Todos los conceptos no-bienvenidos tienen un margen de aprovacion. cuando te encuentres en dudas puedes consultar con el equipo de administradores.</p>"},{"location":"Developers-Code-of-Conduct-es/#cada-set-de-logros-tiene-que-tener","title":"Cada Set de logros TIENE que tener","text":"<p>Proteccion para situaciones donde los jugadores puedes conseguir logros sin esfuerzo, como:</p> <ul> <li>Modo Demo;</li> <li>Cheat codes en el juego;</li> <li>Archivos de guardado;</li> <li>Passwords.</li> </ul> <p>Tambien mira: Plantillas para logros y Ejemplos reales para algunas tecnicas de proteccion bien conocidas.</p>"},{"location":"Developers-Code-of-Conduct-es/#cada-set-de-logros-deberia-tener","title":"Cada Set de logros DEBERIA tener","text":"<ul> <li>Minimo Rich Presence basico; </li> <li>Medallas (Badges) para cada Logro; </li> <li>Todo la informacion del juego llena, e imagenes del juego subidas.</li> </ul> <p>Nota: Rich Presence, Tablas de clasificacion, y paginas del juego imagenes/informacion solo pueden ser agregadas por verdaderos desarrolladores</p>"},{"location":"Developers-Code-of-Conduct-es/#recomendado-pero-no-requerido-por-cada-set-de-logros","title":"Recomendado pero no requerido por cada Set de logros","text":"<ul> <li>Tablas de clasificacion para puntajes y retos de tiempo.</li> <li>Logros Perdidisos flageados, especialmente para RPGs y juegos largos.      - Utiliza <code>[m]</code> al final del titulo del logro para flaggearlo como perdidiso.</li> <li>Una guia de logros. Guias pueden ser creadas y posteadas aqui. </li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#herramientas-para-ayudarle-a-tener-exito","title":"Herramientas para ayudarle a tener \u00e9xito","text":"<p>Tenemos un We have a mapa que puedes utilizar como guia para crear un buen set de logros. Tambien tenemos una guia de dise\u00f1o de logros en como dise\u00f1ar buenos logros, no el lado tecnico pero si el conceptual. Crear un set balanceado es uno de los aspectos mas dificiles de desarrollo, tenemos una guia de balance de dificultad que te podria ayudar en pensar como crear un set que fluya.</p> <p>Es preferible y recomendado trabajar en un set a la vez. Pero si tienes mas, ten abiertas posibilidades para trabajar en equipo o incluso delegar la creacion de un set si otro desarrollador te contacta.</p>"},{"location":"Developers-Code-of-Conduct-es/#revisiones-trabajando-en-sets-que-ya-cuentan-con-logros","title":"Revisiones - Trabajando en Sets que ya cuentan con logros","text":"<p>Revisiones, si estas trabajando en un set que ya cuenta con logros tipicamente requiere aprovacion por la comunidad, presentando tu plan en el foro y en el canal de #revision-voting en Discord. No todos los cambios requieren aprovacion. Mira Revisiones de Sets de Logros para mas detalles.</p>"},{"location":"Developers-Code-of-Conduct-es/#notas-de-codigo","title":"Notas de Codigo","text":"<p>Deja notas precisas para cada valor que utilizes en un logro. Esto te ayuda a ti y a otros de mantener el set libre de bugs.</p> <p>Eres libre de agregar todos las notas que quieras en el juego sin incluso a ver declarado tus intenciones en trabajar en ese juego. Simplemente se cuidadoso en no borrar notas de codigo creadas por otros usuarios.</p>"},{"location":"Developers-Code-of-Conduct-es/#manejo-de-tickets","title":"Manejo de Tickets","text":"<p>Despues que hubieras publicado tus logros preparate para reportes de bugs.</p> <p>Se supone que tienes que dejar tu trabajo libre de bugs con el manejo de tickets y resolviendolos. Responde a todos los tickets lo mas pronto posible. Mientras mas pronto mejor, porque el problema esta fuera de la mente del jugador y puedes utilizarlo como ayuda para resolver el problema tambien.</p> <p>Mientras resuelves tickets, deja un peque\u00f1o resumen de lo que hiciste. Si tienes una indicacion o un reporte falso deja un mensaje cuales fueron tus conclusiones, y entonces cierra el ticket. Cerrar/Resolver un ticket sin dejar ningun comentario es una actitud no-bienvenida.</p> <p>No declares tus planes de trabajar en un juego si cuentas con tickets abiertos.</p> <p>Si tienes planeado resolver tickets o arreglar bugs en logros hechos por otro desarrollador, siempre es una buena practica intentar contactarlo si aun se encuentra activo antes de modificar su trabajo. Un desarrollador inactivo es alguien que cuenta con 10 o mas tickets abiertos y tienen un minimo de dos meses de antiguedad (puedes ver sus tickets abiertos desde el Ticket Manager).</p> <p>Si el desarrollador esta activo, puedes simplemente hecharle una ayuda con la solucion.</p> <p>Si el desarrollador esta inactivo puedes libremente resolverle sus tickets. Sin embargo solamente tienes permitido arreglar el logro con lo que dice en su descripcion; no cambies la intencion de logro sin haber pasado por el proceso de revision.</p>"},{"location":"Developers-Code-of-Conduct-es/#propiedad-de-los-logros","title":"Propiedad de los logros","text":"<p>Cuando tu publicas tu trabajo tu se lo estas dando a la comunidad para que sea rese\u00f1ado y re-trabajado con el paso del tiempo - mira Revisiones en un Set. </p> <p>Aunque los logros publicados por un desarrollador no son propiedad de el, el aun es el encargado en terminos de arreglar y dar mantenimiento. Si otro jugador corrige el logro el es el nuevo encargado de ese logro.</p>"},{"location":"Developers-Code-of-Conduct-es/#retroalimentacion-sobre-el-codigo-de-conducta-del-desarrollador","title":"Retroalimentacion sobre el Codigo de Conducta del Desarrollador","text":"<p>A pesar de que el Codigo de Conducta del Desarrollador es el resultado de un intenso debate, no es un documento absoluto. Si tiene sugerencias para nuevas mejoras, contactanos en nuestro servidor de Discord o manda un mensaje a RAdmin.</p>"},{"location":"Developers-Code-of-Conduct-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 14:58] meleu:</code> Updated Developers Code of Conduct ES (markdown)</li> </ul>"},{"location":"Developers-Code-of-Conduct/","title":"Developer's Code of Conduct","text":"<p>This document covers developers' rights, responsibilities, and rules for fair play.</p> <p>If you are not a dev, check how to become a developer.</p> <p>See Also: Users Code of Conduct.</p> <ul> <li>Golden Rules</li> <li>Developers must do the following to keep in good standing</li> <li>Revisions - Working on Sets with Existing Achievements</li> <li>Expiration of Developer Status</li> <li>Achievement Ownership</li> <li>Feedback about the Developer Code of Conduct</li> </ul>"},{"location":"Developers-Code-of-Conduct/#golden-rules","title":"Golden Rules","text":"<ul> <li>Follow the Developer and Content Guidelines the best you can. When in doubt, ask.</li> <li>Respect your fellow developer and communicate through any issues you have civilly.</li> <li>Make room for other developers to get a chance to work on games they like, in their own way.</li> <li>Do not discourage anyone from working on any game, in public or in private.</li> </ul>"},{"location":"Developers-Code-of-Conduct/#developers-must-do-the-following-to-keep-in-good-standing","title":"Developers must do the following to keep in good standing:","text":"<ul> <li>Keep your work free from unwelcome concepts.</li> <li>Use protective code, preventing potential cheating and exploits.</li> <li>Leave accurate code notes for each achievement condition you use.</li> <li>For set revisions, follow the revision policy.</li> <li>Resolve tickets and leave notes each time you do.</li> <li>Like a wiki, once you publish your work, you are giving it over to the community to be reviewed and reworked over time.</li> </ul>"},{"location":"Developers-Code-of-Conduct/#revisions-working-on-sets-with-existing-achievements","title":"Revisions - Working on Sets with Existing Achievements","text":"<p>Revisions, as in working on a set that has existing achievements typically requires community approval by presenting your plan in the forum and in the #revision-voting channel in Discord. Not all changes need approval. See Achievement Set Revisions for details.</p>"},{"location":"Developers-Code-of-Conduct/#expiration-of-developer-status","title":"Expiration of Developer Status","text":""},{"location":"Developers-Code-of-Conduct/#inactivity","title":"Inactivity","text":"<p>The developer status will expire and account type will be set to <code>[Registered]</code> if the following conditions are met: </p> <ul> <li>Developers: Inactivity as developer for 6 months or overall inactivity for 3 months. </li> <li>Jr. Developers: Inactivity as developer or overall inactivity for 1 month.</li> </ul> <p>It is important for developers to remember that this is NOT a punishment and is only done for security reasons!</p> <p>Inactivity as a developer will be defined as: - Has not made or renewed a set claim. - Has not created new achievements. - Has not performed maintenance on existing sets (revisions, rescores, badge changes, etc.) - Has not resolved, closed, or otherwise addressed any open tickets, theirs or otherwise.</p>"},{"location":"Developers-Code-of-Conduct/#negligence","title":"Negligence","text":"<p>Alternatively, developer status will be removed if the developer has 10 or more tickets that are at least 2 months old. If the developer has any active claims during this period, they will be given an additional 30 days or until the earliest claim renewal (whichever comes first) to resolve all 10 tickets. Not doing so will result in the developer falling into inactive status and the claim(s) being released.</p>"},{"location":"Developers-Code-of-Conduct/#reinstatement","title":"Reinstatement","text":"<p>If a user's developer status was removed due to inactivity and they wish to have it reinstated, they must contact Dev-Compliance. However, before doing so, it is recommended to review any changes that were made to the Developer Code of Conduct, updates to the achievement creation tools, and have a plan to address open tickets for their achievements, if applicable.</p> <p>The steps involved in reinstatement will vary from user to user depending on the following: - The amount of time elapsed since developer status was removed. - The amount of tickets that may have been opened on their achievements.  - Other QA issues that may have come up since developer status was removed. - Moderation warnings or actions the user may have received.</p> <p>A user may be required to submit work to code reviewers if more than a year has passed since their developer status was removed or if they initially obtained developer status before the junior developer program existed (July 2018) and did not retroactively obtain the Junior Developer badge.</p> <p>Note: Achievements edited by other developers will not count against a user seeking reinstatement.</p>"},{"location":"Developers-Code-of-Conduct/#achievement-ownership","title":"Achievement Ownership","text":"<p>When you publish your work you are giving it over to the community to be reviewed and reworked over time - see Achievement Set Revisions. </p> <p>While the original developer does not own published achievements, they are still the caretaker in terms of bug fixing and maintenance. If another developer revises the achievement, they are the new caretaker of that achievement.</p>"},{"location":"Developers-Code-of-Conduct/#changing-accounts","title":"Changing Accounts","text":"<p>If a user with either Developer or Jr. Developer status changes accounts, achievements and tickets under the old account will be re-authored and reassigned to the new account.</p>"},{"location":"Developers-Code-of-Conduct/#feedback-about-the-developer-code-of-conduct","title":"Feedback about the Developer Code of Conduct","text":"<p>Although the Developer Code of Conduct is the result of an intense debate, it's not an immutable document. If you have suggestions for improvements, contact us on our Discord server or send a message to RAdmin.</p>"},{"location":"Developers-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-25 18:42] Hotscrock:</code> Adjust on Jr. Developers inactivity rule</li> <li><code>[2023-06-11 22:48] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> <li><code>[2023-06-04 19:49] televandalist:</code> Removed Code Notes section in favor of the page under Content Guidelines</li> <li><code>[2023-06-04 19:38] televandalist:</code> Removed \"Reserving a game for achievement development\" section in favor of the \"Claims System\" page.</li> <li><code>[2023-06-04 19:11] televandalist:</code> Reverted the \"Developer and Content Guidelines\" change from the last edit.</li> <li><code>[2023-06-04 19:05] televandalist:</code> Golden Rules: \"Developer and Content Guidelines\" -&gt; \"Content Guidelines\" | \"Do not ask, pressure or discourage\" -&gt; \"Do not discourage\"</li> <li><code>[2023-06-04 18:53] televandalist:</code> Changed the Golden Rules based on a proposal and vote</li> <li><code>[2023-06-03 04:00] televandalist:</code> Removed \"Editing Leaderboards\" section since it has been moved to \"Content Guidelines\"</li> <li><code>[2023-06-02 20:36] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> <li><code>[2023-06-02 20:30] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-es/","title":"Escala de Dificultad y Balance","text":"<p>Este documento tiene algunas sugerencias sobre dificultad, balance de un set y sobre mantener un set divertido, amigable, y retador. Lo que estas apunto de ver no son reglas, solamente sugerencias.</p> <p>Nota: ten encenta el C\u00f3digo de Conducta del Desarrollador</p>"},{"location":"Difficulty-Scale-and-Balance-es/#escala-de-dificultad","title":"Escala de Dificultad:","text":"<ol> <li>Regalado</li> <li>Facil</li> <li>Medio</li> <li>Med-dificil</li> <li>Dificil</li> <li>Muy-Dificil</li> <li>Super-Dificil</li> </ol> <p>Mas detalles sobre estos al final.</p> <p>En general tiene que a ver un balance de dificultad uniforme. Uno tiene que pensar en la dificultad en general del set mientras los construyes. Uno no tiene que hacer sets excesivamente dif\u00edciles.</p> <p>Un buen balance en un set de 50 logros en promedio deber\u00eda de tener aproximadamente: 4 regalados, 6 logros f\u00e1ciles, 10 medianos, 10 med-dif\u00edcil, 14 dif\u00edciles, y 6 muy-dificiles, 0 kaizo (super-dif\u00edcil).</p> <p>Una distribuci\u00f3n de dificultad balanceada recompensa a cada tipo de jugador. Le da a cada nivel de habilidad algo que completar hasta que lo dominas por completo.</p> <p>Los logros no tienen que ser solamente una palomita por completar el juego, (muy f\u00e1cil) crea nuevas memorias divertidas con el juego (diversidad de logros).</p> <p>Deja espacio para logros regalados que cuenten con cosas curiosas o divertidas del juego. Se espera la suficiente dificultad para que puedes dominar un set y as\u00ed decir que eres un maestro del juego. Pero tampoco necesita pedir demasiado para el jugador.</p> <p>Tampoco no tienes que pedirle al jugador que haga tareas interminables y repetitivas solo para que un logro sea dificil. Hacer la misma tarea una y otro y otra vez no es dificil, es tipicamente aburrido. Tambi\u00e9n deber\u00edas de evitar hacer logros estilo marat\u00f3n con una colina hasta el final (aquellos que requiere un proceso largo con poca o repetitiva dificultad y entonces aparece un pico de dificultad enorme al final. No lo hagas!).</p> <p>Los Sets tienen que ser masterizados por un jugador con habilidad, que puso la dedicaci\u00f3n y esfuerzo necesario.</p> <p>Un Set tiene que reflejar el contenido del juego. Logros de \u00a8grindear\u00a8 en juegos que requieren grinding son razonables, que en otros cazos podr\u00edan ser inapropiados.</p> <p>Un Set tambi\u00e9n deber\u00eda de romper lo que se espera de un juego, motivando al jugador a encontrar nuevas soluciones a  problemas que ni un jugador veterano hubiera considerado.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#cantidad-del-set","title":"Cantidad del Set:","text":"<p>La cantidad de logros en un Set realmente no tiene reglas. La Calidad es un factor clave.</p> <p>La cantidad de logros depende fuertemente en la diversi\u00f3n y retos que un juego puede otorgar. Es por eso que el desarrollador del set tiene que conocer al juego muy bien.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#variedad-en-el-set","title":"Variedad en el Set:","text":"<p>Mantenlo divertido, entrega variedad, reto al jugador, entrega al jugador nuevas cosas que hacer.</p> <p>Algunos logros pueden pueden ser muy divertidos para el jugador cuando son como un meta-game. Cuando el jugador tiene que pensar el juego enteramente.</p> <p>Algunos ejemplos notables:</p> <ul> <li>Fabulous ComboFabulous Combo (15) - convierte al juego en un juego de puzzle, completar esto es bastante gratificante</li> </ul> <ul> <li>Swordless Adventurer (20) - sin espada estas obligado a repensar el juego por completo. Puedes incluso descubrir que tan \u00fatiles son las sub-armas. Muy divertido!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - retos pacifistas, cuando fuerzan al jugador a tener mas agilidad y romper viejos h\u00e1bitos. Muy divertido!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-es/#definiciones-sobre-la-dificultad","title":"Definiciones sobre la Dificultad","text":""},{"location":"Difficulty-Scale-and-Balance-es/#0-regalado","title":"0 - regalado","text":"<p>Tienen casi no esfuerzo para b\u00e1sicamente todo tipo de jugador para conseguirlo OR el jugador lo consigue sin poner consientemente un esfuerzo. El jugador lo obtiene por accidente y salta en la pantalla. Algunas veces el jugador ni siquiera tiene idea de porque lo consigui\u00f3. Algunos logros regalados son buenos algunos son malos.</p> <p>Ejemplos: Empezar el juego, seleccionar un personaje, coleccionar un \u00edtem facil de conseguir, vencer a tu primer enemigo.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#1-facil","title":"1 - Facil","text":"<p>La mayor\u00eda de jugadores lo pueden conseguir en su primer intento, Algunos en su segundo o tercero. Raramente los jugadores pueden arruinarlo.</p> <p>Ejemplo: Progresa en stages f\u00e1ciles, consigue 100 monedas, colecciona una pluma, colecciona 20 anillos. Obt\u00e9n la primer mejora, llega a un mundo secreto bastante conocido. Pelea contra un jefe muy simples: la mayor\u00eda de los jefes en Super Mario World, completa los primeros mundos en Sonic.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#2-medio","title":"2 - Medio","text":"<p>Varios jugadores pueden conseguir este en su primer intento. Algunos despu\u00e9s de varios intentos. Algunos necesitan practicar. Muy pocos van a batallar mucho con ellos.</p> <p>Ejemplos: Obt\u00e9n todos los switches de colores en Super Mario World, colecciona todos los items en un stage de Castlevania, obt\u00e9n un bonus en un \u00e1rea escondida, obt\u00e9n lunas en SMW. Vence Contra con el c\u00f3digo Konami.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#3-medio-dificil","title":"3 - Medio-Dif\u00edcil","text":"<p>Un porcentaje bajo de jugadores pueden conseguirlo en su primer intento. Algunos despu\u00e9s de varios intentos y la mayor\u00eda les va a tomar algo de esfuerzo y practica completar uno de estos. Algunos lo van a encontrar muy retador, y se rendir\u00e1n.</p> <p>Ejemplos: Obt\u00e9n una de las emeraldas chaos en Sonic 2. Completa Super Mario World.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#4-dificil","title":"4 - Dif\u00edcil","text":"<p>Muy pocos jugadores pueden conseguir uno en su primer intento, incluso si ya conocen el juego (realmente no es su primer intento o si?) la mayor\u00eda pueden completar estos con un esfuerzo solido, algunos intentos y algo de practica, y algunos necesitan practicar con otros juegos primero.</p> <p>Ejemplos: Obt\u00e9n todas las esmeraldas Chaos en Sonic 1,2,3. Pasa Contra sin el c\u00f3digo Konami.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#5-muy-dificil","title":"5 - Muy Dif\u00edcil","text":"<p>Solo los jugados mas extra\u00f1os pueden completar uno de estos en su primer intento. La mayor\u00eda puede completarlo despu\u00e9s de muchos intentos, Muchos jugadores lo van a dejar abandonado y no van a estar dispuestos a completar el set al menos que sean complecionistas o fan\u00e1ticos del juego. Muchos no son capases de completarlo despu\u00e9s de muchos intentos. Usualmente requiere practica significativa, altas habilidades, experiencia, b\u00fasqueda, o gu\u00edas para completarlo.</p> <p>Ejemplos: Completa Contra en una sola vida. Escapa de Zebes (Super Metroid) en 2 minutos o menos. Vence a los jefes de Megaman sin recibir da\u00f1o. Muchos de completa niveles sin recibir da\u00f1o, depende del juego.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#6-super-dificil","title":"6 - Super Dif\u00edcil","text":"<p>La mayor\u00eda de los jugadores no son capases de completarlo despu\u00e9s de decenas de intentos. Algunos jugadores tal vez nunca sean capases de completarlo ya que puede requerir noci\u00f3n del mando y el tiempo mas all\u00e1 de lo normal. Los jugadores con mas habilidad inclusive lo consideran bastante dificil. Puede reiniciar esfuerzos de maratones.</p> <p>Ejemplos: Completa un juego sin conseguir da\u00f1o especialmente si el jugador tiene una barra de vida, retos que restringen al jugador drasticamente y requieren precisi\u00f3n por frame perfecta. Completa Contra dos veces con una vida. Completa Mario Bros sin conseguir monedas. Completa Megaman sin recibir da\u00f1o.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-14 15:34] eldexterr:</code> Created Difficulty Scale and Balance es (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/","title":"Escala de Dificuldade e Equil\u00edbrio","text":"<p>Link para o texto em ingl\u00eas: Difficulty Scale and Balance</p> <p>Este documento tem algumas sugest\u00f5es sobre dificuldade, balanceamento do set e manuten\u00e7\u00e3o de um set divertido, e desafiador. O que voc\u00ea ir\u00e1 ver aqui n\u00e3o s\u00e3o regras, apenas sugest\u00f5es.</p> <p>Nota Seja conciente da C\u00f3digo de Conduta dos Desenvolvedores</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#escala-de-dificuldade","title":"Escala de Dificuldade","text":"<ol> <li>Brinde</li> <li>F\u00e1cil</li> <li>M\u00e9dio</li> <li>Medianos</li> <li>Dif\u00edcil</li> <li>Muito Dif\u00edcil</li> <li>Super Dif\u00edcil</li> </ol> <p>Mais detalhes sobre estes no fundo</p> <p>Em geral, deve haver um equil\u00edbrio est\u00e1vel de dificuldade. Deve-se pensar na dificuldade geral do set ao constru\u00ed-lo. N\u00e3o se deve tornar os set excessivamente dif\u00edceis.</p> <p>Um bom equil\u00edbrio nas 50 conquistas em um set m\u00e9dio teria aproximadamente: 4 Brindes, 6 super f\u00e1ceis. 10 m\u00e9dios, 10 medianos, 14 dif\u00edceis, 6 Muito dif\u00edceis e 0 kaizo.</p> <p>Uma distribui\u00e7\u00e3o de dificuldade bem balanceada tem recompensas para todos os tipos de jogadores. Isso se d\u00e1 a cada n\u00edvel de habilidade algo para realizar at\u00e9 a platina.</p> <p>Conquistas n\u00e3o devem ser apenas uma marca de conclus\u00e3o de um jogo, (muito f\u00e1cil) mas crie divertidas novas mem\u00f3rias para o jogo (diversividade de desafios).</p> <p>Isto deixa espa\u00e7o para os brindes que est\u00e3o apresentando elementos curiosos ou divertidos dos jogos. Isto lhe espera dificuldade suficiente que, uma vez que voc\u00ea platina o set, voc\u00ea \u00e9 o mestre do jogo. Mas isso n\u00e3o pede muito do jogador.</p> <p>Tamb\u00e9m n\u00e3o deve ser pedir ao jogador para fazer coisas aparentemente sem fim e repetitivas para fazer um set parecer dif\u00edcil. Fazendo a mesma tarefa denovo e denovo, n\u00e3o \u00e9 dif\u00edcil, \u00e9 tipicamente tedioso. Deve quase sempre evitar fazer tipos de maratonas com uma \"colina\" no final (Aquelas que requer um longo tempo ou dificuldade repetitiva com e depois uma eleva\u00e7\u00e3o de alta dificuldade no final. N\u00e3o fa\u00e7a isso!)</p> <p>Sets dever\u00e3o ser platin\u00e1veis por um jogador h\u00e1bil que d\u00e1 um esfor\u00e7o dedicado.</p> <p>Sets dever\u00e3o refletir o conte\u00fado do jogo. Farmar conquistas em jogos que exigem Farm s\u00e3o razo\u00e1veis, em outros lugares eles seriam fequentemente inapropriados</p> <p>Sets dever\u00e3o tambem quebrar o que \u00e9 esperado de um jogo, impulsionando o jogador a procurar encontrar novas solu\u00e7\u00f5es para problemas que um jogador veterano nunca considerou</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#quantidade-de-conquistas","title":"Quantidade de Conquistas:","text":"<p>A quantidade de conquistas n\u00e3o tem regras t\u00e3o duras. Quantidade \u00e9 um fator chave</p> <p>A quantidade de um set depende fortemente de o quanto divertido e desafiador o jogo pode oferecer. \u00c9 por isso que o desenvolvedor do set deve conhecer o jogo muito bem.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#variedade-de-conquistas","title":"Variedade de Conquistas:","text":"<p>Mantenha divertido, d\u00ea variedade, desafie o jogador, d\u00ea ao jogador novas coisas para se fazer.</p> <p>Algumas conquistas podem dar muito mais divers\u00e3o para o jogador do que um jogo de metas. Onde \u00e9 necessario que o jogador repense o jogo inteiramente.</p> <p>Alguns Exemplos Not\u00e1veis:</p> <ul> <li>Fabulous Combo (15) - isto transforma o jogo em um jogo de puzzle, completando isso pode ser realmente satisfat\u00f3rio.</li> </ul> <ul> <li>Swordless Adventurer (20) - voc\u00ea \u00e9 for\u00e7ado a repensar todo o jogo sem arma. Voc\u00ea pode descobrir o qu\u00e3o \u00fatil todas as sub-armas s\u00e3o. Muito legal!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - desafios pacifistas, quando possivelmente for\u00e7a muito mais a agilidade do jogador e quebrar velhos h\u00e1bitos. Muito legal!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#definicoes-de-dificuldade","title":"Defini\u00e7\u00f5es de Dificuldade","text":""},{"location":"Difficulty-Scale-and-Balance-pt_BR/#0-brinde","title":"0 - Brinde","text":"<p>N\u00e3o leva quase nenhum esfor\u00e7o para basicamente todos os jogadores para conquistar OU o jogador consegue sem nenhuma consci\u00eancia ou esfor\u00e7o. Al\u00e9m do jogador conseguir por acidente e aparecer na tela. Algumas vezes o jogador n\u00e3o tem nenhuma id\u00e9ia porque ganhou ele. Alguns conquistas brindes s\u00e3o boas e ruins.</p> <p>Exemplos: Iniciando o jogo, escolhendo um personagem, coletando um item de acesso f\u00e1cil, matando seu primeiro inimigo. Trope\u00e7ando em uma conquista que n\u00e3o levou a premedita\u00e7\u00e3o, mas destaca elementos do jogo</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#1-facil","title":"1 - F\u00e1cil","text":"<p>A maioria dos jogadores consegue estas na primeira tentativa, alguns na segunda ou terceira tentativa. Raramente os jogadores podem se confundir.</p> <p>Exemplos: Progresso em fases f\u00e1ceis, pegando 100 moedas, coletando uma pena, coletando 20 an\u00e9is. Pegando o primeiro upgrade, indo para uma fase secreta muito conhecida. Lutando com um chefe facil: a maioria dos chefes em Super Mario World, completando fases iniciais em Sonic The Hedgehog.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#2-medio","title":"2 - M\u00e9dio","text":"<p>A Maioria dos jogadores consegue pegar na primeira tentativa. Muitos poderiam depois de algumas tentativas. Alguns ir\u00e3o precisar praticar. Alguns poucos v\u00e3o lutar com eles.</p> <p>Exemplos: Conseguindo todos os switches coloridos no Super Mario World, coletando todos os itens em uma fase de Castlevania, conseguindo um item b\u00f4nus em uma \u00e1rea mais escondida como as lua em SMW. Zerando Contra com o Konami code</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#3-medianos","title":"3 - Medianos","text":"<p>Uma baixa quantidade de jogadores ir\u00e3o conseguir isso na primeira tentativa. Alguns depois de algumas tentativas e a maioria vai levar algum esfor\u00e7o e pr\u00e1tica para concluir. Alguns ir\u00e3o achar eles muito desafiantes e desistir.</p> <p>Exemplos: Conseguindo algumas das esmeraldas do caos em Sonic The Hedgehog 2, Zerar Super Mario World</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#4-dificil","title":"4 - Dif\u00edcil","text":"<p>Muitos poucos jogadores ir\u00e3o conseguir na primeira tentativa, possivelmente se ja conhece o jogo (n\u00e3o realmente a primeira tentativa?) Alguns podem completar com algum esfor\u00e7o solido, muitas tentativas e alguma pr\u00e1tica e precisa praticar outros jogos antes.</p> <p>Exemplos: Conseguindo todas as Esmeraldas do Caos em Sonic 1,2,3. Zerando Contra sem o Komani Code.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#5-muito-dificil","title":"5 - Muito Dif\u00edcil","text":"<p>Apenas o mais raro dos jogadores conseguem estas em uma primeira tentativa. A maioria consegue complet\u00e1-lo depois de muitas tentativas, Muitos jogadores ir\u00e3o desistir aqui e n\u00e3o estar\u00e1 disposto a completar o set a menos que eles s\u00e3o completistas ou f\u00e3s do jogo. Muitos n\u00e3o ser\u00e3o capazes depois de muitas tentativas. Geralmente pega uma pr\u00e1tica significante, altas habilidades, experi\u00eancia, pesquisas ou guias para completar</p> <p>Exemplos: Zerando Contra com uma vida. Escapando de Zebes (Super Metroid) abaixo de dois minutos. Derrotando muitos chefes de Megaman sem tomar dano. Muitos est\u00e1gios sem danos, dependendo do jogo.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#6-super-dificil","title":"6 - Super Dif\u00edcil","text":"<p>A Maioria dos jogadores n\u00e3o ser\u00e3o capaz de completar isto depois de d\u00fazias de tentativas. Muitos jogadores nunca ser\u00e3o capazes de complet\u00e1-lo, pois podem exigir velocidades de rea\u00e7\u00e3o al\u00e9m das normais. Os jogadores mais qualificados ainda consideram isso extremamente dif\u00edcil. Pode levar os esfor\u00e7os de maratonas para reiniciar</p> <p>Exemplos: Completar um jogo sem tomar dano, especialmente se o jogador tiver uma barra de vida, desafios que restringem drasticamente o jogador e exigem precis\u00e3o quase perfeita para o sucesso. Zerar Contra duas vezes com uma vida. Zerando Megaman sem tomar dano. Zerar Super Mario Bros sem coletar power-ups, coletando apenas 2 moedas, e com a pontua\u00e7\u00e3o abaixo de 500</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-26 02:38] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:37] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:36] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:35] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:19] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-25 16:34] KingDice001:</code> Created Difficulty Scale and Balance pt_BR (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance/","title":"Difficulty Scale and Balance","text":"<p>This doc has some suggestions about difficulty, set balance and on keeping a set fun, approachable, and challenging. What you're going to see here are not rules, just suggestions.</p> <p>Note: be aware of Developers Code of Conduct</p>"},{"location":"Difficulty-Scale-and-Balance/#difficulty-scale","title":"Difficulty Scale:","text":"<ol> <li>Freebie</li> <li>Easy</li> <li>Medium</li> <li>Med-hard</li> <li>Hard</li> <li>Very-Hard</li> <li>Super-Hard</li> </ol> <p>More details on these at the bottom.</p> <p>In general there should be an steady sloping balance of difficulty. One should think of the overall difficulty of a set while building it. One should not make sets excessively difficult.</p> <p>A good set balance on a 50 cheeves in an average set would have roughly: 4 freebies, 6 easy cheeves, 10 medium, 10 med-hard, 14 hard, and 6 very-hard, 0 kaizo.</p> <p>A well balanced difficulty distribution has rewards for every type of player. It gives each skill level something to accomplish until mastery.</p> <p>Achievements should not just be a check-mark of completing a game, (too easy) but create fun new memories for the game (diversity of challenges).</p> <p>It leaves space for freebies that are featuring curious or fun elements of the game. It expects enough difficulty that once you've mastered the set you are a master of the game. But it doesn't ask too much from the player either.</p> <p>It also shouldn't ask the player to be doing seemingly endless repetitive grinding to make a set seem harder. Doing the same task over and over isn't hard, it's typically dull. It should almost always avoid making marathon types with a hill at the end (ones that require long setup times with low or repetitive difficulty and then a spike of high difficulty at the end. Don't do it!).</p> <p>Sets should be mastereable by a skilled player who gives a dedicated effort.</p> <p>Sets should reflect the content of the game. Grinding cheeves in games that require grinding are reasonable, where in other places they would often be inappropriate.</p> <p>Sets should also break out of just what is expected from a game, pushing the player to need to find new solutions for problems a veteran player never considered.</p>"},{"location":"Difficulty-Scale-and-Balance/#set-quantity","title":"Set Quantity:","text":"<p>Set quantity should not have such hard rules. Quality is the key factor.</p> <p>The set quantity strongly depends on how much fun and challenges the game can give. That's why the set developer must know the game very well.</p>"},{"location":"Difficulty-Scale-and-Balance/#set-variety","title":"Set Variety:","text":"<p>Keep it fun, give it variety, challenge the player, give the player new things to do.</p> <p>Some achievements can give much fun to the player when they are like a meta-game. Where the player is required to rethink the game entirely.</p> <p>Some notable examples:</p> <ul> <li>Fabulous Combo (25) - it turns the game into a puzzle game, completing this can be very satisfying.</li> </ul> <ul> <li>Swordless Adventurer (50) - with no sword you are forced to rethink the entire game. You can discover how useful all the sub-weapons are. Very fun!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - pacifist challenges, when possible, force a lot more agility from the player and break old habits. Very fun!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance/#definitions-of-difficulty","title":"Definitions of Difficulty","text":""},{"location":"Difficulty-Scale-and-Balance/#0-freebie","title":"0 - freebie","text":"<p>Takes almost no effort for basically all players to achieve this OR the player gets it without any conscious effort. The player gets these on accident and they pop up on the screen. Sometimes the player will have no idea why they earned them. Some freebies are good some are bad.</p> <p>Examples: Starting the game, picking a character, collecting an easily accessible item, killing your first enemy. Stumbling on a cheeve that took no forethought but highlights elements of the game.</p>"},{"location":"Difficulty-Scale-and-Balance/#1-easy","title":"1 - Easy","text":"<p>Most players could get these on their first attempt, Some on their second or third attempt. Rarely players can mess it up.</p> <p>Examples: Progress on easy stages, getting 100 coins, collecting a feather, collecting 20 rings. Getting the first upgrade, getting to a well known secret stage. Fighting a simple boss: most bosses in Super Mario World, completing early stages in Sonic.</p>"},{"location":"Difficulty-Scale-and-Balance/#2-medium","title":"2 - Medium","text":"<p>Many players could get this on their first attempt. Many could after a few attempts. Some will need to practice. Very few will struggle with them.</p> <p>Examples: Getting all the colored switches in Super Mario World, collecting all of the items in a Castlevania stage, getting a bonus item in a more hidden area, like moons in SMW. Beating Contra with the Konami code.</p>"},{"location":"Difficulty-Scale-and-Balance/#3-medium-hard","title":"3 - Medium-Hard","text":"<p>A low amount of players could get this on their first attempt. Some after a few attempts and most will take some effort and practice to complete these. A few will find them very challenging, and give up.</p> <p>Examples: Getting some of the chaos emeralds in Sonic 2. Beating Super Mario World.</p>"},{"location":"Difficulty-Scale-and-Balance/#4-hard","title":"4 - Hard","text":"<p>Very few player can get these on their first attempt, perhaps if they already know the game (not really a first attempt is it?) Most can complete these with a solid effort, many attempts and some practice, and some need to practice other games first.</p> <p>Examples: Getting all of the Chaos emeralds in Sonic 1,2,3. Beating Contra without the Konami code.</p>"},{"location":"Difficulty-Scale-and-Balance/#5-very-hard","title":"5 - Very Hard","text":"<p>Only the rarest of players can complete these on a first attempt. Most can complete it after many attempts, Many players will drop off here and won't be willing to complete the set unless they are completionists or fans of the game. Many are not able to complete this after very many attempts. Usually takes significant practice, high skills, experience, research, or guides to complete.</p> <p>Examples: Beating Contra in one life. Escaping Zebes (Super Metroid) in under two minutes. Beating many of the Megaman bosses without taking damage. Many damagless stages, depending on the game.</p>"},{"location":"Difficulty-Scale-and-Balance/#6-super-hard","title":"6 - Super Hard","text":"<p>Most players are not able to complete this after dozens of attempts. Many players will never be able to complete it as it could require beyond normal reaction speeds. The top-most skilled players still consider these blisteringly hard. It may take marathon efforts to restart.</p> <p>Examples: Completing a game without taking damage especially if the player has a lifebar, challenges that drastically restrict the player and require near frame perfect accuracy tor success. Beating contra twice in one life. Penniless plumber. Beating Megaman without taking damage.</p>"},{"location":"Difficulty-Scale-and-Balance/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-02 15:52] monkey-bug:</code> Fix typos and points in notable examples</li> <li><code>[2022-10-09 22:11] ScottFromDerby:</code> /achievement links need to be lowercase to work</li> <li><code>[2017-11-26 00:26] Kvon:</code> Changed title from \"Achievement Difficulty Scale and Difficulty Balance\"</li> </ul>"},{"location":"Docs-To-Do-List/","title":"Docs To Do List","text":"<ul> <li>Add section about reporting cheaters in Global Leaderboard and Achievement Hunting Rules</li> <li>Add Dev Tips section</li> <li>Add sections for QA, DevComp, subteams, etc.</li> <li>Other info needed:<ul> <li>Collab workflow suggestions</li> <li>Achievement set suggestions</li> <li>Helping with site cleanup</li> <li>Playtesting</li> <li>Testing cores/emulators</li> <li>Contributing with RAGuides</li> <li>Contributing with RANews</li> <li>Contributing with RAPatches</li> </ul> </li> </ul>"},{"location":"Docs-To-Do-List/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-30 13:04] televandalist:</code> Updated Docs To Do List (markdown)</li> <li><code>[2023-06-30 13:01] televandalist:</code> Updated NEWTEST Overview (markdown)</li> </ul>"},{"location":"Downloads-es/","title":"Descargas","text":""},{"location":"Downloads-es/#paquetes-de-emuladores","title":"Paquetes de Emuladores","text":"<p>Estos no contienen temas para la Interfaz (Overlay), puedes descargar el est\u00e1ndar y los personalizados en los enlaces a continuaci\u00f3n. Estos enlaces se mantienen actualizados.</p> <ul> <li>RAGens - Sega Genesis/Mega Drive  </li> <li>RASnes9x - Super Nintendo Entertainment System  </li> <li>RAFCEUx - Nintendo Entertainment System  </li> <li>RAVBA - Nintendo Gameboy/Gameboy Color/Gameboy Advance  </li> <li>RAP64 - Nintendo 64</li> <li>Project64 Plugin Pack - Paquete de complementos actualizado, necesario para que Project64 funcione.</li> <li>RAMeka - Master System</li> <li>RALibretro - (Trabajo en Progreso) una interfaz de libetro que soporta varios sistemas. Mas informacion en RALibretro page.</li> <li>RetroArch - NOTA: se usa solo para jugar, no para el desarrollo de logros.</li> </ul>"},{"location":"Downloads-es/#temas-para-la-interfaz-overlay","title":"Temas para la Interfaz (Overlay)","text":"<p>Galer\u00eda de vista previa</p>"},{"location":"Downloads-es/#simple","title":"Simple","text":"<ul> <li>Est\u00e1ndar por Scott </li> <li>Crash Bandicoot por Dexterspet </li> <li>Mega Man Classic por Salsa </li> <li>Nintendo Mix (Slumber Party) por Salsa </li> <li>Roll-chan Evolution por Salsa </li> <li>The Legend of Zelda Classic por Salsa </li> <li>Ys Book I &amp; II por Salsa </li> <li>Sonic por matheus2653 </li> <li>Arnold Schwarzenegger por Salsa </li> <li>Reginaldo Rossi por Salsa </li> </ul>"},{"location":"Downloads-es/#multiple-personalizable","title":"M\u00faltiple (personalizable)","text":"<ul> <li>Saga The Legend of Zelda por kdecks</li> </ul>"},{"location":"Downloads-es/#herramientas","title":"Herramientas","text":"<ul> <li>Lunar IPS - Parcheador de ROMs para hacks y otros parches</li> <li>Alcohol Portable - Software de Virtual Drive (para PCEngine)</li> <li>7-Zip - Para extraer los archivos de las descargas de esta p\u00e1gina</li> </ul>"},{"location":"Downloads-es/#herramientas-en-linea","title":"Herramientas en l\u00ednea","text":"<ul> <li>CRC32 checksum - Para verificar que tienes la ROM correcta</li> <li>MD5 checksum - Para verificar que tienes la ROM correcta</li> <li>Marc Robledo's online RomPatcher - Parcheador en l\u00ednea de ROMs para hacks y otros parches</li> </ul>"},{"location":"Downloads-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-30 12:46] ShinyNinetalesTM:</code> created</li> </ul>"},{"location":"Editing-Leaderboards/","title":"Editing Leaderboards","text":""},{"location":"Editing-Leaderboards/#editing-leaderboards","title":"Editing Leaderboards","text":"<ol> <li>Before making updates to a leaderboard,  you must backup each modified conditional line on the comment (if too long use Pastebin link)</li> <li>After editing a leaderboard, if you are fixing, adding, or removing entries, you must leave a comment about changes you have made and why.</li> <li> <p>A leaderboard's concept/design should not be changed once players have begun submitting entries. Exceptions are as follows:</p> <p>A. If a leaderboard has a bug in which a correction would result in a discrepancy between between pre and post fix LB submissions, this would be considered a fundamental change and it may be most appropriate to \"retire\" the leaderboard and create a new corrected LB.</p> <p>B. If a protection needs to be added to the cancel field in a leaderboard, for example to eliminate point farming/leaching (Areas where a game generates an endless number of things, such as items, money, or enemies), it may be preferable to either \u201cretire\u201d or create an additional leaderboard. \"Retiring\" a leaderboard means preventing future submissions.</p> </li> <li> <p>If a developer wishes to create a new concept for a leaderboard, a new one should be added.</p> </li> <li> <p>If a developer wants to implement a fundamental change to a leaderboard while keeping it intact, a revision vote is required. \u201cFundamental changes\u201d involve the following:</p> <p>A. Changes to how players submit scores.</p> <p>B. Changes to submission requirements that impact difficulty and or strategy.</p> </li> <li> <p>A Jr. Developer may only change, add, or remove a leaderboard with a code-reviewer that goes through the revision process with them.</p> </li> </ol>"},{"location":"Editing-Leaderboards/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-03 03:58] televandalist:</code> Updated WIP Editing Leaderboards (markdown)</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/","title":"Emulator Hotkeys for Developers","text":""},{"location":"Emulator-Hotkeys-for-Developers/#bizhawk","title":"BizHawk","text":"<p>May be configured via the Config &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>ESC</code> (<code>Backspace</code> to close overlay)</li> <li>Pause: <code>Pause</code></li> <li>Frame Advance: <code>F</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#pcsx2-with-raintegration-command-line-parameter","title":"PCSX2 (with -raintegration command line parameter)","text":"<p>May be configured via the Settings &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>F1</code> (individual slots can be assigned via <code>Hotkeys</code> &gt; <code>Save State to Slot X</code>)</li> <li>Load State:  <code>F3</code> (individual slots can be assigned via <code>Hotkeys</code> &gt; <code>Save State to Slot X</code>)</li> <li>Change State Index: <code>Shift+F2</code> (prev) / <code>F2</code> (next)</li> <li>Show Overlay: <code>ESC</code></li> <li>Pause: <code>Space</code></li> <li>Frame Advance: Can be assigned via <code>Hotkeys</code> &gt; <code>Frame Advance</code></li> <li>Fast Forward (hold): <code>.</code></li> <li>Fast Forward (toggle): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ralibretro","title":"RALibRetro","text":"<p>May be configured via the Settings &gt; Input &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>ESC</code></li> <li>Pause: <code>P</code></li> <li>Frame Advance: <code>;</code></li> <li>Fast Forward (hold): <code>=</code></li> <li>Fast Forward (toggle): <code>-</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rameka","title":"RAMeka","text":"<ul> <li>Save State: <code>F5</code></li> <li>Load State: <code>F7</code></li> <li>Change State Index: <code>F6</code> (prev) / <code>F8</code> (next)</li> <li>Show Overlay: <code>F12</code></li> <li>Frame Advance: <code>Ctrl+F12</code></li> <li>Fast Forward (toggle): <code>F2</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ranes","title":"RANes","text":"<p>May be configured via the Config &gt; Map Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>\\</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#raproject64","title":"RAProject64","text":"<p>May be configured via the Options &gt; Configuration dialog (Select Hotkeys &gt; Game playing (windowed))</p> <ul> <li>Save State: <code>F5</code></li> <li>Load State: <code>F7</code></li> <li>Change State Index: <code>1</code>-<code>0</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Fast Forward (toggle): <code>F4</code> (Must enable advanced settings: <code>Options</code> &gt; <code>Configuration</code> &gt; <code>General Settings</code> &gt; uncheck <code>Hide advanced settings</code>)</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rapplewin","title":"RAppleWin","text":"<ul> <li>Save State: <code>F11</code></li> <li>Load State: <code>F12</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>Shift+Pause</code></li> <li>Fast Forward (hold): <code>ScrollLock</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#raquasi88","title":"RAQUASI88","text":"<ul> <li>Save State: <code>F12</code> &gt; Misc &gt; Save</li> <li>Load State: <code>F12</code> &gt; Misc &gt; Load</li> <li>Show Overlay: Can be assigned via <code>F12</code> &gt; Key &gt; Assign <code>PAUSE</code> to a function key</li> <li>Fast Forward (hold): Can be assigned via <code>F12</code> &gt; Key &gt; Assign <code>NOWAIT</code> to a function key</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rasnes9x","title":"RASnes9x","text":"<ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>\\</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ravba","title":"RAVBA","text":"<ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>Ctrl+N</code></li> <li>Fast Forward (toggle): Can be assigned via <code>Options</code> &gt; <code>Key Shortcuts</code> &gt; <code>Emulation</code> &gt; <code>Turbo Mode</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-14 08:20] Jamiras:</code> Created Emulator Hotkeys for Developers (markdown)</li> </ul>"},{"location":"Emulator-Support-and-Issues/","title":"Emulator Support and Issues","text":""},{"location":"Emulator-Support-and-Issues/#console-support","title":"Console Support","text":""},{"location":"Emulator-Support-and-Issues/#3do-interactive-multiplayer","title":"3DO Interactive Multiplayer","text":"<ul> <li>\u2705 libretro core: Opera<ul> <li>Some issues depending on BIOS</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#amiga","title":"Amiga","text":"<ul> <li>\u2753 libretro core: FS-UAE</li> <li>\u274c libretro core: P-UAE<ul> <li>Needs memory map to see exposed memory</li> <li>Locks disk files so they can't be opened for hashing</li> <li>Hard disk support?</li> </ul> </li> <li>\u2753 libretro core: PUAE 2021</li> <li>\u2753 libretro core: UAE4ARM</li> </ul>"},{"location":"Emulator-Support-and-Issues/#amstrad-cpc","title":"Amstrad CPC","text":"<ul> <li>\u2705 libretro core: Caprice32<ul> <li>Core does not currently support writing to disk, which may affect hashing when implemented</li> </ul> </li> <li>\u274c libretro core: CrocoDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#apple-ii","title":"Apple II","text":"<ul> <li>\u2705 Standalone emulator: RAppleWin</li> <li>\u231b Bizhawk core: Virtu (Port)<ul> <li>Testing</li> <li>4 Jun 2023 - woz files are not supported</li> <li>4 Jun 2023 - joystick not supported. keyboard has to be manually mapped.</li> <li>4 Jun 2023 - have to manually create and load a multi-disk bundle for games with multiple disks. disks are generically labelled by index only.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#arcade","title":"Arcade","text":"<ul> <li>\u2705 libretro core: FinalBurn Neo<ul> <li>Some boards may not be fully exposed</li> </ul> </li> <li>\u2705 libretro core: flycast<ul> <li>Used for Atomiswave, NAOMI, and NAOMI2</li> </ul> </li> <li>\u274c libretro core: FB Alpha<ul> <li>Deprecated</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#arcadia-2001","title":"Arcadia 2001","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#arduboy","title":"Arduboy","text":"<ul> <li>\u2705 libretro core: Arduous</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-2600","title":"Atari 2600","text":"<ul> <li>\u2705 libretro core: Stella</li> <li>\u2753 libretro core: Stella 2014</li> <li>\u2705 Bizhawk core: AtariHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-5200","title":"Atari 5200","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: atari800<ul> <li>Appears to work fine, but the core is a bit of a headache to use.<ul> <li>The BIOS has to be configured within the core (F1 &gt; Emulator Configuration &gt; System ROM settings)</li> <li>Couldn't figure out controls - does the joystick need to be configured within the core too?</li> <li>Allows loading arbitrary files from the internal menu, which bypasses hashing</li> </ul> </li> </ul> </li> <li>\u274c libretro core: a5200<ul> <li>Does not expose memory</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-7800","title":"Atari 7800","text":"<ul> <li>\u2705 libretro core: ProSystem</li> <li>\u2705 Bizhawk core: A7800Hawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-jaguar","title":"Atari Jaguar","text":"<ul> <li>\u2705 libretro core: Virtual Jaguar<ul> <li>No save state support</li> <li>Many issues with emulation</li> </ul> </li> <li>\u2705 Bizhawk core: Virtual Jaguar</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-jaguar-cd","title":"Atari Jaguar CD","text":"<ul> <li>\u2705 Bizhawk core: Virtual Jaguar</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-lynx","title":"Atari Lynx","text":"<ul> <li>\u2705 libretro core: Handy<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Beetle Lynx</li> <li>\u2705 Bizhawk core: Handy (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-st","title":"Atari ST","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Hatari<ul> <li>Memory not exposed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#cassette-vision","title":"Cassette Vision","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#chip-8","title":"CHIP-8","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: Emux CHIP-8</li> <li>\u274c libretro core: JAXE<ul> <li>16 Apr 22 - Seems ready when we are</li> <li>May need settings blacklist to prevent lowering speed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#commodore-64","title":"Commodore 64","text":"<ul> <li>\u274c libretro core: vice_x64<ul> <li>NOTE: Joystick is in port 2 by default. Use JOY button on virtual keyboard (select) to switch it to port 1.</li> <li>1 May 2022 - Reset does not autorun game</li> </ul> </li> <li>\u231b Bizhawk core: C64Hawk<ul> <li>Testing</li> </ul> </li> <li>\u2753 libretro core: Frodo</li> </ul>"},{"location":"Emulator-Support-and-Issues/#colecovision","title":"ColecoVision","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: blueMSX</li> <li>\u2705 Bizhawk core: ColecoHawk</li> <li>\u274c libretro core: Gearcoleco</li> </ul>"},{"location":"Emulator-Support-and-Issues/#elektor-tv-games-computer","title":"Elektor TV Games Computer","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#fairchild-channel-f","title":"Fairchild Channel-F","text":"<ul> <li>\u2705 libretro core: FreeChaF</li> <li>\u2753 Bizhawk core: ChannelFHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#famicom-disk-system","title":"Famicom Disk System","text":"<ul> <li>\u2705 Standalone emulator: RANes</li> <li>\u2705 libretro core: FCEUmm</li> <li>\u2705 libretro core: Mesen</li> </ul>"},{"location":"Emulator-Support-and-Issues/#fm-towns","title":"FM Towns","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-watch","title":"Game &amp; Watch","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: gw<ul> <li>Does not expose memory</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy","title":"Game Boy","text":"<ul> <li>\u2705 Standalone emulator: RAVBA</li> <li>\u2705 libretro core: Gambatte<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Gearboy</li> <li>\u2705 libretro core: mGBA</li> <li>\u2705 libretro core: VBA-M</li> <li>\u2753 libretro core: Emux GB</li> <li>\u2753 libretro core: fixGB</li> <li>\u2753 libretro core: SameBoy</li> <li>\u2753 libretro core: TGB Dual</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy-color","title":"Game Boy Color","text":"<ul> <li>\u2705 Standalone emulator: RAVBA<ul> <li>Cartridge RAM may appear as all FFs</li> </ul> </li> <li>\u2705 Standalone emulator: Pizza Boy GBC<ul> <li>Android devices only</li> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: Gambatte<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Gearboy</li> <li>\u2705 libretro core: mGBA</li> <li>\u2705 libretro core: VBA-M</li> <li>\u2705 Bizhawk core: Gambatte</li> <li>\u2705 Bizhawk core: GBHawk</li> <li>\u2753 libretro core: Emux GB</li> <li>\u2753 libretro core: fixGB</li> <li>\u2753 libretro core: SameBoy</li> <li>\u2753 libretro core: TGB Dual</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy-advance","title":"Game Boy Advance","text":"<ul> <li>\u2705 Standalone emulator: RAVBA</li> <li>\u2705 Standalone emulator: Pizza Boy GBA<ul> <li>Android devices only</li> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: VBA-M</li> <li>\u2705 libretro core: Beetle GBA</li> <li>\u2705 libretro core: VBA Next</li> <li>\u2705 libretro core: mGBA<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: mGBA</li> <li>\u2753 libretro core: gpSP</li> <li>\u2753 libretro core: Meteor</li> <li>\u2753 libretro core: TempGBA</li> </ul>"},{"location":"Emulator-Support-and-Issues/#gamecube","title":"GameCube","text":"<ul> <li>\u231b Standalone emulator: Dolphin<ul> <li>Testing</li> </ul> </li> <li>\u231b libretro core: Dolphin<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-gear","title":"Game Gear","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: GearSystem</li> </ul>"},{"location":"Emulator-Support-and-Issues/#genesis-mega-drive","title":"Genesis / Mega Drive","text":"<ul> <li>\u2705 libretro core: Genesis Plus GX<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Picodrive</li> <li>\u274c libretro core: Blastem<ul> <li>While some achievements may work, the core has issues with the Game RAM portion of memory.</li> </ul> </li> <li>\u2705 Bizhawk core: Genplus-GX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#intellivision","title":"Intellivision","text":"<ul> <li>\u2705 libretro core: FreeIntV<ul> <li>Crashes when game is reset</li> <li>Some crashes which might be related to Intellivoice</li> </ul> </li> <li>\u2705 Bizhawk core: Intellihawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#interton-vc-4000","title":"Interton VC 4000","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#j2me","title":"J2ME","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: freej2me</li> </ul>"},{"location":"Emulator-Support-and-Issues/#magnavox-odyssey-2","title":"Magnavox Odyssey 2","text":"<ul> <li>\u2705 libretro core: O2EM</li> <li>\u2753 Bizhawk core: O2Hawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#master-system-mark-iii","title":"Master System | Mark III","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Gearsystem</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: Picodrive</li> <li>\u2753 Bizhawk core: SMSHawk</li> <li>\u2753 libretro core: Emux SMS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#mega-duck","title":"Mega Duck","text":"<ul> <li>\u2705 libretro core: SameDuck</li> </ul>"},{"location":"Emulator-Support-and-Issues/#ms-dos","title":"MS-DOS","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: dosbox-core</li> <li>\u274c libretro core: dosbox-SVN</li> <li>\u274c libretro core: dosbox-pure<ul> <li>Needs a way to prevent launching with user-specified command line parameters</li> <li>Needs a way to prevent TSRs</li> <li>Needs a way to deactivate achievements if game drops to command prompt</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#msx","title":"MSX","text":"<ul> <li>\u2705 libretro core: blueMSX<ul> <li>Hash relies on .DSK file not being modified</li> <li>.DSK files appear to be unsupported if they also require a cartridge. There is a core option for this, but it doesn't seem to function properly. See \"SD Snatcher\", which used a 'sound' cartridge.</li> </ul> </li> <li>\u2753 libretro core: fMSX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-cd","title":"Neo Geo CD","text":"<ul> <li>\u2705 libretro core: NeoCD</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-pocket","title":"Neo Geo Pocket","text":"<ul> <li>\u2705 libretro core: Beetle NeoPop</li> <li>\u2753 libretro core: RACE</li> <li>\u2705 Bizhawk core: Beetle NeoPop (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-pocket-color","title":"Neo Geo Pocket Color","text":"<ul> <li>\u2705 libretro core: Beetle NeoPop</li> <li>\u2753 libretro core: RACE</li> <li>\u2705 Bizhawk core: Beetle NeoPop (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nes-famicom","title":"NES / Famicom","text":"<ul> <li>\u2705 Standalone emulator: RANes</li> <li>\u2705 libretro core: FCEUmm<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Mesen</li> <li>\u2705 libretro core: QuickNES</li> <li>\u274c libretro core: NEStopia<ul> <li>Does not map SRAM</li> <li>PLEASE STOP USING THIS FOR ACHIEVEMENTS</li> </ul> </li> <li>\u2753 libretro core: Emux NES</li> <li>\u2753 libretro core: fixNES</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-3ds","title":"Nintendo 3DS","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Citra<ul> <li>Only exposes 64MB of memory - documentation suggests there should be 128MB.</li> <li>Does not support save states</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-64","title":"Nintendo 64","text":"<ul> <li>\u2705 Standalone emulator: RAProject64</li> <li>\u2705 libretro core: ParaLLEl N64</li> <li>\u2705 libretro core: Mupen64Plus-Next<ul> <li>Most recommended</li> </ul> </li> <li>\u231b Bizhawk core: Mupen64plus<ul> <li>Testing (there are some graphical issues that can be fixed using the angrylion plugin)</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-ds","title":"Nintendo DS","text":"<ul> <li>Limited microphone support</li> <li>\u2705 libretro core: DeSmuME</li> <li>\u2705 libretro core: DeSmuME 2015</li> <li>\u2705 libretro core: melonDS</li> <li>\u2705 Bizhawk core: MelonDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-dsi","title":"Nintendo DSi","text":"<ul> <li>\u2705 Bizhawk core: melonDS</li> <li>\u274c libretro core: DeSmuME</li> <li>\u274c libretro core: melonDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nokia-n-gage","title":"Nokia N-Gage","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#oric","title":"Oric","text":"<ul> <li>\u274c Not supported</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-engine-turbografx-16-supergrafx","title":"PC Engine | TurboGrafx-16 | SuperGrafx","text":"<ul> <li>\u2705 libretro core: Beetle PCE Fast<ul> <li>SuperGrafx games do not work on the Beetle PCE Fast core</li> </ul> </li> <li>\u2705 libretro core: Beetle SuperGrafx<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: PCEHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-engine-cd-turbografx-cd","title":"PC Engine CD | TurboGrafx-CD","text":"<ul> <li>\u2705 libretro core: Beetle PCE Fast</li> <li>\u2705 libretro core: Beetle SuperGrafx<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: PCEHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-6001","title":"PC-6001","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-8800","title":"PC-8800","text":"<ul> <li>\u2705 Standalone emulator: RAQuasi88<ul> <li>Most recommended</li> </ul> </li> <li>\u274c libretro core: quasi88<ul> <li>NOT RECOMMENDED</li> <li>PC-88VA not supported</li> <li>16 Apr 2022 - Cannot load m3u. Hash fails because core locks disk file.</li> <li>16 Apr 2022 - Attempting to load a single disk game in RALibretro just goes to \"How many disks?\" prompt. Seems to work in RetroArch</li> <li>16 Apr 2022 - RALibretro does not provide subsystem interface for loading multi-disk games</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-9800","title":"PC-9800","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Neko Project II Kai<ul> <li>Memory is not exposed.<ul> <li>It appears to be exposed in some games depending on the RAM size selected, but it seems like the machine RAM and not actually related to the game.</li> </ul> </li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-fx","title":"PC-FX","text":"<ul> <li>\u2705 libretro core: Beetle PC-FX</li> <li>\u2705 Bizhawk core:</li> </ul>"},{"location":"Emulator-Support-and-Issues/#philips-cd-i","title":"Philips CD-I","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: SAME CDi</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pico-8","title":"Pico-8","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: FAKE-08</li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation","title":"PlayStation","text":"<ul> <li>\u2705 Standalone emulator: DuckStation<ul> <li>There may be memory leak and/or burn-in when using save states. Softcore players beware!</li> </ul> </li> <li>\u2705 libretro core: Beetle PSX HW<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Beetle PSX</li> <li>\u2705 libretro core: ReARMed<ul> <li>BIOS are not required for this core and will zero out the Kernal RAM.</li> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u2705 libretro core: SwanStation</li> <li>\u2753 Bizhawk core: octoshock</li> <li>\u2753 Bizhawk core: Nymashock</li> <li>\u2753 libretro core: Rustation</li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation-2","title":"PlayStation 2","text":"<ul> <li>\u2705 Standalone emulator: PCSX2<ul> <li>PCSX2 is currently the only officially supported option for earning achievements.</li> </ul> </li> <li>\u274c libretro core: LRPS2<ul> <li>Still in alpha state</li> <li>Does not expose memory</li> </ul> </li> <li>\u274c libretro core: Play!<ul> <li>Low compatibility with most commerical games</li> <li>Black screen with stuttering sound</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation-portable","title":"PlayStation Portable","text":"<ul> <li>\u2705 Standalone emulator: PPSSPP<ul> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: PPSSPP<ul> <li>Loading save states too fast can cause it to crash</li> <li>Some games have graphical issues </li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pocketstation","title":"PocketStation","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: pockystation<ul> <li>Core doesn't seem functional, even in RetroArch</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pokemon-mini","title":"Pokemon Mini","text":"<ul> <li>\u2705 libretro core: PokeMini</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-32x","title":"Sega 32X","text":"<ul> <li>\u2705 libretro core: PicoDrive<ul> <li>Several games are problematic</li> <li>Appears to still have unmapped RAM</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-cd","title":"Sega CD","text":"<ul> <li>Appears to still have unmapped RAM</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: Picodrive</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-dreamcast","title":"Sega Dreamcast","text":"<ul> <li>\u2705 libretro core: flycast<ul> <li>Must disable threaded rendering to use save states</li> </ul> </li> <li>\u2753 libretro core: Flycast GLES2</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-pico","title":"Sega Pico","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: picodrive<ul> <li>Needs controls related to turning pages in the attached books</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-saturn","title":"Sega Saturn","text":"<ul> <li>\u2705 libretro core: Beetle Saturn<ul> <li>The only recommended core</li> </ul> </li> <li>\u274c libretro core: Yabause<ul> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u274c libretro core: Kronos<ul> <li>Saving and loading states often locks up the UI in RALibretro</li> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u2753 libretro core: YabaSanshiro</li> <li>\u231b Bizhawk core: Saturnus     - Testing</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sg-1000","title":"SG-1000","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Genesis Plus GX<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: blueMSX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sharp-x1","title":"Sharp X1","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: X1 Millennium<ul> <li>16 Apr 2022 - Disk writes modify source media, which breaks hashing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sharp-x68k","title":"Sharp X68K","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: px68k<ul> <li>Crashes RALibretro upon loading a game</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#snes-super-famicom-satellaview-sufami-turbo","title":"SNES | Super Famicom | Satellaview | Sufami Turbo","text":"<ul> <li>\u2705 Standalone emulator: RASnes9x</li> <li>\u2705 libretro core: Snes9x (Current)<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Mesen-S</li> <li>\u2753 libretro core: Beetle bsnes</li> <li>\u2753 libretro core: Beetle Supafaust</li> <li>\u2753 libretro core: bsnes</li> <li>\u2753 libretro core: bsnes 2014 Accuracy</li> <li>\u2753 libretro core: bsnes 2014 Balanced</li> <li>\u2753 libretro core: bsnes 2014 Performance</li> <li>\u2753 libretro core: bsnes C++98 (v085)</li> <li>\u2753 libretro core: bsnes-hd beta</li> <li>\u2753 libretro core: bsnes-mercury Accuracy</li> <li>\u2753 libretro core: bsnes-mercury Balanced</li> <li>\u2753 libretro core: bsnes-mercury Performance</li> <li>\u2753 libretro core: higan Accuracy</li> <li>\u2753 libretro core: nSide Balanced</li> <li>\u2753 libretro core: Snes9x 2002</li> <li>\u2753 libretro core: Snes9x 2005</li> <li>\u2753 libretro core: Snes9x 2005+</li> <li>\u274c libretro core: Snes9x 2010<ul> <li>PLEASE STOP USING THIS FOR ACHIEVEMENTS!!!!</li> </ul> </li> <li>\u2753 Bizhawk core: BSNES</li> <li>\u2753 Bizhawk core: BSNESv115+</li> </ul>"},{"location":"Emulator-Support-and-Issues/#super-cassette-vision","title":"Super Cassette Vision","text":"<ul> <li>\u274c libretro core: EmuSCV<ul> <li>Unfinished according to libretro docs.</li> <li>Does not expose memory. Appears to export a save state via the RETRO_MEMORY_SAVE_RAM interface, which we try to shoehorn into $E000 as that's what's flagged as Cartridge RAM for the system.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#thomson-to8to8d","title":"Thomson TO8/TO8D","text":"<ul> <li>\u274c Not supported - needs hashing method</li> <li>\u274c libretro core: Theodore<ul> <li>Seems to work</li> <li>Uncertain how core handles writing to disk/tape. May affect hashing.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#ti-83","title":"TI-83","text":"<ul> <li>\u231b libretro core: Numero<ul> <li>Testing</li> </ul> </li> <li>\u231b Bizhawk core: TI83Hawk<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#tic-80","title":"TIC-80","text":"<ul> <li>\u274c Not supported - needs hashing method</li> <li>\u274c libretro core: TIC-80<ul> <li>Doesn't export memory correctly. Can only see 8 bytes.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#uzebox","title":"Uzebox","text":"<ul> <li>\u2705 Bizhawk core: uzem</li> <li>\u2705 libretro core: Uzebox</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vectrex","title":"Vectrex","text":"<ul> <li>\u2705 libretro core: VecX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vic-20","title":"VIC-20","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: VICE xvic</li> </ul>"},{"location":"Emulator-Support-and-Issues/#virtual-boy","title":"Virtual Boy","text":"<ul> <li>\u2705 libretro core: Beetle VB</li> <li>\u2705 Bizhawk core: VBoy</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vmu","title":"VMU","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method, and memory map</li> <li>\u274c libretro core: VeMUlator</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wasm-4","title":"WASM-4","text":"<ul> <li>\u2705 libretro core: wasm4</li> </ul>"},{"location":"Emulator-Support-and-Issues/#watara-supervision","title":"Watara Supervision","text":"<ul> <li>\u2705 libretro core: potator</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wii","title":"Wii","text":"<ul> <li>\u231b Standalone emulator: Dolphin<ul> <li>Testing</li> </ul> </li> <li>\u231b libretro core: Dolphin<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#wii-u","title":"Wii U","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wonderswan","title":"WonderSwan","text":"<ul> <li>\u2705 libretro core: Beetle Cygne</li> <li>\u2705 Bizhawk core: Cygne (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wonderswan-color","title":"WonderSwan Color","text":"<ul> <li>\u2705 libretro core: Beetle Cygne</li> <li>\u2705 Bizhawk core: Cygne (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#xbox","title":"XBOX","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#zeebo","title":"Zeebo","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#zx81","title":"ZX81","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: EightyOne<ul> <li>Memory not exposed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#zx-spectrum","title":"ZX Spectrum","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: FUSE<ul> <li>Requires ability to map keyboard to port 3</li> <li>Uncertain about save support. Cannot seem to insert save disk</li> </ul> </li> <li>\u231b - Bizhawk core: ZXHawk<ul> <li>Hashing needs to be corrected</li> <li>Testing</li> </ul> </li> </ul> <p>More details on Bizhawk cores can be found here.</p>"},{"location":"Emulator-Support-and-Issues/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-27 11:17] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2024-01-12 16:54] Jamiras:</code> add mGBA to supported cores for GB/GBC</li> <li><code>[2023-12-29 03:19] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-12-29 03:15] televandalist:</code> Added Pizza Boy GBA+GBC and PPSSPP standalone. Hopefully fixed the line breaks for the deployed docs (it's not WYSIWYG)</li> <li><code>[2023-09-19 19:48] Jamiras:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-07-23 17:59] Joe Pizzimenti:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-24 07:11] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-04 16:16] Jamiras:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-01 22:08] televandalist:</code> Updated DSi</li> <li><code>[2023-04-12 06:47] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> </ul>"},{"location":"Events/","title":"Events","text":""},{"location":"Events/#current-events","title":"Current Events","text":"Event Name Current Host(s) Relevant Link More Info Achievement of the Week Various Challenge League 4 BahamutVoid Daily DistRActions Bendyhuman DevQuests Various Developer Event (Series) Leaderboard of the Month Searo Peak Streak Bendyhuman RetroAchievements Roulette (RAWR) StingX2 Retro Game Show Thoreau Rollouts Simple Monthly Master Hotscrock The Unwanted televandalist UserQuests(?) Various Player Event (Series)"},{"location":"Events/#past-or-seasonal-events","title":"Past or Seasonal Events","text":"Event Name Previous Host(s) Relevant Link More Info Bad Idea Game StingX2 Bendyhuman's Master Quest Bendyhuman CommuniPlay SporyTike Devember kdeckswilhitewarriorSlashTangent Developer Event Leapfrog BoldewinHolyShinxNevermond12televandalist Master of the Month JAM Rescoring Contributor kdecks RetroAchievements Tournament diegoplantes RetroOlympics Searovoiceofautumn Retro Battle Thoreau Retro Clean-Up 2019 SporyTike Developer Event Retro VGM Quiz Thoreau RPM JAMXymjak Spring Cleaning 2020 wilhitewarrior Developer Event \ud83d\udc80The Big Achievement 2020\ud83d\udc80 televandalist The Great Jacko StingX2 Developer Event The Pumpkin King kdecks VGM Contest RimsalaWateredWillow"},{"location":"Events/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-20 05:46] televandalist:</code> Fixed links</li> <li><code>[2022-03-13 21:23] televandalist:</code> Fix links</li> <li><code>[2022-02-08 22:56] televandalist:</code> Added links for DevQuest and Rollouts doc pages</li> <li><code>[2022-02-08 22:55] televandalist:</code> Updated Events (markdown)</li> <li><code>[2022-02-06 02:47] televandalist:</code> Start Event Page/Directory - will add more later</li> </ul>"},{"location":"FAQ-es/","title":"Preguntas Frecuentes","text":"<ul> <li>\u00bfQu\u00e9 es RetroAchievements.org?</li> <li>\u00bfQu\u00e9 emulador necesito usar?     - Emuladores oficiales de RetroAchievements.org         - \u00bfC\u00f3mo accedo a la interfaz (Overlay) de logros?     - Emulador RetroArch         - \u00bfQu\u00e9 n\u00facleos (Core) RetroArch deber\u00eda usar?         - \u00bfC\u00f3mo puedo ver la insignia (Badge) cuando gano un logro en RetroArch?</li> <li>RetroArch/RALibretro no corre mi juego de arcade. \u00bfQue tengo que hacer?</li> <li>\u00bfSer\u00e1 RetroAchievements compatible con PlayStation?</li> <li>\u00a1Mi correo electr\u00f3nico de bienvenida se ha perdido!</li> <li>\u00bfDonde puedo encontrar ROMs?</li> <li>\u00bfPor qu\u00e9 mi juego no est\u00e1 cargando sus logros?</li> <li>\u00bfQu\u00e9 es el modo \"Hardcore\"?</li> <li>\u00a1No obtuve este logro! (o lo obtuve en un momento equivocado)</li> <li>Complet\u00e9 un logro dif\u00edcil pero no se activ\u00f3, \u00bfse me puede desbloquear manualmente?</li> <li>\u00a1Yo tambi\u00e9n quiero hacer logros!</li> <li>\u00bfQue son los Puntos Blancos (White points)?</li> <li>\u00bfQu\u00e9 se considera hacer trampa (para el Hardcore)? \u00bfQu\u00e9 pasa si encuentro evidencia de un tramposo?</li> <li>\u00bfQu\u00e9 pasa si obtengo un logro que no gan\u00e9?</li> <li>\u00bfC\u00f3mo puedo restablecer mi contrase\u00f1a? (Si no la recuerdo)</li> <li>\u00bfPorque no puedo ver mi nueva foto de perfil?</li> <li>\u00bfVoy obtener alg\u00fan privilegio si me convierto en Patreon?</li> <li>\u00bfRetroAchievements esta haciendo dinero por medio de la emulaci\u00f3n?</li> </ul>"},{"location":"FAQ-es/#que-es-retroachievementsorg","title":"\u00bfQu\u00e9 es RetroAchievements.org?","text":"<p>RetroAchievements.org es una comunidad que colabora y compite para ganar logros personalizados en juegos cl\u00e1sicos a trav\u00e9s de la emulaci\u00f3n. Los logros son hechos por y para la comunidad. Ofrecemos varios emuladores personalizados para su uso, que detectar\u00e1n cuando hayas completado varios desaf\u00edos. Una vez que hayas iniciado sesi\u00f3n, los emuladores publicar\u00e1n los logros que hayas completado en el sitio, para que puedas verificar y comparar tu progreso con el de tus amigos.</p> <p>Aqu\u00ed hay un ejemplo de RAGens, jugando Streets of Rage 2. Ver\u00e1s dos contadores de intentos de tabla de clasificaci\u00f3n (abajo a la derecha), un logro desbloque\u00e1ndose y finalmente la interfaz (Overlay, presionando ESC):</p> <p></p>"},{"location":"FAQ-es/#que-emulador-necesito-usar","title":"\u00bfQu\u00e9 emulador necesito usar?","text":"<p>Los emuladores oficiales de RetroAchievements.org son todos basados en Windows. Para otros sistemas operativos, puedes usar RetroArch. M\u00e1s informaci\u00f3n a continuaci\u00f3n:</p>"},{"location":"FAQ-es/#emuladores-oficiales-de-retroachievementsorg","title":"Emuladores oficiales de RetroAchievements.org","text":"<p>Descarga el emulador de tu elecci\u00f3n en la p\u00e1gina de descargas, inicia sesi\u00f3n con tu nombre de usuario y contrase\u00f1a (s\u00ed, primero debes crearte una cuenta), luego carga una ROM \u00a1y juega!</p>"},{"location":"FAQ-es/#como-accedo-a-la-interfaz-overlay-de-logros","title":"\u00bfC\u00f3mo accedo a la interfaz (Overlay) de logros?","text":"<p>Normalmente, esto se configurar\u00e1 en la tecla de teclado 'ESC' o en la funci\u00f3n de pausa del juego. En la mayor\u00eda de los emuladores, un juego debe estar activo para que funcione.</p> <p>Algunos de los emuladores ya deber\u00edan estar configurados asignando un bot\u00f3n de controlador para ver la interfaz de logros. Generalmente 'ESC' en el teclado debe activarlo, pero si deseas asignarlo a un control, aqu\u00ed hay algunos trucos para algunos de los emuladores oficiales:</p> <ul> <li>Para RAVBA, ir a Tools &gt; Customize y asignar FilePause a un bot\u00f3n.</li> </ul> <ul> <li>Para RASNES, ir a Input &gt; Customize Hotkeys y cambiar Pause/Overlay en la p\u00e1gina 1.</li> </ul> <ul> <li>Para RANES, ir a Config &gt; Map Hotkeys y cambiar Pause a un bot\u00f3n (Nota: esto puede bloquear el emulador, es mejor hacerlo sin una ROM cargada para tener mejores oportunidades).</li> </ul>"},{"location":"FAQ-es/#emulador-retroarch","title":"Emulador RetroArch","text":"<p>Para sistemas operativos que no sean Windows, debes usar el emulador RetroArch.</p> <p>Actualmente se pueden obtener logros a trav\u00e9s de RetroArch en las siguientes plataformas:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (\u00a1s\u00ed, puedes conseguir logros mientras viajas con tu tel\u00e9fono Android!)</li> <li>PlayStation Vita (necesita estar pirateado con HENkaku)</li> <li>PlayStation 3</li> <li>Wii U</li> <li>Raspberry Pi (Sistemas recomendados: RetroPie, lakka y RecalBox)</li> </ul> <p>Se puede obtener RetroArch en los siguientes enlaces:</p> <ul> <li>stable</li> <li>nightly</li> </ul> <p>Una vez que lo hayas instalado y hecho la configuraci\u00f3n inicial, sigue esta gu\u00eda para configurar los logros: https://libretro.readthedocs.io/en/latest/guides/retroachievements/</p>"},{"location":"FAQ-es/#que-nucleo-core-retroarch-deberia-usar","title":"\u00bfQu\u00e9 n\u00facleo (Core) RetroArch deber\u00eda usar?","text":"<p>Hay que tener en cuenta que no todos los n\u00facleos (Core) de RetroArch son compatibles con RetroAchievements. Consulta esta lista para ver cu\u00e1l elegir.</p>"},{"location":"FAQ-es/#como-puedo-ver-la-insignia-badge-cuando-gano-un-logro-en-retroarch","title":"\u00bfC\u00f3mo puedo ver la insignia (Badge) cuando gano un logro en RetroArch?","text":"<p>Esta funci\u00f3n fue implementada en RetroArch 1.7.7 (May/2019), aunque aun hay algunas plataformas en las que aun no funciona (como en el PS Vita). Simplemente necesitas percatarte que la opci\u00f3n de Menu Widget este habilitada (que usualmente lo esta por default).</p>"},{"location":"FAQ-es/#retroarchralibretro-no-corre-mi-juego-de-arcade-que-tengo-que-hacer","title":"RetroArch/RALibretro no corre mi juego de arcade. \u00bfQue tengo que hacer?","text":"<p>Primero lo primero: percatate de estar utilizando el n\u00facleo de RetroArch correcto. Checa aqui cual nucleo deberias de utilizar para poder utilizar la funci\u00f3n de RetroAchievements en juegos de arcade: https://libretro.readthedocs.io/en/latest/guides/retroachievements/#arcade</p> <p>Segundo punto: Los ROMs de Arcade son mas complicados que los de consolas. Hay algunos conceptos y terminologias que necesitas entender y asi todo va a empezar a tener sentido. Aqu\u00ed hay un buen texto en ingles sobre este tema: Demystifying MAME ROMs.</p> <p>Tip Pro: utiliza tu motor de b\u00fasqueda preferido para buscar un \"set de referencia\" (utilizar ROMs de manera aleatoria de diferentes fuentes es un m\u00e9todo de \"prueba y error\" y lo mas probable es que te frustres demasiado).</p>"},{"location":"FAQ-es/#sera-retroachievements-compatible-con-playstation","title":"\u00bfSer\u00e1 RetroAchievements compatible con PlayStation?","text":"<p>Respuesta mem\u00e9tica: Cada vez que alguien pregunta sobre los logros de PSX, el desarrollo se retrasa un mes m\u00e1s. Asi que por favor, \u00a1DEJA DE PREGUNTAR!</p> <p>Respuesta corta: Si, lo ser\u00e1, pero aun no hay una fecha estimada para su llegada.</p> <p>Respuesta larga: El m\u00e9todo actual de creaci\u00f3n de logros tiene limitaciones que influyen directamente en la calidad de los logros. Los juegos de PlayStation son un poco m\u00e1s complejos que los de las consolas que ya son compatibles aqu\u00ed (excepto quiz\u00e1s, los de Nintendo 64). Y en consecuencia, los logros de los juegos de PS merecen una mayor elaboraci\u00f3n y cuidado. Todos tenemos un gran respeto por la consola de PlayStation, y esa es exactamente la raz\u00f3n por la que queremos implementar mejoras en el kit de herramientas utilizado para crear logros antes de agregar este soporte.</p> <p>Nota: si encuentras cualquier otro sitio con logros para PlayStation, ten en cuenta que no esta asociado con RetroAchievements.</p>"},{"location":"FAQ-es/#mi-correo-electronico-de-bienvenida-se-ha-perdido","title":"\u00a1Mi correo electr\u00f3nico de bienvenida se ha perdido!","text":"<p>Lamentablemente, es sabido que algunas veces se pierde el correo electr\u00f3nico de bienvenida. Si esto sucede, inicia sesi\u00f3n con tu nombre de usuario/contrase\u00f1a con el que te registraste, luego visita tu p\u00e1gina de configuraci\u00f3n. En la parte superior, encontrar\u00e1s la opci\u00f3n de volver a enviar tu correo electr\u00f3nico de registro.</p>"},{"location":"FAQ-es/#donde-puedo-encontrar-roms","title":"\u00bfDonde puedo encontrar ROMs?","text":"<p>Aqu\u00ed no. Lamentablemente, es ilegal alojar o distribuir ROMs con derechos de autor.</p>"},{"location":"FAQ-es/#por-que-mi-juego-no-esta-cargando-sus-logros","title":"\u00bfPor qu\u00e9 mi juego no est\u00e1 cargando sus logros?","text":"<p>Ya sea:</p> <ol> <li>No tiene logros.</li> <li>Es la ROM incorrecta.</li> </ol> <p>Una buena pr\u00e1ctica es verificar el tema oficial del foro del juego. Si a\u00fan no tienes una respuesta, consulta esta p\u00e1gina aqu\u00ed para m\u00e1s detalles: Mi juego no esta cargando los logros.</p>"},{"location":"FAQ-es/#que-es-el-modo-hardcore","title":"\u00bfQu\u00e9 es el modo \"Hardcore\"?","text":"<p>El modo Hardcore es una caracter\u00edstica adicional para separar a los buenos jugadores de los grandes jugadores: el modo Hardcore desactiva toda forma de salvado y cargado (savestates) en el emulador: no podr\u00e1s guardar y volver a cargar en cualquier momento. Tendr\u00e1s que completar el juego y obtener los logros la primera vez, al igual que en la consola original. En recompensa por esto, ganar\u00e1s tanto el logro est\u00e1ndar como el logro en modo Hardcore, en efecto, \u00a1ganando el doble de puntos! \u00a1Un juego que normalmente vale 400 puntos, vale 800 puntos si lo completas exitosamente en el modo Hardcore! Por ejemplo: si completas el juego por completo con 400 puntos, entonces tienes la oportunidad de ganar otros 400 en el modo Hardcore.</p> <p>Si quieres jugar con el modo Hardcore desactivado (tambi\u00e9n conocido como \"softcore\"), podr\u00e1s tener algunos problemas. M\u00e1s detalles aqu\u00ed: Why you shouldn't use the load state feature</p>"},{"location":"FAQ-es/#no-obtuve-este-logro-o-lo-obtuve-en-un-momento-equivocado","title":"\u00a1No obtuve este logro! (o lo obtuve en un momento equivocado)","text":"<p>Hay una caracter\u00edstica incorporada solo en los emuladores oficiales (no en RetroArch) que permite informar sobre logros rotos que se obtienen en el momento equivocado, o que no se obtienen del todo. Ir a RetroAchievements -&gt; Report Broken Achievements.</p> <p>Ejemplo:</p> <p>.</p> <p>Tambi\u00e9n hay una forma de informar sobre logros rotos directamente a trav\u00e9s del sitio web. En la p\u00e1gina de cada logro, hay un enlace que dice <code>Report an issue for this achievement</code>, como en la imagen a continuaci\u00f3n:</p> <p></p> <p>Agrega detalles del estado de tu juego, cu\u00e1ndo se activ\u00f3/no se activ\u00f3 el logro, en qu\u00e9 modo de juego ocurri\u00f3, d\u00f3nde estabas cuando sucedi\u00f3/no sucedi\u00f3, si reseteaste el juego recientemente, o cualquier otra cosa que creas que pueda ser relevante para el logro. Esto es necesario para nuestro sistema, para que los desarrolladores sepan d\u00f3nde esta el problema.</p>"},{"location":"FAQ-es/#complete-un-logro-dificil-pero-no-se-activo-se-me-puede-desbloquear-manualmente","title":"Complet\u00e9 un logro dif\u00edcil pero no se activ\u00f3, \u00bfse me puede desbloquear manualmente?","text":"<p>S\u00ed. Pero debes seguir los siguientes pasos:</p> <ol> <li>Envia un ticket describiendo con detalles el problema que tuvo con el logro. <code>Mira la pregunta/respuesta anterior para saber c\u00f3mo enviar un ticket.</code>     1. Si el logro no se registr\u00f3 en el sitio debido a un problema de red, no es necesario que envie un ticket.</li> <li>Obt\u00e9n una prueba/evidencia de que completaste el logro (ejemplo perfecto de evidencia proporcionado por gr1nya). Pruebas aceptables:     1. Capturas de pantalla que muestran que estas jugando en Hardcore y has completado el logro.     2. Un video de aquello (mucho mejor).     3. Ejemplos de logros que has obtenido que reemplazan o superan este logro, por ejemplo, obtuviste el logro de 10.000 puntos, pero no el de 5.000 puntos.</li> <li>Publ\u00edcalo en el canal <code>#help-me</code> de nuestro Servidor de Discord, mencionando a alg\u00fan @admin u otro usuario con el rol de admin, proporcionando la siguiente informaci\u00f3n:     1. En enlace a la p\u00e1gina del logro     2. En que modo estabas jugando (hardcore/softcore)     3. El enlace a la evidencia (captura de pantalla, video, etc.)</li> </ol>"},{"location":"FAQ-es/#yo-tambien-quiero-hacer-logros","title":"\u00a1Yo tambi\u00e9n quiero hacer logros!","text":"<p>\u00a1Es bueno escuchar eso! El mejor lugar para empezar es aqui: Getting Started as an Achievement Developer. Una vez que est\u00e9s familiarizado con el Memory Inspector y otros di\u00e1logos relacionados con los logros, puedes ir al resto de los Developer Docs.</p> <p>Por favor, no dudes en preguntar si necesitas ayuda, \u00a1no luches! Lo m\u00e1s importante es asegurarte de que est\u00e1s disfrutando lo que sea que est\u00e9s haciendo. Si no te est\u00e1s divirtiendo, no lo hagas. Pero si te sientes frustrado y quieres persistir, simplemente deja caer un mensaje en los foros o en el Servidor de Discord y alguien se comunicar\u00e1 contigo en breve.</p>"},{"location":"FAQ-es/#que-son-los-puntos-blancos-white-points","title":"\u00bfQue son los Puntos Blancos (White points)?","text":"<p>Los puntos blancos (White points) son secundarios seg\u00fan lo dif\u00edcil que sea un logro. Explicado en detalle aqu\u00ed.</p>"},{"location":"FAQ-es/#que-se-considera-hacer-trampa-para-el-hardcore-que-pasa-si-encuentro-evidencia-de-un-tramposo","title":"\u00bfQu\u00e9 se considera hacer trampa (para el Hardcore)? \u00bfQu\u00e9 pasa si encuentro evidencia de un tramposo?","text":"<p>Explotaci\u00f3n de conjuntos de logros y alteraci\u00f3n o modificaci\u00f3n deliberada de juego, emulador, memoria, velocidad (avance r\u00e1pido) o conjunto. Cargar bater\u00edas grabadas para obtener logros fuera de lugar sin ganarlos durante el juego normal.</p> <p>Se prohiben todas las trampas de los juegos, a menos que se especifique en la descripci\u00f3n o los comentarios del logro en la p\u00e1gina del logro.</p> <p>Vivimos por un c\u00f3digo de honor m\u00e1s que nada. Si encuentras evidencia de un tramposo, env\u00eda la evidencia a RAdmin, o env\u00eda un correo electr\u00f3nico a RAmodmail@gmail.com.</p>"},{"location":"FAQ-es/#que-pasa-si-obtengo-un-logro-que-no-gane","title":"\u00bfQu\u00e9 pasa si obtengo un logro que no gan\u00e9?","text":"<p>Lo mismo ocurre con no obtenerlo cuando deber\u00eda, en la mayor\u00eda de los casos, querr\u00e1s crear un informe de ticket (ver arriba), dejando una explicaci\u00f3n de lo que sali\u00f3 mal. Tambi\u00e9n querr\u00e1s eliminar estos logros de tu cuenta, para que puedas tener la satisfacci\u00f3n de realmente ganarlos por ti mismo.</p> <p> Restableciendo logros no ganados.</p>"},{"location":"FAQ-es/#como-puedo-restablecer-mi-contrasena-si-no-la-recuerdo","title":"\u00bfC\u00f3mo puedo restablecer mi contrase\u00f1a? (Si no la recuerdo)","text":"<p>Justo aqu\u00ed: https://retroachievements.org/resetPassword.php</p> <p>En el sitio, p\u00e1gina principal, mientras no est\u00e9 conectado:</p> <p></p>"},{"location":"FAQ-es/#porque-no-puedo-ver-mi-nueva-foto-de-perfil","title":"\u00bfPorque no puedo ver mi nueva foto de perfil?","text":"<p>Presiona <code>Ctrl + F5</code> (en la mayor\u00eda de navegadores). Algunas veces despu\u00e9s de haber cambiado tu foto de perfil (tambi\u00e9n conocido como avatar o foto de usuario) necesitas refrescar la cache de tu navegador; en la mayor\u00eda de los navegadores la manera mas r\u00e1pida de hacerlo es con <code>Ctrl + F5</code>.</p>"},{"location":"FAQ-es/#voy-obtener-algun-privilegio-si-me-convierto-en-patreon","title":"\u00bfVoy obtener alg\u00fan privilegio si me convierto en Patreon?","text":"<p>En el sitio web vas a obtener un badge que dice \"I helped fund RA!\". En el servidor de discord vas a tener acceso a un canal dedicado. Aunque estamos inmensamente agradecido por los aportes de nuestros Patreons, no hay otro bonus aparte de esos.</p> <p>Gracias a las contribuciones de Patreon el proyecto de RetroAchievements puede pagar un servidor decente en el sitio web, correr el bot de discord y tambi\u00e9n realizar respaldos cada cierto tiempo (para recuperar informaci\u00f3n en caso de un desastre), y todo esto con una experiencia libre de anuncios. La comunidad entera le merece un gran gracias a los patreons.</p>"},{"location":"FAQ-es/#retroachievements-esta-haciendo-dinero-por-medio-de-la-emulacion","title":"\u00bfRetroAchievements esta haciendo dinero por medio de la emulaci\u00f3n?","text":"<p>No. RetroAchievements es una comunidad de fans devotos que quieren rendirle homenaje a sus juegos favoritos creando y sacando logros! Aunque tambi\u00e9n aceptamos donaciones por medio de Patreon todo el dinero donado se utiliza para pagar los gastos de los servidores y mantener el sitio completamente libre de anuncios. Todos los programadores y desarrolladores entregan su tiempo a lo mejor para la comunidad a su propio costo.</p>"},{"location":"FAQ-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-04-21 03:38] luchaos:</code> update libretro docs links</li> <li><code>[2019-05-24 10:18] eldexterr:</code> Added missing information</li> <li><code>[2019-04-20 15:15] eldexterr:</code> Changed \"otorgar manualmente\" to \"desbloquear manualmente\"</li> <li><code>[2019-02-14 10:12] meleu:</code> fix broken link</li> <li><code>[2019-02-09 20:19] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:14] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:45] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-09 13:15] ShinyNinetalesTM:</code> edited the a link to https://github.com/RetroAchievements/docs/wiki/My-game-is-not-loading-achievements-es</li> <li><code>[2018-05-06 13:19] ShinyNinetalesTM:</code> fixed several words without accent mark (tilde) and some missing commas and parentheses</li> <li><code>[2018-05-04 10:33] meleu:</code> added a title to make it look better after mkdocs conversion</li> </ul>"},{"location":"FAQ-pl/","title":"FAQ pl","text":""},{"location":"FAQ-pl/#czym-jest-retroachievementsorg","title":"Czym jest RetroAchievements.org","text":"<p>RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit, kt\u00f3ra wsp\u00f3\u0142pracuje i rywalizuje \u017ceby zyska\u0107 w\u0142asne osi\u0105gni\u0119cia do klasycznych gier poprzez emulacje, osi\u0105gni\u0119cia s\u0105 tworzone przez i dla spo\u0142eczno\u015bci. My dajemy specjalnie przystosowane emulatory dla was, kt\u00f3re wykrywaj\u0105 gdy wykonasz jakie\u015b wyzwanie. Gdy si\u0119 zalogujesz, emulator wy\u015ble osi\u0105gni\u0119cia jakie zdoby\u0142e\u015b na stron\u0119, aby\u015b m\u00f3g\u0142 zobaczy\u0107 i por\u00f3wna\u0107 post\u0119p z przyjaci\u00f3\u0142mi </p> <p>Tutaj jest przyk\u0142ad RAGens, graj\u0105cy w \"Street of Rage 2\", wida\u0107 dwie Tablice Wynik\u00f3w (dolny prawy r\u00f3g), jedno osi\u0105gni\u0119cie wyskakuje, a na ko\u0144cu Nak\u0142adka Osi\u0105gni\u0119\u0107 (Naci\u015bnij <code>Escape</code>):</p> <p></p>"},{"location":"FAQ-pl/#czym-jest-tryb-hardcore","title":"Czym jest tryb HARDCORE?","text":"<p>Tryb HARDCORE jest dodatkow\u0105 funkcj\u0105 \u017ceby oddzieli\u0107 dobrych graczy od \u015bwietnych graczy: Tryb HARDCORE wy\u0142\u0105cza wszystkie funkcje stanu zapisu z emulatora:  Nie b\u0119dziesz m\u00f3g\u0142 zapisywa\u0107 i wczytywa\u0107 kiedy chcesz. B\u0119dziesz musia\u0142 zdoby\u0107 osi\u0105gni\u0119cia za pierwszym razem, tak jak na oryginalnej konsoli. W nagrod\u0119 za to, dostanie standardowe punkty jak i punkty HARDCORE, skutkuj\u0105c w podwojeniu zyskanych punkt\u00f3w! Zwyk\u0142a gra warta 400 punkt\u00f3w, jest teraz warta 800, je\u015bli przejdziesz gr\u0119 ca\u0142kiem w trybie HARDCORE!</p> <p>Notka: Je\u015bli chcesz gra\u0107 w wy\u0142\u0105czonym trybem HARDCORE (znany r\u00f3wnie\u017c jako SOFTCORE), oczekuj \u017ce mo\u017cesz mie\u0107 pewne problemy. Przeczytaj w tym linku czemu nie powiniene\u015b u\u017cywa\u0107 funkcji wczytania stanu.</p>"},{"location":"FAQ-pl/#ktorego-emulatora-musze-uzywac","title":"Kt\u00f3rego emulatora musz\u0119 u\u017cywa\u0107?","text":"<p>Oficjalne emulatory RetroAchievements.org s\u0105 bazowane na Windowsie. Dla innych system\u00f3w operacyjnych mo\u017cesz u\u017cy\u0107 Retroarch'a. Wi\u0119cej informacji poni\u017cej:</p>"},{"location":"FAQ-pl/#oficjalne-emulatory-retroachievementsorg","title":"Oficjalne emulatory RetroAchievements.org","text":"<p>Prosz\u0119 pobierz emulator twojego wyboru z strony pobierania, zalogowa\u0107 si\u0119 u\u017cywaj\u0105c swojego pseudonimu i has\u0142a (tak, musisz pierw stworzy\u0107 konto), potem za\u0142aduj ROM i zacznij gra\u0107!</p> <p>Co to jest Nak\u0142adka Osi\u0105gni\u0119\u0107 i jak w ni\u0105 wej\u015b\u0107?</p> <p>Nak\u0142adka Osi\u0105gni\u0119\u0107 jest wbudowanym ekranem RetroAchievements, kt\u00f3ry pokazuje osi\u0105gni\u0119cia kt\u00f3re mo\u017cesz zyska\u0107 i opisy tego co trzeba zrobi\u0107, kt\u00f3re osi\u0105gni\u0119cia zyska\u0142e\u015b, twoje punkty osi\u0105gni\u0119\u0107, szczeg\u00f3\u0142y o najlepszych wynikaj tablicy wynik\u00f3w i wi\u0119cej.</p> <p>Normalnie, aby w ni\u0105 wej\u015b\u0107, domy\u015blnym przyciskiem jest przycisk <code>Escape</code>, lub u\u017cywaj\u0105c funkcji pauzy. W wi\u0119kszo\u015bci emulator\u00f3w, gra musi by\u0107 aktywna \u017ceby nak\u0142adka dzia\u0142a\u0142a.</p> <p>Niekt\u00f3re emulatory maj\u0105 przycisk ustawiony na kontrolerze \u017ceby zobaczy\u0107 nak\u0142adk\u0119 osi\u0105gni\u0119\u0107. Og\u00f3lnie <code>Escape</code> na klawiaturze powinien j\u0105 w\u0142\u0105czy\u0107, lecz je\u015bli chcesz przywi\u0105za\u0107 przycisk z kontrolera, tutaj jest jak to ustawi\u0107 na paru oficialnych emulatorach:</p> <ul> <li>dla RAVBA wejd\u017a w Options \u21d2 Key Shortcuts \u21d2 Emulation, zaznaczasz Pause, Ustawiasz \"Shortcut key\" i klikasz \"Assign\"</li> <li>dla RASNES wejd\u017a w Input \u21d2 Customize Hotkeys i zmie\u0144 Pause na pierwszej stronie</li> <li>dla RANES, Config \u21d2 Map Hotkeys i zmie\u0144 \"Pause\" na przycisk (Notka: To mo\u017ce wywali\u0107 emulator, zr\u00f3b to bez za\u0142adowanego ROMu dla lepszych szans).</li> </ul>"},{"location":"FAQ-pl/#emulatory-retroarch","title":"Emulatory Retroarch","text":"<p>Dla system\u00f3w nie-Windowsowych musisz u\u017cy\u0107 Retroarcha</p> <p>aktualnie mo\u017cesz zdoby\u0107 osi\u0105gni\u0119cia za pomocy Retroarcha na podanych platformach:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (Tak! Mo\u017cesz zdobywa\u0107 osi\u0105gni\u0119cia przeno\u015bnie na swoim telefonie!)</li> <li>Playstation Vita (musi by\u0107 zhackowany za pomocy HENkaku</li> <li>Playstation 3</li> <li>Wii U</li> <li>Raspberry PI (zalecane systemy: RetroPie, lakka, RecalBox)</li> </ul> <p>Mo\u017cesz zdoby\u0107 RetroArch na podanych linkach:</p> <ul> <li>Stabilny</li> <li>Conocny</li> </ul> <p>Gdy ju\u017c zainstalowa\u0142\u0119\u015b zrobi\u0142e\u015b wst\u0119pn\u0105 konfiguracj\u0119, pod\u0105\u017caj za poradnikiem, aby ustawi\u0107 osi\u0105gni\u0119cia: https://docs.libretro.com/guides/retroachievements/ </p> <p>Jak mog\u0119 zobaczy\u0107 odznaki gdy zdob\u0119d\u0119 osi\u0105gni\u0119cie na RetroArch?</p> <p>Ta funkcja zosta\u0142a dodana do RetroArch 1.7.7 (Maj/2019), lecz s\u0105 platformy na kt\u00f3rych to ci\u0105gle nie dzia\u0142a, musisz si\u0119 upewni\u0107 \u017ce opcja Menu Wid\u017ceta jest w\u0142\u0105czona (i jest zwykle w\u0142\u0105czona domy\u015blnie).</p>"},{"location":"FAQ-pl/#czym-sa-biae-punkty","title":"Czym s\u0105 bia\u0142e punkty?","text":"<p>Bia\u0142e punkty, zwane r\u00f3wnie\u017c jako punkty \"Retro Ratio\", s\u0105 dodatkowymi punktami bazuj\u0105cymi na trudno\u015bci osi\u0105gni\u0119cia, lecz ta funkcja nie jest aktualnie do ko\u0144ca precyzyjna. Wyja\u015bniona jest tu w szczeg\u00f3\u0142ach</p>"},{"location":"FAQ-pl/#moj-email-powitalny-zagina","title":"M\u00f3j email powitalny zagin\u0105\u0142.","text":"<p>Niestety czasami email powitalny mo\u017ce zagin\u0105\u0107. Je\u015bli tak si\u0119 sta\u0142o, to zaloguj si\u0119 na pseudonim/has\u0142o na kt\u00f3rym si\u0119 zarejestrowa\u0142e\u015b, potem wejd\u017a w ustawienia. Na g\u00f3rze znajdziesz opcj\u0119 aby wys\u0142a\u0107 tw\u00f3j email rejestracyjny ponownie.</p>"},{"location":"FAQ-pl/#czemu-nie-widze-nowego-zdjecia-profilowego","title":"Czemu nie widz\u0119 nowego zdj\u0119cia profilowego?","text":"<p>Naci\u015bnij <code>Ctrl + F5</code> (na wi\u0119kszo\u015bci przegl\u0105darek). Czasami po tym jak zmieni\u0142e\u015b zdj\u0119cie profilowe (znane r\u00f3wnie\u017c jako awatar lub zdj\u0119cie u\u017cytkownika) musisz od\u015bwie\u017cy\u0107 pami\u0119\u0107 cache; w wi\u0119kszo\u015bci przegl\u0105darek <code>Ctrl + F5</code> jest najszybsz\u0105 metod\u0105.</p>"},{"location":"FAQ-pl/#gdzie-moge-znalesc-romy","title":"Gdzie mog\u0119 znale\u015b\u0107 ROMy?","text":"<p>Nie tutaj, jest nielegalne hostowanie lub udost\u0119pnianie ROM\u00f3w. Lecz mamy stron\u0119 o Darmowych Grach gdzie mo\u017cesz znale\u017a\u0107 par\u0119 fajny gier homebrew.</p>"},{"location":"FAQ-pl/#czemu-moja-gra-nie-wczytuje-osiagniec","title":"Czemu moja gra nie wczytuje osi\u0105gni\u0119\u0107?","text":"<p>Mo\u017ce by\u0107 to:</p> <ol> <li>Brak osi\u0105gni\u0119\u0107 dla tej gry.</li> <li>Masz z\u0142y rom.</li> </ol> <p>Dobrym nawykiem mo\u017ce by\u0107 sprawdzenie oficjalnego tematu gry na forum. Je\u015bli ci\u0105gle nie masz odpowiedzi sprawd\u017a t\u0105 stron\u0119 po wi\u0119cej szczeg\u00f3\u0142\u00f3w: Moja gra nie \u0142aduje osi\u0105gni\u0119\u0107.</p>"},{"location":"FAQ-pl/#retroarchralibretro-nie-uruchamia-mojej-gry-automatowej-co-powinienem-zrobic","title":"RetroArch/RALibretro nie uruchamia mojej gry automatowej. Co powinienem zrobi\u0107?","text":"<p>Najpierw: Upewnij si\u0119 \u017ce u\u017cywasz odpowiedniego rdzenia RetroArch. Kliknij tutaj aby dowiedzie\u0107 si\u0119 jaki rdze\u0144 obs\u0142uguje funkcje RetroAchievements dla gier automatowych.</p> <p>Potem: ROMy automatowe s\u0105 bardziej skomplikowane ni\u017c ROMy consolowe. Jest pare termin\u00f3w i koncept\u00f3w kt\u00f3re musisz zrozumie\u0107 aby to nabra\u0142o sens. Tutaj jest dobry tekst na ten temat: Obja\u015bnienie ROM\u00f3w MAME.</p> <p>Szybka rada: U\u017cyj swojej ulubionej przegl\u0105darki i znajd\u017a \"zestaw bazuj\u0105cy\" (u\u017cywanie ROM\u00f3w losowo wzi\u0119tych z r\u00f3\u017cnych \u017ar\u00f3de\u0142 polega na metodzie \"pr\u00f3b i b\u0142\u0119d\u00f3w\" i najprawdopodobniej prowadzi do sporej ilo\u015bci frustracji).</p>"},{"location":"FAQ-pl/#czy-retroachievements-bedzie-wspierac-ta-albo-tamta-konsole","title":"Czy RetroAchievements b\u0119dzie wspiera\u0107 t\u0105 albo tamt\u0105 konsol\u0119?","text":"<p>Kr\u00f3tka odpowied\u017a: Tak, b\u0119dzie</p> <p>D\u0142uga odpowied\u017a: Jedyn\u0105 poprawn\u0105 odpowiedzi\u0105 jest \"Kiedykolwiek kto\u015b z umiej\u0119tno\u015bci\u0105 i ch\u0119ci\u0105 kodowania wsparcia to zrobi.\" - Ka\u017cdy tutaj jest ochotnikiem wi\u0119c dodatkowe wsparcie b\u0119dzie si\u0119 dzia\u0142o, kiedy b\u0119dzie si\u0119 dzia\u0142o.</p>"},{"location":"FAQ-pl/#jak-poprosic-o-zestaw-osiagniec","title":"Jak poprosi\u0107 o zestaw osi\u0105gni\u0119\u0107?","text":"<p>Na ka\u017cdej stronie jest link \"Request set\"</p> <p></p> <p>Klikni\u0119cie tego doda twoj\u0105 nazwe do listy os\u00f3b kt\u00f3re prosz\u0105 o zestaw (lub set) osi\u0105gni\u0119\u0107 do tej gry. Klikni\u0119cie ponownie spowoduje usuni\u0119cie pro\u015bby. \u017beby zobaczy\u0107 list\u0119 os\u00f3b prosz\u0105cych o zestaw osi\u0105gni\u0119\u0107 do tej gry, naci\u015bnij link \"Set Requestors for this game\" w sekcji \"More Info\" na dole strony.</p> <p></p> <p></p> <p>Ca\u0142kowita lista pr\u00f3\u015bb jest podliczana i wy\u015bwietlana na stronie Najbardziej proszonych set\u00f3w, kt\u00f3ra mo\u017ce by\u0107 sortowana wed\u0142ug konsoli. Je\u015bli i kiedy set b\u0119dzie stworzony, pro\u015bby powr\u00f3c\u0105 do u\u017cytkownika, aby m\u00f3g\u0142 u\u017cy\u0107 je na innej grze.</p> <p>Liczba pr\u00f3\u015bb jest ustalana wed\u0142ug nast\u0119puj\u0105cej formu\u0142y:</p> <ul> <li>1 za ka\u017cdy rok posiadania konta</li> <li>1 za osi\u0105gni\u0119cie 2500, 5k, 10k, 15k, 20k</li> <li>1 za ka\u017cde 10k w przedziale 20-180k</li> <li>1 za ka\u017cde 20k dalej</li> </ul> <p>Notka: Wszyscy tw\u00f3rcy osi\u0105gni\u0119\u0107 s\u0105 ochotnikami, pro\u015bba o set nie gwarantuje powstanie osi\u0105gni\u0119\u0107 do tej gry. Cel tej funkcji jest pokazanie developerom tego, co gracze chc\u0105 najbardziej. Mo\u017cesz r\u00f3wnie\u017c zastanowi\u0107 si\u0119 nad zasugerowaniem osi\u0105gni\u0119\u0107 na temacie gry na forum, aby u\u0142atwi\u0107 zacz\u0119cie tworzenia nowego seta.</p>"},{"location":"FAQ-pl/#co-robic-gdy-osiagniecia-nie-dziaaja-prawidowo","title":"Co robi\u0107 gdy osi\u0105gni\u0119cia nie dzia\u0142aj\u0105 prawid\u0142owo?","text":"<p>Kiedy pojawi si\u0119 problem z osi\u0105gni\u0119ciami, gdy nie zosta\u0142e\u015b nagrodzony osi\u0105gni\u0119ciem, lub zosta\u0142e\u015b nagrodzony w nieodpowiednim momencie, istnieje rozwi\u0105zanie tego problemu i mo\u017cliwo\u015b\u0107 zostania poprawnie nagrodzonym. Najpierw powiniene\u015b Zg\u0142osi\u0107 popsute osi\u0105gni\u0119cie (Jest to solidny spos\u00f3b aby wnie\u015b\u0107 wk\u0142ad w popraw\u0119 spo\u0142eczno\u015bci!) To stworzy zg\u0142oszenie dla dewelopera osi\u0105gni\u0119\u0107, kt\u00f3ry potem oceni problem i poszuka rozwi\u0105zania.</p> <p>Je\u017celi nie zosta\u0142e\u015b nagrodzony osi\u0105gni\u0119ciem mo\u017cesz zosta\u0107 nagrodzony r\u0119cznie. B\u0119dziesz potrzebowa\u0142 Zg\u0142oszenie zepsutego osi\u0105gni\u0119cia i Dow\u00f3d jego wykonania</p>"},{"location":"FAQ-pt_BR/","title":"FAQ (Perguntas Frequentes)","text":"<p>Link para o texto em ingl\u00eas: FAQ</p>"},{"location":"FAQ-pt_BR/#o-que-e-o-retroachievementsorg","title":"O que \u00e9 o RetroAchievements.org?","text":"<p>RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos cujos membros colaboram para a sua manuten\u00e7\u00e3o e aperfei\u00e7oamento enquanto  competem entre si para ganhar conquistas personalizadas em jogos cl\u00e1ssicos por meio da emula\u00e7\u00e3o. Todas as conquistas s\u00e3o criadas e mantidas pela pr\u00f3pria comunidade e s\u00e3o presenteadas para os usu\u00e1rios atrav\u00e9s de emuladores especialmente customizados e disponibilizados em nossa p\u00e1gina. Uma vez logado em nossos emuladores, os programas ir\u00e3o informar \u00e0 central todas as conquistas que voc\u00ea conquistou para que voc\u00ea possa checar e comparar o seu progresso com o de seus amigos atrav\u00e9s do site.</p> <p>No exemplo a seguir, RAGens (nossa vers\u00e3o personalizada do emulador Gens do Mega Drive) est\u00e1 emulando o jogo Streets of Rage 2. Dois leaderboards especiais podem ser notados no canto inferior direito da tela (eles ir\u00e3o coletar informa\u00e7\u00f5es especiais como a pontua\u00e7\u00e3o, por exemplo). Ao completar uma s\u00e9rie de requisitos, uma conquista \u00e9 desbloqueada pelo jogador que \u00e9 informado sobre o evento atrav\u00e9s de um \"pop-up\" especial. Ao final do exemplo, um menu especial com v\u00e1rias informa\u00e7\u00f5es sobre o jogo (que pode ser ativado ao pressionar a tecla ESC) aparece na tela.</p> <p></p>"},{"location":"FAQ-pt_BR/#o-que-e-o-modo-hardcore","title":"O que \u00e9 o modo HARDCORE?","text":"<p>O modo HARDCORE \u00e9 um recurso adicional que separa os bons jogadores dos grandes jogadores! Ao habilitar esse modo, voc\u00ea ficar\u00e1 impossibilitado de carregar um arquivo de \"savestate\" previamente salvo, ou seja: o jogo n\u00e3o mais poder\u00e1 ser salvo e carregado a qualquer momento. Ao habilitar o modo HARDCORE, voc\u00ea dever\u00e1 completar o jogo assim como ele foi projetado em seu console original e ganhar as suas conquistas sem a ajuda de recursos extras. Como recompensa, toda vez que habilitar uma conquista nesse modo, duas vers\u00f5es da mesma conquista ser\u00e3o presenteadas: a sua vers\u00e3o normal (ou SOFTCORE) e a sua vers\u00e3o HARDCORE, cada uma delas somando a mesma quantidade de pontos ao seu placar totalizando o dobro de pontos que iriam ser ganhos com o modo HARDCORE desabilitado. Um jogo com um total de 400 pontos poder\u00e1 lhe conferir 800 pontos caso voc\u00ea ganhe todas as conquistas dispon\u00edveis no modo HARCORE!</p> <p>Nota: Ao jogar no modo \"SOFTCORE\" e usar as op\u00e7\u00f5es de \"savestate\" para salvar e carregar o seu jogo a qualquer momento, comportamentos inesperados por parte das conquistas poder\u00e3o ser observados. Para mais informa\u00e7\u00f5es, leia o informe em: Why you shouldn't use the load state feature</p>"},{"location":"FAQ-pt_BR/#qual-emulador-eu-preciso-usar","title":"Qual emulador eu preciso usar?","text":"<p>Os emuladores oficiais do RetroAchiements.org s\u00e3o todos baseados em Windows. Para outros sistemas operacionais, voc\u00ea pode usar o RetroArch. Mais informa\u00e7\u00f5es abaixo:</p>"},{"location":"FAQ-pt_BR/#emuladores-oficiais-do-retroachievementsorg","title":"Emuladores oficiais do RetroAchievements.org","text":"<p>Por favor, fa\u00e7a o download do emulador da sua escolha na pagina de download, fa\u00e7a login usando o seu username e senha, ent\u00e3o carregue uma ROM e jogue! Veja o v\u00eddeo a seguir para uma demonstra\u00e7\u00e3o:</p> <p>https://www.youtube.com/watch?v=rKY2mZjurJw</p>"},{"location":"FAQ-pt_BR/#como-eu-acesso-o-overlay-de-conquista","title":"Como eu acesso o Overlay de conquista?","text":"<p>Normalmente, isso \u00e9 configurado na tecla do seu teclado'ESC', ou na fun\u00e7\u00e3o de pause no jogo. Na maioria dos emuladores, um jogo deve ser ativo para isso ser funcional.</p> <p>Alguns dos emuladores j\u00e1 devem ser configurados atribuindo um bot\u00e3o do controle para ver o overlay de conquistas. Geralmente ESC no teclado deve ativ\u00e1-lo, mas se voc\u00ea quer associar isto para um controle, veja este link.</p>"},{"location":"FAQ-pt_BR/#emuladores-retroarch","title":"Emuladores Retroarch","text":"<p>Para sistemas operacionais \"N\u00e3o-Windows\" voc\u00ea deve usar o RetroArch.</p> <p>Atualmente voc\u00ea pode ganhar conquistas via RetroArch nessas seguintes plataformas:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (Sim! Voc\u00ea pode ganhar conquista onde quiser com o seu telefone Android!)</li> <li>PlayStation Vita (precisa ser desbloqueado com o HENkaku)</li> <li>PlayStation 3</li> <li>Wii U</li> <li>Raspberry Pi (Sistemas recomendados: RetroPie, lakka e RecalBox</li> </ul> <p>Voc\u00ea pode conseguir o RetroArch aqui.</p> <p>Uma vez voce instalado e feito a configura\u00e7\u00e3o inicial, seguindo este guia para configurar as Conquistas: https://libretro.readthedocs.io/en/latest/guides/retroachievements/</p> <p>Mantenha em mente que nem todos os cores do RetroArch \u00e9 compativel com o RetroAchievements. Confira esta lista para ver qual escolher.</p> <p><code>Nota do tradutor: Cores s\u00e3o arquivos que permitem que o RetroArch seja capaz de interpretar emuladores e posteriormente, ROMs.</code></p>"},{"location":"FAQ-pt_BR/#como-eu-posso-ver-o-icone-da-conquista-quando-eu-ganho-uma-conquista-no-retroarch","title":"Como eu posso ver o \u00edcone da conquista quando eu ganho uma conquista no RetroArch?","text":"<p>O RetroArch n\u00e3o tem suporte para esse recurso. Quando voc\u00ea ganha uma conquista, voc\u00ea apenas v\u00ea um texto com o t\u00edtulo da conquista e ent\u00e3o a descri\u00e7\u00e3o. Aqui est\u00e1 um t\u00f3pico sobre isso no rastrador de quest\u00f5es do RetroArch, mas isso n\u00e3o parece ser uma prioridade para qualquer desenvolvedor ativo. Voc\u00ea \u00e9 um programador em C e quer tentar? Qualquer contribui\u00e7\u00e3o \u00e9 muito bem vinda!</p>"},{"location":"FAQ-pt_BR/#meu-email-de-boas-vindas-sumiu","title":"Meu email de boas-vindas sumiu!","text":"<p>Infelizmente algumas vezes o email de boas-vindas \u00e9 conhecido por sumir. Se isso acontecer, por favor, fa\u00e7a login com o seu username e senha que voc\u00ea registrou, ent\u00e3o visite sua p\u00e1gina de configura\u00e7\u00f5es. No topo voce ir\u00e1 encontrar uma op\u00e7\u00e3o para reenviar o seu email de registra\u00e7\u00e3o.</p>"},{"location":"FAQ-pt_BR/#onde-eu-posso-encontrar-roms","title":"Onde eu posso encontrar ROMs","text":"<p>Aqui n\u00e3o. Infelizmente \u00e9 ilegal hospedar ou distribuir ROMs com copyright. Para extrair o arquivo de ROM do seus cartuchos, voc\u00ea pode usar uma ferramenta como o Retrode ou algo similar, ent\u00e3o voc\u00ea pode usar o arquivo de ROM nos nossos emuladores. Outros sites hospedam arquivos ROM que voc\u00ea poderia usar com nossos emuladores, mas n\u00e3o aceitamos baixar ou jogar ROMs para jogos que voc\u00ea n\u00e3o possui.</p>"},{"location":"FAQ-pt_BR/#porque-o-meu-jogo-nao-esta-carregando-as-conquistas","title":"Porque o meu jogo n\u00e3o est\u00e1 carregando as conquistas?","text":"<p>Motivos:</p> <ol> <li>N\u00e3o possui conquistas,</li> <li>Voc\u00ea possui a ROM incorreta.</li> </ol> <p>Para mais detalhes leia esta p\u00e1gina: Meu jogo n\u00e3o est\u00e1 carregando conquistas.</p> <p>Se voc\u00ea \u00e9 um usu\u00e1rio Linux, voc\u00ea pode usar essa ferramenta para checar se sua ROM est\u00e1 OK para o RetroAchievements: https://github.com/meleu/hascheevos</p>"},{"location":"FAQ-pt_BR/#esta-conquista-nao-ativou-ou-ativou-em-um-momento-errado","title":"Esta conquista n\u00e3o ativou! (ou ativou em um momento errado)","text":"<p>Esta \u00e9 uma fun\u00e7\u00e3o contruida para apenas emuladores oficiais (n\u00e3o no RetroArch) que permique que voc\u00ea reporte conquistas quebradas que ocorram no momento errado, ou nem ativar. V\u00e1 em RetroAchievements -&gt; Report Broken Achievements.</p> <p>Veja este exemplo:</p> <p>.</p> <p>Al\u00e9m disso, aqui est\u00e1 um video detalhado explicando como usar isto: https://www.youtube.com/watch?v=TTHbm700Y-Y <code>V\u00eddeo em ingl\u00eas</code></p> <p>Adicionando detalhes do seu estado do jogo quando ativou/n\u00e3o ativou, qual o modo de jogo, onde voc\u00ea estava quando aconteceu/n\u00e3o aconteceu, se voc\u00ea teve que resetar o jogo recentemente, tudo que voc\u00ea acha que pode ser relevante para a conquista. Isto \u00e9 necess\u00e1rio para o nosso sistema, ent\u00e3o os desenvolvedores sabem onde est\u00e1 o problema.</p> <p>Se voc\u00ea tiver evid\u00eancias de conclus\u00e3o, voc\u00ea pode tambem contatar um administrador e a conquista pode ser premiada manualmente para voc\u00ea. Fa\u00e7a provas e poste em <code>#help-me</code> no Discord com a tag @admin. ou envie um PM (Mensagem Pessoal) para um usu\u00e1rio com o nivel de administrador.</p> <p>Provas Qualificadas Capturas de Tela que mostra que est\u00e1 jogando no hardcore e que completou a conquista. Tal como v\u00eddeo (melhor ainda). Exemplos de conquistas que voc\u00ea ganhou que substituem esta conquista, ex. Voc\u00ea conseguiu a conquista por 10 mil pontos mas de 5 mil pontos n\u00e3o ativou.</p> <p>Aqui est\u00e1 um exemplo perfeito de prova fornecido pelo gr1nya.</p>"},{"location":"FAQ-pt_BR/#eu-quero-fazer-conquistas","title":"Eu quero fazer conquistas!","text":"<p>Que bom!! O melhor lugar para se iniciar \u00e9 aqui Come\u00e7ando como um desenvolvedor de conquistas. Uma vez que voc\u00ea se familiarizar com o Memory Inspector e outros di\u00e1logos relacionados a conquistas, voc\u00ea pode ir em outros Documentos para Desenvolvedores</p> <p>Por favor, n\u00e3o hesite em perguntar se voc\u00ea precisa de ajuda, n\u00e3o debata-se! A coisa mais importante \u00e9 ter certeza que est\u00e1 aproveitando qualquer coisa que voc\u00ea esteja fazendo, Se voc\u00ea n\u00e3o est\u00e1 se divertindo, n\u00e3o fa\u00e7a. Mas se voc\u00ea estiver frustrado e quer persistir, apenas mande uma mensagem nos foruns ou no Servidor do Discord e alguem ir\u00e1 lhe responder rapidamente.</p>"},{"location":"FAQ-pt_BR/#o-que-sao-os-pontos-brancos","title":"O que s\u00e3o os Pontos Brancos?","text":"<p>Pontos brancos s\u00e3o secund\u00e1rios baseados em qu\u00e3o dificil uma conquista \u00e9. Explicado Aqui em detalhes.</p>"},{"location":"FAQ-pt_BR/#o-que-e-considerado-trapaca-para-o-hardcore-e-se-eu-encontrar-evidencas-de-um-trapaceiro","title":"O que \u00e9 considerado trapa\u00e7a (para o hardcore)? E se eu encontrar evid\u00eancas de um trapaceiro?","text":"<p>A explora\u00e7\u00e3o de set de conquistas e a altera\u00e7\u00e3o ou modifica\u00e7\u00e3o deliberada de jogos, emuladores, mem\u00f3ria, velocidade (fast-forward \u00e9 permitido) ou set. Carregar saves para obter conquistas sem ganh\u00e1-los durante o jogo normal.</p> <p>Todas as trapa\u00e7as dos jogos n\u00e3o s\u00e3o permitidas a menos que seja especificado na descri\u00e7\u00e3o da conquista ou coment\u00e1rios na p\u00e1gina da conquista.</p> <p>Nos vivemos por um c\u00f3digo de honra acima de tudo. Se voc\u00ea encontar evid\u00eancias de um trapaceiro, envie a evid\u00eancia para o RAdmin ou para o email RAmodmail@gmail.com.</p>"},{"location":"FAQ-pt_BR/#e-se-eu-conseguir-uma-conquista-que-eu-nao-ganhei","title":"E se eu conseguir uma conquista que eu n\u00e3o ganhei?","text":"<p>Mesmo que voc\u00ea n\u00e3o consiga, na maioria dos casos, voc\u00ea deve criar um ticket report (veja abaixo), deixando uma explica\u00e7\u00e3o do que foi errado. Voc\u00ea pode tambem remover essas conquistas de sua conta para voc\u00ea ter a satisfa\u00e7\u00e3o de ganhar realmente ganhar elas.</p> <p> Resetando conquistas n\u00e3o ganhas</p>"},{"location":"FAQ-pt_BR/#como-eu-redefino-minha-senha-se-eu-nao-lembrar-minha-senha","title":"Como eu redefino minha senha? (Se eu n\u00e3o lembrar minha senha)","text":"<p>Aqui: https://retroachievements.org/resetPassword.php</p> <p>No site, na pagina frontal, enquanto n\u00e3o estiver logado </p>"},{"location":"FAQ-pt_BR/#porque-meu-jogo-nao-esta-carregando-as-conquistas","title":"Porque meu jogo n\u00e3o est\u00e1 carregando as conquistas?","text":"<p>Veja: Porque meu jogo nao est\u00e1 carregando as conquistas</p>"},{"location":"FAQ-pt_BR/#retroachievements-tem-alguma-finalidade-lucrativa","title":"RetroAchievements tem alguma finalidade lucrativa?","text":"<p>N\u00e3o. RetroAchievments \u00e9 uma comunidade de f\u00e3s devotados que dedicam tributos aos seus jogos favoritos criando conquistas e competindo entre si. Embora aceitemos doa\u00e7\u00f5es atrav\u00e9s do Patreon, todo o dinheiro arrecadado \u00e9 destinado \u00e0 manuten\u00e7\u00e3o do servidor e \u00e0s despesas originadas pelo nosso site que se mant\u00e9m inteiramente livre de propagandas. Todos os programadores e desenvolvedores dedicam o seu tempo \u00e0 melhora da comunidade sem nenhum retorno financeiro.</p>"},{"location":"FAQ-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-04-21 03:38] luchaos:</code> update libretro docs links</li> <li><code>[2019-03-24 23:58] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 23:42] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 23:41] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 22:06] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:50] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:49] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:48] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-02-10 16:05] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:17] CoolCanuck:</code> https</li> </ul>"},{"location":"FAQ/","title":"FAQ","text":"<p>Frequently asked questions regarding the RetroAchievements website and RetroAchievements in general: - What is HARDCORE mode? - What are the white points? - Will RetroAchievements support this or that console? - How are game entries added to the site? - How do I request an achievement set? - How do I make achievements? - How can I contribute?   - Testing   - Creating Tickets     - Saves and Save States</p> <p>Frequently asked questions regarding the emulators, earning achievements, etc.: - Where can I find ROMs? - Why do I get a message that some achievements are unsupported? - What do I do when the achievement isn't working right?   - Manual Unlocks - Why are achievements not loading? - Which emulators and/or cores should I use?</p> <p>Frequently asked questions regarding user accounts. - Why can't I see my new profile picture? - My welcome email has gone missing! - How do I reset my password? (If I don't remember my password) - Will I have any privilege if I become a patron? - How do I delete my account?</p>"},{"location":"FAQ/#retroachievements-faq","title":"RetroAchievements FAQ","text":""},{"location":"FAQ/#what-is-hardcore-mode","title":"What is HARDCORE mode?","text":"<p>If you want to have a one-to-one replication of how you used to play retro games in the distant past, then HARDCORE mode is what you are looking for. This feature restricts the player from ever loading save states (creating them is allowed for practice/ticket purposes when not playing on HARDCORE), using cheats, and any speed-altering features like rewinding, slow-motion, and advancing the game one frame at a time by using the emulator's built-in functions. Note that the only exception to altering speed is fast-forward which IS allowed. Basically, you are playing the game without the game-altering enhancements emulators come with.</p> <p>While you will still be able to get achievements in Softcore, playing on HARDCORE mode is the only way to earn a Mastery for a game, displaying your skill- and prowess to your fellow retro achievers and competitors by showing up on the game's page as a master of the game, as well as on the main leaderboard. Playing on HARDCORE will also allow you to set times, scores or participate in miscellaneous challenges on game-specific leaderboards.</p> <p>Note: If you want to play with the HARDCORE mode disabled (also known as \"Softcore\"), expect to have some issues. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"FAQ/#what-are-the-white-points","title":"What are the white points?","text":"<p>White points, known as Retro Ratio points, are secondary points based on how hard an achievement is, however this feature is not very accurate currently. Explained here in detail.</p>"},{"location":"FAQ/#will-retroachievements-support-this-or-that-console","title":"Will RetroAchievements support this or that console?","text":"<p>Short answer: Yes, it will.</p> <p>Long answer: The only correct answer to this question is \"Whenever someone with the skills and desire to code support, does just that.\" - Everyone here is a volunteer so additional support and features happen when they happen. In many cases support for a console is dictated by the emulator(core) developer and is outside of Retroachievement's control.</p> <p>For more information on specific consoles you can check here: System X When?</p>"},{"location":"FAQ/#how-do-i-request-an-achievement-set","title":"How do I request an achievement set?","text":"<p>On each game's page there is a link to \"Request Set\".  </p> <p></p> <p>Clicking this will add your name to the list of users who have requested a set for the game. Clicking again will withdraw the request. To see other users who have requested the set, click on the \"Set Requestors\" link below the game's box art.</p> <p></p> <p></p> <p>The total number of requests are tallied and displayed on the Most Requested Sets page which can also be sorted by console.  If and when a set is created the user request will be automatically returned to use for another game.</p> <p>The number of requests available to a user is determined as follows:</p> <ul> <li>1 for every year you've had your account</li> <li>1 for every event badge you have earned</li> <li>1 for reaching 1250, 2500, 5k, 7500, 10k</li> <li>1 for every 5k from 10k-100k</li> <li>1 for every 10k thereafter</li> <li>*Softcore points will count requests up to 10k points for a total of 5</li> </ul> <p>Note: All achievement developers are volunteers, requesting a set gives no guarantee that achievements will be made.  The purpose of the request feature is to give developers visibility to what players want most.  You might also consider making achievement suggestions on a game's forum page to help get a set off the ground.</p>"},{"location":"FAQ/#emulation-faq","title":"Emulation FAQ","text":""},{"location":"FAQ/#where-can-i-find-roms","title":"Where can I find ROMs?","text":"<p>Not here. It is illegal to host or distribute copyrighted ROMs. However we have a page about Free Games where you can find some really cool homebrews.</p>"},{"location":"FAQ/#why-do-i-get-a-message-that-some-achievements-are-unsupported","title":"Why do I get a message that some achievements are unsupported?","text":"<p>This message informs the user that some achievements cannot be activated either because their version of RetroArch and/or the core being used does not support some newer logic features, or because required areas of the RAM are not exposed for achievement processing.</p> <p>In most cases updating to the latest version of RetroArch will correct the problem, alternately updating or using a different supported core will resolve the problem. </p>"},{"location":"FAQ/#what-do-i-do-when-the-achievement-isnt-working-right","title":"What do I do when the achievement isn't working right?","text":"<p>When problems with achievements occur, either where the achievement wasn't awarded to you or it was awarded at the wrong time, there are solutions to get the problems fixed and for proper credit to be given to you! First you'll want to report the broken achievement. (This is an excellent way to contribute to the betterment of the community!) It creates a ticket report for the achievement developers who will then review the problem and look for a solution.</p> <p>If the achievement wasn't awarded, you can request a manual-unlock. You'll need to report the broken achievement and provide proof of completion.</p>"},{"location":"FAQ/#how-do-i-report-a-broken-achievement","title":"How do I report a broken achievement?","text":"<p>There are two ways to report broken achievements. In the emulator title bar go to RetroAchievements \u21d2 Report Broken Achievements:</p> <ol> <li>For Official RetroAchevement emulators only:</li> </ol> <p>.</p> <ol> <li>For RetroArch users you can submit the report directly via website. On every achievement's page you'll see a link saying <code>Report an issue for this achievement</code>, like in the image below:</li> </ol> <p></p> <p>If you use the Official RetroAchevement emulators you can also report problems from the website achievement page, but it is preferred that you use the method built into the emulators. </p>"},{"location":"FAQ/#what-details-i-have-to-add-to-a-broken-achievement-report","title":"What details I have to add to a broken achievement report?","text":"<p>You have to add those information in order for a developer to recognize an issue:</p> <ul> <li>Type of issue (doesn't trigger or triggers at the wrong time)</li> <li>Emulator you were using (and core if using RALib/Retroarch)</li> <li>RA hash (checksum) to recognize a version of the game</li> </ul>"},{"location":"FAQ/#what-details-should-i-add-to-a-broken-achievement-report","title":"What details should I add to a broken achievement report?","text":"<p>If possible, in the broken achievement report Comment paste a link to a screenshot or video (even better) of where the problem occurred. It's recommended to post screenshots on imgur and videos on YouTube.</p> <p>Also add details like:</p> <ul> <li>when it was/wasn't awarded;</li> <li>what game mode (HARDCORE/softcore);</li> <li>what difficulty level or other settings you've selected;</li> <li>how long you were playing;</li> <li>when you most recently died or continued;</li> <li>what you think the problem might be or any details you think could be helpful.</li> </ul> <p>This is necessary so the achievement developers know where the problem is.</p>"},{"location":"FAQ/#what-is-an-ra-hash","title":"What is an RA hash?","text":"<p>RA hash is an unique string of 32 hexadecimal numbers, to distinguish different games and versions of them, all of them have one. </p>"},{"location":"FAQ/#how-do-i-check-the-ra-hash-of-the-game-im-playing","title":"How do I check the RA hash of the game I'm playing?","text":"<ul> <li>For Retroarch - Quick Menu \u21d2 Information, then at the bottom there is \"RetroAchievements Hash\" which is, in fact an RA hash</li> <li>For Standalones/RaLibretro - RetroAchievement tab at the top \u21d2 Get ROM Checksum, and it shows the RA hash</li> </ul>"},{"location":"FAQ/#in-short-how-to-request-a-manual-unlock","title":"In short how to request a manual unlock","text":"<ul> <li>If you use Discord Post in the #manual-unlock channel a request that looks similar to one of these:  <p>@manual-unlock http://retroachievements.org/ticketmanager.php?i=9577 HARDCORE Proof: https://youtu.be/uqD-GTkZbLo</p> <p>@manual-unlock http://retroachievements.org/ticketmanager.php?i=16705 softcore Proof: https://i.imgur.com/83bJE43.png</p> </li> </ul> <ul> <li>If you don't use Discord  While signed into RetroAchievments.org send a private message to the RAdmin user with the title: Manual Unlock Request and a description that looks similar to this:<p>Hi. I'm requesting a manual unlock. http://retroachievements.org/ticketmanager.php?i=9577 HARDCORE Proof: https://youtu.be/uqD-GTkZbLo</p> </li> </ul>"},{"location":"FAQ/#in-detail-how-to-request-a-manual-unlock","title":"In detail how to request a manual unlock","text":"<ol> <li>Open a ticket describing with details the problem you had with the achievement. (How do I report a broken achievement?)     1. If the achievement wasn't registered on the site due to a network problem, you don't need to open a ticket.</li> <li>Get a proof/evidence that you completed the achievement. Acceptable proofs:     1. Screenshots that show that one is playing in HARDCORE and have completed the achievement.     2. Video of such (even better) (perfect example of ideal proof provided by gr1nya).     3. Examples of achievements you've earned that prove you've earned this achievement. Example: You got the achievement for 10k points but the one for 5k points wasn't awarded to you.</li> <li>If you're on our discord server, send a message on the <code>#manual-unlock</code> channel tagging the @manual-unlock role; if you're not on Discord, send a private message message to the RAdmin user. Your message must have:     1. The link to the ticket url. You can find the ticket here: http://retroachievements.org/ticketmanager.php     2. What mode you were playing (HARDCORE/softcore)     3. Link to your qualified proof of completion. Include proof that the achievement was earned in HARDCORE, if you were playing in HARDCORE.</li> </ol> <p>Note: Manual unlocks are intended for players with proof of earning achievements that did not trigger on site due to a bug or network issue.</p> <p>They are not indented for, and will not be awarded to players who have played the game prior to a set being available, or on an another inherently unsupported platform (original hardware for example).</p>"},{"location":"FAQ/#what-if-i-got-an-achievement-i-didnt-earn","title":"What if I got an achievement I didn't earn?","text":"<p>Same with not getting it when you should in most cases you'll want to create a ticket report, leaving an explanation of what went wrong. You'll also want to reset these achievements from your earn history so you can get the satisfaction of truly earning them.</p>"},{"location":"FAQ/#how-do-i-reset-achievements","title":"How do I reset achievements?","text":"<p>There are three ways to do this:</p> <ul> <li>On the achievement page: </li> </ul> <ul> <li>On the game page (when you want or need to reset all earns in a game): </li> </ul> <ul> <li>Near the bottom of your user settings page: </li> </ul>"},{"location":"FAQ/#am-i-the-only-one-with-an-issue","title":"Am I the only one with an issue?","text":"<p>If an achievement doesn't work correctly for you, there is a very good chance it doesn't work for other people. You can check in the achievement's page and look for where it says 'The achievement has 'X' open tickets':</p> <p></p> <p>If the game has tickets, click on the 'open tickets' link. There will be a list to show any reports of broken achievements. You can comment on these to add helpful details or say you have a problem with this achievement too.</p>"},{"location":"FAQ/#account-faq","title":"Account FAQ","text":""},{"location":"FAQ/#why-cant-i-see-my-new-profile-picture","title":"Why can't I see my new profile picture?","text":"<p>Press <code>Ctrl + F5</code> (on most browsers). Sometimes after you've changed your profile picture (also known as avatar or user pic) and you need to refresh your browser cache; in most browsers <code>Ctrl + F5</code> is the quickest way to do it.</p>"},{"location":"FAQ/#my-welcome-email-has-gone-missing","title":"My welcome email has gone missing!","text":"<p>Unfortunately sometimes the welcome email has been known to go missing. If this happens, please log in with your username/password you registered with, then visit your settings page. At the top you'll find the option to resend your registration email.</p>"},{"location":"FAQ/#how-do-i-reset-my-password-if-i-dont-remember-my-password","title":"How do I reset my password? (If I don't remember my password)","text":"<p>Right Here: https://retroachievements.org/resetPassword.php</p> <p>On Site, front page, while not logged in:</p> <p></p>"},{"location":"FAQ/#will-i-have-any-privilege-if-i-become-a-patron","title":"Will I have any privilege if I become a patron?","text":"<p>On the website you'll have a badge to mean \"I helped fund RA!\". On the discord server you'll have access to a dedicated channel. Although we are all immensely grateful for the contributions of the patrons, there is no other bonus besides those ones.</p> <p>Thanks to the Patreon contributions the RetroAchievements project can pay for a decent server to run the website, run the discord bot and also have periodic backups (to recover data in the event of a disaster), and all this with an ad-free experience. The whole community owe a big thank you to the patrons.</p>"},{"location":"FAQ/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-08-03 15:50] Nepiki:</code> Added that players can get a set request from every event badge</li> <li><code>[2023-06-30 12:53] televandalist:</code> Updated FAQ (markdown)</li> <li><code>[2023-06-05 22:04] televandalist:</code> Added a few placeholder questions</li> <li><code>[2023-04-20 05:39] televandalist:</code> Separated into categories (Account, Emulation, and RetroAchievements)</li> <li><code>[2023-04-20 05:30] televandalist:</code> Updated the set request images since they were out-of-date and gigantic.</li> <li><code>[2023-04-20 05:21] televandalist:</code> Got rid of out-of-date info and sections that have their own dedicated pages.</li> <li><code>[2023-04-19 23:43] televandalist:</code> Removed part about getting errors from using words like \"drop\" and \"select\" - it's no longer relevant.  Removed part asking if RA profits off of emulation. It's covered in the RA Manifesto.</li> <li><code>[2023-01-11 22:48] pingus:</code> Change outdated cores list link from libretro to RADocs.</li> <li><code>[2022-09-09 12:37] Nepiki:</code> Updated Hardcore paragraph regarding leaderboards to account for scores/miscellaneous challenges</li> <li><code>[2022-09-08 16:30] Nepiki:</code> Changed the marketing for Hardcore mode.</li> </ul>"},{"location":"Free-Games/","title":"Free Games","text":"<p>In this page you can find games that are completely and legally free download and play on your emulators. Many of them have an achievement set at RetroAchievements.org.</p>"},{"location":"Free-Games/#atari-2600","title":"Atari 2600","text":"<p>AtariAge has plenty of Atari homebrew on their website that you can either purchase physical cartridges of or (most of the time) download from their forums for free with a quick google search.</p> <p>Some examples of AtariAge Atari 2600 homebrew:</p> <ul> <li>Amoeba Jump - by Dionoid</li> <li>AVGN K.O. Boxing - by Devin Cook</li> <li>Flappy - by Michael Haas</li> <li>Go Fish! - by Bob Montgomery</li> <li>Halo 2600 - by Ed Fries</li> <li>INV+ - by Erik Mooney, Piero Cavina</li> <li>Oystron - by Piero Cavina</li> <li>Pac-Man 4K - by Dennis Debro</li> <li>Princess Rescue - by Chris Spry (Due to complications with Nintendo, you can no longer purchase physical copies of this one)</li> <li>Sheep It Up! - by Dr. Ludos</li> <li>Snake-2600 - by Wickeycolombus</li> <li>Tetris26 - by Colin Hughes</li> <li>Video Simon - by Mark De Smet</li> <li>Wall Jump Ninja - by Walaber</li> <li>Zippy the Porcupine - by Chris Spry</li> </ul>"},{"location":"Free-Games/#game-boy","title":"Game Boy","text":"<ul> <li>Dangan GB - by snorpung</li> <li>Deadeus - by -IZMA-</li> <li>Deep Forest - by Kevin Trepanier</li> <li>Dino's Offline Adventure - by gaming monster</li> <li>DMG Deals Damage - by Dr. Ludos</li> <li>Flappy Boy - by zurashu</li> <li>Petite Professional GB - by ocarson</li> <li>Pretty Princess' Castle Escape - by sergeeo</li> <li>Popcorn Caravan - by cabbage</li> <li>Snake - by Donald Hays</li> <li>The Binding of Isaac: Game Boy Edition - by Joshua Robertson</li> <li>Tobu Tobu Girl - by TangramGames</li> <li>Waifu Clicker - by Refresh Games</li> </ul>"},{"location":"Free-Games/#game-boy-color","title":"Game Boy Color","text":"<ul> <li>Hong Kong 2099 - by Bl4h8L4hBl4h</li> <li>Tobu Tobu Girl Deluxe - by TangramGames</li> <li>Warp Coin Catastrophe - by Proximity Sound</li> </ul>"},{"location":"Free-Games/#game-boy-advance","title":"Game Boy Advance","text":"<ul> <li>Celeste Classic - by Maddy Thorson and Noel Berry</li> <li>Pocket Meat - by BomberDev</li> <li>Snakes - by BadMrFrostyXXX</li> </ul>"},{"location":"Free-Games/#nintendo-ds","title":"Nintendo DS","text":"<ul> <li>Anguna DS - by Nathan Tolbert</li> <li>Bubble Wrap DS - by Prodigy Games</li> <li>Crocodingus in Cube Island - by PXLteam</li> <li>EunHye DS - by beadeulpiri</li> <li>Slide Puzzles - by Neumann(Puzzle), roronoa(Migraine), Dustin(15-16)</li> <li>Ultimate Sliding Puzzle - by Kukulcan, LOBO (Warning! some of the puzzles are NSFW!)</li> </ul>"},{"location":"Free-Games/#mega-drivegenesis","title":"Mega Drive/Genesis","text":"<ul> <li>30 Years of Nintendon't by Dr. Ludos</li> <li>Cave Story MD by andwn</li> <li>Double Cooked - by Zhamul, mipelius, Miranda</li> <li>L'ABBAYE DES MORTS - by </li> <li>Mega Flappy Sis - by Lennart</li> <li>Mighty Mighty Missile - by Locomalito(https://www.locomalito.com/)</li> <li>Pringles Game - by MtChocolate</li> <li>Uwol - Quest For Money - by Shiru</li> <li>ZOOMING SECRETARY: GOING PANIC - by Playonretro</li> </ul>"},{"location":"Free-Games/#nes","title":"NES","text":"<ul> <li>2048 - by tsone</li> <li>Alter Ego - by Shiru</li> <li>Blade Buster - by High Level Challenge</li> <li>B\u00f6bl - by Morphcat Games</li> <li>Bootee - by [Mojo Twins](https://www.mojontwins.com/</li> <li>Cookie Clicker - by Damian Yerrick</li> <li>D-Pad Hero - by Kent Hansen, Andreas Pedersen</li> <li>D-Pad Hero 2 - by Kent Hansen, Andreas Pedersen</li> <li>Filthy Kitchen - by dustmop</li> <li>Function</li> <li>Gotta Protectors - Amazon's Running Diet - by Ancient Corp</li> <li>Gruniozerca - by emunes.pl</li> <li>Gruniozerca 2</li> <li>Hot Seat Harry - by Memblerz</li> <li>I Wanna Flip the Sky - by TomL</li> <li>Indivisible - by Kasumi</li> <li>Lala The Magical</li> <li>LAN Master - by Shiru</li> <li>Lawn Mower - by Shiru</li> <li>Legends of Owlia, The by Gradual Games</li> <li>Lunar Limit</li> <li>Melo-Jellos 2 - by Adrian Makes Games</li> <li>Miedow - by Mojo Twins</li> <li>MilioNESy</li> <li>Nebs 'n Debs</li> <li>NES Virus Cleaner</li> <li>NeSnake 2</li> <li>Project Blue</li> <li>SplatooD - by SplatooD Team</li> <li>Streemerz - by Mr. Podunkian</li> <li>Sudoku: NESWORLD Edition - by Al Bailey</li> <li>Super Bat Puncher - by Morphcat Games</li> <li>Zooming Secretary - by Shiru</li> </ul>"},{"location":"Free-Games/#snes","title":"SNES","text":"<ul> <li>Christmas Craze - by Shiru</li> <li>Super Boss Gaiden - by superfamicom.org (??)</li> <li>Super Sudoku - by Rapha\u00ebl Ass\u00e9nat</li> <li>Super Road Blaster (MSU-1) - by dforce3000</li> </ul>"},{"location":"Free-Games/#n64","title":"N64","text":"<ul> <li>Pyoro 64 - by n64squid</li> </ul>"},{"location":"Free-Games/#virtual-boy","title":"Virtual Boy","text":"<ul> <li>BLOX by KR155E</li> <li>Fishbone by thunderstruck and Virtual_Ben</li> <li>Mario Kart: Virtual Cup by DogP</li> <li>Tron by Alberto Covarrubias</li> <li>VB Racing by M.K.</li> </ul>"},{"location":"Game-Identification-es/","title":"Identificaci\u00f3n del Juego","text":"<p>Esta pagina detalla los m\u00e9todos de hashing para cada consola soportada en RA:</p>"},{"location":"Game-Identification-es/#nes","title":"NES","text":"<p>Si el ROM empieza con <code>NES\\1a</code>($4E $45 $53 $1A), los primeros 16 bytes son ignorados y lo que queda del archivo es linkeado/hashed. Si el ROM no empieza con <code>NES\\1a</code> ($4E $45 $53 $1A), el archivo entero es linkeado/hashed.</p>"},{"location":"Game-Identification-es/#famicom-disk-system","title":"Famicom Disk System","text":"<p>El archivo entero es linkeado/hashed.</p> <p>NOTA: Como salvar muta la data de los discos, copias locales de las im\u00e1genes cargadas son necesarias para asegurarte que los hashes no cambien entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#snes","title":"SNES","text":"<p>Si el tama\u00f1o del archivo es de 512 bytes mas que un multiplo de 8K, los primeros 512 bytes son ignorados y lo que queda del archivos es linkeado/hashed. Si el tama\u00f1o del archivo no es de 512 bytes mas que un multiplo de 8K, el archivo entero es linkeado/hashed.</p>"},{"location":"Game-Identification-es/#n64","title":"N64","text":"<p>El archivo entero es es agregado al hash. </p> <p>Esto talvez pueda resultar en tres diferentes hashes para cada juego. La extensi\u00f3n z64 es big endian (ABCD). La extensi\u00f3n n64 es little endian (DCBA). Y la extensi\u00f3n v64 es middle endian (BADC).</p>"},{"location":"Game-Identification-es/#gb","title":"GB","text":"<p>El archivo entero es agregado al hash.</p> <p>NOTA: Parece que RAVBA hace 0-pad la informaci\u00f3n si el tama\u00f1o especifico del ROM (address $148) es mas grande que el archivo. Aun tengo que encontrar un caso donde esto ocurra.</p>"},{"location":"Game-Identification-es/#gbc","title":"GBC","text":"<p>El archivo entero es agregado al hash.</p> <p>NOTA: Parece que RAVBA hace 0-pad la informaci\u00f3n si el tama\u00f1o especifico del ROM (address $148) es mas grande que el archivo. Aun tengo que encontrar un caso donde esto ocurra.</p>"},{"location":"Game-Identification-es/#gba","title":"GBA","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#virtualboy","title":"VirtualBoy","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#master-system","title":"Master System","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#megadrive-genesis","title":"MegaDrive (Genesis)","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#sega-32x","title":"Sega 32X","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#sega-cd","title":"Sega CD","text":"<p>Cosas que hacer: Se necesita investigar esto mas a fondo. Este sistema es incluso soportado?</p> <p>Un buffer de 1KB es agregado al hash. Lo primeros 512 bytes del buffer estan en los primeros 512 bytes del track 0. No estoy seguro de lo que se encuentra en los segundos 512 bytes.</p>"},{"location":"Game-Identification-es/#gamegear","title":"GameGear","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-2600","title":"Atari 2600","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-7800","title":"Atari 7800","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-lynx","title":"Atari Lynx","text":"<p>Si el ROM empieza con <code>LYNX\\0</code>, los primeros 64 bytes son ignorados y el contenido restante del archivo es agregado al hash. Si el ROM no empieza con <code>LYNX\\0</code>, el archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#colecovision","title":"ColecoVision","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#neogeo-pocket","title":"NeoGeo Pocket","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#pcengine-turbografx16","title":"PCEngine (TurboGrafx16)","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#pcengine-cd","title":"PCEngine CD","text":"<p>Tareas que hacer: No estoy completamente seguro de ocmo trabaja este. RAPCE linkea/hashes la \"Placa Madre del ROM principal\", pero no puedo lograr que funcione. RALibRetro parece que no linkea nada, y no hay ningun codigo especial en  RetroArch, as\u00ed que por lo que parece esta linkeando/hashing el archivo entero, pero cual archivo pero cual archivo? El zup es un bin/cue con m\u00faltiples archivos.</p>"},{"location":"Game-Identification-es/#fba-arcade","title":"FBA (Arcade)","text":"<p>El string del nombre del archivo sin la extensi\u00f3n es linkeado/hashed (xxx.zip). Detecta min\u00fasculas y may\u00fasculas.</p>"},{"location":"Game-Identification-es/#pc-8001-pc-8801","title":"PC-8001 / PC-8801","text":"<p>Im\u00e1genes de cintas y discos cargadas en el drive 1 (program disk data) son completamente linkeadas/hashed.</p> <p>NOTA: Como salvar y otras manipulaciones pueden mutar la informaci\u00f3n del disco, copias locales del disco son requeridas para asegurar que los hashes no han cambiado entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#apple-ii","title":"Apple II","text":"<p>Im\u00e1genes de Disco (las dos, disquete y disco duro) cargadas en el drive 1 son completamente linkeadas/hashed.</p> <p>NOTA: Como salvar y otras manipulaciones pueden mutar la informaci\u00f3n del disco, copias locales del disco son requeridas para asegurar que los hashes no han cambiado entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-20 10:49] eldexterr:</code> Created Game Identification es (markdown)</li> </ul>"},{"location":"Game-Identification/","title":"Game Identification","text":"<p>This page details the hashing method used for each supported system.</p>"},{"location":"Game-Identification/#the-3do-company","title":"The 3DO Company","text":"<ul> <li>3DO Interactive Multiplayer uses a custom hash.<ul> <li>The volume header (first 132 bytes of sector 0) and the contents of the LaunchMe file are hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#amstrad","title":"Amstrad","text":"<ul> <li>Amstrad CPC uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#apple","title":"Apple","text":"<ul> <li>Apple II uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#arcade","title":"Arcade","text":"<ul> <li>Arcade uses a custom hash.<ul> <li>The filename string without the extension (<code>path/galaga.zip</code> -&gt; <code>galaga</code>) is hashed. It is case-sensitive.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#arduboy-inc","title":"Arduboy Inc.","text":"<ul> <li>Arduboy uses a custom hash.<ul> <li>Arudboy .hex files contain ASCII text. We normalize to Unix line endings, then perform a full file hash.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#atari","title":"Atari","text":"<ul> <li>Atari 2600 uses the MD5 checksum.</li> </ul> <ul> <li>Atari 7800 uses the MD5 checksum unless the ROM has a header.<ul> <li>If the ROM starts with <code>\\1ATARI7800</code>, the first 128 bytes are ignored and the remaining file contents are hashed. If the ROM does not start with <code>\\1ATARI7800</code>, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Atari Jaguar uses the MD5 checksum.</li> </ul> <ul> <li>Atari Jaguar CD uses a custom hash.<ul> <li>A header block is located within the first sector of the disc. This block indicates the location and size of the boot code, which is loaded and hashed.</li> <li>If the resulting hash is <code>254487b59ab21bc005338e85cbf9fd2f</code>, it's a common bootloader for homebrew games and the actual game code is located in track 2. If a separate header block containing a new location and size is found in track 2, then that data is loaded and hashed.</li> </ul> </li> </ul> <ul> <li>Atari Lynx uses the MD5 checksum unless the ROM has a header.<ul> <li>If the ROM starts with <code>LYNX\\0</code>, the first 64 bytes are ignored and the remaining file contents are hashed. If the ROM does not start with <code>LYNX\\0</code>, the entire file is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#bandai","title":"Bandai","text":"<ul> <li>WonderSwan uses the MD5 checksum.</li> </ul> <ul> <li>WonderSwan Color uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#coleco","title":"Coleco","text":"<ul> <li>ColecoVision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#fairchild","title":"Fairchild","text":"<ul> <li>Channel F uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#gce","title":"GCE","text":"<ul> <li>Vectrex uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#magnavox","title":"Magnavox","text":"<ul> <li>Odyssey2 uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#mattell","title":"Mattell","text":"<ul> <li>Intellivision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#microsoft","title":"Microsoft","text":"<ul> <li>MSX / MSX2 uses the MD5 checksums of each disk.<ul> <li>As saving mutates disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions. We do not believe this is working, but have yet to find a game where saving to disk actually works.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#nec","title":"NEC","text":"<ul> <li>PC-8001/PC-8801 uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul> <ul> <li>PC Engine / TurboGrafx 16 / SuperGrafx use the MD5 checksum unless the ROM has a header.<ul> <li>If the size of the file is 512 bytes more than a multiple of 128KB, the first 512 bytes are ignored and the remaining file contents are hashed. If the size of the file is not 512 bytes more than a multiple of 128KB, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>PC Engine CD / TurboGrafx-CD - uses a custom hash. The boot code and disc title are hashed as follows:<ul> <li>Read 128 bytes from sector 1 of the data track (PCE predates ISO-9660, so there's no file system to read).</li> <li>If <code>\"PC Engine CD-ROM SYSTEM\"</code> does not exist at 32 bytes into the data, discard as invalid.</li> <li>Copy the last 22 bytes of the data into a buffer. This is the disc title, and usually identifies the game.</li> <li>The first three bytes of the data are a little-endian sector index for the boot code.</li> <li>The fourth byte is the number of sectors that the boot code occupies.</li> <li>The boot code is appended to the buffer (N sectors, starting at sector X)</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PC-FX uses a custom hash. The boot code and disc title are hashed as follows:<ul> <li>Read 32 bytes from sector 0 of the data track (PC-FX predates ISO-9660, so there's no file system to read).</li> <li>If <code>\"PC-FX:Hu_CD-ROM\"</code> was not read, discard as invalid.</li> <li>Read 128 bytes from sector 1 of the data track into a buffer. This is the volume header and includes the disc title.</li> <li>The 32-bit value at 32-bytes into the buffer is the first sector of the boot code.</li> <li>The 32-bit value at 36-bytes into the buffer is the number of sectors that the boot code occupies.</li> <li>The boot code is appended to the buffer (N sectors, starting at sector X)</li> <li>The buffer is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#nintendo","title":"Nintendo","text":"<ul> <li>Famicom Disk System uses the MD5 checksum unless the file has a header.<ul> <li>If the ROM starts with <code>FDS\\1a</code>, the first 16 bytes are ignored and the remaining file contents are hashed. </li> <li>If the ROM does not start with <code>FDS\\1a</code>, the entire file is hashed. </li> <li>As saving mutates disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul> <ul> <li>Game Boy uses the MD5 checksum.</li> </ul> <ul> <li>Game Boy Advance uses the MD5 checksum.</li> </ul> <ul> <li>Game Boy Color uses the MD5 checksum.</li> </ul> <ul> <li>GameCube uses a custom hash. Initially loaded program code is hashed as follows:<ul> <li>The Apploader is loaded and added to a buffer.</li> <li>Each DOL segment (code and data) referenced in the Apploader is loaded and added to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Nintendo 64 uses the MD5 checksum for Big Endian (<code>.z64</code>) ROMs.<ul> <li>ByteSwapped (<code>.v64</code>) and Little Endian (<code>.n64</code>) use the MD5 checksum for its Big Endian counterpart.</li> </ul> </li> </ul> <ul> <li>Nintendo DS uses a custom hash.<ul> <li>A NDS ROM has a 0x160 byte header. In this header are pointers to icon/title information and to the boot code for both processors. The hash method combines the header, the two pieces of boot code, and the icon/title information and hashes the result.</li> <li>The icon/title information is 0xA00 bytes starting at the address stored in the header at $68</li> <li>The arm9 code address is stored at $20 in the header, and the size is stored at $2C in the header</li> <li>The arm7 code address is stored at $30 in the header, and the size is stored at $3C in the header</li> </ul> </li> </ul> <ul> <li>Nintendo Entertainment System / Famicom uses a custom hash.<ul> <li>If the ROM starts with <code>NES\\1a</code>, the first 16 bytes are ignored and the remaining file contents are hashed.</li> <li>If the ROM does not start with <code>NES\\1a</code>, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Pokemon Mini uses the MD5 checksum.</li> </ul> <ul> <li>Super Nintendo Entertainment System / Super Famicom / Satellaview / Sufami Turbo use the MD5 unless the ROM has a header.<ul> <li>If the size of the file is 512 bytes more than a multiple of 8KB, the first 512 bytes are ignored and the remaining file contents are hashed. </li> <li>If the size of the file is not 512 bytes more than a multiple of 8KB, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Virtual Boy uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#snk","title":"SNK","text":"<ul> <li>Neo Geo CD uses a custom hash. Initially loaded program code is hashed as follows:<ul> <li>The <code>IPL.TXT</code> file is loaded and parsed.</li> <li>Each line of the file is data to load. PRG files are executable code. Each PRG file is loaded and added to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Neo Geo Pocket uses the MD5 checksum.</li> </ul> <ul> <li>Neo Geo Pocket Color uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#sega","title":"Sega","text":"<ul> <li>32X uses the MD5 checksum.</li> </ul> <ul> <li>Dreamcast uses a custom hash. The disc metadata and primary executable are hashed as follows:<ul> <li>The first 512 bytes of sector 0 are appended to the buffer. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGA SEGAKATANA \"</code>. If not, discard as invalid.</li> <li>The contents of the primary executable (as identified by the volume header) are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Game Gear uses the MD5 checksum.</li> </ul> <ul> <li>Master System uses the MD5 checksum.</li> </ul> <ul> <li>Mega Drive / Genesis uses the MD5 checksum.</li> </ul> <ul> <li>SG-1000 uses the MD5 checksum.</li> </ul> <ul> <li>Saturn uses a custom hash.<ul> <li>The first 512 bytes of track 0 are hashed. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGADISCSYSTEM  \"</code> for Sega CD or <code>\"SEGA SEGASATURN \"</code> for Sega Saturn. If not, discard as invalid.</li> <li>Immediately following those 512 bytes are an arbitrary amount of code that validates the region and loads the primary executable. Without processing the code, we cannot determine what additional file(s) to hash, so this was determined to be sufficient as an alternative to hashing the entire CD.</li> </ul> </li> </ul> <ul> <li>Sega CD uses a custom hash.<ul> <li>The first 512 bytes of track 0 are hashed. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGADISCSYSTEM  \"</code> for Sega CD or <code>\"SEGA SEGASATURN \"</code> for Sega Saturn. If not, discard as invalid.</li> <li>Immediately following those 512 bytes are an arbitrary amount of code that validates the region and loads the primary executable. Without processing the code, we cannot determine what additional file(s) to hash, so this was determined to be sufficient as an alternative to hashing the entire CD.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#sony","title":"Sony","text":"<ul> <li>PlayStation uses a custom hash. The primary executable and its name are hashed as follows:<ul> <li>The <code>SYSTEM.CNF</code> file is loaded and parsed. The primary executable is identified by the BOOT= line within.</li> <li>The primary executable name (and its path) are extracted from <code>SYSTEM.CNF</code> and written to a buffer.</li> <li>The contents of the primary executable are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PlayStation 2 uses a custom hash. The primary executable and its name are hashed as follows:<ul> <li>The <code>SYSTEM.CNF</code> file is loaded and parsed. The primary executable is identified by the BOOT2= line within.</li> <li>The primary executable name (and its path) are extracted from <code>SYSTEM.CNF</code> and written to a buffer.</li> <li>The contents of the primary executable are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PlayStation Portable uses a custom hash. The disc metadata and primary executable are hashed as follows:<ul> <li>The contents of the <code>PSP_GAME\\PARAMS.SFO</code> file are written to a buffer. This contains the game attributes displayed in the menu, including the name and serial.</li> <li>The contents of the primary executable (<code>PSP_GAME\\SYSDIR\\EBOOT.BIN</code>) are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#wasm-4","title":"WASM-4","text":"<ul> <li>WASM-4 uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#watara","title":"Watara","text":"<ul> <li>Supervision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#wellback","title":"Wellback","text":"<ul> <li>Mega Duck uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-04 21:00] televandalist:</code> Changed to a new format</li> <li><code>[2023-06-03 02:03] televandalist:</code> Removed the \"Pending Explanation\" section since it only contained Wii, which is a ways away.</li> <li><code>[2023-05-25 11:16] Jamiras:</code> add hash algorithms for Arduboy, GameCube, Jaguar CD and Neo Geo CD</li> <li><code>[2023-04-11 03:01] televandalist:</code> Added Amstrad CPC, Arduboy, Atari Jaguar CD, Fairchild Channel F, Game Cube, Intellivision, Magnavox Odyssey 2, Mega Duck, Neo Geo CD, SG-1000, and Wii. Added \"Pending Explanation\" section. Made some naming corrections and some formatting tweaks.</li> <li><code>[2021-12-16 13:02] Jamiras:</code> add dreamcast</li> <li><code>[2021-10-10 11:20] Jamiras:</code> add psp</li> <li><code>[2021-04-30 13:05] Jamiras:</code> Updated Game Identification (markdown)</li> <li><code>[2020-12-25 00:07] televandalist:</code> Corrected PC Engine CD name and fixed a minor grammatical error. :bomber:</li> <li><code>[2020-06-13 17:45] Jamiras:</code> add PC-FX</li> <li><code>[2020-06-07 11:41] Jamiras:</code> update for new systems</li> </ul>"},{"location":"Game-Page-Improvement-ideas/","title":"Game Page Improvement ideas","text":""},{"location":"Game-Page-Improvement-ideas/#new-data-points-for-each-entry","title":"New data points for each entry","text":"<ol> <li>Provide to regular users (not only devs) access to the link to opened tickets for a game.</li> <li>Status of set <code>e.g. beta, work in progress, stable, unstable, incomplete</code></li> <li>Shows RA checksum, CRC32 and supported rom names</li> <li>[DONE] Set Developer(s)</li> <li>Publish/Revision Date</li> <li>Players numbers</li> <li>Clickable Genre tags. <code>e.g. Platformer, easy, difficult, long, rpg, jrpg, buggy, etc.</code></li> <li>Special? <code>e.g. awards won, game of the month/week, leaderboard of the month</code></li> </ol>"},{"location":"Game-Page-Improvement-ideas/#other-changes","title":"Other changes","text":"<ol> <li>Follow game button <code>receive updates on changes</code></li> <li>Mark as favorite <code>would show up on user page</code></li> <li>[DONE] Fix or prune \"sort by...\"</li> <li>High scores that are matching are either: <code>Randomized, grouped, King of the hill (Latest winner goes on top) or are sortable to show all of these.</code></li> <li>Gameplay video embed <code>Possibly allow this video to be turned off from game page.</code></li> <li>Average time to master/fastest master/your mastery? <code>: possibly could even log how much time you are in a game on hardcore/softcore, and pause when you go to the overlay or are developing.</code></li> <li>Recent players</li> <li>Allow widgets to be customized, show information more dynamically on page, be removed, moved.</li> </ol> <p>Strikethrough is for issues that are on RAweb</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/","title":"Primeros pasos como un Desarrollador de Logros","text":"<p>Bienvenido al mundo de Creacion de Logros!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#conceptos-basicos","title":"Conceptos Basicos","text":"<p>Tecnicamente un logro es un grupo de condiciones que tienen que ser cumplidas en un punto particular en un video juego.</p> <p>Cuando abres un juego en un emulador con las funciones de RetroAchievements, el emulador esta siempre checando si esas condiciones se cumplen en el punto exacto. Cuando todas las condiciones de un logro en particular son cumplidas, se dispara el logro y el emulador deja de checar las condiciones para ese logro.</p> <p>El proceso de creaci\u00f3n de un logro basicamente se divide en 3 pasos:</p> <ol> <li> <p>Encontar un lugar en la Memoria RAM del juego donde se almacene la informacion que buscas (ejemplos: nivel, barra de vida, tiempo, monedas, sacar un arma, obtener un item, etc.).</p> </li> <li> <p>Crear las condiciones que tienen que ser cumplidas para que se dispare el logro.</p> </li> <li> <p>Probar si tu logro funciona como es debido.</p> </li> </ol> <p>La mayoria de las veces vaz a tener que volver al punto 2 y 3 muchisimas veces para refinar la logica de tu logro.</p> <p>En este documento vamos a ver como lograr los pasos de arriba.</p> <p>Una vez que estes seguro que tu logro esta saltando con las condiciones que tu quieres, puedes subirlo al servidor. Vamos a ver mas sobre eso en un momento.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#primeros-pasos","title":"Primeros Pasos","text":"<p>Antes que nada necesitas estar seguro que tienes un emulador de RA de la pagina de descargas de RetroAchievements y tambien haberte creado una cuenta para poder iniciar seccion en el emulador.</p> <p>En esta guia vamos a utilizar RAGens como demostracion, y el juego Sonic the Hedgehog. Estamos utilizando RAGens pero lo mismo aplica para cualquier otro emulador.</p> <p>Para empezar abre el ejecutable de RAGens, e inicia seccion cuando salga la venta de inicio. Siguiente, ve a File -&gt; Open y selecciona el ROM del que quieres trabajar los logros.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#inspector-de-memoria","title":"Inspector de Memoria","text":"<p>Ahora deberias tener en tu ventana principal corriendo Sonic. Hay otras 3 ventanas que vamos a estar utilizando, que se pueden encontrar sobre la pesta\u00f1a de RetroAchievements en el menu. Vamos a trabajar con el Inspector de Memoria primero:</p> <p></p> <p>El inspector de memoria se puede utilizar para encontrar variables en la RAM que podamos utilizar. Esencialmente estas en una caseria de tesoros por encontrar los lugares en memoria - esta ventana te ayudara a examinar y filtrar la RAM del juego que se encuentra corriendo.</p> <p>NOTA: Si deseas un video paso por paso explicando como encontra valores en la memoria, este viejo video puede llegar a ser util.</p> <p>Tambien mira: Un vistaso al Inspector de Memoria y Tips en la busqueda de Memoria.</p> <p>Para empezar o reiniciar una prueba, haz click en New 8-bit Test en la parte casi superior del medio.</p> <p>Para manter las cosas simple, vamos a empezar a buscar el valor en memoria que guarda el numero de anillos que hemos recolectado. Nuestros pasos son los siguientes:</p> <ol> <li> <p>Carga el ROM y empieza una nueva partida.</p> </li> <li> <p>Resetea la ventana de memoria: Haz click en New 8-bit Test.</p> </li> <li> <p>Regresa al juego y cambia el numero de anillos en la memoria. Por ejemplo, colecciona un anillo</p> </li> <li> <p>En la ventana de memoria, ahora vamos a filtrar los valores que son 'mas grandes que los antiguos valores' (simbolo <code>&gt;</code>). Seleccionamos esto y, entonces hacemos click en Filter.</p> </li> </ol> <p>Cuando ya estes haciendo esto por una 3ra y 4ta vez, el numero de posibilidades o 'candidatos' va a ir disminuyendo. Vamos a seguir haciendo esto asta que lleguemos a un numero muy peque\u00f1o (el mas peque\u00f1o que sea posible), puede llegar a tomar entre 4-5 intentos. Ahora podemos hacer click en la ventana de resultados, y monitoriar los valores en memoria, hasta abajo en el visor de memoria. Continua en el juego y deberias de ver como los valores en la memoria cambian cada vez que coleccionas anillos. Si no es asi, o si algo no se ve bien, intenta otro valor. Con el primer Sonic the Hedgehog, el valor en memoria para el numero de anillos deberia de ser <code>0xfe20</code>.</p> <ul> <li>Nota 1: Utilizando estados de guardados (save states)(F5 para salvar un estado, F8 para cargar un estado, F6-F7 para cambiar que estados utilizar), puedes brincar entre estados de guardado permitiendo esto alterar la RAM, y utilizarlo para filtrar malos candidatos. Puedes buscar resultados que permanescan iguales (Es decir si es que sabes que un valor no tuvo que haber cambiado, utiliza <code>=</code>), o para valores que son diferentes (utiliza 'no igual', simbolo <code>!=</code>).</li> </ul> <ul> <li>Nota 2: Afortunadamente no hay una garantia de un juego a otro para saber como los desarrolladores almacenaban la informacion (4-bit, 8-bit, 16-bit, decimales con codigo binario, negativo/invertido. Por ejemplo utilizando 0xff/0xffff para representar 'fijo', o algo completamente aleatorio), pero eventualmente deberias de encontrarte con varios buenos valores. Nota si estas batallando en encontrar buenos valores, postea en el Foro de Ayuda de RetroAchievements.org, o en el Servidor de Discord de RetroAchievements. Hay bastante gente que estaria dispuesta en ayudarte con mucho gusto!!</li> </ul> <ul> <li>Tip: Si te gusta experimentar con la memoria, intenta ingresar valores directamente en el visor de la RAM. Esto puede causar efectos devastadores en un juego, o podria hacer exactamente lo que deseas que pase, (o inclusive nada!) De todos modos podria ser util, ver si ingresas un valor y paso el resultado que esperas. Utilizalo con cuidado!</li> </ul> <p>Cuando encuentres un valor del que te sientes feliz con el, puedes escriber una peque\u00f1a nota de lo que es haciendo click en Save Note, esto lo va a guardar en la base de datos, y va a ser automaticamente cargado la siguiente vez que cargues el visor de memoria para ese juego, donde sea que te encuentres! Nota despues que haces click en 'Save Note', la nota va a ser automaticamente guardada en la base de datos y compartida, la cual todos los desarrolladores tendran acceso a ella. Todos van a descargar esa nota cuando carguen su ROM. Si intentas sobre-escribir una nota, te va a salir una ventana de confirmacion antes de guardarla.</p> <p>Puedes encontrar mas utiles Tips en Busqueda de Memoria aqui.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#sets-de-logros","title":"Sets de Logros","text":"<p>Ok asi que el valor en memoria para el numero de anillos se encuentra almacenado en <code>0xfe20</code> - nota para un no-programador, estamos manejando numeros en el sistema numerico Hexadecimal que puede llegar a ser desalentador, pero no te preocupes, esencialmente simplemente son numeros y letras en vez de solo numeros, y no olvides <code>0x</code> al principio para mostrar que es un valor en memoria en hexadecimal. Hemos encontrado un valor en el que estamos interesado y lo hemos guardado con Save Note. Ahora queremos crear un nuevo logro.</p> <p>Ve a la pesta\u00f1a de RetroAchievements en el menu de tu emulador, escoje Achievement Sets y vas a ver esta ventana:</p> <p></p> <p>Aqui agrupamos todos los logros disponibles en tres sets:</p> <ol> <li> <p>Logros Core (los principales, set publico de logros),</p> </li> <li> <p>Unofficial/User Achievements (publicos, pero no otorgan puntos: para revision),</p> </li> <li> <p>Local Achievements (personales, en tu PC).</p> </li> </ol> <p>En la venta de Logros, haz click en Local Achievements (superior izquierda), luego en Add New Achievement (superior derecha). Esto va a\u00f1adir una entrada vacia en la lista del centro. Haz doble click en ella: si aun no esta abierta, esto deberia de abrir la ventana del Achievement Editor (editor de logros).</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#editor-de-logros","title":"Editor de Logros","text":"<p>A si es como se ve:</p> <p></p> <p>Esta es la ventana final en la que vamos a poner toda la informacion junta. La mayoria de los campos de arriba se explican solos, ejemplo: Titulo, Descripcion, Puntos. La principal seria la parte de 'Requisitos'</p> <p>Vamos a decir que queremos agregar un logro por coleccionar cierto numero de anillos. Vamos a decir 15 por simplicidad. Despues de llenar los campos de arriba y a ver seleccionado un icono apropiado (en este ejemplo estamos utilizando la medalla del trofeo dorado (00136), pero tu puedes subir una nueva), ocupamos llenar los requisitos. Tenemos un requisito, ese numero de anillos tiene que ser minimo 15. El siguiente click seria en Add New Requirement.</p> <p>Clickear este boton va a agregar algunos valores por default a la lista de requisitos. Los valores por defaults simplemente se percatan que algo relativamente sensible se agrego a la lista. Por ahora, ignorando el campo 'Special?'. Cuando clickeamos en crear, el valor default en memoria va a ser el ultimo valor que dejaste en la ventana de memoria.</p> <p>Lo siguiente seria cambiar estos valores a los siguientes:</p> <ul> <li>Size: <code>16-bit</code></li> <li>Memory: <code>0xfe20</code></li> <li>Cmp: <code>&gt;=</code> - esta es la comparacion que vamos a hacer. Podemos tener cualquier comparacion aqui, pero es sencible que tengas un \"mayor que e igual a\". Esto es importante porque si tenemos 10 anillos y despues obtenemos 10 anillos de una caja de 10 anillos vamos a tener 20, y vamos a perder el logro ya que tendriamos que tener exactamente 15 anillos.</li> <li>Type: <code>Value</code> - estamos comparando este valor en memoria con un valor fijo: 15</li> <li>Size: <code>Empty</code> - Esto es solamente relevante cuando estemos comparando valor en memoria con otro valor en memoria</li> <li>Mem/Val: <code>15</code> - el numero de anillos requirido: el valor del que estamos comparando la memoria</li> <li>Hit Count: <code>0</code> - ignora esto por ahora, es util cuando necesitas que algo paso un cierto numero de veces</li> </ul> <p>Con esto establecido, no necesitamos ninguna otra condicion que agregar, asi que podemos regresar a Achievements Dialog (Ventana de Logros). Para estar seguros, tenemos que guardar nuestro progreso presionando Save Local! Esto guarda todo localmente para asegurar que no perdamos ningun progreso.</p> <ul> <li>Nota: usualmente un logro tiene mas de un requisito para evadir que salte en un momento equivocado (por ejemplo: jugando en modo demo). En este ejemplo estamos utilizando solamente un requisito para simplificar la explicacion. Mira mas Tips en la Creacion de Logros aqui.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#probando-el-logro","title":"Probando el logro","text":"<p>Ahora podemos 'activar' este logro localmente presionando en Activate a mano derecha de la ventana. Esto va a empezar a monitoriar estos valores en memoria y va a entregar el logro una vez que todas las condiciones se hubieran cumplido de manera verdadera. Ahora podemos avanzar y probar si este logro sirve!</p> <p></p> <p>Si presionamos <code>Esc</code> mientras jugamos, vas a ver como se miraria el logro desde la interfaz de RetroAchievements!</p> <p></p> <p>A pesar de que el logro funciono bien en nuestras pruebas, un logro con una logica como esa no esta listo para ser oficialmente lanzado. Primero que nada: tiene una sola condicion: \"anillos coleccionados &gt;= 15\". El problema es que ese mismo valor es el mismo que se utiliza para almacenar el numero de anillos cuando el juego corre en \"modo demo\" (Cuando la computadora juega el juego automaticamente cuando duras mucho tiempo en la pantalla de titulo). A si que, si Sonic colecciona 15 anillos en modo demo el logro tambien saldria, que es algo que no queremos.</p> <p>Checa los tips en la siguiente seccion de abajo para conocer como mejorar la logica de tu logro y hacerlo aceptable para que sea oficialmente lanzado.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#tips-importantes","title":"Tips Importantes","text":"<p>Aqui estan algunos tips que tienes que tener en mente cuando te encuentres creando logros:</p> <ul> <li>Nunca Evade hacer logros con una sola condicion lo mas que puedas. De otra manera es muy probable que el logro se dispare en una parte no deseada. Este es el error mas comun por un desarrollador</li> </ul> <ul> <li>Si el juego tiene un modo demo (El CPU juega despues que esperas un tiempo en la pantalla de titulo), percatate de encontrar el valor para eso y agrega una condicion para que tus logros no se disparen en modo demo. Tambien necesitas saber como utilizar PauseIf y ResetIf.</li> </ul> <ul> <li>PauseIf cheat codes: Si el juego tiene un cheat para aumentar vidas, seleccionar niveles, etc. Percatate de encontrar el valor para eso y agregar algo de proteccion en tus logros. OK, talvez no es un tema muy sencillo, pero es algo que tienes que tener en cuenta cuando estes creando un set oficial de logros.</li> </ul> <ul> <li>Evita crear logros de simplemente llegar a un nivel. Esto puede ser conseguido por medio de un password o un cheat. Mejor haz logros por terminar un nivel, como en la plantilla de aqui. Tambie, no hagas logros por simplemente empezar un juego o \"empieza el juego con X personaje\".</li> </ul> <ul> <li>Si quieres crear un logro por conseguir un item especifico y unico, agrega algunas condiciones para estar seguro que el jugador obtuvo el item donde se suponia que se tenga que obtener, como en esta plantilla de aqui. De otra manera el logro podra ser conseguible utilizando un codigo o cargando una partida de cargado.</li> </ul> <ul> <li>Evita hacer muchos logros sobre simples cosas que necesitan casi cero esfuerzo. Ejemplos de que NO tienes que hacer: obten una moneda o un hongo en Super Mario Bros.</li> </ul> <ul> <li>Ten encuenta los conceptos no-bienvenidos en el dise\u00f1o de logros.</li> </ul> <ul> <li>Se creativo con tus logros. Esos que abarcan caracteristicas y detalles unicos son los mas bienvenidos. Los jugadores aman cuando un peque\u00f1o detalle de un juego que aman es apoyado por un logro. Leer un Walkthrough en GameFAQs te puede dar un poco de inspiracion tambien.</li> </ul> <ul> <li>Intentar pasar la mayor cantidad de tiempo posible con el juego, especialmente si es la primera vez que desarrollas logros. Toma mas tiempo conocer el juego por dentro, trabajar con la memoria funciona ya que es la mejor fuente de ideas para logros unicos.</li> </ul> <p>Puedes encontrar mas en la pagina de Tips y Trucos.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#siguientes-pasos","title":"Siguientes pasos","text":"<p>Ahora que ya sabes como utilizar el Inspector de Memoria, y el Editor de Logros. Llego la hora de que aprendas nuevas tecnicas y practiques:</p> <ul> <li>En orden que refines la logica de tus logros, puedes ver con que funciones cuentas en la pagina de Funciones en la Logica de los Logros.</li> </ul> <ul> <li>Puedes aprender viendo logros existentes que otros desarrolladores han hecho con una explicacion extra en la pagina de Ejemplos Reales.</li> </ul> <ul> <li>Tambien puedes ver algunos ejemplos genericos en la pagina de Plantillas para Logros.</li> </ul> <ul> <li>Una vez que hubieras aprendido todas las tecnicas basicas, si quieres obtener el estatus de Desarrollador tienes que seguir los pasos explicados aqui: Como convertirme en un desarrollador de logros.</li> </ul> <p>Que te diviertas!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:36] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:58] meleu:</code> Updated Getting Started as an Achievement Developer ES (markdown)</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/","title":"Primeiros Passos como um Desenvolvedor de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Getting Started as an Achievement Developer</p> <p>Bem-vindo ao mundo do desenvolvimento de conquisttas!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#conceitos-basicos","title":"Conceitos b\u00e1sicos","text":"<p>Tecnicamente, uma conquista (no contexto de RetroAchievements) \u00e9 um grupo de condi\u00e7\u00f5es que devem ser cumpridas em um determinado frame do jogo.</p> <p>Quando voc\u00ea inicia um jogo em um emulador com o recurso RetroAchievements, o emulador sempre verifica se essas condi\u00e7\u00f5es s\u00e3o atendidas no frame atual. Quando todas as condi\u00e7\u00f5es para uma conquista particular s\u00e3o atendidas, esta conquista \u00e9 ativada e o emulador deixa de verificar as condi\u00e7\u00f5es para essa conquista.</p> <p>O processo de cria\u00e7\u00e3o de uma conquista envolve basicamente 3 etapas:</p> <ol> <li> <p>Encontrar um lugar na RAM do jogo onde a informa\u00e7\u00e3o que voc\u00ea deseja \u00e9 armazenada (exemplos: n\u00edvel, barra de vida, tempo, moedas, segurando uma arma, obter um item, etc.).</p> </li> <li> <p>Criar condi\u00e7\u00f5es que devem ser cumpridas para ativar uma conquista.</p> </li> <li> <p>Testar se a sua conquista est\u00e1 funcionando como esperado.</p> </li> </ol> <p>Provavelmente voc\u00ea voltar\u00e1 para os passos 2 e 3 muitas vezes para refinar a l\u00f3gica de sua conquista.</p> <p>Neste documento, veremos como realizar as etapas acima.</p> <p>Depois de ter certeza de que sua conquista est\u00e1 funcionando nas condi\u00e7\u00f5es desejadas, voc\u00ea pode envi\u00e1-la para o servidor. Veremos mais sobre isso adiante.</p> <p>Tutoriais em V\u00eddeo: o usu\u00e1rio Thoreau \u00e9 um criador de conquistas experiente e criou uma s\u00e9rie de v\u00eddeos mostrando todo o processo de cria\u00e7\u00e3o de conquistas em portugu\u00eas. Confira os v\u00eddeos no youtube.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#primeiros-passos","title":"Primeiros passos","text":"<p>Antes de come\u00e7ar, certifique-se de ter um emulador RA da p\u00e1gina do RetroAchievements Download Page primeiro e crie uma conta para que voc\u00ea possa fazer login usando o emulador.</p> <p>Neste guia, estaremos usando RAGens para demonstrar, e o jogo  Sonic the Hedgehog. Estamos usando RAGens, mas o mesmo se aplica aos outros emuladores.</p> <p>Para come\u00e7ar, execute o RAGens e fa\u00e7a o login quando solicitado. Em seguida, use File -&gt; Open e selecione qualquer ROM que voc\u00ea deseja encontrar conquistas.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#memory-inspector","title":"Memory Inspector","text":"<p>Agora voc\u00ea deve ter sua janela principal executando o Sonic. Existem 3 outros di\u00e1logos que usaremos, que podem ser encontrados em RetroAchievements no menu. Em primeiro lugar, tratamos primeiro o Memory Inspector:</p> <p></p> <p>O Memory Inspector pode ser usado para encontrar endere\u00e7os na RAM para que possamos usar. Essencialmente, voc\u00ea est\u00e1 em uma ca\u00e7ada ao tesouro para locais de mem\u00f3ria - este di\u00e1logo ir\u00e1 ajud\u00e1-lo a examinar e filtrar a RAM do jogo enquanto o jogo est\u00e1 sendo executado.</p> <p>NOTA: Se voc\u00ea quer uma explica\u00e7\u00e3o passo a passo de v\u00eddeo para encontrar endere\u00e7os de mem\u00f3ria, este video esse v\u00eddeo pode ser muito \u00fatil. <code>V\u00eddeo em ingl\u00eas</code></p> <p>Para iniciar ou reiniciar um teste, clique em New 8-bit Test  perto do meio na parte superior.</p> <p>Para manter as coisas simples, come\u00e7aremos procurando pelo endere\u00e7o de mem\u00f3ria que contenha o n\u00famero de an\u00e9is que coletamos. Nossas etapas ser\u00e3o as seguintes:</p> <ol> <li> <p>Carregue a ROM e comece um novo jogo.</p> </li> <li> <p>Redefinir a caixa de di\u00e1logo de mem\u00f3ria: clique em New 8-bit Test.</p> </li> <li> <p>Retorne ao jogo e altere o n\u00famero de an\u00e9is na mem\u00f3ria. Por exemplo, colete um anel.</p> </li> </ol> <p>Na caixa de di\u00e1logo de mem\u00f3ria, agora queremos filtrar por valores que sejam \"maiores do que valores anteriores\" (s\u00edmbolo&gt;). Selecionamos isso, ent\u00e3o, clique em Filter.</p> <p>Cada vez que voc\u00ea executa 3 e 4, o n\u00famero de possibilidades ou 'candidatos' diminuir\u00e1. Continuaremos a faz\u00ea-lo at\u00e9 que o n\u00famero de candidatos alcance um n\u00famero muito pequeno (o menor poss\u00edvel), pode demorar 4-5 tentativas. Em seguida, podemos clicar na janela de resultados e monitorar o endere\u00e7o de mem\u00f3ria no visor de mem\u00f3ria na parte inferior. Continue usando o jogo e voc\u00ea deve ver os valores em mudan\u00e7a de mem\u00f3ria \u00e0 medida que voc\u00ea coleciona an\u00e9is. Se voc\u00ea n\u00e3o, ou se algo n\u00e3o parece direito, tente outro valor. Com o primeiro Sonic the Hedgehog, o endere\u00e7o da mem\u00f3ria para o n\u00famero de an\u00e9is deve ser 0xfe20.</p> <ul> <li>Nota: Usando estados de salvamento (F5 para salvar o estado, F8 para carregar o estado, F6-F7 para alternar o estado a ser usado), voc\u00ea pode alternar entre estados diferentes, permitindo alterar o que est\u00e1 na RAM e usar isso para filtrar fora candidatos ruins. Voc\u00ea pode procurar por valores que permanecem os mesmos (ou seja, se voc\u00ea sabe que o valor n\u00e3o mudou, use =) ou valores diferentes (use 'not equal', symbol! =).</li> </ul> <ul> <li>Nota: Infelizmente nenhuma garantia de jogo para jogo sobre como os desenvolvedores armazenaram seus dados (decimais de codigo bin\u00e1rio de 4 bits, 8 bits, 16 bits, negativos / invertidos, ou seja, usando 0xff / 0xffff para representar 'set' , ou simples, aleatoriamente), mas, eventualmente, voc\u00ea deve encontrar um bom endere\u00e7o. Observe se voc\u00ea est\u00e1 lutando para encontrar bons valores, postar o f\u00f3rum de Ajuda de desenvolvimento RetroAchievements.org Development Help forum ou o servidor  RetroAchievements Discord server. H\u00e1 muitas pessoas que ficar\u00e3o muito felizes em ajudar!</li> </ul> <ul> <li>Dica: se voc\u00ea quiser experimentar a mem\u00f3ria, tente inserir novos valores diretamente no visualizador de RAM. Isso pode ter efeitos devastadores no jogo, ou pode fazer exatamente o que voc\u00ea espera, (ou nada!) Pode ser \u00fatil, para ver se voc\u00ea pode inserir um valor e obter o resultado esperado. Use com cuidado!</li> </ul> <p>Quando voc\u00ea encontrou um endere\u00e7o com o qual voc\u00ea est\u00e1 feliz, voc\u00ea pode escrever uma nota curta para o que \u00e9 e clicar em Salvar nota, isso ir\u00e1 armazen\u00e1-lo no banco de dados e ser\u00e1 restaurado automaticamente na pr\u00f3xima vez que voc\u00ea carregar o visor de mem\u00f3ria para isso jogo onde quer que esteja! Note que depois de clicar em \"Salvar nota\", a nota ser\u00e1 armazenada automaticamente no banco de dados, e compartilhada para que todos os desenvolvedores compartilhem o acesso a essas notas de mem\u00f3ria. Todos ser\u00e3o baixados de novo quando voc\u00ea carregar uma ROM. Se voc\u00ea tentar substituir uma nota, verificar\u00e1 com voc\u00ea primeiro antes de enviar.</p> <p>Voc\u00ea pode encontrar Dicas de Escava\u00e7\u00e3o de Mem\u00f3ria aqui.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#achievement-sets","title":"Achievement Sets","text":"<p>OK para que a localiza\u00e7\u00e3o da mem\u00f3ria para o n\u00famero de an\u00e9is seja armazenada em <code>0xfe20</code> - nota para um n\u00e3o programador, estamos lidando com um sistema de numera\u00e7\u00e3o hexadecimal que pode ser assustador, mas n\u00e3o se preocupe, essencialmente s\u00e3o apenas n\u00fameros e letras em vez de apenas n\u00fameros, e n\u00e3o esquecendo <code>0x</code> no in\u00edcio para mostrar que \u00e9 uma localiza\u00e7\u00e3o de mem\u00f3ria em hexadecimal. Encontramos um endere\u00e7o em que nos interessamos e armazenamos usando Save Note. Agora queremos criar uma nova conquista.</p> <p>V\u00e1 para o RetroAchievements no menu, escolha Achievement Sets e voc\u00ea ver\u00e1 esta caixa de di\u00e1logo:</p> <p></p> <p>Aqui agrupamos todas as conquistas que conhecemos em tr\u00eas conjuntos:</p> <ol> <li> <p>Core Achievements (o principal, conjunto de conquistas p\u00fablico),</p> </li> <li> <p>Unofficial/User Achievements (p\u00fablico, mas n\u00e3o ir\u00e1 premiar pontos, \u00e9 apenas para outros desenvolvedores revisarem),</p> </li> <li> <p>Local Achievements (pessoais no seu PC).</p> </li> </ol> <p>Na caixa de di\u00e1logo Conquistas, clique em Local Achievements (canto superior esquerdo), depois em Add New Achievement (inferior esquerda). Isso ir\u00e1 adicionar uma entrada em branco \u00e0 lista no centro. Clique duas vezes nele: se ainda n\u00e3o est\u00e1 aberto, isso deve selecion\u00e1-lo e abrir a caixa de di\u00e1logo Editor de conquista (Achievement Editor).</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#achievement-editor","title":"Achievement Editor","text":"<p>O Achievement Editor se parece com isso:</p> <p></p> <p>Esta \u00e9 a \u00faltima caixa de di\u00e1logo onde reunimos todos os dados juntos. A maioria dos principais campos s\u00e3o auto-explicativos, ou seja, Title, Description, Points. A principal \u00e9 a parte de 'Requirements' (Requisitos).</p> <p>Digamos que queremos adicionar uma conquista para colecionar um certo n\u00famero de an\u00e9is. Digamos 15 an\u00e9is para simplificar. Depois de preencher os campos na parte superior e selecionar um \u00edcone adequado (neste exemplo, usamos o distintivo de trof\u00e9u de ouro (00136), mas voc\u00ea pode carregar um novo), precisamos preencher os Requisitos. Temos um requisito, que o n\u00famero de an\u00e9is \u00e9 pelo menos 15. O pr\u00f3ximo clique \u00e9 Add New Requirement.</p> <p>Ao clicar neste bot\u00e3o, ser\u00e3o adicionados v\u00e1rios valores padr\u00e3o \u00e0 lista Requisitos. Esses padr\u00f5es apenas garantem que algo relativamente sens\u00edvel seja adicionado \u00e0 lista. Por enquanto, ignorando o campo 'Special?'. Quando clicamos em criar, o valor de mem\u00f3ria padr\u00e3o ser\u00e1 o valor que voc\u00ea deixou pela \u00faltima vez na caixa de di\u00e1logo de mem\u00f3ria.</p> <p>Em seguida, alteraremos esses valores para o seguinte:</p> <ul> <li>Size: <code>16 bits</code>.</li> </ul> <ul> <li>Memory: <code>0xfe20</code>.</li> </ul> <ul> <li>Cmp: <code>&gt;=</code> - esta \u00e9 a compara\u00e7\u00e3o a fazer. Podemos ter alguma compara\u00e7\u00e3o aqui, mas \u00e9 sensato ter \"maior ou igual\". Isso \u00e9 importante porque, se conseguimos 10 an\u00e9is, ent\u00e3o uma caixa de super anel para ter 20, perder\u00edamos exatamente 15 an\u00e9is.</li> </ul> <ul> <li>Type: <code>Value</code> - estamos comparando esse valor de mem\u00f3ria com um valor fixo: 15.</li> </ul> <ul> <li>Size: <code>Empty</code> - isso s\u00f3 \u00e9 relevante ao comparar a mem\u00f3ria com a mem\u00f3ria.</li> </ul> <ul> <li>Mem/Val: <code>15</code> - o n\u00famero de an\u00e9is necess\u00e1rios: o valor com o qual estamos comparando a mem\u00f3ria</li> </ul> <ul> <li>Hit Count: <code>0</code> - ignore isso por enquanto, \u00e9 \u00fatil para quando algo precisa acontecer um certo n\u00famero de vezes.</li> </ul> <p>Com esse conjunto, n\u00e3o temos mais condi\u00e7\u00f5es para adicionar, ent\u00e3o retornamos \u00e0 caixa de di\u00e1logo Achievements. Para estar seguro, devemos salvar nosso progresso ao clicar em Save Local! Isso salva tudo para arquivar localmente para garantir que n\u00e3o perderemos nenhum progresso.</p> <ul> <li>Nota: geralmente as conquistas t\u00eam mais de um requisito para evitar que ele acione em um momento errado (ou seja, jogando o modo de demonstra\u00e7\u00e3o). Neste exemplo, estamos usando apenas um requisito apenas para simplificar a explica\u00e7\u00e3o. Veja mais dicas de cria\u00e7\u00e3o de conquistas aqui.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#testando-a-conquista","title":"Testando a conquista","text":"<p>Agora podemos \"ativar\" essa conquista localmente ao clicar Activate no lado direito. Isso come\u00e7ar\u00e1 a monitorar esses locais de mem\u00f3ria e atribuir\u00e1 a conquista uma vez que todas as condi\u00e7\u00f5es s\u00e3o verdadeiras. Agora, podemos prosseguir e testar para ver se essa conquista funciona!</p> <p></p> <p>Se pressionarmos no jogo Esc, voc\u00ea ver\u00e1 a conquista aparecer como uma demonstra\u00e7\u00e3o do que seria semelhante \u00e0 sobreposi\u00e7\u00e3o no jogo!</p> <p></p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#evitando-bugs","title":"Evitando bugs","text":"<p>O cheevo (achievement) que criamos neste tutorial \u00e9 muito simples, tem apenas uma condi\u00e7\u00e3o: \"an\u00e9is coletados\" &gt;= 15 \". Mas o endere\u00e7o para gravar o n\u00famero de an\u00e9is coletados tamb\u00e9m \u00e9 usado quando o jogo \u00e9 executado em \"modo de demonstra\u00e7\u00e3o\" (AI jogando o jogo depois de esperar um pouco na tela de t\u00edtulo). Ent\u00e3o, se Sonic coletar 15 an\u00e9is no modo de demonstra\u00e7\u00e3o, essa conquista ir\u00e1 desencadear, o que \u00e9 indesej\u00e1vel.</p> <p>Ent\u00e3o, aqui est\u00e3o algumas dicas que voc\u00ea sempre deve ter em mente ao criar suas conquistas:</p> <ul> <li>Nunca use/Evite ao m\u00e1ximo usar apenas uma condi\u00e7\u00e3o. Caso contr\u00e1rio, a conquista provavelmente ir\u00e1 aparecer na hora errada. Este \u00e9 o erro mais comum cometido por um desenvolvedor.</li> </ul> <ul> <li>Use <code>PauseIf</code> demo mode (modo demonstra\u00e7\u00e3o): Se o jogo tiver um modo de demonstra\u00e7\u00e3o, certifique-se de encontrar o endere\u00e7o para ele e adicionar o modo! = Demo ou algo semelhante em suas conquistas. Mais informa\u00e7\u00f5es sobre PauseIf na p\u00e1gina Caracter\u00edsticas da l\u00f3gica de conquista.</li> </ul> <ul> <li>Use <code>PauseIf</code> usando macetes (cheat codes): se o jogo tiver um c\u00f3digo secreto de macete para aumentar vidas, selecionar fases, etc. Certifique-se de encontrar os endere\u00e7os para isso e adicionar algum tipo de prote\u00e7\u00e3o em suas conquistas. OK, talvez n\u00e3o seja um t\u00f3pico muito b\u00e1sico, mas voc\u00ea deve ter em mente ao criar um conjunto de conquistas real.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#ok-o-achievement-funciona-e-agora","title":"OK, o achievement funciona. E agora?","text":"<p>Depois de testarmos que a conquista funciona localmente, h\u00e1 um processo de confirma\u00e7\u00e3o em duas etapas:</p> <ol> <li> <p>Primeiro, na caixa de di\u00e1logo Conquistas, selecionamos nossa conquista e pressione Commit Selected e concordamos com a caixa de di\u00e1logo. Isso ir\u00e1 empurrar nossa conquista para o servidor e armazen\u00e1-lo em Unofficial User-submitted Achievements</p> </li> <li> <p>Para que a conquista seja apreciada por muitos, ela deve ser empurrada para o conjunto Core Achievement (Core Achievement set). Para as suas poucas primeiras conquistas, ele deve ser revisado por um membro da equipe antes que possa ser empurrado para o Core. Depois de ter carregado um conjunto de conquistas para o Unofficial, voc\u00ea precisa entrar em contato com um administrador que, usando seu julgamento e padr\u00f5es pessoais de qualidade, aprovar\u00e1 o conjunto e lhe dar\u00e1 um status de desenvolvedor no site (Developer status). Nesse caso, voc\u00ea pode empurrar qualquer conquista para o Core voc\u00ea mesmo.</p> </li> </ol> <p>Naturalmente, \u00e9 melhor enviar apenas conquistas \u00fanicas e interessantes no grupo de conquistas principais. Se houver duplicatas no grupo Core, as duplicatas adicionadas mais recentemente ser\u00e3o manualmente moderadas e exclu\u00eddas. Se voc\u00ea n\u00e3o quer sua conquista no grupo Core, ou voc\u00ea acha que pode n\u00e3o ser apropriado para o grupo Core (ou seja, se est\u00e1 incompleto, ou se \u00e0s vezes ele parece se desencadear quando n\u00e3o \u00e9 suposto, como quando o jogo est\u00e1 mostrando um demo), deixe-o na se\u00e7\u00e3o N\u00e3o oficial / Se\u00e7\u00e3o submetida pelo usu\u00e1rio.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#proximos-passos","title":"Pr\u00f3ximos passos","text":"<p>Agora que voc\u00ea sabe como usar o Memory Inspector e o Editor de Conquistas. \u00c9 hora de aprender novas t\u00e9cnicas e pr\u00e1ticas:</p> <ul> <li>Para refinar a l\u00f3gica de sua conquista, voc\u00ea pode ver quais recursos voc\u00ea possui na p\u00e1gina Achievement Logic Features.</li> </ul> <ul> <li>Voc\u00ea pode aprender observando as conquistas existentes que outros desenvolvedores fizeram com uma explica\u00e7\u00e3o extra na p\u00e1gina Real Examples.</li> </ul> <ul> <li>Voc\u00ea tamb\u00e9m pode ver alguns exemplos gen\u00e9ricos na p\u00e1gina Achievement Templates.</li> </ul> <p>Diverta-se! Obrigado pela leitura!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:27] meleu:</code> fix links</li> <li><code>[2020-06-20 18:15] meleu:</code> adicionado link para a playlist do Thoreau</li> <li><code>[2018-06-10 10:51] lilbud:</code> Updated Discord Link</li> <li><code>[2018-03-28 20:09] meleu:</code> Updated Getting Started as an Achievement Developer pt_BR (markdown)</li> <li><code>[2018-03-25 01:09] meleu:</code> Updated Getting Started as an Achievement Developer pt_BR (markdown)</li> <li><code>[2018-03-23 01:19] meleu:</code> Updated Getting Started as an Achievement Developer.pt_BR (markdown)</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer/","title":"Getting Started as an Achievement Developer","text":"<p>Welcome to the world of Achievement Creation!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#basic-concepts","title":"Basic Concepts","text":"<p>Technically an achievement is a group of conditions that must be met in a particular frame of the video game.</p> <p>When you launch a game on an emulator with the RetroAchievements feature, the emulator is always checking if those conditions are met in the current frame. When all conditions for a particular achievement are met, it is awarded and the emulator stops checking the conditions for that achievement.</p> <p>The process of creating an achievement basically involves 3 steps:</p> <ol> <li> <p>Finding a place in the game's RAM where the information you want is stored (examples: level, life bar, time, coins, holding a weapon, get an item, etc.).</p> </li> <li> <p>Create conditions that must be met in order to award an Achievement.</p> </li> <li> <p>Test if your achievement is working as expected.</p> </li> </ol> <p>Most likely you'll go back to step 2 and 3 many times to refine the logic of your Achievement.</p> <p>In this doc we'll see how to accomplish the steps above.</p> <p>After you're sure your achievement is triggering at the conditions you want, you can submit it to the server. We'll see more about it later.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#first-steps","title":"First Steps","text":"<p>Before start ensure you have an RA emulator from the RetroAchievements Download Page first and create an account so you can log in using the emulator.</p> <p>In this guide we'll be using RALibRetro with the Genesis Plus GX core to demonstrate, and the game Sonic the Hedgehog. We are using RALibRetro but the same applies for the standalone emulators.</p> <p>To begin, run the RALibRetro executable and login when prompted. If you have not used the Genesis Plus GX core before, you can install it by going to Settings -&gt; Manage Cores -&gt; selecting Sega Genesis in the drop down menu -&gt; clicking Download to the right of the core name. Once the core is installed, go to File -&gt; Select Core -&gt; Sega Genesis -&gt; Genesis Plus GX. Now that you have the core selected, you'll need to load the game. Go to File -&gt; Load Game and select the Sonic the Hedgehog ROM (we recommend using No Intro ROMs by default). </p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#memory-inspector","title":"Memory Inspector","text":"<p>You should now have your main window running Sonic. There are 3 other dialogs we'll be using, which can be found under RetroAchievements in the menu. We'll be dealing with the Memory Inspector first:</p> <p></p> <p>The Memory Inspector can be used to find addresses in RAM for us to use. Essentially you are on a treasure hunt for memory locations - this dialog will help you examine and filter the game's RAM while the game is running.</p> <p>NOTE: If you want a step-by-step video explanation on finding memory addresses, you can view this updated video. For another video resource, you can view this older video.</p> <p>See also: Memory Inspector Overview and Memory Digging Tips.</p> <p>To start or restart a test, click Reset near the top left.</p> <p>To keep things simple, we'll start by looking for the memory address which holds the number of rings we have collected. Our steps will be the following:</p> <ol> <li> <p>Load the ROM and start a new game.</p> </li> <li> <p>Reset the memory dialog: click Reset.</p> </li> <li> <p>Run the first filter: click Filter Once.</p> </li> <li> <p>Return to the game and change the number of rings in memory. For example, collect a ring.</p> </li> <li> <p>In the memory dialog, we now want to filter for values that are 'greater than previous values' (symbol <code>&gt;</code>). We select this, then hit Filter again.</p> </li> </ol> <p>Each time you perform 4 then 5, the number of possibilities or 'candidates' will get smaller. We will continue doing this until the number of candidates reaches a very small number (as few as possible), it can take several attempts. Next we can click in the results window, and monitor the memory address in the memory viewer at the bottom. Continue using the game and you should see the values in memory change as you collect rings. If you don't, or if something doesn't look right, try another value. With the first Sonic the Hedgehog, the memory address for the number of rings should be <code>0xfe20</code>.</p> <ul> <li>Note 1: Using save states (Shift+F1-F10 to save states, F1-F10 to load states), you can switch back and forth between different states allowing you to alter what is in RAM, and use this to filter out bad candidates. You can search for values that remain the same (I.e. If you know the value didn't change, use <code>=</code>), or values that are different (use 'not equal', symbol <code>!=</code>). Using the example above, you can collect a ring then use the \"&gt;\" filter, take a few steps then use the \"=\" filter (since the number of rings did not change), collect more rings and use the \"&gt;\" filter again, etc.</li> </ul> <ul> <li>Note 2: There's unfortunately no guarantee from game to game on how the developers have stored their data (4-bit, 8-bit, 16-bit, binary-coded decimals, negative/inverted, i.e. using 0xff/0xffff to represent 'set', or plain randomly), but eventually you should come across some good addresses. Note if you are struggling to find good values, post in RetroAchievements.org Development Help forum, or RetroAchievements Discord server. There are plenty of people who will be very happy to help!!</li> </ul> <ul> <li>Tip: if you'd like to experiment with memory, try entering new values directly into the RAM viewer. This can have devastating effects on the game, or it might do exactly what you expect, (or nothing at all!) It can be useful though, to see if you can enter a value and get the result you expect. Use with caution!</li> </ul> <p>When you've found an address you're happy with, you can write a short note for what it is and hit Save Note, this will store it on database, and will be automatically restored next time you load up the memory viewer for this game, wherever you are! Note that after clicking 'Save Note', the note will be automatically stored on the database, and shared so all developers will share access to these memory notes. They will all be downloaded afresh when you load a ROM. If you try to overwrite a note, it will check with you first before submitting.</p> <p>You can find more useful Memory Digging Tips here.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#achievement-sets","title":"Achievement Sets","text":"<p>So the memory location for the number of rings is stored at <code>0xfe20</code> - note to a non-programmer, we're dealing in hexadecimal numeral system which can be daunting, but don't worry, essentially it's just numbers and letters instead of only numbers, and not forgetting <code>0x</code> at the start to show that it's a memory location in hex. We've found an address we're interested in and stored it using Save Note. We now want to create a new achievement.</p> <p>Go to the RetroAchievements in the menu, choose Achievement Sets and you'll see this dialog:</p> <p></p> <p>Here we group all the achievements we know about into three sets:</p> <ol> <li> <p>Core Achievements (the main, public Achievement set),</p> </li> <li> <p>Unofficial/User Achievements (public, but will not award you points: for peer review),</p> </li> <li> <p>Local Achievements (exclusive to your PC).</p> </li> </ol> <p>In the Achievements dialog, click Local Achievements (top left), then Add New Achievement (top right). This will add a blank entry to the list in the center. Double click on it: if it's not already open, this should select it and open the Achievement Editor dialog.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#achievement-editor","title":"Achievement Editor","text":"<p>This is how it looks:</p> <p></p> <p>This is the final dialog where we bring all the data together. Most of the top fields are self explanatory, I.e. Title, Description, Points. The main one is the 'Requirements' part.</p> <p>Let's say we want to add an achievement for collecting a certain number of rings. Let's say 15 rings for simplicity. After filling out the fields at the top and selecting a suitable icon (in this example we used the gold trophy badge (00136), but you can upload a new one), we need to fill out Requirements. We have one requirement, that the number of rings is at least 15. Next click is Add New Requirement.</p> <p>Clicking this button will add several default values to the Requirements list. These defaults just ensure that something relatively sensible is added to the list. For now, ignoring the field 'Special?'. When we clicked create, the default memory value will be whatever value you last left in the memory dialog.</p> <p>Next we will change these values to the following:</p> <ul> <li>Size: <code>16-bit</code> - we're using 16-bit because the value can exceed 255 (which is 0xff in hex)</li> <li>Memory: <code>0xfe20</code></li> <li>Cmp: <code>&gt;=</code> - this is the comparison to make. We could have any comparison here, but it's sensible to have \"greater than or equal to\". This is important because if we get 10 rings then a super ring box to have 20, we would miss out having exactly 15 rings.</li> <li>Type: <code>Value</code> - we're comparing this memory value to a fixed value: 15</li> <li>Size: <code>Empty</code> - this is only relevant when comparing memory to memory</li> <li>Mem/Val: <code>15</code> - the number of rings required: the value we are comparing the memory to</li> <li>Hit Count: <code>0</code> - ignore this for now, its useful for when something needs to happen a certain number of times</li> </ul> <p>With that set, we don't have any more conditions to add, so we return to the Achievements Dialog. To be safe, we should save our progress by hitting Save Local! This saves everything to file locally to ensure that we won't lose any progress.</p> <ul> <li>Note: An achievement should have more than one requirement to avoid it triggering at the wrong time (i.e. playing demo mode). In this example, we are using only one requirement to simplify the explanation. See more Achievement Creation Tips here.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer/#testing-the-achievement","title":"Testing the Achievement","text":"<p>We can now 'activate' this achievement locally by checking the box next to Active on the right-hand side in the Achievement Editor or by selecting the achievement in Achievement Sets and clicking Activate Selected. This will start monitoring these memory locations and will award the achievement once all the conditions are true. Now we can go ahead and test to see if this achievement works!</p> <p></p> <p>If we press <code>Esc</code> in-game, you will see the achievement show up as a demonstration of what it would look like in the in-game overlay!</p> <p></p> <p>Although the achievement worked fine in our tests, an achievement with logic like that is not ready to be officially released. First of all, it has only one condition: \"collected rings &gt;= 15\". The problem is that the memory address used to record the number of collected rings is also used when the game runs in \"demo mode\" (AI playing the game after you wait a while on the title screen). So, if Sonic collects 15 rings in demo mode this achievement will trigger, which is unwanted.</p> <p>Check the tips in the next section below to know how to improve the logic of your achievement and then make it acceptable to be officially released.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#important-tips","title":"Important Tips","text":"<p>Here are some tips you have to keep in mind when creating your achievements:</p> <ul> <li>Never Avoid making achievements with only one condition as much as you can. Otherwise it will most likely pop at the wrong time. This is the most common error by a developer</li> </ul> <ul> <li>If the game has a demo mode (AI plays the game after you wait a while on the title screen), make sure to find the address for it and add a condition so your achievements don't trigger in demo mode. You'll also need to know how to use PauseIf and ResetIf.</li> </ul> <ul> <li>PauseIf cheat codes: If the game has a cheat code to increase lives, select stages, etc., make sure to find the addresses for it and add some kind of protection in your achievements. OK, maybe it's not a very basic topic, but you have to keep it in mind when creating an official achievement set.</li> </ul> <ul> <li>Avoid creating achievements for just entering a stage. As it can be earned by a password or a stage select cheat code. It is preferred to make achievements for finishing stages, like in this template here. Also, do not create achievements for just starting a game or \"starting a game with character X\".</li> </ul> <ul> <li>If you want to create an achievement for getting a unique item in the game, add some conditions to make sure the player obtained the item where it is supposed to be obtained, like in this template here. Otherwise the achievement can be earned by using password or loading a saved game.</li> </ul> <ul> <li>Avoid making too many achievements about simple things that require minimal effort. Examples of what NOT to do: get one coin or one mushroom on Super Mario Bros.</li> </ul> <ul> <li>Be aware of the unwelcome achievement's design concepts.</li> </ul> <ul> <li>Be creative with your achievements. Those covering unique features and details of the game are the most welcome. The players love when that little detail of a game they love is supported on an achievement. Reading a walkthrough on GameFAQs can give some inspiration too.</li> </ul> <ul> <li>It can take a while to understand how the memory works in a game, so try spending as much time with it as you can, especially if it's your first attempt at developing achievements. </li> </ul> <p>You can find more in the Tips and Tricks page.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#next-steps","title":"Next Steps","text":"<p>Now that you know how to use the Memory Inspector, and the Achievement Editor. It's time to learn new techniques and practice:</p> <ul> <li>In order to refine your achievement logic, you can see what features you have in the Achievement Logic Features page.</li> </ul> <ul> <li>Another way to learn is by looking at existing achievements that other devs made with an extra explanation in the Real Examples page.</li> </ul> <ul> <li>You can also see some generic examples in the Achievement Templates page.</li> </ul> <ul> <li>Once you have learned the basic techniques, you can continue your quest to become an achievement developer by following the steps explained here: How to Become an Achievement Developer</li> </ul> <p>Have fun!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-01-28 22:59] OvenOverlord:</code> Added Fridge's video link to the step-by-step video explanation links</li> <li><code>[2021-07-08 09:31] televandalist:</code> Fix image links</li> <li><code>[2020-05-15 02:15] televandalist:</code> Changed the Save/Load State method to match that of RALib rather than RAGens.</li> <li><code>[2020-05-15 02:13] televandalist:</code> Quick typo fix.</li> <li><code>[2020-05-15 02:04] televandalist:</code> Reworded instructions to apply to RALibRetro instead of RAGens. Added note about why the 16-bit address was selected in the editor. Fixed multiple typos, grammatical errors, and reworded some 'casual' speak.</li> <li><code>[2020-05-15 00:05] televandalist:</code> Recreated the old images with RALib. Old ones were using RAGens and had the old overlay.</li> <li><code>[2019-02-09 20:44] meleu:</code> mentioning PauseIf with hitcounts on this doc can lead to confusion (if we had a template/example for this technique it would be OK)</li> <li><code>[2019-02-08 10:53] meleu:</code> cosmetic</li> <li><code>[2019-02-08 02:12] Kvon:</code> pauseif link, added critical line for adding cheat protection, typically</li> <li><code>[2019-02-08 02:07] Kvon:</code> added a link to the demo mode tips</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/","title":"Tablas Globales y Reglas para la Caser\u00eda de Logros","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#en-resumen-las-reglas-de-oro","title":"En Resumen - Las Reglas de Oro","text":"<p>Participantes de las Tablas de Clasificaci\u00f3n Globales necesitan conseguir sus logros de manera justa y legitima.</p> <p>En general, un jugador tiene que desbloquear logro de la siguiente manera:</p> <ol> <li>utilizando la ultima versi\u00f3n de un emulador con soporte de RA;</li> <li>dentro del juego con acciones en el juego;</li> <li>que el lo controle;</li> <li>sin modificar los archivos del juego o el c\u00f3digo del juego;</li> <li>sin utilizar el archivo de guardado de otro jugador, y;</li> <li>sin utilizar programas externos de cheats.</li> </ol> <p>Esta reglas son dise\u00f1adas para mantener a los jugadores honestos en sus partidas y que sean honestos con todos los demas jugadores en la competencia de Tablas Globales.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#tabla-de-contenidos","title":"Tabla de Contenidos","text":"<ul> <li>Tablas Globales</li> <li>Modo Hardcore</li> <li>No Trackeado/Untracked</li> <li>No Permitido</li> <li>Permitido</li> <li>Sanciones por hacer trampa</li> <li>Como limpiar tu nombre y apelar el hacer trampa</li> <li>Si necesitas ayuda</li> <li>Agradecimientos Especiales</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#tablas-globales","title":"Tablas Globales","text":"<p>Las tablas globales de RetroAchievements es la competencia principal y oficial. Este incluye un rango \u00fanico del sitio basado en tu suma de puntos de logros en comparaci\u00f3n con todos los dem\u00e1s jugadores rankeados. Cualquier cuenta con puntos mayor a 0 es rankeada autom\u00e1ticamente.</p> <p>Lo que es considerado como una partida justa y legitima contra lo que se considera que no es justo (cheating) en las tablas globales a ido tomando forma por la comunidad desde sus or\u00edgenes. La reglas de abajo son lo que se espera de cada jugador que participa en en el rankeado global. Cualquier indicaci\u00f3n de que un jugador no este siguiendo las reglas este puede llegar a perder el uso de las tablas globales, tambi\u00e9n conocido como el estatus No Trackeado/Untracked.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#modo-hardcore","title":"Modo Hardcore","text":"<p>El modo Hardcore es una funci\u00f3n donde el emulador desactiva completamente la habilidad de estados de guardado (savestate), rebobinar (rewind) y c\u00e1mara lenta (slow motion). La funci\u00f3n de fast-forward es la \u00fanica excepci\u00f3n aceptada.</p> <p>Cuando juegas en modo hardcore los puntos que consigas valen el doble. Entonces si el set de logros tiene un valor de 400 puntos y lo terminas en modo hardcore vas a obtener 800 puntos.</p> <p>Los usuarios que se toman en serio las tablas de clasificaci\u00f3n son mas probables que consigan puntos en modo hardcore.</p> <p>NOTA: cuando se juega con el modo hardcore desactivado (tambi\u00e9n conocido como \"softcore\"), espera tener algunos problemas. Lee en este enlace porque no deber\u00edas de utilizar la funci\u00f3n de cargado de estado.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#no-trackeadountracked","title":"No Trackeado/Untracked","text":"<p>Una cuenta no trackeada no aparece en el ranking global, sus actividades no aparecen en el feed, no se muestra con todos los dem\u00e1s usuarios que consiguieron alg\u00fan logro (en la pagina del logro) y sus entradas en las tablas de clasificaciones no son publicamente visible.</p> <p>Sin embargo una cuenta No Trackeada aun puede disfrutar de RetroAchievements y conseguir los emblemas por completar juegos.</p> <p>Este estatus fue creado para que la gente puede hacer lo que quiera con sus cuentas (como hacer trampa o compartir contenido en sus amigos/familia) sin meterse con el aspecto justo y competitivo de las tablas globales. As\u00ed que, si quieres disfrutar de RetroAchievements pero no quieres competir en las tablas globales puedes solicitar que tu cuenta se deje de trackear. Simplemente manda un mensaje a RAdmin solicitandolo.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#no-permitido","title":"No Permitido","text":"<ol> <li>No utilices m\u00e9todos que alteren el c\u00f3digo del logro para desbloquearlos inmediatamente.</li> <li>No consigas logros en una manera en la que no fueron las intenciones del desarrollador del logro.</li> <li>No utilices archivos de guardado que no sean tuyos o fueron hechos para jugar con otras condiciones.</li> <li>De ninguna manera modifiques el(los) archivo(s) o memoria del juego.</li> <li>No utilices archivos de juego o programas conocidos como \"trainers\".</li> <li>No utilices TAS (tool-assisted speedrunning), bots, o escritura compleja para conseguir logros.</li> <li>No permitas que otra gente acceda a tu cuenta y consiga logros por ti.</li> <li>No seas abusivo/a con los desarrolladores.</li> <li>No crees o compartas m\u00e9todos para hacer trampa.</li> <li>No utilices c\u00f3digos dentro del juego al menos que sea permitido por el desarrollador.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#1-no-utilices-metodos-que-alteren-el-codigo-del-logro-para-desbloquearlos-inmediatamente","title":"1. No utilices m\u00e9todos que alteren el c\u00f3digo del logro para desbloquearlos inmediatamente.","text":"<p>Incluso si \"tu tuviste\" que haber conseguido ese logro. Incluso si el juego estaba buggeado. Incluso si el logro esta completamente roto o removido. Cuando esto es detectado es muy probable que tu cuenta se pase a Untracked.</p> <p>En los casos en que el logro tuvo que haberse desbloqueado pero no paso o no se registro en el sitio debido a un problema de red, deber\u00e1s de seguir los pasos descritos en el FAQ para solicitar un desbloqueo manual.</p> <p>NOTA: percatate de utilizar la ultima versi\u00f3n disponible para ese emulador.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#2-no-consigas-logros-en-una-manera-en-la-que-no-fueron-las-intenciones-del-desarrollador-del-logro","title":"2. No consigas logros en una manera en la que no fueron las intenciones del desarrollador del logro.","text":"<p>Si descubres un atajo a un logro esto es un bug. Por favor reporta este bug creando un ticket de reporte.</p> <p>Tambien mira la regla permitida 2.</p> <p>Ejemplos: </p> <ul> <li>Desbloqueaste logros terminando niveles por medio de un c\u00f3digo de selecci\u00f3n de niveles, y tiene que ser reportado/arreglado.</li> <li>Te diste cuenta que si entras y sales entre dos cuartos desbloqueas logros intencionados para progresi\u00f3n del juego.</li> <li>Encontraste un m\u00e9todo para conseguir logros de no recibir da\u00f1o contra un jefe mientras consegu\u00edas da\u00f1o en la pelea.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#3-no-utilices-archivos-de-guardado-que-no-sean-tuyos-o-fueron-hechos-para-jugar-con-otras-condiciones","title":"3. No utilices archivos de guardado que no sean tuyos o fueron hechos para jugar con otras condiciones.","text":"<p>Incluso si tu archivo esta perdido/corrupto o necesitas un archivo de guardado de cierta parte en el juego por que se te paso algo.</p> <p>Ejemplos:</p> <ul> <li>Descargar un archivo de guardado en linea.</li> <li>Rogarle a un amigo que te mande su archivo de guardado por que se incendio tu casa y se perdieron todos tus archivos de la PC.</li> <li>Cargar un archivo de guardado que creaste en un emulador sin soporte para RA, a uno con soporte para RA.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#4-de-ninguna-manera-modifiques-ellos-archivos-o-memoria-del-juego","title":"4. De ninguna manera modifiques el(los) archivo(s) o memoria del juego.","text":"<p>Ejemplos:</p> <ul> <li>Abrir los archivos del juegos con un editor de texto/hex y cambiar los valores a tu gusto; editar propiedades para archivos del juego de \"solo-lectura\"; etc. </li> <li>Editar las estad\u00edsticas o desbloqueables del juego, y despu\u00e9s guardar tu partida.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#5-no-utilices-archivos-de-juego-o-programas-conocidos-como-trainers","title":"5. No utilices archivos de juego o programas conocidos como \"trainers\".","text":"<p>Programas que pueden potenciar tus poderes en juegos, desbloquear modo de desarrollador, aumentar la velocidad del juego, modificar el c\u00f3digo del juego, etc.</p> <p>Ejemplos:</p> <ul> <li>Utilizar un programa trainer para lo que sea.</li> <li>Utilizar ROMs modificados para cualquier juego (estos no ni siquiera deber\u00edan de ser linkeados).</li> <li>Utilizar emuladores no-oficiales/antiguos-mods que actuan como trainers o herramientas de desarrollo/cheats.</li> <li>Game Genie / Action Replay y cualquier otra herramienta de cheats similar.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#6-no-utilices-tas-tool-assisted-speedrunning-bots-o-escritura-compleja-para-conseguir-logros","title":"6. No utilices TAS (tool-assisted speedrunning), bots, o escritura compleja para conseguir logros.","text":"<p>Estos ya es scripting avanzado que va mas alla de tareas simples (algunas veces incluso sincronizado con la velocidad de reloj del procesador) para permitir que secciones del juegos que sean jugadas de una manera compleja/\u00fanica/o no-monotona/no-repetitiva y sin interacci\u00f3n humana alguna.</p> <p>Ejemplos:</p> <ul> <li>Utilizar TAS para completar un speedrun complicado o un logro de no morir.</li> <li>Utilizar un script complejo con funciones avanzadas.</li> <li>Utilizar scripts complejos que te completan un juego por completo o porciones grandes del juego sin ninguna interacci\u00f3n humana pero que requieren algunas acciones especiales.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#7-no-permitas-que-otra-gente-acceda-a-tu-cuenta-y-consiga-logros-por-ti","title":"7. No permitas que otra gente acceda a tu cuenta y consiga logros por ti.","text":"<p>Incluyendo tu \"hermano peque\u00f1o\" o tu \"primo\". Tu tienes que conseguir logros por ti mismo. Permitir que otra gente consiga logros en tu cuenta no esta permitido en general y si alguien hace trampa o rompe las reglas en tu cuenta tu vas a ser el responsable por sus acciones.</p> <p>Ejemplos:</p> <ul> <li>Permitir que un amigo que esta mas amaestrado en un juego complete secciones mas dif\u00edciles en un juego de single-player.</li> <li>Permitir que alguien inicie secci\u00f3n en tu cuenta para que pase alguna parte complicada de un juego por ti.</li> <li>Permitir que tu hermano peque\u00f1o trabaje en un logro de grindear por ti.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#8-no-seas-abusivoa-con-los-desarrolladores","title":"8. No seas abusivo/a con los desarrolladores.","text":"<p>Por medio del foro, Mensajes Privados, Discord, email, etc. Tienes permitido quejarte, solicitar cambios, dejar comentarios/rese\u00f1as negativas y otras criticas de manera respetuosa, pero tu das un nombre muy mal en la comunidad de cazadores de logros cuando hostigas/atacas a desarrolladores debido a lo que hicieron con los logros de su juego.</p> <p>Ejemplos: Mandar amenazas o insultos a desarrolladores porque agregaron logros a su juego que a ti no te gusta; utilizando una agresividad extrema/excesiva mientras exiges al desarrollador que remueva cambie los logros; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#9-no-crees-o-compartas-metodos-para-hacer-trampa","title":"9. No crees o compartas m\u00e9todos para hacer trampa.","text":"<p>Ejemplos:</p> <ul> <li>Ense\u00f1arle a laguien como utilizar herramientas de hackeado de memoria.</li> <li>Postear en los foros, promoviendo un metodo para editar un archivo de juego.</li> <li>Mandarle a alguien un link a una herramienta de hackeado de memoria o para programas trainer.</li> <li>Ense\u00f1arle a alguien como hacer trampa sin que se note.</li> <li>Crear un script complejo no-permitido y compartirlo inclusive si tu nunca lo utilizaste personalmente.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#10-no-utilices-codigos-dentro-del-juego-al-menos-que-sea-permitido-por-el-desarrollador","title":"10. No utilices c\u00f3digos dentro del juego al menos que sea permitido por el desarrollador.","text":"<p>El otro lado de la moneda para permitido 2. Cheat codes y modos debug no est\u00e1n permitidos mientras el desarrollador a hecho una nota en la que dice donde y cuando es permitido. Incluso si los logros son conseguibles con cheat codes este usualmente es un comportamiento no permitido, considerando que utilizaste cheats de una manera intencional, deber\u00edas de reportarlo como un bug con el sistema de tickets.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#permitido","title":"Permitido","text":"<ol> <li>Fast-forward esta permitido.</li> <li>Cuando dice explicitamente en la descripci\u00f3n de logro, cheat codes/modo dentro del juego est\u00e1n permitidos y herramientas de desarrollo/debug est\u00e1n permitidas.</li> <li>Hacer uso de glitches dentro del juego, exploits, y tacticas \"cheesy\" es permitido.</li> <li>Utilizar guias/walkthroughs en linea es permitido.</li> <li>Jugar juegos en co-op/competitivo con otro jugador o jugadores es permitido.</li> <li>Turbo esta permitido.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#1-fast-forward-esta-permitido","title":"1. Fast-forward esta permitido.","text":"<p>Incluso en modo hardcore el fast-forward esta permitido, como una conveniencia de la actualidad. Es casi un hecho de que el fast-forward ofrece una partida justa y por eso esta disponible para que todos lo utilicen.</p> <p>NOTA:en modo softcore savestates, rewind y camara-lenta tambi\u00e9n est\u00e1n permitidos, pero ten en cuenta que podrias llegar a tener algunos problemas. Checa este link de Porque no deber\u00edas de utilizar la funci\u00f3n de cargado de estado.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#2-cuando-dice-explicitamente-en-la-descripcion-de-logro-cheat-codesmodo-dentro-del-juego-estan-permitidos-y-herramientas-de-desarrollodebug-estan-permitidas","title":"2. Cuando dice explicitamente en la descripci\u00f3n de logro, cheat codes/modo dentro del juego est\u00e1n permitidos y herramientas de desarrollo/debug est\u00e1n permitidas.","text":"<p>Este es un complemento a la regla no permitida numero 2.</p> <p>El desarrollador de logros deber\u00eda de estar capacitado en proteger su trabajo para que estos no se desbloqueen f\u00e1cilmente simplemente ingresando cheat codes. Sin embargo, algunos retos muy cool y divertidos puedes ser creados si tomamos ventaja de los cheats. En estos casos en especifico, utilizar cheats del juego esta permitido.</p> <p>NOTA: si encuentras logros desbloqueables con uso de cheats y que en estos no este descrito que se puedan utilizar, considera abrir un ticket y reportarlo.</p> <p>Ejemplos:</p> <ul> <li>En Tetris (Game Boy) necesitas activar el c\u00f3digo de velocidad para conseguir el   logro Reto de los Dioses (Challenge of the Gods), donde necesitas limpiar 20 lineas en velocidad 19.</li> <li>En Guerrilla War (NES) tienes permitido utilizar el c\u00f3digo de \"selecci\u00f3n de niveles y dificultad\" para conseguir logros donde necesitas completar stages sin acecinar a ning\u00fan reh\u00e9n.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#3-hacer-uso-de-glitches-dentro-del-juego-exploits-y-tacticas-monotonas-cheesy-tactics-es-permitido","title":"3. Hacer uso de glitches dentro del juego, exploits, y t\u00e1cticas \"mon\u00f3tonas\" (cheesy tactics) es permitido.","text":"<p>Glitches/exploits/tacticas-mon\u00f3tonas esta permitido, aunque los desarrolladores pueden programar sus logros para desactivarlos. Esto es usualmente mencionado en la descripci\u00f3n del logro.</p> <p>Esto no incluye cuando hay fallas en el c\u00f3digo del logro del desarrollador. En esos casos, por favor crea un ticket de reporte, y consigue el logro como se supone que el desarrollador quer\u00eda que se obtuviera. Tambi\u00e9n mira regla no permitida 2.</p> <p>Ejemplos:</p> <ul> <li>Traspasar la colisi\u00f3n para evadir enemigos.</li> <li>Hacer algo raro dentro del juego para \"buggearlo de cierta manera\" y consigas invisibilidad.</li> <li>Conseguir items poderosos antes de lo intencionado.</li> <li>Ponerte en un lugar donde los enemigos no te puedan golpear.</li> </ul> <p>Ejemplos cuando los desarrolladores lo desabilitan: Megaman (NES) - vence a los jefes sin recibir da\u00f1o sin utilizar el glitch de pausa.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#4-utilizar-guiaswalkthroughs-en-linea-es-permitido","title":"4. Utilizar gu\u00edas/walkthroughs en linea es permitido.","text":"<p>Ejemplos: v\u00eddeo gu\u00edas de youtube; GameFAQs; soluciones de puzzles; lista de coleccionables; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#5-jugar-juegos-en-co-opcompetitivo-con-otro-jugador-o-jugadores-es-permitido","title":"5. Jugar juegos en co-op/competitivo con otro jugador o jugadores es permitido.","text":"<p>Jugar co-op esta permitido, sin embargo los desarrolladores pueden codificar sus logros para desactivarlo. Esto es usualmente mencionado en la descripci\u00f3n del logro.</p> <p>Tambi\u00e9n mira regla no permitida 2.</p> <p>Ejemplos: un amigo con experiencia jugando Streets of Rage o Goof Troop contigo; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#6-turbo-esta-permitido","title":"6. Turbo esta permitido.","text":"<p>Turbo es cuando dejas presionado solamente un bot\u00f3n y el bot\u00f3n es autom\u00e1ticamente presionado una y otra vez. Esta funci\u00f3n ya sea que esta integrada en el control, o en el emulador. En los dos de los casos esta permitido.</p> <p>En casos en los que hay un scripting mas complejo aparte de solamente presionar un bot\u00f3n repetidamente, esto ya no esta permitido. Mira regla No Permitida 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#sanciones-por-hacer-trampa","title":"Sanciones por hacer trampa","text":"<p>Cuando se detecte que se hace trampa, la cuenta va a ser puesta como Untracked. Hay algunos casos en donde la cuenta puede llegar a ser banneada.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#como-limpiar-tu-nombre-y-apelar-el-hacer-trampa","title":"Como limpiar tu nombre y apelar el hacer trampa","text":"<p>La manera mas r\u00e1pida: Resetea todos tus puntos. Si fuiste previamente puesto como untracked y te gustar\u00eda que se te regresara al estado normal por favor informalo con RAdmin para que tomen la acci\u00f3n necesaria.</p> <p>Si tienes maneras de demostrar que jugabas sin hacer trampa, manda un mensaje a RAdmin, pero ten en cuenta que todo el staff de RA son voluntarios y puede llegar a tomar un tiempo para que revisen tu caso.</p> <p>Si deseas tener la iniciativa de admitir que hac\u00edas trampa, esto es realmente apreciado y se toma en consideraci\u00f3n durante tu caso.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#si-necesitas-ayuda","title":"Si necesitas ayuda","text":"<p>Si alguna vez tuviste una pregunta, comentario, o sugerencias - si\u00e9ntete libre de contactar a RAdmin o al staff de RA (@mods y @admins) en el servidor de discord.</p> <p>Estas reglas ser\u00e1n corregidas cada cierto tiempo si esto es requerido.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#agradecimientos-especiales","title":"Agradecimientos Especiales","text":"<p>Este documento esta fuertemente basado en las reglas de caser\u00eda de logros de 100Pals. Aunque esta versi\u00f3n esta un poco mas resumida y modificada con temas relevantes en cuanto al contexto de RetroAchievements.</p> <p>100Pals es una comunidad con cazadores de logros experimentados que existe desde que los logros fueron implementados en Steam por primera vez en 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:28] meleu:</code> fix link</li> <li><code>[2019-06-03 10:27] meleu:</code> fix broken link</li> <li><code>[2019-05-31 10:09] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-31 10:08] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-31 10:05] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-30 10:50] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-29 11:34] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-27 11:41] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-26 15:27] eldexterr:</code> Created Global Leaderboard and Achievement Hunting Rules es (markdown)</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/","title":"Global Leaderboard and Achievement Hunting Rules fr [In progress]","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#tlpl-regles-dor","title":"TL;PL - R\u00e8gles d'or","text":"<p>Les participants du Classement global doivent gagner leurs succ\u00e8s de mani\u00e8re l\u00e9gitime et dans les r\u00e8gles.</p> <p>De mani\u00e8re g\u00e9n\u00e9rale, un joueur doit d\u00e9bloquer des succ\u00e8s :</p> <ol> <li>en utilisant la derni\u00e8re version en date d'un \u00e9mulateur approuv\u00e9 ;</li> <li>en jouant \u00e0 un jeu directement ;</li> <li>par ses propres moyens ;</li> <li>sans utiliser de fichiers tiers ou de codes permettant de modifier le jeu ;</li> <li>sans utiliser la sauvegarde d'un autre joueur ou des mots-de-passe, et ;</li> <li>sans utiliser de logiciels tiers de tricherie.</li> </ol> <p>Ces r\u00e8gles ont \u00e9t\u00e9 con\u00e7ues pour maintenir une comp\u00e9tition dans le Classement global dont l'objectif est de maintenir une honn\u00eatet\u00e9 envers soi-m\u00eame et ses capacit\u00e9s de jeu et envers tous les autres joueurs.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#table-des-matieres","title":"Table des mati\u00e8res","text":"<ul> <li>Classement global</li> <li>Mode Hardcore</li> <li>Non class\u00e9s</li> <li>Interdit</li> <li>Ce qui est permis</li> <li>Sanctions pour tricherie</li> <li>Comment effacer l'ardoise ou faire appel de tricherie</li> <li>Si vous avez besoin d'aide</li> <li>Remerciements sp\u00e9ciaux</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#classement-global","title":"Classement global","text":"<p>Le classement global de RetroAchievements est la comp\u00e9tition officielle \u00e0 laquelle participe toute la communaut\u00e9. Cela se traduit sur le site par un unique rang au sein de la communaut\u00e9 bas\u00e9 sur la somme des points des succ\u00e8s acquis. Chaque compte dont les points sont sup\u00e9rieurs \u00e0 500 est concern\u00e9.</p> <p>Au sein du classement global, ce qui est consid\u00e9r\u00e9 comme l\u00e9gitime et dans les r\u00e8gles par opposition \u00e0 ill\u00e9gitime (tricherie) a \u00e9t\u00e9 fa\u00e7onn\u00e9 continuellement par la communaut\u00e9 depuis les origines. Il est attendu que les r\u00e8gles ci-dessous doivent \u00eatre respect\u00e9es par tous les joueurs souhaitant participer au syst\u00e8me de classement global. Tout indice menant \u00e0 la conclusion qu'un joueur n'aurait pas respect\u00e9 ces r\u00e8gles entra\u00eenera la bascule du compte parmi les Non class\u00e9s.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#mode-hardcore","title":"Mode Hardcore","text":"<p>Le mode Hardcore est une fonctionnalit\u00e9 qui permet \u00e0 l'\u00e9mulateur de d\u00e9sactiver TOUS les retours en arri\u00e8res, ralentissements et sauvegardes d'\u00e9tat. La fonctionnalit\u00e9 d'acc\u00e9l\u00e9ration est la seule exception accept\u00e9e.</p> <p>Lorsque vous jouez en mode Hardcore, vous gagnez le double des points initialement pr\u00e9vus pour le succ\u00e8s. Donc si une s\u00e9rie de succ\u00e8s vaut 400 points et que vous la compl\u00e9tez en mode Hardcore, vous gagnerez 800 points.</p> <p>Les joueurs qui prennent le classement global au s\u00e9rieux compl\u00e8teront sans aucun doute les s\u00e9ries de succ\u00e8s en mode Hardcore pour obtenir plus de points.</p> <p>NOTE : si vous d\u00e9sactivez le mode Hardcore (ce qu'on appelle le mode \"softcore\"), attendez-vous \u00e0 avoir des probl\u00e8mes. Consultez le lien :  Pourquoi il ne faut pas utiliser le chargement d'\u00e9tat.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#non-classes","title":"Non class\u00e9s","text":"<p>Un compte non class\u00e9 n'appara\u00eet plus dans le classement global, son activit\u00e9 dispara\u00eet du fil et il n'est plus list\u00e9 parmi les joueurs ayant acquis chaque succ\u00e8s (sur la page du succ\u00e8s). Tout ce qui le concerne n'est plus public.</p> <p>Cependant, un compte non class\u00e9 peut encore profiter de RetroAchievements et gagner des badges pour avoir compl\u00e9t\u00e9 des jeux.</p> <p>Ce statut a \u00e9t\u00e9 cr\u00e9\u00e9 pour que chacun puisse faire ce qu'il veut avec son compte (comme tricher, partager son compte avec des amis ou de la famille) sans pour autant fausser l'aspect comp\u00e9titif du classement global. Donc, si vous appr\u00e9ciez RetroAchievements mais ne souhaitez pas participer \u00e0 la comp\u00e9tition du classement global, vous pouvez demander \u00e0 basculer votre compte en non class\u00e9. Il suffit d'envoyer un message \u00e0 RAdmin.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#interdit","title":"Interdit","text":"<ol> <li>Ne pas utiliser de m\u00e9thode qui contournerait le code du succ\u00e8s afin de le d\u00e9bloquer instantan\u00e9ment. .</li> <li>Ne pas gagner le succ\u00e8s d'une mani\u00e8re qui n'a pas \u00e9t\u00e9 pr\u00e9vue par le d\u00e9veloppeur de succ\u00e8s.</li> <li>Ne pas utiliser de sauvegardes ou mots de passe fournis par un autre joueur ou issus de conditions de jeu diff\u00e9rentes.</li> <li>Ne pas modifier les fichiers du jeu ou la m\u00e9moire par quelque moyen que ce soit.</li> <li>Ne pas utiliser de fichiers de jeu ou de logiciels connus comme \u00e9tant des \"trainers\".</li> <li>Ne pas utiliser de TAS (tool-assisted speedrunning), bots, ou scripts complexe pour d\u00e9bloquer des succ\u00e8s.</li> <li>Ne pas partager son compte pour que d'autres d\u00e9bloquent des succ\u00e8s \u00e0 votre place.</li> <li>Ne soyez pas insultant avec les d\u00e9veloppeurs.</li> <li>Ne cr\u00e9ez et partagez aucune m\u00e9thode de tricherie.</li> <li>N'utilisez pas de code de tricherie \u00e0 moins que ce ne soit sp\u00e9cifiquement permis par le d\u00e9veloppeur.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#1-ne-pas-utiliser-de-methode-qui-contournerait-le-code-du-succes-afin-de-le-debloquer-instantanement","title":"1. Ne pas utiliser de m\u00e9thode qui contournerait le code du succ\u00e8s afin de le d\u00e9bloquer instantan\u00e9ment.","text":"<p>M\u00eame si vous \"auriez d\u00fb\" le d\u00e9bloquer. M\u00eame si le jeu est bogu\u00e9. M\u00eame si le succ\u00e8s est retir\u00e9 ou qu'il ne fonctionne plus. Lorsque c'est d\u00e9tect\u00e9, le compte incrimin\u00e9 bascule dans les comptes Non class\u00e9s.</p> <p>Si vous deviez d\u00e9bloquer un succ\u00e8s, mais que \u00e7a n'a pas \u00e9t\u00e9 le cas, ou que l'enregistrement sur le site Internet n'a pas eu lieu \u00e0 cause de probl\u00e8me r\u00e9seau, vous devez suivre la proc\u00e9dure d\u00e9crite dans la FAQ pour d\u00e9bloquer un succ\u00e8s manuellement.</p> <p>NOTE : Assurez-vous de bien utiliser la derni\u00e8re version en date de l'\u00e9mulateur approuv\u00e9.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#2-ne-pas-gagner-le-succes-dune-maniere-qui-na-pas-ete-prevue-par-le-developpeur-de-succes","title":"2. Ne pas gagner le succ\u00e8s d'une mani\u00e8re qui n'a pas \u00e9t\u00e9 pr\u00e9vue par le d\u00e9veloppeur de succ\u00e8s.","text":"<p>Si vous d\u00e9couvrez une porte d\u00e9rob\u00e9e pour accomplir un succ\u00e8s, signalez-la en envoyant un rapport.</p> <p>Consultez aussi Ce qui est permis 2.</p> <p>Exemples : </p> <ul> <li>Vous d\u00e9bloquez un succ\u00e8s pour avoir fini un niveau en utilisant un code de tricherie de s\u00e9lection de niveau. C'est un bogue qui doit \u00eatre rapport\u00e9 et corrig\u00e9.</li> <li>Vous d\u00e9clenchez un succ\u00e8s de progression de niveau en revenant en arri\u00e8re puis en avant entre deux salles.</li> <li>Vous d\u00e9couvrez un moyen de faire un succ\u00e8s 0 dommages sur un boss alors que vous en prenez.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#3-ne-pas-utiliser-de-sauvegardes-ou-mots-de-passe-fournis-par-un-autre-joueur-ou-issus-de-conditions-de-jeu-differentes","title":"3. Ne pas utiliser de sauvegardes ou mots de passe fournis par un autre joueur ou issus de conditions de jeu diff\u00e9rentes.","text":"<p>\u00c0 l'occasion, un d\u00e9veloppeur peut \u00e9ventuellement fournir une sauvegarde ou un mot de passe afin de d\u00e9bloquer un succ\u00e8s. C'est appropri\u00e9 dans le sens o\u00f9 c'est le d\u00e9veloppeur qui l'a d\u00e9cid\u00e9 ainsi.</p> <p>Exemples :</p> <ul> <li>T\u00e9l\u00e9charger une sauvegarde d'un jeu \u00e0 clics.</li> <li>Supplier un ami pour qu'il vous envoie sa sauvegarde car votre maison a br\u00fbl\u00e9 et vous avez perdu tous vos fichiers.</li> <li>Utiliser une sauvegarde en Hardcore que vous avez cr\u00e9\u00e9e sur un \u00e9mulateur non support\u00e9 par RA.</li> <li>Utiliser une sauvegarde en Hardcore cr\u00e9\u00e9e en Softcore pour gagner des points suppl\u00e9mentaires.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#4-ne-pas-modifier-les-fichiers-du-jeu-ou-la-memoire-par-quelque-moyen-que-ce-soit","title":"4. Ne pas modifier les fichiers du jeu ou la m\u00e9moire par quelque moyen que ce soit.","text":"<p>Exemples :</p> <ul> <li>Ouvrir les fichiers d'un jeu avec un \u00e9diteur de texte ou hexad\u00e9cimal et changer une valeur pour obtenir ce que l'on veut, changer les propri\u00e9t\u00e9s d'un fichier et notamment \"lecture seule\", etc. </li> <li>Modifier dans un jeu les statistiques ou l'avancement et sauvegarder les donn\u00e9es.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#5-ne-pas-utiliser-de-fichiers-de-jeu-ou-de-logiciels-connus-comme-etant-des-trainers","title":"5. Ne pas utiliser de fichiers de jeu ou de logiciels connus comme \u00e9tant des \"trainers\".","text":"<p>Les logiciels qui peuvent augmenter votre puissance en jeu, d\u00e9bloquer les modes d\u00e9bogage, acc\u00e9l\u00e9rer le jeu, modifier le code du jeu, etc.</p> <p>Exemples :</p> <ul> <li>Utiliser un logiciel \"trainer\" pour quoi que ce soit.</li> <li>Utiliser une ROM modifi\u00e9e (\"trainer\") qu'importe le jeu (elle ne sera pas associ\u00e9e \u00e0 la s\u00e9rie de succ\u00e8s).</li> <li>Utiliser un \u00e9mulateur non officiel, un vieux mod qui agit comme un \"trainer\" ou comme outil de d\u00e9bogage ou de tricherie.</li> <li>Game Genie / Action Replay et tout autre outil similaire de tricherie.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#6-ne-pas-utiliser-de-tas-tool-assisted-speedrunning-bots-ou-scripts-complexe-pour-debloquer-des-succes","title":"6. Ne pas utiliser de TAS (tool-assisted speedrunning), bots, ou scripts complexe pour d\u00e9bloquer des succ\u00e8s.","text":"<p>Il s'agit de scripts avanc\u00e9s pour le jeu qui vont bien au-del\u00e0 de la simple fonction (parfois li\u00e9e \u00e0 l'horloge interne) qui permettent de maintenir une activit\u00e9 complexe et unique en jeu sans interaction humaine et qui ne suivent pas un sch\u00e9ma r\u00e9current.</p> <p>Exemples :</p> <ul> <li>utiliser un TAS pour accomplir un speedrun difficile ou un succ\u00e8s 0 mort.</li> <li>utiliser un script complexe avec des fonctionnalit\u00e9s avanc\u00e9es.</li> <li>utiliser un script complexe impliquant des actions uniques qui finit de larges portions du jeu voire le jeu compl\u00e8tement sans intervention humaine.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#7-ne-pas-partager-son-compte-pour-que-dautres-debloquent-des-succes-a-votre-place","title":"7. Ne pas partager son compte pour que d'autres d\u00e9bloquent des succ\u00e8s \u00e0 votre place.","text":"<p>M\u00eame votre \"petit fr\u00e8re\" ou votre \"cousin\". Vous devez d\u00e9bloquer les succ\u00e8s par vous-m\u00eame. Laisser d'autres personnes d\u00e9bloquer des succ\u00e8s sur votre compte n'est pas permis et si quelqu'un d'autre que vous triche ou enfreint les r\u00e8gles sur votre compte, c'est vous qui serez tenu pour responsable.</p> <p>Exemples :</p> <ul> <li>Un ami plus talentueux d\u00e9bloque une partie difficile du jeu.</li> <li>Laisser quelqu'un se connecter \u00e0 votre compte pour compl\u00e9ter une partie difficile d'un jeu.</li> <li>Laisser votre petit fr\u00e8re s'occuper du farm d'un succ\u00e8s.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#8-ne-soyez-pas-insultant-avec-les-developpeurs","title":"8. Ne soyez pas insultant avec les d\u00e9veloppeurs.","text":"<p>Via forums, MPs, discord, courriel, etc. Vous n'\u00eates pas autoris\u00e9 \u00e0 vous plaindre, solliciter des changements, poster des analyses ou commentaires n\u00e9gatifs ou tout autre critique irrespectueuse. En attaquant, harcelant les d\u00e9veloppeurs au sujet de leur travail sur les succ\u00e8s, c'est notre image au sein de la communaut\u00e9 des chasseurs de succ\u00e8s que vous salissez.</p> <p>Exemples : Poster des menaces ou des insultes flagrante envers un d\u00e9veloppeur pour avoir ajouter \u00e0 un jeu un succ\u00e8s que vous n'aimez pas. Faire preuve d'incivilit\u00e9 en demandant \u00e0 un d\u00e9veloppeur de retirer ou modifier un succ\u00e8s, etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#9-ne-creez-et-partagez-aucune-methode-de-tricherie","title":"9. Ne cr\u00e9ez et partagez aucune m\u00e9thode de tricherie.","text":"<p>Exemples :</p> <ul> <li>Enseigner \u00e0 quelqu'un comment utiliser des outils de piratage de m\u00e9moire.</li> <li>Poster sur le forum pour promouvoir une m\u00e9thode flagrante d'\u00e9dition.</li> <li>Envoyer \u00e0 quelqu'un un lien vers des outils de piratage de m\u00e9moire ou un programme \"trainers\".</li> <li>Apprendre \u00e0 quelqu'un comment tricher et s'en cacher.</li> <li>Cr\u00e9er un script complexe non autoris\u00e9 et le partager m\u00eame si vous ne l'avez jamais utilis\u00e9 vous-m\u00eame.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#10-nutilisez-pas-de-code-de-tricherie-a-moins-que-ce-ne-soit-specifiquement-permis-par-le-developpeur","title":"10. N'utilisez pas de code de tricherie \u00e0 moins que ce ne soit sp\u00e9cifiquement permis par le d\u00e9veloppeur.","text":"<p>Le c\u00f4t\u00e9 face de Ce qui est permis 2. Les codes de tricherie et les modes de d\u00e9bogage ne sont pas permis \u00e0 moins que le d\u00e9veloppeur n'ait indiqu\u00e9 le contraire et dans quelles conditions. M\u00eame si les succ\u00e8s sont d\u00e9blocables via un code de tricherie, il ne s'agit pas d'un comportement attendu et consid\u00e9r\u00e9 comme de la tricherie si intentionnel. Cela doit \u00eatre signal\u00e9 en tant que bogue via le syst\u00e8me de signalement.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#ce-qui-est-permis","title":"Ce qui est permis","text":"<ol> <li>L'acc\u00e9l\u00e9ration du jeu est permise.</li> <li>Lorsque la description du succ\u00e8s l'indique explicitement, les codes/modes de tricherie et les outils de d\u00e9bogage sont autoris\u00e9s.</li> <li>Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis.</li> <li>Utiliser un guide en ligne est permis.</li> <li>Jouer \u00e0 un jeu comp\u00e9titif/co-op avec un ou plusieurs joueurs est autoris\u00e9.</li> <li>Le Turbo est autoris\u00e9.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#1-lacceleration-du-jeu-est-permise","title":"1. L'acc\u00e9l\u00e9ration du jeu est permise.","text":"<p>M\u00eame en mode hardcore, l'acc\u00e9l\u00e9ration du jeu est autoris\u00e9e en tant que commodit\u00e9 moderne. Il est commun\u00e9ment admis que l'acc\u00e9l\u00e9ration ne pr\u00e9sente pas de risque de fausser le classement. Elle est donc disponible pour tous.</p> <p>NOTE : en mode softcore les sauvegardes d'\u00e9tat, les retours en arri\u00e8re et les ralentissements sont autoris\u00e9s, mais attendez vous \u00e0 des probl\u00e8mes. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#2-lorsque-la-description-du-succes-lindique-explicitement-les-codesmodes-de-tricherie-et-les-outils-de-debogage-sont-autorises","title":"2. Lorsque la description du succ\u00e8s l'indique explicitement, les codes/modes de tricherie et les outils de d\u00e9bogage sont autoris\u00e9s.","text":"<p>Vient en compl\u00e9ment de Interdit 2.</p> <p>Les d\u00e9veloppeurs de succ\u00e8s ont pour instruction de prot\u00e9ger leur travail de telle sorte que le succ\u00e8s ne puisse \u00eatre simplement d\u00e9bloqu\u00e9 par un code de tricherie. Toutefois, quelques challenges cools et funs peuvent \u00eatre cr\u00e9\u00e9s en exploitant des m\u00e9thodes de tricherie. Dans ce cas particulier, les m\u00e9thodes de tricherie sont autoris\u00e9es.</p> <p>NOTE: si vous d\u00e9couvrez qu'un succ\u00e8s est d\u00e9blocable en trichant sans que ce soit indiqu\u00e9 dans son descriptif, proc\u00e9dez \u00e0 un signalement.</p> <p>Examples :</p> <ul> <li>Dans Tetris (Game Boy) vous pouvez activer la tricherie d'acc\u00e9l\u00e9ration pour d\u00e9bloquer le succ\u00e8s Challenge of the Gods, pour lequel vous devez nettoyer 20 lignes \u00e0 la vitesse 19.</li> <li>Dans Guerrilla War (NES) vous \u00eates autoris\u00e9s \u00e0 utiliser l'\u00e9cran de s\u00e9lection des niveaux et de difficult\u00e9 pour d\u00e9bloquer le succ\u00e8s pour lequel vous devez finir des niveaux sans tuer d'otages.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#3-utiliser-des-glitchs-exploits-ou-des-strategies-non-prevues-mais-efficaces-est-permis","title":"3. Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis.","text":"<p>Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis, cependant les d\u00e9veloppeurs peuvent l'emp\u00eacher dans le code. C'est g\u00e9n\u00e9ralement indiqu\u00e9 dans la description du succ\u00e8s.</p> <p>Cette r\u00e8gle n'est pas valable dans le cas de pr\u00e9sence de failles dans le code du d\u00e9veloppeur. Dans ce cas pr\u00e9cis, proc\u00e9dez \u00e0 un signalement et d\u00e9bloquez le succ\u00e8s comme pr\u00e9vu initialement par le d\u00e9veloppeur. Consultez aussi Interdit 2.</p> <p>Exemples :</p> <ul> <li>Franchir les limites permises par le jeu pour \u00e9viter des ennemis.</li> <li>Faire quelque chose d'\u00e9trange dans un jeu afin de le faire buguer et devenir invincible.</li> <li>Obtenir des objets puissant plus t\u00f4t que pr\u00e9vu.</li> <li>Se positionner hors de port\u00e9e des ennemis tout en pouvant les toucher.</li> </ul> <p>Exemple pour lequel les d\u00e9veloppeurs l'emp\u00eachent: Megaman (NES) - battre les boss sans prendre de d\u00e9g\u00e2ts sans utiliser le glitch de la pause.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#4-utiliser-un-guide-en-ligne-est-permis","title":"4. Utiliser un guide en ligne est permis..","text":"<p>Exemples: guides vid\u00e9o sur Youtube; GameFAQs; solutions d'enigmes; listes d'objets \u00e0 collectionner.</p> <p>Pr\u00e9cision d'honn\u00eatet\u00e9: Utiliser un r\u00e9solveur pour sudoku/picross est consid\u00e9r\u00e9 comme de la tricherie. De la tricherie qu'on ne peut punir et donc tol\u00e9r\u00e9e mais de la tricherie tout de m\u00eame.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#5-jouer-a-un-jeu-competitifco-op-avec-un-ou-plusieurs-joueurs-est-autorise","title":"5. Jouer \u00e0 un jeu comp\u00e9titif/co-op avec un ou plusieurs joueurs est autoris\u00e9.","text":"<p>Jouer \u00e0 un jeu en co-op est autoris\u00e9. Cependant, les d\u00e9veloppeurs peuvent l'emp\u00eacher dans le code du succ\u00e8s. C'est g\u00e9n\u00e9ralement indiqu\u00e9 dans la description du succ\u00e8s.</p> <p>Consultez aussi Interdit 2.</p> <p>Exemples : un ami talentueux qui joue \u00e0 Streets of Rage ou Goof Troop avec vous; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#6-le-turbo-est-autorise","title":"6. Le Turbo est autoris\u00e9.","text":"<p>Le Turbo, c'est quand vous pressez un bouton et qu'il est automatiquement press\u00e9 de nouveau de mani\u00e8re r\u00e9p\u00e9titive et rapide. Le Turbo est soit inclus avec une manette soit logiciel avec l'\u00e9mulateur. Dans les deux cas, c'est autoris\u00e9.</p> <p>Dans le cas o\u00f9 un script plus complexe (plus qu'un bouton) est r\u00e9p\u00e9t\u00e9, ce n'est pas autoris\u00e9. Consultez Interdit 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#sanctions-pour-tricherie","title":"Sanctions pour tricherie","text":"<p>Aussit\u00f4t qu'une tricherie aura \u00e9t\u00e9 d\u00e9tect\u00e9e, le compte sera bascul\u00e9 dans la cat\u00e9gorie Non class\u00e9. Dans certains cas, le compte sera banni.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#comment-effacer-lardoise-ou-faire-appel-de-tricherie","title":"Comment effacer l'ardoise ou faire appel de tricherie","text":"<p>Le moyen le plus rapide : remise \u00e0 0 de tous vos points. Si votre compte a \u00e9t\u00e9 bascul\u00e9 dans les non class\u00e9s et que vous souhhaitez l'annuler, merci d'informer Radmin de votre action.</p> <p>ATTENTION : d\u00e9bloquer des succ\u00e8s en utilisant des m\u00e9thodes non support\u00e9es par l'\u00e9mulateur entra\u00eene le basculement du compte dans les non class\u00e9s. Quand cela arrive, la seule solution pour revenir dans le classement global est de supprimer l'int\u00e9gralit\u00e9 des succ\u00e8s de votre compte. Il n'y aura pas ni recours ni exceptions.</p> <p>Si vous avez des preuves que vous avez jou\u00e9 sans tricher, envoyez un message \u00e0 RAdmin, mais gardez \u00e0 l'esprit que l'\u00e9quipe RA sont tous volontaires et que cela peut prendre du temps pour que votre situation soit \u00e9tudi\u00e9e.</p> <p>Si vous voulez aller de l'avant et admettre d'avoir trich\u00e9, un tel comportement sera grandement appr\u00e9ci\u00e9 et nous en tiendrons compte pour la d\u00e9cision.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#besoin-daide","title":"Besoin d'aide","text":"<p>Si vous avez des questions, un commentaire, des suggestions n'h\u00e9sitez pas \u00e0 contacter RAdmin ou l'\u00e9quipe RA (@mods and @admins) sur notre serveur Discord.</p> <p>Ces r\u00e8gles seront modifi\u00e9es \u00e0 l'occasion quand le besoin s'en fera sentir.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#remerciements-speciaux","title":"Remerciements sp\u00e9ciaux","text":"<p>Ce document est fortement inspir\u00e9 de 100Pals Unified Achievement Hunting Rules. Cette version a \u00e9t\u00e9 adapt\u00e9e au contenu de RetroAchievements.</p> <p>100Pals est une communaut\u00e9 de chasseurs de succ\u00e8s exp\u00e9riment\u00e9s qui existe depuis la sortie des premiers succ\u00e8s sur Steam en 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/","title":"Global Leaderboard and Achievement Hunting Rules","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#tldr-golden-rules","title":"TL;DR - Golden Rules","text":"<p>Participants of the Global Leaderboard are required to earn their achievements fairly and legitimately.</p> <p>In general, a player must unlock achievements: - Uusing the latest release version of an approved supported emulator; - Inside of a game by in-game actions; - By their own control; - Without outside-modifying game files or game code; - Without using another player\u2019s save files or passwords, and; - Without using outside cheat programs.</p> <p>These rules are designed to keep players honest in their gameplay and honest towards each other in Global Leaderboard competition.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#table-of-contents","title":"Table of Contents","text":"<ul> <li>Global Leaderboard</li> <li>Hardcore vs Softcore</li> <li>Untracked</li> <li>Not Allowed</li> <li>Allowed</li> <li>Special Thanks</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#global-leaderboard","title":"Global Leaderboard","text":"<p>The RetroAchievements global leaderboard is the main official community competition. This includes a unique site rank based on the sum of achievement points earned in comparison with every other ranked player. Each account with points greater than 0 is ranked by default.</p> <p>What is considered fair and legitimate play versus unfair (cheating) on the global leaderboard has been shaped continually by the community since it's inception. The rules below are what we expect from every player who would like to participate in the ranking system. Any indication of a player's failure to follow the rules herein may lose use of the global leaderboard, also known as Untracked status.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#hardcore-vs-softcore","title":"Hardcore vs Softcore","text":"<p>There are two modes of play: Hardcore and Softcore. - Hardcore mode is a feature where the emulator disables save state loading, rewind and slow motion. The fast-forward feature is the only accepted exception. Users who take the global leaderboard seriously will most likely earn achievements in hardcore. Also, events will almost always require achievements to be earned in Hardcore.   - Note: Creating save states is allowed in hardcore and can be done to help practice an area later on in softcore, or help developers resolve tickets. - Softcore mode allows for emulator features such as save states, rewind, slow motion, emulator cheats, etc. This mode is much less competitive and is geared toward players who just want to do their own thing. This mode can be somewhat problematic when it comes to achievement processing; therefore, error reports are often taken with a grain of salt.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#untracked","title":"Untracked","text":"<p>Users who have the Untracked status are omitted from all rankings. Their activity is hidden from view outside of their user page and their unlocks do not affect achievement statistics. This status is for users who share their accounts, have zero interest in hardcore and softcore rankings, are suspected of cheating, or actually are cheating. Untracked users can still earn achievements how they normally would, obtain mastery badges, etc. </p> <p>Voluntary untracks can be reversed by resetting all progress and contacting RAdmin.</p> <p>Involuntary untracks are generally the result of being flagged for suspicious timestamps. If your account becomes untracked, you can contact RAdmin to find out the cause and how to get it reversed.</p> <p>If you notice a player has become untracked: do not harass them, accuse them of cheating, make a public scene, etc. Do not ask moderators or admin why a user was untracked. It is none of your business.</p> <p>WARNING: Unlocking achievements using methods outside supported emulators results in having your account set as untracked. When this happens, the only way to be on the global leaderboard again is by doing a full reset of all achievements on your profile. There are no exceptions and no appeals. Severe cases of this can also result in a ban.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#not-allowed","title":"Not Allowed","text":"<ol> <li>Do not use methods that circumvent achievement code to instantly unlock achievements.</li> <li>Do not earn achievements in a way that contradicts what the description asks.</li> <li>Do not use save files or passwords that are not your own or were made by under other conditions of play.</li> <li>Do not modify the game's file(s) or memory by any means.</li> <li>Do not use game files or programs known as \"trainers\".</li> <li>Do not use TAS (tool-assisted speedrunning), bots, or complex scripting to gain achievements.</li> <li>Do not allow other people to access your account and earn achievements for you.</li> <li>Do not be abusive to developers.</li> <li>Do not create or share cheating methods.</li> <li>Do not use in-game cheat codes unless it is specified as allowed by the developer.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#1-do-not-use-methods-that-circumvent-achievement-code-to-instantly-unlock-achievements","title":"1. Do not use methods that circumvent achievement code to instantly unlock achievements.","text":"<p>Even if you \"should have\" unlocked the achievement. Even if the game is bugged. Even if the achievement is removed or broken entirely. When it's detected, it will lead the account to be Untracked.</p> <p>In the cases where you should have unlocked the achievement but it didn't trigger or it didn't get registered in the site due to a network problem, you should follow the steps described in FAQ to request a manual unlock.</p> <p>NOTE: make sure you are using the latest release version of an approved supported emulator.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#2-do-not-earn-achievements-in-a-way-that-contradicts-what-the-description-asks","title":"2. Do not earn achievements in a way that contradicts what the description asks.","text":"<p>If you discover a back-door to an achievement, it is a bug. Please report this bug using a ticket report.</p> <p>See also the allowed rule 2.</p> <p>Examples: </p> <ul> <li>You unlock achievements for finishing levels via a level select cheat code; it's a bug and must be reported/fixed.</li> <li>You notice that if you go back and forth between two rooms, you unlock achievements intended for progressing though the game.</li> <li>You've found a method of earning damageless boss achievements while taking damage during the fights.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#3-do-not-use-save-files-or-passwords-that-are-not-your-own-or-were-made-under-other-conditions-of-play","title":"3. Do not use save files or passwords that are not your own or were made under other conditions of play.","text":"<p>Occasionally a developer might provide a save file or password for you to use to earn certain achievements. This is appropriate according to the judgement of the set developer.</p> <p>Examples:</p> <ul> <li>Downloading a clicker game save online.</li> <li>Begging a friend to send you his save file because your house burned down and you lost all your PC files.</li> <li>Loading a save file for Hardcore you created while playing on a non-RA emulator.</li> <li>Loading a save file for Hardcore you created in Softcore in order to gain Hardcore points.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#4-do-not-modify-the-games-files-or-memory-by-any-means","title":"4. Do not modify the game's file(s) or memory by any means.","text":"<p>Examples:</p> <ul> <li>Opening up specific game files with a text/hex editor and changing values to what you want; editing properties such as \"read-only\" for game files; etc. </li> <li>Editing the stats or unlocks in a game, and then saving the data.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#5-do-not-use-game-files-or-programs-known-as-trainers","title":"5. Do not use game files or programs known as \"trainers\".","text":"<p>Programs which can boost your powers in games, unlock debug modes, speed the game up, modify game code, etc.</p> <p>Examples:</p> <ul> <li>Using a trainer program for anything.</li> <li>Using trained ROMs for any game (they will not be linked).</li> <li>Using unofficial/old mods/emulators that act as trainers or debug/cheat toolsets.</li> <li>Game Genie / Action Replay and other similar cheat tools.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#6-do-not-use-tas-tool-assisted-speedrunning-bots-or-complex-scripting-to-gain-achievements","title":"6. Do not use TAS (tool-assisted speedrunning), bots, or complex scripting to gain achievements.","text":"<p>These are all advanced scripting of a game far beyond simple tasks (sometimes even synced to clockspeed) to allow complex, unique, and/or non-monotonous/non-repetitive sections of a game to be played without human interaction.</p> <p>Examples:</p> <ul> <li>using a TAS to complete a difficult speedrun or no-death achievement.</li> <li>using a complex script with advanced functionality.</li> <li>using complex scripts that complete entire games or large portions of games with no human input but requiring many unique actions.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#7-do-not-allow-other-users-to-access-your-account-and-earn-achievements-for-you","title":"7. Do not allow other users to access your account and earn achievements for you.","text":"<p>Including your \"little brother\" or your \"cousin\". You must earn your achievements yourself. Letting people earn achievements on your account is not allowed in general and if anyone cheats or breaks the rules on your account, you will still be held accountable.</p> <p>Examples:</p> <ul> <li>Having a friend who is more skilled at a game complete a difficult section for you in a single-player game.</li> <li>Letting someone log into your RA account to beat a difficult part of a game for you.</li> <li>Letting your little brother work on a grindy achievement for you.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#8-do-not-be-abusive-to-developers","title":"8. Do not be abusive to developers","text":"<p>Via forums, PMs, discord, email, etc. You\u2019re allowed to complain, ask for changes, leave negative reviews/comments and other such respectful criticisms, but you give all of us in the achievement hunting community a really bad name when you harass/attack developers because of what they did to their game\u2019s achievements.</p> <p>Examples: Issuing threats or flagrant insults to devs because they added achievements to their game that you do not like; using extreme/excessive rudeness while demanding a developer remove or change achievements; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#9-do-not-create-or-share-cheating-methods","title":"9. Do not create or share cheating methods.","text":"<p>Examples:</p> <ul> <li>Teaching someone how to use memory hacking tools.</li> <li>Posting on the forums to promote an egregious game file edit method.</li> <li>Sending someone a link to memory hacking tools or trainer programs.</li> <li>Teaching someone how to hide cheating.</li> <li>Creating a non-allowed complex script and sharing it around, even if you never use it yourself.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#10-do-not-use-in-game-cheat-codes-unless-it-is-specified-as-allowed-by-the-developer","title":"10. Do not use in-game cheat codes unless it is specified as allowed by the developer.","text":"<p>The other side of the coin for allowed 2. Cheat codes and debug modes are not allowed unless the developer has made note of which and when it is allowed. Even if the achievements are earnable with cheat codes, this is usually unintended behavior, considered cheating if done intentionally, and should be reported as a bug via the ticket system.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#allowed","title":"Allowed","text":"<ol> <li>Fast-forward is allowed.</li> <li>When explicitly said in achievement's description, in-game cheat codes/modes and in-game debug tools are allowed.</li> <li>Making use of in-game glitches, in-game exploits, and \"cheesy\" tactics are allowed.</li> <li>Using online guides/walkthroughs is allowed.</li> <li>Playing co-op/competitive games with another player or players is allowed.</li> <li>Turbo is allowed.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#1-fast-forward-is-allowed","title":"1. Fast-forward is allowed.","text":"<p>Even in hardcore mode fast-forward is allowed, as a modern convenience. It's almost a consensus that fast-forward offers no risk to the fairplay and then it's available for everyone to use it.</p> <p>NOTE: in softcore mode savestates, rewind and slow motion are also allowed, but expect to have some issues. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#2-when-explicitly-said-in-achievements-description-in-game-cheat-codesmodes-and-in-game-debug-tools-are-allowed","title":"2. When explicitly said in achievement's description, in-game cheat codes/modes and in-game debug tools are allowed.","text":"<p>This is a complement to the not allowed rule 2.</p> <p>The achievement developers are instructed to protect their work so the achievements can't be unlocked easily by simply using a cheat code. However, some cool and fun challenges can be created taking advantage of some cheats. In these specific cases, using in-game cheats are allowed.</p> <p>NOTE: if you find achievements unlockable by using in-game cheats with no pertinent description, consider opening a ticket and reporting it.</p> <p>Examples:</p> <ul> <li>In Tetris (Game Boy) you should activate the speed cheat to earn the Challenge of the Gods achievement, where you have to clear 20 lines on speed 19.</li> <li>In Guerrilla War (NES) you're allowed to use the \"level and difficulty select screen\" cheat to earn the achievements where you have to beat the stages without killing any hostages.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#3-making-use-of-in-game-glitches-in-game-exploits-and-cheesy-tactics-are-allowed","title":"3. Making use of in-game glitches, in-game exploits, and \"cheesy\" tactics are allowed.","text":"<p>In-game glitches/exploits/cheesy tactics are allowed, however developers can code their achievements to disallow them programatically. It's usually mentioned in the achievement's description.</p> <p>This does not include when there are flaws in the achievement developer's code. In such cases, please create a ticket report, and earn the achievement as intended by the developer. See also not allowed rule 2.</p> <p>Examples:</p> <ul> <li>Breaking out out of normal bounds to avoid enemies.</li> <li>Doing something strange inside of a game to \"bug a game out\" so you become invincible.</li> <li>Accessing powerful items earlier than intended.</li> <li>Standing somewhere enemies can\u2019t hit you.</li> </ul> <p>Examples where developers disallow it: Megaman (NES) - beat bosses damageless without using the pause glitch.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#4-using-online-guideswalkthroughs-is-allowed","title":"4. Using online guides/walkthroughs is allowed.","text":"<p>Examples: youtube video guides; GameFAQs; puzzle solutions; collectible lists; etc.</p> <p>A note on honesty: Using solvers for sudoku/picross is considered cheating. Unenforceable tolerated cheating but cheating nonetheless.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#5-playing-co-opcompetitive-games-with-another-player-or-players-is-allowed","title":"5. Playing co-op/competitive games with another player or players is allowed.","text":"<p>Playing co-op is allowed, however developers can code their achievements to disallow it programatically. It's usually mentioned in the achievement's description.</p> <p>See also not allowed rule 2.</p> <p>Examples: a skilled friend playing Streets of Rage or Goof Troop with you; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#6-turbo-is-allowed","title":"6. Turbo is allowed.","text":"<p>Turbo is where you hold a single button down and the button is automatically re-pressed again and again quickly. Turbo is either built into controllers, or into emulation software. In either case it is allowed.</p> <p>In cases where there is any more complex scripting than repeating the same button in quick succession, this is not allowed. See Not allowed 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#special-thanks","title":"Special Thanks","text":"<p>This document is heavily based on the 100Pals Unified Achievement Hunting Rules. This version is trimmed down and tailored with topics that are relevant to the RetroAchievements context.</p> <p>The 100Pals is a community with experienced achievement hunters that exist since achievements were first released on Steam in 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-11 21:04] The Mystical One:</code> Updated notes about save states in hardcore to clarify that creating save states is allowed.</li> <li><code>[2023-06-30 12:55] televandalist:</code> Updated Global Leaderboard and Achievement Hunting Rules (markdown)</li> <li><code>[2023-04-20 02:01] televandalist:</code> Removed \"high-ranking\" from \"If you notice a high-ranking player has become untracked:\" - doesn't matter what their rank is.</li> <li><code>[2023-04-20 01:39] televandalist:</code> Added \"Severe cases of this can also result in a ban.\" in the last paragraph of the Untracked section.</li> <li><code>[2023-04-20 01:37] televandalist:</code> Removed info about Hardcore being worth double. Replaced with a brief explanation of Hardcore vs Softcore. Expanded on info about Untracked users.</li> <li><code>[2022-05-14 23:42] Jendrej:</code> grammar</li> <li><code>[2022-03-09 15:34] StingX2:</code> \"Do not earn achievements in a way that is unintended by the achievement developer.\" into something along the lines of \"Do not earn achievements in a way that is opposite of what the description asks\" suggested by DanielARP</li> <li><code>[2021-05-15 23:11] meleu:</code> do not unlock achievements outside supported emulators</li> <li><code>[2021-04-26 13:29] meleu:</code> fix link</li> <li><code>[2020-02-07 00:49] televandalist:</code> Added an example to point 3 of \"Not Allowed\" to include loading saves in Hardcore that were created in Softcore.</li> </ul>"},{"location":"Glossary-of-Developer-Terms/","title":"Glossary of Developer Terms","text":"<p>This page is for terms used around RetroAchievements. Some of these are technical terms encountered when developing a set, and others are slang and jargon among users and players, like \"set\" and \"cheevo\".</p> <p>This page is still a work-in-progress. Please add definitions and fix errors as you see fit.</p>"},{"location":"Glossary-of-Developer-Terms/#16-bit","title":"16-bit","text":"<p>Processors that work on two byte word lengths. More bits usually mean more addressable memory for more complex games. Also used to describe the fourth generation of consoles, when 16-bit processors were common. A typical 16-bit processor includes the Motorola 68k series (Sega Genesis, Atari Jaguar (as one of its processors), early Macintosh).</p>"},{"location":"Glossary-of-Developer-Terms/#32-bit","title":"32-bit","text":"<p>Processors that work on four byte word lengths. More bits usually mean more addressable memory for more complex games. Also used to describe the fifth generation of consoles, where 32-bit processors were common. Processors this complex tend to be custom designed; 32-bit consoles include the PlayStation and the Sega Saturn.</p>"},{"location":"Glossary-of-Developer-Terms/#8-bit","title":"8-bit","text":"<p>Processors that work on one byte word lengths. Can also be used to describe the second or third generations of consoles, where 8-bit processors were common. Common 8-bit processors include the Z80 (many golden age arcade games, the Sega Master System and Game Gear, and the Game Boy) and the 6502 (Atari 2600, Apple II, NES).</p>"},{"location":"Glossary-of-Developer-Terms/#achievement","title":"achievement","text":"<p>A defined challenge in a game that rewards an RA user with points and an achievement badge when completed.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-id","title":"achievement ID","text":"<p>A unique number associated with an achievement. This can be seen in various places, most notably the end of the URL for the achievement page. The \"100% all goals, stats, and decks with Tony Hawk\" achievement for Tony Hawk's Pro Skater 3 on the PS2 has an achievement ID of 261676.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-editor","title":"achievement editor","text":""},{"location":"Glossary-of-Developer-Terms/#achievement-of-the-week-aotw","title":"Achievement of the Week (\"AOTW\")","text":"<p>A site event where a new achievement is selected weekly for an entire year, and users attempt to unlock ones for as many weeks as they can. Awards and a leaderboard for most unlocks are presented at the end of the year.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-of-the-month-aotm","title":"Achievement of the Month (\"AOTM\")","text":"<p>An addition to the Achievement of the Week event, featuring larger achievements that are presented once a month instead of once a week. AOTM points count towards the final AOTW leaderboard.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-page","title":"achievement page","text":"<p>A page on the site for a specific achievement, showing a list of people who have unlocked it, and a history of any tweaks in logic or status, and a wall for discussing the achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-processing-or-simply-processing","title":"achievement processing (or simply \"processing\")","text":""},{"location":"Glossary-of-Developer-Terms/#achievement-sets","title":"achievement sets","text":"<p>A collection of achievements that pertain to a specific game. </p>"},{"location":"Glossary-of-Developer-Terms/#addhits","title":"AddHits","text":""},{"location":"Glossary-of-Developer-Terms/#address","title":"address","text":""},{"location":"Glossary-of-Developer-Terms/#addsource","title":"AddSource","text":""},{"location":"Glossary-of-Developer-Terms/#admin","title":"admin","text":""},{"location":"Glossary-of-Developer-Terms/#alt-group","title":"alt group","text":""},{"location":"Glossary-of-Developer-Terms/#api","title":"API","text":""},{"location":"Glossary-of-Developer-Terms/#api-key","title":"API key","text":""},{"location":"Glossary-of-Developer-Terms/#author","title":"author","text":"<p>The original developer who published an achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#badge","title":"badge","text":"<p>The image associated with an achievement. It's square and is 64x64 at full size.</p>"},{"location":"Glossary-of-Developer-Terms/#binary","title":"binary","text":"<p>A way to notate numbers using entirely two states, on or off (colloquially 1's and 0's). While computers use binary, more commonly developers use hexadecimal to read the same information.</p>"},{"location":"Glossary-of-Developer-Terms/#big-endian-be","title":"big endian (\"BE\")","text":"<p>A type of endianness where the most significant digit in a word is stored in memory first. In other words, big endian stores the word forwards, as you'd read it on its own. Big endian consoles include the Sega Genesis and the Neo Geo.</p>"},{"location":"Glossary-of-Developer-Terms/#bit","title":"bit","text":"<p>The smallest discrete memory unit. Represented in binary. Rarely addressed directly on consoles.</p>"},{"location":"Glossary-of-Developer-Terms/#bonus-set","title":"\"bonus\" set","text":"<p>A subset for a game featuring additional, more difficult or more esoteric challenges. </p>"},{"location":"Glossary-of-Developer-Terms/#byte","title":"byte","text":"<p>A unit of memory with a length of eight bits. Often the smallest addressable unit of memory.</p>"},{"location":"Glossary-of-Developer-Terms/#cancel-leaderboard","title":"cancel (leaderboard)","text":""},{"location":"Glossary-of-Developer-Terms/#checksum","title":"checksum","text":""},{"location":"Glossary-of-Developer-Terms/#cheevo","title":"cheevo","text":"<p>Colloquial shorthand for \"achievement\".</p>"},{"location":"Glossary-of-Developer-Terms/#claim","title":"claim","text":"<p>When a developer declares their intent to work on a set for a game. Developers can only make a limited number of claims at a time. Unless it's a collaborative set, no other developer can work on that game while the claim is active.</p>"},{"location":"Glossary-of-Developer-Terms/#code-note","title":"code note","text":"<p>A chunk of memory annotated with its purpose for use in achievement developing, a memory location \"bookmark\" of sorts. Each game has a freely-accessible page of code notes associated with it.</p>"},{"location":"Glossary-of-Developer-Terms/#code-reviewer","title":"code reviewer","text":""},{"location":"Glossary-of-Developer-Terms/#commit-selected","title":"commit selected","text":""},{"location":"Glossary-of-Developer-Terms/#completion-trophy","title":"completion trophy","text":"<p>The award given to a user who has finished every achievement in a set in Softcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#core-achievement","title":"core achievement","text":"<p>An achievement that's part of the main set for a game and is able to be unlocked by most players.</p>"},{"location":"Glossary-of-Developer-Terms/#crc-32","title":"CRC-32","text":""},{"location":"Glossary-of-Developer-Terms/#the-cutting-room-floor-tcrf","title":"The Cutting Room Floor (\"TCRF\")","text":"<p>A website dedicated to unused content in games. This can be disabled features, hidden assets, localization changes, or materials in prototypes or prerelease media that changed by the time of the final release.</p>"},{"location":"Glossary-of-Developer-Terms/#demotion","title":"demotion","text":""},{"location":"Glossary-of-Developer-Terms/#decimal-dec","title":"decimal (\"dec\")","text":"<p>A way to notate numbers, using only 0-9 for ten possible values. Prevalent in everyday use, though less so in computing.</p>"},{"location":"Glossary-of-Developer-Terms/#developer-dev","title":"developer (\"dev\")","text":"<p>A user on RetroAchievements who digs into a game's behavior with the intent of creating achievements for it. Developers are also responsible for the upkeep of their sets, in case bugs are found.</p>"},{"location":"Glossary-of-Developer-Terms/#developing-achievements","title":"developing achievements","text":"<p>A process of setting various checks on memory locations that fire when a player completes a task in a game. Achievement logic can be very complex and achievements are reviewed and tested rigorously before sets are released.</p>"},{"location":"Glossary-of-Developer-Terms/#discord","title":"Discord","text":"<p>A chat platform commonly used by gaming communities, including RetroAchievements. Discord servers (or simply \"Discords\") often feature one or many text channels where users can post messages, images, and videos, and voice channels where users can stream video and audio.</p>"},{"location":"Glossary-of-Developer-Terms/#dynamic-link-library-dll","title":"dynamic link library (\"DLL\")","text":"<p>A file type common on Windows computers for sharing code and resources between programs. DLLs are used in the standalone RetroAchievements emulators for all the site-specific functionality, like logging in and listening for achievement logic.</p>"},{"location":"Glossary-of-Developer-Terms/#dynamic-memory","title":"dynamic memory","text":""},{"location":"Glossary-of-Developer-Terms/#endianness","title":"endianness","text":"<p>The order in which a series of bytes are stored in memory. Generally comes in two flavors, little endian and big endian. See those entries elsewhere in this document.</p>"},{"location":"Glossary-of-Developer-Terms/#event-set","title":"\"event\" set","text":""},{"location":"Glossary-of-Developer-Terms/#flag-achievement-field","title":"flag (achievement field)","text":""},{"location":"Glossary-of-Developer-Terms/#flag-memory","title":"flag (memory)","text":""},{"location":"Glossary-of-Developer-Terms/#forum","title":"forum","text":"<p>RetroAchievements has a forum that facilitates development of sets and communication between users and admins, as well as general banter.</p>"},{"location":"Glossary-of-Developer-Terms/#game-icon","title":"game icon","text":""},{"location":"Glossary-of-Developer-Terms/#game-entry-or-simply-entry","title":"game entry (or simply \"entry\")","text":""},{"location":"Glossary-of-Developer-Terms/#game-id","title":"game ID","text":"<p>A unique number associated with a game. This can be seen in various places, most notably the end of the URL for the game page. Vib-Ribbon for the PlayStation has a game ID of 8953.</p>"},{"location":"Glossary-of-Developer-Terms/#game-page","title":"game page","text":"<p>A page on the site for a specific game, listing the achievements for it, completion percentages, users who have mastered the game, leaderboards, and a wall for discussing the game and set, among other things.</p>"},{"location":"Glossary-of-Developer-Terms/#github","title":"GitHub","text":"<p>A website for publishing repositories of code for programs and websites. RetroAchievements uses GitHub to maintain its emulator projects, the website, and the site documentation.</p>"},{"location":"Glossary-of-Developer-Terms/#global-leaderboard","title":"global leaderboard","text":"<p>The ranking of all players on the site based on the number of Hardcore and Softcore points they have.</p>"},{"location":"Glossary-of-Developer-Terms/#hack-set","title":"\"hack\" set","text":"<p>A set developed for a ROM hack of a game.</p>"},{"location":"Glossary-of-Developer-Terms/#hardcore-mode","title":"Hardcore mode","text":"<p>A setting in RA-equipped emulators that disables save states and speed controls, effectively forcing the player to play like they would on the real console. When a player unlocks an achievement in Hardcore, they get double the points for it, and mastery trophies are awarded for unlocking all achievements in that set in Hardcore.</p>"},{"location":"Glossary-of-Developer-Terms/#hash","title":"hash","text":"<p>A string of data used to identify a specific version of a game. Hashes are used to ensure all players are using the same version, as differently-localized or earlier/later editions of a game can have differing memory locations that break achievement sets. For some consoles, the entire game image is hashed; for others, only a chunk of the image is hashed.</p>"},{"location":"Glossary-of-Developer-Terms/#hash-links-log","title":"#hash-links-log","text":""},{"location":"Glossary-of-Developer-Terms/#hexadecimal-hex","title":"hexadecimal (\"hex\")","text":"<p>A way to notate numbers using 0-9 and the letters A-F, providing 16 possible values. Universal in computing thanks to its compactness and 16 being a power of two (decimal notation only has 10 possible values, 10 not being a power of two).</p>"},{"location":"Glossary-of-Developer-Terms/#hits","title":"hits","text":""},{"location":"Glossary-of-Developer-Terms/#homebrew","title":"homebrew","text":"<p>Games and software developed for a console by hobbyists, as opposed to traditional game companies. Homebrew games tend to be adaptations of games for other platforms, though original homebrew certainly exists.</p>"},{"location":"Glossary-of-Developer-Terms/#homebrew-set","title":"\"homebrew\" set","text":""},{"location":"Glossary-of-Developer-Terms/#issue","title":"issue","text":""},{"location":"Glossary-of-Developer-Terms/#junior-developer","title":"junior developer","text":"<p>A new developer with certain extra restrictions on their account, like the number of games they can claim at once.</p>"},{"location":"Glossary-of-Developer-Terms/#json","title":"JSON","text":""},{"location":"Glossary-of-Developer-Terms/#leaderboard","title":"leaderboard","text":"<p>A ranking of players based on their scores, times, or another count (like the Tarzan leaderboard on Pitfall!, for the most vine swings without changing direction) on a game or on a particular stage of a game. Set developers have the option of creating as many leaderboards as they want for their game.</p>"},{"location":"Glossary-of-Developer-Terms/#little-endian-le","title":"little endian (\"LE\")","text":"<p>A type of endianness where the least significant digit in a word is stored in memory first. In other words, little endian stores the word backwards from how you'd read it on its own. Little endian consoles include the NES and the PlayStation.</p>"},{"location":"Glossary-of-Developer-Terms/#local-achievements","title":"local achievements","text":"<p>Achievements that only exist on the developer's computer and have not been pushed to unofficial or core achievement status.</p>"},{"location":"Glossary-of-Developer-Terms/#localization","title":"localization","text":"<p>The act of translating a game from one language to another. Localization is common as many games originate in Japan, and are played in Western countries where Japanese isn't often spoken.</p>"},{"location":"Glossary-of-Developer-Terms/#logic-comparison-or-simply-comparison","title":"logic comparison (or simply \"comparison\")","text":""},{"location":"Glossary-of-Developer-Terms/#lower4","title":"lower4","text":""},{"location":"Glossary-of-Developer-Terms/#md5","title":"MD5","text":"<p>A hashing algorithm. RetroAchievements uses this on its game hashes.</p>"},{"location":"Glossary-of-Developer-Terms/#mastery-trophy","title":"mastery trophy","text":"<p>The award given to a user who has finished every achievement in a set in Hardcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#memory","title":"memory","text":"<p>Usually refers to RAM, an address space that can be written to by the software at will and gets erased when the console is powered off. Most achievement development works by checking values in memory.</p>"},{"location":"Glossary-of-Developer-Terms/#memory-achievement-editor","title":"memory (achievement editor)","text":""},{"location":"Glossary-of-Developer-Terms/#memory-bookmarker","title":"memory bookmarker","text":""},{"location":"Glossary-of-Developer-Terms/#memory-inspector","title":"memory inspector","text":""},{"location":"Glossary-of-Developer-Terms/#memval","title":"mem/val","text":""},{"location":"Glossary-of-Developer-Terms/#multi-set","title":"\"multi\" set","text":""},{"location":"Glossary-of-Developer-Terms/#pauseif","title":"PauseIf","text":""},{"location":"Glossary-of-Developer-Terms/#pointers","title":"pointers","text":""},{"location":"Glossary-of-Developer-Terms/#points","title":"points","text":""},{"location":"Glossary-of-Developer-Terms/#prototype-set","title":"\"prototype\" set","text":"<p>A set for a game that was never finished or published, or theoretically, a set for a prototype of a game that's massively different from its final version, enough to make another set not redundant.</p>"},{"location":"Glossary-of-Developer-Terms/#promote-to-core","title":"promote to core","text":"<p>Making an achievement an official part of a set after development so players can attempt it.</p>"},{"location":"Glossary-of-Developer-Terms/#retroachievements-ra","title":"RetroAchievements (\"RA\")","text":"<p>A site for creating and unlocking achievements in older games, generally the mid-2000s and before. Players are ranked based on the number of points they accumulate for unlocking achievements.</p>"},{"location":"Glossary-of-Developer-Terms/#radocs","title":"RADocs","text":"<p>A set of documentation and instructions associated with the RetroAchievements platform.</p>"},{"location":"Glossary-of-Developer-Terms/#raemus","title":"RAEmus","text":"<p>Short for \"RetroAchievements emulators\", or standalone emulators equipped with RA functionality. This generally only applies to emulators that have been unofficially forked to add RA functionality, and not to all-in-one emulation frontends like RetroArch or BizHawk, or emulators where RA support is official like DuckStation and PCSX2.</p>"},{"location":"Glossary-of-Developer-Terms/#requirement","title":"requirement","text":""},{"location":"Glossary-of-Developer-Terms/#resetif","title":"ResetIf","text":"<p>flag</p>"},{"location":"Glossary-of-Developer-Terms/#reservation","title":"reservation","text":""},{"location":"Glossary-of-Developer-Terms/#retro-ratio","title":"retro ratio","text":"<p>A metric to gauge the relative difficulty of the achievements a player has unlocked. A higher retro ratio means the player has unlocked more uncommon (and presumably difficult) achievements. As of yet, the retro ratio is still not well-defined.</p>"},{"location":"Glossary-of-Developer-Terms/#retroarch","title":"RetroArch","text":"<p>An all-in-one emulator frontend for the Libretro project. RetroArch users install cores that each emulate a specific piece of hardware, allowing for the one program to run games from many systems. Has been ported to many, many consoles and operating systems. RetroArch is one of the main ways of playing RetroAchievements sets, due to many of the cores implementing RA functionality.</p>"},{"location":"Glossary-of-Developer-Terms/#revision","title":"revision","text":"<p>When a set is updated after its initial release to add, remove, or edit achievements, or to update point values.</p>"},{"location":"Glossary-of-Developer-Terms/#revision-voting","title":"revision voting","text":""},{"location":"Glossary-of-Developer-Terms/#rich-presence-script-rps","title":"rich presence script (\"RPS\")","text":"<p>A script that gives detailed information on-site about where a player is in a game, what items they've collected, who they're playing as, and other such data that updates while the player is playing.</p>"},{"location":"Glossary-of-Developer-Terms/#random-number-generator-rng","title":"random number generator (\"RNG\")","text":"<p>Code that generates a seemingly random number, used to make gameplay less predictable and more interesting (though occasionally more frustrating as well). RNG is very rarely truly random, usually taking a number like the game clock and using it as a \"seed\". Poorly implemented seeds can have their \"randomness\" manipulated by players who know how to.</p>"},{"location":"Glossary-of-Developer-Terms/#read-only-memory-rom","title":"read-only memory (\"ROM\")","text":"<p>Refers to an address space that can't be written to. This is usually where the game instructions and assets are stored. \"ROM\" also refers to a copy of the information on a game's ROM chips stored in a file, usually called an \"image\", for play on emulators or for use in hacking or datamining.</p>"},{"location":"Glossary-of-Developer-Terms/#rom-hack-or-simply-hack","title":"ROM hack (or simply \"hack\")","text":"<p>A fanmade modification of a game to add new content and features, often totally converting the game in the process. Usually applies to simpler games that were stored on ROM cartridges; more complex and newer games are simply \"modded\" instead.</p>"},{"location":"Glossary-of-Developer-Terms/#romhackingnet","title":"romhacking.net","text":"<p>A website that hosts guides and utilities for ROM hacking and game modding, as well as the ROM hacks themselves.</p>"},{"location":"Glossary-of-Developer-Terms/#set","title":"set","text":"<p>A group of achievements associated with a game. Sets are usually developed and maintained by one or two people each who inspect the game's memory, define achievements and what points they're worth, and respond to tickets on achievements not working as intended. Completing all achievements in a set awards a trophy, depending on if the achievements were unlocked in Hardcore or Softcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#set-cap","title":"set cap","text":"<p>The former limit on how many points are allowed in a set of achievements. This used to be 400, but there is currently no cap on points in sets.</p>"},{"location":"Glossary-of-Developer-Terms/#size-achievement-editor","title":"size (achievement editor)","text":""},{"location":"Glossary-of-Developer-Terms/#softcore-mode","title":"Softcore mode","text":"<p>Playing with Hardcore mode disabled, allowing for save states and speed controls. Softcore does not give the player double points for unlocking achievements like Hardcore does, and does not award mastery trophies (instead awarding completion trophies).</p>"},{"location":"Glossary-of-Developer-Terms/#stage-id","title":"stage ID","text":""},{"location":"Glossary-of-Developer-Terms/#start-leaderboard","title":"start (leaderboard)","text":"<p>To begin a run that's eligible for leaderboard ranking. A run will fail if it's not completed correctly (player death, restart, pause, or other developer-definable criteria).</p>"},{"location":"Glossary-of-Developer-Terms/#static-memory","title":"static memory","text":""},{"location":"Glossary-of-Developer-Terms/#submit-leaderboard","title":"submit (leaderboard)","text":"<p>To have a score or a time ranked on one of the leaderboards.</p>"},{"location":"Glossary-of-Developer-Terms/#subsource","title":"SubSource","text":""},{"location":"Glossary-of-Developer-Terms/#ticket","title":"ticket","text":""},{"location":"Glossary-of-Developer-Terms/#ticket-manager","title":"ticket manager","text":""},{"location":"Glossary-of-Developer-Terms/#trigger","title":"trigger","text":""},{"location":"Glossary-of-Developer-Terms/#trophy","title":"trophy","text":"<p>An award given to a player for completing a set or participating in a site event.</p>"},{"location":"Glossary-of-Developer-Terms/#type-memdeltavalue","title":"type (mem/delta/value)","text":""},{"location":"Glossary-of-Developer-Terms/#unofficial-achievement","title":"unofficial achievement","text":"<p>An achievement published on-site, but not part of the main set. This usually needs additional testing before it can become a core achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#unlicensed-set","title":"\"unlicensed\" set","text":""},{"location":"Glossary-of-Developer-Terms/#unlock-in-reference-to-achievements-also-called-earning-achievements","title":"unlock (in reference to achievements, also called \"earning\" achievements)","text":"<p>Completing the steps needed to make an achievement fire. The achievement is then displayed on the user's page and elsewhere and they earn the points for having done so.</p>"},{"location":"Glossary-of-Developer-Terms/#upper4","title":"upper4","text":""},{"location":"Glossary-of-Developer-Terms/#user-motto","title":"user motto","text":"<p>A short, user-definable snippet of text on a user page. This is usually silly and in-jokey.</p>"},{"location":"Glossary-of-Developer-Terms/#user-page","title":"user page","text":"<p>The profile associated with a user on-site. This contains their account status (registered/junior developer/developer/moderator/etc), points accrued, completion percentage, trophies, the last five games the user was seen playing, and a wall for others to leave comments on, among other widgets.</p>"},{"location":"Glossary-of-Developer-Terms/#value","title":"value","text":""},{"location":"Glossary-of-Developer-Terms/#value-field-leaderboardrps","title":"value field (leaderboard/rps)","text":""},{"location":"Handling-Tickets/","title":"Handling Tickets","text":""},{"location":"Handling-Tickets/#handling-your-own-tickets","title":"Handling Your Own Tickets","text":"<p>After you've published your achievements, be prepared for bug reports. You're expected to keep your work bug free by appropriately resolving tickets. Respond to all tickets as soon as possible. The sooner you respond the better, because the problem is fresh in the player's mind and you can use them to help you to resolve the problem.</p>"},{"location":"Handling-Tickets/#can-i-claim-a-set-if-i-have-an-open-ticket","title":"Can I Claim a Set If I Have an Open Ticket?","text":"<p>To be allowed to make a primary or collaboration claim on a set, you must not have any unaddressed tickets.</p> <ul> <li>An open ticket is considered addressed when a developer, who may be unable to immediately resolve an issue, leaves a comment requesting a save file, state or additional information from the reporter.</li> <li>Tickets that have been properly closed or resolved are, of course, considered addressed.</li> </ul>"},{"location":"Handling-Tickets/#steps-to-resolve-tickets","title":"Steps to Resolve Tickets","text":"<ol> <li>Do your due diligence to investigate the cause of the issue.</li> <li>Ask detailed questions from the reporter to narrow down possible causes if the initial report is lacking in detail.</li> <li>If not provided, or if a provided save state is not at a point helpful to diagnose the issue, ask for one or more save states. Be clear about where in the game the saves should be made. Help the user know what to capture.</li> <li>Attempt to reproduce the issue on the same core used by the user.     * You may need to edit <code>cores.json</code> in RALibretro to remove the <code>\"platforms\": \"none\"</code> line from a core\u2019s definition in order to download  and use the core.</li> <li>If resolving a ticket for another developer\u2019s achievement, make a backup of the old logic and leave it in a comment on the ticket. That way if your fix has a further issue, you or another developer will be able to reference the previous logic.</li> <li>When you have found the issue, develop and test your changes.<ul> <li>Note: For achievements that triggered at the wrong time make sure you test that your changes work to resolve the false trigger and that they still work to trigger the achievement in the correct method.</li> </ul> </li> <li>Leave a summary of what you did to fix the ticket. If possible, explain why the issue occurred, what fixed it, and why the fix works.</li> </ol>"},{"location":"Handling-Tickets/#steps-to-close-tickets","title":"Steps to Close Tickets","text":"<ol> <li>Perform due diligence in attempting to reproduce the problem.</li> <li>Do not close tickets without leaving a comment about why closing the ticket is the correct action.</li> <li>Close with the most appropriate reason<ul> <li>Unable to Reproduce should be done only after gathering as much information about the context of the ticket as possible, attempting to reproduce it on the core by approaching the triggering conditions as many ways as you can, and still being unable to reproduce the results.</li> <li>Not Enough Information should be done only after attempting to reproduce the issue as much as possible, but without further information from the reporter are unable to come up with the same result.<ul> <li>Give several days for new information to be given before closing in this fashion.</li> </ul> </li> <li>Network Problems should be the close reason if it becomes clear that the issue was caused by the user not having a connection to the server.</li> <li>A Mistaken Report should be used only if it becomes clear that the user did not perform the correct actions to unlock the ticket or reported a ticket for non-ticketable reasons.</li> <li>Other Reason can be used if some other reason for closing a ticket exists. Be sure to properly justify the closure in a ticket comment.</li> </ul> </li> </ol>"},{"location":"Handling-Tickets/#handling-tickets-for-other-developers","title":"Handling Tickets for Other Developers","text":"<p>You may resolve tickets for another developer under the following guidelines:</p>"},{"location":"Handling-Tickets/#if-the-developer-is-active","title":"If the Developer is Active","text":"<p>You may assist them in the resolution. The developer should still implement any code changes needed, but you are allowed to suggest logic and help find the causes.</p>"},{"location":"Handling-Tickets/#if-the-developer-is-inactive","title":"If the Developer is Inactive","text":"<p>You can work on their tickets on your own.</p> <ul> <li>An inactive developer is someone who has 10 or more open tickets that are older than two months (you can see their open tickets from the Ticket Manager).<ul> <li>Contact a Developer Compliance team member to ensure this is the case before making the judgement on your own if they still have the Developer role.</li> </ul> </li> <li>If the developer is inactive, you can freely resolve their tickets through normal resolution processes as stated above.</li> <li>You may change the achievement description to clarify the objective or to match the logic that is present to clarify the intent of the achievement. Do not deviate from an achievement's concept or objective in any way without an approved revision vote.</li> <li>Follow the steps to resolve or close a ticket as if it were your own.</li> </ul>"},{"location":"Handling-Tickets/#claiming-a-ticket","title":"Claiming a Ticket","text":"<p>You may place a soft claim on ticket investigation and resolution by commenting your intent in a ticket comment.</p> <ul> <li>If someone else has stated their intent to resolve a ticket, you may provide additional insight in a ticket comment.</li> <li>The developer working on a ticket may choose to work with another developer or user for assistance in resolving the ticket.</li> <li>After seven days without action towards a resolution, the ticket will be considered unclaimed, to allow other developers to provide a solution.</li> </ul>"},{"location":"Handling-Tickets/#if-a-developer-becomes-active-again","title":"If a Developer Becomes Active Again","text":"<p>Who handles tickets for achievements edited while the developer is Inactive?</p> <p>If an inactive developer becomes active again, they are still responsible for their achievements that have been fixed by other developers. * It is strongly recommended that the newly active dev review any tickets that were resolved during their inactivity period so they can understand the changes made to their achievements. * If necessary, reach out to the developer who made the updates that resolved the tickets. * If the newly active developer no longer wants to be the owner of the achievements, they can reach out to the Developer Compliance team to inquire about a reauthor of said achievements.   * Note that an accepted reauthor will be handled on a case-by-case basis, depending on the developers in question as well as the changes made to the achievements. This rule will be reevaluated if the implementation of a set or achievement maintainer is introduced.</p>"},{"location":"Handling-Tickets/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:08] Andrew Comer:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-03-11 14:03] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:57] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-01-14 10:07] The Mystical One:</code> Cleaned up the \"Handling Tickets for Other Developers\" section so it flows better.</li> <li><code>[2024-01-14 08:31] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-14 08:27] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 23:04] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 23:03] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 22:57] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 22:55] The Mystical One:</code> Changed the Set Claims &amp; Tickets heading to be a question so that it is much more eye-catching.</li> </ul>"},{"location":"Hash-Labels/","title":"Hash Labels","text":"<p>Every ROM that is linked to an achievement set should be clearly identified and labeled. These labels help players know which versions of a game are compatible as well as if there are any translation patches, bug fixes, cosmetic hacks, quality of life hacks, etc. that they can use. </p>"},{"location":"Hash-Labels/#info-for-linked-hashes","title":"Info for Linked Hashes","text":"<ul> <li>RA Hash: Check Game Identification to learn more about these. These appear in <code>Manage Hashes</code> automatically.</li> <li>Filename - Filename should be entered as the description. These are typically automatic, but may need some adjustments.</li> <li>Labels - You can use the labels listed below by using the filename of the image (no extension).</li> </ul>"},{"location":"Hash-Labels/#images","title":"Images","text":"Image Label to Use Note <code>main</code> Sometimes used to show the primary ROM used by the set developer(s) <code>rapatches</code> Used when the hash requires a patch hosted on RAPatches <code>nointro</code> The most common for cartridge-based games <code>redump</code> The most common for disc-based games <code>wozaday</code> Apple II preservation group <code>tosec</code> <code>fbneo</code> Mostly used for Arcade <code>cleancpc</code> Amstrad preservation project <code>4amcrack</code> Used for Apple II <code>neokobe</code> Mostly for PC-8001 and PC-8801 <code>homebrew</code> Used for, you guessed it: Homebrews! <code>atariage</code> Popular site for Homebrews <code>itchio</code> Popular site for Homebrews <code>msu1</code> Used to mark SNES ROMs with MSU-1 patches <code>snesmini</code> <code>egg</code> ROMs purchased from Project Egg, typically Japanese PC games. <code>steam</code> ROMs purchased from Steam. <code>mamesl</code> MAME Software List <code>smwcentral</code> Popular repository for Super Mario World hacks. <code>rhdn</code> Popular repository for ROM hacks <code>goodtools</code> <code>nongood</code> <code>offlinelist</code>"},{"location":"Hash-Labels/#examples","title":"Examples","text":""},{"location":"Hash-Labels/#deja-vu-nes","title":"Deja Vu (NES)","text":"<ul> <li>The first hash is the USA version of the game with an Uncensored patch applied to it. The full text of the description is <code>Deja Vu (USA) (Uncensored) (v1.0) (usertheloset).nes</code>, which follows the RAPatches naming scheme. The labels used are <code>nointro</code> and <code>rapatches</code>.</li> <li>The second hash is the No Intro-verified USA version of the game.</li> <li>The third hash is the No Intro-verified Japanese version of the game.</li> </ul> <p>To see how this will look for the majority of users, go to the game entry page and click on \"Linked Hashes.\"</p> <p></p> <p>As you can see below, <code>nointro</code> became  and <code>rapatches</code> became .</p> <p></p>"},{"location":"Hash-Labels/#suikoden-playstation","title":"Suikoden (PlayStation)","text":"<p>We'll skip the manage hashes example for this one. Let's go straight to \"Linked Hashes\" on the game entry page:</p> <p></p> <p>The hashes labeled with <code>redump</code>, <code>rhdn</code>, and <code>rapatches</code> require patches that are available on both romhacking.net and in the RAPatches repository.</p> <p></p>"},{"location":"Hash-Labels/#linking-to-patches","title":"Linking to Patches","text":"<ul> <li>The first post of a game's forum topic is the best place to include links to patches required.</li> <li>These do not need to follow a specific format, but the information must be clear.</li> <li>Here is one example of how to format the text in the forum: </li> </ul> <p>Input Text:</p> <pre><code>[b]Suikoden (Europe) (De) (v1.01) (Twisted Phoenix Game Translation)[/b]\n[b]Suikoden (Europe) + [url=https://www.romhacking.net/translations/5736/]German Patch[/url][/b] [img=Images/labels/rhdn.png]\nor\n[b]Suikoden (Europe) + [url=https://github.com/RetroAchievements/RAPatches/raw/main/PS1/Translation/German/11255-Suikoden-GermanTranslation.7z]German Patch[/url][/b] [img=Images/labels/rapatches.png]\n[i]RA Checksum: [/i]f0c5ec0696aa2ec2d6e5b731fbe07491\n</code></pre> <p></p> <ul> <li>A second example: Input Text:</li> </ul> <pre><code>[img=Images/labels/rapatches.png] [img=Images/labels/rhdn.png]\nDownload the patch from RHDN [url=https://www.romhacking.net/translations/5736/]here[/url].\nRAPatches Mirror [url=https://github.com/RetroAchievements/RAPatches/raw/main/PS1/Translation/German/11255-Suikoden-GermanTranslation.7z]here[/url].\n</code></pre> <p></p>"},{"location":"Hash-Labels/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-01 22:23] televandalist:</code> Updated Hash Labels (markdown)</li> <li><code>[2023-12-14 12:59] televandalist:</code> Updated Hash Labels (markdown)</li> <li><code>[2023-07-05 23:08] televandalist:</code> rndn -&gt; rhdn</li> <li><code>[2023-06-03 02:30] televandalist:</code> Updated WIP Hash Labels (markdown)</li> </ul>"},{"location":"Hit-Counts-es/","title":"Contador de Golpes (Hit Counts)","text":"<p>En el Editor de Logros (Achievement Editor), el campo de hasta la derecha es el Contador de Golpes (Hit Count). </p> <p>Por default es Cero, que significa que la condicion tiene que ser verdadera para qeu el logro se dispare.</p> <p>Si agregas un contador de golpes (hit count), por ejemplo 5, significa que la condicion tiene va a ser verdadera hasta que se cumplan esos fotogramas (frames), y no se necesitan volver a cumplir de nuevo en cualquier otro momento.</p> <p>PORFAVOR, NOTA: si una condicion tiene cero hit count, y llega al numero requirido, esta condicion ya no esta siendo buscada. Sigue permaneciendo como verdadera, ALMENOS que tengas un <code>ResetIf</code>, que discutiremos mas abajo.</p> <p>Condiciones con <code>Reset If</code> y <code>PauseIf</code> tambien pueden tener hits. Sigue los links para mas informacion.</p> <p>En la seccion de Ejemplos de Verdad hay dos buenos ejemplos:</p> <ul> <li>Utilizando Hit Counts como un Contador</li> <li>Utilizando Valores Delta y Hit Counts para detectar un Incremento</li> <li>Simple ejemplo de como evadir el abuso en Estados de Guardado (Load States)</li> </ul>"},{"location":"Hit-Counts-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:39] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Hit Counts ES (markdown)</li> </ul>"},{"location":"Hit-Counts/","title":"Hit Counts","text":"<p>In the Achievement Editor, the field on the far right side is Hit Count.</p> <p></p> <p>The default is Zero, which means the condition must be true for the achievement to trigger.</p> <p>If you set a target hit count, like 5, it means the condition must be true for at least that many frames, and once that hit count target is met, it doesn't need to be met again at any other time.</p> <p>PLEASE NOTE: if a condition has a non-zero hit count, and reaches the number required, this condition is no longer tested. It  remains true, UNLESS you have a <code>ResetIf</code>, which we will discuss below.</p> <p>Conditions with <code>Reset If</code> and <code>PauseIf</code> flags can also have hits. Follow the links for details.</p> <p>In the Real Examples section there are two examples good examples:</p> <ul> <li>Using Hit Counts as a Timer</li> <li>Using Delta Values and Hit Counts to Detect an Increment</li> </ul>"},{"location":"Hit-Counts/#effect-of-resetting-the-emulator","title":"Effect of Resetting the Emulator","text":"<p>When the emulator is reset, all hits are immediately zeroed out and the achievement is set back to Waiting. However, an emulator reset does not clear out memory, so it's possible for the hits to reaccumulate before the game reinitializes the memory. As such, you should not rely on the hits being cleared out by the emulator reset.</p> <p>Similarly, when the emulator first \"powers on\", the state of memory is not guaranteed to be consistent as true hardware does not initialize its memory. Instead, the software sets some initial state when it claims portions of memory. Some games actually rely on the random nature of the uninitialized memory to seed their random number generators.</p> <p>For both cases, you should have an explicit reset for some piece of knowable logic, like the player being on the title screen.</p>"},{"location":"Hit-Counts/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-07-27 19:31] Searo:</code> Page doesn't exist and we don't care what softcore users do anymore</li> <li><code>[2021-07-17 07:27] Jamiras:</code> Updated Hit Counts (markdown)</li> <li><code>[2021-07-17 07:27] Jamiras:</code> add section detailing behavior at reset/power on</li> <li><code>[2019-02-18 17:01] meleu:</code> fix broken links</li> <li><code>[2019-02-12 13:10] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:23] meleu:</code> Updated Hit Counts (markdown)</li> <li><code>[2019-02-12 09:21] meleu:</code> Created Hit Counts (markdown)</li> </ul>"},{"location":"Home-es/","title":"Introducci\u00f3n","text":""},{"location":"Home-es/#_1","title":"Introducci\u00f3n","text":"<p>Bienvenido a la Documentaci\u00f3n de RetroAchievements!</p> <p>Primero que nada, tienes que conocer el Manifiesto RetroAchievements y seguir el C\u00f3digo de Conducta del Usuario.</p> <p>Si estas buscando documentos sobre creaci\u00f3n de logros, checa nuestra secci\u00f3n de documentos para Desarrolladores.</p> <p>Animamos a todos los miembros de la comunidad a unirse a nuestro servidor de Discord, lo usamos para la mayor\u00eda de las comunicaciones.</p> <p>La lista completa de p\u00e1ginas se encuentran en la barra lateral, pero aqu\u00ed una breve descripci\u00f3n de algunas de ellas:</p> <ul> <li>FAQ: Preguntas Frecuentes (como cual n\u00facleo (Core) RetroArch deber\u00eda usar?).</li> </ul> <ul> <li>Tablas de Clasificaci\u00f3n Globales y Reglas para Obtener Logros: explica las reglas para las tablas globales, que es el estado No Rastreado (Untracked), que puede ser considerado como hacer trampa, etc.</li> </ul> <ul> <li>Descargas: nuestra p\u00e1gina de descargas alternativa.</li> </ul> <ul> <li>Juegos Gratuitos: juegos que son completamente legales descargar y jugar en emuladores.</li> </ul> <ul> <li>Mi juego no esta cargando logros: que hacer cuando tu juego no esta cargando logros.</li> </ul> <ul> <li>Porque no deber\u00edas de utilizar la opci\u00f3n de salvar estados (load state): porque deber\u00edas de esperar tener problemas si salvas/cargas estados mientras juegas.</li> </ul> <ul> <li>Un mensaje para los Cazadores de Logros y Completistas sobre las revisiones: porque no deber\u00edas de frustrarte cuando una revisi\u00f3n en un set de logros es publicada.</li> </ul> <ul> <li>Como contribuir si no eres un desarrollador: si no sabes como crear logros, hay muchas otras maneras para contribuir en la comunidad.</li> </ul> <p>Puedes ayudar a mejorar los documentos editando/creando paginas en la Wiki de RetroAchievements.</p>"},{"location":"Home-es/#traducciones","title":"Traducciones","text":"<ul> <li>English (original)</li> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"Home-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-18 08:01] meleu:</code> enlace para el Manifiesto</li> <li><code>[2019-04-17 13:49] meleu:</code> using partial URI</li> <li><code>[2019-04-17 09:04] ShinyNinetalesTM:</code> fixed punctuation in several words, fixed some typos and rewrited some phrases to emphatize context</li> <li><code>[2019-04-17 08:48] ShinyNinetalesTM:</code> fixed link to Download-es</li> <li><code>[2019-04-16 12:07] eldexterr:</code> fixed typos</li> <li><code>[2019-04-16 12:05] eldexterr:</code> Updated Home es (markdown)</li> <li><code>[2019-04-16 15:48] meleu:</code> original version</li> </ul>"},{"location":"Home-fr/","title":"Home fr","text":""},{"location":"Home-fr/#_1","title":"Home fr","text":"<p>Bienvenue sur la documentation de RetroAchievements!</p> <p>Dans un premier temps, vous devez lire et adh\u00e9rer au Code de conduite des utilisateurs. (en cours de traduction)</p> <p>Si vous cherchez de la documentation sur la cr\u00e9ation d'achievements, jetez un oeil \u00e0 la documentation pour d\u00e9veloppeurs. (en cours de traduction)</p> <p>Nous vous encourageons \u00e0 rejoindre notre serveur Discord, nous l'utilisons pour communiquer la plupart des informations.</p> <p>La liste compl\u00e8te des pages est disponible dans la barre lat\u00e9rale mais voici une rapide description : - FAQ: les questions fr\u00e9quemment pos\u00e9es (comme quelle version de RetroArch je devrais utiliser?). (en cours de traduction)</p> <ul> <li>R\u00e8gles des leaderboard globaux et Chasse aux achievements: explique les r\u00e8gles pour les leaderboards globaux, les param\u00e8tres traqu\u00e9s, ce qui est consid\u00e9r\u00e9 comme de la triche, etc... (en cours de traduction)</li> </ul> <ul> <li>T\u00e9l\u00e9chargements: notre page de t\u00e9l\u00e9chargement alternative. (en cours de traduction)</li> </ul> <ul> <li>Jeux gratuits: liste des jeux t\u00e9l\u00e9chargeables gratuitement et l\u00e9galement sur notre plateforme. (en cours de traduction)</li> </ul> <ul> <li>Mon jeu ne charge pas les achievements correctement: Que faire lorsque votre jeu ne charge pas ses achievements. (en cours de traduction)</li> </ul> <ul> <li>Pourquoi je ne dois pas utiliser les save/load states: les probl\u00e8mes que vous pouvez rencontrer en utilisant des save states. (en cours de traduction)</li> </ul> <ul> <li>Un message pour les compl\u00e9tionniste et les chasseurs d'achievements: pourquoi vous ne devez pas vous sentir frustr\u00e9 quand une r\u00e9vision est faite sur un set d'achievement. (en cours de traduction)</li> </ul> <ul> <li>Comment contribuer si vous n'\u00eates pas un d\u00e9veloppeur: si vous ne savez pas comment d\u00e9velopper des achievements, il y a plein d'autres moyen d'aider la communaut\u00e9. (en cours de traduction)</li> </ul> <p>Vous pouvez \u00e9diter/ajouter de la documentation sur le wiki de RetroAchievements.</p>"},{"location":"Home-fr/#translations","title":"Translations","text":"<ul> <li>Portuguese</li> <li>Spanish</li> <li>English</li> </ul>"},{"location":"Home-pt_BR/","title":"In\u00edcio","text":"<p>Bem-vindo ao Projeto de documenta\u00e7\u00e3o do Retroachievements!</p> <p>Rec\u00e9m chegados, por favor iniciem pelo Manifesto RetroAchievements e com o FAQ.</p> <p>N\u00f3s encorajamos todos os membros da comunidade a se juntar ao nosso Servidor do Discord, n\u00f3s usamos isto para maior comunica\u00e7\u00e3o.</p> <p>Voc\u00ea pode aprender como criar suas pr\u00f3prias conquistas lendo nossos Documentos para Desenvolvedores.</p> <p>Voc\u00ea pode ajudar a melhorar esses documentos editando/criando as p\u00e1ginas no RetroAchievements wiki.</p>"},{"location":"Home-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-22 07:52] meleu:</code> https</li> <li><code>[2020-09-10 01:43] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2020-09-10 01:04] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2019-02-10 16:01] meleu:</code> remove broken link</li> <li><code>[2018-06-10 10:44] lilbud:</code> Updated Discord Link</li> <li><code>[2018-03-25 10:14] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-25 11:56] KingDice001:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-25 11:42] KingDice001:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-24 23:38] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-24 18:36] KingDice001:</code> Updated Home pt_BR (markdown)</li> </ul>"},{"location":"Home-tr_TR/","title":"Home tr TR","text":"<p>RetroAchievements belgelerine ho\u015f geldiniz!</p> <p>Her \u015feyden \u00f6nce, Kullan\u0131c\u0131 Davran\u0131\u015f Kurallar\u0131n\u0131 bilmeli ve bunlara uymal\u0131s\u0131n\u0131z.</p> <p>Ba\u015far\u0131 olu\u015fturma hakk\u0131nda dok\u00fcmanlar ar\u0131yorsan\u0131z, Geli\u015ftirici dok\u00fcmanlar\u0131 b\u00f6l\u00fcm\u00fcm\u00fcz\u00fc inceleyin.</p> <p>T\u00fcm topluluk \u00fcyelerini Discord Sunucumuza kat\u0131lmaya te\u015fvik ediyoruz, bunu \u00e7o\u011fu ileti\u015fim i\u00e7in kullan\u0131yoruz.</p> <p>Sayfalar\u0131n tam listesi kenar \u00e7ubu\u011fundad\u0131r, ancak bunlardan baz\u0131lar\u0131n\u0131n k\u0131sa bir a\u00e7\u0131klamas\u0131:</p> <ul> <li>SSS: S\u0131k\u00e7a Sorulan Sorular (hangi RetroArch Core'u kullanmal\u0131y\u0131m?).</li> </ul> <ul> <li>Global Liderlik ve Ba\u015far\u0131 Av Kurallar\u0131: Global Liderlik i\u00e7in kurallar, \u0130zlenmeyen durum nedir, aldatma say\u0131labilir, vb.</li> </ul> <ul> <li>\u0130ndirilenler: alternatif indirme sayfam\u0131z.</li> </ul> <ul> <li>\u00dccretsiz Oyunlar: tamamen ve yasal olarak \u00fccretsiz olan ve em\u00fclat\u00f6rlerine oynayaca\u011f\u0131n\u0131z oyunlar.</li> </ul> <ul> <li>Oyunum ba\u015far\u0131lar\u0131 y\u00fcklemiyor: oyununuz ba\u015far\u0131lar\u0131 y\u00fcklemiyorsa yapman\u0131z gerekenler.</li> </ul> <ul> <li>Y\u00fck durumu \u00f6zelli\u011fini neden kullanmamal\u0131s\u0131n\u0131z: oynat\u0131rken kaydetme / y\u00fckleme durumunu kullan\u0131yorsan\u0131z neden sorun ya\u015faman\u0131z\u0131 beklemelisiniz.</li> </ul> <ul> <li>Ba\u015far\u0131 Avc\u0131lar\u0131 ve Tamamlay\u0131c\u0131lara revizyonlarla ilgili bir mesaj: bir ba\u015far\u0131 setinde bir revizyon yap\u0131ld\u0131\u011f\u0131nda neden sinir bozmaman\u0131z gerekti\u011fini.</li> </ul> <ul> <li>Bir geli\u015ftirici de\u011filseniz, nas\u0131l katk\u0131da bulunabilirsiniz: Ba\u015far\u0131lar\u0131n nas\u0131l geli\u015ftirilece\u011fini bilmiyorsan\u0131z, toplulu\u011fa katk\u0131da bulunman\u0131n bir\u00e7ok yolu vard\u0131r.</li> </ul> <p>Bu dok\u00fcmanlar\u0131 RetroAchievements wiki'de sayfalar\u0131 d\u00fczenleyerek / olu\u015ftururken daha iyi hale getirebilirsiniz.</p>"},{"location":"Home-tr_TR/#ceviriler","title":"\u00c7EV\u0130R\u0130LER","text":"<ul> <li>PORTEKIZCE</li> <li>ISPANYOLCA</li> </ul>"},{"location":"Home/","title":"Home","text":"<p>Welcome to the RetroAchievements documentation!</p> <p>The docs are currently under heavy construction so be sure to check back often! Each section appears in the sidebar, but here is a brief explanation of the categories:</p> <ul> <li>Guidelines: Details community, user/player, developer, and content policies.</li> <li>General: FAQ, getting started, support/troubleshooting, and other info that can be useful to all members of the community.</li> <li>Achievement Development: Extensive information on both the conceptual and technical aspects of making achievements.</li> </ul> <p>We encourage all community members to join our Discord Server; we use this for most communication.</p> <p>Translations</p> <ul> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"Home/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 14:29] televandalist:</code> Removed the RA logo from the top since the link was broken</li> <li><code>[2023-06-30 12:36] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-30 12:14] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-06 10:35] televandalist:</code> Fix broken link</li> <li><code>[2023-04-13 15:08] televandalist:</code> Removed the links to pages that deal with specific support questions. They should/will be merged with a support section or the FAQ to declutter the home page.</li> <li><code>[2023-04-13 14:51] televandalist:</code> Removed link to \"Free Games\" section. While they are free homebrews, the downloads are typically on site if they actually have a set. If they aren't, they should be.</li> <li><code>[2022-08-23 20:22] Jazerus:</code> grammar fixes</li> <li><code>[2022-02-18 21:24] televandalist:</code> Add Event page link</li> <li><code>[2021-04-21 10:23] meleu:</code> french docs are yet incomplete</li> <li><code>[2020-09-07 09:06] meleu:</code> add Manifesto</li> </ul>"},{"location":"How-RA-Documentation-Works-es/","title":"Como funciona la Documentaci\u00f3n de RA","text":"<p>Este proyecto de documentaci\u00f3n de RetroAchievements junta las gu\u00edas, tutoriales, tips y trucos sobre el desarrollo de RetroAchievements y cualquier otra informaci\u00f3n interesante para la comunidad.</p> <p>Antes de que se empezara este proyecto la informaci\u00f3n sobre el desarrollo de logros estaba esparcida en varios posts del foro en RetroAchievements.org, haciendo la experiencia de aprendizaje mas complicada para el desarrollador novato. Este proyecto comenz\u00f3 trayendo el material de los posts del foro hacia aqu\u00ed, pero en un orden mas ordenado y coherente.</p> <p>La Documentaci\u00f3n de RetroAchievements se divide en dos partes:</p> <ol> <li>Wiki de RetroAchievements</li> <li>Documentos de RetroAchievements</li> </ol> <p>La wiki es donde los documentos son creados y editados. Cualquiera (con una cuenta de github) es capaz de editar el contenido de la wiki. As\u00ed que, si tienes algo que compartir, por favor edita la wiki!</p> <p>El sitio web de los documentos de RetroAchievements tiene (la mayor\u00eda) el mismo contenido que la wiki, pero con un look mas placentero. El contenido de este sitio web es generado por sus moderadores utilizando el contenido de la wiki como su m\u00e9todo de entrada.</p> <p>Cuando un cambio es hecho en la wiki este cambio NO es instant\u00e1neamente reflejado en los documentos. La conversi\u00f3n es realizada por un moderador cada cierto tiempo.</p>"},{"location":"How-RA-Documentation-Works-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 14:02] eldexterr:</code> Created How RA Documentation Works es (markdown)</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/","title":"Como convertirme en un Desarrollador de Logros","text":"<p>Este documento describe todos los pasos que cualquier aspirante a desarrollador de logros tiene que seguir antes de conseguir estatus de Desarrollador. Estos requisitos tambi\u00e9n son una lista para los Rese\u00f1adores de C\u00f3digo (desarrolladores que inspeccionan el c\u00f3digo de nuevos desarrolladores).</p> <p>Cualquiera puede convertirse en un desarrollador en RetroAchievements si pone el suficiente esfuerzo.</p> <p>Opcional pero fuertemente recomendado: \u00fanete a nuestro servidor de Discord y pregunta a un moderador darte el rol de <code>jr-dev</code>. Utiliza los canales #help-me y #devs cada vez que cuentes con alguna pregunta.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#conocimiento-requerido","title":"Conocimiento requerido","text":"<p>Cada desarrollador tiene que m\u00ednimo conocer los conceptos b\u00e1sicos y t\u00e9cnicas mostradas en estos dos documentos:</p> <ol> <li>Empezando como un desarrollador de logros</li> <li>Caracteristicas en la l\u00f3gica de un logro</li> </ol> <p>Cualquier aspirante a desarrollador tiene que demostrar seguir y entender los siguientes conceptos:</p> <ul> <li>B\u00fasqueda B\u00e1sica en la RAM (que se te familiarice el Inspector de Memoria)</li> <li>Notaciones Hexadecimales</li> <li>Valores Delta</li> <li>Hit counts</li> <li>Pause If</li> <li>Reset If</li> <li>Alt Groups</li> <li>Tama\u00f1o de la Memoria: 8-bit y single bit</li> <li>Comparadores en la logica de los Logros mas all\u00e1 de <code>=</code>, por ejemplo <code>&gt;</code>, <code>&lt;</code>, <code>!=</code></li> <li>A\u00f1adir badges/medallas a un logro</li> <li>Crear descripciones certeras en los logros</li> <li>A\u00f1adir las protecciones adecuadas</li> <li>Hacer un set de logros estable</li> </ul> <p>Nota: Tu no necesitas el dominio total de todos estos conceptos para tener un set publicado, pero si los necesitas para obtener un rol como desarrollador completo.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#conceptos-avanzados","title":"Conceptos Avanzados","text":"<p>Aqu\u00ed hay una lista de algunos conceptos/t\u00e9cnicas. No son requisito para convertirte en un Desarrollador, pero est\u00e1n en listadas aqu\u00ed para mostrar al desarrollador jr. (jr-dev) las posibilidades de la l\u00f3gica de los logros.</p> <ul> <li>Hit count como un temporizador (como en este ejemplo y este otro)</li> <li>ResetIf Checkpoints</li> <li>ResetIf con Hitcount</li> <li>PauseIf con Hitcount</li> <li>Las banderas AddSource y SubSource</li> <li>Bandera AddHits</li> <li>Incrementar contador (<code>Valor en Memoria &gt; Valor Delta</code> Contador)</li> <li>Contador de Hits Delta, t\u00e9cnica de pausado</li> <li>Little endianness</li> <li>Tama\u00f1o de Memoria: Lower4, Upper4, y 16-bit, 32-bit</li> <li>Rich Presence din\u00e1mico</li> <li>Tablas de Clasificaci\u00f3n</li> <li>Resets pausables</li> <li>Contador en el incremento de un SubSource</li> </ul> <p>Los Ejemplos Reales y las Plantillas de Logros son paginas \u00fatiles para ver como estas t\u00e9cnicas funcionan.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#practicando","title":"Practicando","text":"<p>En orden para que se te conviertan familiares todas estas t\u00e9cnicas b\u00e1sicamente tienes que practicar. Puedes utilizar cualquier juego para practicar, incluso esos que ya cuentan con logros. Simplemente ten estas reglas en mente:</p> <ul> <li>NO borres/sobre-escribas cualquier Nota de C\u00f3digo existente.</li> </ul> <ul> <li>En esta fase de practica, mant\u00e9n tu trabajo en local y NO subas ning\u00fan logro. Esto lo vas a hacer despu\u00e9s cuando realmente encuentres un juego en el ya vallas a trabajar.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/#buscando-un-juego-el-cual-trabajar","title":"Buscando un juego el cual trabajar","text":"<p>Sigue los Reglamentos en el C\u00f3digo de Conducta del Desarrollador para as\u00ed encontrar un juego en el cual trabajar. B\u00e1sicamente lo que primero necesitas es declarar tus planes de trabajo sobre el juego en el que quieras trabajar en el foro del mismo, y mientras vallas trabajando en el juegos a\u00f1adir tus planes mas detallados en el mismo foro.</p> <p>Tip: para tu primer set de logros es recomendable que escojas un juego que aun no tiene logros y que no es muy popular.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#planeando-tu-set-de-logros","title":"Planeando tu Set de Logros","text":"<p>Una vez que encuentras un juego el cual trabajar necesitas planificar tu Set de Logros.</p> <p>Ten en cuenta conocer lo suficientemente bien el juego para as\u00ed hacer un buen set. Checa su pagina de GameFAQs o algo parecido, intenta aprender mas sobre el videojuego, sus secretos y detalles. Aqu\u00ed hay una buena gu\u00eda que te podr\u00eda servir de ayuda con esto: Mapa de Desarrollo del Set.</p> <p>Postea tus planes en el foro oficial del juego, para que as\u00ed la comunidad pueda dejar sugerencias y retroalimentacion. Esta actitud es requerida para todo tipo de desarrolladores y desarrolladores jr. (jr-dev).</p> <p>IMPORTANTE!: estate abierto en recibir retroalimentacion y sugerencias.</p> <p>Tambi\u00e9n mira: Dise\u00f1o de Logros, es una gu\u00eda extensiva en como dise\u00f1ar buenos e interesantes logros. No sobre el lado t\u00e9cnico sino el conceptual.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#publica-tus-logros-en-unofficial-para-revision","title":"Publica tus logros en Unofficial para revisi\u00f3n","text":"<p>Despues de haber creado varios logros, promuebelos a Unofficial y despu\u00e9s contacta a un @mod o aun @code-reviewer en nuestro servidor de Discord (si no utilizas Discord, manda un mensaje a RAdmin) y pregunta por alguien que pueda rese\u00f1ar tu trabajo.</p> <p>Otra vez, es extremadamente importante que est\u00e9s abierto a recibir critica constructiva y ayuda de parte de la comunidad en cualquier momento.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#estoy-listo-para-conseguir-estatus-de-desarrollador","title":"Estoy listo para conseguir estatus de Desarrollador?","text":"<p>Una vez que los Rese\u00f1adores de C\u00f3digo han inspeccionado el c\u00f3digo de tus logros y conceptos, ellos y el administrador van a utilizar el \"Conocimiento Requerido\" en la lista de requisitos de arriba para determinar si estas listo. Si no estas completamente calificado para ser un desarrollador pero tu set esta completo y estable el set va a ser publicado. Puedes preguntar que conceptos aun necesitas para demostrar tu capacidad para obtener tu estatus como desarrollador.</p> <p>Los m\u00e9ritos para que un desarrollador jr. (jr-dev) reciba un estatus de desarrollador dependen en:</p> <ul> <li>su habilidad en publicar trabajo que contengan el est\u00e1ndar del C\u00f3digo de Conducta del Desarrollador;</li> <li>demostrar el conocimiento requerido y conceptos avanzados;</li> <li>la calidad y complejidad de su trabajo;</li> <li>el tiempo y pensamiento que puso en planificar y trabajar los logros;</li> <li>mostrando el deseo en utilizar el estatus como desarrollador con cuidado y responsabilidad;</li> <li>la medida en que los puntos anteriores reflejan sus capacidades como desarrollador.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/#codigo-de-conducta-del-desarrollador","title":"C\u00f3digo de Conducta del Desarrollador","text":"<p>Una vez que hubieras conseguido tu estatus como desarrollador, tu TIENES que adherirte a el C\u00f3digo de Conducta del Desarrollador. Eso es extremadamente importante para crear un ambiente justo entre los Desarrolladores de Logros.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:30] meleu:</code> fix links</li> <li><code>[2019-04-17 17:26] eldexterr:</code> Find some typos</li> <li><code>[2019-04-16 14:50] meleu:</code> page title en espa\u00f1ol</li> <li><code>[2019-04-16 14:42] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:58] meleu:</code> Updated How to Become an Achievement Developer ES (markdown)</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/","title":"How to Become an Achievement Developer","text":"<p>This document describes all the steps that any aspiring achievement developer must follow before getting Developer status. These requirement are also a checklist for Code Reviewers (developers who inspect the code of new developers).</p> <p>Anyone can become a RetroAchievements developer if they put in the effort.</p> <p>Strongly recommended: join our Discord server so you can get in contact with other achievement developers who can show you the ropes and help you along. If you already know what game you want to work on, go ahead and ask for the <code>jr-dev</code> role in <code>#tech-support</code> forum by creating a post tagged as <code>Join Team</code> and pinging <code>@QA-Maintainer</code> (Make sure to first get your account verified by following instructions in <code>#welcome</code> if you haven't already). This gives you access to the <code>#jr-devs</code> channel, where you can talk to code reviewers and ask any development related questions.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#finding-a-game-to-work-on","title":"Finding a Game to Work on","text":"<p>Follow the guidelines on the Developer's Code of Conduct to find a game to work on achievements for it. The basics are that you must declare you plans to work on the game on in the forum, and then as you work on the game, add your plans for the game in the forum.</p> <p>Tip: for your first achievement set it's recommended to choose a game that doesn't yet have achievements and is not very popular.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#planning-your-achievement-set","title":"Planning your Achievement Set","text":"<p>Once you find a game to work on you need to plan your Achievement Set.</p> <p>Be sure you know enough about the game to make a good set. Check the GameFAQs or something, try to learn more about the game, its secrets and details. Here is a good guide to help you with this: Set Development Roadmap.</p> <p>Post your plans on the official game's forum topic, so the community can leave suggestions and provide feedback. This is required behavior for all devs and jr-dev.</p> <p>IMPORTANT!: be open to receive feedback and suggestions.</p> <p>See also: Achievement Design, it's an extensive guide on how to design good and interesting achievements. It's not about the technical side but the conceptual.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#required-knowledge","title":"Required Knowledge","text":"<p>Every developer must know at least the basic concepts and techniques shown in these two docs:</p> <ol> <li>Getting Started as an Achievement Developer</li> <li>Achievement Logic Features</li> </ol> <p>Any aspiring dev must demonstrate understanding of the following concepts:</p> <ul> <li>Basic RAM digging (be familiar with the Memory Inspector)</li> <li>Hexadecimal notation</li> <li>Delta values</li> <li>Hit counts</li> <li>Pause If</li> <li>Reset If</li> <li>Alt Groups</li> <li>Memory sizes: 8-bit and single bit</li> <li>Achievement logic comparisons besides <code>=</code>, such as <code>&gt;</code>, <code>&lt;</code>, <code>!=</code></li> <li>Adding badges to an achievment</li> <li>Creating accurate descriptions for achievements</li> <li>Add appropriate protections</li> <li>Make a stable achievement set</li> </ul> <p>Note: You do not need mastery of all these concepts to have a set published, but you do need them to have the full Developer role.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#advanced-concepts","title":"Advanced Concepts","text":"<p>Here is a list of some advanced concepts/techniques. They are not required to become a Developer, but are listed here to let the jr-dev know the possibilities of the Achievement's logic.</p> <ul> <li>Hit count as timer (like in this example and this one)</li> <li>ResetIf Checkpoints</li> <li>ResetIf with Hitcount</li> <li>PauseIf with Hitcount</li> <li>AddSource and SubSource Flags</li> <li>AddHits and SubHits Flag</li> <li>Increment counter (<code>Mem &gt; Delta</code> Counter)</li> <li>Delta Hit Counter, pause technique</li> <li>Little endianness</li> <li>Memory size: Lower4, Upper4, and 16-bit, 32-bit</li> <li>Dynamic Rich Presence</li> <li>Leaderboards</li> <li>Pausable Resets</li> <li>SubSource increment counter</li> </ul> <p>The Real Examples and Achievement Templates pages are useful resources to see how those techniques work.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#code-notes","title":"Code Notes","text":"<p>Junior developers can create and delete code notes that they have created, but they cannot delete or edit any notes created by others. Developers CAN edit and remove notes by other users, and these changes are site-wide.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#practicing","title":"Practicing","text":"<p>In order to become familiar to those techniques you must practice. You can use any game to practice, even those that already have achievements. Just be aware about these rules:</p> <ul> <li>Do NOT delete/overwrite any existing Code Note.</li> </ul> <ul> <li>On this practicing phase, keep your work in local and do NOT upload any achievement. You'll do it later when you find a game to actually work on.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/#get-your-work-reviewed","title":"Get your work reviewed","text":"<p>After creating some achievements, upload them to Unofficial and then create a post in <code>#jr-dev-forum</code> on our Discord server (if you don't use Discord, send a message to RAdmin) and ask them to find someone to review your work.</p> <p>Do NOT ask another developer to promote your achievements to the Core without a proper review.</p> <p>Again, it's extremely important that you are open to receive constructive criticism and helpful advice from the community at any time.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#am-i-ready-to-get-the-developer-status","title":"Am I ready to get the Developer status?","text":"<p>Once the Code Reviewers have inspected your achievement's code and concepts, they and the admin will use the \"Required Knowledge\" checklist above to determine if you're ready. If you're not fully qualified to be a developer yet, but your set is complete and stable, the set will get published. You can then ask which concepts you still need to demonstrate proficiency in to be given developer status.</p> <p>The merit of a jr-dev receiving developer status depends on:</p> <ul> <li>their ability to publish work that meets the standards of the Developer's Code of Conduct;</li> <li>demonstration of required knowledge and advanced concepts;</li> <li>the quality and complexity of their work;</li> <li>the time and thought they put into planning and working on achievements;</li> <li>showing the will to use the Developer status with care and responsibility;</li> <li>the extent to which the points above reflect their capabilities as a developer.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/#developers-code-of-conduct","title":"Developer's Code of Conduct","text":"<p>Once you get your Developer status, you MUST adhere to the Developer's Code of Conduct. That is extremely important to create a fair environment between the Achievement Developers.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 10:41] televandalist:</code> Fix broken link</li> <li><code>[2023-03-29 21:18] Searo:</code> Typo</li> <li><code>[2023-03-29 20:56] Searo:</code> Update jr request wording after #help-me channel changed to #tech-support</li> <li><code>[2023-02-15 13:25] Riley Nielsen:</code> Updated How to Become an Achievement Developer (markdown)</li> <li><code>[2022-05-14 21:53] Searo:</code> Update QA-Team to QA-Maintainer</li> <li><code>[2022-05-02 17:52] RALordAndrew:</code> Updated How to Become an Achievement Developer (markdown)</li> <li><code>[2021-11-28 14:47] Searo:</code> Clarification on channel and team to ask for jr-dev role on Discord</li> <li><code>[2021-05-01 07:27] meleu:</code> fix link to AddHits page</li> <li><code>[2021-04-26 13:33] meleu:</code> fix links</li> <li><code>[2021-04-26 13:31] meleu:</code> fix link</li> </ul>"},{"location":"How-to-configure-OBS-Studio-to-see-the-popups/","title":"How to configure OBS Studio to see the popups","text":"<p>In \"Window Capture\" mode, OBS Studio will not capture the popups. The popups are rendered using a \"Layered Window\", and OBS Studio removed support for capturing layered windows</p> <p>If you want to include the popups in your stream, you have two options: change to \"Display Capture\" mode, or add a second \"Window Capture\" for the \"TransparentOverlayWindow\". This page will attempt to walk you through doing the second.</p> <p>Add a second \"Window Capture\" source to the Scene. In the popup dialog, select the \"TransparentOverlayWindow\".</p> <p></p> <p>You'll probably notice the window is pink.</p> <p></p> <p>Add a filter to the second \"Window Capture\"</p> <p></p> <p>Add a \"Color Key\" filter, set the Key Color Type to \"Custom Color\", then use the Select Color dialog to enter <code>#FF01FE</code> as the color. Decrease the similarity to 1 and the opacity to 90.</p> <p></p> <p>Finally, if you still have a bit of a pink border showing up, enable a Scale Filter. They all seem to eliminate the remnant, so choose whichever you like best.</p> <p></p>"},{"location":"How-to-configure-OBS-Studio-to-see-the-popups/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-06-30 17:06] Jamiras:</code> Created How to configure OBS Studio to see the popups (markdown)</li> </ul>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/","title":"Como contribuir si no eres un desarrollador","text":"<p>Incluso si tu no sabes como crear logros aun hay varias maneras para contribuir con la comunidad de RetroAchievements. Aqu\u00ed se encuentran algunos ejemplos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportar-logros-rotos","title":"Reportar logros rotos","text":"<p>Si tu logro se disparo en el momento equivocado o no se disparo del todo, por favor reportalo. Sabemos que a muchos usuarios le gustan los puntos gratis, pero por favor, incluso si un logro se disparo en el momento equivocado, reportalo!</p> <p>Otra situaci\u00f3n que tambi\u00e9n merece ser reportada es cuando un logro se dispara por medio del uso de un cheat en el juego (ej. c\u00f3digo de selecci\u00f3n de stages), o cargando un archivo de guardado.</p> <p>Hay dos maneras para reportar un logro roto: directamente desde el emulador o por medio de la pagina web. En los dos casos, agrega detalles del estado de tu juego, cuando se disparo/no se disparo, cual modo de juego, donde estabas cuando paso/no paso, si reseteaste el juego recientemente, cualquier cosa que pienses que podr\u00eda resultar relevante para el logro. Esto es necesario para que los desarrolladores encuentren donde esta el problema.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportando-por-medio-del-emulador","title":"Reportando por medio del emulador","text":"<p>Ve a RetroAchievements -&gt; Report Broken Achievements, esta funci\u00f3n solamente esta disponible en emuladores oficiales (no en RetroArch).</p> <p>Mira este ejemplo:</p> <p>.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportar-por-medio-del-sitio-web","title":"Reportar por medio del sitio web","text":"<p>En la pagina de cada logro podr\u00e1s ver un link que dice <code>Report an issue for this achievement</code>, como en la imagen de abajo:</p> <p></p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#sugiere-buenos-logrosretos","title":"Sugiere buenos logros/retos","text":"<p>Si conoces un juego bastante bien, probablemente tal vez tengas algunas ideas muy cool sobre retos para el juego. Postea tus ideas en el foro del juego.</p> <p>Tenemos una gu\u00eda en como pensar y dise\u00f1ar buenos logros, no el lado t\u00e9cnico sino el conceptual. Que incluso los que no son desarrolladores pueden llegar a conseguir un poco de inspiraci\u00f3n de ese documento.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#la-retro-alimentacion-es-siempre-bienvenida","title":"La retro-alimentaci\u00f3n es siempre bienvenida","text":"<p>Deja retro-alimentaci\u00f3n en los foros sobre que te gusta o que te disgusta sobre un set de logros. Se especifico y deja cada detalle.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#haz-iconosemblemas-para-logros","title":"Haz iconos/emblemas para logros","text":"<p>Si te gusta jugar con gr\u00e1ficos puedes crear alg\u00fan arte para los emblemas o iconos de juegos. Utilizando la opci\u00f3n de captura de pantalla del emulador puede llegar a ser \u00fatil para esto, y entonces puedes editarlo para hacer llegar a hacer algo muy cool.</p> <p>Puedes encontrar mas informaci\u00f3n en la pagina de creaci\u00f3n de Badges e Iconos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#ayuda-con-la-documentacion","title":"Ayuda con la documentaci\u00f3n","text":"<p>Si cuentas con una cuenta de github y conoces lo b\u00e1sico del Markdown, puedes ayudar con la documentaci\u00f3n. Corregir errores ortogr\u00e1ficos, gramaticales o informaci\u00f3n err\u00f3nea.</p> <p>Hecha un vistazo a esta pagina para conocer los detalles: Contribuyendo con los documentos</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#participa-en-los-eventos-de-la-comunidad","title":"Participa en los eventos de la comunidad","text":"<p>Como Logro de la Semana, Tabla Clasificatoria de la Semana u otros eventos que suceden en nuestro servidor de discord.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 13:00] eldexterr:</code> Created How to contribute if you are not a developer es (markdown)</li> </ul>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/","title":"Como contribuir se Voc\u00ea n\u00e3o for um Desenvolvedor","text":"<p>Link para o texto em ingl\u00eas: How to contribute if you're not a developer</p> <p>Mesmo que voc\u00ea n\u00e3o saiba como criar conquistas existem muitas formas de contribuir com a comunidade RetroAchievements. Aqui est\u00e3o alguns exemplos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#reportar-conquistas-quebradas","title":"Reportar conquistas quebradas","text":"<p>Se uma conquista ativar em um tempo errado ou n\u00e3o ativar, por favor reporte.</p> <p>Outra importante situa\u00e7\u00e3o que precisa ser reportada \u00e9 uma conquista ativando por usar algum tipo de trapa\u00e7a no jogo (ex. c\u00f3digo de sele\u00e7\u00e3o de fase), ou por carregar um jogo salvo (arquivos de save)</p> <p>Para reportar uma conquista quebrada, v\u00e1 em RetroAchievements -&gt; Report Broken Achievements, esse recurso s\u00f3 est\u00e1 dispon\u00edvel em emuladores oficiais (n\u00e3o no RetroArch).</p> <p>Veja este exemplo:</p> <p>.</p> <p>Detalhes adicionais do estado do seu jogo, quando ativa/n\u00e3o ativa, que modo de jogo, onde voc\u00ea est\u00e1 quando aconteceu/n\u00e3o aconteceu, se voc\u00ea teve que resetar o jogo recentemente, qualquer outra coisa que voc\u00ea acha que pode ser relevante para a conquista. Isso \u00e9 necess\u00e1rio para o nosso sistema, para que os desenvolvedores saibam onde est\u00e1 o problema.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#sugerir-conquistas-legaisdesafios","title":"Sugerir conquistas legais/desafios","text":"<p>Se voce conhece um jogo muito bem, voc\u00ea provavelmente pode ter algumas ideias interessantes de desafios para o jogo. Poste suas ideias no forum relacionado ao jogo.</p> <p>Nos temos um guia sobre como pensar e projetar boas conquistas, n\u00e3o o lado t\u00e9cnico, mas o conceitual. Entao at\u00e9 os n\u00e3o-desenvolvedores podem ter alguma inspira\u00e7\u00e3o a partir daquela informa\u00e7\u00e3o.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#feedback-e-sempre-bem-vindo","title":"Feedback \u00e9 sempre bem-vindo","text":"<p>Dar Feedback (coment\u00e1rios) nos foruns sobre qual voc\u00ea gosta ou n\u00e3o gosta sobre a lista de conquista. Seja espec\u00edfico e deixe detalhes</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#faca-icones-para-as-conquistas","title":"Fa\u00e7a \u00edcones para as conquistas","text":"<p>Se voc\u00ea gosta de brincar com gr\u00e1ficos, voc\u00ea pode criar algumas artes para os \u00edcones das conquistas ou os \u00edcones para os jogos. Usando o recurso de screenshot (captura de tela) do emulador em si pode ajudar com isso, e entao voc\u00ea pode editar para fazer algo legal.</p> <p>Voc\u00ea pode ver mais informa\u00e7\u00f5es sobre a P\u00e1gina de Cria\u00e7\u00e3o de Icones.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#participe-em-eventos-da-comunidade","title":"Participe em eventos da comunidade","text":"<p>Como a \"Conquista da Semana\" (Achievement of the Week), Ranking da semana (Leaderboard of the Week) ou outros eventos que acontecem no nosso servidor do Discord.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-06-10 10:56] lilbud:</code> Uploaded new gif showing reporting broken achievements</li> <li><code>[2018-06-10 10:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-04-02 19:02] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-28 20:11] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-25 12:00] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-25 11:45] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 22:15] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 21:02] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 21:02] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 20:53] KingDice001:</code> Created How to contribute if you are not a developer-pt_BR (markdown)</li> </ul>"},{"location":"How-to-run-RALibretro-on-Linux/","title":"How to run RALibretro on Linux","text":"<p>To be done...</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/","title":"HowTo Scrape Achievement List to CSV for Rescore and Revision Updates","text":"<p>This is a fast and easy method to scrape all Achievements, Descriptions or other useful information from RetroAchievements into a CSV format which can be posted in Forums and Discord for sharing Rescore and Revision Update plans.</p> <ol> <li>Download the Chrome Extension from https://simplescraper.io</li> <li>Browse to the Game Page you want to Scrape the Achievement List from (example: https://retroachievements.org/game/11256)</li> <li>Click on 'Launch Simple Scraper' and choose 'Scrape this website'</li> <li>Choose 'Add a property'</li> <li>Now you can select what information you want to scrape, click on the Achievements</li> <li>The number of selected items must match the number of Achievements on the Site</li> </ol> <p>(!) you can change the scraping content manually in the appearing box below 'propertyName1'.</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#for-rescoring-updates-scrape-achievements-only","title":"For Rescoring Updates - scrape Achievements only","text":"<ul> <li><code>div.achievemententry div.achievementdata a</code></li> <li><code>.achievementdata a</code></li> </ul>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#for-revision-updates-scrape-achievements-and-descriptions","title":"For Revision Updates - scrape Achievements and Descriptions","text":"<ul> <li><code>div.achievemententry div.achievementdata</code></li> <li><code>.achievementdata</code></li> </ul> <ol> <li>Click on the checkmark to confirm the selection and choose 'View Results'</li> <li>A new tab should open, now click on CSV to download the Achievement List</li> <li>Upload the downloaded CSV file to Google Drive and open it with Google Sheets</li> </ol> <p>(!) Scraped Achievements with Descriptions can be seperated by splitting the columns with '\\n'.</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#upload-and-split-into-columns-in-google-sheets","title":"Upload and split into columns in Google Sheets","text":"<ol> <li>In Google Sheets, select <code>A</code> (must be marked) and choose 'Data' then 'Split text to columns', 'custom' and insert <code>\\n</code>.</li> </ol> <p>Please check Achievement-Set-Revisions for more information regards Recore and Revision Updates.</p>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/","title":"Leaderboard bug list and improvement ideas","text":""},{"location":"Leaderboard-bug-list-and-improvement-ideas/#bugs","title":"Bugs","text":"<ul> <li>Leaderboards only show the top 5 during the popup submit results, not your position (if you're not in the top 5). Show the player rank seems to be the right thing to do.</li> <li>Cancel only takes action on the first condition, everything else is ignored.</li> <li>Fix leaderboard order bug, the order specified by the dev is ignored instead displaying order of creation.</li> <li>Submission dates are not updating when an improved score is submitted. (The rank is updating)</li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#improvement-ideas","title":"Improvement Ideas","text":""},{"location":"Leaderboard-bug-list-and-improvement-ideas/#general","title":"General","text":"<ul> <li>Make all leaderboard submits hardcore only.</li> <li>Always cancel on reset.</li> <li>Add clone leaderboard button.</li> <li>Usurp leaderboard: Change it so when a player matches a score the most recent entry goes on top.</li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#math-and-syntax","title":"Math and Syntax","text":"<ul> <li>Add syntax for hits/add reset?</li> <li>Exponents syntax especially x^0.</li> <li>Order of operation calculation.</li> <li>Multiple start/submit conditions ie alts/ORs for start/cancel/submit</li> <li>Allow for the multiplication of two or more addresses </li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#hidden-leaderboards-and-overlay","title":"Hidden Leaderboards and overlay","text":"<ul> <li>Add an option to have hidden leaderboards - choose if visible.</li> <li>Add an option to hide cancel popup.</li> <li>Make submit box smaller?</li> <li>Add an option to be able to choose location in overlay.</li> <li>Add an option to display popup text that's not for any leaderboard. Allow for control of how long the popup will stay?</li> <li>Able to change overlay color.</li> </ul> <p>Idea for on screen notification and an expansion on the idea: \"Add an option to display popup text that's not for any leaderboard. Allow for control of how long the popup will stay\"</p> <p>The point is to help the player track their progress on certain types of achievements.</p> <p>Using something similar to the leaderboard, when selected by the developer, allow hits to be displayed on screen. It could perhaps show hits, or the sum of hits from multiple conditions. </p> <p>Also, maybe with a similar text info as rich presence, where on screen it would display 4/9 Goomba's stomped. or 20/100 seconds survived or 9 items collected, etc.</p> <p>Beyond that, achievements with this type OSD info built in, they could either be turned on and off individually from the overlay. )Where they would always be off if the achievement was complete.) OR have a manual start and stop similar to leaderboards.</p> <p>This could be used to display failed attempts. For example a ResetIf could be marked as a failstate, when the reset happens OSD would show Escaping the cave without being seen: failed.</p>"},{"location":"Leaderboards-es/","title":"Tablas de Clasificaci\u00f3n","text":"<p>Actualmente las Tablas de Clasificaci\u00f3n pueden ser editadas por desarrolladores desde el sitio web. Es una interfaz bastante tosca y un trabajo algo complicado hacer que una tabla funcione de manera correcta. As\u00ed que en este documento vamos a intentar a entender como funciona.</p>"},{"location":"Leaderboards-es/#visiones-generales","title":"Visiones Generales","text":"<p>Asi es como se ve una lista de Tablas de Clasificaci\u00f3n de un juego en el sitio web:</p> <p></p> <p>En el centro puedes llegar a ver cada Tabla que a sido creada, y en la columna de la derecha puedes llegar a ver las Notas de C\u00f3digo del Juego. Las Notas est\u00e1n all\u00ed para ayudar en algunas de las condiciones que se encuentran aqu\u00ed abajo.</p> <p>Aqu\u00ed hay una breve explicaci\u00f3n de cada campo que se encuentra en una Tabla de Clasificacion:</p> <ul> <li>Titulo: El titulo de la tabla.</li> <li>Descripci\u00f3n: La descripci\u00f3n de la tabla.</li> <li>Formato: Puede llegar a ser <code>Puntuaci\u00f3n</code>, <code>Tiempo (Frames)</code>, <code>Tiempo (Milisegundos)</code> o <code>Valor</code>. Se utiliza para distinguir que tipo de tabla es (vamos a ver mas sobre esto mas abajo).</li> <li>\"LowerIsBetter\" checkbox: cuando se encuentra activada, significa que el valor mas bajo es mejor. Es usualmente el caso para logros basados en tiempo.</li> <li>Start: condiciones para empezar la tabla, aka STA.</li> <li>Cancel: condiciones para cancelar la tabla, aka CAN.</li> <li>Submit: condiciones para subir una entrada a la tabla, aka SUB.</li> <li>Value: valor que quieres que se suba a la tabla, aka VAL.</li> </ul> <p>Nota: Una tabla valida TIENE que tener todas estas cuatro condiciones.</p> <p>Esos \u00faltimos 4 campos son realmente importantes y se tiene que tomar MUCHO cuidado de acuerdo a los datos que vas a introducir en ellas. Es por eso que requieren una explicaci\u00f3n a continuaci\u00f3n:</p> <p>La condici\u00f3n STA o Start son una serie de valores, como un logro, que tienen que llegar a ser verdad en orden para que la tabla empieza a buscar una entrada para la tabla. Una vez que STA es verdadero, el juego va a activar las otras tres constantemente.</p> <p>Si la condici\u00f3n Cancel (CAN) es verdadera, entonces esta va a cancelar la tabla y no se va a subir la entrada a la misma. </p> <p>Si la condici\u00f3n Submit (SUB) es verdadera, entonces la puntuaci\u00f3n entrara en las tablas. NOTA: Cancel tiene mas prioridad que Submit. Si las dos se convierten verdaderas en el mismo frame, la puntuaci\u00f3n no sera ingresada.</p> <p>Finalmente, Value (VAL) es un caso especial, y va a ser tomado de la memoria utilizando la formula que se ingreso en la entrada de Value. Esta es la puntuaci\u00f3n que se muestra cuando la Tabla esta activa, y el valor que es ingresado en las tablas si SUB es verdadero.</p> <p>NOTA: Una vez que una tabla activa es cancelada o ingresada, esta no puede ser re-activada asta que la condici\u00f3n Start se convierta en falsa, y verdadera de nuevo. Esto previene a la tabla de ser re-activada inmediatamente que se ingreso un valor o se cancelo.</p>"},{"location":"Leaderboards-es/#formato-de-direcciones","title":"Formato de Direcciones","text":"<p>Las direcciones de memoria para STA/CAN/SUB/VAL tienen el siguiente formato:</p> localizaci\u00f3n/tama\u00f1o prefijo (las letras pueden ser en min\u00fasculas) ejemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Leaderboards-es/#ejemplo","title":"Ejemplo","text":"<p>La mejor manera de empezar es hecharle un vistazo a una de las tablas ya existentes https://retroachievements.org/leaderboardList.php y abrirla para ver como funciona. Vamos a utilizar la tabla de Green Hill Act 1 (Sonic the Hedgehog) para este ejemplo. Entonces veamos como funciona:</p> <p></p> <p>El Titulo/Descripci\u00f3n son algo obios.</p> <p>El Type es \"Time (Frames)\". En Sonic cada 60 frames es un 1 segundo, entonces vamos a monitoriar los segundo utilizando frames.</p> <p>La caja de Lower Is Better esta marcada, entonces aquel que consiga el tiempo mas corto sera el #1.</p> <p>Ahora vamos a desglosar las partes mas importantes.</p>"},{"location":"Leaderboards-es/#condiciones-de-start","title":"Condiciones de Start","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <ul> <li><code>0xfe10=h0000</code>: Si la direcci\u00f3n de 16-bit 0xfe10 en la RAM es equivalente a 0000 en hex,</li> <li><code>_</code>: Y,</li> <li><code>0xhf601=h0c</code>: Si la direcci\u00f3n de 8-bit 0xf601 en la RAM es equivalente a 0c en hex,</li> <li><code>_</code>: Y,</li> <li><code>d0xhf601!=h0c</code>: Si la misma direcci\u00f3n anterior (0xf601) NO es equivalente a 0c en hex,</li> <li><code>_</code>: Y,</li> <li><code>0xfff0=0</code> Si la direcci\u00f3n de 16-bit 0xfff0 en la RAM es equivalente a 0.</li> </ul> <p>Esto puede parecer desalentador, porque no sabes que significan esta direcciones. Es por eso que las Notas de C\u00f3digo en la columna de la derecha son bastante \u00fatiles! Tu puedes llegar a ver como estas direcciones son mostradas en memoria. En nuestro ejemplo tenemos:</p> <ul> <li><code>0xfe10</code> es el nivel, y se espera que sea <code>0</code> (el primer nivel).</li> <li><code>0xf601</code> es una direccion en memoria de 8-bit, y utilizamos el prefijo <code>0xh</code> en vez de <code>0x</code>. <code>0xf601</code> es el modo de la pantalla. La segunda y terceras partes de las condiciones para empezar estan diciendo \"el modo actual tiene que ser  ingame (<code>0c</code>), y el modo en el frame anterior NO tiene que ser ingame\". Nota: ese prefijo <code>d</code> en la direcci\u00f3n representa delta, o \"el valor en el frame anterior\". Sum\u00e1ndole a esto: ejecuta STA si ACABAMOS de llegar a un nivel, (para empezar a checar el tiempo).</li> <li>Finalmente tambi\u00e9n esperamos que <code>0xfff0</code> sea equivalente a <code>0</code>, ya que esta direcci\u00f3n se utiliza para demo mode, y no queremos que la tabla se active cuando esta el modo demo activado!</li> </ul> <p>Tip: el error mas com\u00fan cuando creamos tablas de clasificaci\u00f3n es olvidarnos de la <code>h</code> cuando tratamos de hacer referencia a un valor en memoria de 8-bit.</p> <p>Pro-tip: STA, CAN, y SUB soportan toda la logica que se encuentra disponible en el editor de logros. La manera mas facil es asegurarte que escribiste todo correctamente es crear logros locales que capturen estos eventos, y entonces extraer los valores ingresados en el archivo \"XXX-User.txt\" asociado al juego en el cual te encuentras trabajando.</p>"},{"location":"Leaderboards-es/#condiciones-para-cancelar","title":"Condiciones para Cancelar","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <ul> <li>0xfe13 es el numero de vidas.</li> </ul> <p>La condici\u00f3n de cancelaci\u00f3n checa si el contador de VIDAS alguna vez se decrementa. Literalmente dice \"Cancela si el valor ACTUAL en 0xfe13 es menor al valor ANTERIOR en 0xfe13\". Queremos hacer esto porque puedes llegar al ultimo checkpoint, morir y resetear tu tiempo a 0:00. Y no queremos que se pueda hacer esto, ya que no es la manera correcta de completar el nivel. As\u00ed que si el jugador muere, se va a resetear el progreso de la tabla. Finalmente, si conectas dos condiciones de cancelaci\u00f3n con una <code>s</code>, la tabla se va a cancelar si cualquiera de las condiciones es verdadera.</p>"},{"location":"Leaderboards-es/#condiciones-para-ingresar-entradas","title":"Condiciones para Ingresar Entradas","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <ul> <li>0xf7cc es la bandera para terminar el nivel, esta no es interactiva.</li> </ul> <p>La secci\u00f3n de submit checa si en el frame actual se encuentra la bandera de 'endlevel' como verdadera (o <code>!=0</code>, 'no es un cero'), y el frame anterior (delta) lo tiene como falso (o <code>=0</code>, 'cero'). Esto sugiere que el jugador a llegado al final del nivel.</p> <p>Tip: puede llegar a ser \u00fatil observar como trabajan estos valores en memoria, y conocer que tipo de valor se utilizan en diferente circunstancias.</p>"},{"location":"Leaderboards-es/#interpretador-de-valores","title":"Interpretador de Valores","text":"<p>Tambi\u00e9n mira: C\u00f3digo Binario Formateado en Decimal</p> <p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Finalmente, valor. Una vez que el jugador a llegado a la condici\u00f3n de inicio, se mostrara una notificaci\u00f3n en pantalla, mostrando el progreso del jugador en tiempo real. Si es una una tabla sobre tiempo, va a ver un reloj, y si es una puntuaci\u00f3n se mostrara simplemente el valor. Si ellos llegan a cumplir la condici\u00f3n de cancelaci\u00f3n, se mostrara un mensaje diciendo que fallaron, y la notificaci\u00f3n sera removida. Si ellos cumplen la condici\u00f3n de submit exitosamente, el valor actual se va a tomar y se va a subir una entrada, aparecer\u00e1 una notificaci\u00f3n informando al jugador sobre su posici\u00f3n en las tablas.</p> <p>La condiciones en value son especiales en cierto aspectos. Es evaluada constantemente y se muestra en pantalla en tiempo real cuando una tabla esta activada. No trabaja como otras condiciones, interpreta las direcciones de la siguiente manera:</p> <p><code>direcci\u00f3n*modificador</code> (direcci\u00f3n veces modificador)</p> <p>y usa al <code>_</code> operador guion bajo como 'mas'. El asterisco <code>*</code> significa 'multiplicar', entonces en el valor</p> <p><code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>representa:</p> <p>8-bit 0xfe24 1 vez, MAS 8-bit 0xfe25 60 veces, MAS 8-bit 0xfe22 3600 veces</p> <p>La raz\u00f3n de esto es que los valores de cada una de estas direcciones significan frames, segundos, y minutos respectivamente. Cuando agregamos estos valor juntos, obtenemos un total de frames que ingresamos a la base de datos.</p> <p>Recuerdas que el campo de 'Formato' pod\u00eda ya ser Puntuaci\u00f3n, Tiempo (Frames), Tiempo (Milisegundos) o Valor? Tiempo (Frames) es el mas com\u00fan de todos, y representa 'frames'. Time (Milisegundos) espera un valor que pueda convertir en milisegundos (Super Mario Kart utiliza esto). Sin embargo para convertir un valor en frames a un formato que sea humanamente entendible tenemos que dividir el valor por 60 para conseguir una interpretaci\u00f3n certera de los segundos, y un valor en milisegundos deber\u00eda estar dividido por 100 para conseguir el numero de milisegundos. Esto se utiliza ya sea en el sitio web y en los programas para mostrar el valor apropiadamente, y es importante que se distinga ya que podemos estar seguros que estamos consiguiendo el valor mas acertado del emulador, utilizando el formato que sea necesario para capturar el tiempo.</p> <p>Tambi\u00e9n hay un s\u00edmbolo que solamente funciona en este campo. Conecta dos valores condicionales con un <code>$</code> y esto va a provocar que solamente se utilice el valor con tenga el valor mas alto.</p> <p>NOTA: Tiempo (Milisegundos) son actualmente centenas de segundo, no mil\u00e9simas de segundo. por ejemplo: un valor de  6234 deber\u00eda de ser 62.34 segundos, no 6.234 segundos.</p> <p>Tip: el modificador usa valores decimales, entonces si por ejemplo quieres divir entre dos, puedes multiplicar por  0.5: <code>0xhfe24*0.5</code></p>"},{"location":"Leaderboards-es/#ayuda-futura","title":"Ayuda Futura","text":"<p>Desafortunadamente hay MUCHAS maneras de llegar a hacer este proceso de la manera equivocada, entonces si llegas a tener alg\u00fan problema si\u00e9ntete libre de pedir ayuda en nuestro Servidor de Discord.</p> <p>Si quieres practicar, es bastante recomendable que crees tu tabla e intentes algo en un juego nuevo, en vez de utilizar una tabla ya existente.</p> <p>Por favor ten en cuenta que estos archivos son arrastrados directamente a la partida de alguien cuando abra el juego, y un valor de memoria mal ingresado o un comando puede causar que el emulador se crashee, as\u00ed que por favor testea el c\u00f3digo de tu tabla!</p>"},{"location":"Leaderboards-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:35] meleu:</code> fix link</li> <li><code>[2019-05-17 10:24] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-16 11:31] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-16 10:56] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-15 10:21] eldexterr:</code> Updated Leaderboards (markdown)</li> </ul>"},{"location":"Leaderboards-pt_BR/","title":"Leaderboards","text":"<p>Link para o texto em ingl\u00eas: Leaderboards</p> <p>Atualmente Leaderboards podem ser editadas por desenvolvedores no site. \u00c9 uma interface bastante confusa e um trabalho dif\u00edcil para fazer com que uma leaderboard funcione corretamente. \u00c9 realmente necess\u00e1rio cuidado e aten\u00e7\u00e3o para obter uma boa leaderboard, ent\u00e3o, neste documento n\u00f3s vamos tentar entender como isto funciona.</p>"},{"location":"Leaderboards-pt_BR/#visao-geral","title":"Vis\u00e3o Geral","text":"<p>Isto \u00e9 como uma lista de Leaderboard de um jogo aparece no site</p> <p></p> <p>No centro voc\u00ea pode ver todas as Leaderboard feitas, e na coluna direita voc\u00ea pode ver as Code Notes (Notas de C\u00f3digo). As Code Notes est\u00e3o aqui para ajudar com algumas condi\u00e7\u00f5es que veremos abaixo.</p> <p>Aqui est\u00e1 uma breve explica\u00e7\u00e3o de cada campo de uma Leaderboard:</p> <ul> <li>Title (T\u00edtulo): O t\u00edtulo de uma Leaderboard</li> <li>Description (Descri\u00e7\u00e3o): A descri\u00e7\u00e3o de uma Leaderboard</li> <li>Format (Formato): Isto pode ser <code>Score</code>, <code>Time (Frames)</code>, <code>Time (Milliseconds)</code> ou <code>Value</code>. \u00c9 usado para distinguir que tipo de leaderboard \u00e9 (j\u00e1 vamos falar disso abaixo)</li> <li>\"LowerIsBetter\" checkbox (Menor\u00c9Melhor) : Quando marcado, isso quer dizer, um valor baixo \u00e9 a melhor coisa. \u00c9 geralmente usando em casos de leaderboards baseadas em tempo, enquanto uma pontua\u00e7\u00e3o maior geralmente \u00e9 melhor.</li> <li>Start (Iniciar): Condi\u00e7\u00f5es de in\u00edcio, aka STA</li> <li>Cancel (Cancelar): Condi\u00e7\u00f5es de cancelamento, aka CAN</li> <li>Submit (Submeter): Condi\u00e7\u00f5es para envio, aka SUB</li> <li>Value (Valor): Como interpretar os valores, aka VAL</li> </ul> <p>Nota: Uma leaderboard v\u00e1lida NECESSITA ter todas as quatro condi\u00e7\u00f5es.</p> <p>Esses 4 \u00faltimos campos s\u00e3o realmente importantes e MUITOS cuidados devem ser tomados na entrada de qualquer caracter dentro dessas linhas. \u00c9 por isso que eles merecem uma explica\u00e7\u00e3o mais na frente:</p> <p>A condi\u00e7\u00e3o STA ou Start \u00e9 uma s\u00e9rie de condi\u00e7\u00f5es, como uma conquista, que devem ser verdadeiras para come\u00e7ar a a Leaderboard. Uma vez que o STA for verdadeiro, o jogo ir\u00e1 come\u00e7ar a monitorar as condi\u00e7\u00f5es CAN, SUB e VAL.</p> <p>Se a condi\u00e7\u00e3o Cancel (CAN) for verdadeira, ela ir\u00e1 cancelar todo o progresso relativo ao envio da leaderboard. Se no entanto a condi\u00e7\u00e3o Submit (SUB) for verdadeira, ent\u00e3o, o placar gerado na leaderboard ser\u00e1 enviado</p> <p>Finalmente, o Valor (VAL) \u00e9 um caso especial, e ir\u00e1 ser obtido da mem\u00f3ria usando a f\u00f3rmula iniciada na caixa de mem\u00f3ria (memory box)</p>"},{"location":"Leaderboards-pt_BR/#formato-do-endereco","title":"Formato do Endere\u00e7o","text":"<p>O Endere\u00e7o de mem\u00f3ria para STA/CAN/SUB/VAL tem o segunte formato:</p> localiza\u00e7\u00e3o/tamanho prefixo (pode ser min\u00fasculo) exemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Leaderboards-pt_BR/#exemplo","title":"Exemplo","text":"<p>O melhor lugar para iniciar \u00e9 olhando uma das leaderboards existentes http://retroachievements.org/leaderboardList.php e desmontar para ver como funciona. N\u00f3s iremos usar o Green Hill Act 1 (Sonic the Hedgehog) Leaderboard para este prop\u00f3sito. Vamos ver como fica:</p> <p></p> <p>Os campos Title e Description s\u00e3o um pouco \u00f3bvios.</p> <p>O Type \u00e9 \"Time (Frame)\". Em Sonic cada 60 frames equivale a 1 segundo, ent\u00e3o vamos monitorar o tempo usando os frames.</p> <p>A checkbox Lower Is Better est\u00e1 marcada, entao aquele que fizer o tempo mais curto ser\u00e1 o #1.</p> <p>Agora nos vamos explicar as partes mais importantes.</p>"},{"location":"Leaderboards-pt_BR/#condicoes-de-inicio","title":"Condi\u00e7\u00f5es de In\u00edcio","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <ul> <li><code>0xfe10=h0000</code>: Se o endere\u00e7o da RAM 0xfe10 \u00e9 equivalente hex 0000,</li> <li><code>_</code>: E,</li> <li><code>0xhf601=h0c</code>: Se o endere\u00e7o da RAM 8-bits 0xf601 \u00e9 equivalente para hex 0c,</li> <li><code>_</code>: E,</li> <li><code>d0xhf601!=h0c</code>: Se o endere\u00e7o da RAM 8-bits anterior 0xf601 N\u00c3O \u00e9 equivalente ao 0c,</li> <li><code>_</code>: E,</li> <li><code>0xfff0=0</code> Se o endere\u00e7o da RAM 0xfff0 \u00e9 equivalente ao 0.</li> </ul> <p>Esto parece ser intimidador, porque nos n\u00e3o sabemos o que esse endere\u00e7o diz. \u00c9 por isso que o Code Note na coluna direita \u00e9 de bastante ajuda! Voc\u00ea pode ser como esses endere\u00e7os est\u00e3o classificados na mem\u00f3ria. Em nosso exemplo nos temos:</p> <ul> <li><code>0xfe10</code> \u00e9 o nivel, e espera-se que seja <code>0</code> (o primeiro nivel).</li> <li><code>0xf601</code> \u00e9 um endere\u00e7o de mem\u00f3ria de 8 bits, e nos usamos o prefixo <code>0xh</code> em vez de <code>0x</code> para significar isso. <code>0xf601</code> \u00e9 o modo de tela. A segunda e a terceira parte desta Condi\u00e7\u00e3o de In\u00edcio est\u00e1 dizendo \"o modo atual deve ser ingame (<code>0c</code>), e o modo no frame anterior N\u00c3O deve ser ingame\". Nota: O prefixo \"d\" no endere\u00e7o representa delta, ou \"o valor do frame anterior\". Resumindo: ative o leaderboard imediatamente ap\u00f3s iniciar uma fase (a partir da\u00ed vamos come\u00e7ar a medir o tempo).</li> <li>Finalmente n\u00f3s al\u00e9m de esperar que <code>0xfff0</code> seja aquivalente a <code>0</code>, porque <code>0xfff0</code> \u00e9 o modo de demonstra\u00e7\u00e3o e n\u00f3s n\u00e3o queremos enviar pontua\u00e7\u00f5es para a leaderboard quando a demo estiver ativa!</li> </ul>"},{"location":"Leaderboards-pt_BR/#condicoes-de-cancelamento","title":"Condi\u00e7\u00f5es de Cancelamento","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <ul> <li><code>0xfe13</code> \u00e9 o numero de vidas.</li> </ul> <p>A se\u00e7\u00e3o de cancelamento checa se o contador de VIDAS do jogador se tormar menor. Literalmente, isto diz \"Cancela se o ATUAL valor em 0xfe13 \u00e9 menor que o valor ANTERIOR em 0xfe13. N\u00f3s queremos que fa\u00e7a isso porque voce pode alcan\u00e7ar o checkpoint final e correr fora do tempo, resetando seu contador para 0:00. Nos n\u00e3o queremos permitir isso, porque isto n\u00e3o \u00e9 a forma correta de completar o nivel. Ent\u00e3o, se o jogardor morrer, n\u00f3s resetamos o progresso do leaderboard dele.</p>"},{"location":"Leaderboards-pt_BR/#condicoes-de-envio","title":"Condi\u00e7\u00f5es de envio","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <ul> <li><code>0xf7cc</code> isto \u00e9 a bandeira de final de fase, n\u00e3o-interativo.</li> </ul> <p>A se\u00e7\u00e3o de envio checa se o frame atual tem o marcador de 'endlevel' (fim de fase) for para verdadeiro (ou <code>!=0</code>, 'naozero'), e o frame anterior (delta) tem isto para ser falso (ou <code>=0</code>, 'zero'). Isto sugere que o jogador chegou ao fim do nivel, e provou ser um benchmark bastante robusto</p> <p>Dica: isto pode ser \u00fatil para observar estes valores na mem\u00f3ria para ver como eles executam, e que tipo de valores eles terminam em diferentes circunst\u00e2ncias.</p>"},{"location":"Leaderboards-pt_BR/#interpretador-de-valores","title":"Interpretador de Valores","text":"<p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Finalmente, valores. Uma vez que o jogador chegou ao inicio da condi\u00e7\u00e3o, eles ir\u00e3o ser mostrados em uma caixa quue permanece na tela, aparecendo o progresso deles at\u00e9 agora. Se \u00e9 uma leaderboard de tempo, ser\u00e1 um rel\u00f3gio, e se for uma pontua\u00e7\u00e3o, ser\u00e1 apenas o valor. Se eles cumprirem a condi\u00e7\u00e3o de cancelamento, eles ser\u00e3o informados de que eles falharam, e o pop-up ser\u00e1 removido. Se caso o jogador chegar com sucesso \u00e0 condi\u00e7\u00e3o de envio, o valor atual ser\u00e1 pego e submetido como pontua\u00e7\u00e3o. o pop-up ingame ir\u00e1 informar o jogador o t\u00e3o longe da leaderboard, e a posi\u00e7\u00e3o deles na leaderboard.</p> <p>A condi\u00e7\u00e3o de valor \u00e9 especial em poucas maneiras. Ele \u00e9 avaliado constantemente e exibido na tela o tempo todo quando a leaderboard est\u00e1 ativa. Isto n\u00e3o funciona como as outras condi\u00e7\u00f5es. Isto espera endere\u00e7os da seguinte maneira:</p> <p><code>endere\u00e7o*modificador</code> (endere\u00e7o tempo modificador)</p> <p>e usa o <code>_</code> sublinhado como um 'plus'. O <code>*</code> asterisco significa 'm\u00faltiplo', ent\u00e3o no valor</p> <p><code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>representa:</p> <p>8-bit <code>0xfe24</code> vezes 1, MAIS 8-bit <code>0xfe25</code> vezes 60, MAIS 8-bit <code>0xfe22</code> vezes 3600</p> <p>A raz\u00e3o para isso \u00e9 que os valores em cada um desses endere\u00e7os significam frames, segundos e minutos respectivamentes. Quando nos adicionamos esses valores juntos, n\u00f3s conseguimos um grande total em frames que vamos enviar para o \"Banco de dados\".</p> <p>Lembre que o campo 'Formato' pode ser Pontua\u00e7\u00e3o, Tempo (Frames), Tempo (Milisegundos) ou Valor. Tempo(Frames) \u00e9 o mais comum, e representa 'frames'. Tempo (Milisegundos) espera um valor que nos podemos converter diretamente para milisegundos. (Super Mario Kart usa isso). No entanto, para converter um valor em frame dentro de um formato \"para ser lidos por humanos\", nos devemos dividiu o valor por 60 para uma representa\u00e7\u00e3o de segundos correta, e um valor em milisegundos deve ser dividido por 100 para conseguir o numero de segundos. Isso \u00e9 usado no site e no aplicativo para exibir o valor apropriadamente, e \u00e9 importante para distinguir, para que possamos ter certeza de obter o valor mais preciso do emulador, usando qualquer formato que eles usem para registrar o tempo.</p>"},{"location":"Leaderboards-pt_BR/#ajuda-adicional","title":"Ajuda Adicional","text":"<p>Infelizmente h\u00e1 MUITAS maneiras de este processo dar errado, ent\u00e3o, se voce tiver algum problema, sinta-se livre pra pedir ajuda em nosso servidor do Discord.</p> <p>Se voc\u00ea quer praticar, \u00e9 altamente recomendado criar sua pr\u00f3pria leaderboard e tentar alguma coisa em um novo jogo, melhor que usar uma leaderboard existente</p> <p>Por favor, lembre-se que esses arquivos s\u00e3o puxados diretamente para o jogo de algu\u00e9m se eles decidirem jog\u00e1-lo, e uma m\u00e1 forma\u00e7\u00e3o de endere\u00e7o de mem\u00f3ria ou linha pode causar um crash no emulador, ent\u00e3o por favor, teste seu c\u00f3digo da leaderboard!</p>"},{"location":"Leaderboards-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-28 11:35] meleu:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 03:15] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:56] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:55] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:49] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:44] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:38] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:37] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:36] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:35] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> </ul>"},{"location":"Leaderboards/","title":"Leaderboards","text":"<ul> <li>Overview</li> <li>Example</li> <li>Start Conditions</li> <li>Cancel Conditions</li> <li>Submit Conditions</li> <li>Value</li> <li>Value Format</li> <li>Design Tips</li> <li>Score Wrapping</li> <li>Further Help</li> </ul>"},{"location":"Leaderboards/#overview","title":"Overview","text":"<p>This is how a game's Leaderboard List looks like on the website:</p> <p></p> <p>In the center you can see every already made Leaderboard, and in the right column you can see the Code Notes for the game. The Code Notes are here to help with some conditions we'll see below.</p> <p>And now you can also create and edit Leaderboards through the GUI just like achievements by selecting Leaderboards from the Assets List:</p> <p></p> <p>Here's a brief explanation of each field of a single Leaderboard:</p> <ul> <li>Title: the leaderboard's title.</li> <li>Description: the leaderboard's description.</li> <li>Format: specifies how the value should be displayed.</li> <li>\"LowerIsBetter\" checkbox: determines how the list should be sorted. When checked, lower value appear as higher ranks in the leaderboard. Time-based leaderboards usually honor faster times (lower), whereas score-based leaderboards favor higher values.</li> <li>Start: start conditions, aka STA.</li> <li>Cancel: cancel conditions, aka CAN.</li> <li>Submit: submit conditions, aka SUB.</li> <li>Value: a value interpreter, aka VAL.</li> <li>Display Order: The order leaderboards appear and also used for hiding them from view if set to -1. This can only be edited from the site editor.</li> </ul> <p>Note: A valid leaderboard MUST have all four of these conditions, even if they're set to always be true (<code>1=1</code>) or always be false (<code>0=1</code>).</p> <p>Those last 4 fields are really important and LOTS of care must be taken over the entry of any characters into these strings. That's why they deserve a further explanation:</p> <p>The Start (STA) condition is a series of values, like an achievement, that must be true in order to start looking for a leaderboard submission. </p> <p>If a Cancel (CAN) condition is true, then it will cancel the leaderboard and no score will be submitted. NOTE: Cancel is given priority over Start. If both become true in the same frame, the leaderboard will not start.</p> <p>If the Submit (SUB) condition is true, then the leaderboard score will be submitted. NOTE: Cancel is given priority over Submit. If both become true in the same frame, the score will not be submitted.</p> <p>Finally, the Value (VAL) is a special case, and will be taken from memory using the formula stated in the memory box. This is the score that gets displayed while the leaderboard is active, and the value that's submitted if SUB is true.</p> <p>Memory addresses for STA/CAN/SUB/VAL have the format defined here.</p> <p>NOTE: Once an active leaderboard is cancelled or submitted, it cannot be reactivated until the Start condition becomes false, then true again. This prevents the leaderboard from immediately reactivating after submission/cancel.</p>"},{"location":"Leaderboards/#example","title":"Example","text":"<p>The best place to start is to look at existing leaderboards and break it down to see how it works. We're going to use the Green Hill Act 1 (Sonic the Hedgehog) Leaderboard for this purpose. Then let's see how it looks:</p> <p></p> <p>The Title/Description fields are quite obvious.</p> <p>The Type is \"Time (Frames)\". The value we're tracking updates once a frame, and the Genesis runs at 60 frames per second. (see not below for systems that run at other speeds)</p> <p>The Lower Is Better flag is checked, then the one who makes the shortest time will be the #1.</p> <p>Now we're going to break down the most important parts.</p>"},{"location":"Leaderboards/#start-conditions","title":"Start Conditions","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <p></p> <ul> <li><code>0xfe10=h0000</code>: If 16-bit RAM address 0xfe10 is equivalent to hex 0000,</li> <li><code>_</code>: AND,</li> <li><code>0xhf601=h0c</code>: If 8-bit RAM address 0xf601 is equivalent to hex 0c,</li> <li><code>_</code>: AND,</li> <li><code>d0xhf601!=h0c</code>: If the previous 8-bit RAM address 0xf601 is NOT equivalent to hex 0c,</li> <li><code>_</code>: AND,</li> <li><code>0xfff0=0</code> If 16-bit RAM address 0xfff0 is equivalent to 0.</li> </ul> <p>This might seem daunting, because we don't know what these addresses mean. That's why the Code Notes in the right column are pretty handy! You can see how these addresses are labeled in memory. In our example we have:</p> <ul> <li><code>0xfe10</code> is the level, and is expected to be <code>0</code> (the first level).</li> <li><code>0xf601</code> is an 8-bit memory address, and we use the prefix <code>0xh</code> instead of <code>0x</code> to signify this. The <code>0xf601</code> is the screen mode. The second and third parts of the start statement are saying \"the current mode should be ingame (<code>0c</code>), and the mode on the previous frame should NOT be ingame\". Note: that <code>d</code> prefix on the address represents delta, or \"the previous frame's value\". Summing up: trigger this if we've JUST arrived in a level (the start of the level, when we want to start testing their time).</li> <li>Finally we also expect <code>0xfff0</code> to be equivalent to <code>0</code>, because this address is used for demo mode, and we don't want to award a leaderboard entry when the demo is active!</li> </ul> <p>Tip: the most common mistake when creating leaderboards through the site editor is forgetting the <code>h</code> when trying to reference an 8-bit memory address.</p> <p>Note: You can use HitCounts in the Start/Submit/Cancel triggers, but you are responsible for resetting them. These triggers are evaluated every frame, and the state of the leaderboard is dependent on which ones are true. As such, the HitCount will increment even when the leaderboard is not active unless you have an explicit ResetIf condition.</p>"},{"location":"Leaderboards/#cancel-conditions","title":"Cancel Conditions","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <p></p> <ul> <li>0xfe13 is the number of lives.</li> </ul> <p>The cancel section checks if the player's LIVES counter ever becomes lower. Literally, it says \"Cancel if the CURRENT value at 0xfe13 is less than the PREVIOUS value at 0xfe13\". We want to do this because you could reach the final checkpoint and run out of time, resetting your timer to 0:00. We don't want to allow this, because it's not the correct way of completing the level. So if the player dies, we reset their leaderboard progress. Finally, if you connect two cancel conditions with <code>s</code>, the leaderboard will cancel when either one of them are true.</p>"},{"location":"Leaderboards/#submit-conditions","title":"Submit Conditions","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <p></p> <ul> <li>0xf7cc is the endlevel flag, non-interactive.</li> </ul> <p>The submit section checks if the current frame has the 'endlevel' flag set to true (or <code>!=0</code>, 'nonzero'), and the previous frame (delta) has it set to false (or <code>=0</code>, 'zero'). This suggests that the player has reached the end of the level, and has proven to be a fairly sturdy benchmark.</p> <p>Tip: it can be useful to watch these values in memory to see how they perform, and what sort of values they end up at in different circumstances.</p>"},{"location":"Leaderboards/#value","title":"Value","text":"<p>Finally, value. Once the player has reached the start condition, they will be shown a popup which remains on-screen, showing their progress so far. If it's a time leaderboard, it will be a clock, and if it's a score, it will just be the value. If they fulfill the cancel condition, they will be told that they have failed, and the popup will be removed. If they successfully reach the submit condition, the current value will be taken and submitted as their score, and on successful submission, an in game popup will inform the player of the leaderboard so far, and their position in the leaderboard.</p> <p>For more information on the value format, see Value Definition.</p> <p>NOTE: The value calculation is performed using 32-bit signed integers. As such, the maximum value is 2147483647 and the minimum value is -2147483648. Values above the maximum will wrap around and register as very negative numbers. </p>"},{"location":"Leaderboards/#value-format","title":"Value Format","text":"<p>'Format' can be any of the available formats, but the editor currently only provides Score, Time (Frames), Time (Milliseconds) and Value. Time (Frames) is the most common one, and represents a time derived from a value that increments every frame. It does this by multiplying by 100 (to convert to hundredths of a second) and dividing by 60 (the number of frames per second).</p> <p>NOTE: If you're using a system that doesn't run at 60Hz, you have to use \"Time (millisecs)\" and multiply by some value to do the conversion yourself (50Hz = <code>*2</code> [100/50], 60Hz = <code>*1.666666</code> [100/60], 75Hz =<code>*1.333333</code> [100/75]).</p> <p>NOTE: Time (Milliseconds) is actually hundredths of a second, not thousandths of a second. i.e. a Value of 6234 would be 62.34 seconds, not 6.234 seconds.</p>"},{"location":"Leaderboards/#design-tips","title":"Design Tips","text":"<p>Leaderboards can sometimes get pretty spammy and take up a lot of screen space when starting or depending on how many are active at once. It is generally good practice to try and eliminate this as much as possible when you can. You can do this by taking advantage of the fact that you can start and submit a leaderboard on the same frame by setting the start condition to what you would normally use as the submit and then setting the submit condition so something that is always true like 1=1.</p> <p>If a game tracks a score or time that you are using to directly call for your value then consider starting and submitting the leaderboard on the same frame so that only one popup is called (for the submission) and the screen won't have extra clutter. There are still cases where it can be useful for players to have the values up on display if they are hidden in menus so use your best judgement. </p> <p>In games where levels are short and retries are quick you really don't want to have it start/cancel/submit repeatedly after each start/retry when you can help it as the popups can start stacking together and clutter the screen well past the actual attempts are over. These are a prime candidate for starting and submitting on the same frame when possible.</p>"},{"location":"Leaderboards/#score-wrapping","title":"Score Wrapping","text":"<p>In games where the high score wraps around back to 0 it is actually possible to account for this and keep your leaderboard tracking the score! You can do this by using Alt Groups combined with MeasuredIf to track which loop you are on and will use one Alt per loop.</p> <p>As an example lets take a look at Balloon Fight on NES where the score wraps around after 999,990. Here is the original leaderboard:</p> <p></p> <p>And an updated version which will continue tracking after each loop: Core needs to have a Measured statement in it so just put something that is never true and also a ResetIf for resetting the MeasuredIf statements in the Alt Groups when needed (in this case on the title screen)</p> <p></p> <p>The first Alt will contain the normal logic for high score</p> <p></p> <p>The next Alt will contain a MeasuredIf that is true after the first loop which will allow this value to be used. You will also add an extra condition to AddSource in the total score from the first loop which will be 1,000,000 in this case. This value will now be used since MeasuredIf is true and the value is the highest of the Alt Groups</p> <p></p> <p>For the next Alt we increment the number of hits used in the loop detection as well as the value we multiply the total score added by for each loop</p> <p></p>"},{"location":"Leaderboards/#further-help","title":"Further Help","text":"<p>There are unfortunately MANY ways to get this process wrong, so if you are having any trouble feel free to ask for help in our Discord server.</p> <p>If you want to practice, it's highly recommended to create your own leaderboard and attempting something on a new game, rather than using an existing leaderboard. Just remember to clean up any test leaderboards that you push to the site afterwards.</p> <p>Please remember that these files are pulled directly into someone's game if they decide to play it, and a badly formed memory address or string could cause their emulator to crash, so please test your leaderboard code!</p>"},{"location":"Leaderboards/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:08] televandalist:</code> Added ToC</li> <li><code>[2022-05-30 18:49] Searo:</code> Cleanup</li> <li><code>[2022-05-30 18:45] Searo:</code> Typos</li> <li><code>[2022-05-30 18:35] Searo:</code> Misc updates</li> <li><code>[2022-02-04 17:36] Jamiras:</code> extract memory sizes</li> <li><code>[2022-02-04 16:47] Jamiras:</code> extract Value Definition to separate page</li> <li><code>[2021-10-23 12:28] Jamiras:</code> Updated Leaderboards (markdown)</li> <li><code>[2021-06-08 10:07] Jamiras:</code> Updated Leaderboards (markdown)</li> <li><code>[2021-04-26 13:35] meleu:</code> fix link</li> <li><code>[2020-11-13 16:36] Jamiras:</code> Updated Leaderboards (markdown)</li> </ul>"},{"location":"Measured-Flag/","title":"Measured Flag","text":"<p><code>Measured</code> marks a condition for tracking progress. It adds a progress bar to the achievement overlay to inform the user how close they are to completing an achievement. As the user expects an achievement to trigger when the progress bar is full, it is expected that any other conditions in the achievement should be true most of the time.</p> <p><code>Measured</code> should not be used to track things that are clearly visible to the user. If you have an achievement for getting 500,000 points, you don't need to Measure it if the score is displayed on the screen. Similarly, there's no need to use <code>Measured</code> in an achievement for having 100 of something in the inventory if the player can see a count of how many they have just by opening the inventory.</p> <p>If placed on a condition with a required HitCount, the target value is the required HitCount and the current value is the current HitCount. <code>AddHits</code> can be used.</p> <p>If placed on a condition without a HitCount, the target value is the constant on the right side of the condition and the current value is the evaluation of the left side of the condition. <code>AddSource</code> and <code>SubSource</code> can be used.</p> <p>If multiple conditions are marked as <code>Measured</code> and have the same target value, the current value will be the maximum of all the <code>Measured</code> conditions.</p> <p>If multiple conditions are marked as <code>Measured</code> and have different target values, a Parse Error -22 will occur.</p> <p>Note that progress for <code>Measured</code> values is reported at the time of examination and may actually go down depending on the current value (Hit Count could be reset, or comparison value decreases).</p> <p>To limit the scope of a <code>Measured</code> condition, you can add a <code>MeasuredIf</code> condition. A <code>MeasuredIf</code> condition must be true for the <code>Measured</code> value to be non-zero (and for the achievement to trigger). You can use <code>MeasuredIf</code> to create achievements that require playing as a certain character, or just to prevent bogus data from showing up if the player is in the wrong part of the game. If any <code>MeasuredIf</code> condition in a group is false, the <code>Measured</code> value for the group is automatically 0.</p> <p>Since <code>PauseIf</code> has precedence over <code>Measured</code>, the <code>Measured</code> value will be captured when a group becomes paused, and the captured value will be returned until the group is unpaused and <code>Measured</code> can be evaluated again. If another <code>Measured</code> exists in a non-paused group, its value will be returned even if it is lower than the captured value.</p>"},{"location":"Measured-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-10 11:56] Jamiras:</code> Updated Measured Flag (markdown)</li> <li><code>[2022-09-10 11:56] Jamiras:</code> Updated Measured Flag (markdown)</li> <li><code>[2022-03-19 07:21] Jamiras:</code> add note about behavior when Paused</li> <li><code>[2021-05-01 07:28] meleu:</code> fix link to AddHits page</li> <li><code>[2020-05-17 14:14] Jamiras:</code> add MeasuredIf</li> <li><code>[2019-11-14 19:42] Jamiras:</code> Created Measured Flag (markdown)</li> </ul>"},{"location":"Memory-Inspector-Overview-es/","title":"Un vistazo al Inspector de Memoria","text":"<p>Aqui un vistazo del Inspector de Memoria y sus caracteristicas. Esta herramienta se puede encontrar en la pesta\u00f1a de \"RetroAchievements\" en cualquier emulador integrado con RA.</p> <p>Tambien mira: Tips en la Busqueda de Memoria.</p>"},{"location":"Memory-Inspector-Overview-es/#ventana-del-inspector-de-memoria","title":"Ventana del Inspector de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#1-reset-to-resetear-en","title":"1. Reset to (Resetear en)","text":"<p>Haz click en uno de los botones para empezar una nueva pruba. Por lo general pruebas en 8-bit es lo mas apropiado. </p>"},{"location":"Memory-Inspector-Overview-es/#2-filter-values-filtrar-valores","title":"2. Filter Values (Filtrar Valores)","text":"<p>Usualmente vas a filtrar ya sea en <code>=</code> (igual a) el ultimo valor conseguido o <code>!=</code> (diferente que) el ultimo valor conseguido. Si conoces el valor exacto que deseas buscar, puedes utilizar <code>Given Value</code>(Valor entregado), o si estas convencido que el valor tuvo que haber incrementado, puedes intentar <code>&gt;</code> (mayor que) o <code>&lt;</code> (menor que).</p>"},{"location":"Memory-Inspector-Overview-es/#3-filter-filtrar","title":"3. Filter! (Filtrar)","text":"<p>Cada vez que presiones este boton, estas filtrando los valores que no concuerdan en memoria entre el ultimo testeo y el de ahora.</p>"},{"location":"Memory-Inspector-Overview-es/#4-ventana-de-resultados","title":"4. Ventana de Resultados","text":"<p>Despues de haber filtrado los resultados miraras en la ventana exactamente que es lo que paso, cuantos valores has conseguido y cuantos estan fuera. Algunos puntos a tener en cuenta:</p> <ul> <li>Los resultados muestran cambios en los valores en tiempo real, asi puedes identificar mas facilmente las variables utiles.</li> <li>Los resultados en la busqueda estan resaltados dependiendo el criterio. Para valores que no cumplen el filtro de busqueda, van a estar resaltados en rojo. Puedes desactivar esto en la casilla de <code>Highlights</code> , si asi lo prefieres.</li> <li>Tambien puedes manualmente excluir cualquier variable seleccionada de la busqueda. Utiliza la tecla Ctrl o Shift para seleccionar multiples a la vez.</li> <li>Historial de Resultados: Te puedes mover hacia atras (<code>&lt;&lt;</code>) o hacia adelante (<code>&gt;&gt;</code>) por medio de las busquedas anteriores. Ten en cuenta que si empiezas una nueva busqueda (una <code>New 8-bit Test</code>), tu historial va a ser borrado.</li> </ul>"},{"location":"Memory-Inspector-Overview-es/#5-watching-observando","title":"5. Watching (Observando)","text":"<p>Cualquier valor que se encuentre aqui va a ser observado en el Visor de Memoria y se mostraran sus notas de codigo a la derecha. La direccion tiene que ser <code>0x</code> (Un cero, y despues una letra x), seguido de digitos hexadecimales.</p>"},{"location":"Memory-Inspector-Overview-es/#6-visor-de-memoria","title":"6. Visor de Memoria","text":"<p>Cualquier variable que se este observando y las variables que tiene alrededor se muestran en esta ventana. Puedes ver mas informacion a continuacion, en la seccion de Leyendo informacion en el Visor de Memoria.</p>"},{"location":"Memory-Inspector-Overview-es/#7-notas-de-codigo","title":"7. Notas de Codigo","text":"<p>Una vez que hubieras encontrado un valor en memoria del que quieras hacer una nota, serciorate que el valor este introducido en la caja que dice 'Watching' (Observando). Ahora puedes escribir una peque\u00f1a descripcion en la caja de texto, y hacer click en <code>Save Note</code> (Salvar Nota). Esto va a mandar el valor en memoria y su descripcion a la base de datos, para que puede ser compartida con todos los desarrolladores que trabajen con este juego.</p> <p>Haz click en la fleca hacia abajo para ver cuales valores en memoria han sido encontrados hasta ahora, junto con su descripcion, la cual te dice para que sirve esa variable.</p> <p>Intenta mantener tus descripciones limpias y simples, para que sean facil de entender. Para re-escribir una nota, seleccionala en la lista desglozable, actualiza la descripcion, y haz click en <code>Save Note</code> (Salvar Nota). Una ventana va a salir confirmando sobre-escribir la nota existente - checa si esta bien el cambio, y haz click en OK.</p> <p>Si deseas remover una nota, seleccionala en el menu desglozable, y haz click en <code>Remove</code> (Remover).</p>"},{"location":"Memory-Inspector-Overview-es/#8-marcadores-de-memoria","title":"8. Marcadores de Memoria","text":"<p>Cuando haces click en el boton <code>Open Memory Bookmarker</code> (Abrir Marcadores de Memoria) vas a ver esta ventana:</p> <p></p> <p>Con esto, puedes ver multiples variables designadas al mismo tiempo en vez de estar moviendote por todo el Inspector.</p> <p>Los marcadores pueden ser renombrados haciendo doble-click en su descripcion. Si haces doble click en la variable, te puedes mover directamente a ella en el Inspector de Memoria.</p> <p>Valores agregados al marcador se van a mostrar en el inspector de memoria de color verde. Desde aqui tambien puedes Freezear (Congelar) cualquier marcador.</p> <p>Esto es util para cosas como vida o consumibles. Congelar variables puede ser manipulado directamente desde el inspector. Ten en mente que, el congelamiento ocurre 1 frame despues del gameplay. Esto significa que incluso cuando este congelada, el valor no va a cambiar al menos que pase un frame para que pueda congelarse la variable. Esto siempre se va a mostrar como amarillo.</p>"},{"location":"Memory-Inspector-Overview-es/#leyendo-informacion-en-el-visor-de-memoria","title":"Leyendo informacion en el Visor de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#notaciones-decimales-binarias-y-hexadecimales","title":"Notaciones Decimales, Binarias y Hexadecimales","text":"<p>Para trabajar bien con el Visor de Memoria, es importante entender minimo lo basico de los numeros binarios y hexadecimal. Aqui hay algunos recursos de informacion sobre este tema sin irnos a detalles muy extremos:</p> <ul> <li>https://es.wikipedia.org/wiki/Sistema_binario</li> <li>https://es.wikipedia.org/wiki/Sistema_hexadecimal</li> </ul> <p>Los digitos utilizados en el sistema binario son <code>0</code> y <code>1</code>. Un digito binario tambien es conocido como un bit. Ocho bits tambien se le conocen como un byte.</p> <p>Los digitos utilizados en el sistema hexadecimal son <code>0</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>7</code>, <code>8</code>, <code>9</code>, <code>A</code>, <code>B</code>, <code>C</code>, <code>D</code>, <code>E</code> y <code>F</code>. La notacion hexadecimal tambien se le conoce como hex.</p> <p>La razon principal para estas 2 notaciones, mas alla del sistema decimal tradicional, son:</p> <ul> <li>Notacion Decimal es lo que los humanos entienden.</li> <li>Notacion Binaria es lo que las computadoras \"entienden\".</li> <li>Notacion Hexadecimal se puede llegar a ver como un punto medio entre la binaria y la decimal. Porque un solo digito hexadecimal representa 4 bits, entonces es una notacion mas corta y entendible con la que pueden trabajar los humanos y las computadoras tambien pueden \"entender\".</li> </ul> <p>La siguiente table muestra las direntes notacion para sus valores equivalentes.</p> Decimal Hexadecimal Binario <code>0</code> <code>0x0</code> <code>0000</code> <code>1</code> <code>0x1</code> <code>0001</code> <code>2</code> <code>0x2</code> <code>0010</code> <code>3</code> <code>0x3</code> <code>0011</code> <code>4</code> <code>0x4</code> <code>0100</code> <code>5</code> <code>0x5</code> <code>0101</code> <code>6</code> <code>0x6</code> <code>0110</code> <code>7</code> <code>0x7</code> <code>0111</code> <code>8</code> <code>0x8</code> <code>1000</code> <code>9</code> <code>0x9</code> <code>1001</code> <code>10</code> <code>0xA</code> <code>1010</code> <code>11</code> <code>0xB</code> <code>1011</code> <code>12</code> <code>0xC</code> <code>1100</code> <code>13</code> <code>0xD</code> <code>1101</code> <code>14</code> <code>0xE</code> <code>1110</code> <code>15</code> <code>0xF</code> <code>1111</code> <p>Mas datos sobre las diferentes notaciones:</p> <ul> <li>Para indicar que un valor esta escrito en hexadecimal, se utiliza el prefijo <code>0x</code>: <code>0x10 = 16</code>, <code>10 = 10</code>.</li> <li>Dos digitos hex representan 8 bits y tienen un rango entre <code>0</code> y <code>255</code>. </li> <li>Cuatro digitos hex representan 16 bits y tienen un rango entre <code>0</code> y <code>65535</code>.</li> <li>Ocho digitos hex representan 32 bits y tienen un rango entre <code>0</code>y <code>4294967295</code>.</li> </ul>"},{"location":"Memory-Inspector-Overview-es/#modos-en-el-visor-de-memoria","title":"Modos en el visor de Memoria","text":"<p>La parte de hasta abajo del Inspector de Memoria es lo que llamamos visor de Memoria:</p> <p></p> <p>Puedes ver la informacion en el Visor de Memoria utilizando los modos 8, 16 y 32-bit.</p>"},{"location":"Memory-Inspector-Overview-es/#modo-8-bit","title":"Modo 8-bit","text":"<p>Por defecto, el Visor de Memoria muestra la informacion en modo de 8-bit. Esto muestra cada byte de memoria como un valor de dos-caracteres hexadecimales por separado. Cada byte tiene su propia direccion.</p> <p>Dieciseis bytes son mostrados por linea. La direccion de un byte se puede determinar a\u00f1adiendo la posicion de la fila (mostrada a la izquierda del vizor) a la posicion de la columna (mostrada arriba del visor). Usando la imagen de arriba como un ejemplo, el cursor esta en <code>0x002a7</code> (<code>0x002a0</code> + <code>7</code>).</p>"},{"location":"Memory-Inspector-Overview-es/#modo-1632-bit","title":"Modo 16/32-bit","text":"<p>Antes de que hables del modo de 16-bit mode y 32-bit, es importante saber sobre el endianness (extremidad):</p> <p>Valores que necesitan mas de 8-bits (en otras palabras: mas grandes que 255) necesitan estar almacenado en multiples bytes. Inclusive, los sistemas emulados que utilizamos almacenan valores de multiples-bytes en orden little-endian.</p> <p>En la imagen del Visor de Memoria de arriba puedes ver que en la direccion <code>0x0002c0</code> tenemos el valor hexadecimal <code>ce</code> y en <code>0x0002c1</code> el valor es <code>39</code>. Cuando cambias el visor a modo de 16-bit, los valores <code>ce</code> y <code>39</code> se agrupan en <code>0x0002c0</code> y son mostrados como <code>39ce</code>. Esto pasa porque automaticamente agrupa cada dos bytes y los muestra como valos hexadecimales de 16-bit.</p> <p>NOTA: Mientras que los valores de 16-bits se alinean generalmente a direcciones pares, este no siempre es el caso. De hecho hay un valor de 16-bit que no se muestra en <code>0x0002c1</code>. Ya que el valor en <code>0x0002c1</code> es <code>39</code> y el valor en <code>0x0002c2</code> es <code>29</code>, el valor de 16-bit value en la direccion <code>0x0002c1</code>es <code>0x2939</code>.</p> <p>Similarmente en, el modo de 32-bit, los cuatro bytes de <code>0x0002c0</code> a <code>0x0002c3</code> se muestran como un solo valor de 32-bit <code>0x252939ce</code> en la direccion <code>0x0002c0</code>, pero tambien hay valores de 32-bit en <code>0x0002c1</code>, <code>0x0002c2</code>, and <code>0x0002c3</code>.</p>"},{"location":"Memory-Inspector-Overview-es/#endianness","title":"Endianness","text":"<p>Se describe como Endianness el orden en el que una secuencia de bytes se encuentra almacenada en memoria de una computadora. Los dos tipos mas comunes son: Big-Endian (tambien conocido como BE) y Little-Endian (tambien conocido como LE).</p> <p>En el orden Big-Endian la \"big end\" (extremidad) de un numero (el valor mas significativo en secuencia) es almacenado primero (posicionado en la direccion mas peque\u00f1a). En la imagen de abajo puedes ver el numero <code>0x12345678</code> almacenado en la direccion <code>0x100</code> en el sistema big-endian. Ten en cuenta que el byte mas significativo <code>0x12</code> se encunetra en la direccion <code>0x100</code>:</p> <p></p> <p>En el orden Little-Endian el \"little end\" (extremidad) de un numero (el valor menos significativo en secuencia) es almacenado primero (posicionado en la direccion mas grande). En la imagen de abajo puedes ver el numero <code>0x12345678</code> almacenado en la direccion <code>0x100</code> en orden little-endian. Ten en cuenta que el byte menos significativo <code>0x78</code> se encuentra en la direccion <code>0x100</code>:</p> <p></p>"},{"location":"Memory-Inspector-Overview-es/#trabajando-con-tamanos-inferiores-a-8-bit","title":"Trabajando con tama\u00f1os inferiores a 8-bit","text":"<p>En addicion al 8-bit, 16-bit y 32-bit los tama\u00f1os descritos arriba, existen tama\u00f1os adicionales que pueden ser utilizados al momentos que estemos creando logros (en el editor de Logros (Achievement Editor)).</p>"},{"location":"Memory-Inspector-Overview-es/#single-bits","title":"Single bits","text":"<p>En el visor de memoria cuando un valor de 8-bit es seleccionado vas a ver algo como la imagen de abajo (en la imagen: un byte con valor <code>6f</code> es seleccionado; los bits estan resaltados con un circulo naranja):</p> <p></p> <p>Es muy comun almacenar informacion importante en un solo bit. Ya que un bit solo puede tener dos posibles valores (<code>1</code> o <code>0</code>), algunas veces se utiliza para significarn \"si\" o \"no\", \"encendido\" o \"apagado\", \"tiene un item\" o \"no item\", etc. Algunos juegos, especialmente aquellos que tienen espacio muy limitado en memoria, utilizan bit como botones bastante.</p> <p>Importante: Puedes referirte a cada uno de esos bits indidualmente en el Editor de Logros (Achievement Editor).</p> <p>Significados mas comunes de botones de bit en la memoria de un juego:</p> <ul> <li>tienes un item</li> <li>boton presionado (muy comun)</li> <li>area explorada</li> <li>secuencia del juego activated</li> <li>cheat activado</li> <li>modo demo activo</li> </ul> <p>En el visor de memoria solo puedes ingresar valores hex, entonces es importante conocer la importancia entre valores con notacion hexadecimal y binaria. Puedes ver en la tabla de \"Notaciones Decimales, Binarias y Hexadecimales\" , pero lo usual es usar una calculadora (la calculadora default de MS Windows en modo programador puede hacer el trabajo)</p>"},{"location":"Memory-Inspector-Overview-es/#upper4-y-lower4","title":"Upper4 y Lower4","text":"<p>Upper4 son los cuatro bits superiores de un byte (bit: 7, 6, 5, 4), mostrados como un solo caracter hexadecimal. Lower4 son los cuatro bits inferiores de un byte (bit: 3, 2, 1, 0), mostrados como un solo caracter hexadecimal.</p> <p>Observando el diagrama de tama\u00f1o de memoria de abajo, un byte en la direccion <code>0x00a274</code> es seleccionado (valor <code>0x23</code>). El primer caracter, <code>2</code> es el valor Upper4. El segundo characterr <code>3</code> es el valor Lower4.</p> <p>Ocasionalmente solo vas a estar interesado en trabajar con solo un digito hexadecimal. Utilizando el diagrama de tama\u00f1o de memoria como un ejemplo, como una condicion de un logro donde <code>Upper4 0x00a274 = 0x2</code> seria verdadera. Una condicion donde<code>Lower4 0x00a274 = 0x3</code> seria verdadera.</p>"},{"location":"Memory-Inspector-Overview-es/#diagrama-de-tamano-de-memoria","title":"Diagrama de Tama\u00f1o de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 20:18] meleu:</code> add link to spanish doc</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Memory Inspector Overview ES (markdown)</li> </ul>"},{"location":"Memory-Inspector-Overview/","title":"Memory Inspector","text":"<p>Here is an overview of the Memory Inspector and its features. This tool can be found on \"RetroAchievements\" menu on any emulator integrated with RA.</p> <p>See also: Memory Digging Tips.</p> <ul> <li>Memory Inspector Dialog<ul> <li>1. New Search</li> <li>2. Filter</li> <li>3. Results</li> <li>4. Code Notes</li> <li>5. Memory View</li> <li>Memory Bookmarks</li> </ul> </li> <li>Reading Data in the Memory Viewer<ul> <li>Decimal, Binary, and Hexadecimal Notations</li> <li>Memory Viewer Modes<ul> <li>8-Bit Mode<ul> <li>16 and 32-Bit Mode</li> </ul> </li> </ul> </li> <li>Working with Sizes Smaller Than 8-Bit<ul> <li>Single Bits</li> <li>Upper4 and Lower4</li> </ul> </li> </ul> </li> <li>Memory Sizes Diagram</li> </ul>"},{"location":"Memory-Inspector-Overview/#memory-inspector-dialog","title":"Memory Inspector Dialog","text":""},{"location":"Memory-Inspector-Overview/#1-new-search","title":"1. New Search","text":"<p>This is the first thing you must do when you're looking for something in memory. </p> <p>The first drop down allows you to quick select All memory, System RAM, or Cartridge RAM. The field below the first drop down lets you type in a custom range (i.e. 0x10000-0x100FF).</p> <p>The second drop down specifies the size of the data you're interested in finding.</p> <p>The <code>Reset</code> button clears out any previously captured results (part 3 of the dialog) and captures the current memory state.</p>"},{"location":"Memory-Inspector-Overview/#2-filter","title":"2. Filter","text":"<p>Filters the memory state in an attempt to locate a specific memory address.</p> <p>The first drop down allows you to specify the comparison to use. The second drop down is what you're comparing against. Most of the time you're going to be filtering on <code>!= Last Value</code>, which eliminates any results where the memory has not changed.</p> <p>The available comparisons are:</p> <ul> <li><code>Constant</code> - comparison is made against the value entered in the field below the drop down.</li> <li><code>Last Value</code> - comparison is made against the value captured by the last applied filter, or the initial value if no filter has been applied</li> <li><code>Last Value Plus</code> - comparison is made against the Last Value plus the value entered in the field below the drop down. If the value were 3, the comparison would me made against a number which is three higher than the Last Value for each value captured by the last applied filter.</li> <li><code>Last Value Minus</code> - the same as Last Value Plus, except the value entered in the field below the drop down is subtracted from each value captured by the last applied filter.</li> <li><code>Initial Value</code> - comparison is made against the value captured when the New Search was begun.</li> </ul> <p>The <code>Filter Once</code> button immediately applies the selected filter and updates the Results.</p> <p>The <code>Continuous Filter</code> button applies the selected filter repeatedly until stopped. The fewer the results, the more frequently the filter is applied. The filter is only applied once every N ms, where N is the number of results / 1000. If there are less than 1000 results, it's applied every frame. If there are 50000 results, it's applied every 500ms (twice a second). If there are 1000000 results, it's only applied every 10 seconds.</p>"},{"location":"Memory-Inspector-Overview/#3-results","title":"3. Results","text":"<p>As filtering is applied, the list of potential matches will appear here.</p> <p>On the left side is information about the results, including the number of matches, the filter applied, and how many filters have been applied. If you believe you have applied a filter incorrectly, or the filter results in no matches, you can use the <code>&lt;&lt;</code> button to return to the previous set of results. You can do this all the way back to the initial results. Similarly, you can use the <code>&gt;&gt;</code> button to return to results you have backed out of. Once you apply a new filter, the forward filters are discarded and the <code>&gt;&gt;</code> button is disabled.</p> <p>Below the result information are two buttons. The first allows you to manually remove the selected items from the result set. You can use Ctrl and Shift to select multiple items. The second lets you create a bookmark for an item in the result set. It will appear in the Bookmarks dialog.</p> <p></p> <p>The items in the result set show the address of the match, the current value, and a brief description of the memory at the address. If a code note exists for the address, it will be shown. Otherwise, a general classification of the address will be shown.</p> <p>Additionally, items in the result set can be colored.</p> <ul> <li>Red - the item does not currently match the filter</li> <li>Grey - the item does currently match the filter, but at some point since the filter was applied it did not match.</li> <li>Green - the item is bookmarked</li> <li>Blue - the item has a code note</li> </ul> <p>Clicking on a row will set the selected address to the associated item.</p>"},{"location":"Memory-Inspector-Overview/#4-code-notes","title":"4. Code Notes","text":"<p>Provides detailed information about the selected address, and allows the user to annotate addresses found by the search process. Try to keep your descriptions simple and clear, so they can be easily understood. Clear notes are important for debugging if a problem with an achievement occurs.</p> <p>The text field shows the currently selected address from the memory view (part 5 of the dialog). You can manually type in any address, or use the up and down arrows to jump to the next or previous address that have a code note.</p> <p>Just to the right of the text field is a button that opens the Code Notes dialog, which allows you to browse and search through the code notes.</p> <p>Below the text field is a button that will create a bookmark from the selected address.</p> <p>The large text area is where you can modify the code note for the selected address. NOTE: the changes are not saved unless you press the Save Note button. If you change the selected address without saving, the changes will be lost.</p> <p><code>Save Note</code> and <code>Delete</code> immediately attempt to update the server - either with the modified note text, or by clearing out the note text.</p>"},{"location":"Memory-Inspector-Overview/#5-memory-view","title":"5. Memory View","text":"<p>Allows direct browsing of the memory. The memory updates once per frame as the emulator runs.</p> <p>The currently selected address appears in red. Addresses with code notes show up blue, and addresses associated to bookmarks show up green.</p> <p>You can click on any piece of data in the memory viewer to jump to the associated address. You can also use the keyboard to navigation around in memory (up/down/left/right/pgup/pgdn/home/end).</p> <p>When the memory viewer is focused, a cursor will be visible. You can type any hexadecimal character to change the character at the cursor to another value. This immediately changes the value for the emulator, and may cause unexpected behavior, so use at your own risk. Additionally, modifying memory (through any of the tools) prevents achievements from being unlocked on the server as an anti-cheat mechanism.</p>"},{"location":"Memory-Inspector-Overview/#memory-bookmarks","title":"Memory Bookmarks","text":"<p>You can open the Memory Bookmarks dialog from the RetroAchievements menu. It will also automatically open when adding a bookmark from either of the buttons on the Memory Inspector dialog. </p> <p></p> <p>With this, you can view multiple designated addresses at once instead of having to shuffle around in the Inspector. Bookmarked addresses will show in the Memory Inspector as green.</p> <p>If you double-click on an address, you can move straight to that address in the Memory Inspector.</p> <p>The bookmarks can be renamed by clicking their description. This does not update the code note for the associated address.</p> <p>You can change the size or format of a bookmark by clicking on the field and selecting a new value from the dropdown. Clicking on the value field will allow you to enter a new value for the bookmark. It will automatically be written to the memory.</p> <p>From here you can also Freeze any bookmarks. This is helpful for things like health or consumables. Keep in mind, freezing occurs 1 frame after gameplay. This means that even when frozen, the value will change for at least one frame before returning to the frozen value. Frozen bookmarks will be displayed as yellow.</p>"},{"location":"Memory-Inspector-Overview/#reading-data-in-the-memory-viewer","title":"Reading Data in the Memory Viewer","text":""},{"location":"Memory-Inspector-Overview/#decimal-binary-and-hexadecimal-notations","title":"Decimal, Binary, and Hexadecimal Notations","text":"<p>To work well with the Memory Viewer, it's important to understand at least the basics of binary and hexadecimal numeral notations. Here are good sources of information about this matter without going into extreme details:</p> <ul> <li>https://simple.wikipedia.org/wiki/Binary_number</li> <li>https://simple.wikipedia.org/wiki/Hexadecimal_numeral_system</li> </ul> <p>The digits used in binary system are <code>0</code> and <code>1</code>. A binary digit is also known as bit. Eight bits is also known as one byte.</p> <p>The digits used in hexadecimal system are <code>0</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>7</code>, <code>8</code>, <code>9</code>, <code>A</code>, <code>B</code>, <code>C</code>, <code>D</code>, <code>E</code> and <code>F</code>. The hexadecimal notation is also known as hex.</p> <p>The main reasons for the existence of these 2 notations, besides the traditional decimal notation, are:</p> <ul> <li>Decimal notation is what humans understand.</li> <li>Binary notation is what computers \"understand\".</li> <li>Hexadecimal notation can be seen as a middle ground between binary and decimal. Because a single hexadecimal digit represents 4 bits, then a shorter and more understandable notation for humans to work in a way that the computer \"understands\".</li> </ul> <p>The table below shows the different notations for equivalent values.</p> Decimal Hexadecimal Binary <code>0</code> <code>0x0</code> <code>0000</code> <code>1</code> <code>0x1</code> <code>0001</code> <code>2</code> <code>0x2</code> <code>0010</code> <code>3</code> <code>0x3</code> <code>0011</code> <code>4</code> <code>0x4</code> <code>0100</code> <code>5</code> <code>0x5</code> <code>0101</code> <code>6</code> <code>0x6</code> <code>0110</code> <code>7</code> <code>0x7</code> <code>0111</code> <code>8</code> <code>0x8</code> <code>1000</code> <code>9</code> <code>0x9</code> <code>1001</code> <code>10</code> <code>0xA</code> <code>1010</code> <code>11</code> <code>0xB</code> <code>1011</code> <code>12</code> <code>0xC</code> <code>1100</code> <code>13</code> <code>0xD</code> <code>1101</code> <code>14</code> <code>0xE</code> <code>1110</code> <code>15</code> <code>0xF</code> <code>1111</code> <p>More facts about the different number notations:</p> <ul> <li>To indicate a value is written in hexadecimal, the prefix <code>0x</code> is used: <code>0x10 = 16</code>, <code>10 = 10</code>.</li> <li>Two hex digits represent 8 bits and can range from <code>0</code> to <code>255</code>. </li> <li>Four hex digits represent 16 bits and can range <code>0</code> to <code>65535</code>.</li> <li>Eight hex digits represent 32 bits and can range from <code>0</code>to <code>4294967295</code>.</li> </ul>"},{"location":"Memory-Inspector-Overview/#memory-viewer-modes","title":"Memory Viewer Modes","text":"<p>The bottom part of the Memory Inspector is what we call the Memory Viewer:</p> <p></p> <p>You can see data in Memory Viewer using 8, 16 or 32-bit modes.</p>"},{"location":"Memory-Inspector-Overview/#8-bit-mode","title":"8-Bit Mode","text":"<p>By default, the Memory Viewer shows data in 8-bit mode. This displays each byte of memory as a separate two-character hexadecimal value. And each byte has its own address.</p> <p>Sixteen bytes are shown per line. The address of a byte can be determined by adding the row index (displayed to the left of the viewer) to the column index (displayed above the viewer). Using the image above as an example, the cursor is at <code>0x002a7</code> (<code>0x002a0</code> + <code>7</code>).</p>"},{"location":"Memory-Inspector-Overview/#16-and-32-bit-mode","title":"16 and 32-bit Mode","text":"<p>Before we talk about 16-bit mode and 32-bit mode, it's important to know about endianness:</p> <p>Values that need more then 8-bits (in other words: larger than 255) have to be stored in multiple bytes. However, the emulated systems we use store multi-byte values in little-endian order.</p> <p>In the image of the Memory Viewer above you can see that at address <code>0x0002c0</code> we have the hex value <code>ce</code> and in <code>0x0002c1</code> the value is <code>39</code>. When you switch the viewer to 16-bit mode, the <code>ce</code> and <code>39</code> values are grouped at <code>0x0002c0</code> and get displayed as <code>39ce</code>. This happens because it automatically groups every two bytes and displays them as 16-bit hex values.</p> <p>NOTE: While 16-bit values are usually aligned to even addresses, that's not always the case. There's actually a non-displayed 16-bit value at <code>0x0002c1</code>. Since the value at <code>0x0002c1</code> is <code>39</code> and the value at <code>0x0002c2</code> is <code>29</code>, the 16-bit value at <code>0x0002c1</code> address is <code>0x2939</code>.</p> <p>Similarly, in 32-bit mode, the four bytes from <code>0x0002c0</code> to <code>0x0002c3</code> are displayed as a single 32-bit value <code>0x252939ce</code> at address <code>0x0002c0</code>, but there are also 32-bit values at <code>0x0002c1</code>, <code>0x0002c2</code>, and <code>0x0002c3</code>.</p>"},{"location":"Memory-Inspector-Overview/#endianness","title":"Endianness","text":"<p>Endianness describes the order in which a sequence of bytes are stored in computer systems memory. The two most common types are: Big-Endian (also known as BE) and Little-Endian (also known as LE).</p> <p>In the Big-Endian order the \"big end\" of the number (most significant value in the sequence) is stored first (placed at the lowest address). In the image below you see the number <code>0x12345678</code> stored at the address <code>0x100</code> in the big-endian order. Notice that the most significant byte <code>0x12</code> is at the address <code>0x100</code>:</p> <p></p> <p>In the Little-Endian order the \"little end\" of the number (least significant value in the sequence) is stored first. In the image below you see the number <code>0x12345678</code> stored at the address <code>0x100</code> in the little-endian order. Notice that the least significant byte <code>0x78</code> is at the address <code>0x100</code>:</p> <p></p>"},{"location":"Memory-Inspector-Overview/#working-with-sizes-smaller-than-8-bit","title":"Working with Sizes Smaller Than 8-Bit","text":"<p>In addition to the 8-bit, 16-bit and 32-bit sizes described above, there are additional sizes that can be used when writing achievements (in the Achievement Editor).</p>"},{"location":"Memory-Inspector-Overview/#single-bits","title":"Single Bits","text":"<p>In the memory viewer when an 8-bit address is selected you will see something like the image below (in the image: a byte with the value <code>6f</code> is selected; the bits are highlighted with an orange circle):</p> <p></p> <p>It is very common in games to store important information as a single bit. As a bit can only have two possible values (<code>1</code> or <code>0</code>), sometimes it's used to mean \"yes\" or \"no\", \"on\" or \"off\", \"have item\" or \"no item\", etc. Some games, specially those with limited memory space, use bit switches a lot.</p> <p>Important: You can refer to each one of those bits individually in the Achievement Editor.</p> <p>Common meaning of bit switches in a game memory:</p> <ul> <li>have an item</li> <li>button pressed (very common)</li> <li>area explored</li> <li>in game trigger activated</li> <li>cheat activated</li> <li>in demo mode</li> </ul> <p>In the memory viewer you can only input hex values, then it's important to know equivalence of values between hex and binary notations. You can see the table in the \"Decimal, Binary and Hexadecimal notations\" section, but the usual is to use a calculator (the default calculator on MS Windows on the programmer view can do the job).</p>"},{"location":"Memory-Inspector-Overview/#upper4-and-lower4","title":"Upper4 and Lower4","text":"<p>Upper4 is the upper four bits of a byte (bit: 7, 6, 5, 4), displayed as a single hexadecimal character. Lower4 is the lower four bits of a byte (bit: 3, 2, 1, 0), displayed as a single hexadecimal character.</p> <p>Looking at the memory size diagram below, a byte at address <code>0x00a274</code> is selected (value <code>0x23</code>). The first character, <code>2</code> is the Upper4 value. The second character <code>3</code> is the Lower4 value.</p> <p>Occasionally you will only be interested working with a single hexadecimal digit. Using the memory size diagram as an example, an achievement condition where <code>Upper4 0x00a274 = 0x2</code> would be true. A condition where <code>Lower4 0x00a274 = 0x3</code> would be true.</p>"},{"location":"Memory-Inspector-Overview/#memory-sizes-diagram","title":"Memory Sizes Diagram","text":""},{"location":"Memory-Inspector-Overview/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:27] televandalist:</code> Added ToC</li> <li><code>[2022-07-11 16:49] timenoe:</code> Small typo corrected concerning <code>!= Last Value</code> filter</li> <li><code>[2021-08-25 19:10] meleu:</code> fix markdown format</li> <li><code>[2020-06-11 07:34] Jamiras:</code> add details about Continuous Filter backoff algorithm</li> <li><code>[2020-05-17 21:48] Jamiras:</code> update for new memory inspector dialog</li> <li><code>[2019-03-14 00:37] Keltron3030:</code> Updated Memory Inspector Overview (markdown)</li> <li><code>[2019-03-14 00:35] Keltron3030:</code> Added some additional info to memory viewer features as requested by Jr developer.</li> <li><code>[2019-02-14 21:56] meleu:</code> bitfields image</li> <li><code>[2019-02-14 21:45] meleu:</code> test2</li> <li><code>[2019-02-14 21:44] meleu:</code> test</li> </ul>"},{"location":"Memory-Searching-Techniques/","title":"Memory Searching Techniques","text":"<p>Know good techniques? Add to this page.</p>"},{"location":"Minimum-Required-Versions-for-Logic-Features-es/","title":"Versiones M\u00ednimas Requeridas para Funciones en la L\u00f3gica","text":"<p>A veces es \u00fatil saber cuando una funci\u00f3n fue agregada/modificada y las implicaciones de esos cambios, especialmente si estas trabajando en un ticket. Compara la etiqueta de tiempo del ticket con los lanzamientos del toolkit para determinar con que comportamiento el jugador se ve\u00eda afectado.</p> Funci\u00f3n RA_Integration RetroArch ResetIf/PauseIf HitCount 0.073(31-Ago-2018) 1.7.4(30-Ago-2018) Tablas de Clasificaci\u00f3n Cancelar Y (Leaderboard Cancel AND) 0.073(31-Ago-2018) 1.7.0(25-Dic-2017) Tablas de Clasificaci\u00f3n \u00d3 (Leaderboard OR) 0.073(31-Ago-2018) 1.7.4(30-Ago-2018) Soporte para valores Completos de 32-bit 0.073(31-Ago-2018) 1.7.0(25-Dic-2017) Retrasar procesamiento de logros por los primeros 100 frames de cargar el ROM 0.073(31-Ago-2018) (ver la linea de abajo) Remplazar el retraso de 100 frames con la l\u00f3gica de activaci\u00f3n de retraso (delayed activation logic) 0.075(04-Feb-2019) 1.6.3(28-Jul-2017)"},{"location":"Minimum-Required-Versions-for-Logic-Features-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Minimum-Required-Versions-for-Logic-Features/","title":"Minimum Required Versions for Logic Features","text":"<p>Sometimes it's useful to know when a feature was added/changed and the implications of these changes, specially if you are working on a ticket. Compare the ticket timestamp to the toolkit releases to determine which behavior the player would have been subject to.</p> Feature RA_Integration RetroArch rcheevos Leaderboard Cancel AND 0.073(31 Aug 2018) 1.7.0(25 Dec 2017) n/a Full 32-bit value support 0.073(31 Aug 2018) 1.7.0(25 Dec 2017) n/a ResetIf/PauseIf HitCount 0.073(31 Aug 2018) 1.7.4(30 Aug 2018) n/a Leaderboard OR 0.073(31 Aug 2018) 1.7.4(30 Aug 2018) n/a Delay achievement processing for 100 frames on load 0.073(31 Aug 2018) n/a n/a Replace 100 frame delay with delayed activation logic 0.075(04 Feb 2019) 1.6.3(28 Jul 2017) n/a AndNext 0.76(21 Jun 2019) 1.7.7(7 May 2019) 8.0(4 May 2019) Prior 0.76(21 Jun 2019) 1.7.7(7 May 2019) 8.0(4 May 2019) 24-bit read 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.0.1(18 Jun 2019) AddAddress 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Measured 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Measured syntax for leaderboard values 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Detect and report Unsupported achievements 0.79(22 May 2021) 1.8.2(25 Dec 2019) n/a OrNext 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) BitCount 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) MeasuredIf 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) Trigger 0.79(22 May 2021) 1.8.7(17 May 2020) 9.0(9 May 2020) Include hits in save states 0.073(31 Aug 2018) 1.9.1(28-Mar 2021) 9.0(9 May 2020) SubHits 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) ResetNextIf 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Ranges in rich presence lookups 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Maxof($) for Measured leaderboard values 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) ResetIf/PauseIf support for Measured leaderboard values 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Big Endian memory reads 1.0(29 Jan 2022) 1.9.9(5 Sep 2021) 10.2(27 Aug 2021) Measured raw/percent flag 1.0(29 Jan 2022) 1.9.9(5 Sep 2021) 10.2(27 Aug 2021) Floating point memory reads 1.0(29 Jan 2022) 1.10.1(6 Mar 2022) 10.3(14 Jan 2022) Built-in macros for rich presence 1.0(29 Jan 2022) 1.10.1(6 Mar 2022) 10.3(14 Jan 2022) MBF32 LE memory read 1.1(15 Nov 2022) 1.13.0(19 Nov 2022) 10.5(12 Nov 2022) XOR modifier 1.1(15 Nov 2022) 1.13.0(19 Nov 2022) 10.5(12 Nov 2022) Float BE memory reads 1.3(TBD) 1.17.0(3 Feb 2024) 11.0(2 Nov 2023) FixedN leaderboard/RP sizes 1.3(TBD) 1.17.0(3 Feb 2024) 11.1(21 Jan 2024)"},{"location":"Minimum-Required-Versions-for-Logic-Features/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-27 14:12] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2023-11-29 18:27] Jamiras:</code> stub for Float BE</li> <li><code>[2023-07-19 09:37] Jamiras:</code> update RetroArch versions for rcheevos 10.5 features</li> <li><code>[2022-11-15 14:46] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-11-12 07:15] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-03-06 10:44] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-29 11:05] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-13 09:14] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-08 09:59] Jamiras:</code> add 0.80 DLL features</li> <li><code>[2021-06-03 13:48] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> </ul>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/","title":"Tutorial para Jogos Multi-Discos","text":""},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#arquivos-m3u","title":"Arquivos .m3u","text":"<p>Alterar os discos no Playstation exige que voc\u00ea crie um arquivo playlist (.m3u) para seus discos. Isso pode soar intimidador, mas na verdade \u00e9 bem simples.</p> <p>Passo 1: Coloque seus arquivos .bin e .cue na localiza\u00e7\u00e3o desejada.</p> <p>Passo 2: Abra o Bloco de notas.</p> <p>Passo 3: Digite no bloco de notas o nome dos arquivos .cue da mesma forma que eles est\u00e3o no arquivo original. Quando voc\u00ea terminar, seu documento de texto vai estar parecido com algo mais ou menos assim:</p> <p></p> <p>Quando terminar, salve o documento de texto, na mesma localiza\u00e7\u00e3o que o disco do jogo, com o nome que voc\u00ea quiser.</p> <p>Passo 4: Renomeie o documento, mudando sua extens\u00e3o de .txt para .m3u</p> <p></p> <p>ATEN\u00c7\u00c3O: Se voc\u00ea n\u00e3o consegue ver a extens\u00e3o .txt no final do t\u00edtulo do seu documento de texto voc\u00ea precisar\u00e1 alterar as configura\u00e7\u00f5es para que extens\u00f5es sejam vis\u00edveis. No Windows 10 isso \u00e9 muito simples, voc\u00ea consegue encontrar essa op\u00e7\u00e3o na sua pasta em \"View\" e marcar a caixa \"File name extensions\".</p> <p></p> <p>E... pronto! Simples, n\u00e3o? A partir de agora, quando voc\u00ea for iniciar o jogo, abra ele pelo arquivo .m3u que voc\u00ea acabou de criar.</p> <p>ATEN\u00c7\u00c3O: Se voc\u00ea j\u00e1 jogou o primeiro disco do jogo e seus saves n\u00e3o est\u00e3o mais l\u00e1, voc\u00ea pode resgatar eles indo at\u00e9 a pasta \"saves\" do seu emulador, encontrando os arquivos de save e renomeando eles para igualar com o arquivo .m3u que voc\u00ea criou. Por exemplo:</p> <p>'Metal Gear Solid (v1.1) (Disc 1).mcr'   &gt;   'Metal Gear Solid (v1.1).mcr'</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#alterando-discos-no-ralibretro","title":"Alterando discos no RAlibretro","text":"<p>Para alterar os discos no RAlibretro, quando o jogo solicitar a troca, v\u00e1 para o menu \"File\" e siga esses passos</p> <p></p> <p>Passo 1: File &gt; CD-ROM &gt; Open Tray</p> <p>Passo 2: File &gt; CD-ROM &gt; Desired Disc</p> <p>Passo 3: File &gt; CD-ROM &gt; Close Tray</p> <p>E \u00e9 isso!</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#alterando-discos-no-retroarch","title":"Alterando discos no Retroarch","text":"<p>Voc\u00ea ir\u00e1 encontrar a op\u00e7\u00e3o em \"Quick Menu &gt; Disk Control\"</p> <p></p> <p></p> <p>Passo 1: Selecione \"Disk Cycle Tray Status\" (ATEN\u00c7\u00c3O: Se voc\u00ea tem a op\u00e7\u00e3o \"Pause when menu activated\" ativada, voc\u00ea precisar\u00e1 sair e entrar no menu novamente para que o jogo saiba que a tampa do disco foi aberta)</p> <p>Passo 2: Selecione \"Disk Index\" (Esquerda e direita para alterar os discos)</p> <p>Passo 3: Selecione \"Disk Cycle Tray Status\" novamente</p> <p>E pronto!</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-01-10 11:36] Hyze01:</code> Updated Multi Disc Games Tutorial pt_BR (markdown)</li> <li><code>[2020-01-10 11:35] Hyze01:</code> Updated Multi Disc Games Tutorial pt_BR (markdown)</li> <li><code>[2020-01-10 11:23] Hyze01:</code> Ajudado com a tradu\u00e7\u00e3o.</li> <li><code>[2020-01-10 10:31] meleu:</code> Created Multi-Disc Games Tutorial-pt_BR (markdown)</li> </ul>"},{"location":"Multi-Disc-Games-Tutorial/","title":"Multi-Disc Games Tutorial","text":""},{"location":"Multi-Disc-Games-Tutorial/#m3u-files","title":"m3u files","text":"<p>Changing discs on Playstation requires creating a playlist file (.m3u) for your discs. This may sound intimidating but it's actually very simple.</p> <p>Step 1: Place your .bin and .cue files in the desired location.</p> <p>Step 2: Open Notepad</p> <p>Step 3: Type the names of your .cue files exactly as they're named on your files. When you're finished your text document should look something like this:</p> <p></p> <p>When you're finished save the text document in the same location as your game discs with whatever name you like.</p> <p>Step 4: Rename the document, changing the extension from .txt to .m3u</p> <p></p> <p>NOTE: If you can't see the .txt extension at the end of your text document title you need to change your settings to show known file extensions. In Windows 10 it's very simple, you can find that on your folder under 'View' and a checkbox reading 'File name extensions'</p> <p></p> <p>Now you're done! Simple, huh? From here on out, when you start the game, load it using the .m3u file you've just created.</p> <p>NOTE: If you have already played the first disc of a game and find your saves no longer there, you can retrieve them by navigating to your emulators 'saves' folder, finding the save for your first disc and renaming it to match the .m3u you've created. for example:</p> <p>'Metal Gear Solid (v1.1) (Disc 1).mcr'   &gt;   'Metal Gear Solid (v1.1).mcr'</p>"},{"location":"Multi-Disc-Games-Tutorial/#changing-discs-in-ralibretro","title":"Changing Discs in RAlibretro","text":"<p>To change discs on RAlibretro, when the game prompts you, go to the file menu and follow these steps</p> <p></p> <p>Step 1: File &gt; CD-ROM &gt; Open Tray</p> <p>Step 2: File &gt; CD-ROM &gt; Desired Disc</p> <p>Step 3: File &gt; CD-ROM &gt; Close Tray</p> <p>And that's it!</p>"},{"location":"Multi-Disc-Games-Tutorial/#changing-discs-in-retroarch","title":"Changing Discs in Retroarch","text":"<p>You'll find the option in Retroarch under 'Quick Menu &gt; Disk Control'</p> <p></p> <p></p> <p>Step 1: Select 'Disk Cycle Tray Status' (Note: If you have the 'Pause when menu activated' option on, you'll need to turn the menu off and on again so that the game knows the disc tray has been opened)</p> <p>Step 2: Select 'Disk Index' (Left and right to change discs)</p> <p>Step 3: Select 'Disk Cycle Tray Status' again</p> <p>And you're done!</p>"},{"location":"Multi-Disc-Games-Tutorial/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-31 09:42] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-31 11:01] meleu:</code> add proper headings and other cosmetics</li> <li><code>[2019-12-29 12:26] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 12:22] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:58] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:57] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:56] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:53] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:52] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:51] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> </ul>"},{"location":"My-game-is-not-loading-achievements-es/","title":"Mi juego no esta cargando los logros","text":"<p>Quiz\u00e1s cargaste tu juego, pero ves una ventana emergente:  Luego miras la interfaz (usualmente con 'ESC') y ves: </p> <p>O tal vez obtuviste estos mensajes:</p> <p></p> <p>y</p> <p></p> <p>Cuando ocurre cualquiera de estas situaciones es por que, ya sea el juego a\u00fan no tiene logros, o es probable que tengas la ROM incorrecta.</p> <p>Solo para estar seguro, busca el nombre del juego y verifica los resultados que coincidan. </p> <p>Si el juego tiene logros pero tu ROM no est\u00e1 en nuestro sistema, necesitar\u00e1s encontrar la ROM correcta, u obtener soporte para tu ROM.</p> <p>Verifica el primer post del hilo oficial del juego en el foro. El enlace para ello se encuentra en la parte inferior de la lista de logros, en las respectivas p\u00e1ginas de los juegos. Ejemplo para Super Mario Bros.:</p> <p></p> <p>Probablemente el primer post del hilo oficial del juego en el foro tenga una lista de ROM v\u00e1lidas para el juego, y tambi\u00e9n el \"checksum\" de las ROM.</p> <p>Nota: el \"checksum\" es un n\u00famero usado para confirmar si dos copias de un archivo son id\u00e9nticas. En RA, lo usamos para asegurar que el jugador est\u00e9 usando la misma ROM que el desarrollador de los logros.</p> <p>Tambi\u00e9n verifica los \u00faltimos posts del hilo oficial del juego en el foro y los comentarios en la p\u00e1gina del juego en busca de pistas sobre qu\u00e9 ROM necesitas. Si el nombre correcto de la ROM y el \"checksum\" a\u00fan no se encuentran en la lista, deber\u00e1s solicitarlo (por favor, NO PIDAS ENLACES PARA DESCARGAR EL ROM, solo el nombre del archivo y el \"checksum\"). Puedes solicitarlo en la p\u00e1gina del juego en el foro, o pedir ayuda en Discord o en el chat del sitio en la p\u00e1gina principal.</p> <p>Tambi\u00e9n puedes contribuir a la comunidad obteniendo soporte para tu ROM, si es que es compatible. Publica el \"checksum\" de tu ROM existente en el foro de ese juego y tambi\u00e9n el nombre exacto que tienes para el ROM, y un desarrollador lo revisar\u00e1 contigo para ver si es compatible.</p> <p> Como encontrar el \"checksum\" de tu ROM.</p> <p>Para obtener m\u00e1s informaci\u00f3n sobre el \"checksum\" y los hashes, puedes leer este articulo (en Ingl\u00e9s): https://datacrystal.romhacking.net/wiki/Hashes</p>"},{"location":"My-game-is-not-loading-achievements-es/#listas-completas-de-la-mayoria-de-los-juegos-en-la-base-de-datos-de-retroachievements","title":"Listas completas de la mayor\u00eda de los juegos en la base de datos de RetroAchievements","text":"<p>El usuario caricatur hizo un gran trabajo al compilar algunas listas de ROM vinculadas a los juegos que tenemos en la base de datos en RetroAchievements. Aqu\u00ed est\u00e1n los enlaces a las publicaciones del foro respectivas:</p> <ul> <li>Mega Drive/Genesis</li> <li>Master System</li> <li>PC Engine</li> <li>Gameboy</li> <li>Gameboy Color</li> <li>Gameboy Advance</li> <li>NES</li> <li>SNES</li> <li>Nintendo 64</li> </ul>"},{"location":"My-game-is-not-loading-achievements-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:56] meleu:</code> fix markdown format</li> <li><code>[2018-10-11 00:26] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:47] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-30 12:27] ShinyNinetalesTM:</code> added link to \"comprehensive list\" for NES, as well as done for the english version</li> <li><code>[2018-05-09 13:13] ShinyNinetalesTM:</code> Created My game is not loading achievements-es (markdown)</li> </ul>"},{"location":"My-game-is-not-loading-achievements/","title":"My game is not loading achievements","text":"<p>Maybe you loaded up your game but you see a popup:  Then you check the overlay (typically ESC) and see: </p> <p>Or maybe you got these messages:</p> <p></p> <p>and</p> <p></p> <p>When any of these situations happens, either your game doesn't have achievements yet or more likely you have the incorrect ROM.</p> <p>Just to be sure, search for the game name and check matching results. </p> <p>If your game has achievements but your ROM isn't in our system either you'll need to find the correct ROM or get support for your ROM.</p>"},{"location":"My-game-is-not-loading-achievements/#how-do-i-know-if-my-rom-is-compatible","title":"How do I know if my ROM is compatible?","text":"<p>If your ROM has the same checksum/hash as those linked to the website, then it is compatible.</p> <p>Note: a \"checksum\" or \"hash\" is a number used to confirm if two copies of a file are identical. On RA we use it to assure the player is using the same ROM as the achievement developer.</p> <p>There are two ways of checking what checksums/hashes are linked to a game:</p>"},{"location":"My-game-is-not-loading-achievements/#check-the-linked-hashes-page-associated-with-the-game","title":"Check the Linked Hashes page associated with the game","text":"<p>Example for Super Mario Bros. NOTE: You must be logged in to view linked hashes.</p> <p>You can access this page by clicking the \"Hashes linked to this game\" button in the \"More Info\" section on the game page.</p> <p></p> <p>It takes you to a page like this:</p> <p></p>"},{"location":"My-game-is-not-loading-achievements/#check-the-top-post-of-the-official-games-forum-thread","title":"Check the top post of the official game's forum thread","text":"<p>The link for it can be found at the bottom of the achievement list on game pages OR in the More Info section. Example for Super Mario Bros.:</p> <p></p> <p></p> <p>The first post of the official game's forum thread usually has a list of valid ROMs for the respective game and also the checksum of the ROMs. </p> <p>If your ROMs name and checksum aren't listed yet, then you'll need to ask for it (please, do NOT ask for links to download the ROM, only the filename and the checksum). You can request it in the game's forum page or ask for help in Discord or on the site chat on the front page.</p> <p>Once you make a request, a developer will review it and make sure it works. Then they will add the hash to the 'compatible hashes page.' </p>"},{"location":"My-game-is-not-loading-achievements/#how-to-find-the-checksum-of-your-rom","title":"How to find the checksum of your ROM:","text":"<p>In the menu bar <code>RetroAchievements</code> &gt; <code>Get ROM Checksum</code></p> <p> </p> <p>For more details about checksum and hashes, read here: https://datacrystal.romhacking.net/wiki/Hashes</p>"},{"location":"Naming-Conventions/","title":"Naming Conventions","text":""},{"location":"Naming-Conventions/#naming-conventions","title":"Naming Conventions","text":"<ul> <li>No Symbols: Do not use accented/special characters like the <code>\u00e9</code> in Pokemon, as they currently break a few things (like feed). They are also not visible in search without the special character. Same for UTF-8 Universal Emoji codes. Allowed exception: Rich Presence Scripts.</li> </ul>"},{"location":"Naming-Conventions/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 15:27] televandalist:</code> Created Naming Conventions (markdown)</li> </ul>"},{"location":"New-Achievement-Set-Checklist/","title":"New Achievement Set Checklist","text":""},{"location":"New-Achievement-Set-Checklist/#before-you-begin","title":"Before you Begin","text":""},{"location":"New-Achievement-Set-Checklist/#1-are-you-free-of-tickets","title":"1. Are you free of tickets?","text":"<p>Before working on new games you must address all open tickets you have. Once you're free of tickets, then go ahead. Tickets are addressed when they are either resolved/closed for a valid reason with a comment on the ticket, or when transferred to reporter and awaiting further information (such as more details, reproduction steps, or save states).</p>"},{"location":"New-Achievement-Set-Checklist/#2-is-the-game-present-on-the-database","title":"2. Is the game present on the database?","text":""},{"location":"New-Achievement-Set-Checklist/#no","title":"No","text":"<p>Then ask for it to be added on Discord #help-me or on our forums and some dev will add it for you. It's essential you choose the right ROM(s) to work with. If you want to work on a ROM hack, check the achievements for ROM hacks doc first.</p>"},{"location":"New-Achievement-Set-Checklist/#yes","title":"Yes","text":"<p>Good! Go ahead.</p>"},{"location":"New-Achievement-Set-Checklist/#3-does-the-game-already-have-an-achievement-set","title":"3. Does the game already have an achievement set?","text":""},{"location":"New-Achievement-Set-Checklist/#yes_1","title":"Yes","text":"<p>If there is an existing set, don't give up. You can still improve it, by adding/removing/reworking achievements, or make changes to titles and images, etc. However you'll need to go through the set revision process.</p>"},{"location":"New-Achievement-Set-Checklist/#no_1","title":"No","text":"<p>Look deeper. Often there are multiple entries in the database for the same game under different titles. Once you're sure, you'll need to check if there's another dev working on the game.</p> <p>Note: Only one achievement set is allowed per game per console. For details see working with the right ROM.</p>"},{"location":"New-Achievement-Set-Checklist/#4-is-another-developer-working-on-the-game","title":"4. Is another developer working on the game?","text":"<p>To be sure if there's another dev working on a game, check the game's claims on the game page. This is needed to avoid conflicts between multiple developers working on the same game.</p>"},{"location":"New-Achievement-Set-Checklist/#yes_2","title":"Yes","text":"<p>If this is the case, you may not work on the game unless the developer(s) with the claim agree to a collaboration. Do not make a collaboration claim without approval the developer(s) working on the set.</p> <p>Developers are expected to renew their reservation every three months. Look at the time stamps on the claims history to see when the developer posted a reservation for development. If the developer has not stated or renewed their reservation on the game after three months the claim will expire and then you can make a claim and post your plans to work.</p>"},{"location":"New-Achievement-Set-Checklist/#no_2","title":"No","text":"<p>Great! You're free to go ahead! The next step is to announce your plans to develop achievements for the game.</p>"},{"location":"Overlay-Themes/","title":"Overlay Themes","text":"<p>Preview gallery</p> <p>Default theme file showing all available settings. Must be named <code>theme.json</code> when placed in <code>overlay</code> subdirectory.</p>"},{"location":"Overlay-Themes/#single","title":"Single","text":"<ul> <li>Default by Scott </li> <li>Crash Bandicoot by Dexterspet </li> <li>Mega Man Classic by Salsa </li> <li>Nintendo Mix (Slumber Party) by Salsa </li> <li>Roll-chan Evolution by Salsa </li> <li>The Legend of Zelda Classic by Salsa </li> <li>Ys Book I &amp; II by Salsa </li> <li>Sonic by matheus2653 </li> <li>Arnold Schwarzenegger by Salsa </li> <li>Reginaldo Rossi by Salsa </li> <li>Spyro by rabbids4eva</li> <li>Gex by rabbids4eva</li> <li>PlayStation 2 by rabbids4eva</li> <li>LittleBIGPlanet by rabbids4eva</li> <li>Kula World / Roll Away by rabbids4eva</li> <li>MediEvil by rabbids4eva</li> <li>wip3out by rabbids4eva</li> </ul>"},{"location":"Overlay-Themes/#multiple-customizable","title":"Multiple (customizable)","text":"<ul> <li>The Legend of Zelda franchise by kdecks</li> </ul>"},{"location":"Overlay-Themes/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-13 14:56] televandalist:</code> Renamed \"Downloads\" page to \"Overlay Themes\" since that's all that was left - :lel:</li> </ul>"},{"location":"PauseIf-Flag-es/","title":"Bandera PauseIf","text":"<p>Un <code>PauseIf</code> (PausarSi) puede ser seleccionado en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Mientras sea verdadero, el <code>PauseIf</code> pausa la actividad de todas las condiciones en el mismo grupo. No pausa condiciones en otros grupos (mas sobre Grupos Alternos (Alt Groups) abajo).</p> <p>Nota: ten en menta que todas las condiciones en la oracion anterior incluye condiciones <code>ResetIf</code>! En otras palabras Un <code>ResetIf</code> no va a funcionar si un <code>PauseIf</code> esta activo.</p> <p>Un <code>PauseIf</code> es usualmente para prevenir hit counts en una situacion especifica (como pausar el juego). Tambien se utiliza cuando quieres mantener los contadores de hits (hit counts) capturados anteriormente, pero no se quiere incrementar o reseatear mientras este sucediendo algo.</p>"},{"location":"PauseIf-Flag-es/#pauseif-con-hit-counts","title":"<code>PauseIf</code> con hit counts","text":"<p>Una condicion <code>PauseIf</code> con un contador de hits (hit count) especifico solo se va a disparar cuando el numero de hits se cumplan. Una vez que el contador de hits (Hit Counts) se cumpla, el grupo se mantiene pausado asta que un <code>ResetIf</code>en otro grupo sea verdadera o hasta que se reinicie el juego. Un <code>PauseIf</code> sin un contador de hits (Hit Count) se va a terminar de pausar cuando la condicion ya no sea verdadera.</p>"},{"location":"PauseIf-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:00] meleu:</code> Updated PauseIf Flag ES (markdown)</li> </ul>"},{"location":"PauseIf-Flag/","title":"PauseIf Flag","text":"<p>The <code>PauseIf</code> flag can be chosen in the Flag column of the Achievement Editor.</p> <p><code>PauseIf</code> is usually used to prevent hit counts from going up during a specific situation (like when the game is paused). It's used when you want to keep previously earned hit count, but don't want to increment it or reset it while something else is going on.</p> <p>When a group is processed, first all <code>PauseIf</code> are evaluated in order. As soon as any <code>PauseIf</code> is true, the group stops processing. This means that any <code>PauseIf</code>s after the true <code>PauseIf</code> will not be evaluated. This allows one <code>PauseIf</code> to prevent another <code>PauseIf</code> from collecting hits, but it's usually better to write the second <code>PauseIf</code> with an <code>AndNext</code> to limit when it collects hits.</p> <p>This also means that any <code>ResetIf</code>s in the group will not be processed while the group is paused. To reset the hit count on a <code>PauseIf</code>, you must place the <code>ResetIf</code> in an alt group or attach a <code>ResetNextIf</code> to the <code>PauseIf</code>.</p> <p>Delta values are not affected by paused groups. The value returned by a delta read will still be from the previous frame, not from the frame just before the group was paused.</p>"},{"location":"PauseIf-Flag/#pauseif-with-hit-counts","title":"<code>PauseIf</code> with hit counts","text":"<p>A <code>PauseIf</code> condition with a hit count target will only trigger when the hit count target is met. Once the hit count target is met, the group remains paused until the hit count is reset by a <code>ResetIf</code> in another group or a <code>ResetNextIf</code> attached to the <code>PauseIf</code>. You may hear this referred to as a PauseLock.</p> <p>A <code>PauseIf</code> without a hit count will automatically unpause when the condition is no longer true.</p>"},{"location":"PauseIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-05-24 18:58] Jamiras:</code> Updated PauseIf Flag (markdown)</li> <li><code>[2021-08-07 17:00] Dimedime:</code> updated interaction with ResetNextIf</li> <li><code>[2019-02-12 13:13] meleu:</code> typo</li> <li><code>[2019-02-12 13:13] meleu:</code> fix broken link</li> <li><code>[2019-02-12 09:36] meleu:</code> Updated PauseIf (markdown)</li> </ul>"},{"location":"Prior-Values/","title":"Prior Values","text":"<p>A <code>Prior</code> value is the previous value at an address. It is similar to Delta, except it's only updated when the current values changes, whereas Delta is updated every frame. Note: when you use <code>Prior</code> it is implicit that you are referring to an address and not a value.</p> <p>Examples of how it can be used:</p> <ul> <li>Ensures a player visited the previous level instead of using a password to get there: <code>prior level = 6</code> would only be true if the player isn't currently on level 6, but hasn't been anywhere except the current level since being on level 6. If they came straight from the menu <code>prior level</code> would likely be 0.</li> </ul>"},{"location":"Prior-Values/#comparison-of-memory-types-across-several-frames","title":"Comparison of memory types across several frames:","text":"Frame Mem Delta Prior 1 25 0 0 2 25 25 0 3 30 25 25 4 35 30 30 5 35 35 30 6 35 35 30 7 40 35 35 <p>Delta is always one frame behind Mem. Prior is only updated when Mem changes.</p>"},{"location":"Prior-Values/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-01-10 16:03] meleu:</code> fix markdown link</li> <li><code>[2021-01-05 10:53] tofof:</code> fix busted link</li> <li><code>[2019-06-21 19:03] Jamiras:</code> Updated Prior Values (markdown)</li> <li><code>[2019-06-21 19:03] Jamiras:</code> initial documentation</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/","title":"Progression and Win Condition Guidelines","text":"<p>Progression and Win Type conditions are assigned to achievements in a set and used to designate when a game has been beaten. A game is considered when all the following statements are true:</p> <ol> <li>All progression-typed achievements have been earned, if any are present.</li> <li>Any win-typed achievement has been earned, if any are present.</li> </ol> <p>Typing core sets is required for set release. Subsets should not be typed.</p>"},{"location":"Progression-and-Win-Condition-Guidelines/#how-to-add-types-to-achievements","title":"How To Add Types to Achievements","text":"<ul> <li>For individual achievements, you may change the type in the Developer panel on that achievement's page on the RA website.</li> <li>For multiple achievements at the same time, select Manage Core Achievements or Manage Unofficial Achievements in the Developer panel on the game's page on the RA website, then check the box for all achievements for a given typing and click either Set Selected to Progression or Set Selected to Win Condition.</li> <li>At the time of this update, typing is unavailable in RA_Integration, so it cannot be done through emulators.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#progression-type-conditions","title":"Progression Type Conditions","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#progression-conditions","title":"Progression Conditions:","text":"<ul> <li>Achievements that mark steady progress through a set. Post-game content is usually not progression.</li> <li>Cannot be missed assuming no glitches/exploits have been used.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#non-progression","title":"Non-progression","text":"<p>The following types of achievements are not considered for progression type marking:</p> <ul> <li>Optional content</li> <li>Higher Difficulties</li> <li>Side Quests</li> <li>Collectibles</li> <li>Challenges</li> <li>Easter Eggs</li> <li>Story that can be missed, including ending variations.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#win-conditions","title":"Win Conditions","text":"<ul> <li>Achievement(s) that mark the end of the game. Bad endings are usually not true endings.</li> <li>Some games may have multiple Win Conditions, in which case earning any of these achievements (plus all progression) marks the game as beaten.</li> <li>Others may only have one, which should still be marked as a Win Condition for user readability.</li> <li>In some cases, there is no single Win Condition, such as a puzzle game when progression can be done in any order. In these cases, earning all Progression achievements will mark the game as beaten.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#types-of-progression","title":"Types of Progression","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#standard","title":"Standard","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#linear-progression","title":"Linear progression","text":"<ul> <li>Things you encounter as you play through level-to-level.</li> <li>Example: Prince of Persia - Each level is played sequentially to complete the game.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#grouped","title":"Grouped","text":"<ul> <li>Levels are grouped together rather than having individual achievements.</li> <li>Example: Lemmings - Achievements are awarded every 5 levels.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#bosses","title":"Bosses","text":"<ul> <li>Boss fights as story milestones.</li> <li>Example: Spyro: Year of the Dragon - Buzz, Spike and Scorch are mandatory boss fights to be able to progress and defeat the Sorceress.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#key-itemsevents","title":"Key Items/Events","text":"<ul> <li>Collecting important items, reaching the next location or witness key story events.</li> <li>Example: Final Fantasy - Significant events such as Sleeping Prince and Flotation act as story milestones between the game's other boss progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#non-standard-progression","title":"Non-Standard Progression","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#compilation","title":"Compilation","text":"<ul> <li>All games within these have equal importance, so all need to be completed to mark the compilation as beaten.</li> <li>Mark Progression for all individual games as usual.</li> <li>Win Conditions must instead be marked as Progression.</li> <li>Example: Final Fantasy Origins - Both Scions and Sinners and True Emperor of Hell are marked as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#intended-skips","title":"Intended Skips","text":"<ul> <li>Some games include features that allow levels to be skipped without the use of bugs or exploits. In these cases, skippable levels must not be marked as progression as the game can be beaten without them.</li> <li>Example: Super Mario Bros. - Because it is possible to warp to different levels, it is not possible to mark any as Progression. Saved The Girl is marked as the Win condition.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#limited-scopelittle-substance","title":"Limited Scope/Little Substance","text":"<ul> <li>Some games are so simplistic, or have so little content, that the difference between Progression and Mastery is minor. If Progression is clear, mark as usual. Otherwise, mark every achievement as a Progression Condition.</li> <li>Example: Dice of Fate - This is a dice simulator.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-game-modes","title":"Multiple Game Modes","text":"<ul> <li>All non-endless and non-restrictive modes that are available when first launching the game have Progression Conditions marked.</li> <li>These game modes have equal importance, much like the individual games in a compilation. Any Win Conditions should instead be marked as Progression.</li> <li>Endless modes, by definition, continue until failure, so lack Progression and are not included.</li> <li>Restrictive modes limit the player in some way, most often with time or turn limits. They may appear to contain Progression, but the limitations act as an additional challenge, making these achievements Non-Progression that should not be marked.</li> <li>Example: Kirby Super Star - Bye Bye Birdy, What A Meta-Knightmare, Like A Gentle Breeze, Back On Solid Ground and Balance Restored...? are marked as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#subsets","title":"Subsets","text":"<ul> <li>These are inherently focused on a challenge, restriction or other non-standard ways of playing a game.</li> <li>Do not mark any Progression or Win conditions; this is already covered within the core set.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-possible-win-conditions","title":"Multiple Possible Win Conditions","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-endings","title":"Multiple Endings","text":"<ul> <li>Endings that occur at the end of the game through normal play should be marked as Win Conditions.</li> <li>Alternative endings that require optional content such as collectibles are Non-Progression and should not be marked.</li> <li>Alternative endings that end the storyline early are also Non-Progression and should not be marked.</li> <li>Examples:<ul> <li>Knuckles Chaotix - Both Bad Ending and Good Ending are marked as Win conditions. The ending is determined by optional collectibles.</li> <li>Oddworld: Abe's Oddysee - Both Bad Ending and Good Ending are marked as Win conditions. The ending is determined by saving NPCs.</li> <li>Sigma Star Saga - One is the Loneliest Number and Show Me This Planet are marked as Win conditions. The ending is determined by a gameplay action that only changes the final cutscene.</li> <li>Cave Story MD - Coward is not marked as either Progression or Win because it ends the game early and does not resolve the story. Shtuff Happens and Curse Broken are both marked as Win conditions.</li> <li>Castlevania: Dawn of Sorrow - The Dark Lord Returns is not marked as either Progression or Win because it ends the game early and does not resolve the story. No Dark Lord Here is marked as the Win condition.</li> <li>Shadowgate - Uh... What? is not marked as either Progression or Win because it causes the player's death. Talimar the Black is marked as the Win condition.</li> <li>Sonic Adventure 2 - Final Story</li> <li>Zero Escape: Nine Hours, Nine Persons, Nine Doors - Plaudite! Acta Est Fabula!</li> <li>Live-A-Live - Live A Live requires optional character recruitment. Only Demon King No More is marked as a Win condition.</li> <li>Powerslave | Exhumed - King of the World requires optional collectibles. Only Time to Rest is marked as a Win condition.</li> <li>Sonic 3 &amp; Knuckles - Hyper Sonic Victory, Hyper Knuckles Victory and Super Tails Victory all require optional collectibles. Sonic Victory, Knuckles Victory and Tails Victory are all marked as Win conditions.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-difficulties","title":"Multiple difficulties","text":"<ul> <li>Progression and Win Conditions should be marked for the lowest difficulty supported by the set.</li> <li>If difficulty achievements do not stack (e.g. normal or higher), for each difficulty available from a fresh save, mark each game completion achievement as a Win Condition.</li> <li>Endings that are only available on lower difficulties are not considered Progression.</li> <li>Examples:<ul> <li>Devil May Cry 3 - Leave Me And Go and Normal Mode are marked as Win conditions as Easy and Normal are available on a 1st playthrough.</li> <li>Resident Evil 3: Nemesis - Carlos, My Love! and Is That You?! are Win conditions, Easy is not covered by the set.</li> <li>Streets of Rage 3 - The End? is not marked as Progression or Win because Easy difficulty ends the game early. Unfinished Business, Time's Up and The End! are all Win conditions.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-storylinescharacters","title":"Multiple Storylines/Characters","text":"<ul> <li>Some linear games have an epilogue or expanded story that are still part of a standard playthrough. These resolve the storyline and should be marked as a Win Condition.</li> <li>Some games may have endless post-game content after the story has resolved. This optional content should not be marked as either Progression or Win Conditions.</li> <li>Additional story content that is exclusive to a particular version or release are part of Progression. These differentiate that game from other releases and should be marked as Win Conditions. Endings reached before this point should be marked as Progression.</li> <li>Credits do not always mean the end of a story.</li> <li>Some games have progression differences based on initial character choice. In these cases, all starting characters' endings are needed to beat the game, so these should all be marked as Progression Conditions.</li> <li>If the character choice only affects playstyle or abilities, each character's ending should be marked as Win Conditions.</li> <li>Characters may each have multiple endings. In these cases, make sure to only mark their normal ending, not ones that require extra steps.</li> <li>Examples:<ul> <li>EarthBound - Smiles and Tears is marked as the Win condition, On a Mission from God is marked as a Progression condition.</li> <li>Resident Evil 2 - No Time to Waste and I Have to Find You are marked as Win conditions. Progression cannot be marked due to the order of characters chosen not being significant to the overall story.</li> <li>Shin Megami Tensei: Persona 3 FES - The Fate of the Sealed is marked as the Win condition, Thank You for Everything is marked as a Progression condition.</li> <li>Final Fantasy I &amp; II: Dawn of Souls - Break The Time Loop, To Heck With You! and To Arubboth With You! are marked as Progression. This version of the game expands the storyline to resolve the plot.</li> <li>Final Fantasy V: Advance - The True Power of the Void is not marked as Progression or Win due to being post-game content in an endless game. The Win condition is Warriors of Light.</li> <li>Pokemon Gold Version - Battle On the Mountain is not marked as Progression or Win due to being post-game content in an endless game. The Win condition is Elite Five.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#notable-genres","title":"Notable Genres","text":"<p>These genres often lack standard progression, so have additional guidelines here. They may also feature multiple game modes; see the guidelines above for how to mark Progression for these.</p>"},{"location":"Progression-and-Win-Condition-Guidelines/#arcade","title":"Arcade","text":"<p>Use the first of the following that is applicable:</p> <ul> <li>Mark achievements for clearing each stage as Progression and the last as a Win Condition.<ul> <li>Example: Galaga - Bulletstorm is marked as the Win condition.</li> </ul> </li> <li>Use the last stage that adds new elements (enemies/obstacles/mechanics) or increases the difficulty as the final stage of Progression.<ul> <li>Example: Donkey Kong - Mark 150m Finish as the Win condition.</li> </ul> </li> <li>Use the set developer's score achievements as Progression, with reaching the highest as the Win Condition.<ul> <li>Example: Pokemon Pinball: Ruby &amp; Sapphire - 1st Place Ruby, 1st Place Sapphire and High Roller are marked as Progression.</li> </ul> </li> <li>Use the in-game leaderboards' high scores as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#fighting","title":"Fighting","text":"<ul> <li>The game should be cleared with all starting characters for a Beat</li> <li>The progression and/or win achievements for each character available on a fresh launch should be marked as Progression, with no Win Conditions.<ul> <li>Example: Soulcalibur II - Weapon Master (Story) and each default character's Arcade (Normal or Higher) are marked as Progression. Time Attack (Restrictive), Survival (Endless) and the unlockable modes are not marked.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#puzzle","title":"Puzzle","text":"<ul> <li>Some Puzzle games allow levels to be played in any order. In these cases, do not mark any Win Conditions, only Progression.</li> <li>Puzzle games may segment levels by difficulty. These function as categories rather than the same levels again but more challenging, so higher difficulties are still part of Progression in these cases.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#rhythm","title":"Rhythm","text":"<ul> <li>All songs unlocked through standard gameplay are considered Progression.</li> <li>Do not include songs unlocked with additional steps such as high score or chain requirements.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#shoot-em-ups-aka-shumps","title":"Shoot 'em Ups (aka Shumps)","text":"<ul> <li>If character/ship choice does not affect the storyline, only one needs to be cleared to Beat the game.</li> <li>Mark each character's win achievement as a Win Condition.</li> <li>Do not mark character-specific achievements as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#sports","title":"Sports","text":"<ul> <li>Win a game is only considered Progression if there are no other game modes.</li> <li>Progression should be marked for all non-endless modes available from a fresh launch.</li> <li>All tournaments/events unlocked through standard gameplay are considered Progression.</li> <li>Do not include tournaments/events unlocked through additional steps such as perfect games</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-17 08:43] Andrew Comer:</code> Updated Progression and Win Condition Guidelines (markdown)</li> <li><code>[2023-11-17 08:19] The Mystical One:</code> Added details on how to apply types to the achievements.</li> <li><code>[2023-11-06 17:25] Andrew Comer:</code> More formatting fixes</li> <li><code>[2023-11-06 17:20] Andrew Comer:</code> Formatting fixes</li> <li><code>[2023-11-05 16:36] Andrew Comer:</code> Remove duplicate bullet points</li> <li><code>[2023-11-03 14:34] Etron:</code> Added game links to each example</li> <li><code>[2023-11-03 08:05] The Mystical One:</code> Initial Creation based on Progression Typing Draft</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#changelog_1","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-17 08:43] Andrew Comer:</code> Updated Progression and Win Condition Guidelines (markdown)</li> <li><code>[2023-11-17 08:19] The Mystical One:</code> Added details on how to apply types to the achievements.</li> <li><code>[2023-11-06 17:25] Andrew Comer:</code> More formatting fixes</li> <li><code>[2023-11-06 17:20] Andrew Comer:</code> Formatting fixes</li> <li><code>[2023-11-05 16:36] Andrew Comer:</code> Remove duplicate bullet points</li> <li><code>[2023-11-03 14:34] Etron:</code> Added game links to each example</li> <li><code>[2023-11-03 08:05] The Mystical One:</code> Initial Creation based on Progression Typing Draft</li> </ul>"},{"location":"RA-In-Review/","title":"RA In Review","text":"<p>Logging things to be mentioned in the next \"year in review\" article.</p>"},{"location":"RA-In-Review/#2021","title":"2021","text":""},{"location":"RA-In-Review/#january","title":"January","text":"<ul> <li>Added Intellivision support (credits? Jamiras?).</li> <li>RAPatches repository - televandalist</li> </ul>"},{"location":"RA-In-Review/#april","title":"April","text":"<ul> <li>Watara Supervision support</li> <li>QA Team created</li> <li>Any admin can deploy documentation website</li> </ul>"},{"location":"RA-In-Review/#may","title":"May","text":"<ul> <li>Updated Code of Conduct</li> <li>Server comments logging changes in the Leaderboards - Searo</li> </ul>"},{"location":"RA-In-Review/#previous-years","title":"Previous Years","text":"<ul> <li>2020: https://retroachievements.org/viewtopic.php?t=12239</li> <li>2019: https://retroachievements.org/viewtopic.php?t=9929</li> <li>2018: https://retroachievements.org/viewtopic.php?t=8060 and https://retroachievements.org/viewtopic.php?t=8099</li> <li>2017: https://retroachievements.org/viewtopic.php?t=6081</li> </ul>"},{"location":"RA-Trackers/","title":"RA Trackers","text":""},{"location":"RA-Trackers/#achievement-trackers","title":"Achievement Trackers","text":""},{"location":"RA-Trackers/#retro-achievement-tracker","title":"Retro Achievement Tracker","text":"<p>Developer: RetroS3xual \ud83d\udce5 Download \ud83c\udfa5 Tutorial</p> <p>Custom Layout: YES Game Information: YES User Information: YES Maintained: YES </p>"},{"location":"RA-Trackers/#retreon","title":"Retreon","text":"<p>Developer: glacia \ud83d\udce5 Download</p> <p>Custom Layout: YES Game Information: YES User Information: NO Maintained: NO </p>"},{"location":"RA-Trackers/#missing-tracker","title":"Missing Tracker","text":"<p>If you have made or use a tracker which is not listed here you can contact the moderation team on the RetroAchievements Discord Server or send a private message to RAdmin including the name of the tracker and the creator of it.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/","title":"RABot, the RA Discord Robot","text":"<p>RABot is the the official RetroAchievements Discord robot. Therefore, to interact with him, you need to be a member of the RA Discord server.</p> <p>RABot has many cool and useful commands and in this page you'll see some examples of how some of them can be used.</p> <p>RABot is powered by JavaScript, Node.js, discord.js and Commando.</p> <p>Special thanks: the DragonFire's Xiao bot is a great source of inspiration for many of the cool commands we have in RABot, like <code>!bulbapedia</code>, <code>!manga</code>, <code>!translate</code>, <code>!define</code> and others.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-help","title":"Getting help","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#help","title":"<code>!help</code>","text":"<p>This command makes the RABot send a DM with the list of commands available.</p> <p>If you need help about a specific command use <code>!help command_name</code>.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#docs","title":"<code>!docs</code>","text":"<p>Provide links to RetroAchievements documentation.</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#rarch","title":"<code>!rarch</code>","text":"<p>Provide basic info about RetroArch.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#rules","title":"<code>!rules</code>","text":"<p>Show the rules, or a specific one.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#about","title":"<code>!about</code>","text":"<p>Show info about the RABot.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#panic","title":"<code>!panic</code>","text":"<p>What to do when the site is down.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#creating-polls","title":"Creating polls","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#poll","title":"<code>!poll</code>","text":"<p>Creates a simple poll. People can vote adding reactions, but they can also vote with unlisted reactions. See <code>!tpoll</code> if you are interested in a more advanced and serious poll.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#tpoll","title":"<code>!tpoll</code>","text":"<p>Creates a timed poll. In this kind of poll only the first reaction is considered a vote, and if people react with an unlisted reaction then the vote is voided.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#dealing-with-numbers","title":"Dealing with numbers","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#hex","title":"<code>!hex</code>","text":"<p>Converts a non-negative integer from decimal (or binary) to hexadecimal (or vice-versa).</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#bin","title":"<code>!bin</code>","text":"<p>Converts a non-negative integer from decimal (or hexadecimal) to binary (or vice-versa).</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#calculator","title":"<code>!calculator</code>","text":"<p>Alias: <code>!calc</code></p> <p>Evaluates the given math expression and responds with the result.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-retroachievementsorg-infolinks","title":"Getting RetroAchievements.org info/links","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#ragame","title":"<code>!ragame</code>","text":"<p>Alias: <code>!game</code></p> <p>Google for a game at RetroAchievements.org and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#tickets","title":"<code>!tickets</code>","text":"<p>Return the URL for the open tickets page of the given game name.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#whatgame","title":"<code>!whatgame</code>","text":"<p>Alias: <code>!wg</code></p> <p>Responds with a random game that has achievements.</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#whatcheevo","title":"<code>!whatcheevo</code>","text":"<p>Responds with a random achievement.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#random-facts","title":"Random facts","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#funfact","title":"<code>!funfact</code>","text":"<p>Responds with a retrogaming fun fact.</p> <p>Note: you can suggest more fun fact entries here.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#memefact","title":"<code>!memefact</code>","text":"<p>Alias: <code>!meme</code></p> <p>Responds with a RetroAchievements meme fact.</p> <p>Note: you can suggest more meme fact entries here, but keep these 2 simple rules in mind 1) you can't suggest your own quote; and 2) when suggesting a quote, be sure to get an approval from the author and/or the person being mentioned.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-gaming-related-info","title":"Getting gaming related info","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#gamefaqs","title":"<code>!gamefaqs</code>","text":"<p>Aliases: <code>!gamefaq</code>, <code>!gfaq</code></p> <p>Google for a game at GameFAQs and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#longplay","title":"<code>!longplay</code>","text":"<p>Aliases: <code>!lplay</code>, <code>!lp</code></p> <p>Search for a longplay video on youtube and post the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#vgmaps","title":"<code>!vgmaps</code>","text":"<p>Alias: <code>!vgmap</code></p> <p>Searches vgmaps.com for a video game's map.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#howlongtobeat","title":"<code>!howlongtobeat</code>","text":"<p>Alias: <code>!hltb</code></p> <p>Google for a game at howlongtobeat.com and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#miscellaneous","title":"Miscellaneous","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#define","title":"<code>!define</code>","text":"<p>Aliases: <code>!dictionary</code>, <code>!dict</code></p> <p>Defines a word.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#translate","title":"<code>!translate</code>","text":"<p>Alias: <code>!tr</code></p> <p>Translates text to a specific language. Powered by https://translate.yandex.com/</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#urban","title":"<code>!urban</code>","text":"<p>Defines a word, but with Urban Dictionary.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#wikipedia","title":"<code>!wikipedia</code>","text":"<p>Alias: <code>!wp</code></p> <p>Searches Wikipedia for your query.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#youtube","title":"<code>!youtube</code>","text":"<p>Alias: <code>!yt</code></p> <p>Search for a video on youtube and post the first one found.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#bulbapedia","title":"<code>!bulbapedia</code>","text":"<p>Searches Bulbapedia for your query.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#movie","title":"<code>!movie</code>","text":"<p>Searches TMDB for your query, getting movie results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#manga","title":"<code>!manga</code>","text":"<p>Searches AniList for your query, getting manga results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#anime","title":"<code>!anime</code>","text":"<p>Searches AniList for your query, getting anime results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-01-16 03:48] meleu:</code> Akinator is :ded:</li> <li><code>[2019-11-17 22:11] meleu:</code> akinator command is ded</li> <li><code>[2019-02-16 13:12] meleu:</code> remove faq</li> <li><code>[2019-02-14 11:15] meleu:</code> typo</li> <li><code>[2019-01-17 22:36] meleu:</code> added some aliases</li> <li><code>[2019-01-17 11:11] meleu:</code> fixed caps in the page's title</li> </ul>"},{"location":"RALibretro/","title":"RALibretro","text":"<p>!! This page is wildly out-of-date</p> <p>RALibretro is a multi-emulator that can be used to develop RetroAchievements.</p> <p>The \"multi-emulation\" feature is only possible because it uses libretro cores to do the actual emulation. What RALibretro does is to connect the emulation to the tools used to create RetroAchievements.</p>"},{"location":"RALibretro/#warning","title":"WARNING","text":"<p>RALibretro is a Work-in-Progress!!!</p> <p>Currently the development is going on this repo: https://github.com/RetroAchievements/RALibretro</p> <p>Here's a list of known issues (feel free to report new issues if you find one): https://github.com/RetroAchievements/RALibretro/issues</p>"},{"location":"RALibretro/#installation-instructions","title":"Installation Instructions","text":"<p>Just download RALibretro from the Downloads page and unzip it.</p>"},{"location":"RALibretro/#basic-usage","title":"Basic Usage","text":"<ol> <li>Launch RALibretro.exe</li> <li>Click on <code>File</code> &gt; <code>Load System</code>, and click on the system you want to emulate</li> <li>Now go to <code>File</code> &gt; <code>Load Game</code> and choose your ROM. Note: RALibretro currently doesn't accept zipped files!</li> <li>Now you can create your cheevos or just earn some!</li> </ol>"},{"location":"RALibretro/#supported-systems","title":"Supported Systems","text":"<p>NOTE: some systems may require system (BIOS) files in the <code>System</code> directory in order to load games correctly.</p> <p>Here is a list of the systems supported currently:</p> <ul> <li>SNES</li> <li>NES</li> <li>Nintendo 64</li> <li>Mega Drive</li> <li>Master System</li> <li>Gameboy</li> <li>Gameboy Color</li> <li>Gameboy Advance</li> <li>PC Engine (TurboGrafx-16/TurboGrafx-CD)</li> <li>Atari Lynx</li> <li>Game Gear</li> <li>Neo Geo Pocket</li> <li>Atari 2600</li> <li>Atari 7800</li> <li>Virtual Boy</li> <li>Neo Geo (Arcade) - new. NOTE: you need to put the <code>neogeo.zip</code> BIOS file on the same directory as the ROMs.</li> <li>Capcom Play System 1, 2 and 3 (Arcade) - new</li> </ul>"},{"location":"RALibretro/#keyboard-input","title":"Keyboard Input","text":"Keyboard a s z x d c f v Enter Tab g h RetroPad Y X B A L R L2 R2 Start Select L3 R3 SNES Y X B A L R Start Select NES B A Swap disk side (FDS) Insert/Eject disk (FDS) Start Select Mega Drive A Y B C X Z Start Master System B A Start GameGear B A Start Gameboy [Color] B A Start Select Gameboy Advance B A L R Start Select PC Engine II I Run Select Atari Lynx B A Option 1 Option 2 Start Neo Geo Pocket B A Start Atari 2600 o L difficulty b R difficulty b L difficulty a R difficulty a Start Select Neo Geo C D A B Start Coin CPS1/2/3* * * * * * * Start Coin <p>Note: the buttons for CPS1/2/3 games vary for each game.</p>"},{"location":"RALibretro/#keyboard-shortcuts","title":"Keyboard Shortcuts","text":"<ul> <li>see overlay: <code>Esc</code></li> <li>pause emulation: <code>p</code></li> <li>advance one frame at a time: <code>;</code> (automatically pauses emulation)</li> <li>fast forward: <code>=</code></li> <li>fast forward toggle: <code>-</code> (minus signal)</li> <li>Screenshot: <code>PrintScreen</code></li> </ul>"},{"location":"RALibretro/#saveload-state-keys","title":"Save/Load state keys","text":"<ul> <li>Save state current slot: <code>Backspace</code></li> <li>Load state current slot: <code>F11</code></li> <li>Load state from slot 1, 2, .., 9, 0: <code>F1</code>, <code>F2</code>, ..., <code>F9</code>, <code>F10</code></li> <li>Save state to slot  1, 2, .., 9, 10: <code>shift</code>+<code>F1</code>, <code>shift</code>+<code>F2</code>, ..., <code>shift</code>+<code>F9</code>, <code>shift</code>+<code>F10</code></li> <li>Previous slot: <code>shift</code>+<code>-</code></li> <li>Next slot: <code>shift</code>+<code>+</code></li> <li>Switch slot: <code>0</code>, <code>1</code>, <code>2</code>,..., <code>9</code></li> </ul>"},{"location":"RALibretro/#missing-features","title":"Missing Features","text":"<ul> <li>feedback to the user when save/load state, pausing, etc.</li> <li>N64 support</li> <li>load zipped ROMs</li> <li>input configuration</li> <li>more issues listed here: https://github.com/RetroAchievements/RALibretro/issues</li> </ul>"},{"location":"RALibretro/#how-to-make-aes-bios-work-in-ralibretro-or-retroarch","title":"How to make AES BIOS work in RALibretro or RetroArch","text":"<p>To make AES BIOS emulation mode work in your emulator:</p> <ol> <li> <p>Make sure your emulator works correctly.</p> </li> <li> <p>Put <code>neogeo.zip</code> to <code>System</code> directory (RALibretro), or a folder you keep your NeoGeo ROMs (RetroArch).</p> </li> <li> <p>Make sure the <code>neogeo.zip</code> consist of at least files you can see here:</p> </li> </ol> <p></p> <p>If you keep only those files, AES mode will be automatically forced for any NeoGeo game (recommended).</p> <p>Important! The files which are highlighted on this picture (<code>neo-epo.bin</code> and <code>neo-po.bin</code>) are the only one actually related to AES mode, and you probably will need to include them in your archive to make AES mode work for you. <code>neo-po.bin</code> is necessary for japanese-only titles or to make the japanese versions to work, but due to emulation issue it also forces japanese language as default, that's why you will need to remove it to display english in some games.</p> <ol> <li>Load any FBA compatible neo geo ROM. More complete archive (including files needed to run MVS and UniBIOS modes) might need additional configuration to force AES mode:</li> </ol> <p>In RaLibretro: Settings-&gt;Emulation-&gt;Force Neo Geo Mode-&gt;AES</p> <p>In RetroArch: Command-&gt;Menu Toggle-&gt;Options-&gt;Force Neo Geo Mode-&gt;AES</p>"},{"location":"RATools/","title":"RATools","text":""},{"location":"RATools/#about-ratools","title":"About RATools","text":"<p>RATools is a standalone executable designed to assist developers of the retroachievements.org community. It's primary purpose is to provide a scripting language for achievement development.</p> <ul> <li>Releases</li> <li>Wiki</li> </ul>"},{"location":"RATools/#rascript","title":"RAScript","text":"<ul> <li>RAScript is a domain-specific language (DSL) that allows achievement developers for retroachievements.org the ability to design achievements using many of the modern conveniences provided by programming languages - such as variables, loops, and comments.</li> </ul>"},{"location":"RATools/#tutorials","title":"Tutorials","text":"<p>The user Etron writes an ongoing series of RATools tutorials, which appear in RANews each month.</p> <ul> <li>Getting Started: Introduction to using RATools</li> <li>Memory: Examples of variables and functions - Example Game: Sonic the Hedgehog</li> <li>Add Hits: Examples of counting with tally - Example Game: Streets of Rage 2 </li> <li>Bitflags: Examples of counting bit flags with For Loops - Example Game: Pok\u00e9mon Red | Blue</li> <li>Arithmetic Operations: Examples of using arithmetic functions to convert values from Binary-Coded Decimal (BCD) - Example Game: Pitfall!</li> <li>Pointers: Examples of pointer use and data structures - Example Game: Spider-Man</li> <li>If/else: Examples of using logic conditions to build an achievement - Example Game: Tetris DX</li> <li>Challenges Part 1: Examples of damageless, deathless, and weapon limited challenges - Example Game: Mega man</li> <li>Challenges Part 2: Examples of speedruns and other time challenges - Example Game: Super Mario World</li> <li>Triggers and Measure: Examples of using these flags together - Example Game: Street Fighter II: The World Warrior</li> <li>Strings: Examples of utilizing specific arrays - Example Game: Rez</li> <li>Rich Presence: Examples of writing dynamic Rich Presence scripts</li> <li>Leaderboards: Examples of various types of in-game leaderboards - Example Game: Doom</li> </ul>"},{"location":"RATools/#rascript-repositories","title":"RAScript Repositories","text":"<p>Many achievement developers' RAScripts are publicly available and are a great resource in becoming more familiar with it: - AlmightyXor - AuburnRDM - Bartis1989 - BenGhazi - Bilalscape12 - Bryan1150 - Etron - FRAN269 - gde - Guinea - Jamiras - lordpsycho - meleu - pinguupinguu - Searo - Sines - SlashTangent - Snow - soopercool101 - suXin - televandalist - theanxietybuster - tomojin - WCopeland - wolfman2000 - zxmega</p>"},{"location":"RATools/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-09 07:03] televandalist:</code> Updated RATools (markdown)</li> <li><code>[2023-06-05 22:55] televandalist:</code> Created RATools (markdown)</li> </ul>"},{"location":"Real-Examples-es/","title":"Intro","text":"<p>Uno de los mejores m\u00e9todos para aprender es ver ejemplos reales. En esta secci\u00f3n vamos a ver profundamente varios logros y vamos a desglosar la l\u00f3gica detr\u00e1s de cada uno de ellos.</p> <p>- Utilizar Hit Counts como un Temporizador   - Utilizando Valores Delta y Hit Counts para detectar un Incremento   - Simple Ejemplo de Como Evadir el Abuso de Estados de Guardado (Load State)   - Evitar el Problema de que un Contador Incremente Dos Veces en el mismo Frame   - Creando un Temporizador con Hits de un ResetIf en base a la velocidad de un Juego</p>"},{"location":"Real-Examples-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:37] meleu:</code> fix broken links</li> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Real-Examples-pt_BR/","title":"Exemplos Reais","text":"<p>Link para o texto em ingl\u00eas: Real Examples</p> <p>Um dos melhores recursos de aprendizagem est\u00e1 em analisar alguns exemplos reais. Nesta se\u00e7\u00e3o, analisaremos profundamente alguns achievements e quebraremos a l\u00f3gica por tr\u00e1s deles.</p> <p>- Usando Hit Counts e ResetIf   - Usando Delta Values e ResetIf   - Exemplo Simples de Como Evitar o abuso de Load State</p>"},{"location":"Real-Examples-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:04] KingDice001:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-25 11:47] KingDice001:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-23 22:16] meleu:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-23 01:20] meleu:</code> Updated Real Examples.pt_BR (markdown)</li> </ul>"},{"location":"Real-Examples/","title":"Real Examples","text":"<p>One of the best learning resource is looking at some real examples. In this section we will look deep into some achievements and break down the logic behind them. - Using Hit Counts as a Timer - Using Delta Values and Hit Counts to Detect an Increment - Circumvent the Problem of a Counter Incrementing Twice in the Same Frame - Creating a Timer with Reset If Hits based on the Speed of the Game - Using Add Source and Deltas for Collectibles and Similar Achievements</p>"},{"location":"Real-Examples/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-09-27 15:42] televandalist:</code> Updated Real Examples (markdown)</li> <li><code>[2022-02-07 09:42] televandalist:</code> Corrected typo (wil -&gt; will) - Removed link to the save state abuse example since it doesn't exist</li> <li><code>[2021-04-27 01:34] televandalist:</code> ToC fix</li> <li><code>[2021-01-10 08:33] televandalist:</code> Added link to Add Source/Delta example</li> <li><code>[2019-02-18 16:51] meleu:</code> fix broken links</li> <li><code>[2018-08-31 21:36] meleu:</code> Updated Real Examples (markdown)</li> <li><code>[2018-09-01 01:26] magusLOGS:</code> Updated Real Examples (markdown)</li> <li><code>[2018-01-29 10:20] meleu:</code> added links to the examples</li> <li><code>[2018-01-29 10:17] meleu:</code> this page is just a disclaimer, the real examples now have each one its own page</li> <li><code>[2017-12-11 10:23] meleu:</code> Updated Real Examples (markdown)</li> </ul>"},{"location":"Regional-Compatibility/","title":"Regional Compatibility","text":""},{"location":"Regional-Compatibility/#adding-regional-compatibility","title":"Adding Regional Compatibility","text":"<p>If you would like to add support for another region (e.g. adding support for a European ROM when the set was made with the USA ROM) to a set, please note the following: * For the majority of consoles, PAL-region games run at 50hz whereas NTSC runs at 60hz. Without a 60Hz patch, some achievements could be easier to obtain due to the decreased frame-rate. This is especially important for achievements that use frames-as-time in their logic and for leaderboards in general. * Some regions have different cheats. There are many cases where cheat codes were altered or removed upon localization. These should be accounted for.  * If there are enough differences between versions, an entirely separate set might be the best option. For more information on this, please see localization differences.</p>"},{"location":"Reporting-a-Broken-Achievement/","title":"Reporting Broken Achievements","text":"<p>To report a broken achievement, go to the achievement's page. Directly under the players won statistic, you'll see a link reading  \"Report an issue for this achievement.\" Click that link to take you to the \"Report Broken Achievement\" form</p>"},{"location":"Reporting-a-Broken-Achievement/#report-broken-achievement-form","title":"Report Broken Achievement Form","text":"<p>When reporting a broken achievement, please fill out all the fields to the best of your ability. The more information we have on the issue, the better our chances of figuring out what went wrong.</p>"},{"location":"Reporting-a-Broken-Achievement/#issue","title":"Issue","text":"<p>Select either \"Triggered at wrong time\" or \"Doesn't trigger.\" These are the only two valid reasons for submitting a ticket. If you have criticisms about an achievement, you can post those in the comments. Please Note: If you're submitting a manual unlock request for a network error, there's no need to file a ticket at all. Message RAdmin or post your request in the #Manual-Unlocks channel of our discord, specify that it was a network error and no actual problem with the achievement and we will take care of it for you.</p> <p>Triggered at wrong time: Select this option if an achievement popped at a time when it shouldn't have.</p> <p>Doesn't trigger: Select this option if you completed the requirements listed in the description but the achievement didn't trigger.</p>"},{"location":"Reporting-a-Broken-Achievement/#emulator","title":"Emulator","text":"<p>Select the emulator used in this drop-down menu. If using RetroArch or RALibRetro please also include information about the core used while playing. Checksum: Select your game's checksum here. \"But I don know dis.\" It's very simple. The checksum is like your game's signature. It's how the emulator determines what game and what version of the game you're using. When you have it, you should find it on this drop-down menu. This can be extremely important when looking into a problem so please always try to include this information.</p> <p>To find your Checksum in RetroArch: Go to the Quick Menu, and scroll down to \"Information.\" Under Information, you should see a line reading \"RetroAchievements Hash.\" That long list of numbers and letters you see is your Checksum. </p> <p>To find your Checksum in RALibRetro or other RA standalone emulators: Under the \"RetroAchievements\" menu, the very last item on the list is \"Get ROM Checksum.\" Simply click that and it will spit it out at you clear as day.</p>"},{"location":"Reporting-a-Broken-Achievement/#description","title":"Description","text":"<p>This is the most important field of all. Tell us what happened in as much detail as you possibly can. The less information provided here, the more difficult it is for us to figure out what went wrong. Even details that might seem insignificant to you could be very significant to us. The more you can tell us, the better our chances of being able to figure out why it happened. In other words, \"Dis no werk!\" isn't much help to us in figuring out what the problem was.</p>"},{"location":"ResetIf-Flag-es/","title":"Bandera ResetIf","text":"<p>Un <code>ResetIf</code> (ResetearSi) puede ser elegido en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Si la condicion asociada es verdad, todos los hit counts en el logro se van a resetear a 0. Esto incluye hit counts en otros grupos (mas sobre eso en Alt Groups (Grupos Alternos) mas abajo).</p> <p>El logro no se va a disparar si uno o mas condiciones <code>ResetIf</code> son verdaderas, incluse si no hay condiciones que necesitan hit counts (contadores de golpes).</p> <p>Puedes encontrar muchos ejemplos de <code>ResetIf</code> en la pagina de Ejemplos Reales.</p>"},{"location":"ResetIf-Flag-es/#resetif-con-hit-counts","title":"<code>ResetIf</code> con hit counts","text":"<p>Una condicion <code>Reset If</code> con un contador de golpes (hit count) solo se va a cumplir cuando el numero de hits necesarios se cumpla.</p> <p>Nota: Si otra condicion <code>ResetIf</code> se cumple, todas las condiciones, incluido el <code>ResetIf</code> con su hit count se van a reinisiar sus contadores de golpes (hit count) a 0.</p> <p>Es muy comun utilizar una condicion con un hit count de 1 como proceso para empezar a hacer un logro, y utilizar un <code>ResetIf</code> para cancel el logro antes de la condicion se cumpla. Un ejemplo comun es un logro sin recivir da\u00f1o: \"Desde el principio de el (nivel/combate), resetear si sea recivido da\u00f1o, que salte el logro al final de el (nivel/combate)\". Cuando la condicion para empezar el nivel es verdadera, un hit count es capturado. Si aun sigue capturado cuando la condicion del final es verdadera, el logro va a saltar. Si la condicion del <code>ResetIf</code> se dispara, el hit count en la condicion de empezar se va a regresar a zero, lo cual hace la condicion falsa cuando quiera evaluar si ya se cumplio la condicion final, y el logro no va a saltar.</p>"},{"location":"ResetIf-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:29] meleu:</code> fix broken links</li> <li><code>[2019-03-12 15:00] meleu:</code> Updated ResetIf Flag ES (markdown)</li> </ul>"},{"location":"ResetIf-Flag/","title":"ResetIf Flag","text":"<p>The <code>ResetIf</code> can be chosen in the Flag column of the Achievement Editor</p> <p>If the associated condition is true, all hit counts in the achievement will be reset to 0. This includes hit counts in other groups (more about it in Alt Groups below).</p> <p>The achievement will not trigger if one or more <code>ResetIf</code> conditions is true, even if there are no conditions with hit count targets.</p> <p>You can see many examples of <code>ResetIf</code> in the Real Examples page.</p>"},{"location":"ResetIf-Flag/#resetif-with-hit-counts","title":"<code>ResetIf</code> with hit counts","text":"<p>A <code>Reset If</code> condition with a hit count will only trigger when the hit count target is met.</p> <p>Note: If another <code>ResetIf</code> condition is met, all conditions, including the <code>ResetIf</code> with the hit count will have their hit counts reset to 0.</p> <p>It is very common to use a condition with a hit count of 1 as a start marker for an achievement, and use a <code>ResetIf</code> to cancel the achievement before the end condition is met. A common example is a damageless achievement: \"From start of (level/battle), reset if damage taken, trigger at end of (level/battle)\". When the start condition is true, a hit count is captured. If it's still set when the end condition is true, the achievement triggers. If the <code>ResetIf</code> condition triggers, the hit count on the start condition is set back to zero, which makes the condition false when evaluating the state when the end condition is true, and the achievement will not trigger.</p>"},{"location":"ResetIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-12 13:11] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:36] meleu:</code> Updated ResetIf (markdown)</li> </ul>"},{"location":"ResetNextIf-Flag/","title":"ResetNextIf Flag","text":"<p>The <code>ResetNextIf</code> Flag is a special version of the [[ResetIf Flag]] that only resets the hit count of the following condition.</p> <p><code>ResetNextIf</code> has the same priority as the condition that it's attached to. If followed by a <code>PauseIf</code>, it can be used to reset that specific <code>PauseIf</code> without needing an alt. If attached to a standard condition, it will not be processed if the achievement is paused.</p> <p><code>AddAddress</code>, <code>AddSource</code>, and <code>SubSource</code> are combining modifier conditions and are not considered as the following condition. The <code>ResetNextIf</code> will apply to the next non-modified condition.</p> <p><code>AndNext</code> and <code>OrNext</code> are combining logical conditions and will have their hit counts reset, as well as whatever condition follows them.</p> <p>All other condition flags, including <code>AddHits</code> and <code>SubHits</code>, will cause processing of the <code>ResetNextIf</code> behavior to stop.</p>"},{"location":"ResetNextIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-08-12 10:28] Jamiras:</code> Updated ResetNextIf Flag (markdown)</li> <li><code>[2021-04-30 12:21] Jamiras:</code> Created ResetNextIf Flag (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto-es/","title":"Manifiesto de RetroAchievements","text":"<p>Este es el Manifiesto de RetroAchievements del cual todo miembro de la comunidad deber\u00eda ser consciente</p> <p>Desde los primeros d\u00edas de RetroAchievements, esto es lo que tenemos en nuestro FAQ como la respuesta de \u00bfQue es RetroAchievements.org?</p> <p>RetroAchievements.org es una comunidad sin animo de lucros que colabora y compite para ganar logros personalizados en juegos cl\u00e1sicos a trav\u00e9s de la emulaci\u00f3n. Los logros son hechos por y para la comunidad. (...)</p> <p>En este manifiesto exploraremos esa respuesta de manera mas profunda.</p>"},{"location":"RetroAchievements-Manifesto-es/#retroachievements-es-una-comunidad-sin-animo-de-lucro","title":"RetroAchievements es una comunidad sin animo de lucro.","text":"<p>Tenemos un enlace de donaciones en la pagina principal pero aun seguimos siendo una una comunidad sin animo de lucro.</p> <p>Nuestros patrocinadores contribuyen con literalmente un dolar al mes, y afortunadamente tenemos suficiente para pagar el servidor sin necesitar anuncios molestos</p> <p>Sin embargo, queremos dejar bien claro que obtener donaciones no es nuestro modelo de negocios, exactamente debido a que \u00a1RetroAchievements no es un negocio!</p> <p>Organizaciones de negocios esperan ansiosamente la llegada de nuevos clientes. Siempre hacen todo lo posible por complacer a la clientela para seguir obteniendo mas y mas. Pero ac\u00e1, en RetroAchievements, no somos un negocio, Somos una comunidad.</p> <p>No tenemos clientes, tenemos miembros de la comunidad.</p> <p>Somos un grupo de personas apasionadas a los juegos retro. Y si compartes nuestra misma pasi\u00f3n, eres bienvenido a un\u00edrtenos.</p> <p>E incluso aunque recibamos a todos, no estamos rogando desesperadamente por la llegada de mas y mas usuarios. La decisi\u00f3n es tuya: Si te gusta lo que ofrecemos \u00a1Toma tu control y juguemos algunos cl\u00e1sicos!</p>"},{"location":"RetroAchievements-Manifesto-es/#los-logros-son-hechos-por-y-para-la-comunidad","title":"Los logros son hechos por y para la comunidad.","text":"<p>Esta relacionado con lo que dijimos mas arriba. No ofrecemos servicios a forasteros. Las cosas que creamos en esta comunidad son hechas para la misma. Eres bienvenido a permanecer con nosotros, pero va de tu parte decidir si quieres ser parte de ella.</p> <p>Mientras seas parte de esta comunidad, siempre ten en mente las siguientes declaraciones:</p> <p>1. Lo mas importante que tenemos son los logros.</p> <p>2. Las personas mas importantes que tenemos son los creadores de logros.</p> <p>\u00bfQue significa esto?</p>"},{"location":"RetroAchievements-Manifesto-es/#lo-mas-importante-que-tenemos-son-los-logros","title":"Lo mas importante que tenemos son los logros.","text":"<p>A todos nos encantan las medallas en nuestro perfil, \u00bfno? Tanto as\u00ed que causa frustraci\u00f3n cuando el set de respectiva medalla obtiene una revisi\u00f3n. Pero es importante tener en mente que este proyecto siempre esta evolucionando.</p> <p>Hacemos revisiones de sets de logros con la calidad en mente, y para demostrar que respetamos el juego. Tambi\u00e9n respetamos los premios que has obtenido, pero mejorar la calidad general del proyecto toma precedencia sobre perfiles individuales y/o la cantidad de puntos.</p> <p>Otra cosa, sino eres capaz de hacerle \"mastered\" a un set de logros, eso no autom\u00e1ticamente significa que el set necesita ser hecho mas f\u00e1cil/degradado/convertirse en bonus. Si otros jugadores lo han obtenido, es muy probable que tu tambi\u00e9n puedas. Pero incluso si no puedes, no pasa nada. No necesitas desbloquear todos los logros para divertirte con juegos antiguos</p> <p>Si aun as\u00ed piensas que alg\u00fan logro en el set tiene conceptos no bienvenidos, puedes hacer un post de tus argumentos en el foro del juego en cuesti\u00f3n. Simplemente aseg\u00farate de ser respetuoso. Lo que nos lleva al siguiente punto...</p>"},{"location":"RetroAchievements-Manifesto-es/#las-personas-mas-importantes-que-tenemos-son-los-creadores-de-logros","title":"Las personas mas importantes que tenemos son los creadores de logros.","text":"<p>\u00a1No se malentienda! En el ecosistema de RetroAchievements hay muchas personas cumpliendo una buena cantidad de roles diferentes a crear logros, y todos son importantes. Pero los creadores de logros son el pilar de este proyecto. Sin ellos, este seria solamente un sitio web jugando a ser anticuado con un manojo de \"bugs\".</p> <p>Crear logros es un proceso que toma mucho tiempo. Las personas que lo hacen dedican una muy buena parte de su tiempo libre para producir contenido beneficioso para toda la comunidad</p> <p>A todas estas, incluso si no eres capaz/estas interesado en crear logros y solamente quieres jugar, tambi\u00e9n eres importante para nosotros. De hecho tenemos una cantidad incontable de jugadores que son miembros invaluables</p> <p>Mientras mas involucrado est\u00e9s, mas valioso eres para la comunidad.</p> <p>Por ultimo pero no menos importante, si tienes criticas hacia el trabajo de un creador de logros, se respetuoso. Demostrar amargura hacia ellos esta muy mal visto. Ser irrespetuoso hacia ellos har\u00e1 que definitivamente no seas bienvenido aqu\u00ed.</p>"},{"location":"RetroAchievements-Manifesto-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-20 18:35] meleu:</code> estan -&gt; son</li> <li><code>[2020-09-16 12:36] meleu:</code> cambiando un poquito</li> <li><code>[2020-09-11 02:49] Pelouch:</code> Updated RetroAchievements Manifesto es (markdown)</li> <li><code>[2020-09-11 02:43] Pelouch:</code> Updated RetroAchievements Manifesto es (markdown)</li> <li><code>[2020-09-10 04:24] meleu:</code> Created RetroAchievements Manifesto es (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto-fr/","title":"RetroAchievements Manifesto fr","text":"<p>Ceci est le manifeste de Retroachievements. Chaque membre de cette communaut\u00e9 devrait en prendre connaissance.</p> <p>Depuis les premiers jours de RetroAchievements, la r\u00e9ponse \u00e0 la question de ce qu\u2019est Retroachievements.org se trouve dans notre FAQ.</p> <p>RetroAchievements.org est une communaut\u00e9 \u00e0 but non lucratif qui promeut le travail collaboratif et l\u2019esprit de comp\u00e9tition dans le but d\u2019obtenir des succ\u00e8s faits soi-m\u00eame via la sc\u00e8ne de l\u2019\u00e9mulation. Les succ\u00e8s sont cr\u00e9\u00e9s pour et par la communaut\u00e9. (\u2026)</p> <p>\u00c0 travers ce manifeste, nous allons r\u00e9pondre de mani\u00e8re plus pr\u00e9cise \u00e0 cette question.</p>"},{"location":"RetroAchievements-Manifesto-fr/#retroachievementsorg-est-une-communaute-a-but-non-lucratif","title":"RetroAchievements.org est une communaut\u00e9 \u00e0 but non lucratif.","text":"<p>Nous disposons d'un syst\u00e8me de donations sur la page principal du site, mais nous restons avant tout une communaut\u00e9 \u00e0 but non lucratif.</p> <p>Les m\u00e9c\u00e8nes participent \u00e0 hauteur d\u2019un seul et unique dollar par mois et heureusement, nous en avons suffisamment pour payer les serveurs sans avoir besoin de mettre en place un syst\u00e8me p\u00e9nible de publicit\u00e9s.</p> <p>Cependant, nous voulons \u00eatre clair sur un point. Recevoir des donations n\u2019est pas notre business model, justement car RetroAchievements n\u2019est pas un business !</p> <p>Une entreprise commerciale est toujours d\u00e9sireuse de capter toujours plus de clients. Elle fait le maximum pour les satisfaire pour en ramener toujours plus. Mais ici, chez RetroAchievements, nous ne sommes pas une entreprise, nous sommes une communaut\u00e9.</p> <p>Nous n\u2019avons pas de clients, nous sommes les membres d\u2019une communaut\u00e9.</p> <p>Nous sommes tout un tas de passionn\u00e9s de jeux vid\u00e9o r\u00e9tro. Et si vous partagez cette m\u00eame passion, alors vous \u00eates plus que le bienvenu pour nous rejoindre.</p> <p>Bien que nous accueillions quiconque le souhaite, nous ne courrons pas d\u00e9sesp\u00e9r\u00e9ment apr\u00e8s de nouveaux membres. C\u2019est \u00e0 votre demande : si vous aimez ce que nous avons \u00e0 offrir, attrapez votre manette et jouez \u00e0 des classiques !</p>"},{"location":"RetroAchievements-Manifesto-fr/#les-succes-sont-faits-par-et-pour-la-communaute","title":"Les succ\u00e8s sont faits par et pour la communaut\u00e9.","text":"<p>Tout ceci pour dire que nous ne sommes pas l\u00e0 pour offrir un service \u00e0 des tiers. Les choses que nous cr\u00e9ons au sein de cette communaut\u00e9 ne concernent que cette communaut\u00e9. Vous \u00eates le bienvenu, mais c\u2019est \u00e0 vous de d\u00e9cider d\u2019en faire partie.</p> <p>Et tant que nous parlons de communaut\u00e9, gardez \u00e0 l\u2019esprit ces quelques points :</p> <ol> <li> <p>La chose la plus importante ici sont les succ\u00e8s.</p> </li> <li> <p>Les personnes les plus importantes sont les cr\u00e9ateurs de succ\u00e8s.</p> </li> </ol> <p>Qu\u2019est-ce que cela signifie ?</p>"},{"location":"RetroAchievements-Manifesto-fr/#la-chose-la-plus-importante-ici-sont-les-succes","title":"La chose la plus importante ici sont les succ\u00e8s.","text":"<p>Nous adorons tous ces badges sur notre profil, non ? Un tel attachement peut engendrer parfois de la frustration lorsqu\u2019une modification est apport\u00e9e \u00e0 une s\u00e9rie de succ\u00e8s. Mais il est important de garder \u00e0 l\u2019esprit que ce projet est en constante \u00e9volution.</p> <p>Nous apportons des modifications aux s\u00e9ries de succ\u00e8s avec un objectif de qualit\u00e9 et pour faire preuve de respect envers le jeu. Nous respectons \u00e9galement les r\u00e9compenses que vous avez obtenues, mais am\u00e9liorer la qualit\u00e9 globale du projet prend le pas sur les profils individuels et ou le total de points de chacun.</p> <p>\u00c9galement, si vous ne ma\u00eetrisez pas une s\u00e9rie de succ\u00e8s, cela ne veut pas forc\u00e9ment dire que le niveau de difficult\u00e9 doit \u00eatre abaiss\u00e9 ou les succ\u00e8s retir\u00e9s ou bascul\u00e9s dans une s\u00e9rie bonus. Si d\u2019autres joueurs sont capables de les avoir, il est probable que vous le puissiez aussi. Mais si ce n\u2019est pas le cas, ce n\u2019est pas grave non plus. Il n\u2019est pas n\u00e9cessaire de d\u00e9bloquer tous les succ\u00e8s existants pour prendre du plaisir avec les jeux r\u00e9tro.</p> <p>Si vous pensez tout de m\u00eame qu\u2019un succ\u00e8s rel\u00e8ve d\u2019un concept qui n\u2019est pas le bienvenu, vous pouvez poster vos arguments sur le forum d\u00e9di\u00e9 \u00e0 ce jeu. Faites simplement preuve de respect dans votre formulation. Ce qui nous am\u00e8ne au prochain point\u2026</p>"},{"location":"RetroAchievements-Manifesto-fr/#les-personnes-les-plus-importantes-sont-les-createurs-de-succes","title":"Les personnes les plus importantes sont les cr\u00e9ateurs de succ\u00e8s.","text":"<p>Ne vous trompez pas ! L\u2019\u00e9cosyst\u00e8me Retroachievements dispose de beaucoup de gens, jouant chacun des r\u00f4les diff\u00e9rents du cr\u00e9ateur de succ\u00e8s, et ils sont tous aussi importants. Mais le cr\u00e9ateur de succ\u00e8s est l\u2019\u00e9pine dorsale du projet. Sans lui, il s\u2019agit juste d\u2019un site Internet archa\u00efque et plein de bugs.</p> <p>Cr\u00e9er des succ\u00e8s est une activit\u00e9 extr\u00eamement chronophage. Les personnes qui s\u2019en occupent, consacrent une part non n\u00e9gligeable de leur temps libre \u00e0 produire du contenu au b\u00e9n\u00e9fice de la communaut\u00e9 tout enti\u00e8re.</p> <p>Quoi qu\u2019il en soit, m\u00eame si vous n\u2019\u00eates pas capable/int\u00e9ress\u00e9 par la cr\u00e9ation de succ\u00e8s et souhaitez juste jouer, vous \u00eates tout aussi important \u00e0 nos yeux. En fait, de nombreux simples joueurs sont de pr\u00e9cieux membres de notre communaut\u00e9. Le point important ici \u00e9tant d\u2019\u00eatre impliqu\u00e9 et agr\u00e9able.</p> <p>Plus vous vous impliquerez, plus vous serez pr\u00e9cieux aux yeux de la communaut\u00e9.</p> <p>Enfin et surtout, si vous deviez \u00e9mettre des critiques \u00e0 l\u2019\u00e9gard du travail d\u2019un cr\u00e9ateur, faites-le dans le respect. \u00catre acerbe avec eux est tr\u00e8s mal vu. Manquez-leur de respect et vous ne serez d\u00e9finitivement plus le bienvenu.</p>"},{"location":"RetroAchievements-Manifesto-pl/","title":"RetroAchievements Manifesto pl","text":"<p>To jest Or\u0119dzie RetroAchievements, kt\u00f3re ka\u017cdy cz\u0142onek spo\u0142eczno\u015bci powinien zna\u0107</p> <p>Od pocz\u0105tku istnienia RetroAchievements to jest nasza odpowied\u017a z FAQ na temat Czym jest RetroAchievements.org?</p> <p>RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit, kt\u00f3ra wsp\u00f3\u0142pracuje i rywalizuje \u017ceby zyska\u0107 w\u0142asne osi\u0105gni\u0119cia do klasycznych gier poprzez emulacje, osi\u0105gni\u0119cia s\u0105 tworzone przez i dla spo\u0142eczno\u015bci. (...)</p> <p>W tym Or\u0119dziu zobaczymy w g\u0142\u0105b tej odpowiedzi</p>"},{"location":"RetroAchievements-Manifesto-pl/#retroachievementsorg-jest-spoecznoscia-non-profit","title":"RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit","text":"<p>Mamy link do dotacji na stronie g\u0142\u00f3wnej, lecz ci\u0105gle jeste\u015bmy spo\u0142eczno\u015bci\u0105 non-profit</p> <p>Patroni daj\u0105 dos\u0142ownie jednego dolara miesi\u0119cznie, a na szcz\u0119\u015bcie mamy wystarczaj\u0105co patron\u00f3w aby op\u0142aci\u0107 serwer bez polegania na irytuj\u0105cych reklamach</p> <p>Lecz, chcemy aby to by\u0142o oczywiste, \u017ce zdobywanie dotacji to nie nasz model biznesowy, poniewa\u017c RetroAchievements.org to nie jest biznes!</p> <p>Organizacje s\u0105 zawsze ch\u0119tne zyska\u0107 nowych klient\u00f3w. Robi\u0105 co chc\u0105 aby zadowoli\u0107 klienta, aby zyskiwa\u0107 ich wi\u0119cej i wi\u0119cej, lecz tu na RetroAchievements nie jeste\u015bmy organizacj\u0105, My jeste\u015bmy spo\u0142eczno\u015bci\u0105.</p> <p>My nie mamy klient\u00f3w, my mamy cz\u0142onk\u00f3w spo\u0142eczno\u015bci.</p> <p>Jeste\u015bmy grupk\u0105 ludzi z pasj\u0105 to gier retro. Je\u015bli masz tak\u0105 sam\u0105 pasj\u0119, ciep\u0142o cie przywitamy.</p> <p>Mimo i\u017c przyjmujemy wszystkich, nie b\u0142agamy desperacko o nowych u\u017cytkownik\u00f3w. To tw\u00f3j wyb\u00f3r, je\u017celi podoba ci si\u0119 oferta kt\u00f3r\u0105 mamy, chwy\u0107 za pada i zagrajmy w klasyki!</p>"},{"location":"RetroAchievements-Manifesto-pl/#osiagniecia-stworzone-sa-przez-i-dla-spoecznosci","title":"Osi\u0105gni\u0119cia stworzone s\u0105 przez i dla spo\u0142eczno\u015bci.","text":"<p>To jest powi\u0105zane z tym to by\u0142o podane powy\u017cej. Nie oferujemy us\u0142ugi dla os\u00f3b z zewn\u0105trz. Rzeczy kt\u00f3re tworzymy w tej spo\u0142eczno\u015bci nale\u017c\u0105 do tej samej spo\u0142eczno\u015bci. Mo\u017cesz z nami zosta\u0107, ale to tw\u00f3j wyb\u00f3r, czy chcesz by\u0107 jej cz\u0119\u015bci\u0105.</p> <p>Podczas bycia cz\u0119\u015bci\u0105 tej spo\u0142eczno\u015bci, pami\u0119taj poni\u017csze o\u015bwiadczenia:</p> <p>1. Najwa\u017cniejsz\u0105 rzecz\u0105 jak\u0105 tu mamy s\u0105 osi\u0105gni\u0119cia.</p> <p>2. Najwa\u017cniejszymi osobami s\u0105 tw\u00f3rcy osi\u0105gni\u0119\u0107.</p> <p>Co to znaczy?</p>"},{"location":"RetroAchievements-Manifesto-pl/#najwazniejsza-rzecza-jaka-tu-mamy-sa-osiagniecia","title":"Najwa\u017cniejsz\u0105 rzecz\u0105 jak\u0105 tu mamy s\u0105 osi\u0105gni\u0119cia.","text":"<p>Wszyscy kochamy te odznaki na naszej stronie profilowej, racja? Te przywi\u0105zanie do odznaki czasem powoduje irytacje kiedy szczeg\u00f3lny zestaw osi\u0105gni\u0119\u0107 przejdzie przez rewizje. Wa\u017cne jest pami\u0119ta\u0107 \u017ce ten projekt ci\u0105gle ewoluuje.</p> <p>Robimy Rewizje do zestaw\u00f3w osi\u0105gni\u0119\u0107 z my\u015bl\u0105 o jako\u015bci, i \u017ceby odda\u0107 szacunek grze. Szanujemy r\u00f3wnie\u017c nagrody kt\u00f3re posiadasz, lecz polepszanie jako\u015bci projektu jest wa\u017cniejsze od naszych stron profilowych lub liczby punkt\u00f3w.</p> <p>R\u00f3wnie\u017c, je\u015bli nie jeste\u015b zdolny opanowa\u0107 zestaw osi\u0105gni\u0119\u0107, to nie znaczy \u017ce automatycznie powinien by\u0107 u\u0142atwiony/zdj\u0119ty/przeniesiony do bonusowego zestawu. Je\u017celi innym graczom si\u0119 uda\u0142o, jest prawdopodobne \u017ce ci si\u0119 te\u017c mo\u017ce uda\u0107. Lecz je\u015bli nie mo\u017cesz, jest okej. Nie musisz odblokowa\u0107 ka\u017cdego osi\u0105gni\u0119cia aby mie\u0107 frajd\u0119 z starych gier.</p> <p>Je\u017celi ci\u0105gle my\u015blisz \u017ce zestaw osi\u0105gni\u0119\u0107 ma niechciany koncept, mo\u017cesz napisa\u0107 swoje argumenty w temacie gry na forum. Tylko pisz z szacunkiem, co prowadzi nas do kolejnego punktu...</p>"},{"location":"RetroAchievements-Manifesto-pl/#najwazniejszymi-osobami-sa-tworcy-osiagniec","title":"Najwa\u017cniejszymi osobami s\u0105 tw\u00f3rcy osi\u0105gni\u0119\u0107.","text":"<p>Nie przyjmij tego \u017ale! Ekosystem RetroAchievements ma wiele os\u00f3b, kt\u00f3rzy maj\u0105 inne role ni\u017c tw\u00f3rca osi\u0105gni\u0119\u0107 i s\u0105 oni wszyscy wa\u017cni. lecz tw\u00f3rcy osi\u0105gni\u0119\u0107 s\u0105 podstaw\u0105 tego projektu. Bez nich, to jest tylko stara i zbugowana strona.</p> <p>Tworzenie osi\u0105gni\u0119\u0107 to proces zajmuj\u0105cy mas\u0119 czasu. Osoby dedykuj\u0105 spor\u0105 cz\u0119\u015b\u0107 swojego wolnego czasu produkuj\u0105c zawarto\u015b\u0107 na korzy\u015b\u0107 ca\u0142ej spo\u0142eczno\u015bci</p> <p>Nawet je\u015bli nie jeste\u015b zdolny lub nie chcesz tworzy\u0107 osi\u0105gni\u0119\u0107, a chcesz tylko sobie pogra\u0107, jeste\u015b r\u00f3wnie\u017c wa\u017cny dla nas. Mamy wielu graczy kt\u00f3rzy s\u0105 warto\u015bciowymi cz\u0142onkami. Punktem kluczowym jest bycie mi\u0142ym i staranie si\u0119</p> <p>Tym bardziej si\u0119 przyk\u0142adasz, tym bardziej jeste\u015b warto\u015bciowy dla naszej spo\u0142eczno\u015bci.</p> <p>Na koniec, je\u015bli masz krytyk\u0119 na temat pracy tw\u00f3rcy osi\u0105gni\u0119\u0107, uszanuj ich. okazywanie rozgoryczenia jest nie mile widziane. Gdy b\u0119dziesz niemi\u0142y wobec nich, za d\u0142ugo tu nie zostaniesz</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/","title":"O Manifesto RetroAchievements","text":"<p>Este \u00e9 o Manifesto RetroAchievements e todo membro desta comunidade DEVE estar ciente disso.</p> <p>Desde os prim\u00f3rdios do RetroAchievements, isto \u00e9 o que temos no nosso FAQ como resposta para O que \u00e9 o RetroAchievements.org?</p> <p>RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos que colabora e compete para ganhar conquistas personalizadas em jogos cl\u00e1ssicos atrav\u00e9s de emula\u00e7\u00e3o. As conquistas s\u00e3o criadas pela e para a comunidade. (...)</p> <p>Neste manifesto n\u00f3s vamos nos aprofundar nessa resposta.</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#retroachievementsorg-e-uma-comunidade-sem-fins-lucrativos","title":"RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos","text":"<p>N\u00f3s temos um link de doa\u00e7\u00f5es na nossa p\u00e1gina principal, mas ainda assim n\u00f3s somos uma comunidade sem fins lucrativos.</p> <p>Os patronos contribuem com, literalmente, um d\u00f3lar (1 USD) por m\u00eas e, felizmente, n\u00f3s temos patronos suficiente para pagar o servidor sem que precisemos recorrer aos an\u00fancios irritantes.</p> <p>No entanto, queremos deixar bem claro que obter doa\u00e7\u00f5es n\u00e3o \u00e9 o nosso modelo de neg\u00f3cio pelo exato motivo de que RetroAchievements n\u00e3o \u00e9 um neg\u00f3cio!</p> <p>Organiza\u00e7\u00f5es de neg\u00f3cios est\u00e3o sempre ansiosas para obter mais e mais clientes. Elas fazem o que elas podem para agradar os clientes e continuar obtendo cada vez mais. Mas aqui, no RetroAchievements, n\u00f3s n\u00e3o somos um neg\u00f3cio, n\u00f3s somos uma comunidade.</p> <p>N\u00e3o temos clientes, n\u00f3s temos membros da comunidade.</p> <p>N\u00f3s somos um grupo de pessoas apaixonadas por retrogames. E se voc\u00ea compartilhar da mesma paix\u00e3o, voc\u00ea \u00e9 muito bem vindo a se juntar a n\u00f3s!</p> <p>Embora estejamos de portas abertas para receber bem qualquer um, n\u00f3s n\u00e3o estamos desesperadamente implorando por mais usu\u00e1rios. Cabe a voc\u00ea decidir: se voc\u00ea gosta do que n\u00f3s temos a oferecer, pegue o seu joystick e vamos jogar alguns cl\u00e1ssicos!</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#conquistas-sao-feitas-pela-e-para-a-comunidade","title":"Conquistas s\u00e3o feitas pela e para a comunidade","text":"<p>Isto est\u00e1 relacionada com o que foi dito acima. N\u00f3s n\u00e3o estamos oferecendo um servi\u00e7o para pessoas de fora. As coisas que criamos nesta comunidade s\u00e3o para esta mesma comunidade. Voc\u00ea \u00e9 bem-vindo a ficar com a gente, mas cabe a voc\u00ea decidir se quer ser parte disso.</p> <p>E enquanto fizer parte desta comunidade, tenha sempre em mente as seguintes afirma\u00e7\u00f5es:</p> <p>1. A coisa mais importante que n\u00f3s temos aqui s\u00e3o as conquistas.</p> <p>2. As pessoas mais importantes que n\u00f3s temos aqui s\u00e3o os criadores de conquistas.</p> <p>E o que isso significa? Abaixo, abordaremos de forma mais detalhada cada conceito e os motivos de serem t\u00e3o fundamentais:</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#a-coisa-mais-importante-que-nos-temos-aqui-sao-as-conquistas","title":"A coisa mais importante que n\u00f3s temos aqui s\u00e3o as conquistas","text":"<p>N\u00f3s todos amamos aquelas ins\u00edgnias na nossa p\u00e1gina do perfil, certo? Tal apego aquela ins\u00edgnia, \u00e0s vezes, causa frustra\u00e7\u00e3o quando a respectiva cole\u00e7\u00e3o de conquistas recebe uma revis\u00e3o, mas \u00e9 importante ter em mente que este projeto est\u00e1 constantemente evoluindo.</p> <p>N\u00f3s fazemos revis\u00f5es nas conquistas tendo em mente a qualidade e para mostrar verdadeiro respeito pelo jogo. Tamb\u00e9m respeitamos os trof\u00e9us que voc\u00ea obteve, mas melhorar a qualidade geral do projeto tem preced\u00eancia sobre nossas p\u00e1ginas de perfil e/ou quantidade de pontos.</p> <p>Al\u00e9m disso, se voc\u00ea n\u00e3o for capaz de obter todas as conquistas de um jogo, isso n\u00e3o significa automaticamente que elas precis\u00e3o ser suavizadas/removidas/se tornarem conquistas b\u00f4nus. Se outros jogadores obtiveram aquelas conquistas, \u00e9 prov\u00e1vel que voc\u00ea tamb\u00e9m consiga. Contudo, se voc\u00ea n\u00e3o consegue, est\u00e1 tudo bem tamb\u00e9m. Voc\u00ea n\u00e3o precisa desbloquear todas as conquistas para continuar se divertindo com jogos antigos.</p> <p>Se ainda assim voc\u00ea acha que a cole\u00e7\u00e3o de conquistas possui conceitos indesej\u00e1veis, voc\u00ea pode postar seus argumentos no f\u00f3rum no t\u00f3pico do jogo. Apenas certifique-se de ser respeitoso em suas palavras. O que nos leva ao pr\u00f3ximo ponto...</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#as-pessoas-mais-importantes-que-nos-temos-aqui-sao-os-criadores-de-conquistas","title":"As pessoas mais importantes que n\u00f3s temos aqui s\u00e3o os criadores de conquistas","text":"<p>N\u00e3o nos entenda mal! O ecossistema do RetroAchievements tem muitas pessoas executando muitos papeis diferentes de criar conquistas \u2014 e elas s\u00e3o todas importantes. Os criadores de conquistas s\u00e3o a espinha dorsal desse projeto. Sem eles, isso aqui \u00e9 apenas um site bugado e antiquado.</p> <p>Cria\u00e7\u00e3o de conquistas \u00e9 uma atividade que consome muito tempo. As pessoas que fazem isso dedicam uma grande parte do seu tempo livre produzindo conte\u00fado em prol de toda a comunidade.</p> <p>De qualquer forma, mesmo que voc\u00ea n\u00e3o consiga ou n\u00e3o esteja interessado em criar conquistas e queira apenas jogar, voc\u00ea tamb\u00e9m \u00e9 importante para n\u00f3s! Na verdade n\u00f3s temos in\u00fameros jogadores que s\u00e3o membros muito valiosos. O ponto-chave aqui \u00e9: envolva-se e seja legal.</p> <p>Quanto mais voc\u00ea se envolve, mais valioso voc\u00ea \u00e9 para a comunidade.</p> <p>Por \u00faltimo, mas n\u00e3o menos importante, se voc\u00ea tiver cr\u00edticas sobre o trabalho dos criadores de conquistas, seja respeitoso. Demonstrar hostilidade em rela\u00e7\u00e3o a eles \u00e9 fortemente desaprovado. Seja desrespeitoso com eles e voc\u00ea definitivamente n\u00e3o ser\u00e1 bem-vindo aqui.</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 08:14] meleu:</code> fix links</li> <li><code>[2020-09-16 12:32] meleu:</code> reverting small changes</li> <li><code>[2020-09-16 12:29] meleu:</code> Revert 4f2de8f85aecad218d3d7bb533c9b7eb343de796...c175774b3077e1d3bc3d0e794e126a8febb143ff on RetroAchievements Manifesto pt_BR</li> <li><code>[2020-09-10 04:12] Alexandre Gadelha:</code> Movido a se\u00e7\u00e3o 3 como item 4 da se\u00e7\u00e3o 2.</li> <li><code>[2020-09-10 04:05] Alexandre Gadelha:</code> Pequena edi\u00e7\u00e3o final</li> <li><code>[2020-09-10 04:04] Alexandre Gadelha:</code> Adi\u00e7\u00e3o do item 3 na se\u00e7\u00e3o 2 (Conquistas s\u00e3o feitas pela e para a comunidade). Adi\u00e7\u00e3o da se\u00e7\u00e3o 3. Melhorias quanto a ortografia.</li> <li><code>[2020-09-10 02:55] Alexandre Gadelha:</code> Pequenas edi\u00e7\u00f5es</li> <li><code>[2020-09-10 02:43] Alexandre Gadelha:</code> Arrumado os erros de ortografia e erros de digita\u00e7\u00e3o</li> <li><code>[2020-09-10 01:47] meleu:</code> Updated The RetroAchievements Manifesto pt_BR (markdown)</li> <li><code>[2020-09-10 01:47] meleu:</code> Destroyed RetroAchievements Manifesto pt_BR (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto/","title":"RetroAchievements Manifesto","text":"<p>This is the RetroAchievements Manifesto and every member of this community should be aware of this.</p> <p>Since the early days of RetroAchievements, this is what we have in our FAQ as the answer for What is RetroAchievements.org?</p> <p>RetroAchievements.org is a zero profit community who collaborate and compete to earn custom-made achievements in classic games through emulation. Achievements are made by and for the community. (...)</p> <p>In this manifesto we're going to go deeper into that answer.</p>"},{"location":"RetroAchievements-Manifesto/#retroachievementsorg-is-a-zero-profit-community","title":"RetroAchievements.org is a zero profit community","text":"<p>We do have a donation link on our frontpage, but we're still a zero profit community.</p> <p>The patrons contribute with literally one dollar per month, and fortunately we have enough patrons to pay for server expenses without needing to rely on annoying adverts.</p> <p>However, we want to make very clear that getting donations is not our business model, exactly because RetroAchievements is not a business!</p> <p>Business organizations are always eager to get more customers. They do what they can to please the customers and keep getting more and more of them. But here, at RetroAchievements, we are not a business, we are a community.</p> <p>We don't have customers, we have community members.</p> <p>We are a bunch of people passionate about retrogames. And if you share the same passion, you're very welcome to join us.</p> <p>Although we're welcoming anyone, we're not desperately begging for more and more users. It's your call: if you like what we have to offer, pick your gamepad and let's play some classics!</p>"},{"location":"RetroAchievements-Manifesto/#achievements-are-made-by-and-for-the-community","title":"Achievements are made by and for the community.","text":"<p>It's related to what was said above. We are not offering a service for outsiders. The things we create in this community are for this very same community. You're welcome to stay with us, but it's up to you to decide if you want to be part of it.</p> <p>And while being part of this community, always keep in mind the following statements:</p> <p>1. The most important thing we have here are the achievements.</p> <p>2. The most important people we have here are the achievement creators.</p> <p>What does that mean?</p>"},{"location":"RetroAchievements-Manifesto/#the-most-important-thing-we-have-here-are-the-achievements","title":"The most important thing we have here are the achievements.","text":"<p>We all love those badges on our profile page, right? Such attachment to that badge sometimes causes frustration when the respective achievement set get a revision. But it's important to keep in mind that this project is constantly evolving.</p> <p>We make achievement set revisions with quality in mind, and to show actual respect for the game. We also have respect for the awards you got, but improving the overall quality of the project has precedence over our individual profile pages and/or our amount of points.</p> <p>Also, if you're not able to master an achievement set it doesn't automatically mean that it needs to be nerfed/demoted/turned into a bonus set. If other players got that, it's probable you can get that too. But if you can't, it's OK too. You don't need to unlock every achievement to keep having fun with old games.</p> <p>If you still think the achievement set has unwelcome concepts, you can post your arguments in the game's forum topic. Just be sure to be respectful in your words. Which brings us to the next point...</p>"},{"location":"RetroAchievements-Manifesto/#the-most-important-people-we-have-here-are-the-achievement-creators","title":"The most important people we have here are the achievement creators.","text":"<p>Don't get it wrong! The RetroAchievements ecosystem has a lot of people, playing many different roles than creating achievements, and they are all important. But the achievement creators are the backbone of this project. Without them, this is just a buggy and old fashioned website.</p> <p>Achievement creation is a very time consuming activity. The people doing it dedicate a big portion of their free time producing content for the benefit of the whole community.</p> <p>Anyways, even if you're not able to/interested in creating achievements and just want to play, you're also important to us. In fact we have countless players that are very valuable members. The key point here is: get involved and be nice.</p> <p>The more you get involved, the more valuable you are to the community.</p> <p>Last but not least, if you have criticism about achievement creators' work, be respectful. Showing bitterness towards them is strongly frowned upon. Be disrespectful with them and you're definitely not welcome here.</p>"},{"location":"RetroAchievements-Manifesto/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-19 23:45] televandalist:</code> Slight grammar fix about server expenses.</li> <li><code>[2020-09-17 14:44] meleu:</code> the you are valuable -&gt; the more valuable you are</li> <li><code>[2020-09-08 07:45] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 19:39] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 09:10] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 08:48] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 08:45] meleu:</code> Created RetroAchievements Manifesto (markdown)</li> </ul>"},{"location":"Rich-Presence-es/","title":"Rich Presence","text":""},{"location":"Rich-Presence-es/#introduccion","title":"Introducci\u00f3n","text":"<p>Rich Presence (RP) es un breve resumen de lo que est\u00e1n haciendo los jugadores activos en su partida. Para tener RP en un juego necesitas un Script de Rich Presence (RPS) que este es creador por desarrolladores. El Script checa la memoria del juego y ya sea como esta fue programada reporta los valores de ciertas direcciones con definiciones asignadas por el desarrollador as\u00ed como en que stage se encuentra el jugador, cuantas vidas tienes, si el juego esta en pausa, que modo de juego se encuentra jugando, lo que a logrado el jugador, etc. Esta informacion es reportada de vuelta al sitio. Cada juego publicado deber\u00eda de tener m\u00ednimo un RPS b\u00e1sico.</p> <p>Ejemplo de RP en acci\u00f3n:</p> <p> </p> <p>Para ver la RP en tiempo real haz clic en el menu de RetroAchievements en tu emulador y despu\u00e9s en Rich Presence Monitor. Una peque\u00f1a ventana deber\u00eda de mostrar tu RP actual. (Bueno para realizar pruebas)</p> <p></p> <p>La mejor manera de entender Rich Presence es observar varios ejemplos de juegos, mira las direcciones que fueron utilizadas a mira como el texto es mostrado en el monitor y en el sitio.</p>"},{"location":"Rich-Presence-es/#como-funciona","title":"Como funciona?","text":"<p>Cada vez que un juego es lanzado, guarda los logros del juego en un archivo de 'ruta' donde el ROM detalla todos los logros y valores en memoria (y tablas clasificatorias) que puede llegar a rastrear. Tambi\u00e9n va a solicitar un Script de  Rich Presence para el ROM que se encuentre actualmente cargado. El emulador va a reportar al sitio web cada 120 segundos. Similarmente, cada 120 segundos o parecido, la caja de 'active players' en la pagina de inicio se va a refrescar, detallando la ultima actividad conocida por todos los jugadores activos. Si no hay un Script de rich presence entregado, el texto sera 'earning achievements' Si se esta jugando un juego con logros, 'playing [game]' si se juega un juego sin logros, o 'developing achievements' si la ventaba de memoria esta abierta y es visible. </p> <p>El RPS de cada juego puede ser encontrado en la secci\u00f3n de desarrollo en cada pagina de juego: </p> <p></p> <p></p>"},{"location":"Rich-Presence-es/#ejemplo-super-mario-bros","title":"Ejemplo (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>El RSP se compone de objetos de Lookup, objectos de Formato y un objeto de Display. </p>"},{"location":"Rich-Presence-es/#lookups","title":"Lookups","text":"<p>Los Lookups se definen de la siguiente manera: </p> <pre><code>Lookup:NombreDelLockup\nValor1=Texto cuando este valor este activo\nValor2=Texto cuando este otro valor\n...\n</code></pre> <p>Le damos un valor al Lookup, consistiendo de una serie de direcciones de memoria y modificador. Encontraras mas sobre esto mas adelante. </p>"},{"location":"Rich-Presence-es/#formato","title":"Formato","text":"<p>Las Tablas de Formato se definen de la siguiente manera:</p> <pre><code>Format:Score\nFormatType=VALOR\n</code></pre> <p>Empezamos con <code>Formato:</code>, y despu\u00e9s con el nombre del tipo de formato. En la siguiente linea, escribe <code>FormatType=</code>, y entonces uno de los siguientes valores: <code>VALUE</code>, <code>SCORE</code> (o <code>POINTS</code>), <code>TIME</code> (o <code>FRAMES</code>), <code>SECS</code>, <code>MILLISECS</code>, o <code>OTHER</code>. </p> <ul> <li><code>VALUE</code>: valor gen\u00e9rico, no se agregan ceros. </li> <li><code>SCORE</code>/<code>POINTS</code>: \"000130 puntos\" </li> <li><code>TIME</code>/<code>FRAMES</code>: este valor describe el numero de frames consecuentes, y se va a mostrar como 00:00.00 </li> <li><code>SECS</code>: este valor describe el numero de segundos que han pasado, y se va a mostrar como 00:00 </li> <li><code>MILLISECS</code>: este valor describe el numero de centenas de segundo que han pasado, y se va a mostrar como 00:00.00 </li> </ul>"},{"location":"Rich-Presence-es/#display","title":"Display","text":"<p>Display es la string que se muestra en la caja de 'Active Players' en la pagina de inicio del sitio web. Para referirte a un Lookup o aun Format previamente definidos se utiliza simplemente un '@'. Y entonces se agrega el nombre que le diste al lookup o al format (distingue may\u00fasculas y min\u00fasculas!), e inmediatamente despu\u00e9s de eso, en brackets, sigue la serie de valores en memoria que especifican que sera enviado a ese lookup y format.</p> <p><code>@Powerup(0xh756)</code> </p> <p>Eso significa que vas a utilizar el Lookup o Format que se llama <code>Powerup</code>, y entrega cualquier valor que se encuentre actualmente en 0xh756. </p>"},{"location":"Rich-Presence-es/#analizando-el-lookup-de-ejemplo","title":"Analizando el Lookup de Ejemplo","text":"<ul> <li><code>@Mode(0xh770)</code> - Un Lookup para la direcci\u00f3n que muestra si el juego se encuentra en modo demo o si un mundo a sido completado.  </li> <li><code>@Paused(0xh776)</code> - Un Lookup para la direcci\u00f3n que muestra si el juego se encuentra en pausa (Se utilizan 3 valores, dos de ellos son para pausar y despausar).  </li> <li><code>@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Un Lookup para la direcci\u00f3n que muestra si Mario tiene la Estrella. Mas sobre esto mas adelante.  </li> <li><code>@Powerup(0xh756)</code> - Un Lookup para la direcci\u00f3n que muestra si Mario es Peque\u00f1o, grande o cuenta con la habilidad de fuego.  </li> <li><code>Mario in</code> - Texto est\u00e1tico para unir los objetos format y lookup.  </li> <li><code>@Digit(0xh75f_v1)</code> - <code>Digit</code> es un objeto format definido como un valor. La direcci\u00f3n 0xh75f es Mundo menos 1 (porque cuenta con base 0, y este empieza a contar desde cero). <code>_v1</code> Significa + valor 1. <code>_v+1</code> tambi\u00e9n es correcto.  </li> <li><code>-</code> - Mas texto est\u00e1tico para separar el mundo y el nivel. como en el juego Mundo 1-1.  </li> <li><code>@Digit(0xh75c_v1)</code> - Otro uso del objeto <code>Digit</code> format . Esta vez se encuentra rastreando el Stage. Mundo 1-X.  </li> <li><code>@Swimming(0xh704)</code> - Un Lookup para la direcci\u00f3n que muestra si el jugador se encuentra nadando.  </li> <li><code>@Status(0xhe)</code> - Un Lookup para la direcci\u00f3n que muestra el estatus de Mario, como por ejemplo descendiendo de un tubo.  </li> <li><code>, \ud83d\udeb6:</code> - Mas texto est\u00e1tico. \ud83d\udeb6 es el s\u00edmbolo para vidas.  </li> <li><code>@Digit(0xh75a_v1)</code> - Tercer uso del objeto <code>Digit</code> format. Esta vez checa la direcci\u00f3n de vidas del jugador.  </li> <li><code>,</code> - Texto est\u00e1tico.  </li> <li><code>@Quest(0xh7fc)</code> Un lookup para ver si el jugador se encuentra en modo normal o en la 2da vuelta (modo dificil).  </li> <li><code>Quest</code> - Texto est\u00e1tico.  </li> </ul>"},{"location":"Rich-Presence-es/#tamano-de-direcciones","title":"Tama\u00f1o de Direcciones","text":"<p>Para especificar el tama\u00f1o de la direcci\u00f3n que te encuentras utilizando, hay varios caracteres que se utilizan para esto. (se ignora si es may\u00fascula o min\u00fascula)</p> <ul> <li>Una direcci\u00f3n de 16bit es el default y esta no cuenta con un car\u00e1cter designado. En 0x10 la direcci\u00f3n es de dos bytes - 16 bits.</li> <li>El car\u00e1cter para una direcci\u00f3n de 8bit es <code>h</code> (o <code>H</code>). En 0xh10 la direcci\u00f3n es un byte - 8 bits. <code>xxxx xxxx</code> </li> <li>El car\u00e1cter para una direcci\u00f3n upper4 es <code>u</code> (o <code>U</code>). En 0xu10 la direcci\u00f3n es un nibble - 4 bits. <code>xxxx 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n lower4 es <code>l</code> (o <code>L</code>). En 0xl10 la direcci\u00f3n es un nibble - 4 bits. <code>0000 xxxx</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit0 es <code>m</code> (o <code>M</code>). En 0xm10 la direcci\u00f3n es un bit, el bit mas bajo: <code>0000 000x</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit1 es <code>n</code> (o <code>N</code>). En 0xn10 la direcci\u00f3n es un bit, el segundo bit: <code>0000 00x0</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit2 es <code>o</code> (o <code>O</code>). En 0xo10 la direcci\u00f3n es un bit, el tercer bit: <code>0000 0x00</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit3 es <code>p</code> (o <code>P</code>). En 0xp10 la direcci\u00f3n es un bit, el cuarto bit: <code>0000 x000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit4 es <code>q</code> (o <code>Q</code>). En 0xq10 la direcci\u00f3n es un bit, el quinto bit: <code>000x 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit5 es <code>r</code> (o <code>R</code>). En 0xr10 la direcci\u00f3n es un bit, el sexto bit: <code>00x0 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit6 es <code>s</code> (o <code>S</code>). En 0xs10 la direcci\u00f3n es un bit, el s\u00e9ptimo bit: <code>0x00 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit7 es <code>t</code> (o <code>T</code>). En 0xt10 la direcci\u00f3n es un bit, el bit mas alto: <code>x000 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n de 32bit es <code>x</code> (o <code>X</code>). En 0xx10 la direcci\u00f3n es de cuatro bytes y 32 bits.</li> </ul> <p>Resumiendolo en una tabla:</p> localizaci\u00f3n/tama\u00f1o prefijo (las letras pueden ser en min\u00fasculas) ejemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Rich-Presence-es/#display-con-strings-condicionales","title":"Display con Strings Condicionales","text":"<pre><code>Display:\n?0x 000085=0?Pantalla de Titulo\n?0xT00007c=1?Mapa Personalizado en @Zona(0xH00016c)\nJugando Batalla @Batalla(0x 00007c*0.2) en @Zona(0xH00016c)\n</code></pre> <p>El marcador <code>Display:</code> se sigue utilizando para indicar el principio del bloque de Display. Si la siguiente linea empieza con un signo de interrogaci\u00f3n, se considera como un display con una string condicional. La parte de la linea que se encuentra entre los dos signos de interrogaci\u00f3n es la clausula de la condici\u00f3n. Si la clausula de la condici\u00f3n se eval\u00faa y esta es verdadera, entonces la siguiente parte de la linea se utiliza como el string del display. Si esta no se eval\u00faa como verdadera, entonces se procede a la siguiente linea. Si esta empieza con un signo de interrogaci\u00f3n, entonces el mismo proceso se repite. Si este no empieza con un signo de interrogaci\u00f3n, la linea entera se utiliza como el string default para el display.</p> <p>NOTA: Se requiere una string default en caso de que ninguna de tus strings condicionales sean verdaderas. Si solamente cuentas con strings condicionales, el script no va a hacer nada.</p> <p>Observando este ejemplo, si el valor de 16-bit en $0085 es igual a 0, el string del display sera <code>Title Screen</code>. Si no, la siguiente linea es examinada. Si el 7mo bit de $007C es igual a 1, el string del display sera <code>Mapa Personalizado en @Zona(0xH00016c)</code>. Si no entonces, como linea final no cuenta con una clausula condicional esta es utilizada.</p> <p>Strings de Display asociados con una clausula condicional soportan todo la misma sintaxis que el string de display predeterminado. En este ejemplo, puedes ver que el lookup <code>@Zona</code> se utiliza en los dos strings condicionales y en el string predeterminado. </p> <p>La frase condicional soporta todos los asesores de direcciones previamente mencionados as\u00ed como la l\u00f3gica de los AND (_) y OR (S). Nota: las clausulas OR aun requieren un grupo 'core', as\u00ed como en los logros.</p> <ul> <li><code>?0xH1234=32_0xH2345=0?ejemplo y</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $2345 is 0, muestra <code>ejemplo y</code></p> </li> </ul> <ul> <li><code>?0xH1234=32S0xH2345=1S0xH2345=2?ejemplo o</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $2345 es 1 o 2, muestra <code>ejemplo o</code></p> </li> </ul> <ul> <li><code>?0xH1234=32_0xH5678=33S0xH2345=1S0xH2345=2?ejemplo y/o</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $5678 es 33 y el valor de 8-bit en $2345 es 1 o 2, muestra <code>ejemplo y/o</code></p> </li> </ul>"},{"location":"Rich-Presence-es/#codigo-binario-programado-en-decimal-bcd","title":"C\u00f3digo Binario programado en Decimal (BCD)","text":"<p>BCD es cuando cuando los valores son almacenados en una direcci\u00f3n del 0-9 (un d\u00edgito) o 0-99 (dos d\u00edgitos). ten en mente que la mayor\u00eda de las veces los valores son almacenados en hexadecimal, pero algunas veces los juegos los almacenan de esta manera y aqu\u00ed esta el mejor m\u00e9todo para trabajar con este tipo de valores en tu display.</p> <p>BCD decodifica cada car\u00e1cter hexadecimal como un d\u00edgito decimal. Si el inspector de memoria muestra un 86 (en hex), el resulta de BCD decodificando el valor seria un 86 (en decimal).</p> <p>Para objectos con estos valores puedes utilizar le prefijo BCD, como aqu\u00ed <code>b0xh1234</code>. Esto tambi\u00e9n funciona con valores en tablas de clasificaci\u00f3n. Ten en cuenta que tambi\u00e9n vas a necesitar especificar el tama\u00f1o de la direcci\u00f3n BCD en memoria. <code>b0x1234</code> lee un valor de  16-bit. <code>b0xh1234</code> lee un valor de 8-bit y <code>b0xX1234</code> lee un valor de 32-bit. NOTA: Soporte para decodificacion BCD de 16-bit y 32-bit es una funci\u00f3n para el kit de desarrollo 0.075.</p> <p>Esto es usualmente usado para puntuaciones y tiempo, pero algunas veces tambi\u00e9n para otros tipos de valores.</p>"},{"location":"Rich-Presence-es/#limites","title":"Limites","text":"<ul> <li>Limite de 16,000 caracteres por script  </li> <li>Limite de 100 caracteres para lo que se esta mostrando</li> <li>Caracteres Unicode son permitidos</li> </ul>"},{"location":"Rich-Presence-es/#detalles-de-la-sintaxis","title":"Detalles de la Sintaxis","text":"<ul> <li>Las llaves para Lookups son en decimal por default y hex si agregas el prefijo <code>0x</code>. Esto significa <code>1</code> == <code>0x1</code>, <code>2</code> == <code>0x2</code>, <code>9</code> == <code>0x9</code>, <code>10</code> == <code>0xa</code>, <code>100</code> == <code>0x64</code>, etc.  </li> <li>Los nombres para Lookup/Format son sensibles entre may\u00fasculas y min\u00fasculas por lo que necesitas escribir exactamente igual el nombre para que se muestre correctamente en el string del display: <code>@test(0x1234)</code> el cual no va a encontrar \"Format:Test\"</li> <li>Un Lookup/Format no pueden contener espacios antes o despu\u00e9s del nombre. <code>@test(0x1234)</code> no va a encontrar \"Format:test   \" o \"Format:   test\"</li> <li>Si tu Lookup/Format no puede ser encontrado, no se va a mostrar nada. <code>Esta es una prueba @test(0x1234).</code> va a salir como <code>Esto es una .</code> si <code>test</code> no puede ser encontrado.</li> <li>Se pueden agregar comentarios en cualquier parte del script. Una doble diagonal (<code>//</code>) indica que la parte restante de la linea va a ser ignorada cuando se procese el script. Nota: los comentarios tambi\u00e9n aplican para el tama\u00f1o m\u00e1ximo de caracteres del script.</li> </ul>"},{"location":"Rich-Presence-es/#tips-y-trucos","title":"Tips y Trucos","text":"<ul> <li>Los nombres de los Lookup pueden ser tan cortos como un solo car\u00e1cter si necesitas ahorrarte algunos caracteres extras.</li> <li>Zeros subsecuentes pueden ser eliminados de las direcciones (<code>0xh0001</code> puede ser acortado a <code>0xh1</code>).</li> <li>Convertir todos tus valores de hex a decimal va tomar muchos menos caracteres.</li> <li>Caracteres Unicode no siempre \"toman menos espacio\" ellos usualmente toman hasta cuatro caracteres del sistema.</li> <li>Si un lookup no contiene ning\u00fan valor mapeados, va a resultar en un valor (sin espacio) en blanco. Puedes cambiar este comportamiento agregando una sola linea a los valores del lookup, '*' a el valor que deseas.</li> <li>Cada <code>Lookup</code> o <code>Format</code> puede ser cargado m\u00faltiples veces con las mismas o diferentes direcciones. Puedes definir un solo <code>Format:Number FormatType=VALUE</code> en vez de definir valores individuales para las vidas, Puntuaci\u00f3n, Nivel, etc.</li> <li>Poner espacios a tus lookups algunas veces antes o despues puede ayudarte a esconder ciertos lookups cuando estos no son requeridos, como lo hacen <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code>, y @Mode . </li> </ul>"},{"location":"Rich-Presence-es/#propiedades-de-los-valores","title":"Propiedades de los Valores","text":"<p>Cuando utilizamos objetos lookup y format <code>@object()</code> es posible combinar y hacer c\u00e1lculos. Esto puede ser utilizado para mostrar una puntuaci\u00f3n correctamente, tiempo del juego, etc. o hacen lookups avanzados.</p> <p>Ejemplo <code>@Puntuaci\u00f3n(0x28*10_0x29*1000_0x26*100000) puntos</code> </p> <p>Esto significa utiliza el lookup o Format <code>Puntuaci\u00f3n</code>, y entrega la suma de: - 0x28 10 veces, AGREGA - 0x29 1000 veces, AGREGA - 0x26 100000 veces</p> <ul> <li><code>_</code> agregas las direcciones mutuamente.  </li> <li>O tambi\u00e9n puedes agregar un valor est\u00e1tico <code>0x28_v10</code>. Esto agrega un 10 a tu total, as\u00ed como el valor de <code>0x28</code> + 10 puede ser mostrado. Tambi\u00e9n se puede hacer lo mismo pero restando <code>0x28_v-10.</code> </li> <li>Si lo que quieres es restar una direcci\u00f3n necesitas multiplicar el valor por -1. <code>0x29*-1</code>. <code>0x29</code> es ahora negativo.  </li> <li>Si lo que quieres es hacer una divisi\u00f3n lo que necesitas es multiplicar por un numero quebrado. <code>0x26*.5</code>. <code>0x26</code> va a mostrar el valor 1/2 de <code>0x26</code>.  </li> <li>Y as\u00ed puedes crear un string con todo junto: <code>0x28*10_0x29*-1_0x26*.625_v-10</code>.</li> <li>Tambi\u00e9n puedes agregar direcciones entre si para agregar a tus lookups de acuerdo a la suma de varias direcciones. Esto es utilizado en el ejemplo de @Star. Esta buscando la suma de los 6 bits mas bajos de la direcci\u00f3n 0xh79f. La manera en la que esta direcci\u00f3n trabaja es que mientras se encuentre un valor hay significa que Mario es invisible porque agarro una estrella y cuenta el valor hex en 0x23 (35 en decimal) a 0. 23 en binario es 0010 0011 significando que la suma m\u00e1xima de estos bits seria 5 durante 0001 1111 cuando el contador llega al valor hex de 0x1f (31 en decimal).</li> </ul>"},{"location":"Rich-Presence-es/#simbolos-estandar-unicode","title":"S\u00edmbolos Est\u00e1ndar Unicode","text":"<p>Sin ninguna duda puedes utilizar estos s\u00edmbolos en rich presence.</p> <p>\u258c\u258c=Pausa \ud83d\udd01=Continues \u23f0=Tiempo de la Partida/Reloj del Juego \ud83d\udd11=Llaves \ud83d\udca3=Bombas \u2764\ufe0f o \u2764=En un juego con corazones (ej. Zelda)  \ud83d\udcb0=Dinero \ud83d\udea9=Nivel/Stage   </p> <p>Cuando te encuentres desarrollando Rich Presence tienes que hacegurarte que te estas comunicando de una manera completamente clara. Si no estas utilizando s\u00edmbolos estandarizados tal vez tengan sentido para ti pero tal vez sea completamente confusos para otros. Cuando utilices s\u00edmbolos no estandarizados, checalo con otro usuario o con alguna otra gente para ver si los s\u00edmbolos que estas utilizando tienen sentido. Si no lo tienen, utiliza mejores s\u00edmbolos, o  utiliza texto o s\u00edmbolos junto con texto.</p> <p>Para unicode/emojis personalizados ShapeCatcher es un excelente recurso, puedes ponerte a dibujarlos y la AI va a buscar resultados similares. Simplemente ten cuidado de no utilizar unicode que sea demasiado oscuro, ya que no se va a mostrar correctamente en todos los sistemas.</p> <p>Toma nota en la preferencia de la comunidad en cuanto a displays: </p>"},{"location":"Rich-Presence-es/#desarrollando-rich-presence","title":"Desarrollando Rich Presence","text":"<p>La herramienta de desarrollo actualmente no cuenta con editor de Rich Presence integrado, pero puedes hacer pruebas locales antes de guardar algo en el servidor. Una vez que hubieras empezado un juego y el Rich Presence actual a sido descargado del servidor, puedes llegar a encontrar en <code>RACache\\Data\\XXX-Rich.txt</code> donde XXX es el ID del juego. </p> <p>El Monitor de Rich Presence (ejecutable desde el menu de RetroAchievments) lee este archivo y muestra el valor actual cada segundo mientras la ventana se encuentre abierta.</p> <p>Si haces cambios al archivo <code>XXX-Rich.txt</code>, y vuelves a reseleccionar la opci\u00f3n de monitor del menu, este va a leer los nuevos cambios para aqu\u00ed as\u00ed puedas hacer pruebas inmediatamente sin tener que aplicar cambios al servidor. Continua haciendo cambios y vuelve a seleccionar la opci\u00f3n en el menu asta que el script trabaje como esperas que lo haga, una vez que hubieras terminado copia el contenido del archivo a la pagina del servidor para que est\u00e9n los cambios disponibles para todos los dem\u00e1s jugadores.</p> <p>NOTA: El archivo <code>XXX-Rich.txt</code> es sobre-escrito con la informaci\u00f3n actual del servidor cada vez que el juego es abierto. Mientras aun tengas el archivo abierto en un editor, siempre vas a poder guardar tus cambios a pesar de re-abrir el juego.</p>"},{"location":"Rich-Presence-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 20:02] meleu:</code> fix broken link</li> <li><code>[2019-05-19 15:48] eldexterr:</code> Updated Rich Presence es (markdown)</li> <li><code>[2019-05-19 15:42] eldexterr:</code> Updated Rich Presence es (markdown)</li> <li><code>[2019-05-17 11:03] eldexterr:</code> Created Rich Presence es (markdown)</li> </ul>"},{"location":"Rich-Presence-pt_BR/","title":"Estado de Presen\u00e7a","text":"<p>link para texto em ingl\u00eas: Rich Presence</p>"},{"location":"Rich-Presence-pt_BR/#introducao","title":"Introdu\u00e7\u00e3o","text":"<p>O Estado de Presen\u00e7a (RP - Rich Presence, pela sigla em ingl\u00eas), \u00e9 uma breve vis\u00e3o geral do que os jogadores est\u00e3o fazendo atualmente em seu jogo. Para ter RP em um jogo, voc\u00ea precisa de um Script do Estado de Presen\u00e7a (ou Rich Presence Script - RPS - pela sigla em ingl\u00eas). O Script verifica a mem\u00f3ria do jogo do jogador e como programado relata os valores de certos endere\u00e7os com defini\u00e7\u00f5es atribu\u00eddas pelo Desenvolvedor, como em qual est\u00e1gio o jogador est\u00e1, quantas vidas eles t\u00eam, se o jogo est\u00e1 em pausa, que modo de jogo eles est\u00e3o jogando, o que o jogador realizou, etc. Esta informa\u00e7\u00e3o \u00e9 reportada de volta ao site.</p> <p>Exemplo de RP em a\u00e7\u00e3o:</p> <p></p> <p>Para ver o RP ao vivo em um jogo, clique no menu RetroAchievements no seu emulador e clique em Rich Presence Monitor. Uma pequena janela mostrar\u00e1 seu RP ativo. (Bom para depura\u00e7\u00e3o)</p> <p></p> <p>A melhor maneira de entender o Estado de Presen\u00e7a \u00e9 olhar para v\u00e1rios exemplos no jogo, olhar para os endere\u00e7os usados e ver como o texto \u00e9 exibido no Rich Presence Monitor e no site.</p>"},{"location":"Rich-Presence-pt_BR/#como-funciona","title":"Como funciona?","text":"<p>Toda vez que um jogo \u00e9 iniciado, ele busca os achievements em um arquivo 'patch' para a ROM, que detalha todos os achievements e endere\u00e7os de mem\u00f3ria (e leaderboards) que podem ser observados. Ele tamb\u00e9m solicitar\u00e1 um Rich Presence Script para a ROM atualmente carregada. O emulador informar\u00e1 o site a cada 120 segundos. Da mesma forma, a cada 120 segundos mais ou menos, a caixa de 'jogadores ativos' na frontpage ser\u00e1 atualizada, detalhando a \u00faltima atividade conhecida de todos os jogadores ativos. Se n\u00e3o houver um script do estado de presen\u00e7a, o texto estar\u00e1 \"ganhando achievements\" se estiver jogando um jogo com achievements, \"jogando [jogo]\" se estiver jogando sem achievements ou \"desenvolvendo achievements\" se a caixa de di\u00e1logo de mem\u00f3ria estiver aberta e vis\u00edvel.</p> <p>O RPS para cada jogo pode ser encontrado na se\u00e7\u00e3o de desenvolvimento na p\u00e1gina de cada jogo:</p> <p></p> <p></p>"},{"location":"Rich-Presence-pt_BR/#exemplo-super-mario-bros","title":"Exemplo (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>Ele se divide em uma s\u00e9rie de objetos de pesquisa, objetos de formato e um objeto de exibi\u00e7\u00e3o.</p>"},{"location":"Rich-Presence-pt_BR/#pesquisas","title":"Pesquisas","text":"<p>Pesquisas s\u00e3o definidas assim:</p> <pre><code>Lookup:NameOfLookup\nValue1=Text When This Value\nValue2=Text When Another Value\n...\n</code></pre> <p>N\u00f3s damos ao Lookup (pesquisa) um valor, consistindo de uma s\u00e9rie de endere\u00e7os de mem\u00f3ria e modificadores. Falaremos mais sobre isso depois.</p>"},{"location":"Rich-Presence-pt_BR/#formato","title":"Formato","text":"<p>Tabelas de formato s\u00e3o definidas assim:</p> <pre><code>Format:Score\nFormatType=VALUE\n</code></pre> <p>Comece com <code>Format</code>: e depois o nome do tipo de formato. Na pr\u00f3xima linha, forne\u00e7a <code>FormatType =</code> e, em seguida, um dos seguintes: <code>VALUE</code>, <code>SCORE</code> (ou <code>POINTS</code>), <code>TIME</code> (ou <code>FRAMES</code>), <code>SECS</code>, <code>MILLISECS</code> ou <code>OTHER</code>.</p> <ul> <li><code>VALUE</code>: valor gen\u00e9rico, sem zeros \u00e0 esquerda.</li> <li><code>SCORE</code> / <code>POINTS</code>: \"000130 pontos\"</li> <li><code>TIME / FRAMES</code>: o valor descreve o n\u00famero de quadros transcorridos e ser\u00e1 transformado em 00: 00.00</li> <li><code>SECS</code>: valor descreve o n\u00famero de segundos decorridos e ser\u00e1 transformado em 00:00</li> <li><code>MILLISECS</code>: value descreve o n\u00famero de milissegundos decorridos e ser\u00e1 transformado em 00: 00.00</li> </ul>"},{"location":"Rich-Presence-pt_BR/#exibicao","title":"Exibi\u00e7\u00e3o","text":"<p>A exibi\u00e7\u00e3o ser\u00e1 uma string exibida na caixa \"Players ativos\" na primeira p\u00e1gina. Refere-se aos objetos Lookup e Format definidos anteriormente usando um \u00fanico '@'. Em seguida, ele especifica um nome para a pesquisa ou formato (diferencia mai\u00fasculas de min\u00fasculas) e, imediatamente depois, entre colchetes, uma s\u00e9rie de valores de mem\u00f3ria que especificam o que enviar para esse objeto de pesquisa ou formato.</p> <p><code>@Powerup (0xh756)</code></p> <p>Isso significa usar o Lookup ou o Formato chamado <code>Powerup</code>, e dar a ele qualquer valor que esteja em 0xh756.</p>"},{"location":"Rich-Presence-pt_BR/#exemplo-de-analise-de-pesquisa","title":"Exemplo de an\u00e1lise de pesquisa","text":"<ul> <li><code>@Mode (0xh770)</code> - pesquisa o endere\u00e7o que mostra se o jogo est\u00e1 no modo de demonstra\u00e7\u00e3o ou se um mundo foi conclu\u00eddo.</li> <li><code>@Paused (0xh776)</code> - pesquisa o endere\u00e7o que mostra se o jogo est\u00e1 em pausa (s\u00e3o utilizados 3 valores, dois deles s\u00e3o para pausa e pausa).</li> <li><code>@Star (0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Procura o endere\u00e7o de se Mario tem a estrela de invencibilidade. Mais sobre isso depois.</li> <li><code>@Powerup (0xh756)</code> - Procura pelo endere\u00e7o que mostra se o Mairo \u00e9 Pequeno, grande ou tem poder de fogo.</li> <li><code>Mario in</code> - Texto est\u00e1tico para pesquisar string e formatar objetos juntos.</li> <li><code>@Digit (0xh75f_v1)</code> - D\u00edgito \u00e9 um objeto de formato definido como um valor. O endere\u00e7o 0xh75f \u00e9 o mundo menos 1 (porque \u00e9 baseado em 0, j\u00e1 que come\u00e7a a contar em 0). _v1 significa + valor 1. _v + 1 tamb\u00e9m est\u00e1 correto.</li> <li><code>-</code> - Mais texto est\u00e1tico para dividir o mundo e o n\u00edvel. como no hypen no mundo 1-1.</li> <li><code>@Digit (0xh75c_v1)</code> - Outro uso do objeto de formato de d\u00edgito. Desta vez est\u00e1 olhando para o est\u00e1gio. Mundo 1-X.</li> <li><code>@Swimming (0xh704)</code> - pesquisa o endere\u00e7o que mostra se o jogador est\u00e1 nadando.</li> <li><code>@Status (0xhe)</code> - pesquisa o endere\u00e7o que mostra o status de Mario, como passar por canos.</li> <li><code>, \ud83d\udeb6:</code> - Mais texto est\u00e1tico. \ud83d\udeb6 \u00e9 um s\u00edmbolo para vidas.</li> <li><code>@Digit (0xh75a_v1)</code> - Terceiro uso do objeto de formato de d\u00edgito. Desta vez, est\u00e1 verificando o endere\u00e7o do jogador.</li> <li><code>,</code>- texto est\u00e1tico.</li> <li><code>@Quest (0xh7fc)</code> Uma pesquisa para ver se o jogador est\u00e1 em normal ou na segunda miss\u00e3o, hardmode.</li> <li><code>Quest</code> - Texto Est\u00e1tico.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#tamanho-do-endereco","title":"Tamanho do endere\u00e7o","text":"<p>Para especificar o tamanho do endere\u00e7o que voc\u00ea est\u00e1 verificando, existem v\u00e1rios caracteres usados. (capitaliza\u00e7\u00e3o \u00e9 ignorada)</p> <ul> <li>Um endere\u00e7o de 16 bits \u00e9 padr\u00e3o e n\u00e3o possui designa\u00e7\u00e3o de caractere. Em 0x10, o endere\u00e7o \u00e9 dois bytes - 16 bits.</li> <li>Um caractere de endere\u00e7o de 8 bits \u00e9 <code>h</code> (ou <code>H</code>). Em 0xh10, o endere\u00e7o \u00e9 um byte - 8 bits. <code>xxxx xxxx</code></li> <li>Um caractere de endere\u00e7o do upper4 \u00e9 <code>u</code> (ou U). Em 0xu10, o endere\u00e7o \u00e9 um nibble - 4 bits. <code>xxxx 0000</code></li> <li>Um caractere de endere\u00e7o do lower4 \u00e9 <code>l</code> (ou L). Em 0xl10 o endere\u00e7o \u00e9 um nibble - 4 bits. <code>0000 xxxx</code></li> <li>Um caractere de endere\u00e7o bit0 \u00e9 <code>m</code> (ou <code>M</code>). Em 0xm10 o endere\u00e7o \u00e9 um bit, o bit mais baixo: <code>0000 000x</code></li> <li>Um caractere de endere\u00e7o bit1 \u00e9 <code>n</code> (ou <code>N</code>). Em 0xn10 o endere\u00e7o \u00e9 um bit, o segundo bit: <code>0000 00x0</code></li> <li>O caractere de um endere\u00e7o de bit2 \u00e9 <code>o</code> (ou <code>O</code>). Em 0xn10 o endere\u00e7o \u00e9 um bit, o terceiro bit: <code>0000 0x00</code></li> <li>Um caractere de endere\u00e7o de bit3 \u00e9 <code>p</code> (ou <code>P</code>). Em 0xp10 o endere\u00e7o \u00e9 um bit, o quarto bit: <code>0000 x000</code></li> <li>Um caractere de endere\u00e7o bit4 \u00e9 <code>q</code> (ou <code>Q</code>). Em 0xq10 o endere\u00e7o \u00e9 um bit, o quinto bit: <code>000x 0000</code></li> <li>Um caractere de endere\u00e7o bit5 \u00e9 <code>r</code> (ou <code>R</code>). Em 0xr10 o endere\u00e7o \u00e9 um bit, o sexto bit: <code>00x0 0000</code></li> <li>Um caractere de endere\u00e7o bit6 \u00e9 <code>s</code> (ou <code>S</code>). Em 0xs10 o endere\u00e7o \u00e9 um bit, o s\u00e9timo bit: <code>0x00 0000</code></li> <li>Um caractere de endere\u00e7o bit7 \u00e9 <code>t</code> (ou <code>T</code>). Em 0xt10 o endere\u00e7o \u00e9 um bit, o bit superior: <code>x000 0000</code></li> <li>Um caractere de endere\u00e7o de 32 bits \u00e9 <code>x</code> (ou <code>X</code>). Em 0xx10 o endere\u00e7o \u00e9 de quatro bytes e 32 bits.</li> </ul> <p>Resumindo em uma tabela:</p> <p></p>"},{"location":"Rich-Presence-pt_BR/#strings-de-exibicao-condicional","title":"Strings de exibi\u00e7\u00e3o condicional","text":"<pre><code>Display:\n?0x 000085=0?Title Screen\n?0xT00007c=1?Custom Map in @Landscape(0xH00016c)\nPlaying Battle @Battle(0x 00007c*0.2) in @Landscape(0xH00016c)\n</code></pre> <p>O <code>Display</code>: marker existente ainda \u00e9 usado para indicar o in\u00edcio do bloco de exibi\u00e7\u00e3o. Se a pr\u00f3xima linha come\u00e7ar com um ponto de interroga\u00e7\u00e3o, ela ser\u00e1 considerada uma sequ\u00eancia de exibi\u00e7\u00e3o condicional. A parte da linha entre os dois pontos de interroga\u00e7\u00e3o \u00e9 a cl\u00e1usula condicional. Se a cl\u00e1usula condicional avaliar que \u00e9 verdadeiro (true), a parte restante da linha ser\u00e1 usada como a sequ\u00eancia de exibi\u00e7\u00e3o. Se n\u00e3o avaliar true, o processamento prosseguir\u00e1 para a pr\u00f3xima linha. Se come\u00e7ar com um ponto de interroga\u00e7\u00e3o, o mesmo processo ser\u00e1 repetido. Se n\u00e3o come\u00e7ar com um ponto de interroga\u00e7\u00e3o, a linha inteira ser\u00e1 usada como a sequ\u00eancia de exibi\u00e7\u00e3o padr\u00e3o.</p> <p>Olhando para este exemplo, se o valor de 16 bits em $ 0085 for 0, a seq\u00fc\u00eancia de exibi\u00e7\u00e3o \u00e9 <code>Title Screen</code>. Se n\u00e3o, a pr\u00f3xima linha \u00e9 examinada. Se o s\u00e9timo bit de $ 007C for 1, a cadeia de exibi\u00e7\u00e3o ser\u00e1 Custom <code>Map em @Landscape (0xH00016c)</code>. Se n\u00e3o, a linha final n\u00e3o tem uma cl\u00e1usula condicional e \u00e9 usada.</p> <p>As cadeias de exibi\u00e7\u00e3o associadas a uma cl\u00e1usula condicional suportam a mesma sintaxe que a cadeia de exibi\u00e7\u00e3o padr\u00e3o. Neste exemplo, voc\u00ea pode ver que a pesquisa <code>@Landscape</code> \u00e9 usada na seq\u00fc\u00eancia de exibi\u00e7\u00e3o condicional e na sequ\u00eancia de exibi\u00e7\u00e3o padr\u00e3o. A pesquisa em si s\u00f3 precisa ser definida uma vez.</p> <p>A frase condicional suporta todos os assessores de endere\u00e7o mencionados anteriormente, bem como a l\u00f3gica AND (_) e OR (S). Note que cl\u00e1usulas OR ainda requerem um grupo 'core', da mesma forma que as conquistas.</p> <ul> <li><code>? 0xH1234 = 32_0xH2345 = 0? and example</code></li> </ul> <p>se o valor de 8 bits em $ 1234 for 32 e o valor de 8 bits em $ 2345 for 0, display <code>and example</code></p> <ul> <li><code>? 0xH1234 = 32_0xH2345 = 1S0xH2345 = 2? or example</code></li> </ul> <p>se o valor de 8 bits em $ 1234 for 32 e o valor de 8 bits em $ 2345 for 1 ou 2, exibir <code>or example</code></p>"},{"location":"Rich-Presence-pt_BR/#decimal-binario-codificado-dbc","title":"Decimal Bin\u00e1rio Codificado (DBC)","text":"<p>DBC \u00e9 quando os valores s\u00e3o armazenados em um endere\u00e7o de 0 a 9 (um d\u00edgito) ou 0 a 99 (dois d\u00edgitos). Na maioria das vezes os valores s\u00e3o armazenados em hexadecimal, mas em algum momento os jogos ir\u00e3o armazen\u00e1-los desta maneira e aqui est\u00e1 a melhor maneira de lidar com esses endere\u00e7os no seu monitor.</p> <p>Para objetos de valor, voc\u00ea pode usar o prefixo DBC, como em <code>b0x1</code>. Um endere\u00e7o DBC \u00e9 considerado 8bit, h \u00e9 desnecess\u00e1rio, mas tamb\u00e9m n\u00e3o causar\u00e1 problemas. Outros prefixos de caracteres funcionam? (n\u00e3o testado). Quando voc\u00ea usa o prefixo b e o endere\u00e7o \u00e9 armazenado como um DBC, sua sa\u00edda para um endere\u00e7o de 10 ser\u00e1 10 em vez de 16 (que \u00e9 10 em hexadecimal).</p> <p>Isso \u00e9 mais comumente usado para pontua\u00e7\u00e3o e tempo, mas geralmente outros tipos de valores de exibi\u00e7\u00e3o.</p>"},{"location":"Rich-Presence-pt_BR/#limites","title":"Limites","text":"<ul> <li>Limite de 2500 caracteres para script</li> <li>Limite de 100 caracteres para o que \u00e9 exibido</li> <li>Caracteres Unicode s\u00e3o permitidos</li> <li>Usar <code>&amp;</code> no texto cortar\u00e1 o script ap\u00f3s o <code>&amp;</code></li> <li>Usando o personagem <code>+</code> n\u00e3o ser\u00e1 exibido</li> </ul>"},{"location":"Rich-Presence-pt_BR/#detalhes-da-sintaxe","title":"Detalhes da Sintaxe","text":"<ul> <li>O RPS ignora 0s finais em pesquisas de endere\u00e7o hexadecimais e os valores <code>0x00001</code> == <code>0x1</code>, <code>0xh0000245</code> == <code>0xh245, 0x0a</code> == <code>0xa</code>.</li> <li>Os valores de pesquisa s\u00e3o Decimal por padr\u00e3o e hex se voc\u00ea colocar o prefixo de <code>0x</code>. Isso significa <code>1</code> == <code>0x1</code>, <code>2</code> == <code>0x2</code>, <code>9</code> == <code>0x9</code>, <code>10</code> == <code>0xa</code>, <code>100</code> == <code>0x64</code>, etc.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#dicas-e-truques","title":"Dicas e truques","text":"<ul> <li>As pesquisas devem ser espec\u00edficas de caso com seus @ correspondentes na exibi\u00e7\u00e3o e n\u00e3o conter espa\u00e7os ap\u00f3s a pesquisa ser definida.</li> <li>Os nomes de pesquisa podem ser t\u00e3o curtos quanto um \u00fanico caractere se voc\u00ea precisar incluir alguns caracteres extras.</li> <li>Transformar todos os seus valores de hexadecimal em decimal ocupar\u00e1 menos caracteres.</li> <li>Caracteres Unicode nem sempre \"ocupam menos espa\u00e7o\", eles geralmente ocupam at\u00e9 quatro caracteres do sistema.</li> <li>Se voc\u00ea n\u00e3o definir suas pesquisas, elas ser\u00e3o deixadas em branco (sem espa\u00e7o). Apenas para NES, SNES, Gen, RAVBA. N64, Meka e Lynx deixar\u00e3o a palavra \"Desconhecido\" toda vez que voc\u00ea n\u00e3o definir uma pesquisa.</li> <li>Voc\u00ea s\u00f3 precisa de um objeto de formato de valor. Voc\u00ea pode referenci\u00e1-lo com v\u00e1rios endere\u00e7os. (isso \u00e9 sempre verdade?)</li> <li>Colocar espa\u00e7os em suas pesquisas algumas vezes antes ou depois pode permitir que voc\u00ea oculte determinadas pesquisas quando elas n\u00e3o forem necess\u00e1rias, como fazer <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code> e <code>@Mode</code>.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#propriedades-de-valor","title":"Propriedades de valor","text":"<p>Ao usar objetos de pesquisa e formata\u00e7\u00e3o <code>@object ()</code>, \u00e9 poss\u00edvel combinar e executar c\u00e1lculos. Isso pode ser usado para exibir corretamente uma pontua\u00e7\u00e3o, em tempo de jogo, etc. ou fazer pesquisas mais avan\u00e7adas.</p> <p>Exemplo `@Score (0x28 * 10_0x29 * 1000_0x26 * 100000) points``</p> <p>Isso significa usar a pesquisa ou pontua\u00e7\u00e3o de formato e dar a soma de:</p> <ul> <li>0x28 vezes 10, ADD</li> </ul> <ul> <li>0x29 vezes 1000, ADD</li> </ul> <ul> <li>0x26 vezes 100000</li> </ul> <ul> <li><code>_</code> adiciona os endere\u00e7os juntos.</li> </ul> <ul> <li>Ou voc\u00ea pode adicionar um valor est\u00e1tico <code>0x28_v10</code>. Isso adiciona 10 ao seu total, como em qualquer que seja o valor de <code>0x28</code> + 10 ser\u00e1 exibido. Voc\u00ea tamb\u00e9m pode subtrair <code>0x28_v-10</code>.</li> </ul> <ul> <li>Se voc\u00ea quiser subtrair um endere\u00e7o, multiplique o endere\u00e7o por -1. <code>0x29 * -1</code>. <code>0x29</code> agora \u00e9 negativo.</li> </ul> <ul> <li>Se voc\u00ea gostaria de realizar a divis\u00e3o, voc\u00ea precisar\u00e1 multiplicar por um decimal. <code>0x26 * .5</code>. <code>0x26</code> ir\u00e1 gerar 1/2 do valor em <code>0x26</code>.</li> </ul> <ul> <li>E voc\u00ea pode amarrar tudo junto: <code>0x28 * 10_0x29 * -1_0x26 * .625_v-10</code>.</li> </ul> <ul> <li>Voc\u00ea tamb\u00e9m pode adicionar endere\u00e7os juntos para fornecer pesquisas com base nas somas de v\u00e1rios endere\u00e7os. Isso \u00e9 usado no exemplo em @Star. Est\u00e1 procurando a soma dos 6 bits mais baixos do endere\u00e7o 0xh79f. A maneira como esse endere\u00e7o funciona \u00e9 que, desde que haja um valor l\u00e1, Mario \u00e9 star Mario invenc\u00edvel e a contagem regressiva do valor hexadecimal 0x23 (35 decimal) para 0. 23 em bin\u00e1rio \u00e9 0010 0011, significando que a soma m\u00e1xima desses bits pode ser 5 durante 0001 1111 quando a contagem regressiva alcan\u00e7a o valor hexadecimal 0x1f (31 decimal).</li> </ul>"},{"location":"Rich-Presence-pt_BR/#simbolos-padrao-unicode","title":"S\u00edmbolos Padr\u00e3o Unicode","text":"<p>\u258c\u258c=em pausa</p> <p>\ud83d\udd01= n\u00famero de loop</p> <p>\ud83d\udeb6=vidas. Outros s\u00edmbolos que representam o jogo claramente tamb\u00e9m s\u00e3o adequados. \ud83d\udc30=in a Bugs bunny Game, \ud83d\udc35=in a Donkey Kong Country game, \u2708=In a jet plane game,</p> <p>\ud83d\udc9e=Continue</p> <p>\ud83d\udcaf=Pontos</p> <p>\u23f0=Tempo de jogo/Rel\u00f3gio do game</p> <p>\ud83d\udd11=Chaves</p> <p>\ud83d\udca3=Bombas \u2630=Menu</p> <p>\u2764\ufe0f ou \u2764= Em um jogo com cora\u00e7\u00f5es (ex. Zelda)</p> <p>\ud83d\udcb0=Dinheiro</p> <p>\u2696=Dificuldade</p>"},{"location":"Rich-Presence-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-16 12:25] meleu:</code> smallfix</li> <li><code>[2020-09-16 12:24] meleu:</code> use RP acronym</li> <li><code>[2020-09-16 12:20] meleu:</code> use relative links</li> <li><code>[2020-09-15 17:49] Ben-Ghazi:</code> Changed the links to go to the docs equivalent instead of the wiki.</li> <li><code>[2018-03-28 03:11] KingDice001:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-28 03:06] KingDice001:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:25] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:24] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:06] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 21:17] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> </ul>"},{"location":"Rich-Presence/","title":"Rich Presence","text":"<ul> <li>Introduction</li> <li>How Does it work?</li> <li>Example</li> <li>Macros</li> <li>Lookups</li> <li>Format</li> <li>Built-in macros</li> <li>Display</li> <li>Example Lookup Breakdown</li> <li>Conditional Display Strings</li> <li>Limits</li> <li>Rich Presence Restrictions</li> <li>Tips and Tricks</li> <li>Value Properties</li> <li>Unicode Standard Symbols</li> <li>Developing Rich Presence</li> <li>Parse Errors</li> </ul>"},{"location":"Rich-Presence/#introduction","title":"Introduction","text":"<p>Rich Presence (RP) is brief overview of what active players are currently doing in their game. To have RP in a game you need a Rich Presence script, which is created by Developers. The script checks the player's game memory and reports the values of certain addresses with definitions assigned by the Developer such as which stage the player is on, how many lives they have, if the game is paused, what game mode they are playing, what the player has accomplished, etc. This information is reported back to the website once every two minutes.</p> <p>A good rich presence should inform other users how far into the game you are (level/ town/dungeon), and give an overall sense of how the player is doing (score/remaining lives/character level). Additional details may be useful, depending on their context within the game. Try not to go overboard with the detail though. Other players don't care what you named your dog, or need to know how many bullets you have left, especially since it only updates every two minutes. Additionally, the more fluff you add to a rich presence display, the more diluted the important information becomes.</p> <p>Example of RP in action:</p> <p> </p> <p>To see the RP live in a game click on the RetroAchievements menu in your emulator and then click on Rich Presence Monitor. A small window will show you your active RP. (Good for debugging)</p> <p></p> <p>The best way to understand Rich Presence is to look at various examples in game, look at the addresses used and look at how the text is displayed in the Rich Presence Monitor and on site.</p>"},{"location":"Rich-Presence/#how-does-it-work","title":"How Does it work?","text":"<p>The game's Rich Presence script is downloaded with the achievement and leaderboard data for a game. As soon as the emulator validates this data, it starts a session for the user. This sets the user's 'Last Seen In' to 'Playing [game]'. 30 seconds later, the Rich Presence script will be evaluated and the result sent to the server. This will update the 'Last Seen In' for the player, which is also used in the 'Active Players' list on the front page. Every two minutes after that, the Rich Presence script will be evaluated again, and the 'Last Seen In' will be updated again. This continues until the user closes the emulator.</p> <p>If there isn't a Rich Presence script for the game, the user has disabled rich presence, or the user has modified the Rich Presence script, the text will remain 'Playing [game]'.</p> <p>The user's 'Last Seen In' may also say 'Fixing Achievements' or 'Developing Achievements' if they have any of the tool windows open. The first will display if achievements have been published for the set. The second if achievements have not been published for the set.</p> <p>The Rich Presence script for a game can be found under the development section on each game's page: </p> <p></p> <p></p>"},{"location":"Rich-Presence/#example-super-mario-bros","title":"Example (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>It breaks down into a series of Lookup objects, Format objects and one Display object. </p>"},{"location":"Rich-Presence/#macros","title":"Macros","text":"<p>A macro converts a value into a user-friendly string. Macros are placed within a display string and will be replaced when the display string is evaluated. A macro starts with an <code>@</code>, then the name of the macro, an opening parenthesis, the value to evaluate, and a closing parenthesis.</p> <p><code>@Macro(0xh1234)</code> says read the byte at $1234, transform it using the <code>Macro</code> macro, and place the result in the display string where the macro had been.</p> <p>Parameters for each macro are constructed using a value definition.</p>"},{"location":"Rich-Presence/#lookups","title":"Lookups","text":"<p>Lookups are defined like this: </p> <pre><code>Lookup:NameOfLookup\n1=Text When 1\n2=Text When 2\n...\n</code></pre> <p>When a display string references a Lookup, it's value will be located in the table and the associated text will be displayed.</p> <p>NOTE: Values in the Lookup should be in decimal. If you want to use hex values, include a <code>0x</code> prefix. (i.e. <code>0x12=Eighteen</code>)</p> <p>You can also specify multiple values for a single text string:</p> <pre><code>1-5,10=Text When These Values\n*=Text For All Other Values\n</code></pre> <p>In this example, the values 1, 2, 3, 4, 5, and 10 all map to the first text string.</p> <p>Anything that doesn't match an item defined in the lookup table will return the text associated with <code>*</code>. If <code>*</code> does not appear in the lookup table, no text will be returned if a value doesn't have an entry.</p>"},{"location":"Rich-Presence/#format","title":"Format","text":"<p>Format tables are defined like this:</p> <pre><code>Format:Score\nFormatType=VALUE\n</code></pre> <p>Begin with <code>Format:</code>, then the name of the Format converter. On the next line, give <code>FormatType=</code>, then one of the following:</p> <ul> <li><code>VALUE</code>: generic value, no leading zeroes. </li> <li><code>SCORE</code>/<code>POINTS</code>: generic value, padded with leading 0s to 6 digits.</li> <li><code>TIME</code>/<code>FRAMES</code>: value describes the number of frames elapsed, and will be turned into 00:00.00 by multiplying by 100 (hundredths of a second) and dividing by 60 (frames per second). If your system runs at something other than 60 fps, you'll have to do the conversion yourself and use <code>MILLISECS</code>.</li> <li><code>MILLISECS</code>: value describes the number of hundredths of a second elapsed, and will be turned into 00:00.00 </li> <li><code>SECS</code>: value describes the number of seconds elapsed, and will be turned into 00:00 </li> <li><code>MINUTES</code>: value describes the number of minutes elapsed, and will be turned into 0h00</li> <li><code>SECS_AS_MINS</code>: value describes the number of seconds elapsed, and will be turned into 0h00</li> <li><code>FLOAT1</code>-<code>FLOAT6</code>: formats a floating point number with the specified number of digits after the decimal</li> </ul>"},{"location":"Rich-Presence/#built-in-macros","title":"Built-in macros","text":"<p>As of the 1.0 version of the DLL, you can use predefined macros for the most common formats. The following macros are now implicit:</p> Macro Format Description <code>@Number()</code> <code>VALUE</code> A generic value with no leading zeroes <code>@Score()</code> <code>SCORE</code> A generic value, padded with leading zeroes to six digits <code>@Centiseconds()</code> <code>MILLISECS</code> The number of hundreths of a second elapsed, and will be formatted as <code>00:00.00</code> <code>@Seconds()</code> <code>SECS</code> The number of seconds elapsed, and will be formatted as <code>00:00</code> <code>@Minutes()</code> <code>MINUTES</code> The number of minutes elapsed, and will be formatted as <code>0h00</code> <code>@Float1()</code> <code>FLOAT1</code> A floating point number, formatted with one digit after the decimal <code>@Float2()</code> <code>FLOAT2</code> A floating point number, formatted with two digits after the decimal <code>@Float3()</code> <code>FLOAT3</code> A floating point number, formatted with three digits after the decimal <code>@Float4()</code> <code>FLOAT4</code> A floating point number, formatted with four digits after the decimal <code>@Float5()</code> <code>FLOAT5</code> A floating point number, formatted with five digits after the decimal <code>@Float6()</code> <code>FLOAT6</code> A floating point number, formatted with six digits after the decimal <code>@ASCIIChar()</code> n/a Converts a value from 0x20-0x7F into a character using the ASCII character map. Other values will be converted to <code>?</code> <code>@UnicodeChar()</code> n/a Converts a value into a character using the 16-bit Unicode character map. Unknown values will be converted to <code>\ufffd</code>"},{"location":"Rich-Presence/#display","title":"Display","text":"<p>Display is a string that gets shown in the 'Active Players' box on the front page and the 'Last Seen In' section of the player's profile.</p> <p>It is built by replacing any macros in the display string with text from a Lookup or formatted values from a Format converter. Each macro is identified by a single '@', which is followed by the name for the Lookup or Format (case sensitive!), and immediately after, in parenthesis, a value specifying what to send to that Lookup or Format object.</p> <p><code>Using @Powerup(0xh756)!</code> </p> <p>This means use the Lookup or Format that's called <code>Powerup</code>, and give it whatever 8-bit value is in the address 0x756. After converting, put the result in between \"Using \" and \"!\".</p> <p>NOTE: Lookup/Format names are case sensitive and must exactly match the usage in the Display string: <code>@test(0x1234)</code> will not find <code>Format:Test</code></p> <p>NOTE: Lookup/Format definitions cannot contain spaces before or after the name. <code>@test(0x1234)</code> will not find <code>Format:test</code> or <code>Format:   test</code></p>"},{"location":"Rich-Presence/#example-lookup-breakdown","title":"Example Lookup Breakdown","text":"<ul> <li><code>@Mode(0xh770)</code> - Lookup for the address that shows if the game is in demo mode or a world has been completed.  </li> <li><code>@Paused(0xh776)</code> - Lookup for the address that shows if the game is paused (3 values are used, two of them are for pausing and unpausing).  </li> <li><code>@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Lookup for the address of if Mario has Star invincibility. More on this later.  </li> <li><code>@Powerup(0xh756)</code> - Lookup for the address that show if Mario is Small, big or has fire power.  </li> <li><code>Mario in</code> - Static text to string lookup and format objects together.  </li> <li><code>@Digit(0xh75f_v1)</code> - <code>Digit</code> is a format object defined as a value. The address 0xh75f is the World minus 1 (because it is 0 based, as in it starts counting at 0). <code>_v1</code> Means + value 1. <code>_v+1</code> is also correct.  </li> <li><code>-</code> - More static text to split World and Level. as in the hyphen in World 1-1.  </li> <li><code>@Digit(0xh75c_v1)</code> - Another use of the <code>Digit</code> format object. This time It's looking up the stage. World 1-X.  </li> <li><code>@Swimming(0xh704)</code> - Lookup for the address that shows if the player is swimming.  </li> <li><code>@Status(0xhe)</code> - Lookup for the address that shows Mario's status, such as going through pipes.  </li> <li><code>, \ud83d\udeb6:</code> - More static text. \ud83d\udeb6 is a symbol for lives.  </li> <li><code>@Digit(0xh75a_v1)</code> - Third use of the <code>Digit</code> format object. This time it's checking the player lives address.  </li> <li><code>,</code> - Static text.  </li> <li><code>@Quest(0xh7fc)</code> A lookup to see if the player is in normal or on the 2nd quest, hardmode.  </li> <li><code>Quest</code> - Static Text.  </li> </ul>"},{"location":"Rich-Presence/#conditional-display-strings","title":"Conditional Display Strings","text":"<pre><code>Display:\n?0x 000085=0?Title Screen\n?0xT00007c=1?Custom Map in @Landscape(0xH00016c)\nPlaying Battle @Battle(0x 00007c*0.2) in @Landscape(0xH00016c)\n</code></pre> <p>The existing <code>Display:</code> marker is still used to indicate the start of the display block. If the next line starts with a question mark, it is considered to be a conditional display string. The portion of the line between the two question marks is the conditional clause. If the conditional clause evaluates true, then the remaining portion of the line is used as the display string. If it does not evaluate true, then processing proceeds to the next line. If it starts with a question mark, the same process repeats. If it does not start with a question mark, the entire line is used as the default display string.</p> <p>NOTE: A default display string is required in case none of the conditional display strings match. If you only have conditional display strings, the script will appear to do nothing.</p> <p>Looking at this example, if the 16-bit value at $0085 is 0, the display string is <code>Title Screen</code>. If not, the next line is examined. If the 7th bit of $007C is 1, the display string is <code>Custom Map in @Landscape(0xH00016c)</code>. If not, the final line does not have a conditional clause and is used.</p> <p>Display strings associated with a conditional clause support all of the same syntax as the default display string. In this example, you can see the <code>@Landscape</code> lookup is used in both the conditional display string and the default display string. The lookup itself only has to be defined once.</p> <p>The conditional phrase supports all of the previously mentioned address accessors as well as AND (_) and OR (S) logic. Note that OR clauses still require a 'core' group, just like achievements.</p> <ul> <li><code>?0xH1234=32_0xH2345=0?and example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $2345 is 0, display <code>and example</code></p> </li> </ul> <ul> <li><code>?0xH1234=32S0xH2345=1S0xH2345=2?or example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $2345 is 1 or 2, display <code>or example</code></p> </li> </ul> <ul> <li><code>?0xH1234=32_0xH5678=33S0xH2345=1S0xH2345=2?and/or example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $5678 is 33 and the 8-bit value at $2345 is 1 or 2, display <code>and/or example</code></p> </li> </ul> <p>Pro-tip: Conditions can be created using the achievement editor. Once you have your condition defined, use the <code>Copy Def</code> button to copy the achievement definition to the clipboard so you can paste it into the rich presence script.</p>"},{"location":"Rich-Presence/#limits","title":"Limits","text":"<ul> <li>65,535 character limit for script  </li> <li>255 character limit for what is displayed  </li> <li>Unicode characters are allowed, but use count as more than 1 character towards the specified limits.</li> </ul>"},{"location":"Rich-Presence/#rich-presence-custom-name-restriction","title":"Rich Presence Custom Name Restriction","text":"<p>Rich Presence that directly displays custom player input text is prohibited.  The most common example being displaying what a player inputs as their character or file name directly into Rich Presence.</p> <p>This restriction helps in preventing inappropriate or offensive content from showing on various site pages as well as makes the moderation of Rich Presence more manageable, in addition to protection player privacy as players may not realize their text is being displayed publicly.</p>"},{"location":"Rich-Presence/#tips-and-tricks","title":"Tips and Tricks","text":"<ul> <li>Comments can be added anywhere in the script. A double slash (<code>//</code>) indicates the remaining portion of the line should be ignored when processing the script. Note: comments still apply toward the script size limit.</li> <li>Lookup names can be as short as a single character if you need to squeeze in a few extra characters.</li> <li>Leading zeros can be removed from addresses (<code>0xh0001</code> can be shortened to <code>0xh1</code>).</li> <li>Turning all your values from hex into decimal will take up less characters.</li> <li>Unicode characters don't always \"take up less space\" they often take up to four system characters.</li> <li>Each <code>Lookup</code> or <code>Format</code> named mapping can be referenced multiple times with the same or different addresses. You can define a single <code>Format:Number FormatType=VALUE</code> instead of defining individual ones for Lives, Score, Level, etc.</li> <li>Putting spaces in your Lookups sometimes before or after can allow you to hide certain lookups when they are not needed, like how <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code>, and @Mode do. </li> </ul>"},{"location":"Rich-Presence/#value-properties","title":"Value Properties","text":"<p>When using lookup and format objects <code>@object()</code> it's possible to combine and perform calculations. Macro parameters are value definitions, so you can use multiplication, addition, and even some logic to generate values that aren't directly available in memory.</p> <p>Example <code>@Score(0xh28*10_0xh29*1000_0xh26*100000) points</code> </p> <p>This means use the Lookup or Format <code>Score</code>, and give it the sum of: - the 8-bit value at 0x28 times 10, ADD - the 8-bit value at 0x29 times 1000, ADD - the 8-bit value at 0x26 times 100000  </p>"},{"location":"Rich-Presence/#unicode-standard-symbols","title":"Unicode Standard Symbols","text":"<p>You can without doubt use these symbols in rich presence.</p> <p>\u258c\u258c=Paused \ud83d\udd01=Continues \u23f0=In Game Time/Game Clock \ud83d\udd11=Keys \ud83d\udca3=Bombs \u2764\ufe0f or \u2764=In a game with hearts (e.g. Zelda)  \ud83d\udcb0=Money \ud83d\udea9=Level/Stage   </p> <p>While making Rich Presence, devs need to be careful that they are communicating clearly. If you are using non-standard symbols they will make sense to you but could be entirely confusing to others. When using non-standard symbols, check them with someone else or a few people to see if the symbols you use make sense. If they don't, use better symbols, use text or use symbols alongside of text.</p> <p>For custom unicode/emoji ShapeCatcher is an excellent resource, you can draw what you're looking for and an AI will find similar matches. Just be careful to not use unicode that too obscure, as they don't all display on all systems.</p> <p>Take note of community display preference:</p> <p></p>"},{"location":"Rich-Presence/#developing-rich-presence","title":"Developing Rich Presence","text":"<p>The toolkit does not currently have an integrated Rich Presence editor, but you can test local changes before putting them on the server. Once you've started a game and the current Rich Presence has been downloaded from the server, you can find it in <code>RACache\\Data\\XXX-Rich.txt</code> where XXX is the game ID. </p> <p>The Rich Presence Monitor (openable from the RetroAchievments menu) reads this file and shows the current value every second while the window is open.</p> <p>If you make changes to the <code>XXX-Rich.txt</code> file, and reselect the menu option, it will read the new changes and allow you to immediate test them without applying the changes to the server. Continue to make changes and reselect the menu option until the script is behaving as you expect, then copy the contents to the server page to make it available to everyone else.</p> <p>NOTE: The <code>XXX-Rich.txt</code> file is overwritten with the current server data each time the game is opened. As long as you still have the file open in an editor, you can always save your changes over the updated file after reopening the game.</p> <p>Rich Presence files utilize Condition Syntax for Memory Sizes, Prefixes and Logical Flags. These are also represented if you copy and paste achievement logic from the Achievement Editor.</p>"},{"location":"Rich-Presence/#parse-errors","title":"Parse Errors","text":"Code Enum Description -2 <code>INVALID_MEMORY_OPERAND</code> A memory operand was expected and not found. Memory operands start with <code>0x</code>, then a size indicator. The most common causes of this are forgetting the <code>0x</code> or having an <code>_S</code> or <code>__</code> in the script. -3 <code>INVALID_CONST_OPERAND</code> A lookup key could not be evaluated. The most common cause of this is using hex without the <code>0x</code> prefix. This may also occur on older versions of RetroArch when using CSV or range keys for lookups. -6 <code>INVALID_OPERATOR</code> An unknown operator was encountered. The most common cause of this is using <code>!</code> instead of <code>!=</code> -16 <code>MISSING_VALUE</code> A macro was encountered without providing a value (i.e. <code>@Points</code> instead of <code>@Points(0xh1234)</code>) -18 <code>MISSING_DISPLAY_STRING</code> The rich presence script did not contain a <code>Display:</code> element, or contained only conditional display strings -20 <code>RC_INVALID_VALUE_FLAG</code> A non-combining flag is used in a non-trigger context. Combining flags are AddSource, SubSource, AddHits, AddAddress and AndNext. <p>Additionally, if you see <code>[Unknown macro]</code>, that means the macro name could not be resolved. For example <code>@Points(0xh1234)</code> without defining <code>Format:Points</code> would generate <code>[Unknown macro]Points(0xh1234)</code>.</p> <p>This issue happens sometimes when a Rich Presence is created in the <code>&lt;GameID&gt;-Rich.txt</code> file in the <code>RACache&gt;Data</code> folder. In this case the issue can be fixed by adding an empty line at the start of the file.</p>"},{"location":"Rich-Presence/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-26 08:48] The Mystical One:</code> Updated Rich Presence (markdown)</li> <li><code>[2024-01-26 08:46] The Mystical One:</code> Adds Player-Input Text Restriction section.</li> <li><code>[2024-01-13 09:50] OvenOverlord:</code> Updated Rich Presence (markdown)</li> <li><code>[2023-06-06 11:04] televandalist:</code> Added ToC</li> <li><code>[2022-04-30 16:18] Jamiras:</code> Updated Rich Presence (markdown)</li> <li><code>[2022-02-04 17:38] Jamiras:</code> extract memory sizes</li> <li><code>[2022-02-04 17:12] Jamiras:</code> extract Value Definition to separate page</li> <li><code>[2022-01-31 10:51] Jamiras:</code> add built-in macros</li> <li><code>[2022-01-26 09:39] Shane Shirey:</code> Updated Rich Presence (markdown)</li> <li><code>[2022-01-26 09:38] Shane Shirey:</code> Updated Rich Presence (markdown)</li> </ul>"},{"location":"Rollouts/","title":"Rollouts","text":""},{"location":"Rollouts/#intro","title":"Intro","text":"<p>Rollouts are events that are meant to mimic a console launch. Developers participating in rollouts devote their time to working on achievement sets with the intent of having several sets ready once the console is supported for all players. </p>"},{"location":"Rollouts/#general-guidelines","title":"General Guidelines","text":"<p>It's worth noting that these are general guidelines that apply to all rollouts. Individual rollouts may require addtional guidelines. </p> <ul> <li>Each rollout needs a coordinator/manager to handle a variety of tasks to ensure the rollout goes smoothly. <ul> <li>Task of Coordinator(s)/Manager(s)<ul> <li>Gauging interest from achievement developers.</li> <li>Keeping track of claims to ensure there's no overlap and to keep the claims manager(s) up-to-date. </li> <li>Having close communication with participants to answer questions and to resolve any conflicts that may arise. </li> <li>Reporting emulator/core bugs and other issues to tech-team.</li> <li>Provide necessary information to the RANews team, if applicable.</li> <li>Maintaining a schedule so developers know when they are to officially claim their picks in the forum, when playtesters can start testing sets, and when the console's support will officially launch.</li> <li>Ensuring the console ID is validated on the website when support launches, or at least be in contact with the web team to do so. </li> </ul> </li> </ul> </li> </ul> <ul> <li>Developers are limited to leading one set at a time, but may collaborate on as many sets as they wish. Upon completion of a set, they are to notify QA to look over their set and sign them off, which allows them to move on to their next pick, if applicable. </li> </ul> <ul> <li>As per the Developer Code of Conduct, Developers must be free of unaddressed tickets in order to have their claims locked in. They must also have an open claim slot. </li> </ul> <ul> <li>Since the overall goal of a rollout is to provide sets to launch with a console's support, developers who go inactive or otherwise end up not working on the chosen sets will have their claim lapsed. In other words, claiming a set just to sit on it will not fly and will result in a lapse. </li> </ul>"},{"location":"Rollouts/#rollout-process","title":"Rollout Process","text":"<ul> <li>When a previously unsupported console becomes viable to work on achievements, developers are to be asked individually if they would like to participate in a console's rollout. If they are interested, they are to pick one game as their priority pick, but may provide a list of additional games as backup. </li> <li>The overall list is then sorted to see if there are any overlapping picks. If a priority pick is exclusive to one developer, they can be locked in for that pick. If multiple developers share the same priority pick, they will be encouraged to collaborate. </li> </ul>"},{"location":"Rollouts/#previous-rollouts","title":"Previous Rollouts","text":"Launch Date Console Number of Sets on Launch Day Relevant Links 2019-09-07 PlayStation 28 Forum Topic 2021-10-01 PlayStation Portable 38 Forum Topic 2022-02-12 Dreamcast 34 Forum Topic 2022-03-28 Amstrad CPC 30 Forum Topic 2022-05-08 ArduboyWASM-4 3825 Forum Topic 2022-07-28 Fairchild Channel FMega Duck ???? Forum Topic 2022-10-01 PlayStation 2 92 Forum Topic 2023-04-16 Nintendo DSi 45 Forum Topic 2023-06-04 Atari Jaguar CD 12 Forum Topic 2023-07-01 Interton VC 4000 31 Forum Topic 2023-07-01 Elektor TV Games Computer 23 Forum Topic 2023-07-01 Arcadia 2001 22 Forum Topic Pending Uzebox ?? Pending Pending TI-83 ?? Pending Pending Neo Geo CD ?? Pending Pending Commodore 64 ?? Pending Pending ZX Spectrum ?? Pending"},{"location":"Set-Development-Roadmap-es/","title":"Mapa de Desarrollo de Set","text":"<p>Lo siguiente es un plano detallado de la mayor\u00eda de las cosas que necesitas considerar cuando te encuentres haciendo un set de logros. No es requisito seguir esto al pie de la letra, esto es mas como una gu\u00eda.</p>"},{"location":"Set-Development-Roadmap-es/#investigacion-inicial","title":"Investigaci\u00f3n Inicial","text":"<ul> <li>Manual del Juego: Estudiarlo</li> <li>Game Faqs: Leer/checarlo</li> <li>Game Cheats: Encontrar, anotar</li> <li>Longplay: Estudiarlo/observarlo</li> <li>Sets similares: Comparar, anotar tus ideas favoritas</li> <li>Partimes: checar si existen</li> <li>Speedruns: checar si existen</li> </ul>"},{"location":"Set-Development-Roadmap-es/#diseno-conceptual","title":"Dise\u00f1o Conceptual","text":"<ul> <li>Logros 1: Tormenta de Ideas, incluye ideas de sets similares, manual, etc.     - Anota secretos, progreso, elementos clave, coleccionables, puntuaciones     benchmarks, Easter eggs, jefes, key items, par times, recompensas internas.</li> <li>Investigaci\u00f3n 2: Checa/testea que los dise\u00f1os sean posibles.</li> <li>Memoria 1: Estima las direcciones necesarias para los logros.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#cazeria-de-memoria","title":"Cazeria de Memoria","text":"<ul> <li>Memoria 2: Busca valores necesarios en memoria.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#diseno-de-logros","title":"Dise\u00f1o de Logros","text":"<ul> <li>Balance 1: Balancea el set de acuerdo a la distribuci\u00f3n de dificultad, remueva o re dise\u00f1a eso que no encaja.</li> <li>Logros 2: Construye la lista, pasa los logros completos a unofficial (no es necesario).</li> <li>Memoria 3: Busca las soluciones necesarias, dependiendo la memoria del juego.</li> <li>Logros 3: A\u00f1ade nuevas ideas as\u00ed como vengan.</li> <li>Logros 4: Re-trabaja o remueve ideas que son imposibles.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#pre-lanzamiento-pasos-finales","title":"Pre-lanzamiento Pasos Finales","text":"<ul> <li>T\u00edtulos &amp; Descripciones: Finalizalos</li> <li>Bugs 1: Testea logros para encontrar bugs, puedes usar/grabar v\u00eddeos tambi\u00e9n.</li> <li>Pagina del Juego: Actualizar. Icono del Juego, im\u00e1genes, informaci\u00f3n, recursos, paginas similares.</li> <li>Tablas de Clasificaci\u00f3n (opcional): Codificalas</li> <li>Rich presence: Codificala</li> <li>Badges: Crealos</li> </ul>"},{"location":"Set-Development-Roadmap-es/#lanzamiento","title":"Lanzamiento","text":"<ul> <li>Logros 7: P\u00e1salos a core</li> <li>Puntos: Balancealos de acuerdo al m\u00e1ximo de tu set</li> <li>Ordenar Logros: Hazlo</li> <li>Post del Foro: Haz el anuncio</li> </ul>"},{"location":"Set-Development-Roadmap-es/#post-lanzamiento","title":"Post-Lanzamiento","text":"<ul> <li>Bugs 2: Arregla esos que vengan.</li> <li>Balance 2: Re-balancea la dificultad del set de acuerdo a la retroalimentaci\u00f3n.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 13:48] eldexterr:</code> Created Set Development Roadmap es (markdown)</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/","title":"Roteiro de Desenvolvimento de um Set de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Set Development Roadmap</p> <p>O texto seguinte \u00e9 um roteiro detalhado da maioria das coisas que voc\u00ea deveria considerar ao fazer um conjunto de conquistas. N\u00e3o \u00e9 necess\u00e1rio seguir exatamente isso, mas serve como um guia.</p>"},{"location":"Set-Development-Roadmap-pt_BR/#pesquisa-inicial","title":"Pesquisa Inicial","text":"<ul> <li>Manual do Jogo: Analise</li> <li>Game Faqs: Leia / Cheque</li> <li>Trapa\u00e7as: Procure, anote</li> <li>Longplay: Analise / Assista</li> <li>Sets Semelhantes: Compare, anote as id\u00e9as favoritas</li> <li>Partimes: Cheque se eles existem</li> <li>Speedruns: Cheque se eles existem</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#design-conceitual","title":"Design Conceitual","text":"<ul> <li>Conquista 1: Uma chuva de id\u00e9ias, incluindo id\u00e9as de sets similares, manuais, etc.<ul> <li>Notas de segredos, progressos, eventos-chaves, colecion\u00e1veis, placares,   benchmarks, Easter Eggs (segredos), chaves, itens, recompensas internas</li> </ul> </li> <li>Pesquisa 2: Checar / Testar se os projetos s\u00e3o possiveis.</li> <li>Mem\u00f3ria 1: Estimar endere\u00e7os necess\u00e1rios para as conquistas.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#cacar-memorias","title":"Ca\u00e7ar Mem\u00f3rias","text":"<ul> <li>Mem\u00f3ria 2:. Procure por endere\u00e7os de mem\u00f3ria necess\u00e1rios</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#design-de-conquistas","title":"Design de Conquistas","text":"<ul> <li>Balan\u00e7a 1: Balancear a dificuldade do set, remover ou redesenhar    aqueles que n\u00e3o se encaixam.</li> <li>Conquistas 2: Construa a Lista, empurre-a inteira para o unofficial (n\u00e3o-oficial) (n\u00e3o \u00e9 obrigat\u00f3rio).</li> <li>Mem\u00f3ria 3: Procure por solu\u00e7\u00f5es perdidas, dependendo da mem\u00f3ria do jogo.</li> <li>Conqusitas 3: Adicionar id\u00e9ias conforme elas veem.</li> <li>Conquistas 4: Retrabalhe ou remova id\u00e9as que s\u00e3o impossiveis.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#pre-lancamento-passos-finais","title":"Pr\u00e9-lan\u00e7amento - Passos Finais","text":"<ul> <li>Titulos &amp; Descri\u00e7\u00f5es: Finalize</li> <li>Bugs 1: Teste conquistas por bugs, Fa\u00e7a / Use poss\u00edveis Movies</li> <li>P\u00e1gina do Jogo: Atualize o \u00edcone do jogo, images, informa\u00e7\u00e3o, recursos, jogos similares.</li> <li>Leaderboards (opcional): C\u00f3digo</li> <li>Rich presence: C\u00f3digo</li> <li>Badges (\u00cdcones): Crie</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#lancamentos","title":"Lan\u00e7amentos","text":"<ul> <li>Conquistas 7: Mova para o Core</li> <li>Pontos: Distribua os pontos de acordo com a dificuldade</li> <li>Ordem do set: Fa\u00e7a</li> <li>Post no Forum: Fa\u00e7a o anunciamento</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#apos-lancamento","title":"Ap\u00f3s Lancamento","text":"<ul> <li>Bugs 2: Corrigir aqueles que vierem.</li> <li>Balan\u00e7a 2: Reequilibre a dificuldade do set baseado no feedback.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 16:23] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:22] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:17] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:15] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:04] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 13:18] KingDice001:</code> Created Set Development Roadmap pt_BR (markdown)</li> </ul>"},{"location":"Set-Development-Roadmap/","title":"Set Development Roadmap","text":"<p>The following is a detailed road-map of most things you would want to consider while making an achievement set. It's not required to follow this exactly but is meant as a guide.</p>"},{"location":"Set-Development-Roadmap/#initial-research","title":"Initial Research","text":"<ul> <li>Game manual: Review</li> <li>Game Faqs: Read/check</li> <li>Game Cheats: Find, note</li> <li>Longplay: Review/watch</li> <li>Similar sets: Compare, note favorite ideas</li> <li>Partimes: check if they exist</li> <li>Speedruns: check if they exist</li> </ul>"},{"location":"Set-Development-Roadmap/#conceptual-design","title":"Conceptual Design","text":"<ul> <li>Achievements 1: Brainstorm, include ideas from similar sets, manual, etc.     - Note secrets, progress, key events, collectibles, scores      benchmarks, Easter eggs, bosses, key items, par times, internal rewards.</li> <li>Research 2: Check/test that designs are possible.</li> <li>Memory 1: Estimate needed addresses for achievements.</li> </ul>"},{"location":"Set-Development-Roadmap/#memory-hunt","title":"Memory hunt","text":"<ul> <li>Memory 2: Search for needed memory addresses.</li> </ul>"},{"location":"Set-Development-Roadmap/#achievement-design","title":"Achievement Design","text":"<ul> <li>Balance 1: Balance set for difficulty distribution, remove or redesign    those that don't fit.</li> <li>Achievements 2: Build the list, push complete to unofficial (not required).</li> <li>Memory 3: Search for solutions missing, depending on the game's memory.</li> <li>Achievements 3: Add new ideas as they come.</li> <li>Achievements 4: Rework or remove ideas that are impossible.</li> </ul>"},{"location":"Set-Development-Roadmap/#pre-release-final-steps","title":"Pre-release Final steps","text":"<ul> <li>Titles &amp; Descriptions: Finalize</li> <li>Bugs 1: Test achievements for bugs, possibly make/use movies.</li> <li>Game page: Update. Game icon, images, info, resources, similar games.</li> <li>Leaderboards (optional): Code</li> <li>Rich presence: Code</li> <li>Badges: Create</li> </ul>"},{"location":"Set-Development-Roadmap/#release","title":"Release","text":"<ul> <li>Achievements 7: Push to core</li> <li>Points: Balance to your cap</li> <li>Ordering: Do it</li> <li>Forum post: Make announcement</li> </ul>"},{"location":"Set-Development-Roadmap/#post-release","title":"Post Release","text":"<ul> <li>Bugs 2: Fix those that come.</li> <li>Balance 2: Re-balance set difficulty based on feedback.</li> </ul>"},{"location":"Set-Development-Roadmap/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-08 10:57] meleu:</code> fix markdown</li> <li><code>[2018-02-17 18:08] Kvon:</code> Updated Set Development Roadmap (markdown)</li> <li><code>[2018-01-29 13:35] meleu:</code> tagged Rich Presence as optional</li> <li><code>[2017-11-27 05:42] meleu:</code> format fix</li> <li><code>[2017-11-26 06:43] meleu:</code> cosmetic</li> <li><code>[2017-11-26 06:31] meleu:</code> improved markdown formatting</li> <li><code>[2017-11-26 00:32] Kvon:</code> added preface, changed title from \"Sample Set Development Roadmap\"</li> </ul>"},{"location":"Set-Plagiarism/","title":"Set Plagiarism","text":"<p>As developers, our goal is to give every set we develop its own unique achievement set when possible. Sometimes we end up reusing an idea or two that another developer already used for their own set. Being an open community, sharing and building on others ideas is encouraged, however, intentionally taking someone else\u2019s work and applying it to your own set is prohibited and disrespectful to the work of the original Developer. If a set has been copied or copy/pasted, it will be grounds for demotion until the issue is remedied.  This applies to RetroAchievement sets and third-party platform achievement sets like Xbox Live, PSN, Steam, and other similar services.  If you are concerned about your set breaking these guidelines, just submit an inbox message to DevCompliance on the site and we will take a look at it.</p>"},{"location":"Set-Plagiarism/#unacceptable-plagiarism","title":"Unacceptable Plagiarism","text":""},{"location":"Set-Plagiarism/#iconsbadges","title":"Icons/Badges","text":"<p>Achievement and mastery badges need to be unique from other sets.  Slightly modifying a badge or putting a watermark over an existing badge is not acceptable unless it\u2019s a bonus/subset mastery badge.  The difference must be obvious from a zoomed out side by side comparison of the badges.  Using any copyrighted badges from official sets is prohibited.</p>"},{"location":"Set-Plagiarism/#titles","title":"Titles","text":"<p>Achievement titles should be unique from other sets. This may not always be possible when working on games that have ports for multiple systems. Generic titles and titles based on the in-game contents are both allowed. For example, Green Hills Zone is the first level of Sonic the Hedgehog on the Mega Drive, Master System, and Game Gear ports. Additionally, the level shows up in later entries of the Sonic series. As such, the achievement title \u201cGreen Hills Zone\u201d would be acceptable in all these sets.</p>"},{"location":"Set-Plagiarism/#design","title":"Design","text":"<p>The design of an achievement is open to the community.  You can use an idea from other sets so long as the achievement badge and title differ.  However, an exact copy of the achievement list from another set is prohibited.</p>"},{"location":"Set-Plagiarism/#acceptable-copying","title":"Acceptable Copying","text":""},{"location":"Set-Plagiarism/#descriptions","title":"Descriptions","text":"<p>Achievement descriptions do not have to be unique.  Descriptions need to be clear instructions of how to earn an achievement so variations on a description may make the achievement confusing.  There are only so many ways to say \u201cBeat the game without dying.\u201d</p>"},{"location":"Set-Plagiarism/#rich-presenceleaderboards","title":"Rich Presence/Leaderboards","text":"<p>Copying Rich Presence and Leaderboards are allowed.  When copying a Rich Presence you should note the original author at the top by adding a line: <code>// RP By Original Dev</code></p>"},{"location":"Set-Plagiarism/#logic","title":"Logic","text":"<p>Copying the logic of another achievement is acceptable. Developers are encouraged to look at how other sets are coded and incorporate it into their own sets.</p>"},{"location":"Set-Plagiarism/#self-plagiarism","title":"Self-Plagiarism","text":"<p>You are allowed to copy anything you created from one set to another set.  However, it is preferable to let another developer work on a port for set you have already created.</p>"},{"location":"Set-Plagiarism/#in-game-achievements","title":"In Game Achievements","text":"<p>Some games incorporate a set of in game achievements that were released with the game.  Any of these achievements can be used as long as they are not Unwelcome Concepts.</p>"},{"location":"Set-Plagiarism/#code-notes","title":"Code Notes","text":"<p>Code notes can be copied from another set.  Noting who did the original memory digging is good practice but not required.</p>"},{"location":"Set-Plagiarism/#giving-credit-or-copying-with-permission","title":"Giving Credit or Copying with Permission","text":"<p>Credit should be given when using one of the Acceptable Copying items listed above.  However, giving credit for one of the Unacceptable Plagiarism items is still plagiarism.  Even if the original developer has given permission to use their assets it is unacceptable to do so.  Each set should include a developers\u2019 own creative spin on existing achievements and sets.  You are not expected to reinvent the wheel, just make it your own.</p>"},{"location":"Set-Plagiarism/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-11-16 21:55] pingus:</code> remove title</li> <li><code>[2022-11-16 21:53] pingus:</code> Created Set Plagiarism (markdown)</li> </ul>"},{"location":"Setup-Guide/","title":"Setup Guide","text":"<p>WIP Page</p> <ul> <li>Emulators<ul> <li>Bizhawk</li> <li>DuckStation</li> <li>PCSX2</li> <li>RALibretro</li> <li>RAMeka</li> <li>RANes</li> <li>RAP64</li> <li>RAppleWin</li> <li>RAQUASI88</li> <li>RASnes9x</li> <li>RAVBA</li> <li>RetroArch</li> <li>WinArcadia</li> </ul> </li> <li>Cores<ul> <li>Final Burn Neo</li> <li>Flycast</li> <li>PPSSPP</li> </ul> </li> </ul>"},{"location":"Setup-Guide/#emulators","title":"Emulators","text":""},{"location":"Setup-Guide/#bizhawk","title":"Bizhawk","text":"<p>Pending</p>"},{"location":"Setup-Guide/#duckstation","title":"DuckStation","text":"<p>Pending</p>"},{"location":"Setup-Guide/#pcsx2","title":"PCSX2","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ralibretro","title":"RALibretro","text":"<p>Pending - for now, see RALibretro</p>"},{"location":"Setup-Guide/#rameka","title":"RAMeka","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ranes","title":"RANes","text":"<p>Pending</p>"},{"location":"Setup-Guide/#rap64","title":"RAP64","text":"<p>Pending</p>"},{"location":"Setup-Guide/#rapplewin","title":"RAppleWin","text":"<p>Pending</p>"},{"location":"Setup-Guide/#raquasi88","title":"RAQUASI88","text":"<p>RAQUASI88 is based on QUASI88kai, which is a fork of QUASI88 with various improvements.</p> <p>Documentation is available in the release archives, or in the repository for the project. Files that do not end with <code>.EN.TXT</code> are in Japanese only.</p> File Description QUICK-START.EN.TXT PC-8801 and QUASI88(kai) general information targeted at first-time users RAQUASI88[.EN].TXT RetroAchievements and RAQUASI88-specific information QUASI88.TXT QUASI88(kai)-specific information, presented in a digestible format MANUAL.TXT Exhaustive rundown of options and systems for QUASI88(kai), for advanced users COMPATIBILITY.TXT Game-specific options required to run or function correctly <p>The PC-8000/8800 support forum thread, as well as individual game pages and forum threads, also contain some information.</p>"},{"location":"Setup-Guide/#rasnes9x","title":"RASnes9x","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ravba","title":"RAVBA","text":"<p>Pending</p>"},{"location":"Setup-Guide/#retroarch","title":"RetroArch","text":"<p>Pending</p>"},{"location":"Setup-Guide/#winarcadia","title":"WinArcadia","text":"<p>Pending</p>"},{"location":"Setup-Guide/#cores","title":"Cores","text":""},{"location":"Setup-Guide/#final-burn-neo","title":"Final Burn Neo","text":"<p>Pending</p>"},{"location":"Setup-Guide/#flycast","title":"Flycast","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ppsspp","title":"PPSSPP","text":"<p>Pending</p>"},{"location":"Setup-Guide/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:21] televandalist:</code> Updated Setup Guide (markdown)</li> <li><code>[2023-06-05 22:19] televandalist:</code> Created Setup Guide (markdown)</li> </ul>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-es/","title":"Un Ejemplo Simple en como evitar el Abuso de Estados de Guardado","text":"<p>(Editado ya que en el dll version 0.73 esto es usualmente incorrecto)</p> <p>En este ejemplo el juego es Zooming Secretary (NES), y el logro es Great Job! - Now you can take a rest, por pasar el juego.</p> <p>En este queremos que el jugador hubiera pasado por todos los niveles y haber pasado el juego en orden para que salte el logro. Si el jugador utiliza un save state para ir directamente al ultimo mundo y terminarlo, el logro no va a salir.</p> <p>Variables (Addresses)</p> <ul> <li><code>0x06e9</code>: ID de Nivel. De 0 a 8 y 8 significa \"juego terminado\".</li> </ul> <p></p> <p>Condiciones</p> <ol> <li>Estar en el \"nivel de juego terminado\".</li> <li>El nivel fue incrementado 8 veces.</li> <li>Resetear el contador si el nivel decrementa.</li> </ol> <p>Como este juego tiene 8 niveles, el valor en la variable del ID de Nivel tiene que ser incrementado 8 veces para pasar el juego. De esta manera el jugador no puede simplemente empezar el juego, cargar un estado de guardado e ir directamente al nivel final y pasar el juego. El/ella necesita pasar por todos los niveles.</p> <p>El <code>ResetIf</code> se encuentra solo para evitar casos en el que el jugador este cargando estados de guardado y yendo hacia adelante y atr\u00e1s por todos los niveles intentando que el contador llegue a 8. Si el/ella a cargar un estado yendo a un nivel mas bajo, el contador de hits pasara a cero.</p>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-pt_BR/","title":"Exemplo Simples de Como Evitar o Abuso de Load State","text":"<p>Link para o texto em ingl\u00eas: Simple Example of How to Avoid Load State Abusing</p> <p>Neste exemplo, o jogo \u00e9 Zooming Secretary (NES), e o Achievement \u00e9 Great Job! - Now you can take a rest, por terminar o jogo.</p> <p>Neste, queremos garantir que o jogador tenha passado por todos os n\u00edveis para vencer o jogo para ganhar o achievement. Se o jogador usar um save state para ir diretamente ao \u00faltimo est\u00e1gio e finaliz\u00e1-lo, o achievement n\u00e3o aparecer\u00e1.</p> <p>Endere\u00e7os</p> <ul> <li><code>0x06e9</code>: level ID. Do 0 ao 8. O 8 significa \"fim de jogo\".</li> </ul> <p></p> <p>Condi\u00e7\u00f5es</p> <ol> <li>No \"game finished level\".</li> <li>O level aumentou 8 vezes.</li> <li>Reset o contador se o level diminuir.</li> </ol> <p>Como este jogo tem 8 leveis, o valor no endere\u00e7o de identifica\u00e7\u00e3o (ID address) de n\u00edvel deve ser aumentado 8 vezes para vencer o jogo. Desta forma, um jogador n\u00e3o pode simplesmente iniciar o jogo, carregar (load game) para ir diretamente ao \u00faltimo n\u00edvel e depois vencer o jogo. Ele / ela precisa percorrer todos os n\u00edveis.</p> <p>O <code>ResetIf</code> est\u00e1 aqui apenas para evitar o caso em que o jogador continua carregando states (load state) indo para frente e para tr\u00e1s entre os n\u00edveis fazendo o contador de hits ser 8. Se ele / ela carrega um estado (load) indo para um n\u00edvel mais baixo, o contador de visitas vai para zero.</p>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:07] KingDice001:</code> Updated Simple Example of How to Avoid Load State Abusing pt_BR (markdown)</li> <li><code>[2018-03-25 11:51] KingDice001:</code> Updated Simple Example of How to Avoid Load State Abusing pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Simple Example of How to Avoid Load State Abusing.pt_BR (markdown)</li> </ul>"},{"location":"Site-Change-Log/","title":"Site Change Log","text":""},{"location":"Site-Change-Log/#22-december-2017","title":"22-December-2017","text":""},{"location":"Site-Change-Log/#site-update","title":"Site update","text":"<ol> <li>Untracked status has been added as a possible user status. Untracked players do not show up in the global ranking. Instead of banning players who are found to be cheating they can be given the status of untracked. Also players who don't want to show up in the global rankings can also request this status, given by admin.</li> </ol>"},{"location":"Site-Change-Log/#16-december-2017","title":"16-December-2017","text":""},{"location":"Site-Change-Log/#emulators-update-v0068","title":"Emulators Update [v0.068]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x </p>"},{"location":"Site-Change-Log/#general-changes","title":"General Changes","text":"<ol> <li>Game Titles with special characters such as <code>~</code> or <code>[</code> no long appear at the start of the entry database but at the end.</li> </ol> <p>Rich Presence:</p> <ol> <li>Parse Rich Presence has been changed into Rich Presence monitor. This will actively display rich presence </li> <li>The Rich Presence Monitor also supports much more unicode </li> <li>Rich presence is displayed every 2 minutes instead of every 10. </li> </ol> <p>Linking: </p> <ol> <li>Only Developers and Admin are allowed to link ROMs to game entries. This is to prevent unsupported ROM versions which will cause achievement errors and to prevent some forms of cheating. </li> </ol>"},{"location":"Site-Change-Log/#developer-changes","title":"Developer Changes","text":""},{"location":"Site-Change-Log/#achievement-sets-window","title":"Achievement Sets Window:","text":"<ol> <li>Button layout reworked and compressed </li> <li>Activate All has been added to Local Achievements </li> <li>Buttons removed: Vote Up, Vote Down, Goto Web page, Close </li> </ol>"},{"location":"Site-Change-Log/#renames","title":"Renames:","text":"<ol> <li>Fetch Latest \u21d2 Refresh from Server </li> <li>Reset Achieved Status, Activate \u21d2 Activate Selected </li> <li>Save Local \u21d2 Save All Local </li> <li>Achievement Processing Active? \u21d2 Processing Active </li> <li>Achievements found \u21d2 Num Achievements Found </li> <li>In local Commit Selected \u21d2 Promote to Unofficial </li> </ol>"},{"location":"Site-Change-Log/#bugs-fixes","title":"Bugs Fixes:","text":"<ol> <li>Changing the points value of an achievement even after it's been updated the points value in the Achievements window does not update. </li> <li>Activating an achievement and then making changes to it changes it's active status display from Yes to No even though it is still active. </li> <li>After committing a change and then fetching latest or reloading the rom the changes made are no longer visible. </li> <li>Other \"under the hood\" bug fixes.</li> </ol>"},{"location":"Site-Change-Log/#1-december-2017","title":"1-December-2017","text":""},{"location":"Site-Change-Log/#emulators-update-v0067","title":"Emulators Update [v0.067]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x</p>"},{"location":"Site-Change-Log/#developer-changes_1","title":"Developer Changes","text":"<p>Memory Inspector:</p> <ol> <li>You can now scroll with your mouse-wheel in the memory viewport. </li> <li>The memory viewer cursor no longer defaults to line 5, instead you are allowed to move it within a current viewport freely.  When you move past the top or bottom the view will scroll up or down and keep the cursor position on the top most or bottom most line. </li> <li>In the memory viewport hitting page down will go down 1 page depending on how many addresses you have in view. Previously it would only go down 5 lines. </li> <li>In the memory viewport while selecting an address from the \"Watching\" it will put the selected address in focus on the center of the viewport relative to the length of the viewport. </li> <li>While putting values into the Mem Viewport you can wrap around the right side instead of getting stopped at 0xf of that line. This allows for quicker corrupting, which can sometimes be useful for finding addresses. </li> <li>When deleting a note in the Mem Viewport the selected stays at current address instead of going to 0x0. </li> <li>Notes window has been extended to 5 from 3 lines. </li> <li>Notes window now has word wrap and accept line returns greater than 3. </li> <li>View Notes Button has been added below Delete. </li> <li>Memory Search Range has been added allowing for Custom Range System RAM and Game RAM. </li> <li>Searching for hex values in Given Value is allowed with the prefix 0x. </li> </ol> <p>Achievement Editor:</p> <ol> <li>\"Clone selected\" achievement has been replaced with \"Copy\" and \"Paste\" buttons.  You are now able to copy and paste multiple selected requirements within an achievement, to an alt group or to another achievement! </li> <li>\"Delete Selected\" will now delete ALL selected achievements instead of just one at a time.(edited) </li> </ol> <p>Rich Presence:</p> <ol> <li>No longer displays \"Unknown\". It just leaves a blank non-space. Devs this means you don't need to sweat as much about about those knowing every value state of an address in RPS. </li> <li>If someone is playing a set without achievement or a Rich Presence script it the Rich Presence will say \"Playing [game name]\".</li> </ol>"},{"location":"Site-Change-Log/#7-november-2017","title":"7-November-2017","text":""},{"location":"Site-Change-Log/#site-update_1","title":"Site Update","text":"<p>Time stamps on user, game pages and in many places now show the year. </p>"},{"location":"Site-Change-Log/#emulators-update-v0066","title":"Emulators Update [v0.066]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x </p>"},{"location":"Site-Change-Log/#general-changes_1","title":"General Changes","text":"<ul> <li>More anti-cheat measures were included. </li> <li>Soft IPS patching is removed in the listed emulators. Caused some incompatibilities. </li> <li>Issue with leaderboards popping twice is resolved. </li> </ul>"},{"location":"Site-Change-Log/#developer-changes_2","title":"Developer Changes","text":"<ul> <li>Achievement Editor window is slightly extended. </li> <li>Scroll bar retains position when editing longer achievements. </li> <li>Issue with uploading broken badges is fixed. </li> </ul>"},{"location":"Site-Change-Log/#30-october-2017","title":"30-October-2017","text":""},{"location":"Site-Change-Log/#site-update_2","title":"Site Update","text":"<ol> <li>Password Reset is fixed and working. Now if you forget your password you can have a password reset link emailed to you: http://retroachievements.org/resetPassword.php</li> </ol>"},{"location":"Site-Change-Log/#6-october-2017","title":"6-October-2017","text":""},{"location":"Site-Change-Log/#site-update_3","title":"Site Update","text":"<p>Started the log</p> <ol> <li>Rich Presence has been fixed:  Now online shows all online players. Developers are able to create, edit and save rich presence. Number of currently online is no long visible by online players. Active players shows a time stamp of last updated.</li> </ol>"},{"location":"SubSource-Flag-es/","title":"Bandera SubSource","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>El <code>SubSource</code> puede ser seleccionado en la columba de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Funciona similarmente a <code>Add Source</code>, pero una bandera <code>Sub Source</code> convierte el valor en memoria en un valor negativo.</p> <p>Nota 1: <code>Sub Source</code> NO es una bandera de subtraccion. Solo convierte el valor en negativo.</p> <p>Nota 2: La ultima linea (sin el <code>Add Source</code> o <code>Sub Source</code>) aun se agrega a la comparativa final (Es una condicion que se tiene que cumplir). </p> <p>Utlizando este ejemplo de uso de un <code>AddSource</code>, si lo remplazamos con un <code>Sub Source</code> y con los mismos valores (<code>valor(0x8010) = 1</code> and <code>valor(0x8020) = 2</code>), la comparacion seria <code>-1 + 2 &gt; 0</code>, o <code>1 &gt; 0</code>.</p>"},{"location":"SubSource-Flag-es/#utilizando-subsource-para-contar-incrementos-especificos","title":"Utilizando SubSource para Contar Incrementos Especificos","text":"<p><code>SubSource</code> tambien puede ser utilizado para rastrear incrementos especificos en una variable. La condicion que se muestra abajo dice que el actual valor en la variable <code>0x0080dc</code> menos el valor en el antiguo fotograma (Delta Frame) en la misma direccion deberia de ser igual a <code>2</code>. Efectivamente, esto significa que la condicion es verdadera cualquier vez que el valor en <code>0x0080dc</code> se incremente exactamente sobre dos.</p> <p></p>"},{"location":"SubSource-Flag-es/#buscando-un-resultado-negativo","title":"Buscando un resultado negativo","text":"<p>Si el resultado en tu operacion con Sub Source es un numero negativo, es posible buscarlo. A si es como se representan los numeros negativos:</p> <ul> <li><code>-1</code> es <code>0xFFFFFFFF</code></li> <li><code>-2</code> es <code>0xFFFFFFFE</code></li> <li><code>-3</code> es <code>0xFFFFFFFD</code></li> <li><code>-4</code> es <code>0xFFFFFFFC</code></li> <li><code>-5</code> es <code>0xFFFFFFFB</code></li> <li><code>-6</code> es <code>0xFFFFFFFA</code></li> <li><code>-7</code> es <code>0xFFFFFFF9</code></li> <li>y asi sucesivamente...</li> </ul> <p>A si que, vamos a decir que quieres buscar si el <code>valor(0x8010) = 1</code> menos el <code>valor(0x8020) = 2</code> es igual a <code>-1</code>. Asi es como le harias:</p> <p></p> <p>Esto significa <code>-2 + 1 = -1</code>, que es verdad.</p> <p>Avanzado: tambien es posible utilizar directamente numeros negativos en la columna de la izquierda con tus operaciones Sub/Add Source. Para hacerlo, recuerda cambiar el Tipo (Type) de <code>Mem</code> a <code>Value</code>, y utilizar los valores explicados arriba, como <code>0xFFFFFFE5</code> para <code>-27</code>, y <code>0xFFFFFFE3</code> para <code>-29</code>, por ejemplo:</p> <p></p> <p>Esto significa <code>-2 + (-27) = -29</code>, que es <code>-2 - 27 = -29</code>, el cual es cierto.</p> <p>De todos modos ten cuidado, si utilizas numeros negativos en una bandera con Sub Source, va a resultar en un doble negativo, convirtiendo los numeros de nuevo a positivos. Hecha un vistazo:</p> <p></p> <p>Esto significa <code>- (-2) + (-27) = -29</code>, que es <code>2 - 27 = -29</code>, que es <code>-25 = -29</code>, el cual es falso.</p>"},{"location":"SubSource-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:32] meleu:</code> fix broken link</li> <li><code>[2019-03-12 15:01] meleu:</code> Updated SubSource Flag ES (markdown)</li> </ul>"},{"location":"SubSource-Flag/","title":"SubSource Flag","text":"<p>Note: most likely this technique is not needed for simple games. So, it's not mandatory for jr-devs.</p> <p>The <code>SubSource</code> can be chosen in the Flag column of the Achievement Editor</p> <p>Works similarly to <code>Add Source</code>, but the <code>Sub Source</code> flag subtracts the calculated value from the accumulator.</p> <p>Because it subtracts from the accumulator, <code>SubSource A, B</code> is actually <code>B - A</code>.</p>"},{"location":"SubSource-Flag/#simple-example","title":"Simple example","text":"ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>In this example the value in <code>0x8010</code> will be subtracted from the value in <code>0x8020</code> and the comparison will check is if this sum is greater than four.</p> <p>If the value in <code>0x8010</code> is <code>1</code> and the value in <code>0x8020</code> is <code>2</code>, the comparison will be <code>-1 + 2 &gt; 4</code>, or <code>1 &gt; 4</code>.</p>"},{"location":"SubSource-Flag/#using-subsource-to-count-specific-increments","title":"Using SubSource to Count Specific Increments","text":"<p><code>SubSource</code> can also be used to track specific increases in addresses. The conditions below states that the current value in address <code>0x80dc</code> minus the value in the previous frame in the same address must be equal <code>2</code>. Effectively, this means that the condition is true whenever the value in address <code>0x80dc</code> increases by exactly two.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Delta 8-bit 0x80dc 2 Mem 8-bit 0x80dc = Value 0x02 0 (0)"},{"location":"SubSource-Flag/#checking-for-a-negative-result","title":"Checking for a negative result","text":"<p>The accumulator and all logic performed is limited to an unsigned 32-bit number. If the total drops below 0, it underflows, resulting in a very large positive number. Here's the representation for the first few negative numbers:</p> <ul> <li><code>-1</code> is <code>0xFFFFFFFF</code></li> <li><code>-2</code> is <code>0xFFFFFFFE</code></li> <li><code>-3</code> is <code>0xFFFFFFFD</code></li> <li><code>-4</code> is <code>0xFFFFFFFC</code></li> <li><code>-5</code> is <code>0xFFFFFFFB</code></li> <li><code>-6</code> is <code>0xFFFFFFFA</code></li> <li><code>-7</code> is <code>0xFFFFFFF9</code></li> <li>and so on...</li> </ul> <p>So, if you wanted to see if a value was 1 less than another value, you could write:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8020 2 Mem 8-bit 0x8010 = Value 0xffffffff 0 (0) <p>This would be true if the value at $8010 (1) was 1 less than the value at $8020 (2): <code>1 - 2</code> = <code>-1</code> = <code>0xFFFFFFFF</code>.</p> <p>However, you should swap the conditions to make it easier to read (<code>B - A = -1</code>) is the same as (<code>A - B = 1</code>):</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 = Value 1 0 (0) <p>This evaluates <code>-1 + 2 = 1</code>, which is true.</p>"},{"location":"SubSource-Flag/#subtracting-negative-constants","title":"Subtracting negative constants","text":"<p>It is also possible to use straight negative numbers in the left section of your Sub/Add Source operations. To do so, remember to change the Type from <code>Mem</code> to <code>Value</code>, and use the values as explained above, such as <code>0xFFFFFFE5</code> for <code>-27</code>, and <code>0xFFFFFFE3</code> for <code>-29</code>, for example:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 32-bit 0x8020 2 Value 0xffffffe5 = Value 0xffffffe3 0 (0) <p>If $8020 contains 2, this would be true. <code>-2 + (-27) = -29</code>, which is <code>-2 - 27 = -29</code>, which is true.</p> <p>If you use a negative number in a <code>SubSource</code> flag, it will result in a double negative, turning the number back to positive.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Value 0xfffffffe 2 Value 0xffffffe5 = Value 0xffffffe3 0 (0) <p>This means <code>-(-2) + (-27) = -29</code>, which is <code>2 - 27 = -29</code>, which is <code>-25 = -29</code>, which is false.</p>"},{"location":"SubSource-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-12-13 10:49] Jamiras:</code> \"less\" -&gt; \"minus\"</li> <li><code>[2021-11-27 08:38] Jamiras:</code> Updated SubSource Flag (markdown)</li> <li><code>[2020-01-15 08:23] meleu:</code> better example of a negative number</li> <li><code>[2019-12-31 12:14] meleu:</code> cosmetic</li> <li><code>[2019-02-17 23:42] meleu:</code> better example for \"Using SubSource to Count Specific Increments\"</li> <li><code>[2019-02-17 21:05] meleu:</code> cosmetic</li> <li><code>[2019-02-14 10:10] meleu:</code> fix broken link</li> <li><code>[2019-02-12 13:25] meleu:</code> add heading to \"Using SubSource to Count Increments\"</li> <li><code>[2019-02-12 13:18] meleu:</code> fix broken link</li> <li><code>[2019-02-12 09:37] meleu:</code> Updated SubSource (markdown)</li> </ul>"},{"location":"Subsets/","title":"Subsets","text":"<p>Advanced Developer Topic</p> <ul> <li>What are Subsets?</li> <li>Types of Subsets<ul> <li>Bonus Sets</li> <li>Multi Sets</li> <li>Challenge Runs</li> <li>DLC and Expansions</li> <li>Regional Differences</li> <li>User-Generated Content</li> </ul> </li> <li>Naming Scheme</li> <li>Approval and Claims</li> </ul>"},{"location":"Subsets/#what-are-subsets","title":"What are Subsets?","text":"<p>When browsing the list of games, you will see that some games have a <code>[Subset]</code> tag in the title. Each of these contain achievements that for some reason or another, are not available in a game's base set.  Subsets are typically home to specific types of challenge runs. They have also inherited what have been known simply as <code>[Bonus]</code> and <code>[Multi]</code> sets. </p> <p>The methods to create a subset and means to play them will change once they become a more integrated feature. As of now, they require a patch to generate a unique hash and are separate entries from the base set, so achievements must be obtained separately as well. Information on creating these patches can be obtained here.</p>"},{"location":"Subsets/#types-of-subsets","title":"Types of Subsets","text":""},{"location":"Subsets/#bonus-sets","title":"Bonus Sets","text":"<p>While Bonus sets are subject to debate amongst both players and achievement creators, the overall purpose of a bonus set is for achievements that were not fit for the base set to have a home and still be obtainable by a devoted player. Think of them as \"deluxe\" challenges. The following types of achievements are the most suitable for Bonus Sets: - Extreme Challenges: If it's generally voiced a challenge is too difficult, it's a prime candidate for a Bonus set.  However, just because the achievement(s) are possible to code does not mean they are possible to obtain; therefore, the achievement must still be obtainable. A good example of this is the infamous Mr. Perfect from Mega Man (NES), which requires the player to complete the entire game without taking damage. - Grind Sessions: If achievements involve overly long and frustrating grinds that have no meaningful purpose, they're better suited for Bonus sets. These include leveling characters to the maximum level, maxing out stats, performing a task an absurd amount of times, etc. when none of those things award the player. A good example of something grindy that awards the player, thus making it suitable for a base set, is One of a Kind from Final Fantasy IV (SNES), which requires a highly RNG-reliant grind for an item to trade for said armor. - Variety Packs - Want to do a mixture of subset ideas all within one set because you don't want to do several different subsets? Then do it and throw it in a Bonus set. An example of this is the Suikoden Bonus Set, which contains various challenge runs, rare drops, and extreme challenges within a single subset. - Showcasing of or Abuse of Glitches: Glitching can have unpredictable effects in a game's memory, which can result in unwanted behavior for some achievements, thus making them not suitable for a base set. Some examples of this are Replica from Final Fantasy VII (PlayStation) and Rare Candy Addiction from Pokemon - Red and Blue Versions (Game Boy.</p>"},{"location":"Subsets/#multi-sets","title":"Multi Sets","text":"<p>This one is simple. If an achievement requires input from more than one player in order to unlock it, then it cannot be in the base set. </p>"},{"location":"Subsets/#challenge-runs","title":"Challenge Runs","text":"<p>While many base sets include plenty of challenges, developers have the option to add challenges that last the duration of a game's playthrough to a Subset. These are typically self-imposed challenges that go against how a game is normally played. Examples: - Chrono Trigger - No Level Up - requires players to complete the game without ever leveling up their characters.  - EarthBound - Rare Drops - requires players to obtain all the rare drops from enemies. - Final Fantasy - Solo Class - requires players to complete the game using only one character class, but they need to do it with every class to master the set. - Pokemon - Professor Oak Challenge - There are several of these so far! This challenge requires players to catch and/or evolve every Pokemon possible between major story points in the game. - Trails in the Sky FC - NG Nightmare - requires players to obtain 100% completion in a single, NG (New Game) playthrough on the Nightmare difficulty setting, as opposed to doing it on NG+ with carryovers. </p>"},{"location":"Subsets/#dlc-and-expansions","title":"DLC and Expansions","text":"<p>Not very common, but will become more common as our console support expands. Achievements in these sets are exclusive to a game's downloadable content or expansion pack(s). Examples: - Arc the Lad 2 - Arc Arena: Monster Tournament - released as a bonus disc in the Arc the Lad Collection, this requires save data from Arc the Lad 2 in order to play. - F-Zero X - Expansion Kit - achievements are for content exclusive to the 64DD expansion of the game. - Return Fire - Maps o' Death - a separate release that provides additional maps to the game. It requires save data from the original game in order to play.</p>"},{"location":"Subsets/#regional-differences","title":"Regional Differences","text":"<p>If a regional variant of a game does not have enough differences to warrant a \"full\" set, but you don't want to include it with the base set due to interference with base challenges, you can make a Subset to showcase the differences. </p>"},{"location":"Subsets/#user-generated-content","title":"User-Generated Content","text":"<p>If a game has a feature that allows players to make their own content such as custom levels, then a subset would be an acceptable place to include said content. Examples: - Irritating Stick - IrRAtating Custom Courses - features custom stages made by various RA community members. - Tony Hawk's Underground - RAdical Custom Goals/Gaps - Custom goals and gaps made by various RA community members.</p>"},{"location":"Subsets/#naming-scheme","title":"Naming Scheme","text":"<p>To prevent players from getting confused, there is a specific naming scheme required for all Subsets: - Bonus Sets: Must have <code>[Subset - Bonus]</code> following the base game title. For example: <code>Castlevania [Subset - Bonus]</code> and <code>Darkwing Duck [Subset - Bonus]</code>. - Multi Sets: Must have <code>[Subset - Multi]</code> following the base game title. For example: <code>Contra [Subset - Multi]</code> and <code>Kirby 64: THe Crystal Shards [Subset - Multi]</code>. - Challenge Runs: Must have <code>[Subset - Challenge Name/Type]</code> following the base game title. For example: <code>Chrono Trigger [Subset - No Level Up]</code> and <code>Pocket Monsters Midori [Subset - Monotype Challenge]</code>. - DLC and Expansions: Must have <code>[Subset - DLC/Expansion Name</code> following the base game title. For example: <code>Return Fire - [Subset - Maps o' Death]</code> and <code>F-Zero X [Subset - Expansion Kit]</code> - User-Generated Content: While not actually required, including <code>RA</code> in the subset title has been a fun way to name the content.</p>"},{"location":"Subsets/#approval-and-claims","title":"Approval and Claims","text":"<p>The approval process and claiming of a subset will vary depending on if the subset type is pre-approved, your involvement with the base set, and whether or not you're a full developer or a junior developer:</p> Authorship\u00b9 Approval and Claiming Process Sole Author of Core Set \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 Does not require a plan and revision vote \u2022 Considered a free claim \u2074 Collaborative Author of Core Set \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 Requires a plan and revision vote? \u00a0\u00a0\u00a0\u25e6 No, if all active authors of the set approve \u00a0\u00a0\u00a0\u25e6 Yes, otherwise  \u2022 Considered a free claim \u2074 No Core Set Authorship \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 If approved, a set plan must be posted in the base set's forum topic and must go through revision voting \u2022 Is not considered a free claim \u2022 In the event that both a revision and subset plan are made for a set, both claims will count as one Junior Developer \u2022 In addition to the above cases, must first be approved by Code Reviewers <p>\u00b9 In the case of multiple revision authors, use the most restrictive ruleset in the table. Example: If there is a subset collaboration and any subset author is not a core set author, use the <code>No Core Set Authorship</code> rules.</p> <p>\u00b2 To Contact Developer Compliance, send them a site message here and replace the <code>[Game Name]</code> and <code>[Subset Name]</code> in the subject line with the game name and desired subset name.</p> <p>\u00b3 The following are pre-approved subset types and therefore do not require contacting Developer Compliance: - Bonus - Multi - DLC/Expansions - Glitch Showcases - Regional Differences - User-Generated Content - Challenge Run: Low Level Game/No Leveling Runs - Challenge Run: Solo Class/Monotype Runs - Challenge Run: Checkpoint Challenges, such as Professor Oak Challenges - Challenge Run: Perma-Death Challenges, such as Nuzlocke Challenges</p> <p>\u2074 For now, an admin must be contacted via Discord or by messaging RAdmin to mark a claim as free. As a courtesy, please only request this if you actually need the claim slot or if you expect a long development period.</p>"},{"location":"Subsets/#notes","title":"Notes","text":"<ul> <li>In the case of multiple revision authors, use the most restrictive ruleset in the table. Example: If there is a subset collaboration and any subset author is not a core set author, use the 'no core set authorship' rules.</li> </ul>"},{"location":"Subsets/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-10-30 13:00] The Mystical One:</code> Fixes formatting in the pre-approved list.</li> <li><code>[2023-07-11 10:55] The Mystical One:</code> Add in footnote for when there are multiple subset authors, which table entry should be used.</li> <li><code>[2023-06-30 13:45] The Mystical One:</code> Cleaned up the table for collaborative core set author of a subset, which implied that other authors had to approve, and so thus could stealthily veto. Current wording should be clear that collaborative author disapproval now merely means you have to go through the plan/revision vote route.</li> <li><code>[2023-06-23 11:21] The Mystical One:</code> Fixed spacing in pre-generated subject line on DevCompliance contact link.</li> <li><code>[2023-06-23 11:16] The Mystical One:</code> Added links to contact Developer Compliance with pre-generated subject to be edited.</li> <li><code>[2023-05-09 04:03] televandalist:</code> Added info about User-Generated Content to multiple sections. Also added it to the list of pre-approved subset types</li> <li><code>[2023-04-19 23:49] televandalist:</code> Moved the \"how to create a subset patch\" info to RAPatches' wiki</li> <li><code>[2023-03-13 07:48] televandalist:</code> Typo fix</li> <li><code>[2023-03-13 07:42] televandalist:</code> Fix formatting, hopefully...</li> <li><code>[2023-03-13 07:33] televandalist:</code> Rewrote the Approval and Claiming section again. Turned the info into a table so relevant points are easier to find.</li> </ul>"},{"location":"System-X-wen/","title":"System X wen","text":"<p>This article was originally published in the RANews - November/2020</p>"},{"location":"System-X-wen/#intro","title":"Intro","text":"<p>There seems to be a lot of speculation on what the next available systems to support achievements will be. With the recent announcement of a PS2 core, there have been a lot of questions regarding if/when it will be supported. If you're only interested in the answer to that question, skip to the end of this article. But if you want to understand what exactly is needed to add support for a new system, keep reading.</p>"},{"location":"System-X-wen/#requirements","title":"Requirements","text":"<p>These are the things that are required in order to add RetroAchievements support for a new system:</p> <ol> <li>Emulation (preferably a libretro core).<ul> <li>The core must expose memory.</li> <li>The core must function in RALibretro.</li> </ul> </li> <li>Unique identification of games.</li> <li>Server support.</li> </ol>"},{"location":"System-X-wen/#step-1-emulation","title":"Step 1: Emulation","text":"<p>The first step is, obviously, to have an emulator for the system to be supported.</p> <p>In the early days of RetroAchievements we used standalone emulators - one for each system. Keeping all those emulators bug-free and up-to-date requires a lot of effort and we don't have enough programmers involved on this front.</p> <p>It's currently preferred to use a libretro core for emulation. This way the core developers can push new features and we can focus only on the achievement functionality. Cores can be updated and released without any additional effort for us.</p> <p>Another big advantage is that libretro cores also function in RetroArch, which allows RetroAchievements to be earned on many platforms (the standalone emulators were all Windows-only applications).</p> <p>Managed by: libretro core developers.</p>"},{"location":"System-X-wen/#step-1a-exposed-memory","title":"Step 1a: Exposed Memory","text":"<p>As achievement triggers are a series of conditions that watch for things that happen in the emulated RAM,  another requirement is access to the system's RAM.</p> <p>Without exposed memory, the Memory Inspector appears blank and achievement creators are unable to create achievements.</p> <p>Additionally, as RetroAchievements only reads the memory once per frame, some systems which heavily leverage paged memory have to provide some way to access the entire memory, not just the current page of memory.</p> <p>Managed by: libretro core developers with some interaction with RetroAchievements developers.</p>"},{"location":"System-X-wen/#step-1b-ralibretro","title":"Step 1b: RALibretro","text":"<p>The core must function in RALibretro, as that is where the achievement developers will identify the important pieces of memory and create the achievements.</p> <p>This is usually only an issue if the core relies on some functionality not yet implemented in RALibretro (like the recently added keyboard and OpenGL 3D support), but some issues are caused by the RALibretro implementation being sufficiently different from the RetroArch implementation. Unless the core can be modified to not require the missing functionality, it cannot be supported until RALibretro is updated.</p> <p>This page lists the status of each core the last time they were tested.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#step-2-game-identification","title":"Step 2: Game Identification","text":"<p>We must be able to uniquely identify the games for the system.</p> <p>We use a method called MD5, which scans the game's file and generates a number that we usually call as \"hash\". With this number it's possible to confirm if two copies of a file are identical, which makes it possible to ensure the player is using a ROM that the achievements were designed or tested against.</p> <p>For most systems, we are able to just hash the entire ROM file, minus any header information. For larger games (particularly those on CD or DVD) we only hash what we consider to be the most important data to minimize load times. More information on how we identify games can be found here.</p> <p>For systems with writable media (mostly home computers), we have to make sure that we don't hash any files that may be modified by the game itself. Systems that write to the game file must treat the original disk file as readonly and only write changes to a copy of the disk. If the core/emulator modifies the disk file, it can no longer be identified and cannot be considered viable for achievements.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#step-3-configure-the-web-server","title":"Step 3: Configure the Web Server","text":"<p>In order to support a new system, the RetroAchievements web server must be properly configured to accept new game and achievement entries for that system.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#when-will-ra-support-system-x","title":"When will RA support System X?","text":"<p>This page lists the status of each core the last time they were tested.</p>"},{"location":"Systems-Memory-Mapping/","title":"Work in Progress","text":"<p>This page details how the memory of each supported system is mapped.</p> <p>Memory banks as registered in the RA emulators are defined here.</p>"},{"location":"Systems-Memory-Mapping/#nes","title":"NES","text":"<p>Reference: https://wiki.nesdev.com/w/index.php/CPU_memory_map</p> Bank Offset Length Description 0 0x0000 0x0800 2KB internal RAM 1 0x0800 0x0800 Mirror of $0000-$07FF 2 0x1000 0x0800 Mirror of $0000-$07FF 3 0x1800 0x0800 Mirror of $0000-$07FF 4 0x2000 0x0008 PPU registers 5 0x2008 0x1FF8 Mirrors of $2000-$2008 6 0x4000 0x0018 APU and I/O registers 7 0x4018 0x0008 APU and I/O test registers 8 0x4020 0x1FE0 Cartridge data 9 0x6000 0x2000 Cartridge RAM 10 0x8000 0x8000 Cartridge ROM"},{"location":"Systems-Memory-Mapping/#snes","title":"SNES","text":"<p>https://en.wikibooks.org/wiki/Super_NES_Programming/SNES_memory_map</p>"},{"location":"Systems-Memory-Mapping/#n64","title":"N64","text":"<p>https://raw.githubusercontent.com/mikeryan/n64dev/master/docs/n64ops/n64ops%23h.txt</p>"},{"location":"Systems-Memory-Mapping/#gb","title":"GB","text":"<p>Reference: http://gameboy.mongenel.com/dmg</p> <p>The memory map reflects the CPU memory space.</p>"},{"location":"Systems-Memory-Mapping/#gbc","title":"GBC","text":"<p>The memory map is identical to the Game Boy's, with the exception of banked work RAM. The first bank is mapped to its usual location in CPU space, while banks 2-7 are appended to the end of the memory map, in the 0x10000-0x15FFF region.</p>"},{"location":"Systems-Memory-Mapping/#gba","title":"GBA","text":"<p>https://www.coranac.com/tonc/text/hardware.htm#sec-memory</p>"},{"location":"Systems-Memory-Mapping/#virtualboy","title":"VirtualBoy","text":""},{"location":"Systems-Memory-Mapping/#master-system","title":"Master System","text":"<p>Reference: http://www.codeslinger.co.uk/pages/projects/mastersystem/memory.html</p> <p>TODO: find a more reliable source.</p> Offset Length Description 0x0C000 0x02000 RAM"},{"location":"Systems-Memory-Mapping/#megadrive-genesis","title":"MegaDrive (Genesis)","text":"<p>https://en.wikibooks.org/wiki/Genesis_Programming https://wiki.megadrive.org/index.php?title=Main_68k_memory_map see also Jamiras comment here: https://github.com/RetroAchievements/RALibretro/issues/47#issuecomment-455374796</p>"},{"location":"Systems-Memory-Mapping/#gamegear","title":"GameGear","text":""},{"location":"Systems-Memory-Mapping/#atari-2600","title":"Atari 2600","text":"<p>Reference: http://www.randomterrain.com/atari-2600-memories-tutorial-andrew-davie-05.html#summary</p> Offset Length Description 0x080 0x080 RAM"},{"location":"Systems-Memory-Mapping/#atari-7800","title":"Atari 7800","text":""},{"location":"Systems-Memory-Mapping/#atari-lynx","title":"Atari Lynx","text":""},{"location":"Systems-Memory-Mapping/#colecovision","title":"ColecoVision","text":""},{"location":"Systems-Memory-Mapping/#neogeo-pocket","title":"NeoGeo Pocket","text":""},{"location":"Systems-Memory-Mapping/#pcengine-turbografx16","title":"PCEngine (TurboGrafx16)","text":""},{"location":"Systems-Memory-Mapping/#pcengine-cd","title":"PCEngine CD","text":""},{"location":"Systems-Memory-Mapping/#arcade","title":"Arcade","text":""},{"location":"Systems-Memory-Mapping/#pc-8001-pc-8801","title":"PC-8001 / PC-8801","text":"<p>Reference: http://www.maroon.dti.ne.jp/youkan/pc88/memmap.html</p> <p>The memory map is based on the PC-8801 layout, but excludes graphics VRAM and extended RAM.</p>"},{"location":"Systems-Memory-Mapping/#pc-8801","title":"PC-8801","text":"Bank Offset Length Description 0 0x00000 0x10000 Main RAM 1 0x10000 0x1000 Text VRAM <p>Text VRAM is also known as high-speed RAM, and is used as a main RAM area in some titles.</p>"},{"location":"Systems-Memory-Mapping/#pc-8001","title":"PC-8001","text":"<p>Reference: http://www.cyross.com/pc8801wiki</p> <p>The entire memory space is mapped in the PC-8801 main RAM bank, but only RAM is exposed, so most of the mapped space will remain uninitialized.</p> Offset Length Description 0x08000 0x08000 RAM"},{"location":"Systems-Memory-Mapping/#apple-ii","title":"Apple II","text":"<p>Reference: http://apple2.guidero.us/doku.php/mg_notes/general/mem_map</p> <p>The memory map consists of both main and auxiliary RAM banks. Rather than mapping the CPU-accessible memory space, which can flicker at high frequencies, the RAM banks are mapped consecutively.</p> <p>Auxiliary RAM is only available on systems with 128KB of RAM (Apple IIe and up), so it will remain uninitialized on 64KB systems or when running titles that are not designed to make use of auxiliary RAM.</p> Bank Offset Length Description 0 0x00000 0x10000 Main RAM 1 0x10000 0x10000 Auxiliary RAM"},{"location":"Testing-for-Demo-Mode/","title":"Testing for Demo Mode","text":"<p>Link to original post on RetroAchievements</p> <p>One of the more annoying things that can happen is if you leave your game running, and the game awards you achievements for reaching levels you haven't reached yet. This is fairly common, as many games of the 16-bit era still had 'attract modes', and is usually a pretty easy thing to fix with the achievements. </p> <p>We are looking in the game to find something that is set when the game is in a demo mode. Either a small piece of memory set to <code>0</code>, or <code>1</code>, or <code>0xff</code>. It could be anything really.</p> <p>To start it will help to play through the game a little, and set a few save states throughout different levels of the game. And then to begin finding this 'is demo mode active' memory, we should first reset the game and wait for the demo to play.</p> <p>During when the game plays the first demo, use the Memory Inspector to start a new 8-bit test, (click <code>New 8-bit test</code>), and set the filter value to be equal to the last known value (under <code>Filter values:</code>, set to <code>==</code>), and press <code>Filter!</code> a few times. With each press, you should see the number of matches slowly become fewer, but not by much. </p> <p>Next wait til the game starts playing another demo but on a different level. When the next demo is playing, press Filter a few more times, and you'll see the candidates get smaller again. Continue to do this until you've eliminated as many candidates as you can.</p> <p>IMPORTANT: Don't forget, you only want to press filter when the game is DEFINITELY in the demo. If you press when it's on the title screen, or playing a movie, or even when fading in or out, the value might not be set. There's no real way to know; we are assuming that it will be set (or unset) when the demo itself is playing, which itself is only a fairly likely assumption. </p> <p>After viewing some or all of the demos, you will probably still have TONS of potential memory values. Here's the juicy part, that should eliminate a ton of candidates at once. Load up one of your save states where you are definitely in-game, playing and NOT in a demo.</p> <p>Now we will be filtering for \"I am NOT in a demo\". Set your filter value to not-equal <code>!=</code>, and hit <code>Filter</code> ONLY ONCE.</p> <p>At this point, the set of candidates now represent memory values that are \"values different to when a demo was playing\". Switch back to equal (=), and hit <code>Filter</code> a few more times (because we are saying 'whatever values we have, they are the same as the ones just now. The 'is demo mode' value will still be equivalent to whatever it was just now). It might help to move the character around the screen, or perform a few actions, between hitting the <code>Filter</code> button. </p> <p>Next, load up your next save state, and perform the same routine. Your number of candidates should reduce further, until you have less than 100 remaining.</p> <p>By now if you should have only a few candidates remaining. Likely values for the candidate will be 0, 1 or 0xff. If it is something else I'd recommend ignoring it, as it's not likely to be what we're looking for (but still, not impossible). For example, in Sonic the Hedgehog (Mega Drive), the address is 0xfff0, and the value is 01 when a demo is active.</p> <p>Our next step will be to verify our find. Pick one of these values and restart the game, keeping an eye on this value as the game plays the demos. Then load through each of your save states and see if it changes as you expect it to. Perhaps start a brand new game and see if it matches up correctly to the value it is when the other save states are active. Make a note of the value it is when the game is active. </p> <p>Let's say we are pretty confident we've found the memory used to say 'game is in demo mode'. We'll save this to CodeNotes by adding a description in the Memory Inspector, then clicking <code>Add Note</code>. </p> <p>Next we will use the <code>Achievements</code> dialog to find all the achievements that could unlock during the demos (probably all the level-based achievements), and add a new requirement to these achievements. Add it alongside the existing requirements. For this new requirement, set the address to the 'demo mode active' memory we found, set the mem size to 8-bit, and set the value we require to be equal to the value when the game is active.</p> <p>That's it! Now the achievement will only trigger if the player is on a certain level, AND that the game is not in a demo mode! </p> <p>Before we commit this back to the server, it's a good idea to test out this to see if it worked. Press ESC on the game to bring up the overlay and pause the game. Then click 'Reset Achieved Status' on this achievement in the 'Achievements' dialog, and confirm the prompt. Finally, click back in the game and press TAB to reset the game, and ESC to dismiss the overlay. Press F4 a few times to increase the speed of the game, and watch to ensure the achievement doesn't trigger. If it still triggers, it sounds like something went wrong. Try and check the requirements are entered correctly ('is demo mode' comparison probably needs to be '8-bit'), check that you reset the right achievement, and finally watch the value of the 'is demo mode' flag in the memory inspector. </p> <p>If it worked correctly, select the achievement in the Achievements dialog, hit 'Commit Selected', confirm the dialog and you're done!</p> <p>There are many alternative methods for getting the 'is demo mode' flag, but unfortunately none of them are guarantees. All I can do is suggest methods I've found in existing games. To start with, I'll suggest Castlevania: Bloodlines (Mega Drive), and the achievement Watery Grave (5). There is a mild cheat-protection in these requirements, but I'll just focus on the 'demo mode' part. Castlevania treats every screen as a type of 'screen mode'. To test for this, I started the game, and at the sega logo, I started an 8-bit test. I then assumed that the 'screen mode' would have changed by the time it was playing the 'intro movie', so I did a 'not equal', then an 'equal' filter to suggest that I only want candidates that have changed. I did this again at the 'press start' screen, then at the options screen, then the password screen, character select screen, and finally ingame. </p> <p>By this point I had 10 matches. I mentally eliminated anything where the surrounding values were very random - this data is likely to be graphic or sound data, and won't be much use for us. After having repeated the test and watching each of these 10 values, I also eliminated a few more, as some of these appeared to change while I was still on the same screen. This left me with three values, <code>0x9002</code>, <code>0x9004</code> and <code>0x905e</code>. After going into game and playing for a few seconds, I could tell that <code>0x905e</code> was changing while I was still ingame. I opted to use <code>0x9002</code>, as it was located fairly close to clean boundary (<code>0x9000</code>). Also values like this are likely to be in the second half of RAM (between <code>0x8000</code> and <code>0xffff</code>) as they are easier for developers to address. </p>"},{"location":"Tips-and-Tricks-es/","title":"Tips y Trucos","text":""},{"location":"Tips-and-Tricks-es/#tips-en-la-busqueda-de-memoria","title":"Tips en la B\u00fasqueda de Memoria","text":"<p>Tambi\u00e9n mira: Un vistazo al Inspector de Memoria.</p> <ul> <li>Empieza con la vista de 8-bit en el Visor de Memoria. Buscar pedazos grandes de memoria solo complica las cosas, pero har\u00eda un trabajo mas f\u00e1cil para un desarrollador experimentado. Si tu estas empezando y no estas consciente de t\u00e9rminos como endianess y bit ordering (o cuando los ojos est\u00e1n cansados), es mejor hacer observaciones usando la vista de 8-bit. Es simplemente mas f\u00e1cil!</li> </ul> <ul> <li>Desmarca la casilla \"Show Decimal Values\" en el Editor de Logros (Achievement Editor) para as\u00ed poder introducir los valores hex que encuentres en el Visor de Memoria (Memory Viewer). Es mejor que estar utilizando una calculadora de programador!</li> </ul> <ul> <li>Si encuentras una variable, tambi\u00e9n busca en los alrededores de la misma podr\u00edas encontrar muchas variables utiles.</li> </ul> <ul> <li>Puedes introducir valores en el Visor de Memoria para ver si afectan al juego.</li> </ul> <ul> <li>Incluso si algo esta visiblemente decrementando en el juego, como la vida, la memoria podr\u00eda tener diferencias. Podr\u00eda ser posible que este incluso incrementando, as\u00ed que como es algo de lo que no estas del todo seguro, es preferible que utilices los filtros <code>!=</code> y <code>=</code>.</li> </ul> <ul> <li>Si tu absolutamente no puedes reducir los resultados de un filtro, puedes intentar adivinar algunos valores o m\u00ednimo como esta actuando ese valor (<code>&gt;</code> o <code>&lt;</code>). Por ejemplo, cero vida es usualmente <code>0</code>, Stage 1 es usualmente el valor <code>0</code>, Stage 2 es usualmente el valor <code>1</code> dependiendo el tipo de juego.</li> </ul> <ul> <li>Vista de 16/32 bit: Recuerda que cuando trabajas con variables de 16 o 32 bit las variables de la derecha son primero. Por Ejemplo: si en 8bit se mira de esta manera <code>AB CD WX YZ</code>, en 16 bit se convierte en <code>CDAB YZWX</code>. A esto se le llama \"ordenado de bits big endian\". Sin preocupaciones puedes ignorar esta platica geek, solamente recordando que las cosas se almacenan al rev\u00e9s en la vista de 16 bit y superiores.</li> </ul> <ul> <li>Bit fields: Utiliza single bits para cosas que solamente cambian en un bit. En el Inspector de Memoria (Memory Inspector), cuando una variable es seleccionada, vas a encontrar <code>Bits: 7 6 5 4 3 2 1 0</code> arriba de las variables. Y abajo de esos n\u00fameros va a ver ya sea un <code>0</code> o un <code>1</code>, as\u00ed como <code>0 0 1 0 0 0 1 1</code> en la imagen de abajo. Si <code>bit5</code> tiene un <code>1</code> arriba de el, entonces <code>bit3=1</code> para esa variable. El uso de Single bit es muy com\u00fan en un juego para items/eventos/desbloqueos/etc. Tal vez suene un poco confuso , pero es muy importante que lo entiendas. Algunos juegos con espacio en memoria muy limite usan los campos de bits (Bit fields) much\u00edsimo! Es una t\u00e9cnica importante de aprender.</li> </ul> <p></p>"},{"location":"Tips-and-Tricks-es/#tips-en-la-creacion-de-logros","title":"Tips en la Creaci\u00f3n de Logros","text":"<p>Tambi\u00e9n mira: Conceptos No-Bievenidos y Dise\u00f1o de Logros.</p> <ul> <li>Nunca Evita utilizar solo una condici\u00f3n lo mas que puedas. Cuando utilizas solo una condici\u00f3n el logro es muy probable que salga en el momento equivocado.  Este es el error mas com\u00fan de un desarrollador.</li> </ul> <ul> <li>Si el juego tiene un modo demo (El CPU juega despu\u00e9s que hubieras esperado un tiempo en la pantalla de titulo), percatate de buscar la variable para ello y agrega la condicion para que tus logros no salgan en modo demo. Tal vez necesites saber como se utiliza un PauseIf y ResetIf.</li> </ul> <ul> <li><code>PauseIf</code> cheat codes: Si el juego tiene un cheat code para incrementar vidas, seleccionar stages, etc. Percatate de encontrar las variables para ello y agregar alguna especie de protecci\u00f3n a tus logros.</li> </ul> <ul> <li>Si quieres crear un logro para colecciona un \u00edtem \u00fanico y especifico en el juego, agrega algunas condiciones para asegurarte que el jugador consigui\u00f3 el \u00edtem donde se supone que se tiene que conseguir, como en este ejemplo de aqu\u00ed. De otra manera podr\u00eda saltar utilizando un password, cargando un archivo de guardado, etc.</li> </ul> <ul> <li>Condiciones \u00d3: si necesitas condiciones \u00d3, vas a necesitar Alt groups.</li> </ul> <ul> <li>Evita el exceso de Logros. Si un juego tiene 100 levels, no hagas un logro por cada nivel. Haz cada 25 o parecido. Considera el tiempo en el que un jugador casual podr\u00eda desbloquear esos logros. Si generalmente puedes desbloquear todos los logros de un set de progreso en medio hora y siendo un jugador casual, eso es dise\u00f1o de puro relleno, y no es recomendable.</li> </ul> <ul> <li>Se Creativo y Divertido: Se lo mas creativo posible con tus logros. \"Vence a X sin utilizar/hacer Y\", \"Vence a X en 5 segundos\", \"p\u00e1sate el juego con solo 3 corazones\". Ten en mente que incluso el jugador casual puede sacarse todos los logros si pone su mejor esfuerzo. No es divertido para un jugador casual si es demasiado dif\u00edcil!  (Mira:  Tips para Sets Bonus mas abajo para retos de verdad!). Hay una pagina completa sobre Dise\u00f1o de Logros hay puedes conseguir buenas ideas para pensar en como hacer buenos logros.</li> </ul> <ul> <li>Glitchless, por favor!: No hagas logros donde requieras el uso de glitches. Glitches, en la mayor\u00eda de los casos, corrompen y destabilizan la RAM y memoria del juego. Para agregar b\u00e1sicamente rompen todo el set de logros. Por eso es, sabio agregar protecci\u00f3n a esto para as\u00ed detener a los jugadores de utilizarlos y conseguir los logros f\u00e1cilmente.</li> </ul> <ul> <li>Evita utilizar solamente texto y gr\u00e1ficas: La mayor\u00eda de las veces, un logro que requiere que pase cierto evento especial puede estar atado a una event flag (usualmente un single bit or byte), o a un objeto recibido por el jugador. Es mucho mejor utilizar estos valores que utilizar el ID de texto que se muestra en la caja de texto, o, mucho peor, RAM de v\u00eddeo (memoria atada a los gr\u00e1ficos que se muestran en pantalla) ya que muchas veces son menos estables. Especialmente en versiones diferentes del juego, y son mas dif\u00edciles de trabajar.</li> </ul> <ul> <li>Amamos el Arte:  Badges bonitos son badges que dan gusto conseguir! Tiene que representar visualmente el logro en si, o una pista de acuerdo a la ubicaci\u00f3n en el juego para evadir secretos.  Que est\u00e9n a la par con el estilo de arte del juego funciona muy bien.  Buscar en Google Im\u00e1genes \"Sprite Sheets\" es un tip muy \u00fatil para incluir arte del juego. Si eres un buen artista gr\u00e1fico, sera tu tiempo de brillar actualizando badges! Puedes encontrar mas informaci\u00f3n en la Pagina de Creaci\u00f3n de Badges e Iconos.</li> </ul>"},{"location":"Tips-and-Tricks-es/#tips-en-tu-estructura-gramatical","title":"Tips en tu estructura gramatical","text":"<ul> <li>No S\u00edmbolos: No utilizas caracteres de acentos/especiales como la <code>\u00e9</code> en Pokemon, ya que actualmente rompen algunas cosas (como el feed). Cambien no son visibles en la b\u00fasqueda si no se introduce el car\u00e1cter especial. Lo mismo para c\u00f3digos universales de Emoji UTF-8. Excepci\u00f3n Permitida: Scripts de Rich Presence.</li> </ul> <ul> <li>Cuida tu Ingles: evita errores ortogr\u00e1ficos. Como RetroAchievements es una comunidad internacional, utilizar el Ingles para las Notas de C\u00f3digo es una buena practica, ya que otro desarrollador puede utilizar tus notas en un futuro.</li> </ul>"},{"location":"Tips-and-Tricks-es/#trucos","title":"Trucos","text":""},{"location":"Tips-and-Tricks-es/#encontrando-la-variable-para-el-modo-demo","title":"Encontrando la variable para el Modo Demo","text":"<p>Un truco usual para empezar a filtrar valores para encontrar el Modo Demo es dejar que empieze y asi empezar a filtrar con <code>=</code> \"Last Known Value\" y presionar \"Filter\" suficiente veces, deteni\u00e9ndote una vez que el demo hubiera terminado (ten cuidado de no filtrar despu\u00e9s que se hubiera terminado el demo).</p> <p>Ahora empieza el juego de manera normal y cuando tengas control del personaje cambie el filtro a <code>!=</code> y filtra solo una vez. Los valores que se filtraron son los que cambiaron desde el modo demo.</p> <p>Ahora cambien el filtro de regreso a <code>=</code> y entonces inicia una secuencia de jugar-y-filtrar. Que significa juega un poco, mu\u00e9vete por el escenario, derrota algunos enemigos, y entonces filtra.</p> <p>Pro tip: Es muy muy muy \u00fatil tener estados de guardado (savestates) en diferentes niveles del juego, ya que puedes hacer lo de jugar-y-filtrar en diferentes escenarios y hacer el filtrado mas efectivo.</p> <p>Despu\u00e9s de conseguir algunas variables como resultado, por lo general el valor de demo es igual a <code>1</code> (algunas veces tambi\u00e9n es <code>ff</code>). Si encuentras una direcci\u00f3n potencial editala a <code>0</code> y checa si eres capaz de mover al personaje. Si s\u00ed, BINGO!, esa es la variable que estabas buscando.</p>"},{"location":"Tips-and-Tricks-es/#observador-de-variables-address-watcher","title":"Observador de Variables (Address Watcher)","text":"<p>Aqu\u00ed un truco f\u00e1cil utilizando un logro de prueba para observar si una variable tiene cambios, que es algo que tu vas a querer saber com\u00fanmente.</p> <p></p> <p>Condiciones Explicadas </p> <ol> <li><code>Valor 1 = Valor 0</code>; Esto es para prevenir que el logros jamas sea verdadero, ya que el valor 0 nunca va a ser igual a 1.</li> <li><code>Valor 1 = Valor 1</code>; Para que funcione este truco el logro necesita hits para que se resetee. Cuando 1 = 1 hits ser\u00e1n agregados a la condici\u00f3n.</li> <li><code>ResetIf Mem 0x10 != Delta 0x10</code>; Esta es la variable que quieres observar. Cada vez que hay un cambio el logro se va a reiniciar.</li> </ol> <ul> <li>Por ultimo checa que las casillas de <code>Pause on Reset</code> y <code>Active</code> est\u00e9n marcadas. Ahora vas a conseguir un pop-up y la emulaci\u00f3n se va a pausar cada vez que la variable cambie.</li> </ul>"},{"location":"Tips-and-Tricks-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-14 13:53] eldexterr:</code> Document Finished :)</li> <li><code>[2019-04-12 11:50] eldexterr:</code> Document isn\u00b4t finish</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/","title":"Dicas e Truques","text":"<p>Link para o texto em ingl\u00eas: Tips and Tricks</p>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-para-convencao-de-nomes","title":"Dicas para Conven\u00e7\u00e3o de Nomes","text":"<ul> <li>Sem s\u00edmbolos: N\u00e3o use caracteres acentuados / especiais como o \"\u00e9\" no Pok\u00e9mon, pois eles v\u00e3o bagun\u00e7ar algumas coisas (como o feed). Eles tamb\u00e9m n\u00e3o ser\u00e3o vis\u00edveis na pesquisa sem o caracter especial.</li> </ul> <ul> <li>Sem Emojis: N\u00e3o utilize os Universal Emoji codes da UTF-8 no nome das suas conquistas, pois a exibi\u00e7\u00e3o desses c\u00f3digos \u00e9 totalmente dependente da plataforma (i. E .: Mac OSX, Windows, Linux, iOS, Android e navegador).</li> </ul> <ul> <li>Preocupe-se com a gram\u00e1tica: evite erros de gram\u00e1tica. Como o RetroAchievements \u00e9 uma comunidade internacional, usar o ingl\u00eas para Code Notes \u00e9 uma boa pr\u00e1tica, pois outro desenvolvedor pode usar suas anota\u00e7\u00f5es no futuro. Se o ingl\u00eas n\u00e3o for o seu primeiro idioma, passar seus t\u00edtulos, nomes e notas de c\u00f3digo atrav\u00e9s de um corretor ortogr\u00e1fico ajudar\u00e1. \u00c9 um passo extra para aqueles que t\u00eam dificuldade com a l\u00edngua inglesa, mas o cuidado e a aten\u00e7\u00e3o refletem nas suas qualidades positivas como desenvolvedor.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-selecao-de-rom","title":"Dicas de sele\u00e7\u00e3o de ROM","text":"<ul> <li>Sele\u00e7\u00e3o de regi\u00e3o: Escolha as ROM lan\u00e7adas como <code>NTSC USA</code> se dispon\u00edveis, pois 60 FPS (Frames Per Second) \u00e9 uma experi\u00eancia de jogo mais suave. As ROMs lan\u00e7adas como <code>PAL European</code> s\u00e3o executados em 50 FPS, e devem ser evitados na maioria dos casos. As ROMs lan\u00e7adas como <code>NTSC Japan</code> tamb\u00e9m s\u00e3o executados em 60 FPS, mas s\u00f3 \u00e9 a melhor op\u00e7\u00e3o se o jogo for uma vers\u00e3o exclusiva do Jap\u00e3o. Recorrer a um jogo lan\u00e7ado como <code>PAL European</code> deve ser apenas em \u00faltimo caso (exclusivo para a Europa) e normalmente \u00e9 um n\u00famero muito seleto de jogos \u00fanicos da biblioteca inteira do console.</li> </ul> <ul> <li>Sem Mods: N\u00e3o use uma ROM com uma tela de inicializa\u00e7\u00e3o modificada / personalizada, como Mode7 e RisingSun, porque ela bagun\u00e7a a RAM.</li> </ul> <ul> <li>Sem trainers: N\u00e3o use uma ROM que inclua um recurso cheat integrado. Elas s\u00e3o frequentemente referidas com \"ROM trainers\". Elas n\u00e3o s\u00e3o oficiais e, de forma alguma s\u00e3o suportados pelo RetroAchievements.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-escavacao-de-memoria","title":"Dicas de escava\u00e7\u00e3o de mem\u00f3ria","text":"<ul> <li>Voc\u00ea pode inserir valores no Memory Inspector para ver se ele afeta algo no jogo.</li> </ul> <ul> <li>Se voc\u00ea encontrar um endere\u00e7o, procure tamb\u00e9m a mesma regi\u00e3o que o rodeia e voc\u00ea pode encontrar muitos outros endere\u00e7os \u00fateis.</li> </ul> <ul> <li>Mesmo que algo esteja visivelmente decrescente no jogo, como a sa\u00fade, o valor n\u00e3o est\u00e1 necessariamente diminuindo. \u00c9 poss\u00edvel que ele esteja aumentando, ent\u00e3o, como \u00e9 incomum para voc\u00ea saber com certeza, voc\u00ea deve apenas filtrar <code>!=</code> E <code>==</code>.</li> </ul> <ul> <li>Se voc\u00ea absolutamente n\u00e3o consegue reduzir os resultados de um filtro, voc\u00ea pode tentar adivinhar alguns valores ou pelo menos como o valor est\u00e1 atuando (<code>&gt;</code> ou <code>&lt;</code>). Por exemplo, geralmente nenhuma barra de energia \u00e9 <code>0</code>, o est\u00e1gio 1 geralmente \u00e9 o valor <code>0</code>, o est\u00e1gio 2 geralmente \u00e9 o valor <code>1</code>, dependendo do tipo de jogo. Outro exemplo, talvez cada segmento da sua energia tenha 4 barrinhas - Voc\u00ea deve procurar quando \"4\" vai para \"3\" quando voc\u00ea perde uma barrinha?</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-por-nivel-de-habilidade","title":"Dicas por n\u00edvel de habilidade","text":""},{"location":"Tips-and-Tricks-pt_BR/#nivel-1-facil","title":"N\u00edvel 1 - F\u00e1cil","text":"<p>Comece com a visualiza\u00e7\u00e3o de 8 bits no Memory Inspector. Olhar para grandes partes de mem\u00f3ria ir\u00e1 complicar as coisas, mas isso facilitar\u00e1 o trabalho de um desenvolvedor experiente. Se voc\u00ea est\u00e1 apenas come\u00e7ando e desconhece termos como endianess e bit ordering (ou quando o cansa\u00e7o bate), \u00e9 melhor fazer suas observa\u00e7\u00f5es na vis\u00e3o de 8 bits. \u00c9 mais f\u00e1cil!</p>"},{"location":"Tips-and-Tricks-pt_BR/#nivel-2-medio","title":"N\u00edvel 2 - M\u00e9dio","text":"<p>Big data (vista de 16 ou 32 bits): lembre-se de que ao adicionar um endere\u00e7o de 16 bits o endere\u00e7o \u00e0 direita vem primeiro.</p> <p>Exemplo: <code>AB CD WX YZ</code> em 8 bits torna-se<code>CDAB YZWX</code> em 16 bits.</p> <p>Isso \u00e9 chamado de \"ordena\u00e7\u00e3o de bytes big endian\". Voc\u00ea pode tranquilamente ignorar esse papo geek apenas lembrando que as coisas est\u00e3o armazenadas \"de tr\u00e1s pra frente\" na vista de 16 bits e acima.</p> <p>Lembre-se de que se voc\u00ea estiver vendo mem\u00f3ria em peda\u00e7os maiores, quando voc\u00ea destaca um valor, esse valor agora representa um \"peda\u00e7o\" de mem\u00f3ria de 16 ou 32 bits e n\u00e3o o endere\u00e7o de mem\u00f3ria de 8 bits que voc\u00ea pode estar procurando. Voc\u00ea precisar\u00e1 voltar para a vis\u00e3o de 8 bits e destacar a endere\u00e7o que te interessa, se voc\u00ea encontrar algo de 8 bits que pare\u00e7a interessante.</p>"},{"location":"Tips-and-Tricks-pt_BR/#nivel-3-avancado","title":"N\u00edvel 3 - Avan\u00e7ado","text":"<p>Adicionando suporte para os cores libretro Little Endian: N64-specific, na maioria das vezes, ao adicionar suporte para um core libretro LE ao seu set, os conceitos explicados anteriormente (N\u00edvel Intermedi\u00e1rio) se aplicam, com ordena\u00e7\u00e3o de bytes ligeiramente alteradas. O que \u00e9 visto como leg\u00edvel em 16 bits muda drasticamente no interior de um core LE.</p> <p>Exemplo: AB CD WX YZ primeiro pega os bits de A, vira-os como se estivessem olhando em um espelho; bits de B bits e vira-os; bits de C... etc, at\u00e9 Z, e ent\u00e3o se torna WXYZ ABCD com os bytes do seu \u00faltimo passo.</p> <p>Para adicionar o suporte LE, voc\u00ea estar\u00e1 escrevendo uma condi\u00e7\u00e3o do n\u00facleo falso (Mem 0x000001 = Mem 0x000001), copiando suas condi\u00e7\u00f5es originais n\u00e3o-LE com um 'PauseIf<code>na parte superior em uma Alt, copie as mesmas condi\u00e7\u00f5es para a outra. Ambos os 'PauseIf</code>s conter\u00e3o um cheque olhando para um endere\u00e7o de mem\u00f3ria que nunca muda para ver se o seu valor de 16 bits teve o seu pedido de bytes alterado (Pense nisso como \" <code>PauseIf</code> n\u00e3o estou no n\u00facleo LE\" e \"<code>PauseIf</code> eu sou\" nas condi\u00e7\u00f5es alt).</p> <p>Um funcionar\u00e1 se o jogador estiver executando em um n\u00facleo LE, o outro n\u00e3o. Em seguida, voc\u00ea executar\u00e1 a matem\u00e1tica que descrevi acima nos valores que voc\u00ea est\u00e1 procurando no \"<code>PauseIf</code>, n\u00e3o estou no LE core\" Alt, e atualizando-o.</p> <p>Confuso? Sim. \u00c9 por isso que a maioria dos iniciantes e desenvolvedores intermedi\u00e1rios n\u00e3o deve se preocupar.</p>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-criacao-de-achievements","title":"Dicas de cria\u00e7\u00e3o de achievements","text":"<ul> <li>Nunca use / Evite usar apenas uma condi\u00e7\u00e3o, tanto quanto voc\u00ea puder. Ao usar apenas uma condi\u00e7\u00e3o, o achievement provavelmente ir\u00e1 aparecer na hora errada. Este \u00e9 o erro mais comum cometido por um desenvolvedor, resultando na justificativa \"Popped at the Wrong Time\" anexada nos Bug Tickets recebidos em RetroAchievements.org. Programe suas conquistas com robustez.</li> </ul> <ul> <li>PauseIf Demo Mode:  Se o jogo tiver um modo de demonstra\u00e7\u00e3o (AI joga o jogo depois de esperar um pouco na tela de t\u00edtulo), assegure-se de encontrar o endere\u00e7o para isso e adicione <code>mode != Demo</code> ou algo semelhante em suas conquistas.</li> </ul> <ul> <li>Reiniciar Acontece: Alguns emuladores enviam um valor espec\u00edfico para a RAM quando reiniciados / recarregados. \u00c9 apenas para o primeiro quadro, mas pode fazer com que os achievements disparem, ent\u00e3o voc\u00ea precisa se preparar para isso. Geralmente, \u00e9 um valor como o FF. Voc\u00ea pode ver o valor se voc\u00ea usar Frame Advance / Next Frame ao reiniciar o jogo.</li> </ul> <ul> <li>Limita\u00e7\u00f5es:  H\u00e1 um limite de 100 achievements, um teto de 400 pontos e um limite de caracteres para uma \u00fanica conquista (tente n\u00e3o colocar mais de 50 condi\u00e7\u00f5es em uma conquista, isso \u00e9 mais amor do que o RetroAchievements consegue lidar!).</li> </ul> <ul> <li>Alt groups (lado esquerdo do editor) s\u00e3o usados para \"ou\" condi\u00e7\u00f5es. O grupo Core est\u00e1 sempre l\u00e1 e deve sempre ser verdadeiro com pelo menos um grupo Alt sendo completamente verdadeiro para obter um achievement. O grupo inteiro \u00e9 a sua condi\u00e7\u00e3o \"ou\". Mais informa\u00e7\u00f5es sobre a p\u00e1gina  Achievement Logic Features page.</li> </ul> <ul> <li>Evite o spam de achievement. Se um jogo tiver 100 n\u00edveis, n\u00e3o fa\u00e7a um achievement para cada n\u00edvel. Fa\u00e7a a cada 25 ou mais. Geralmente, \u00e9 avaliado pela equipe de desenvolvimento da RA para codificar esses achievements do tipo \"Filler\". Se voc\u00ea pretende criar alguns desbloqueios progressivos desta maneira - as palavras: (\"F\u00e1cil\", \"M\u00e9dio\", \"Dif\u00edcil\") ajudar\u00e3o a coloc\u00e1-lo em contexto. Considere o segmento de tempo que um jogador casual desbloquearia esses achievements progressivos. Se, em geral, voc\u00ea poderia desbloquear tudo em um conjunto progressivo de achievements desta natureza em menos de meia hora como jogador casual, design de preenchimento e n\u00e3o recomendado.</li> </ul> <ul> <li>Seja criativo e divertido: Seja t\u00e3o criativo quanto poss\u00edvel com achievements. \"Beat X sem usar / fazer Y\", \"Beat X em 5 segundos\", \"3 heart run\". Certifique-se de que os jogadores ocasionais ainda podem obter estes com seu melhor esfor\u00e7o. N\u00e3o \u00e9 divertido se for muito dif\u00edcil para um jogador casual! (Veja: Dicas de b\u00f4nus abaixo para os desafios reais!). H\u00e1 uma p\u00e1gina inteira sobre Achievement Design que pode dar bons conselhos sobre como pensar sobre bons achievements.</li> </ul> <ul> <li>Glitchless, please!: N\u00e3o fa\u00e7a achievements que exijam falhas. As falhas, na maioria dos casos, corrompem e desestabilizam a mem\u00f3ria do jogo e a RAM. Eles quebram o resto do conjunto para incluir. No entanto, \u00e9 aconselh\u00e1vel codificar as paredes do bloco impedindo os jogadores de us\u00e1-los para obter um dom\u00ednio f\u00e1cil. Este \u00e9 um tema de muito debate no RA, uma vez que o achievement d\u00e1 uma falha de quebra do jogo \u00e0s vezes requer muita habilidade de jogador. Algumas falhas s\u00e3o poss\u00edveis apenas no console, algumas apenas em emulador. Por sua inconsist\u00eancia e instabilidade em rela\u00e7\u00e3o \u00e0 mem\u00f3ria, \u00e9 recomend\u00e1vel bloque\u00e1-los para proteger a integridade do seu conjunto e sua reputa\u00e7\u00e3o. (Este \u00e9 um problema excepcional em alguns jogos do GameBoy, onde o playground falou em seu caminho para a vit\u00f3ria foi prominente!)</li> </ul> <ul> <li>N\u00f3s amamos arte: Emblemas bonitos s\u00e3o emblemas gratificantes! Ele deve representar visualmente a realiza\u00e7\u00e3o em si, ou sugerir o local no jogo para os segredos. Corresponder ao estilo de arte do jogo funciona bem. O Google Image busca \"Sprite Sheets\" \u00e9 uma dica \u00fatil para incluir alguma arte do jogo. Se voc\u00ea \u00e9 um bom artista gr\u00e1fico, atualizar emblemas \u00e9 o seu tempo para brilhar! Mais informa\u00e7\u00f5es podem ser encontradas na Badge and Icon Creation page.</li> </ul> <ul> <li>Desmarque \"Show Decimal Values\" no Achievement Editor para que voc\u00ea possa inserir os valores hexadecimais que voc\u00ea v\u00ea no Visualizador de mem\u00f3ria. \u00c9 melhor do que usar a calculadora de um programador!</li> </ul> <ul> <li>16-bit segredos: Os requisitos de 16 bits n\u00e3o precisam ser usados em um n\u00famero par de RAM, eles podem ser usados adequadamente, mesmo que a visualiza\u00e7\u00e3o de 16 bits n\u00e3o o mostre corretamente. Ex: 0 1 2 3 4 5, em 16 bits geralmente \u00e9 visto como 10 32 54, mas se voc\u00ea come\u00e7ar o endere\u00e7o no 1 aqui em sua exig\u00eancia, \"21\" ser\u00e1 lido pela conquista, mesmo que seja de 16 bits A visualiza\u00e7\u00e3o no visor de mem\u00f3ria n\u00e3o est\u00e1 mostrando isso. Tamb\u00e9m funciona se \u00e9 o \u00faltimo endere\u00e7o na linha (come\u00e7ando em F, indo para 0). Esteja ciente de que, se voc\u00ea estiver codificando por n\u00facleos LE, voc\u00ea tamb\u00e9m precisar\u00e1 atualizar isso! Sempre deixe notas de c\u00f3digo descritivo para si ou para outra pessoa.</li> </ul> <ul> <li>Bit field segredos: Use bits simples (0-7) para coisas que apenas alteram um \u00fanico bit. No Memory Viewer, quando um endere\u00e7o \u00e9 selecionado, haver\u00e1 \"bits 0 1 2 3 4 5 6 7\" acima dos endere\u00e7os, e abaixo desses n\u00fameros ser\u00e3o \"0\" ou \"1\" como \"0 0 0 0 0 0 0 0 \"se bit3 tiver um 1 abaixo dele, bit3 = 1 para esse endere\u00e7o. O uso de um \u00fanico bit \u00e9 muito comum para eventos / desbloqueios de jogos / etc. Voc\u00ea vai querer usar estes em jogos onde voc\u00ea pode fazer coisas em diferentes ordens, di\u00e1logos, eventos, desbloqueios .. Se voc\u00ea verificar \"8 bits x = 7 \"e algu\u00e9m fez algo diferente, como saltar algo ou obter algo extra, seu valor de 8 bits provavelmente ser\u00e1 diferente porque os \u00fanicos bits dentro s\u00e3o diferentes e a conquista n\u00e3o ser\u00e1 desbloqueada, ent\u00e3o neste caso voc\u00ea verifique se h\u00e1 bits espec\u00edficos dentro o endere\u00e7o de 8 bits. Agora, se, por exemplo, os desbloqueios de itens usam todos os 8 bits do endere\u00e7o de 8 bits e voc\u00ea quer fazer \"desbloquear todos os itens\", voc\u00ea pode apenas fazer \"8 bits x = 0xff\" Isso pode ser confuso, mas \u00e9 muito importante para entender. Alguns jogos com espa\u00e7o de mem\u00f3ria limitado usam muito os campos de bits! \u00c9 uma t\u00e9cnica importante para aprender.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-28 20:15] meleu:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 12:03] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 12:03] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 11:47] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Tips and Tricks.pt_BR (markdown)</li> </ul>"},{"location":"Tips-and-Tricks/","title":"Tips and Tricks","text":"<ul> <li>Memory Digging Tips</li> <li>Achievement Creation Tips</li> <li>Naming Convention Tips</li> <li>Tricks<ul> <li>Finding the Address for Demo Mode</li> <li>Address Watcher</li> </ul> </li> </ul>"},{"location":"Tips-and-Tricks/#memory-digging-tips","title":"Memory Digging Tips","text":"<p>See also: Memory Inspector Overview.</p> <ul> <li>Start with 8-bit view in the Memory Viewer. Looking at larger chunks of memory will complicate things, but it will make a seasoned developer's job easier. If you're just starting out and unaware of terms like endianess and bit ordering (or when the eyes are tired), its best to make your observations in 8-bit view. Its just easier!</li> </ul> <ul> <li>Uncheck \"Show Decimal Values\" in the Achievement Editor so you can enter the hex values you see in the Memory Viewer. Its better than using a programmers calculator!</li> </ul> <ul> <li>If you find an address, also search the same region surrounding it and you could find many more useful addresses.</li> </ul> <ul> <li>You can input values in the memory viewer to see if it affects the game.</li> </ul> <ul> <li>Even if something is visibly decreasing in-game, like health, memory can behave differently. It's possible for it to be increasing, so since it's uncommon for you to know for sure, prefer the <code>!=</code> and <code>=</code> filters.</li> </ul> <ul> <li>If you absolutely cannot reduce the results of a filter, you can try guessing some values or at least how the value is acting (<code>&gt;</code> or <code>&lt;</code>). For example, no health is usually <code>0</code>, Stage 1 is usually value <code>0</code>, Stage 2 is usually value <code>1</code> depending on the type of game.</li> </ul> <ul> <li>16/32 bit view: remember that when working with 16 or 32 bit address the address to the right comes first. Example: if in 8bit it looks like <code>AB CD WX YZ</code>, in 16 bit it becomes <code>CDAB YZWX</code>. This is called \"big endian byte ordering\". You can safely ignore the geek-speak by just remembering things are stored backwards in 16 bit view and above.</li> </ul> <ul> <li>Bit fields: Use single bits for things that only change a single bit. In the Memory Inspector, when an address is selected, there will be <code>Bits: 7 6 5 4 3 2 1 0</code> above the addresses. And below those numbers will be either <code>0</code> or <code>1</code>, like <code>0 0 1 0 0 0 1 1</code> in the image below. If <code>bit5</code> has <code>1</code> under it, then <code>bit5=1</code> for that address. Single bit usage is very common for game items/events/unlocks/etc. This may be confusing, but it's very important to understand. Some games with limited memory space use bit fields a lot! Its an important technique to learn.</li> </ul> <p></p>"},{"location":"Tips-and-Tricks/#achievement-creation-tips","title":"Achievement Creation Tips","text":"<p>See also: Unwelcome Concepts and Achievement Design.</p> <ul> <li>Never Avoid using only one condition as much as you can. When using only one condition the achievement will most likely pop at the wrong time.  This is the most common error by a developer.</li> </ul> <ul> <li>If the game has a demo mode (AI plays the game after you wait a while on the title screen), make sure to find the address for it and add a condition so your achievements don't trigger in demo mode. You'll probably need to know how to use PauseIf and ResetIf.</li> </ul> <ul> <li><code>PauseIf</code> cheat codes: If the game has a cheat code to increase lives, select stages, etc. Make sure to find the addresses for it and add some kind of protection in your achievements.</li> </ul> <ul> <li>If you wanna create an achievement for collecting a specific and unique item in the game, add some conditions to make sure the player got the item where it is supposed to be obtained, like in this template here. Otherwise the achievement may trigger by using password, loading a save game, etc.</li> </ul> <ul> <li>OR conditions: if you need OR conditions, you'll need Alt groups.</li> </ul> <ul> <li>Avoid Achievement Spam. If a game has 100 levels, do not make an achievement for each level. Do every 25 or so. Consider the time segment a casual player would unlock these progressive Achievements in. If generally you could unlock all in a progressive set of Achievements of this nature in under half an hour as a casual player, that's filler design, and not recommended.</li> </ul> <ul> <li>Be Creative and Fun: Get as creative as possible with achievements. \"Beat X without using/doing Y\", \"Beat X in 5 seconds\", \"3 heart run\". Be sure casual players can still get these with their best effort. It isn't fun if its way too difficult for a casual player!  (See:  Bonus Set Tips below for the real challenges!). There is a whole page about Achievement Design that can give good advices on how to think about good achievements.</li> </ul> <ul> <li>Glitchless, please!: Do not make achievements requiring glitches. Glitches, in most cases, corrupt and destabilize game memory and RAM. They break the rest of the set to include. It is however, wise to code block walls stopping players from using them to get easy mastery.</li> </ul> <ul> <li>Avoid relying on text and graphics: Most of the time, an achievement that requires triggering a special event can be tied to an event flag (usually a single bit or byte), or to an item received by the player. It is better practice to use these values than to check the ID of text being displayed in a text box, or, even worse, video RAM (memory tied to the actual graphics displaying on the screen) as they are often less stable. Especially between different versions of a single game, and they are more difficult to debug.</li> </ul> <ul> <li>We love Art:  Pretty badges are rewarding badges! It should visually represent the achievement itself, or hint at the location in the game for secrets.  Matching to the game's art style works well.  Google Image searches for \"Sprite Sheets\" is an useful tip to include some game art. If you're a good graphics artist, updating badges is your time to shine! More info can be found at the Badge and Icon Creation page.</li> </ul> <ul> <li>Regional Consideration: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</li> </ul>"},{"location":"Tips-and-Tricks/#naming-convention-tips","title":"Naming Convention Tips","text":"<ul> <li>No Symbols: Do not use accented/special characters like the <code>\u00e9</code> in Pokemon, as they currently break a few things (like feed). They are also not visible in search without the special character. Same for UTF-8 Universal Emoji codes. Allowed exception: Rich Presence Scripts.</li> </ul> <ul> <li>Mind your English: avoid grammar mistakes. As RetroAchievements is an international community, using English for Code Notes is a good practice, as another developer can use your notes in the future.</li> </ul>"},{"location":"Tips-and-Tricks/#tricks","title":"Tricks","text":""},{"location":"Tips-and-Tricks/#finding-the-address-for-demo-mode","title":"Finding the Address for Demo Mode","text":"<p>An usual trick to start filtering addresses to find the Demo Mode is to let the demo begin and then start to filter <code>=</code> \"Last Known Value\" and press \"Filter\" many times, stopping right before the demo ends (be careful to not filter after the demo ends).</p> <p>Now start the game normally and when you're able to control the character change the filter to <code>!=</code> and then filter one single time. The filtered addresses are the ones that has changed since the demo mode.</p> <p>Now change the filtering back to <code>=</code> and then start a sequence of play-and-filter. Which means play a bit, move around then scenario, defeat some enemies, and then filter.</p> <p>Pro tip: It is very very very useful to have savestates in different levels of the game, so you can do the play-and-filter in different scenarios and make the filtering more effective.</p> <p>After getting a few addresses as result, quite often the demo value will be <code>1</code> (sometimes it's also <code>ff</code>). If you find a potential address edit it to <code>0</code> and check if you become able to control the character. If yes, BINGO!, that's the address you're looking for.</p>"},{"location":"Tips-and-Tricks/#address-watcher","title":"Address Watcher","text":"<p>Here's an easy trick using a dummy achievement to watch an address for any changes, which is something you'll quite often want to know.</p> <p></p> <p>Conditions Explained </p> <ol> <li><code>Value 1 = Value 0</code>; This is to prevent the achievement from ever being true, as the value 0 never equals 1.</li> <li><code>Value 1 = Value 1</code>; For this trick to work the achievement needs hits to reset. When 1 = 1 hits will be added to this condition.</li> <li><code>ResetIf Mem 0x10 != Delta 0x10</code>; This is the address you want to watch. Any time there is a change the achievement will reset.</li> </ol> <ul> <li>Last of all make sure that <code>Pause on Reset</code> and <code>Active</code> are both checked. Now you will get a pop-up and emulation will pause each time this address changes.</li> </ul>"},{"location":"Tips-and-Tricks/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:26] televandalist:</code> Updated Tips and Tricks (markdown)</li> <li><code>[2023-06-03 02:06] televandalist:</code> Updated Tips and Tricks (markdown)</li> <li><code>[2021-11-30 18:30] SporyTike:</code> Typo that caused a jr-dev confusion. Bit5 = Bit5 and not Bit3</li> <li><code>[2019-08-13 19:42] Kvon:</code> Tips and Tricks: Text hooks tip added</li> <li><code>[2019-02-07 14:57] meleu:</code> decrease verbosity; add trick fo find demo mode; group tips and tricks more reasonably</li> <li><code>[2019-01-17 11:19] meleu:</code> removed the \"Limitations\" topic</li> <li><code>[2019-01-17 11:17] meleu:</code> subnests on bullet points need 4 spaces</li> <li><code>[2019-01-15 19:15] Jamiras:</code> Update reset behavior for 0.75 toolkit</li> <li><code>[2019-01-13 16:20] Rapha\u00ebl Zumer:</code> Add \"Avoid relying on text and graphics\" tip</li> <li><code>[2019-01-13 15:41] Rapha\u00ebl Zumer:</code> Fix typos and reword a memory digging tip</li> </ul>"},{"location":"Trigger-Flag/","title":"Trigger Flag","text":"<p><code>Trigger</code> marks one or more conditions in an achievement as the logic that is expected to be the final logic to become true which causes the achievement to trigger. This allows the runtime to know when an achievement is about to trigger, so a challenge indicator can be shown on the screen.</p> <p>When all conditions that must be true for the achievement to trigger are true except those marked with the <code>Trigger</code> flag, the achievement will become Primed. It will remain Primed as long as all of the previous conditions remain true, or until the achievement triggers or is deactivated.</p> <p>This functionality allows putting indicators on the screen to help players know when a challenge is active, or more importantly, when they fail the challenge. </p> <p>A prime example would be for a damageless boss fight. The <code>Trigger</code> flag would be put on the \"boss is dead\" condition. When all other conditions are true (ex: in boss fight, boss at full hp (HitCount 1), not demo), the challenge indicator would be displayed. If the player takes damage, the HitCount on the \"boss at full hp\" condition would get reset, and the challenge indicator would go away.</p> <p>Trigger should not be used if the player is not attempting a challenge. Achievements that would be earned without any additional effort from the player don't need to tell the player they're about to be earned.</p> <p>Up to eight challenge indicators can be shown at one time (though rarely more than one or two should be). If indicators and leaderboard trackers are both visible, the tracker will appear above the indicators.</p>"},{"location":"Trigger-Flag/#interaction-with-pauseif","title":"Interaction with PauseIf","text":"<p>If the achievement is Paused while Primed, the indicator will become hidden.</p> <p>If it is Paused before it is Primed, the indicator will not be shown at all until the achievement is unpaused.</p> <p>When the achievement becomes unpaused, the indicator may be displayed or hidden depending on the state of the non-Trigger conditions.</p>"},{"location":"Trigger-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-10 11:52] Jamiras:</code> Updated Trigger Flag (markdown)</li> <li><code>[2021-06-29 08:18] Chris:</code> update interaction w/ pauseif to latest (0.79.2) integration</li> <li><code>[2021-04-30 12:07] Jamiras:</code> Created Trigger Flag (markdown)</li> </ul>"},{"location":"Unwelcome-Concepts/","title":"Unwelcome Concepts","text":"<ul> <li>Unwelcome Concepts</li> <li>Unwelcome Game Types</li> <li>Rich Presence Restrictions</li> <li>Banned Titles</li> </ul>"},{"location":"Unwelcome-Concepts/#unwelcome-concepts","title":"Unwelcome Concepts","text":"<p>You can and should always be as creative as you can be, but there are some concepts that are NOT welcome for achievements. Below is a list of what have been deemed unwelcome concepts. Please note that there is some wiggle room so some exceptions to the rules have been provided. When in doubt, consult with Developer Compliance.</p> <ul> <li>Achievement Spam</li> <li>Playing Poorly Without Purpose</li> <li>Zero Effort Without Purpose</li> <li>Requires Glitches</li> <li>Requires Two Players</li> <li>Requires Complete Perfection</li> <li>Pointless Excessive Grinding</li> <li>Overly RNG Reliant</li> <li>\"Secret\" Achievements</li> </ul>"},{"location":"Unwelcome-Concepts/#achievement-spam","title":"Achievement Spam","text":"<p>It is bad design to have achievements popping too frequently. An example of this is unlocking achievements for both defeating a boss as well as obtaining a specific item after the fight. </p> <p>When these are acceptable:</p> <ul> <li>Using the above example: If the achievement for defeating the boss is challenge-based, such as damageless. It is not a guaranteed unlock simply by playing.</li> <li>If the achievements are stackable.<ul> <li>Defeating a boss on normal or higher difficulty + defeating the same boss on hard difficulty.</li> <li>Opening the last chest in an area + opening all chests in the game</li> </ul> </li> </ul>"},{"location":"Unwelcome-Concepts/#playing-poorly-without-purpose","title":"Playing Poorly Without Purpose","text":"<p>Achievements for dying, getting a game over, or repeatedly failing a task just for the sake of it are unnecessary. </p> <p>When these are acceptable: - Many point-and-click adventure games and visual novels often tie a player's death into the story, which can result in unique scenes a player would not witness otherwise. - If playing poorly results in a humorous or otherwise interesting in-game acknowledgement such as being awarded a helmet for taking too many head shots.</p>"},{"location":"Unwelcome-Concepts/#zero-effort-without-purpose","title":"Zero Effort Without Purpose","text":"<p>Examples of this are achievements for simply starting a game, collecting a single coin, watching a video, etc.</p> <p>When these are acceptable:</p> <ul> <li>\"Disclaimer\" achievements that are meant to address the player about restrictions in the achievement sets. These should only exist when the player can lock themselves out of multiple achievements without even realizing it.</li> <li>Not skipping an opening cinematic if it had been considered a big deal at the time.</li> <li>Addressing something fun, historical, or interesting.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-glitches","title":"Requires Glitches","text":"<p>Achievements for performing tasks that are only possible by using glitches, exploiting bugs, etc. are not allowed in a base set. Glitches/Bugs are errors within a game's code which often cause unintended behavior. Examples are memory overflow, incorrectly loaded levels, and clipping into objects.</p> <p>When these are acceptable:</p> <ul> <li>Historically significant glitches and well-known, easy-to-execute glitches of importance to the game's community are allowed with the approval of Developer Compliance. It should be clear that the glitch is needed for the achievement(s) and serve to highlight the glitch's importance or significance.<ul> <li>Achievements including approved glitches must require the player to perform some feat using the glitch. Simply causing the glitch to occur without purpose is insufficient unless activating the glitch itself is a meaningful task.</li> </ul> </li> <li>A <code>[Subset - Glitch Showcase]</code> or <code>[Subset - Bonus]</code>.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-two-players","title":"Requires Two Players","text":"<p>Achievements that require input from at least one other player are not allowed in a base set.</p> <p>When these are acceptable:</p> <ul> <li><code>[Subset - Multi]</code> sets.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-complete-perfection","title":"Requires Complete Perfection","text":"<p>Section Pending</p>"},{"location":"Unwelcome-Concepts/#pointless-excessive-grinding","title":"Pointless Excessive Grinding","text":"<p>Achievements that require long, repetitive tasks solely for the sake of saying you did it. If an achievement calls for spending countless hours making a character reach level 99 or farming for 99 of a certain item, but there is no actual purpose to it, then it does not have a place in a base set. </p> <p>When these are acceptable:</p> <ul> <li>Subsets, whether devoted to max levels (if approved) or a typical Bonus set.</li> <li>The player is awarded in-game for the grind.</li> </ul>"},{"location":"Unwelcome-Concepts/#overly-rng-reliant","title":"Overly RNG Reliant","text":"<p>Rely entirely on randomness, especially when there are extremely low odds. </p> <p>When these are acceptable: Games or mini-games where the randomness is a major aspect.</p>"},{"location":"Unwelcome-Concepts/#secret-achievements","title":"\"Secret Achievements\"","text":"<p>When the player has no indication of what they're going after.</p> <p>When these are acceptable:</p> <ul> <li>Secretive or intentionally vague achievement descriptions can be used to prevent major spoilers, so long as the achievements are unmissable progression. </li> </ul>"},{"location":"Unwelcome-Concepts/#unwelcome-game-types","title":"Unwelcome Game Types","text":"<p>Let's face it. There are some games, or 'games,' rather, that are not fit for achievements. Below is a list of said types of games that are usually not.</p> <ul> <li>Games That Lack Gameplay</li> <li>Compilations and Multi-Carts</li> <li>Betas, Demos, and Prototypes</li> </ul>"},{"location":"Unwelcome-Concepts/#games-that-lack-gameplay","title":"Games That Lack Gameplay","text":"<ul> <li>Videos, music visualizers, jukeboxes, etc.<ul> <li>These will not be accepted without explicit approval. Approval will be handled via voting by Developer Compliance and requires implementation of sufficiently creative concepts. For example: Game Boy Advance Video Series was presented with the idea to include a leaderboard quiz at the end of each episode. This unique plan involved gameplay beyond just pressing start and was approved.</li> </ul> </li> <li>Book sets are still allowed, but must be worth 0 points.</li> </ul>"},{"location":"Unwelcome-Concepts/#compilations-and-multi-carts","title":"Compilations and Multi-Carts","text":"<p>If a compilation or multi-cart features games that share the same console, then they are not allowed. An example of this is 6-Pak for Genesis/Mega Drive, which contains six Genesis/Mega Drive games.</p>"},{"location":"Unwelcome-Concepts/#betas-demos-and-prototypes","title":"Betas, Demos, and Prototypes","text":"<p>If the game ended up having an official release, then these are generally not allowed unless there is unique content. Games that only existed as betas, demos, or prototypes are typically fine, so long as they're actually playable (some prototypes barely qualify).</p>"},{"location":"Unwelcome-Concepts/#rich-presence-custom-name-restriction","title":"Rich Presence Custom Name Restriction","text":"<p>Rich Presence that directly displays custom player input text is prohibited.  The most common example being displaying what a player inputs as their character or file name directly into Rich Presence.</p> <p>This restriction helps in preventing inappropriate or offensive content from showing on various site pages as well as makes the moderation of Rich Presence more manageable, in addition to protection player privacy as players may not realize their text is being displayed publicly.</p>"},{"location":"Unwelcome-Concepts/#banned-titles","title":"Banned Titles","text":"<p>We generally avoid banning titles, leaving content filtering up to individual users to decide. Even still, some titles are egregious enough to warrant removal from the site, both for the protection of the users and of the site itself. Below is an incomplete list of such titles, to be updated as necessary.</p> Title Year Platform \u2022 Lolita Syndrome\u2022 \u30ed\u30ea\u30fc\u30bf\u30fb\u30b7\u30f3\u30c9\u30ed\u30fc\u30e0 1983 FM-7, PC-88 \u2022 My Lolita\u2022 \u30de\u30a4\u30fb\u30ed\u30ea\u30fc\u30bf 1984 FM-7, PC-88 \u2022 The Guy Game 2004 PS2, Xbox, Windows"},{"location":"Unwelcome-Concepts/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-26 08:49] The Mystical One:</code> Updated Unwelcome Concepts (markdown)</li> <li><code>[2024-01-26 08:46] The Mystical One:</code> Added Rich Presence Custom Name Restriction section.</li> <li><code>[2023-06-30 11:03] The Mystical One:</code> Added Developer Compliance contact links.</li> <li><code>[2023-06-28 15:10] The Mystical One:</code> Added in the clarification that an approved glitch should be for accomplishing something with the glitch.</li> <li><code>[2023-06-12 18:27] meleu:</code> fix list formats so mkdocs can render them properly</li> <li><code>[2023-06-05 21:10] televandalist:</code> Added Demos to \"Betas, Demos, and Prototypes\" - Added a link to GBA Video Series - Added quick links to the sections under unwelcome game types -</li> <li><code>[2023-06-02 20:33] televandalist:</code> Updated WIP Unwelcome Concepts (markdown)</li> </ul>"},{"location":"Useful-Links/","title":"Useful Links","text":""},{"location":"Useful-Links/#httpsgamefaqsgamespotcom","title":"https://gamefaqs.gamespot.com/","text":"<p>Great place to find game guides, finding almost all you could want to know about game content, find cheat codes, for development utility and also for making proper protections against the codes.</p>"},{"location":"Useful-Links/#httpswwwvgmapscom","title":"https://www.vgmaps.com/","text":"<p>Thousands of maps/screenshots of your favourite video games.</p>"},{"location":"Useful-Links/#httpstcrfnet","title":"https://tcrf.net/","text":"<p>It is a site dedicated to unearthing and researching unused and cut content from video games. From debug menus, to unused music, graphics, enemies, or levels, many games have content never meant to be seen by anybody but the developers \u2014 or even meant for everybody, but cut due to time/budget constraints.</p>"},{"location":"Useful-Links/#cumulative-probability-calculator","title":"Cumulative Probability Calculator","text":"<p>When working with achievements with an RNG factor you will often want to know the probability of success for players given a number of attempts. (see unwelcome concepts, achievements with low odds). Use it to calculate P(X&gt;=1), assuming the player needs to succeed only once across several attempts, to estimate how many attempts an might require for less lucky players.</p>"},{"location":"Useful-Links/#httpswwwzapstudionetframecalc","title":"https://www.zapstudio.net/framecalc/","text":"<p>Simple utility to calculate frames out of time given and the other way around.</p>"},{"location":"Useful-Links/#httpswwwromhackingnet","title":"https://www.romhacking.net","text":"<p>The biggest repository of patches to hack ROMs. </p>"},{"location":"Useful-Links/#httpdatacrystalromhackingnetwikihashes","title":"http://datacrystal.romhacking.net/wiki/Hashes","text":"<p>Explains what hashes are. If you don't know what they are you should probably read this.</p>"},{"location":"Useful-Links/#httpsemn178githubioonline-toolscrc32_checksumhtml","title":"https://emn178.github.io/online-tools/crc32_checksum.html","text":"<p>Drag and drop checksum checker utility. You can also get the checksum from the rom you have loaded from the retroachievements menu in the emulators.</p>"},{"location":"Useful-Links/#httpwwwmarcrobledocomrompatcherjs","title":"http://www.marcrobledo.com/RomPatcher.js","text":"<p>An online ROM patcher utility.</p>"},{"location":"Useful-Links/#httpjsonviewerstackhu","title":"http://jsonviewer.stack.hu","text":"<p>Excellent for viewing raw achievements</p>"},{"location":"Useful-Links/#httpgamehackingorg","title":"http://gamehacking.org","text":"<p>Provides many Pro Action, Game Genie, and Game Shark codes which can be converted to RAW addresses on the site. </p>"},{"location":"Useful-Links/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-29 12:34] meleu:</code> add https://www.zapstudio.net/framecalc/</li> <li><code>[2019-01-29 14:15] Kvon:</code> added the Cumulative Probability Calculator link</li> <li><code>[2019-01-07 12:14] meleu:</code> added vgmaps.com</li> <li><code>[2018-12-06 20:20] televandalist:</code> Added gamehacking.org - I use the site a lot and always recommend it to people looking for addresses. - tele</li> <li><code>[2018-10-11 00:21] CoolCanuck:</code> gamefaqs.com -&gt; gamefaqs.gamespot.com</li> <li><code>[2018-05-03 11:53] meleu:</code> better format, making the URLs appear on the ToC after mkdocs conversion</li> <li><code>[2018-04-28 22:31] meleu:</code> Updated Useful Links (markdown)</li> <li><code>[2018-04-28 19:03] magusLOGS:</code> added tcrf.net</li> <li><code>[2018-04-28 13:48] meleu:</code> Created Useful Links (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct-es/","title":"C\u00f3digo de Conducta de los Usuarios","text":""},{"location":"Users-Code-of-Conduct-es/#nuestros-estandares","title":"Nuestros Est\u00e1ndares","text":"<p>Nosotros queremos un entorno abierto, positivo y acogedor. </p> <p>Ejemplos de comportamientos que contribuyen a crear un entorno positivo incluyen: </p> <ul> <li>Usar lenguaje acogedor e inclusivo. </li> <li>Ser respetuoso sobre diferentes puntos de vista y experiencias. </li> <li>Aceptar critica constructiva con gracia. </li> <li>Enfocarse en lo que es mejor para la comunidad. </li> <li>Mostrar empat\u00eda hacia otros miembros de la comunidad. </li> </ul> <p>Ejemplos de comportamientos inaceptables de parte de los participantes incluyen: </p> <ul> <li>Postear enlaces de descarga a sitios donde otros pueden descargar ROMs ilegales. </li> <li>Hacer trampas: No est\u00e1 permitido usar trucos a menos que sea especificado en la descripci\u00f3n del Logro, o en el comentario de la pagina del Logro. Incluyendo trucos en el juego, que existen en su consola originaria, est\u00e1n considerados como trampa si no han sido especificados. Las cuentas a las que se les evidencie hayan usado trampas, se les dar\u00e1 el estatus de \"Untracked\". </li> <li>Intentar irrumpir intencionalmente la estabilidad de la comunidad: Incitando cacer\u00edas-de-bruja, influenciar conductas, o generar drama, donde ese tipo de argumentos y desacuerdos deber\u00edan ser llevados a cabo en privado. </li> <li>Troleo excesivo, insultos/comentarios despectivo, y ataques personales o pol\u00edticos. </li> <li>El uso de im\u00e1genes con contenido sexual, y atenciones o insinuaciones sexuales molestas. </li> <li>Acoso publico o privado. </li> <li>Publicar informaci\u00f3n privada de otro, tales como direcci\u00f3n f\u00edsica o electr\u00f3nica, sin su explicito permiso. </li> </ul>"},{"location":"Users-Code-of-Conduct-es/#responsabilidades-de-los-administradores","title":"Responsabilidades de los Administradores","text":"<p>Los administradores tienen el derecho y la responsabilidad de remover, editar, o denegar comentarios, Logros, Medallas, posteos en el foro, y otras contribuciones que no est\u00e1n alineadas a este C\u00f3digo de Conducta, o el banear temporal o permanentemente a cualquier participante por otros comportamientos que ellos consideren inapropiados, amenazantes, ofensivos, o da\u00f1inos. Cu\u00e1ndo el comportamiento inapropiado no es muy claro, los administradores discutir\u00e1n entre ellos que acci\u00f3n deber\u00e1 ser tomada. </p> <p>Los administradores que no sigan o impongan el C\u00f3digo de Conducta en buena fe pueden enfrentar repercusiones temporales o permanentes como lo sera determinado por otros miembros lideres del proyecto. </p>"},{"location":"Users-Code-of-Conduct-es/#reportando","title":"Reportando","text":"<p>Instancias de abuso, acoso, trampa o de otro modo comportamientos inaceptables deber\u00e1n ser reportados contactando al equipo de moderadores de RetroAchievements en el Servidor de Discord (usuarios con nombres en azul). Tambi\u00e9n puedes contactar a todos los administradores/moderadores activos enviando un Mensaje Privado al usuario RAdmin en el sitio oficial. </p> <p>Las quejas ser\u00e1n evaluadas, investigadas y respondidas cuando la circunstancia lo amerite.</p>"},{"location":"Users-Code-of-Conduct-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-17 09:12] ShinyNinetalesTM:</code> fixed some inaccuracies</li> <li><code>[2019-02-14 10:09] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:14] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-04 10:34] meleu:</code> Updated Users Code of Conduct es (markdown)</li> <li><code>[2018-05-04 10:03] meleu:</code> added a title to make it look better after mkdocs conversion</li> <li><code>[2018-04-20 18:31] ShinyNinetalesTM:</code> Changed \"cazerias\" to the correct word \"cacer\u00edas\", and changed \"derrogantes\" to \"despectivos\" (derrogantes doesn't exist at all in spanish language). Also, removed an extra n in \"deber\u00edan\" and changed \"der\" to \"ser\"</li> <li><code>[2018-03-24 11:30] meleu:</code> Updated Codigo de Conducta de los usuarios (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/","title":"Users Code of Conduct fr","text":"<ul> <li>Mission</li> <li>R\u00e8gles     - Version courte     - Version longue     - Libert\u00e9 d'expression</li> <li>Comment fonctionne la mod\u00e9ration     - Que faire si vous pensez que la mod\u00e9ration a commis une erreur ?</li> <li>Tricherie</li> <li>FAQ</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#mission","title":"Mission","text":"<p>Le projet RetroAchievements a pour objectif de fournir les outils n\u00e9cessaires \u00e0 la cr\u00e9ation de succ\u00e8s pour les jeux r\u00e9tro et \u00e0 leur mise en valeur. Nous aspirons \u00e0 promouvoir une communaut\u00e9 saine ax\u00e9e sur la collaboration autour de cette passion. Toute cr\u00e9ation est pens\u00e9e pour \u00eatre gratuite et ne fera jamais l'objet de profits de notre part.</p>"},{"location":"Users-Code-of-Conduct-fr/#regles","title":"R\u00e8gles","text":"<p>Il y a beaucoup de joueurs r\u00e9tro \u00e0 travers le globe appartenant \u00e0 de nombreuses cultures diff\u00e9rentes, aux points de vue et opinions vari\u00e9s. C'est pourquoi, afin de garantir un environnement sain \u00e0 la communaut\u00e9 pour partager cette passion commune des jeux r\u00e9tro, il nous faut nous doter de certaines r\u00e8gles.</p>"},{"location":"Users-Code-of-Conduct-fr/#version-courte","title":"Version courte","text":"<p>Cette version courte devrait suffir \u00e0 la plupart des gens :</p> <ol> <li>Ne soyez pas imb\u00e9cile ou odieux - personne n'aime les trolls.</li> <li>N'utilisez pas notre site Internet ou notre serveur Discord pour partager du mat\u00e9riel faisant l'objet de droits d'auteur ou des informations permettant de le t\u00e9l\u00e9charger.</li> <li>Respectez les th\u00e9matiques de chaque canal Discord et chaque forum du site Internet (nous mettons \u00e0 disposition des sections hors sujet). </li> <li>Quand un mod\u00e9rateur ou un administrateur vous demande de vous arr\u00eater, vous devez vous arr\u00eater.</li> <li>Quand vous avez un doute, posez la question \u00e0 un @mod de Discord ou envoyez un message \u00e0 RAdmin sur le site Internet..</li> </ol>"},{"location":"Users-Code-of-Conduct-fr/#version-longue","title":"Version longue","text":"<p>Si la Version courte n'est pas assez d\u00e9taill\u00e9e pour vous, en voici une plus d\u00e9taill\u00e9e :</p>"},{"location":"Users-Code-of-Conduct-fr/#exemple-de-comportement-attendu","title":"Exemple de comportement attendu","text":"<ul> <li>Se concentrer sur le bien de la communaut\u00e9.</li> <li>Faire preuve d'empathie envers les autres membres de la communaut\u00e9.</li> <li>Faire preuve de respect lorsqu'on exprime son point de vue.</li> <li>Accepter gracieusement les critiques constructives et respectueuses.</li> <li>D\u00e9noncer aux mod\u00e9rateurs et ou administrateurs les situations o\u00f9 les r\u00e8gles ont \u00e9t\u00e9 viol\u00e9es.</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#comportement-socialement-inacceptables","title":"Comportement socialement inacceptables","text":"<ul> <li>Demander ou fournir des liens pour t\u00e9l\u00e9charger du mat\u00e9riel faisant l'objet de droits d'auteur.</li> <li>Spammer ou tenter de vandaliser le serveur Discord ou le site Internet par quelque mani\u00e8re que ce soit. </li> <li>Proposer des produits publicitaires, services ou d'autres serveurs Discord sans approbation.</li> <li>Sectarisme : ce qui inclut le racisme, le sexisme, l'\u00e9litisme, l'intol\u00e9rance, les attaques au sujet de la nationalit\u00e9 de quelqu'un, sa religion, ses orientations sexuelles ou ses ob\u00e9diences politiques, etc.</li> <li>Harc\u00e8lement public ou priv\u00e9.</li> <li>Diffamation au sens de fausses d\u00e9clarations concernant une personne et qui pourraient salir sa r\u00e9putation.</li> <li>Menaces de violences.</li> <li>Avances sexuelles importunes.</li> <li>Poster de la pornographie au sens de toute image ou description d'un comportement \u00e9rotique sens\u00e9 stimuler quelqu'un sexuellement.</li> <li>Poster des images horribles ou gores dans le but de d\u00e9go\u00fbter.</li> <li>Publier les informations personnelles de quelqu'un comme une photo ou l'adresse \u00e9lectronique, sans son accord explicite.</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#comportement-tres-mal-vu","title":"Comportement tr\u00e8s mal vu","text":"<ul> <li>Argumentation publique agressive.</li> <li>Trop de posts de merde.</li> <li>Attaques personnelles au sens de faire des remarques abusives concernant une personne plut\u00f4t que des remarques factuelles.</li> </ul> <p>Les mod\u00e9rateurs interviendront pour calmer le jeu s'il leur semble que la situation commence \u00e0 d\u00e9raper. Consulter ci-dessous Comment fonctionne la mod\u00e9ration.</p>"},{"location":"Users-Code-of-Conduct-fr/#liberte-dexpression","title":"Libert\u00e9 d'expression","text":"<p>Si vous souhaitez juste vous d\u00e9fouler en d\u00e9versant des commentaires p\u00e9joratifs sur notre mani\u00e8re de mener le projet, vous \u00eates libre de le faire. Mais dans la mesure o\u00f9 cela g\u00e9n\u00e8re une d\u00e9motivation et une perte de temps de nos volontaires, nous n'en voulons ni sur nos forums et ni sur notre serveur Discord. Il existe beaucoup d'autres options sur Internet pour le faire.</p> <p>Gardez \u00e0 l'esprit que RetroAchievements.org n'est pas un bastion de la libert\u00e9 d'expression.</p> <p>Si vous avez des critiques \u00e0 formuler, nous serons heureux de les \u00e9couter pour autant qu'elles soient faites de mani\u00e8re respectueuse.</p>"},{"location":"Users-Code-of-Conduct-fr/#comment-fonctionne-la-moderation","title":"Comment fonctionne la mod\u00e9ration","text":"<p>Si vous avez le sentiment qu'une mod\u00e9ration est n\u00e9cessaire, contactez un @mod sur notre serveur Discord ou adressez votre probl\u00e8me \u00e0 RAdmin, une adresse partag\u00e9e par tous les mod\u00e9rateurs.</p> <p>La mission des mod\u00e9rateurs est de s'assurer que tous les utilisateurs respectent le code de conduite des utilisateurs.</p> <p>Que fait un mod\u00e9rateur s'il constate une violation du code de conduite :</p> <ol> <li> <p>Un rappel \u00e0 l'ordre formel et diplomatique (ni sarcasme ni ton mena\u00e7ant).</p> </li> <li> <p>Si le rappel \u00e0 l'ordre est ignor\u00e9, le contrevenant sera renvoy\u00e9 du notre serveur Discord.</p> </li> <li> <p>Si le contrevenant continue d'ignorer la mod\u00e9ration, il sera alors banni de notre serveur Discord. S'il avait le r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet, ses privil\u00e8ges seront r\u00e9voqu\u00e9s.</p> </li> </ol> <p>Note: sur le site Internet, il n'y a pas de \"renvoi\". Si le contrevenant ignore le rappel \u00e0 l'ordre, c'est directement le bannissement.</p> <p>Si vous avez fait l'objet d'un bannissement et souhaitez faire appel de cette d\u00e9cision pour r\u00e9cup\u00e9rer votre acc\u00e8s, envoyez un courriel \u00e0 ramodmail@gmail.com ou directement un message \u00e0 RAdmin.</p>"},{"location":"Users-Code-of-Conduct-fr/#que-faire-si-vous-pensez-que-la-moderation-a-commis-une-erreur","title":"Que faire si vous pensez que la mod\u00e9ration a commis une erreur ?","text":"<p>Si vous pensez que les mod\u00e9rateurs n'ont pas respect\u00e9 les r\u00e8gles \u00e9dict\u00e9es ci-dessus, envoyez un message direct \u00e0 RAdmin ou un courriel \u00e0 ramodmail@gmail.com. Il s'agit d'une adresse partag\u00e9e par tous les mod\u00e9rateurs et les administrateurs. La question sera discut\u00e9e coll\u00e9gialement et \u00e9quitablement.</p> <p>Les administrateurs ou mod\u00e9rateurs qui ne respecteraient pas ou violeraient d\u00e9lib\u00e9r\u00e9ment ce code de conduite devraient faire face \u00e0 des r\u00e9percussions temporaires voire d\u00e9finitives d\u00e9cid\u00e9es par les autres membres de l'administration du projet.</p>"},{"location":"Users-Code-of-Conduct-fr/#tricherie","title":"Tricherie","text":"<p>Consulter les R\u00e8gles concernant le classement global et la chasse aux succ\u00e8s.</p>"},{"location":"Users-Code-of-Conduct-fr/#faq","title":"FAQ","text":"<ul> <li>Quand un membre est banni du serveur Discord, est-il automatiquement banni du site Internet ?</li> <li>J'ai cr\u00e9\u00e9 un serveur Discord car je veux plus de libert\u00e9 que je n'en ai sur le serveur officiel RetroAchievements. Puis-je en faire la promotion ici ?</li> <li>Est-il obligatoire pour un d\u00e9veloppeur de succ\u00e8s de rejoindre le serveur Discord ?</li> <li>Si un cr\u00e9ateur de succ\u00e8s est banni de Discord, perdra-t-il son r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet ?</li> <li>Si je suis banni du serveur Discord mais que je souhaite encore cr\u00e9er des succ\u00e8s, que dois-je faire ?</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#quand-un-membre-est-banni-du-serveur-discord-est-il-automatiquement-banni-du-site-internet","title":"Quand un membre est banni du serveur Discord, est-il automatiquement banni du site Internet ?","text":"<p>Non.</p> <p>Le membre pourra toujours utiliser nos services et jouer \u00e0 des jeux r\u00e9tro afin de d\u00e9bloquer des succ\u00e8s. Toutefois, si le comportement perturbateur devait se prolonger sur le site Internet, il en serait alors \u00e9galement banni.</p>"},{"location":"Users-Code-of-Conduct-fr/#jai-cree-un-serveur-discord-car-je-veux-plus-de-liberte-que-je-nen-ai-sur-le-serveur-officiel-retroachievements-puis-je-en-faire-la-promotion-ici","title":"J'ai cr\u00e9\u00e9 un serveur Discord car je veux plus de libert\u00e9 que je n'en ai sur le serveur officiel RetroAchievements. Puis-je en faire la promotion ici ?","text":"<p>Non.</p>"},{"location":"Users-Code-of-Conduct-fr/#est-il-obligatoire-pour-un-developpeur-de-succes-de-rejoindre-le-serveur-discord","title":"Est-il obligatoire pour un d\u00e9veloppeur de succ\u00e8s de rejoindre le serveur Discord ?","text":"<p>Non.</p> <p>Rejoindre notre serveur Discord est facultatif. Toutefois, si vous vous trouvez sur la liste des membres bannis de Discord, vous ne pouvez pr\u00e9tendre au r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet.</p>"},{"location":"Users-Code-of-Conduct-fr/#si-un-createur-de-succes-est-banni-de-discord-perdra-t-il-son-role-de-developpeur-sur-le-site-internet","title":"Si un cr\u00e9ateur de succ\u00e8s est banni de Discord, perdra-t-il son r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet ?","text":"<p>Oui.</p>"},{"location":"Users-Code-of-Conduct-fr/#si-je-suis-banni-du-serveur-discord-mais-que-je-souhaite-encore-creer-des-succes-que-dois-je-faire","title":"Si je suis banni du serveur Discord mais que je souhaite encore cr\u00e9er des succ\u00e8s, que dois-je faire ?","text":"<p>Envoyez votre appel \u00e0 RAdmin ou ramodmail@gmail.com afin de demander \u00e0 ce que votre bannissement soit lev\u00e9.</p> <p>Il n'est pas important que vous souhaitiez ou non rejoindre le serveur Discord mais si vous \u00eates dans la liste des utilisateurs bannis, vous ne pouvez pas pr\u00e9tendre au r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet. </p>"},{"location":"Users-Code-of-Conduct-pl/","title":"Kodeks Post\u0119powania U\u017cytkownika","text":""},{"location":"Users-Code-of-Conduct-pl/#nasze-standardy","title":"Nasze Standardy","text":"<p>Chcemy wolne, otwarte, pozytywne \u015brodowisko. Pami\u0119taj cz\u0142eku; wszyscy tu jeste\u015bmy aby po\u0142\u0105czy\u0107 si\u0119 wsp\u00f3ln\u0105 pasj\u0105 grania w stare gry!</p>"},{"location":"Users-Code-of-Conduct-pl/#przykady-zachowania-ktore-suzy-do-tworzenia-przyjaznego-srodowiska","title":"Przyk\u0142ady zachowania kt\u00f3re s\u0142u\u017cy do tworzenia przyjaznego \u015brodowiska.","text":"<ul> <li>U\u017cywanie go\u015bcinnego i jasnego j\u0119zyka.</li> <li>Szanowanie innych z r\u00f3\u017cnym punktem widzenia i do\u015bwiadczeniem .</li> <li>\u0141agodne przyjmowanie konstrukcyjnego krytycyzmu .</li> <li>Skupianie si\u0119 na tym, co jest najlepsze dla spo\u0142eczno\u015bci.</li> <li>Pokazywanie empatii innym cz\u0142onkom spo\u0142eczno\u015bci.</li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#nieakceptowalne-zachowanie","title":"Nieakceptowalne zachowanie","text":"<ul> <li>Pytanie czy wysy\u0142anie link\u00f3w do stron gdzie mo\u017cna \u015bci\u0105ga\u0107 nielegalnie ROM-y.</li> <li>Spamienie wiadomo\u015bciami czy pr\u00f3bowanie wandalizowania Discorda czy strony w jaki kolwiek spos\u00f3b.</li> <li>Reklamowanie produkt\u00f3w, us\u0142ug, lub innych serwer\u00f3w discord bez zezwolenia.</li> <li>Dyskryminacja: w to wchodzi rasizm, seksizm, elityzm, nietolerancja innych kraj\u00f3w, religii, orientacji seksualnej, pogl\u0105d\u00f3w politycznych.</li> <li>Publiczne czy prywatne n\u0119kanie, N\u0119kanie na RetroAchievements jest definiowane jako systematyczne lub ci\u0105g\u0142e dr\u0119czenie i poni\u017canie, do takiego stopnia \u017ceby sensowna osoba ba\u0142a si\u0119 wyra\u017ca\u0107 swoje pogl\u0105dy (oczywi\u015bcie, te pogl\u0105dy nie mog\u0105 \u0142ama\u0107 Kodeks Post\u0119powania), ba\u0142a si\u0119 uczestniczy\u0107 w konwersacji, lub o swoje bezpiecze\u0144stwo</li> <li>Oszczerstwo, w sensie rozpowiadania k\u0142amstw na temat osoby aby poni\u017cy\u0107 jej reputacje</li> <li>Gro\u017aby przemoc\u0105</li> <li>Niechciana uwaga seksualna lub podej\u015bcie wobec innych</li> <li>Postowanie pornografii, w sensie zdj\u0119\u0107 lub opis\u00f3w zachowa\u0144 erotycznych w celu wzbudzenia ekscytacji seksualnej</li> <li>Postowanie ohydnych lub krwawych obraz\u00f3w w celu obrzydzenia kogo\u015b</li> <li>Publikowanie czyi\u015b prywatnych informacji, takich jak ich zdj\u0119cia lub fizyczny czy elektroniczny adres, bez jasnego zezwolenia</li> </ul> <p>Takie zachowanie mo\u017ce sko\u0144czy\u0107 si\u0119 dla sprawcy wyciszeniem, wykopaniem, lub banem z serwer Discord lub/i z RetroAchievements.org</p>"},{"location":"Users-Code-of-Conduct-pl/#zle-widziane-zachowanie","title":"\u0179le widziane zachowanie","text":"<ul> <li>Zaci\u0119te publiczne k\u0142\u00f3tnie </li> <li>Nadmierny Shitposting</li> <li>Ataki na osob\u0119, w sensie robienie obra\u017aliwych uwag na lub powi\u0105zane z osob\u0105, zamiast podawanie dowod\u00f3w podczas sprawdzania zarzut\u00f3w lub komentarzy</li> </ul> <p>Moderator wst\u0105pi aby uspokoi\u0107 je\u015bli konwersacja wyjdzie spod kontroli, w takim wypadku moderator mo\u017ce usun\u0105\u0107 komentarze, tymczasowo wyciszy\u0107 u\u017cytkownik\u00f3w , poprosi\u0107 aby porozmawiali prywatnie, lub podj\u0119cie innych akcji kt\u00f3re s\u0105 konieczne aby uciszy\u0107 sytuacje. Zachowaj spok\u00f3j, a wszyscy b\u0119dziemy mieli lepszy czas</p>"},{"location":"Users-Code-of-Conduct-pl/#wyraznie-zezwolone","title":"Wyra\u017anie zezwolone","text":"<ul> <li>Sensowny krytycyzm i kwestionowanie decyzji administracyjnych </li> <li>Sensowna krytyka kreacji tw\u00f3rc\u00f3w osi\u0105gni\u0119\u0107</li> </ul> <p>Podczas robienia publicznej krytyki zachowuj si\u0119 cywilizowanie i nie atakuj os\u00f3b, nie stosowanie si\u0119 do tego b\u0119dzie skutkowa\u0107 moderacj\u0105</p> <p>Dla zdrowia psychicznego i mora\u0142\u00f3w spo\u0142eczno\u015bci spr\u00f3buj aby krytyka by\u0142a zach\u0119caj\u0105ca, konstrukcyjna i optymistyczna.</p>"},{"location":"Users-Code-of-Conduct-pl/#zasady-dla-serwera-discord","title":"Zasady dla serwera Discord","text":"<p>Pozosta\u0144 w temacie kana\u0142u w kt\u00f3rym jeste\u015b, niekt\u00f3re kana\u0142y s\u0105 szczeg\u00f3\u0142owe, a niekt\u00f3re s\u0105 elastyczne. Sprawd\u017a opis kana\u0142u na g\u00f3rze i jak inny u\u017cywaj\u0105 kana\u0142.</p>"},{"location":"Users-Code-of-Conduct-pl/#etyka-forum","title":"Etyka forum","text":""},{"location":"Users-Code-of-Conduct-pl/#opublikuj-to","title":"Opublikuj to!","text":"<ul> <li>Tw\u00f3j post jest na temat i jest bezpo\u015brednio z nim powi\u0105zany</li> <li>Tw\u00f3j post daje nowe pomys\u0142y lub perspektyw\u0119 na temat dyskusji</li> <li>Tw\u00f3j post ma twoje pomys\u0142y i pogl\u0105dy na temat</li> <li>Tw\u00f3j post odpowiada bezpo\u015brednio na czyje\u015b pytania</li> <li>Tw\u00f3j post odkopuje stare uwagi, w kt\u00f3re wierzysz \u017ce potrzebuj\u0105 \u015bwiat\u0142a</li> <li>Tw\u00f3j post ma sensowny krytycyzm czyjego\u015b punktu widzenia lub pomys\u0142\u00f3w</li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#zostaw","title":"Zostaw!","text":"<ul> <li>Trollowanie, lub nabijanie si\u0119 z pozycji czyjej\u015b lub kogo\u015b</li> <li>Niejasne narzekanie</li> <li>Memy, dokuczanie</li> <li>Rozmowy nie na temat lub dyskusji na temat dyskusji</li> <li>Zgadzanie si\u0119 lub zaprzeczanie, bez podawania argument\u00f3w </li> <li>Zaprzeczanie lub krytykowanie czyjej\u015b pozycji bez podawania sensownych kontrargument\u00f3w</li> <li>Spam i posty bez kontekstu</li> <li>Agresywne lub pasywno-agresywne atakowanie pozycji innego rozm\u00f3wcy</li> <li>K\u0142\u00f3cenie si\u0119 lub sprzeciwianie si\u0119 kierunku moderacji</li> </ul> <p>Je\u015bli inni zachowuj\u0105 si\u0119 nieprzyzwoicie nie graj moderatora!</p> <ul> <li>Zamiast pr\u00f3bowa\u0107 si\u0119 przekrzykiwa\u0107, zachowaj dobr\u0105 form\u0119 i stosuj si\u0119 do dobrej etykiety</li> <li>Zamiast m\u00f3wi\u0107 \u017ce spami\u0105/trolluj\u0105/obra\u017caj\u0105/s\u0105 toksyczni zignoruj cz\u0119\u015b\u0107 lub ca\u0142\u0105 wiadomo\u015b\u0107 i skontaktuj si\u0119 z moderatorem (je\u015bli jest taka konieczno\u015b\u0107). Odpowiadanie lub granie moderatora karmi trolla</li> </ul> <p>Je\u015bli czujesz \u017ce moderacja jest konieczna, napisz do [Radmina]((http://retroachievements.org/createmessage.php?t=RAdmin.md), kt\u00f3ry jest kontem moderator\u00f3w</p> <p>Je\u015bli masz problem z jak\u0105kolwiek czynno\u015bci\u0105 moderacji wy\u015blij wiadomo\u015b\u0107 do [Radmina]((http://retroachievements.org/createmessage.php?t=RAdmin.md) lub wy\u015blij maila do ramodmail@gmail.com. To jest wsp\u00f3lne konto kt\u00f3re widz\u0105 admini i moderatorzy, problemy b\u0119d\u0105 przedyskutowane i za\u0142atwione sprawiedliwie </p>"},{"location":"Users-Code-of-Conduct-pl/#konflikty","title":"Konflikty","text":"<p>Jest ok i cz\u0119sto dobrze jak si\u0119 pojawi konflikt, lecz jest wa\u017cne aby by\u0142 on pozytywny, zobacz Hierarchie Niezgody Grahama (I will make the image later), by zobaczy\u0107 co wypada, wszystko pod Zaprzeczeniem nie jest wystarczaj\u0105co dobre na forum, gdy\u017c krytyczny ton, atakowanie innych i wyzwiska nie s\u0105 akceptowane</p>"},{"location":"Users-Code-of-Conduct-pl/#oszukiwanie","title":"Oszukiwanie","text":"<p>Zobacz list\u0119 Globaln\u0105 Tablic\u0119 Wynik\u00f3w i Zasady Zdobywania Osi\u0105gni\u0119\u0107.</p> <p>Konta kt\u00f3rym udowodniono oszukiwanie b\u0119d\u0105 ustawione na \"nie \u015bledzone\", a w niekt\u00f3rych wypadkach banowane.</p> <p>Je\u017ali podejrzewasz kogo\u015b o oszukiwanie, nie r\u00f3b publicznych zarzut\u00f3w. Podziel si\u0119 dowodami z administacj\u0105/moderacj\u0105, lub poczekaj na szczeg\u00f3\u0142ow\u0105 ocen\u0119. Zarzuty oszukiwania mog\u0105 by\u0107 bardzo niszcz\u0105ce dla spo\u0142eczno\u015bci i s\u0105 cz\u0119sto bezzasadne lub nie maj\u0105 wystarczaj\u0105co dowod\u00f3w aby zosta\u0107 ukaranym. Twoje zarzuty pozostan\u0105 anonimowe </p> <p>Naprzyk\u0142ad:_ u\u017cytkownik by\u0142 oskar\u017cony o oszukiwanie, bo ocenie dowod\u00f3w, __, _, _. uznali\u015bmy \u017ce jest wystarczaj\u0105co/niewystarczaj\u0105co dowod\u00f3w  aby by\u0142 nie \u015bledziony.</p>"},{"location":"Users-Code-of-Conduct-pl/#zgaszanie","title":"Zg\u0142aszanie","text":"<p>Przypadki Nieakceptowalnego zachowania lub oszukiwania mog\u0105 by\u0107 zg\u0142aszane do ekipy moderator\u00f3w na serwerze discord RetroAchievements (osoby z niebieskimi  pseudonimami). Mo\u017cesz r\u00f3wnie\u017c skontaktowa\u0107 si\u0119 ze wszystkimi moderatorami/adminami poprzez wysy\u0142anie prywatnej wiadomo\u015bci do U\u017cytkownika Radmin na oficjalnej stronie.</p> <p>Skargi b\u0119d\u0105 sprawdzone, zbadane i zaadresowane zale\u017cnie od okoliczno\u015bci. </p>"},{"location":"Users-Code-of-Conduct-pl/#obowiazki-adminowmoderacji","title":"Obowi\u0105zki admin\u00f3w/moderacji","text":"<p>Admini/moderacja s\u0105 odpowiedzialni za utrzymywanie naszej spo\u0142eczno\u015bci dobrze funkcjonuj\u0105cej. Oni musz\u0105 podtrzymywa\u0107 ten kodeks post\u0119powanie jak i ten Deweloper\u00f3w osi\u0105gni\u0119\u0107 na stronie i na discordzie. Ich obowi\u0105zki na tych dw\u00f3ch frontach s\u0105 opisane poni\u017cej.</p>"},{"location":"Users-Code-of-Conduct-pl/#na-stronie","title":"Na stronie","text":"<ul> <li>poprzez zasady kodeksu post\u0119powania, odrzucanie lub usuwanie<ul> <li>komentarzy</li> <li>osi\u0105gni\u0119\u0107</li> <li>odznak</li> <li>post\u00f3w na forum</li> <li>inne kontrybucje kt\u00f3re nie s\u0105 w tym kodeksie post\u0119powania </li> </ul> </li> <li>\"Nie \u015bledzi\u0107\" u\u017cytkownika kt\u00f3ry zosta\u0142 potwierdzonym oszustem </li> <li>Ostrzega\u0107, banowa\u0107 tymczasowo lub permanentnie cz\u0142onk\u00f3w co \u0142ami\u0105 ten kodeks post\u0119powania nadmiernie, ostrze\u017cenie jest pierwsze w wi\u0119kszo\u015bci przypadk\u00f3w <ul> <li>Kiedy niepoprawne zachowanie jest niejasne, sztab b\u0119dzie dyskutowa\u0142 o tym jakie akcje powinny by\u0107 podj\u0119te</li> </ul> </li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#na-discordzie","title":"Na Discordzie","text":"<ul> <li>Pomaganie gdy kto\u015b o to prosi, najlepiej poprzez pokazywanie strony dokumentacji z odpowiedzi\u0105 (by ludzie u\u017cywali dokumentacji aby znajdywa\u0107 odpowiedzi kt\u00f3rych potrzebuj\u0105).</li> <li>Utrzymywanie kana\u0142\u00f3w w temacie, ale w odpowiednim stopniu rozlu\u017anienia w kana\u0142ach generalnych. \u017beby pozwoli\u0107 na naturalny przep\u0142yw konwersacji </li> <li>Weryfikowanie u\u017cytkownik\u00f3w na Discordzie</li> <li>Zapewnienie aby nazwa u\u017cytkownika by\u0142a taka sama jak na stronie. Akceptowany wyj\u0105tek: <code>DiscordNick (RA_Username)</code>.</li> <li>Zarz\u0105dzanie rolami, jak:<ul> <li>Dawanie roli 'jr-dev' osob\u0105 kt\u00f3re s\u0105 zainteresowane tworzeniem osi\u0105gni\u0119\u0107</li> <li>Dawanie 'developer' osob\u0105 kt\u00f3re maj\u0105 status Dewelopera na stronie.</li> <li>Zarz\u0105dzanie rol\u0105 zwyci\u0119zc\u00f3w 'AOTW'.</li> <li>Zarz\u0105dzanie rolami '*-wiadomo\u015bci'</li> </ul> </li> <li>W wypadku jak kto\u015b \u0142amie kodeks post\u0119powania nagminnie, administrator/moderator u\u017cyje swojego os\u0105du aby wykopa\u0107 tego u\u017cytkownika, pierw dostanie on ostrze\u017cenie w wi\u0119kszo\u015bci przypadk\u00f3w. Je\u015bli wr\u00f3ci i b\u0119dzie si\u0119 dalej \u017ale zachowywa\u0107, zostanie zbanowany<ul> <li>Kiedy nieodpowiednie zachowanie nie jest jasne, sztab wewn\u0105trz przedyskutuje jaka czynno\u015b\u0107 powinna zosta\u0107 podj\u0119ta </li> </ul> </li> </ul> <p>Administatorzy/Moderatorzy kt\u00f3rzy nie przestrzega lub nie egzekwuje kodeksu post\u0119powania mo\u017ce zosta\u0107 tymczasowo lub permanentnie ukarany z za\u0142o\u017cenia innych lider\u00f3w projektu.</p>"},{"location":"Users-Code-of-Conduct-pt_BR/","title":"C\u00f3digo de Conduta dos Usu\u00e1rios","text":""},{"location":"Users-Code-of-Conduct-pt_BR/#nossas-normas","title":"Nossas Normas","text":"<p>N\u00f3s queremos um ambiente aberto, agrad\u00e1vel e acolhedor. </p> <p>Exemplos de comportamentos que contribuem para criar um ambiente adequado incluem:</p> <ul> <li>Usar vocabul\u00e1rio acolhedor e inclusivo;</li> <li>Respeitar diferentes ideias, opini\u00f5es e pontos de vista;</li> <li>Estar aberto a cr\u00edticas construtivas;</li> <li>Focar-se no melhor para a comunidade;</li> <li>Mostrar empatia por outros membros da comunidade.</li> </ul> <p>Exemplos de comportamentos inaceit\u00e1veis incluem:</p> <ul> <li>Compartilhar sites que promovam a pirataria e o download ilegal de ROMs;</li> <li>Trapacear (cheating): qualquer tipo de trapa\u00e7a, salvo quando devidamente especificado na descri\u00e7\u00e3o da conquista ou em coment\u00e1rios na p\u00e1gina da mesma, \u00e9 proibido. Mesmo cheats presentes nos jogos (como menus secretos e c\u00f3digos de invencibilidade), quando n\u00e3o especificados na descri\u00e7\u00e3o ou p\u00e1gina de uma conquista, s\u00e3o considerados trapa\u00e7as. Contas que fizeram, comprovadamente, o uso de trapa\u00e7as ser\u00e3o marcadas como \"Untracked\";     </li> <li>Tentar, intencionalmente, causar instabilidade na comunidade: Incitar \"ca\u00e7a \u00e0s bruxas\", participar de \"tretas\" publicamente onde os argumentos e discordancias deveriam ser resolvidos de maneira particular entre os envolvidos;</li> <li>\"Trollagem\" excessiva, fazer coment\u00e1rios insultantes ou depreciativos, al\u00e9m de ofender moralmente ou politicamente outros usu\u00e1rios;</li> <li>Usar ou compartilhar imagens com conota\u00e7\u00e3o sexual e insinuar-se sexualmente de forma inadequada e abusiva; </li> <li>Assediar de forma p\u00fablica ou privativa;</li> <li>Divulgar, sem explicita permiss\u00e3o, dados pessoais de outros.</li> </ul>"},{"location":"Users-Code-of-Conduct-pt_BR/#responsabilidades-dos-administradores","title":"Responsabilidades dos Administradores","text":"<p>Os administradores t\u00eam o direito e responsabilidade de remover, editar ou rejeitar coment\u00e1rios, conquistas, emblemas, \u00edcones, t\u00f3picos do f\u00f3rum e outras contribui\u00e7\u00f5es que n\u00e3o est\u00e3o de acordo com os termos presentes neste C\u00f3digo de Conduta. Ainda, administradores podem banir, permanentemente ou temporariamente, usu\u00e1rios por outros comportamentos considerados inadequados, amea\u00e7adores, ofensivos ou prejudiciais. Quando um comportamento n\u00e3o for claramente inapropriado, os administradores debater\u00e3o, entre si, para decidir quais medidas ser\u00e3o tomadas.</p> <p>Administradores que n\u00e3o cumprirem ou impuserem, de boa-f\u00e9, o C\u00f3digo de Conduta poder\u00e3o estar sujeitos a san\u00e7\u00f5es, permanentes ou tempor\u00e1rias, determinadas por outros membros da lideran\u00e7a do projeto. </p>"},{"location":"Users-Code-of-Conduct-pt_BR/#comunicacao","title":"Comunica\u00e7\u00e3o","text":"<p>Casos de abuso, ass\u00e9dio, trapa\u00e7as, ou outros comportamentos inadequados podem ser informados aos administradores do RetroAchievements, no servidor Discord por meio de uma Mensagem Direta \u00e0 um dos administradores (usu\u00e1rios com nomes em vermelho). Voc\u00ea tamb\u00e9m pode contatar um administrador enviando uma Mensagem Privada para o usu\u00e1rio RAdmin no site oficial.</p> <p>As reclama\u00e7\u00f5es ser\u00e3o lidas, investigadas e respondidas caso a caso.</p>"},{"location":"Users-Code-of-Conduct-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-10 16:00] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:12] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-04 10:02] meleu:</code> Updated Users Code of Conduct pt_BR (markdown)</li> <li><code>[2018-03-24 11:31] meleu:</code> Updated Codigo de Conduta do Usuario (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct/","title":"Users Code of Conduct","text":"<ul> <li>Mission Statement</li> <li>Rules     - Short Version     - Long Version     - Freedom of Speech</li> <li>How Moderation Works     - What to do if you think moderation is wrong</li> <li>FAQ</li> </ul>"},{"location":"Users-Code-of-Conduct/#mission-statement","title":"Mission Statement","text":"<p>The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. We strive to promote a healthy and collaborative community around this hobby. Everything we produce is made available for free and we will never profit from it.</p>"},{"location":"Users-Code-of-Conduct/#rules","title":"Rules","text":"<p>There's a lot of retrogamers around the globe, spanning various different cultures, points of view, and opinions. Therefore, in order to provide a healthy environment for the community to share their passion for retrogames, we need some rules.</p>"},{"location":"Users-Code-of-Conduct/#short-version","title":"Short Version","text":"<p>This short version should be enough for most people:</p> <ol> <li>Don't be a jerk or generally obnoxious - nobody likes trolls.</li> <li>Don't use our website or Discord server to share copyrighted material or information about where they can be downloaded.</li> <li>Keep the Discord channels and forum threads on-topic (we do have a section for off-topic chatting, though).</li> <li>When a moderator/admin asks you to stop, you should stop.</li> <li>When in doubt, ask a @mod in Discord or send a message to RAdmin on the website.</li> </ol>"},{"location":"Users-Code-of-Conduct/#long-version","title":"Long Version","text":"<p>If the short version is not clear enough for you, here's a detailed one:</p>"},{"location":"Users-Code-of-Conduct/#examples-of-expected-behavior","title":"Examples of expected behavior","text":"<ul> <li>Focusing on what is best for the community.</li> <li>Showing empathy towards other community members.</li> <li>Being respectful when expressing your viewpoint.</li> <li>Gracefully accepting constructive and respectful criticism.</li> <li>Reporting to moderators/admins cases where these rules are being violated.</li> </ul>"},{"location":"Users-Code-of-Conduct/#unacceptable-social-behavior","title":"Unacceptable social behavior","text":"<ul> <li>Asking for or posting links to sites where others could download copyrighted material.</li> <li>Spamming messages or attempting to vandalize Discord or the website by any means.</li> <li>Advertising products, services, or other Discord servers without approval.</li> <li>Bigotry: This includes racism, sexism, elitism; intolerance regarding others' nationality, religion, sexual orientation, political beliefs, etc.</li> <li>Public or private harassment.</li> <li>Defamation, as in making false statements about a person that may injure their reputation.</li> <li>Threats of violence.</li> <li>Unwelcome sexual attention or advances towards others.</li> <li>Posting pornography, as in images or descriptions of erotic behavior intended to cause sexual excitement. </li> <li>Posting gruesome or gory images intended to cause disgust.</li> <li>Publishing others' private information, such as a photos of them or their physical or electronic address, without explicit permission.</li> </ul>"},{"location":"Users-Code-of-Conduct/#behavior-strongly-frowned-upon","title":"Behavior strongly frowned upon","text":"<ul> <li>Heated public arguments.</li> <li>Excessive shitposting.</li> <li>Personal attacks, as in making abusive remarks on or relating to one's person, instead of providing evidence when examining another person's claims or comments.</li> </ul> <p>The moderators will step in to cool things down if arguments start getting out of hand. Check below how moderation works.</p>"},{"location":"Users-Code-of-Conduct/#freedom-of-speech","title":"Freedom of Speech","text":"<p>If you just want to rant or dump derogatory comments about how we run things here, you're free to do that. But, as it's demotivating and wastes a lot of volunteers' time, we don't want it on our forums or Discord Server. There are plenty of options where you can do it around the Internet.</p> <p>Keep in mind that RetroAchievements.org is NOT a bastion of freedom of speech.</p> <p>If you have criticism, you're very welcome to say it, just be sure to be civil.</p>"},{"location":"Users-Code-of-Conduct/#how-moderation-works","title":"How Moderation Works","text":"<p>If you feel moderation is needed, ping the @mod role on our Discord server, or direct your issues to RAdmin, a shared mod-mail account.</p> <p>The moderation goal is to assure users adhere to the User's Code of Conduct.</p> <p>What a moderator should do after seeing a breach to the Code of Conduct:</p> <ol> <li> <p>Formal and diplomatic warning (no sarcasm, no threatening tone).</p> </li> <li> <p>If the warning is ignored, the offender will be kicked from our Discord server.</p> </li> <li> <p>If the offender continues to ignore the moderation, they'll be banned from our Discord server. If the offender has the \"Developer\" role on the website, their privileges will be removed.</p> </li> </ol> <p>Note: on the website there's no \"kick\". If the offender ignores the warning, the next step is a ban.</p> <p>If you've been banned and somehow want to appeal to have your access back, send an email to ramodmail@gmail.com or a Direct Message to RAdmin.</p>"},{"location":"Users-Code-of-Conduct/#what-to-do-if-you-think-moderation-is-wrong","title":"What to do if you think moderation is wrong","text":"<p>If you think moderators are not acting like described above, send a Direct Message to RAdmin or email ramodmail@gmail.com. This is a shared moderation account that all mods and admins see. The issue will be discussed and dealt with fairly.</p> <p>Admins/mods who do not follow or enforce this Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's administration.</p>"},{"location":"Users-Code-of-Conduct/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"Users-Code-of-Conduct/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"Users-Code-of-Conduct/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"Users-Code-of-Conduct/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"Users-Code-of-Conduct/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"Users-Code-of-Conduct/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"Users-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 20:45] televandalist:</code> Removed section on cheating since it was just a redirect to the \"Global Leaderboard and Achievement Hunting Rules\" section, which is in the same category.</li> <li><code>[2021-05-01 20:24] meleu:</code> criticism doesn't need to be DMs to RAdmin</li> <li><code>[2021-05-01 12:05] meleu:</code> rewording stuff</li> <li><code>[2021-05-01 07:30] meleu:</code> reorder short rules</li> <li><code>[2021-05-01 07:22] meleu:</code> list's indentation</li> <li><code>[2021-05-01 07:17] meleu:</code> simpler, clearer and more focused version</li> <li><code>[2020-11-03 19:07] HolyShinx:</code> forgot one word, geez I'm so clumsy ;-;</li> <li><code>[2020-11-03 19:03] HolyShinx:</code> added rule 1, 2 and 4 to Discord Chat Specific Rules from RA discord server</li> <li><code>[2020-09-18 23:03] meleu:</code> no \"public lynching\"</li> <li><code>[2020-05-10 19:34] meleu:</code> Revert 65363acd5c8e6ab50b72985f30a64405b8c96526...72e3510e81ea66c6a90885af39e670f8d9f38b3e on Users Code of Conduct</li> </ul>"},{"location":"Using-Add-Source-and-Deltas-for-Collectibles-or-Similar-Achievements/","title":"Using Add Source and Deltas for Collectibles or Similar Achievements","text":"<p>In this example is a simple way one can utilize the Add Source flag in their achievement logic.</p> <p>We'll look at an achievement from Suikoden (PlayStation) entitled Treasure Hunter - Dragon Knights' Domain:</p> <p>Addresses Used</p> <ul> <li><code>0x1b8244</code>: bit0-bit4 are treasures in Soniere, bit5 is a treasure at the Northern Checkpoint, and bit6-bit7 are treasures at the Dragon Den.</li> <li><code>0x1b8245</code>: bit0 is a treasure at the Dragon Den, bit1-bit5 are treasures at Seek Valley, and bit6-7 are treasures in Kalekka.</li> <li><code>0x1b824b</code>: bit0-bit1 are treasures at the Village of the Hidden Rune, bit2 is unused, bit3-4 are treasures at the Dragon Knights' Fortress, bit5-6 are treasures in Teien, and bit7 is a treasure at Luiken's House. </li> </ul> <p></p> <p>This particular achievement only requires treasures from Dragon Knights' Fortress, Dragon Den, and Seek Valley; therefore, we only need bit6-7 from <code>0x1b8244</code>, bit0-bit5 from <code>0x1b8245</code>, and bit3-bit4 from <code>0x1b824b</code>. </p> <p>Logic Breakdown</p> <ul> <li>There are two groups of ten conditions with the main differences being the Delta type and the total. This is to ensure that the player goes from nine of these treasures obtained to having all ten of these treasures obtained. Note: Remember to use hexadecimal for Add Source totals! </li> <li>Since we're using bitflags here, the totals for individual conditions will only ever be 0x00 or 0x01. Obviously, we want them all to be 0x01 for the trigger, but we don't want someone to get the achievement simply by loading a save with all ten treasures already found.</li> <li>The trigger is the first frame that the player goes from nine to ten treasures obtained. This is to help prevent the achievement from triggering when it's not supposed to.</li> <li>The Measured flag is on the last condition so the player can check how far they are from their goal. If they have eight out of ten treasures, the achievement will show that it is 80% complete in the overlay (RAEmus) or achievement menu (RetroArch). </li> </ul> <p>This method is mostly handy for when the totals between the Delta-type and Mem-type only have a difference of 0x01, but it can be used in various types of achievements: collectibles that are only obtainable one-at-a-time, map completion (such as dungeon-crawlers with viewable maps that get revealed as you enter new areas), learnable skills, bestiaries, completing a certain number of side missions, and many others.</p> <p>If you run into a situation where more than one bitflag in an Add Source chain toggles at the same time, you can still utilize this template. However, you'll want to clone the Delta conditions and make it so both totals create a range. Still using the above achievement as an example, the existing total could be changed to <code>&lt;= 0x09</code> and the total for the second group could be <code>&gt;= 0x05</code>. This would make it so the achievement would trigger if the total goes from 5-9 treasures to 10 treasures.</p> <p>To Do: - Provide a separate example for the Delta range. - Go over using BitCount in a similar achievement. - Go over using <code>/</code> when you need at least one of multiple things.</p>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment-es/","title":"Utilizando Valores Delta y Hit Counts para Detectar un Incremento","text":"<p>Tomemos a Streets of Rage 2 (Mega Drive) como ejemplo, y al logro Steel Grip - Derrota a 10 enemigos sin tirar tu arma. Este se basa en cuatro condiciones:</p> <p>Variables (Addresses)</p> <ul> <li><code>0xef33</code>: sujetando un arma </li> <li><code>0xef37</code>: tipo de arma</li> <li><code>0xef4e</code>: numero de KOs (jugador 1)</li> </ul> <p></p> <p>Condiciones</p> <ol> <li> <p>el jugador esta sujetando un arma. Requerimos que esto sea verdad, una vez. Esto no es realmente necesario, pero es util para mostrar progresi\u00f3n. Necesitamos que el jugador sujete un arma, m\u00ednimo una vez.</p> </li> <li> <p>numero de KOs que el jugador a hecho. Es de 16-bit (esto significa que el valor puede ser mayor a 255), y utilizando un delta y los s\u00edmbolos 'mayor que (greater than)', estamos diciendo que necesitamos que el numero de KOs sea mayor que el valor anterior, y necesitamos que esto pase 10 \u00fanicas veces. Cada vez que el valor actual sea mas grande que el valor anterior, el hit count va a subir por uno. El siguiente frame, el valor 'delta' tiene que incrementarse para ser el mismo que el valor actual, esto asegura que despu\u00e9s de cada baja, el contador de KO se va a subir a uno, y el hit count va a subir a uno. LIMITACI\u00d3N: si el numero de KOs sube sobre dos en el mismo frame, el hit count solo va a subir por uno. Es una peque\u00f1a desventaja que pasa mas com\u00fan de lo que aparenta...</p> </li> <li> <p>Se resetea todo el progreso, si el tipo de arma es diferente al ultimo tipo de arma conocido.</p> </li> <li> <p>Se resetea todo el progreso, si el jugador no se encuentra cargando un arma.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment/","title":"Using Delta Values and Hit Counts to Detect an Increment","text":"<p>Let's take Streets of Rage 2 (Mega Drive) as a case study, and Steel Grip - Defeat 10 enemies without dropping your weapon achievement. This relies on four conditions:</p> <p>Addresses</p> <ul> <li><code>0xef33</code>: holding weapon </li> <li><code>0xef37</code>: weapon type</li> <li><code>0xef4e</code>: number of KOs (player 1)</li> </ul> <p></p> <p>Conditions</p> <ol> <li> <p>the player is holding a weapon. We require this to be true, once. This is actually not necessary, but it's useful to show the progression. We are requiring the player to hold a weapon, at least once.</p> </li> <li> <p>number of KOs that the player has made. It's 16-bit (meaning the value can be more than 255), and by using the delta and 'greater than' symbols, we are saying that we require the number of KOs to be bigger than the previous value, and we need this to happen 10 unique times. Every time the current value is bigger than the previous value, the hit count will go up by one. The next frame, the 'delta' value will have increased to be the same as the current value, this ensures that after every kill, the KO counter will go up by one, and the hit count will go up by one. LIMITATION: if the number of KOs goes up by two in the same frame, the hit count will only go up by one. It's a slight flaw that does happen a little more often than expected... it's not so accurate but it's a fairly close estimate to your number of kills.</p> </li> <li> <p>reset all our progress, if the weapon type is different than the last known weapon type.</p> </li> <li> <p>reset all our progress, if the player is no longer carrying a weapon.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-ResetIf-pt_BR/","title":"Usando Valores Deltas e ResetIf","text":"<p>Link para o texto em ingl\u00eas: Using Delta Values and Hit Counts to Detect an Increment</p> <p>Vamos pegar Streets of Rage 2 (Mega Drive) como um caso de estudo, e o achievement Steel Grip - Defeat 10 enemies without dropping your weapon. Isso depende de quatro condi\u00e7\u00f5es:</p> <p>Endere\u00e7os</p> <ul> <li><code>0xef33</code>: arma em m\u00e3o</li> <li><code>0xef37</code>: tipo de arma </li> <li><code>0xef4e</code>: n\u00famero de KOs (player 1)</li> </ul> <p></p> <p>Condi\u00e7\u00f5es</p> <ol> <li> <p>o jogador est\u00e1 segurando uma arma. Isso deve ser verdadeiro, ao menos uma vez. Isso na verdade n\u00e3o \u00e9 necess\u00e1rio, mas \u00e9 \u00fatil mostrar a progress\u00e3o. Estamos dizendo que exigem que o jogador mantenha uma arma, pelo menos uma vez.</p> </li> <li> <p>n\u00famero de KOs que o jogador fez. \u00c9 16 bits (o que significa que o valor pode ser superior a 255), e usando os s\u00edmbolos delta e 'maior que', estamos dizendo que exigimos que o n\u00famero de KOs seja maior do que o valor anterior, e precisamos disso para aconte\u00e7a 10 unicas vezes. Toda vez que o valor atual \u00e9 maior do que o valor anterior, a contagem de hits aumentar\u00e1 em um. No pr\u00f3ximo quadro, o valor 'delta' aumentar\u00e1 para ser o mesmo que o valor atual, isso garante que depois de cada morte, o contador KO ir\u00e1 subir de um, e a contagem de batidas aumentar\u00e1 em um.  LIMITA\u00c7\u00c3O: se o n\u00famero de KOs aumentar em dois no mesmo quadro, a contagem de batidas aumentar\u00e1 apenas em um.. \u00c9 uma pequena falha que acontece um pouco mais frequentemente do que o esperado ... n\u00e3o \u00e9 t\u00e3o preciso, mas \u00e9 uma estimativa bastante pr\u00f3xima do seu n\u00famero de mortes</p> </li> <li> <p>resete todo o seu progresso, se o tipo de arma for diferente do \u00faltimo tipo de arma conhecida.</p> </li> <li> <p>resete todo seu progresso, se o jogador j\u00e1 n\u00e3o estiver carregando uma arma.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-ResetIf-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-18 17:01] meleu:</code> fix broken link</li> <li><code>[2018-03-25 12:06] KingDice001:</code> Updated Using Delta Values and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:49] KingDice001:</code> Updated Using Delta Values and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Using Delta Values and ResetIf.pt_BR (markdown)</li> </ul>"},{"location":"Using-Hit-Counts-and-ResetIf-pt_BR/","title":"Usando o Contador de Hits e o ResetIf","text":"<p>Link para o texto em ingl\u00eas: Using Hit Counts as a Timer</p> <p>Vamos ver como o achievement Super Hang-On (Mega Drive) Speed Freak - Maintain at least 300kph for 10 seconds aparece no Achievement Editor dialog:</p> <p>Addresses (endere\u00e7os)</p> <ul> <li><code>0x0055a</code>: \u00e9 a velocidade.</li> <li><code>0x0c757</code>: \u00e9 0x00 quando o jogo \u00e9 sem compensa\u00e7\u00e3o (sem pausar).</li> </ul> <p></p> <p>Nesse achievement, desejamos que haja um fato ou condi\u00e7\u00e3o que seja verdadeira 600 vezes consecutivamente. A raz\u00e3o para isso \u00e9 que o Genesis/Mega Drive est\u00e1 travado no processamento de 60 frames de l\u00f3gica por segundo (NTSC pelo menos?). E o fato que estamos procurando \u00e9 que \"a velocidade \u00e9 mais de 300\". Al\u00e9m disso, queremos que o jogador mantenha a velocidade acima de 300 sem pausar o jogo.</p> <p>Condi\u00e7\u00f5es</p> <ol> <li> <p>A velocidade do jogador est\u00e1 acima de 300 para 600 frames (ou 10 segundos se passaram).</p> </li> <li> <p>reset o contador de hit (hit counter) se a velocidade for menor que 300.</p> </li> <li> <p>reset o contador de hit se o jogador pausa o jogo.</p> </li> </ol>"},{"location":"Using-Hit-Counts-and-ResetIf-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-18 16:55] meleu:</code> fix broken link</li> <li><code>[2018-03-25 12:05] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:48] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:48] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-23 01:22] meleu:</code> Updated Using Hit Counts and ResetIf.pt_BR (markdown)</li> </ul>"},{"location":"Using-Hit-Counts-as-a-Timer-es/","title":"Utilizando Hit Counts como un Temporizador","text":"<p>En este ejemplo vas a ver como los hit counts pueden ser utilizados como temporizador y recompensar un logro si la condici\u00f3n es verdadera por 10 segundos.</p> <p>Veamos como en Super Hang-On (Mega Drive) el logro Speed Freak - Manten un minimo de 300kph por 10 segundos se ve en la ventana del Editor de Logros (Achievement Editor):</p> <p>Variables (Addresses)</p> <ul> <li><code>0x0055a</code>: es la velocidad.</li> <li><code>0x0c757</code>: es 0x00 cuando el juego no se encuentra pausado.</li> </ul> <p></p> <p>En este logro, queremos que una condici\u00f3n sea verdadera 600 veces consecutivamente. La raz\u00f3n de esto es que el Sega Genesis procesa fijamente 60 frames de l\u00f3gica por segundo (m\u00ednimo NTSC?). Y tambi\u00e9n estamos buscando que la \"velocidad sea sobre 300\". Y aparte que el jugador mantenga la velocidad sin pausar el juego.</p> <p>Condiciones</p> <ol> <li> <p>velocidad del jugador sea sobre 300 por 600 frames (o que hubieran pasado 10 segundos).</p> </li> <li> <p>resetear el hit counter si la velocidad es inferior a 300.</p> </li> <li> <p>resetear el hit counter si el jugador pausa el juego.</p> </li> </ol>"},{"location":"Using-Hit-Counts-as-a-Timer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Using-Hit-Counts-as-a-Timer/","title":"Using Hit Counts as a Timer","text":"<p>In this example, you'll see how hit counts can be used as a timer and award an achievement if a condition is true for 10 seconds.</p> <p>Let's see what Super Hang-On (Mega Drive)'s achievement Speed Freak - Maintain at least 300kph for 10 seconds looks like in the Achievement Editor dialog:</p> <p>Addresses</p> <ul> <li><code>0x0055a</code>: is the speed.</li> <li><code>0x0c757</code>: is 0x00 when the game is unpaused.</li> </ul> <p></p> <p>For this achievement, we are looking for a condition that is met 600 times consecutively. The reason why is that the genesis is locked into processing 60 frames of logic per second (NTSC at least?). And the condition we're checking is \"speed is over 300\". Also, we want the player to keep the speed above 300 without pausing the game.</p> <p>Conditions</p> <ol> <li> <p>player's speed is above 300 for 600 frames (or 10 seconds have passed).</p> </li> <li> <p>reset the hit counter if the speed goes under 300.</p> </li> <li> <p>reset the hit counter if the player pauses the game.</p> </li> </ol>"},{"location":"Using-a-Conditional-ResetIf/","title":"Using a Conditional ResetIf","text":"<p>Real Example document structure:</p> <p>Brief explanation...</p> <p>Addresses</p> <ul> <li><code>0x123</code>: Note about the address</li> <li><code>0x456</code>: another note</li> </ul> <p></p> <p>Conditions</p> <ol> <li> <p>Explaining each requirement in the achievement's logic.</p> </li> <li> <p>Explanation of requirement 2.</p> </li> <li> <p>Explanation of requirement 3...</p> </li> </ol>"},{"location":"Value-Definition/","title":"Value Definition","text":"<p>Value definitions are used for leaderboards and rich presence.</p> <p>A value is calculated by evaluating one or more memory reads. Read values can be scaled (multiplication) or summed (addition) to arrive at the final value.</p> <p>NOTE: Value calculations are performed using 32-bit signed integers. As such, the maximum value is 2147483647 and the minimum value is -2147483648. Values above the maximum will wrap around and register as very negative numbers. </p>"},{"location":"Value-Definition/#value-from-measured","title":"Value from Measured","text":"<p>Starting with the 0.77 DLL (and RetroArch 1.8.2), you can use the Measured flag to generate a Value. This supports all logic supported by the achievement editor, but every condition must have a flag that somehow influences the Measured value (i.e. AddSource, AddAddress). Note that the Measured condition cannot have a multiplier directly on it. If the final clause needs to be multiplied, use an additional AddSource and Measure 0.</p> <p>VAL: <code>A:0xhfe24_A:0xhfe25*60_A:0xhfe22*3600_M:0</code></p> <p>The example provided above reads:</p> <pre><code>AddSource 8-bit 0xfe24\nAddSource 8-bit 0xfe25 * Value 60\nAddSource 8-bit 0xfe22 * Value 3600\nMeasured  Value 0\n</code></pre> <p>The addresses represent frames, seconds, and minutes respectively, and are individually multiplied and then added together to create a total number of frames that can be submitted to the database.</p>"},{"location":"Value-Definition/#value-from-hitcount","title":"Value from HitCount","text":"<p>Sometimes you want to count the number of times something happens and submit that as the value. You can also do this using Measured syntax. Just add a comparison to your final condition. Do not include an explicit Hit target, or that will be the maximum value that can be submitted.</p> <p>The HitCount on the condition will automatically be set to 0 when the leaderboard starts, and the HitCount will be submitted as the Value when the leaderboard submit trigger activates. You can use PauseIf and ResetIf within the Value conditions to further control the behavior.</p> <p>For example:</p> <pre><code>M:0xH1234!=d0xH1234\n</code></pre> <p>Would submit the number of times the byte at $1234 changed while the leaderboard was active.</p> <pre><code>N:0xH1234!=20_M:0xH1234!=d0xH1234\n</code></pre> <p>Would submit the number of times the byte at $1234 changed to something other than 20 while the leaderboard was active.</p>"},{"location":"Value-Definition/#legacy-syntax","title":"Legacy Syntax:","text":"<p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Before the introduction of the Measured flag, Values were written using their own syntax. Some people still prefer this syntax as it's generally easier to do by hand. A legacy value is the sum of a collection of memory values multiplied by modifiers.</p> <p><code>address*modifier</code> (address times modifier)</p> <p>The <code>_</code> underscore operator separates the individual values and acts as 'plus'. So the example above represents:</p> <pre><code>8-bit 0xfe24 times 1, PLUS\n8-bit 0xfe25 times 60, PLUS\n8-bit 0xfe22 times 3600\n</code></pre> <p>The addresses represent frames, seconds, and minutes respectively, and are individually multiplied and then added together to create a total number of frames that can be submitted to the database.</p> <p>To add a constant, use <code>_vN</code> where N is the constant in decimal (i.e. <code>_v10</code>) will add 10 to the result. You can also use negative values for N (i.e. <code>_v-10</code> will subtract 10 from the result.</p> <p>Tip: modifier can be a non-integer value, so if you need to divide by two, you can multiply by 0.5: <code>0xhfe24*0.5</code></p>"},{"location":"Value-Definition/#modifiers","title":"Modifiers","text":""},{"location":"Value-Definition/#max-of","title":"Max of","text":"<p>Multiple value calculations may be joined with a <code>$</code>. This is similar to alt groups in a trigger, but instead of any one alt group needing to be true, whichever \"alt value\" is largest will be used as the overall value for the expression.</p> <p><code>M:0xH1234$M:0xH1235</code> would return the larger of the values at $1234 or $1235.</p>"},{"location":"Value-Definition/#binary-inversion","title":"Binary Inversion","text":"<p>A single memory reference can be prefixed with a <code>~</code> to perform a binary inversion on it. After reading the value from memory, every bit is switches (0s become 1s, 1s become 0s).</p> <p>Typically, this is used to conditionally add or subtract a value:</p> <p><code>A:0xH1234*~0xM1233_M:0xH1235</code> will add the byte at $1234 to the byte at $1235 if bit0 of $1233 is not set.</p>"},{"location":"Value-Definition/#binary-coded-decimal","title":"Binary Coded Decimal","text":"<p>Binary Coded Decimal (BCD) is when a values in memory is stored as decimal digits in each hex digit location. For example, if the memory inspector shows 86 at a byte in memory, it would normally represent the decimal value 134 (0x86 hex = 134 decimal). BCD decoding the value keeps the individual decimal numbers and the result is 86 (0x86 hex = 86 BCD).</p> <p>You can have the runtime decode BCD values by putting a <code>b</code> prefix in front of the memory reference (i.e. <code>b0xW1234</code>). You still need to specify the size of the BCD memory address. b0x1234 reads a 16-bit value. b0xh1234 reads an 8-bit value and b0xX1234 reads a 32-bit value. NOTE: Support for 16-bit and 32-bit BCD decoding is a feature of the 0.075 toolkit.</p>"},{"location":"Value-Definition/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-02-04 17:41] Jamiras:</code> add link to Condition Syntax</li> <li><code>[2022-02-04 17:34] Jamiras:</code> Updated Value Definition (markdown)</li> <li><code>[2022-02-04 16:52] Jamiras:</code> Updated Value Definition (markdown)</li> <li><code>[2022-02-04 16:41] Jamiras:</code> Updated Value definition (markdown)</li> </ul>"},{"location":"WIP---Dev-Tips---Code-Notes-En-Masse/","title":"WIP---Dev-Tips---Code-Notes-En-Masse","text":"<p>When RAM digging, you may find yourself wishing for a way to do code notes en masse. Unfortunately, there's not a convenient or simple way to do this, but it is possible and can save a ton of time if you are patient enough to learn how.</p> <p>First, we'll look at how local code notes work: - Open the Memory Inspector and the Code Notes windows. - Go to a random address and type something in as a note, but do not publish it. - Check that address in the Code Notes window. You'll notice that your note is red. - Go to the emulator's RACache directory and open the <code>GameID-User.txt</code> file of the game you have running. - Lines that start with <code>N0:</code> are local code notes. Once you publish a note, it will disappear from the <code>GameID-User.txt</code> file.</p> <p><code>N0:address of the note:\"text of the code note\"</code></p> <ul> <li><code>N0:</code> is how the server knows this is a code note.</li> <li><code>address of the note</code> the memory address, obviously. This will be in hex, not decimal.</li> <li><code>:</code> it's just a separator</li> <li><code>\"text of the code note\"</code> - the contents of the code note, and yes, the quotes are required. Line breaks can be used with <code>\\r\\n</code> and quotes within the note can be used with <code>\\\"</code></li> </ul> <p>Now, the next part requires some general know-how with spreadsheets. It will vary per game, so you'll need to figure out the formula for a lot of things yourself. We will use an example, though.</p> <p>Let's say we want to have notes for all character stats. You will need the following: - Character 1's stat addresses. - An offset for Character 1 and Character 2's first stats.</p> <p>We will use Trails in the Sky SC as an example.</p> <p>Character 1 is Estelle, and her stat addresses are as followed:</p> Address \"Character and Stat\" 0xc5bbcc \"[16-bit] Estelle - Current Level\" 0xc5bbd0 \"[16-bit] Estelle - Max HP\" 0xc5bbd4 \"[16-bit] Estelle - Current HP\" 0xc5bbd8 \"[16-bit] Estelle - Max EP\" 0xc5bbda \"[16-bit] Estelle - Current EP\" 0xc5bbdc \"[16-bit] Estelle - Current CP\" 0xc5bbe0 \"[32-bit] Estelle - Current EXP\" 0xc5bbe4 \"[16-bit] Estelle - STR Stat\" 0xc5bbe6 \"[16-bit] Estelle - DEF Stat\" 0xc5bbe8 \"[16-bit] Estelle - ATS Stat\" 0xc5bbea \"[16-bit] Estelle - ADF Stat\" 0xc5bbec \"[16-bit] Estelle - DEX Stat\" 0xc5bbee \"[16-bit] Estelle - AGL Stat\" 0xc5bbf0 \"[16-bit] Estelle - MOV Stat\" 0xc5bbf2 \"[16-bit] Estelle - SPD Stat\" 0xc5bbfa \"[16-bit] Estelle - RNG Stat\" <p>Character 2 is Joshua. His first stat (Current Level) is at the address 0xc5bc08.</p> <p>0xc5bc08 minus 0xc5bbcc is 0x3c, or 60 in decimal. We can confirm this by checking his last stat (RNG), which is 0xc5bc36, also 0x3c/60 from Estelle's last stat.</p> <p>We'll start by putting Estelle's stats into a spreadsheet and adding a column between the addresses and stats. It will look like this (column numbers in parenthesis):</p> Address (A) Blank Column (B) \"Character and Stat\" (C) 0xc5bbcc \"[16-bit] Estelle - Current Level\" 0xc5bbd0 \"[16-bit] Estelle - Max HP\" 0xc5bbd4 \"[16-bit] Estelle - Current HP\" 0xc5bbd8 \"[16-bit] Estelle - Max EP\" 0xc5bbda \"[16-bit] Estelle - Current EP\" 0xc5bbdc \"[16-bit] Estelle - Current CP\" 0xc5bbe0 \"[32-bit] Estelle - Current EXP\" 0xc5bbe4 \"[16-bit] Estelle - STR Stat\" 0xc5bbe6 \"[16-bit] Estelle - DEF Stat\" 0xc5bbe8 \"[16-bit] Estelle - ATS Stat\" 0xc5bbea \"[16-bit] Estelle - ADF Stat\" 0xc5bbec \"[16-bit] Estelle - DEX Stat\" 0xc5bbee \"[16-bit] Estelle - AGL Stat\" 0xc5bbf0 \"[16-bit] Estelle - MOV Stat\" 0xc5bbf2 \"[16-bit] Estelle - SPD Stat\" 0xc5bbfa \"[16-bit] Estelle - RNG Stat\" <p>In cell B1, we'll use the following formula: <code>=hex2dec(A1)</code> to turn the address to decimal. Then we'll drag it down to populate the other cells. It should now look like this (also, added the row column since we'll need it):</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" <p>Now, we'll populate the cells with Joshua's stats using the offset. In cell B17, we will use the formula <code>=B1+60</code>, which will give us <code>12958728</code>. Drag cell B17 to B32. In cell A17, use the formula <code>=dec2hex</code> and drag that down to A32. It should now look like this:</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" 17 0xc5bc08 12958728 18 0xc5bc0c 12958732 19 0xc5bc10 12958736 20 0xc5bc14 12958740 21 0xc5bc16 12958742 22 0xc5bc18 12958744 23 0xc5bc1c 12958748 24 0xc5bc20 12958752 25 0xc5bc22 12958754 26 0xc5bc24 12958756 27 0xc5bc26 12958758 28 0xc5bc28 12958760 29 0xc5bc2a 12958762 30 0xc5bc2c 12958764 31 0xc5bc2e 12958766 32 0xc5bc36 12958774 <p>Now, we'll copy cells C1:C16 and paste them to cells C17:C32. We'll highlight C17:C32 and use the Find &amp; Replace tool (CTRL+H for Google Sheets) to change instances of <code>Estelle</code> to <code>Joshua</code>, but only for that cell range. It will look like this:</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" 17 0xc5bc08 12958728 \"[16-bit] Joshua - Current Level\" 18 0xc5bc0c 12958732 \"[16-bit] Joshua - Max HP\" 19 0xc5bc10 12958736 \"[16-bit] Joshua - Current HP\" 20 0xc5bc14 12958740 \"[16-bit] Joshua - Max EP\" 21 0xc5bc16 12958742 \"[16-bit] Joshua - Current EP\" 22 0xc5bc18 12958744 \"[16-bit] Joshua - Current CP\" 23 0xc5bc1c 12958748 \"[32-bit] Joshua - Current EXP\" 24 0xc5bc20 12958752 \"[16-bit] Joshua - STR Stat\" 25 0xc5bc22 12958754 \"[16-bit] Joshua - DEF Stat\" 26 0xc5bc24 12958756 \"[16-bit] Joshua - ATS Stat\" 27 0xc5bc26 12958758 \"[16-bit] Joshua - ADF Stat\" 28 0xc5bc28 12958760 \"[16-bit] Joshua - DEX Stat\" 29 0xc5bc2a 12958762 \"[16-bit] Joshua - AGL Stat\" 30 0xc5bc2c 12958764 \"[16-bit] Joshua - MOV Stat\" 31 0xc5bc2e 12958766 \"[16-bit] Joshua - SPD Stat\" 32 0xc5bc36 12958774 \"[16-bit] Joshua - RNG Stat\" <p>We can repeat this for the remaining characters, but we'll leave it as is to keep it simple.</p> <p>Remember the syntax: <code>N0:address of the note:\"text of the code note\"</code>. This is how we'll set up the spreadsheet: - Add a column to the left of column A and fill that column with <code>N0:</code>. - Copy cells B1:B32 (which are now the hex addresses). - Right-click on B1 and go to Paste Special -&gt; Values only, or simply press CTRL+SHIFT+V. If you don't do this, the next step will mess everything up. - Clear Column C (which were the decimal addresses) and fill C1:C32 with <code>:</code>. - The sheet should now look like this:</p> Row N0: (A) Address (B) : (C) \"Character and Stat\" (D) 01 N0: 0xc5bbcc : \"[16-bit] Estelle - Current Level\" 02 N0: 0xc5bbd0 : \"[16-bit] Estelle - Max HP\" 03 N0: 0xc5bbd4 : \"[16-bit] Estelle - Current HP\" 04 N0: 0xc5bbd8 : \"[16-bit] Estelle - Max EP\" 05 N0: 0xc5bbda : \"[16-bit] Estelle - Current EP\" 06 N0: 0xc5bbdc : \"[16-bit] Estelle - Current CP\" 07 N0: 0xc5bbe0 : \"[32-bit] Estelle - Current EXP\" 08 N0: 0xc5bbe4 : \"[16-bit] Estelle - STR Stat\" 09 N0: 0xc5bbe6 : \"[16-bit] Estelle - DEF Stat\" 10 N0: 0xc5bbe8 : \"[16-bit] Estelle - ATS Stat\" 11 N0: 0xc5bbea : \"[16-bit] Estelle - ADF Stat\" 12 N0: 0xc5bbec : \"[16-bit] Estelle - DEX Stat\" 13 N0: 0xc5bbee : \"[16-bit] Estelle - AGL Stat\" 14 N0: 0xc5bbf0 : \"[16-bit] Estelle - MOV Stat\" 15 N0: 0xc5bbf2 : \"[16-bit] Estelle - SPD Stat\" 16 N0: 0xc5bbfa : \"[16-bit] Estelle - RNG Stat\" 17 N0: 0xc5bc08 : \"[16-bit] Joshua - Current Level\" 18 N0: 0xc5bc0c : \"[16-bit] Joshua - Max HP\" 19 N0: 0xc5bc10 : \"[16-bit] Joshua - Current HP\" 20 N0: 0xc5bc14 : \"[16-bit] Joshua - Max EP\" 21 N0: 0xc5bc16 : \"[16-bit] Joshua - Current EP\" 22 N0: 0xc5bc18 : \"[16-bit] Joshua - Current CP\" 23 N0: 0xc5bc1c : \"[32-bit] Joshua - Current EXP\" 24 N0: 0xc5bc20 : \"[16-bit] Joshua - STR Stat\" 25 N0: 0xc5bc22 : \"[16-bit] Joshua - DEF Stat\" 26 N0: 0xc5bc24 : \"[16-bit] Joshua - ATS Stat\" 27 N0: 0xc5bc26 : \"[16-bit] Joshua - ADF Stat\" 28 N0: 0xc5bc28 : \"[16-bit] Joshua - DEX Stat\" 29 N0: 0xc5bc2a : \"[16-bit] Joshua - AGL Stat\" 30 N0: 0xc5bc2c : \"[16-bit] Joshua - MOV Stat\" 31 N0: 0xc5bc2e : \"[16-bit] Joshua - SPD Stat\" 32 N0: 0xc5bc36 : \"[16-bit] Joshua - RNG Stat\" <ul> <li>Copy cells A1:D32 and paste them into the <code>GameID-User.txt</code> file.</li> <li>Use Find and Replace to change tabs to an empty space/nothing/blank.</li> </ul> <p>The <code>GameID-User.txt</code> contents now look like this:</p> <pre><code>#.#.#.#\nTrails in the Sky SC\nN0:0xc5bbcc:\"[16-bit] Estelle - Current Level\"\nN0:0xc5bbd0:\"[16-bit] Estelle - Max HP\"\nN0:0xc5bbd4:\"[16-bit] Estelle - Current HP\"\nN0:0xc5bbd8:\"[16-bit] Estelle - Max EP\"\nN0:0xc5bbda:\"[16-bit] Estelle - Current EP\"\nN0:0xc5bbdc:\"[16-bit] Estelle - Current CP\"\nN0:0xc5bbe0:\"[32-bit] Estelle - Current EXP\"\nN0:0xc5bbe4:\"[16-bit] Estelle - STR Stat\"\nN0:0xc5bbe6:\"[16-bit] Estelle - DEF Stat\"\nN0:0xc5bbe8:\"[16-bit] Estelle - ATS Stat\"\nN0:0xc5bbea:\"[16-bit] Estelle - ADF Stat\"\nN0:0xc5bbec:\"[16-bit] Estelle - DEX Stat\"\nN0:0xc5bbee:\"[16-bit] Estelle - AGL Stat\"\nN0:0xc5bbf0:\"[16-bit] Estelle - MOV Stat\"\nN0:0xc5bbf2:\"[16-bit] Estelle - SPD Stat\"\nN0:0xc5bbfa:\"[16-bit] Estelle - RNG Stat\"\nN0:0xc5bc08:\"[16-bit] Joshua - Current Level\"\nN0:0xc5bc0c:\"[16-bit] Joshua - Max HP\"\nN0:0xc5bc10:\"[16-bit] Joshua - Current HP\"\nN0:0xc5bc14:\"[16-bit] Joshua - Max EP\"\nN0:0xc5bc16:\"[16-bit] Joshua - Current EP\"\nN0:0xc5bc18:\"[16-bit] Joshua - Current CP\"\nN0:0xc5bc1c:\"[32-bit] Joshua - Current EXP\"\nN0:0xc5bc20:\"[16-bit] Joshua - STR Stat\"\nN0:0xc5bc22:\"[16-bit] Joshua - DEF Stat\"\nN0:0xc5bc24:\"[16-bit] Joshua - ATS Stat\"\nN0:0xc5bc26:\"[16-bit] Joshua - ADF Stat\"\nN0:0xc5bc28:\"[16-bit] Joshua - DEX Stat\"\nN0:0xc5bc2a:\"[16-bit] Joshua - AGL Stat\"\nN0:0xc5bc2c:\"[16-bit] Joshua - MOV Stat\"\nN0:0xc5bc2e:\"[16-bit] Joshua - SPD Stat\"\nN0:0xc5bc36:\"[16-bit] Joshua - RNG Stat\"\n</code></pre> <ul> <li>Save it.</li> <li>Next time the game is loaded and the Code Notes window is opened, all of those notes will appear in red.</li> <li>If we click Publish at the bottom of the Code Notes window, all of the notes will publish at once.</li> </ul> <p>That's all, folks. Learn some spreadsheet formulas and Regular Expressions and you will become a Code Note guru. Please use responsibly and don't actually save over my Trails in the Sky SC notes. Always spot-check addresses here and there to make sure your formulas stay consistent. I added over 500 code notes to the wrong game using an older method, which was much easier to make mistakes. &lt;3 - tele. </p>"},{"location":"WIP---Dev-Tips---Code-Notes-En-Masse/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-06 20:59] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2024-01-06 20:58] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-25 18:11] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-10 18:49] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-10 18:30] televandalist:</code> Typos</li> <li><code>[2023-04-10 18:25] televandalist:</code> First draft</li> </ul>"},{"location":"WIP-CoC-FAQ/","title":"WIP CoC FAQ","text":""},{"location":"WIP-CoC-FAQ/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"WIP-CoC-FAQ/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"WIP-CoC-FAQ/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"WIP-CoC-FAQ/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"WIP-CoC-FAQ/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"WIP-CoC-FAQ/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"WIP-CoC-FAQ/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-20 00:41] televandalist:</code> Created WIP-CoC-FAQ (markdown)</li> </ul>"},{"location":"WIP-Content-Guidelines/","title":"WIP Content Guidelines","text":"<p>WIP Page. Probably going to separate these into the following: - Game Entries - Achievement Set Requirements (done) - Unwelcome Concepts (done) - Tickets (done) - Hacks - Subsets (done) - Leaderboards &amp; Rich Presence - Hubs</p>"},{"location":"WIP-Content-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-03 03:57] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-06-03 02:00] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-23 22:38] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:59] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:11] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:03] televandalist:</code> Created WIP-Content-Guidelines (markdown)</li> </ul>"},{"location":"WIP-Jr/","title":"WIP-Jr","text":"<p>WIP Page - Combining \"Getting started as an achievement developer,\" \"How to Become an Achievement Developer,\" and \"Set Development Roadmap\" into a sort-of Junior Dev doc.</p> <p>This document covers the basics of how achievements work and the steps one must take to get started with achievement development.</p> <p>Anyone can become a RetroAchievements developer if they put in the effort!</p> <ul> <li>Basic-Concepts</li> <li>Becoming a Junior Developer</li> <li>Choosing a Game to Work On</li> <li>Set Development Roadmap<ul> <li>Initial Research</li> <li>Conceptual Design</li> <li>RAM Digging</li> <li>Achievement Design</li> <li>Pre-Release Steps</li> <li>Release</li> <li>Post-Release</li> </ul> </li> </ul>"},{"location":"WIP-Jr/#basic-concepts","title":"Basic Concepts","text":"<p>So how do RetroAchievements work? Technically, an achievement consists of a series of conditions that make up what we refer to as the <code>achievement logic</code>. When a game with an achievement set is launched in an emulator that supports RetroAchievements, the emulator constantly checks if the conditions of each achievement are met in the current frame of gameplay. When all conditions for a particular achievement are met, the emulator will stop checking the conditions of that achievement and award it to the player.</p> <p>The barebones process of creating achievement logic involves 3 steps: 1. Finding a place in the game's RAM where the information needed for an achievement is stored. Some examples: current level or stage, health, timer, coins, points, ammo, holding a weapon, etc. 2. Creating conditions that must be met in order to award an achievement. 3. Test if the achievement is working as expected.</p> <p>However, this is often much easier said than done. There is a good chance that those steps will need to be repeated many times in order to refine the achievement logic to make it stable enough for players. </p>"},{"location":"WIP-Jr/#becoming-a-junior-developer","title":"Becoming a Junior Developer","text":"<p>If you would like to start developing achievements, the first thing you will need to do is read up on our Developer and Content Guidelines. It is also important to read the various pages in the Achievement Development category, but that can be done as you go. </p> <p>It is strongly recommended to join our Discord server so you can quickly and easily contact other achievement developers who can show you the ropes and help you along. Once you have joined the server, make sure you get verified by following the instructions in the <code>#welcome</code> channel. If you already know what game you'd like to make achievements for, you can go ahead and ask for the <code>jr-dev</code> role in the <code>#tech-support</code> forum channel by creating a post tagged as <code>Join Team</code> and pinging <code>QA-Maintainer</code>. Once you have the <code>jr-dev</code> role, you will have access to the <code>#jr-devs</code> channel, where you can talk to code reviewers and ask any development-related questions.</p>"},{"location":"WIP-Jr/#choosing-a-game-to-work-on","title":"Choosing a Game to Work On","text":"<p>After you have become a Junior Developer, you can decide on a game to work on. If you need an entry made for it, you can ask code reviewers to do so. They will need to open a forum topic for you anyway, assuming it doesn't already have one. You can now claim it for achievement development. </p>"},{"location":"WIP-Jr/#set-development-roadmap","title":"Set Development Roadmap","text":"<p>Once you have chosen your game and have claimed it for development, you need to plan your achievement set. You should know enough about the game to give it justice. The following are some tips on coming up with a plan:</p>"},{"location":"WIP-Jr/#initial-research","title":"Initial Research","text":"<ul> <li>Read through the game manual: Remember those? Game manuals often give insight into the game's story and mechanics.</li> <li>GameFAQs: Check the guides, FAQs, cheats, boards, etc. Soak up the info.</li> <li>Longplays and Speedruns: Seeing others play the game may give you ideas or show you something new.</li> <li>Similar Sets: Does a different port of the game have a set? What's it like? What would you change?</li> </ul>"},{"location":"WIP-Jr/#conceptual-design","title":"Conceptual Design","text":"<ul> <li>Start brainstorming your achievement list. How will you split up the progression achievements? What are the notable events in the game? Are there collectibles? Are there score benchmarks? What secrets/easter eggs are notable enough? Does the game have an internal reward system?</li> <li>Check our guide about Achievement Design</li> <li>Check and test if your designs are possible.</li> <li>Figure out what data you will need to make the achievements. For example: achievements for collectibles will require the RAM addresses where their data is stored.</li> </ul>"},{"location":"WIP-Jr/#ram-digging","title":"RAM Digging","text":"<p>Once you have a plan, it is recommended that you post it in the game's forum topic. This will allow the community to give feedback and will give code reviewers an idea of where you're at from a design standpoint. It is important to be open to receive feedback and suggestions!</p>"},{"location":"WIP-Jr/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 01:59] televandalist:</code> Created WIP-Jr (markdown)</li> </ul>"},{"location":"WIP-Overview/","title":"WIP Overview","text":""},{"location":"WIP-Overview/#overview","title":"Overview","text":"<p>The docs are currently under heavy construction. For starters, the following pages are going to be moved to the site:</p> <ul> <li>RetroAchievements Manifesto</li> <li>Users Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> <li>Developer's Code of Conduct</li> <li>Set Plagiarism</li> <li>Achievement Scoring</li> <li>Achievement Set Revisions</li> <li>Achievements for ROM hacks</li> <li>Subsets</li> <li>Working with the Right ROM</li> <li>FAQ</li> </ul> <p>The plan is to have any documentation involving guidelines/policy as well as a general FAQ be in plain sight on retroachievements.org. Some of the pages will be merged and will result in the following categories:</p> <ul> <li>User Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> <li>Developer Code of Conduct</li> <li>Content Guidelines</li> <li>General FAQ</li> </ul> <p>This will eventually allow for the wiki to be more open and dedicated to support docs, tutorials, resources, etc.</p> <p>From sidebar:</p> <ul> <li>WIP User Code of Conduct</li> <li>WIP CoC FAQ</li> <li>WIP Content Guidelines</li> <li>WIP---Dev-Tips---Code-Notes-En-Masse</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/","title":"User Code of Conduct","text":"<ul> <li>Mission Statement</li> <li>Rules     - Unacceptable Social Behavior     - Freedom of Speech</li> <li>Moderation     - Order of Action     - Reporting Wrongful Action     - Ban Appeal</li> <li>Cheating</li> <li>FAQ</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/#mission-statement","title":"Mission Statement","text":"<p>The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. We strive to promote a healthy and collaborative community around this hobby. Everything we produce is made available for free and we will never profit from it.</p>"},{"location":"WIP-User-Code-of-Conduct/#rules","title":"Rules","text":"<p>In order to support the growth of our community as described in our mission statement, we need some rules.  1. Don't be a jerk or generally obnoxious - nobody likes trolls. 2. Do not use the RetroAchievements website or Discord server to share or request copyrighted material. This includes direct downloads, links to ROM sites, etc. 3. Keep the Discord channels and forum threads on-topic. 4. When a moderator/admin asks you to stop, you should stop. 5. When in doubt, ask a <code>@mod</code> in Discord or send a message to RAdmin on the website. 6. Do not advertise products, services, or other Discord servers without approval.</p>"},{"location":"WIP-User-Code-of-Conduct/#_1","title":"WIP User Code of Conduct","text":"<p>Moderation typically follows a \"three strikes\" warning system, but there are certain behaviors that will not be tolerated and will likely expedite removing someone from the community. These behaviors include, but are not limited to: - Bigotry. This includes racism, sexism, elitism; intolerance regarding others' nationality, religion, sexual orientation, political beliefs, etc. - Public or private harassment. - Unwelcome sexual attention or advances towards others. - Doxing. This is publishing others' private information, such as photos, contact information, etc. without their explicit permission. - Spamming, excessive shitposting, etc. - Personal attacks, as in making abusive remarks on or relating to one's person, instead of providing evidence when examining another person's claims or comments. - Posting pornography, as in images or descriptions of erotic behavior intended to cause sexual excitement.  - Posting gruesome or gory images intended to cause disgust. - Heated public arguments.</p> <p>Please report to moderators/admins cases where these rules and behaviors are being violated. The moderators will step in to cool things down if arguments start getting out of hand.</p>"},{"location":"WIP-User-Code-of-Conduct/#freedom-of-speech","title":"Freedom of Speech","text":"<p>Some people show up just to complain and all admins/mods are evil. We get it. If you want to constantly rant or dump derogatory comments about how we run things here, you're free to do that. However, this can be demotivating and wastes a lot of volunteers' time; therefore, we don't want it on our forums or Discord Server. There are plenty of options where you can do it around the internet.</p> <p>Keep in mind that RetroAchievements.org is NOT a bastion of freedom of speech.</p> <p>Criticism is welcome, but just be sure to be civil.</p>"},{"location":"WIP-User-Code-of-Conduct/#moderation","title":"Moderation","text":"<p>If you feel moderation is needed, ping the <code>@mod</code> role on our Discord server, or direct your issues to RAdmin, a shared mod-mail account.</p>"},{"location":"WIP-User-Code-of-Conduct/#order-of-action","title":"Order of Action","text":"<p>The moderation teams' goal is to assure users adhere to the User's Code of Conduct. If a member from moderation spots an action that is a breach of this Code of Conduct, the following steps will be taken for proper action:</p> <ol> <li> <p>Formal and diplomatic warning via carl-bot. (no sarcasm, no threatening tone).</p> </li> <li> <p>If the warning is ignored, the offender will be kicked from our Discord server.</p> </li> </ol> <p>Note: For website offenses, Step 2 is ignored. If the offender ignores the warning in Step 1, the next action results in a ban as detailed below:</p> <ol> <li>If the offender continues to ignore the moderation, they'll be banned from our Discord server. If the offender has the \"Developer\" role on the website, their privileges will be removed.</li> </ol>"},{"location":"WIP-User-Code-of-Conduct/#reporting-wrongful-moderation","title":"Reporting Wrongful Moderation","text":"<p>If you think moderators are not acting like described above, send a Direct Message to RAdmin or email ramodmail@gmail.com. This is a shared moderation account that all mods and admins see. The issue will be discussed and dealt with fairly.</p> <p>Admins/mods who do not follow or enforce this Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's administration.</p>"},{"location":"WIP-User-Code-of-Conduct/#ban-appeal","title":"Ban Appeal","text":"<p>If you've been banned and want to appeal to have your account access back, please send a site Direct Message to RAdmin. In the event that your site account has been banned, please send an email to ramodmail@gmail.com.</p>"},{"location":"WIP-User-Code-of-Conduct/#cheating","title":"Cheating","text":"<p>Check the Global Leaderboard and Achievement Hunting Rules.</p>"},{"location":"WIP-User-Code-of-Conduct/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"WIP-User-Code-of-Conduct/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"WIP-User-Code-of-Conduct/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"WIP-User-Code-of-Conduct/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"WIP-User-Code-of-Conduct/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"WIP-User-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-30 14:39] televandalist:</code> Updated WIP User Code of Conduct (markdown)</li> <li><code>[2023-06-06 10:44] televandalist:</code> Fix broken link</li> <li><code>[2023-04-20 00:39] televandalist:</code> Created WIP-User-Code-of-Conduct (markdown)</li> </ul>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/","title":"WIP \u2010 How Does RetroAchievements Work","text":"<p>RetroAchievements (RA) provides users the ability to earn achievements in retro games from an RA achievement set.  It awards achievements by comparing a game\u2019s memory, henceforth referred to as RAM, to achievement code written by an RA developer.  Achievement code, also known as logic, is a list of memory conditions chosen by the developer, that when all are simultaneously true on a single frame, will award an achievement.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#what-is-an-achievement-set","title":"What Is An Achievement Set?","text":"<p>An achievement set is the compilation of individual achievements, rich presence and leaderboards for a particular game.  Achievements are comprised of achievement logic, a title, a description, a point value and a badge.  Additionally, a set must contain a Rich Presence script which provides site users information on where active players are in a game.  Sets may have leaderboards that track how well players perform in certain things in a game such as how quickly they can beat stages, how many points they can score and many other things.  RA users interface with all these components and subcomponents.  Each one is a vital part of the player experience.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#what-is-achievement-code-and-how-is-it-written","title":"What Is Achievement Code And How Is It Written?","text":"<p>RA code is a custom text based language that is interpreted by RA supporting emulators.  Developers write code using either the Achievement Editor in the RAIntegration toolkit or by using RATools, a standalone executable that provides a scripting language for achievement development.  Both the achievement editor and RATools produce code that is used for all achievements, leaderboards and Rich Presence.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#how-is-achievement-code-processed","title":"How Is Achievement Code Processed?","text":"<p>A game\u2019s RAM is its most basic form.  RAM is simply the game's memory addresses and their respective values at any given time.  When processed by a console or emulator, the RAM can be used to recognize what is happening within the game.  Games are processed in a series of frames, generally 60, 50, 30 or 25 per second depending on console and format.  RA processes all unearned achievement logic in a set every frame.  Because of this, developers can create logic such that when all of its conditions are simultaneously true, identify something uniquely precise happening in a game and award an achievement, activate a leaderboard and provide accurate Rich Presence.  It is an achievement developer\u2019s job to understand enough of a game's RAM to be able to construct this logic.</p> <p>Understanding how the RAM works that a developer intends to use in their logic is essential to creating a stable set that awards achievements, submits leaderboard scores and accurately displays Rich Presence only as intended.  RA developers use developer emulator tools to inspect a game's RAM and determine which addresses are responsible for things they intend to use for logic.  Developers have many ways to precisely define exactly which memory conditions must be true in order to construct logic, including retaining knowledge that something occurred previously in memory, but may no longer be true.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#achievement-logic-and-processing-example","title":"Achievement Logic and Processing Example","text":"<p>As a simple example, to award an achievement for obtaining the hammer in Zelda II: The Adventure of Link, a developer would need to figure out which memory addresses within the game were associated with a few unique things about obtaining the hammer.  There are often many ways to do this.  One way a developer might approach this achievement is to find the addresses for the room ID to ensure the player is in the room with the hammer, also perhaps an area ID to ensure the player is in the right section of the game and lastly an address that indicates whether the player actually gets the hammer.  The reason a room and area ID are important is because when a player loads a save file that has collected the hammer, the memory would indicate that possessed of the hammer goes from untrue to true, but this isn't where the achievement should award.  The room and area ID conditions would ensure that a player was actually obtaining the hammer in game and not just loading a save file that already possessed it.  A solid achievement could be constructed to award when the following is true simultaneously:</p> <p>Room ID = room the hammer is in Area ID = area of game the hammer is in Possesion of hammer changes from not possessed to possessed</p> <p>Here is what this achievement would look like in the Achievement Editor  In this example, address 0x0561 is the room ID and its value is 0x15 when the player is in the room with the hammer, address 0x076e is the area ID and its value is 0x02 when in Death Mountain where the hammer is located and Bit0 of address 0x078b indicates if the player has the hammer.  This bit changes from 0 to 1 when the player acquires the hammer, so the achievement checks for a frame where this bit is greater than it was the previous frame which is precisely when the hammer is obtained since bits can only be either 1 or 0.  If all three conditions are true on the same frame, the achievement is awarded.  This can only happen when the player obtains the hammer while in the hammer room in Death Mountain, not at some other time such as loading a save file.</p> <p>Every frame the player is playing the game, the RAM is being compared to the achievement logic to check if all conditions are true on that frame.  For this example achievement, all conditions can only be true on the same frame when a player is in the room and area where the hammer is obtained and the player obtains the hammer.  When that happens, all of the conditions defined in the logic will be true and the achievement will be immediately awarded.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#leaderboard-and-rich-presence-code","title":"Leaderboard and Rich Presence Code","text":"<p>Leaderboards function quite similarly to achievements in terms of logic, but need a list of conditions to tell the leaderboard when to activate, when to cancel itself, and when and what value to submit to the leaderboard.  Creating a leaderboard is essentially like creating a few small achievements that will be processed sequentially.</p> <p>Rich Presence code is very similar to achievement and leaderboard code, but is written slightly differently due to the way it is handled by the site.  Rich Presence is written and submitted to RA as a script, as opposed to a string of code like achievements and leaderboards.  It still uses the same fundamental code as achievements and leaderboards, but has some additional features such as custom macros that may be used.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#take-aways","title":"Take Aways","text":"<p>The key to writing solid code is to first understand what in RAM can be used to recognize a particular game event for which a developer intends to award an achievement, use for a leaderboard or Rich Presence.  The next steps are finding the necessary memory addresses and their values to recognize when the event occurs and constructing logic to create a list of conditions that will only be simultaneously true on the intended frame.</p>"},{"location":"Ways-to-Contribute/","title":"Ways to Contribute","text":"<p>If you do not wish to become an achievement developer, but would still like to contribute to RetroAchievements, there are many ways to do so:</p> <ul> <li>Report Broken Achievements<ul> <li>Reporting Via Emulator</li> <li>Reporting Via Website</li> </ul> </li> <li>Suggest Achievement Ideas</li> <li>Give Feedback</li> <li>Create Badges and Game Icons</li> <li>Help with the Documentation</li> <li>Participate in Events</li> <li>Report Title and Description Errors</li> <li>Playtesting</li> <li>Compatibility Testing</li> <li>Write for RANews</li> <li>Create RAGuides</li> <li>Help with RAPatches</li> </ul>"},{"location":"Ways-to-Contribute/#report-broken-achievements","title":"Report Broken Achievements","text":"<p>If an achievement triggered at a wrong time or didn't trigger at all, please report it. We know that many users love free points, but please, even if an achievement triggered at a wrong time, report it!</p> <p>Another important situation that needs to be reported is a cheevo triggering by using some kind of cheat in the game (e.g. stage select code), or by loading a saved game.</p> <p>There are two ways to report a broken cheevo: directly in the emulator or via website. On both cases, add details of the state of your game, when it triggered/didn't trigger, what game mode, where you were when it happened/didn't happen, if you had reset the game recently, anything else you think may be relevant to the achievement. This is necessary for our system so the devs know where there is a problem.</p>"},{"location":"Ways-to-Contribute/#reporting-via-emulator","title":"Reporting Via emulator","text":"<p>Go to RetroAchievements -&gt; Report Broken Achievements, this feature is only available on official emulators (not on RetroArch).</p> <p>See this example:</p> <p>.</p>"},{"location":"Ways-to-Contribute/#report-via-website","title":"Report Via Website","text":"<p>On every achievement's page you see a link saying <code>Report an issue for this achievement</code>, like in the image below:</p> <p></p>"},{"location":"Ways-to-Contribute/#suggest-achievement-ideas","title":"Suggest Achievement Ideas","text":"<p>If you know a game very well, you probably can have some cool ideas of challenges for the game. Post your ideas on the forum topic related to the game.</p> <p>We have a guide on how to think about and design good achievements, not the technical side but the conceptual. Then even non-developers can get some inspiration from that info.</p>"},{"location":"Ways-to-Contribute/#give-feedback","title":"Give Feedback","text":"<p>Give feedback in the forums about what you like or dislike about the achievements sets. Be specific and leave details.</p>"},{"location":"Ways-to-Contribute/#create-badges-and-game-icons","title":"Create Badges and Game Icons","text":"<p>If you like to play with graphics you can create some art for the achievements badges or icons for the games. Using the screenshot feature from the emulator itself can help with this, and then you can edit to make something cool.</p> <p>You can see more info about it on the Badge and Icon Creation page.</p>"},{"location":"Ways-to-Contribute/#help-with-the-documentation","title":"Help with the Documentation","text":"<p>If you have a github account and know the basics of Markdown, you can help with the documentation. Fixing typos, grammar or inaccurate information.</p> <p>Take a look at this page to know the details: Contributing with the docs</p>"},{"location":"Ways-to-Contribute/#participate-in-events","title":"Participate in Events","text":"<p>Such as Achievement of the Week, Leaderboard of the Week or other events that happens on our discord server.</p>"},{"location":"Ways-to-Contribute/#report-title-and-description-errors","title":"Report Title and Description Errors","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#playtesting","title":"Playtesting","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#compatibility-testing","title":"Compatibility Testing","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#write-for-ranews","title":"Write for RANews","text":"<p>Section Pending - for now, see the RANews Repository.</p>"},{"location":"Ways-to-Contribute/#create-raguides","title":"Create RAGuides","text":"<p>Section Pending - for now, see the RAGuides Repository.</p>"},{"location":"Ways-to-Contribute/#help-with-rapatches","title":"Help with RAPatches","text":"<p>Section Pending - for now, see the RAPatches Repository.</p>"},{"location":"Ways-to-Contribute/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:32] televandalist:</code> Updated Ways to Contribute (markdown)</li> <li><code>[2023-06-05 22:29] televandalist:</code> Updated Ways to Contribute (markdown)</li> <li><code>[2023-06-05 21:59] televandalist:</code> Updated Non Developer Contributions (markdown)</li> <li><code>[2023-06-05 21:58] televandalist:</code> Added quick links/ToC - Added WIP sections for Playtesting, Compatibility Testing, RANews, and RAGuides</li> <li><code>[2023-06-05 20:42] televandalist:</code> Renamed from \"How to contribute if you're not an achievement developer\" to \"Ways to Contribute\"</li> </ul>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/","title":"Por que no deber\u00edas utilizar la funci\u00f3n de cargar estado","text":"<p>Nota: actualmente el problema descrito solamente sucede en RetroArch.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#hardcoresoftcore","title":"Hardcore/Softcore","text":"<p>Algunos usuarios les gusta utilizar la funci\u00f3n de guardar/cargar estado para salvar su progreso en un juego. Puede que ya lo sepas pero, esta funci\u00f3n no esta permitida cuando se juega en modo hardcore. Pero algunos usuarios no son jugadores hardcore y prefiero mantener el modo hardcore desactivado (vamos a llamar a este modo como softcore).</p> <p>Algunas veces algunos usuarios reportan que un logro no se desbloqueo, y cuando se les pregunta dicen que estaban jugando en softcore.</p> <p>Una cosa que tienes que tener en cuenta es:</p> <p>Si utilizas la funci\u00f3n de cargar estado espera tener problemas con los logros cuando no se disparan cuando se suponia que se ten\u00edan que disparar.</p> <p>Ahora vamos a intentar explicar para aquellos que no est\u00e1n muy familiarizados con los detalles sobre el desarrollo de logro y por que este tipo de problema ocurre.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#concepto-basico-detras-de-un-logro","title":"Concepto B\u00e1sico detr\u00e1s de un logro","text":"<p>T\u00e9cnicamente un logro es un grupo de condiciones que tienen que ser cumplidas en un frame en particular dentro del v\u00eddeo juego.</p> <p>Cuando abres un juego en un emulador con la funci\u00f3n de RetroAchievements integrada, el emulador esta siempre revisando si las condiciones son cumplidas en el frame actual. Cuando todas las condiciones en el ese logro en particular son cumplidas, el logro es otorgado y el emulador deja de revisar si las condiciones para ese logro.</p> <p>Ejemplos de condiciones:</p> <ul> <li>la barra de vida esta llena</li> <li>la barra de vida se bajo</li> <li>se tienen 9 vidas</li> <li>actualmente estas en el stage 3</li> <li>en la pantalla de titulo del juego</li> <li>se esta empezando una boss fight</li> <li>el juego esta pausado</li> </ul> <p>El problema con softcore es que cuando cargas un estado de guardado puedes arruinar la l\u00f3gica detr\u00e1s del logro.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplos","title":"Ejemplos","text":""},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplo-1-completa-el-juego-sin-utilizar-passwords","title":"Ejemplo 1: Completa el juego sin utilizar passwords","text":"<p>Imag\u00ednate un juego con 5 stages y con la funci\u00f3n de password.</p> <p>Tal vez las condiciones para que el logro \"Completa el juego sin utilizar passwords\" salte son (en un logro de verdad por lo general hay mas condiciones, pero para esta explicaci\u00f3n vamos a considerar solamente estas):</p> <ul> <li>estar en stage 1 (y memoriza este evento como algo que paso)</li> <li>estar en stage 2 (memorizatelo)</li> <li>estar en stage 3 (memorizatelo)</li> <li>estar en stage 4 (memorizatelo)</li> <li>estar en stage 5 (memorizatelo)</li> <li>completa el stage 5</li> </ul> <p>Entonces para conseguir este logro lo que necesitas es estar en todos los niveles al menos alguna vez y completar el juego.</p> <p>Cuando estas en el stage 1, el emulador lo recuerda, y lo mismo para todos los dem\u00e1s stages. Y cuando terminas el stage 5 (completa el juego) obtienes el logro.</p> <p>Ahora imag\u00ednate este escenario:</p> <ul> <li>un jugador softcore empez\u00f3 el juego y jugo los stages 1, 2 y 3</li> <li>el necesitaba dejar de jugar cuando se encontraba en el stage 4 y entonces guardo un estado para continuar despu\u00e9s</li> <li>cerro el emulador</li> <li>despu\u00e9s el pod\u00eda jugar de nuevo, empez\u00f3 el juego y cargo el estado que hab\u00eda guardado</li> <li>jugo los stages 4, 5 y completo el juego</li> </ul> <p>En este escenario el logro no saldr\u00eda.</p> <p>Despu\u00e9s de cerrar el emulador el \"olvida\" lo que paso en los stages 1, 2 y 3. Cuando corres el emulador/juego de nuevo y cargas el estado en el stage 4, el emulador no va a detectar que pasaste por lo stages anteriores. Entonces el logro no se va a desbloquear.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplo-2-derrota-al-jefe-x-sin-recibir-dano","title":"Ejemplo 2: Derrota al jefe X sin recibir da\u00f1o","text":"<p>Lo mas probable es que la condiciones que tienen que ser cumplidas para que este logro salte son:</p> <ol> <li>entra al cuarto del jefe (y memoriza este evento como algo que paso).</li> <li>si se toma da\u00f1o, olvida que se entro al cuarto del jefe.</li> <li>derrota al jefe.</li> </ol> <p>En otras palabras: para obtener este logro el emulador tiene que \"saber\" que entraste al cuarto del jefe, que no obtuviste ning\u00fan da\u00f1o, y que venciste al jefe.</p> <p>El detalle importante en el que tenemos que prestar atenci\u00f3n es: cuando recibes alg\u00fan da\u00f1o, el emulador \"olvida\" que entraste al cuarto del jefe. Entonces incluso si cargaste un estado en alg\u00fan punto en el que aun no recib\u00edas da\u00f1o pero ya estabas dentro del cuarto del jefe, el emulador no va a detectar cuando entras por primera vez al cuarto. Y el logro no va a saltar.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ultimas-palabras","title":"Ultimas Palabras","text":"<p>Cuando reportes logros rotos da la mayor cantidad de detalles que sean posibles, y no olvides si estabas o no jugando en hardcore.</p> <p>Si quieres solicitar que un administrador te otorgue un logro manualmente cuando este no se disparo, ten en cuenta proveer pruebas. Especialmente para logros como en los ejemplos de arriba (no recibir da\u00f1o, no passwords, no muertes, etc).</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-31 10:50] eldexterr:</code> Created Why you shouldn't use the load state feature es (markdown)</li> </ul>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/","title":"Why you shouldn't use the load state feature","text":"<p>Note: currently the issue described here happens only on DuckStation standalone and RetroArch versions older than 1.9.1.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#hardcoresoftcore","title":"Hardcore/Softcore","text":"<p>Some users like to use the save/load state feature to save their progress in a game. As you may know, this feature isn't allowed when playing with hardcore mode. But some users aren't hardcore gamers and prefer to keep hardcore mode disabled (let's call this mode softcore).</p> <p>From time to time some users report that an achievement isn't triggering, and when asked they say they were playing in softcore.</p> <p>One thing you all have to keep in mind is:</p> <p>If you use the load state feature expect to have issues of cheevos not triggering when they are expected to trigger.</p> <p>Here we'll try to explain to those who don't know the details of achievements development why this kind of issue happens.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#basic-concept-behind-an-achievement","title":"Basic concept behind an achievement","text":"<p>Technically an achievement is a group of conditions that must be met in a particular frame of the video game.</p> <p>When you launch a game using an emulator with the RetroAchievements feature, the emulator is always checking if those conditions are met in the current frame. When all conditions for a particular achievement are met, it is awarded and the emulator stops checking the conditions for that achievement.</p> <p>Examples of conditions:</p> <ul> <li>health bar is full</li> <li>health bar decreased</li> <li>have 9 lives</li> <li>currently on stage 3</li> <li>at the title screen of the game</li> <li>starting the boss fight</li> <li>the game is paused</li> </ul> <p>The problem with softcore is that when you load a saved state you can ruin the logic behind an achievement.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#examples","title":"Examples","text":""},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#example-1-beat-the-game-without-passwords","title":"Example 1: Beat the game without passwords","text":"<p>Imagine a game with 5 stages and with the password feature.</p> <p>Some probable conditions to trigger the \"Beat the game without passwords\" achievement are (in a real cheevo there will be more conditions, but for this explanation let's consider only these ones):</p> <ul> <li>be at stage 1 (and memorize this event as something that happened)</li> <li>be at stage 2 (memorize it)</li> <li>be at stage 3 (memorize it)</li> <li>be at stage 4 (memorize it)</li> <li>be at stage 5 (memorize it)</li> <li>finish stage 5</li> </ul> <p>So to get this achievement you have to pass through all stages and then beat the game.</p> <p>When you are at stage 1, the emulator memorizes it, the same thing for all other stages. And when you finish stage 5 (beat the game) you get the achievement.</p> <p>Now imagine this scenario:</p> <ul> <li>a softcore player started the game and played stages 1, 2 and 3</li> <li>they needed to stop playing when at stage 4 and then they saved a state to continue later</li> <li>they closed the emulator</li> <li>later they could play again, started the game, and loaded the state they saved</li> <li>played stages 4, 5 and beat the game</li> </ul> <p>In this scenario, the achievement won't trigger.</p> <p>After closing the emulator it \"forgets\" that you passed through stages 1, 2, and 3. When you run the emulator/game again and load the state being on stage 4, the emulator won't detect that you passed through the previous stages. Then the achievement won't trigger.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#example-2-defeat-boss-x-without-taking-damage","title":"Example 2: Defeat boss X without taking damage","text":"<p>Most likely the conditions to be met in a frame to make this achievement trigger are:</p> <ol> <li>entered the boss room (and memorize this event as something that happened).</li> <li>if the player takes any damage, forget they entered the boss room.</li> <li>beat the boss.</li> </ol> <p>In other words: to get this achievement the emulator must \"know\" that you entered the boss room, didn't take any damage, and beat the boss.</p> <p>The important detail to pay attention to here: when you take any damage, the emulator \"forgets\" that you entered the boss room. Then even if you load a state to a point where you didn't take any damage but already entered the room, the emulator won't detect that you entered the room. And then the achievement won't trigger.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#final-words","title":"Final Words","text":"<p>When reporting a broken achievement give as many details as possible, and don't forget to mention if you are playing on hardcore mode or not.</p> <p>If you want to request an admin to manually award you an achievement that didn't trigger, be sure to provide qualified proof. Especially for achievements like those in the examples above (no damage, no passwords, no death, etc).</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/","title":"Working with DLC for the PlayStation Portable","text":"<p>Various games for the PlayStation Portable support DLC content. Depending on the game, this may come in different formats with different processes for installation.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#standard","title":"Standard","text":"<p>Traditional (generally paid) DLC was installed by the Playstation Store into game directories. Most of the time this will consist of one or more edat files and a param.pbp. Sometimes more files or directories are needed as well. If you already have decrypted DLC in this format, place it in saves/PSP/GAME/&lt;game_id&gt;/ in the exact format it came in. The game ID -must- match the region of the game you're playing. For example, Dissidia 012 will use ULUS10566 for the US version and ULES01505 for the EU version. For users dumping data from real hardware, you'll need to use custom firmware and the npdecrypter plugin to decrypt your DLC to a format usable by PPSSPP. Further information can be found in the plugin's readme.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#save-file","title":"Save File","text":"<p>A number of games distributed (generally free) DLC as extra save files for the games. These will have their own specifically-named directories which are placed alongside your game savedata in saves/PSP/SAVEDATA/. In a few rare cases, there may be multiple sets of DLC that cannot be installed simultaneously for games using this method. For users dumping data from real hardware, just copy it to the same location from the memory stick. Nice and simple. Despite the free nature of this DLC, we don't believe we have the legal rights to distribute it ourselves, so please don't ask.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#updates","title":"Updates","text":"<p>These can be a bit complicated. Currently the only way to apply updates tends to be by patching the update into the iso itself, after decrypting it on real hardware. This is messy and suboptimal, but there isn't a way around it right now. You'll need to open the iso in a tool like UMDGen and insert/replace the updated files in usrdir. Exact per-game instructions on doing so are outside the scope of this guide. Of note, this will be required to be able to use the DLC for Little Big Planet and Bleach: Heat the Soul 7, and may be necessary for other games as well. In the future, this step hopefully can be skipped.</p> <p>Further information: https://github.com/hrydgard/ppsspp/issues/12344</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#killzone-liberation","title":"Killzone Liberation","text":"<p>This game's final chapter is only available as DLC. This specific game had a very strange DLC configuration, requiring downloading a free \"game\" through the PSP's browser, running it to unpack the DLC file, then leaving the second \"game\" present while playing the real one. Unfortunately, it uses a wide variety of kernel calls unique to this game that aren't emulated yet. Even with the DLC in its post-extraction state, it just causes the game to freeze when present. There's no way to emulate the game's final chapter at this time.</p> <p>Further information: https://github.com/hrydgard/ppsspp/issues/12343</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#note","title":"Note","text":"<p>While links to github issues are provided here, please refrain from commenting on them unless you have constructive information to provide about the issues at hand. A simple supportive thumbs up to indicate interest in an issue is sufficient.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-10-01 06:12] Sanaki:</code> Updated Working with DLC for the PlayStation Portable (markdown)</li> <li><code>[2021-10-01 06:08] Sanaki:</code> Hopefully fix a tag issue on the deployed docs</li> <li><code>[2021-09-30 23:26] Sanaki:</code> Created Working with DLC for the PlayStation Portable (markdown)</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/","title":"Trabajando con el ROM apropiado","text":"<p>Relacionado: Logros para hacks de ROM, Sets Bonus</p> <p>Solamente un set es permitido por juego y por consola. Esto es aplica en casos de existente revisiones oficiales (ex. Rev A), parches oficiales, no-oficiales, y otras regiones.</p> <p>Sets Bonus son una excepci\u00f3n de esta esta regla, pero son considerado como una extensi\u00f3n del set est\u00e1ndar y estos siguen reglas diferentes sobre el tipo de logros que son permitidos.</p>"},{"location":"Working-with-the-Right-ROM-es/#seleccion-de-rom","title":"Selecci\u00f3n de ROM","text":"<p>Casi cualquier juego cuenta con m\u00faltiples versiones del ROM , algunas veces asta docenas. Y algunas veces hay diferencias bastante mayores hasta el punto en el que, un ROM ni siquiera es compatible con los logros de otro ROM del mismo juego. Entonces, encontrar el mejor ROM para desarrollar logros es importante y tiene que hacerse cuidadosamente.</p> <ul> <li>Seleccionando la Regi\u00f3n: Cuando sea posible escoge ROMs de <code>NTSC USA</code> no-intro, porque 60 FPS es una experiencia mucho mas fluida. Lanzamientos  <code>PAL Europeos</code> corren a 50 FPS, y la mayor\u00eda de los casos tienen que ser evadidos. Lanzamientos <code>NTSC Japan</code> tambi\u00e9n corren a 60 FPS , pero solamente son la mejor opci\u00f3n si el juego fue exclusivamente   lanzado en Jap\u00f3n.  Utilizar como recurso la versi\u00f3n <code>PAL Europea</code> de un juego deber\u00eda de ser el ultimo recurso (Juego exclusivamente de Europa solamente), y son tipicamente muy pocos juegos y bastante \u00fanicos tambi\u00e9n, de toda la librer\u00eda de la consola. El problema de PAL/NTSC no aplica a la emulaci\u00f3n del GBA, que corre todas las versiones regionales a la misma cantidad de FPS.</li> </ul> <ul> <li>No Mods: No utilizes ROM con una pantalla de inicio modificada/personalizada como Mode7 o RisingSun porque arruinan completamente la RAM.</li> </ul> <ul> <li>No Trainers: No utilices un ROM que incluya soporte para cheats integrado.  Estos son com\u00fanmente referidos como  <code>ROM trainers</code>, no son oficiales, y no son compatibles por Retro Achievements de ninguna manera.</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#no-intro","title":"No-Intro","text":"<p>ROMs de No-Intro son el tipo de ROMs preferidos a ser linkeados a la base de datos de RA, y son los que deber\u00edas de utilizar para hacer tu set cuando sea esto posible. Ellos filtran malos dumps, hacks, fakes, overdumps, underdumps, etc. y solo muestra los ROMs que son mas fieles al cartucho original. ROMs de No-Intro ROMs pueden ser identificados de la siguiente manera:</p> <p>Nombre del Juego (Regi\u00f3n) (Lenguajes Disponibles si es que aplica) (Revisi\u00f3n Actual si es que aplica) Ejemplo:  Diddy Kong Racing (USA) (En,Fr) (Rev A)</p> <p>GoodTools Nombre del Juego (Regi\u00f3n) [!], aunque tambi\u00e9n algunos de los ROMs Nombre del Juego (Regi\u00f3n) (Grupo de Rom Dumpers) son de una era mas temprana y tal vez sean iguales a la base de datos de No-Intro pero no es algo garantizado.</p> <p>Puedes verificar aqu\u00ed que el checksum de tu ROM concuerda con el que se encuentra en la base de datos de No-Intro. Desafortunadamente algunos emuladores de RA no calculan correctamente el checksum (como el de  NES) as\u00ed que tal vez necesites encontrar tu checksum desde otra fuente.</p>"},{"location":"Working-with-the-Right-ROM-es/#parches-de-traduccion","title":"Parches de Traducci\u00f3n","text":"<p>(tambi\u00e9n mira: P\u00f3liza de Localizaci\u00f3n de ROM mas abajo)</p> <p>Ingles es el lenguaje primario de RetroAchievements. Los parches de traducci\u00f3n son algunas veces aplicados por los desarrolladores a t\u00edtulos que no se encuentran en ingles. En estos casos instrucciones de como parchear el ROM se van a encontrar en el foro del juego. Proveer un parche de traducci\u00f3n a un titulo existente permite que el juego sea mas accesible a otros usuarios. Tu tienes que inspeccionar profundamente la memoria para ver si el parche es completamente compatible con el set de logros y as\u00ed mandarlo como aprobaci\u00f3n para que lo cheque un desarrollador y as\u00ed lo pueda postear en el foro del juego.</p> <p>Algunas veces los parches de traducci\u00f3n pueden llegar a diferir cr\u00edticamente del MD5 del desarrollador encontrando as\u00ed diferencias en la memoria original. Antes de linkear estos parches checa con el desarrollador original del juego o haz pruebas profundas en memoria para asegurarte que es completamente compatible. Puedes agregar parches de traducci\u00f3n que te hubieras encontrado en linea mientras todos los logros funcionen de manera correcta y no hagan al juego mas o menos dificil.</p>"},{"location":"Working-with-the-Right-ROM-es/#poliza-de-localizacion-de-rom","title":"P\u00f3liza de Localizaci\u00f3n de ROM","text":"<p>Como Ingles es el lenguaje principal de la comunidad, ROMs en Ingles son preferidos. Cuando escojas que ROM deseas para construir logros entre todas las versiones regionales disponibles tu tienes que darle prioridad a los ROMs No-Intro Americanos para consolas que no son port\u00e1tiles y ROMs Europeos para consolas port\u00e1tiles. </p> <p>Damos la bienvenida y nos gustar\u00eda seguir mejorando nuestro soporte para todas las versiones regionales, especialmente Japones (ya que la mayor\u00eda de nuestra librer\u00eda de juegos fueron creados en Jap\u00f3n). Aparte, algunos usuarios simplemente prefieren versi\u00f3n regional en especifico de un juego y es al final de cuentas es mucho mejor incluir un soporte amplio para que cada buen ROM este linkeado a una buena entrada y as\u00ed se le den los logros apropiados.</p> <p>Cuando miramos en como juegos con diferentes versiones regionales son manejados nuestro est\u00e1ndar es una entrada por juego y por consola. Lo ideal seria que si alguien carga la versi\u00f3n Americana o Japonesa de Donkey Kong, Pac-Man o Contra, la gente consiga los mismos logros para la misma entrada. Pero hay algunas situaciones donde es mejor para nuestra librer\u00eda y jugadores separar las versiones regionales en sus propia entradas \u00fanicas. Si la comunidad tiene la raz\u00f3n en creer que es mejor que una entrada se parta en dos, esto puede ser revisado y aprobado por el equipo de desarrolladores despu\u00e9s de un votaci\u00f3n y discusi\u00f3n.</p>"},{"location":"Working-with-the-Right-ROM-es/#diferencias-de-localizacion","title":"Diferencias de Localizaci\u00f3n","text":"<p>El tipo de cambios hechos durante una localizaci\u00f3n (mas com\u00fanmente de Japones a Ingles) pueden varear bruscamente. Cualquiera de los siguientes cambios pueden ser resultados de una localizaci\u00f3n:</p> <ul> <li>Poquito o realmente ning\u00fan gran cambio;</li> <li>Passwords remplazan el sistema de guardado;</li> <li>Correcci\u00f3n de Bugs;</li> <li>Ligeras o traducciones extensas;</li> <li>Ligeros o cambios cosm\u00e9ticos extensivos incluyendo estos, elementos considerados como ofensivos censurados, cambios en sfx, o assets licenciados cambiados a gen\u00e9ricos, o personajes desconocidos convertidos en personajes de Nintendo (ej. Tetris Attack, Super Mario Bros. 2);</li> <li>Stages agregados, modificados o removidos;</li> <li>F\u00edsicas y mec\u00e1nicas del juego modificadas;</li> <li>Modos de Juego, niveles de dificultad y opciones del juego modificadas o removidas;</li> <li>Cheats o modo debug agregado o removido;</li> <li>El juego fue rebalanceado haci\u00e9ndolo mas f\u00e1cil o mas dificil, algunas veces significativamente;</li> <li>Dos juegos fueron combinados en uno;</li> <li>y mucho mas.</li> </ul> <p>Debido a estas variantes y para evitar llenar la base de datos de entradas duplicadas innecesarias nuestra meta es minimizar el numero de sets separados. Para que un set sea separado necesita razones suficientes; nos tomamos bastante cuidado cuando tenemos que aprobar este tipo de casos.</p>"},{"location":"Working-with-the-Right-ROM-es/#separando-una-entrada-regional","title":"Separando una entrada regional","text":""},{"location":"Working-with-the-Right-ROM-es/#1-obtener-aprobacion-por-medio-del-canal-de-discord-revision-voting-es-requerido","title":"1. Obtener aprobaci\u00f3n por medio del canal de Discord #revision-voting es requerido.","text":"<p>La aprobaci\u00f3n sigue el mismo m\u00e9todo de votaciones como cuando se va a trabajar una revisi\u00f3n, como postear tu plan en el foro del juego y en el canal de Discord de #revision-voting; permitiendo tiempo para discutirlo y esperar las 72 horas para que la mayor\u00eda pueda votar en las votaciones.</p> <p>Recuerda que la meta de reducir la duplicaci\u00f3n de entradas; solo se permite que un set se separe cuando es realmente comprensible.</p> <p>El desarrollador que intente separar un set tiene que tener un fuerte motivo por el que el set merezca una nueva entrada y porque no es posible crear la experiencia que se desea con solamente una entrada.</p> <p>Los Desarrolladores que busquen partir un set tienen que venir con el acto de buena fe. Los Sets tienen que ser partidos por el bien de nuestra librer\u00eda de juegos y la comunidad y no por una manera ego\u00edsta de re-hacer un set o buscar puntos de desarrollador gratis.</p>"},{"location":"Working-with-the-Right-ROM-es/#2-tal-vez-podria-ser-aceptable-separar-un-set-si","title":"2. Tal vez podr\u00eda ser aceptable separar un set si","text":"<ol> <li>Cuenta con grandes cambios est\u00e9ticos a el punto donde puede ser confundido como un juego completamente nuevo.  </li> <li>Cuenta con grandes cambios de balance como cambios significativos en la dificultad.  </li> <li>Cuenta con grandes cambios de contenido como nuevos modos de juego, stages bastante modificados, nuevas abilidades, etc.  </li> <li>Cuenta con grandes cambios en las mec\u00e1nicas.  </li> </ol> <p>Ejemplos de juegos que califican:</p> <ul> <li>Esperando ejemplos de precedentes </li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#3-es-probablemente-no-aceptable-partir-un-set-cuando","title":"3. Es probablemente no aceptable partir un set cuando","text":"<ol> <li>El gameplay, balance, contenido del juego o mec\u00e1nicas est\u00e1n mayormente intactas.  </li> <li>Varias de las versiones examinadas (como Rev A) son de la misma region.  </li> <li>Una versi\u00f3n es ligeramente mas f\u00e1cil/dificil que la otra.  </li> <li>El \u00fanico cambio es una traducci\u00f3n o cambio un nombre.  </li> <li>Cambios cosm\u00e9ticos menores o moderados.  </li> <li>Cheats o modo debug fueron agregados o removidos.  </li> </ol> <p>Considerando todo esto, aun depende de la consideraci\u00f3n de los desarrolladores.</p> <p>Ejemplos de juegos que (probablemente) no califican:</p> <ul> <li>Super Mario Bros. (NES); el lanzamiento J y US es el mismo archivo.</li> <li>Earthbound, Chrono Trigger, Bionic Commando (NES); las (principales) diferencias son ligeramente cosm\u00e9ticas, traducciones y censura.</li> <li>Rockman/Mega Man (NES); la diferencia principal siendo algunos cambios en los sfx y un nuevo titulo y pantalla de titulo.</li> <li>The Legend of Zelda (NES), A Link to the Past (SNES); mas alla de la traduccion, la diferencia principal en la versi\u00f3n Americana es de que varios bugs fueron corregidos.</li> <li>Contra (NES); la version de Famicom tiene fondos animados, mas im\u00e1genes, modo de selecci\u00f3n de stages, etc. La versi\u00f3n E (Europea) tiene un nuevo nombre Probotector y los sprites de personajes y enemigos fueron cambiados por robots.</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#4-despues-de-que-un-set-fue-aprobado-para-ser-partido","title":"4. Despu\u00e9s de que un set fue aprobado para ser partido","text":"<p>No es aceptable simplemente duplicar los sets en dos entradas diferentes. Sets separados tienen que tratarse como una nueva entrada y no un un sub-set (donde los sets Bonus son sub-sets). Estos tienen que tener un sentimiento diferente, retos que hablen de las funciones \u00fanicas del juego que causaron que este se separara en su propia entrada en primer lugar.</p>"},{"location":"Working-with-the-Right-ROM-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-22 10:21] eldexterr:</code> Updated Working with the Right ROM es (markdown)</li> <li><code>[2019-05-20 10:23] eldexterr:</code> Created Working with the Right ROM es (markdown)</li> </ul>"},{"location":"Working-with-the-Right-ROM/","title":"Working with the Right ROM","text":"<p>Related: Achievements for ROM hacks, Subsets</p> <p>Only one achievement set is allowed per game per console. This is true in cases of existing official revisions (ex. Rev 1), official and unofficial fix patches, and alternate regions.</p> <p>Subsets are an exception to this rule, but are considered an extension to a standard set and follow different rules for what types of achievements are allowed.</p> <p>Regional exceptions may exist -rarely- when regional variations massively change the game.</p>"},{"location":"Working-with-the-Right-ROM/#rom-selection","title":"ROM Selection","text":"<p>Almost every game has multiple ROM versions available, sometimes dozens. Often there are major differences under the hood that prevent achievement compatibility between version. Because of this, finding the best ROM for achievements is critical and should be done carefully.</p> <ul> <li>Region Selection: For TV-connected consoles, when possible choose No-Intro (cartridge) or Redump (disc) <code>NTSC USA</code> release ROMs, because 60Hz is a smoother gaming experience and generally matches the intended play speed. <code>PAL European</code> releases run at 50Hz, and are to be avoided in most cases. <code>NTSC Japan</code> releases also run at 60Hz, but are only the best choice if the game was a Japan-exclusive release. <code>PAL European</code> releases should be used as a last resort only (Europe-only exclusive), and are typically limited to a very select few unique games from the entire console's library. Handheld consoles don't have regional timing differences, so language options should be prioritized there whenever possible.</li> </ul> <ul> <li>Revision Selection: Since revisions primarily contain bug and typo fixes, unless you have a -specific- reason not to, always choose the final revision. This will often save both players and developers headaches in the long run. Before working on a game, do a quick search for known revisional changes and take a look at TCRF to see if there's a reason to prefer an earlier revision.</li> </ul> <ul> <li>Ring Codes: Some systems, such as Sega Saturn, have multiple version of the game with different \"ring codes\". These are alphanumeric identifiers stamped on the inner ring of the physical discs. In most cases these will have no functional effect on the game or perhaps even the hash, but as mentioned with Revisions, check to see if there are known differences first.</li> </ul> <ul> <li>Format: For most systems this won't be an issue if you've used verified good dumps. For N64 in particular, games can exist in three formats based on the order of the bytes in the file: n64 (little endian), v64 (byteswapped), and z64 (big endian). Despite producing unique hashes, these three formats are identical for the same dump. Because big endian is the most accurate representation of the N64's cartridges, the big endian (z64) hash -must- be linked for any N64 game, in addition to whatever format you may wish to use personally as a developer. This ensures a single set of roms can consistently be used to play. If required, Tool64 can be used to change byte order.</li> </ul> <ul> <li>Arcade: Arcade ROMs are a bit of a special case because FBNeo mandates the exact contents of the game's archive. When different versions exist, the base version of the name should be preferred in general (for instance, mslug2 should be preferred over mslug2dg or mslug2t). This is merely a guideline, as there may be various reasons to prefer a different version.</li> </ul> <ul> <li>No Mods: Use a clean ROM. Do not use a ROM with a modded/custom launch screen such as Mode7 and RisingSun have because it changes RAM values and complicates users' ability to use their own legally dumped ROMs.</li> </ul> <ul> <li>No Trainers: Do not use a ROM that includes an integrated cheat feature. These are most often refereed to as after-market <code>ROM trainers</code>, are not official, and are not in any way supported by RetroAchievements. These ROMs cannot be linked even as secondary options.</li> </ul>"},{"location":"Working-with-the-Right-ROM/#preservation-groups","title":"Preservation Groups","text":"<p>No-Intro and Redump are the primary groups responsible for verifying clean dumps of console games, excluding all modifications and untrustworthy sources in the process. They offer dat files that can be used to verify your own dumps via a ROM manager. ROMs verified by these groups are preferred whenever possible, and can generally be identified by the following naming scheme:</p> <p>Game Name (Region) (Available Languages if Applicable) (Current Revision if Applicable) Example:  Diddy Kong Racing (USA) (En,Fr) (Rev 1)</p> <p>TOSEC is another less restrictive preservation group. Their hashes often will match Redump for discs, but will frequently contain less thoroughly verified dumps. For floppy discs, cassettes, and less well-known systems where No-Intro and/or Redump verification aren't avaliable, TOSEC is a good fallback choice.</p> <p>You can verify that your ROM checksum matches the databases of No-Intro, Redump, or TOSEC either by using a rom manager with a dat provided by the preferred group or by verifying checksum manually and searching the dat for it in a text editor. Bear in mind that unlike a manual check, the rom manager may be able to skip over external headers to accurately verify integrity. Standard choices are clrmamepro and Romulus.</p>"},{"location":"Working-with-the-Right-ROM/#preferred-groups-per-console","title":"Preferred Groups Per Console","text":"Console ID Console Name Preferred Group 01 GenesisMega Drive No Intro 02 Nintendo 64 No Intro 03 Super NintendoSuper Famicom No Intro 03 Sufami Turbo No Intro 03 Satellaview No Intro 04 Game Boy No Intro 05 Game Boy Advance No Intro 06 Game Boy Color No Intro 07 NESFamicom No Intro 07 Famicom Disk System No Intro 08 TurboGrafx-16PC Engine No Intro 08 SuperGrafx No Intro 08 TurboGrafx-CDPC Engine CD Redump 09 Sega CDMega CD Redump 10 Sega 32X No Intro 11 Master SystemMark III No Intro 12 PlayStation Redump 13 Atari Lynx No Intro 14 Neo Geo Pocket No Intro 14 Neo Geo Pocket Color No Intro 15 Game Gear No Intro 17 Atari Jaguar No Intro 18 Nintendo DS No Intro 21 PlayStation 2 Redump 23 Magnavox Odyssey 2 No Intro 24 Pokemon Mini No Intro 25 Atari 2600 No Intro 27 Arcade Final Burn Neo 28 Virtual Boy No Intro 29 MSX (Cartridges) No Intro 29 MSX (Disks) TOSEC 29 MSX2 (Cartridges) No Intro 29 MSX2 (Disks) TOSEC 33 SG-1000 No Intro 38 Apple II TOSEC 39 Sega Saturn Redump 40 Sega Dreamcast Redump 41 PlayStation Portable Redump 41 PlayStation Portable No Intro 43 3DO Redump 44 ColecoVision No Intro 45 Intellivision No Intro 46 Vectrex No Intro 47 NEC PC-8001 Neo Kobe 47 NEC PC-8001 TOSEC 47 NEC PC-8801 Neo Kobe 47 NEC PC-8801 TOSEC 49 NEC PC-FX Redump 51 Atari 7800 No Intro 53 WonderSwan No Intro 53 WonderSwan Color No Intro 63 Watara Supervision No Intro"},{"location":"Working-with-the-Right-ROM/#translation-patches","title":"Translation patches","text":"<p>(see also: ROM Localization Policy below)</p> <p>English is the Primary language of RetroAchievements. Translation Patches are sometimes applied by developers to non-English titles as the main hash for an achievement set where no licenced English version exists. In these cases patching instructions will be provided in the forum thread of that title. Whenever reasonable, the original unpatched version should still be supported as well.</p> <p>Sometimes translation patches may produce critically different memory from the linked hashes. All linked hashes are expected to be fully supported by the -entire- achievement set. If you can't personally guarantee this, don't link the hash.</p> <p>If you aren't the original developer of the set in question and the developer is active, verify memory personally using testing mode and contact the developer before attempting to add a new translation.</p>"},{"location":"Working-with-the-Right-ROM/#rom-localization-policy","title":"ROM Localization Policy","text":"<p>As English is the primary language of the community, English ROMs are preferred. When choosing which ROM to build achievements for, we give priority to No-Intro or Redump US ROMs for non-handheld consoles and European ROMs for handheld consoles. </p> <p>We would like to continue improving our support for all regional versions, especially Japanese (as the majority of our game library was created in Japan). Some users may also prefer a specific regional version of a game and it is better to include broad support so that any good ROM can link to a good entry and give appropriate achievements. That said, regional variants must still be fully supported, and 50Hz slowdown needs to be mitigated (via additional patches) or proven to be a non-issue when present.</p> <p>When looking at how games with regional versions are handled, our standard is one entry per game per console. It is ideal that if a player loads up the US or Japanese version of Donkey Kong, Pac-Man, or Contra, they will earn the same achievements from the same entry. As mentioned above, there are some extremely rare situations where it is better for our library and players to split off regional versions into their own unique entry. If the community has reason to believe that it's better for an entry to be split, it can be reviewed and approved by the RetroAchievements staff.</p> <p>Tip: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions, making multi-region support difficult.</p>"},{"location":"Working-with-the-Right-ROM/#localization-differences","title":"Localization Differences","text":"<p>The types of changes made during localization (most commonly from Japanese to English) can vary wildly. Any of the following changes may result from a localization:</p> <ul> <li>Little or no change at all;</li> <li>Passwords replace battery saves;</li> <li>Bugs fixed;</li> <li>Light or extensive translations;</li> <li>Light or extensive cosmetic changes including \"offensive\" elements being censored, sfx changes, licenced assets being replaced with generic ones, and/or unknown characters becoming Nintendoed (e.g. Tetris Attack, Super Mario Bros. 2);</li> <li>Stages added, modified or removed;</li> <li>Game physics and game mechanics modified;</li> <li>Game modes, difficulty levels and game options added or removed;</li> <li>Cheat codes or debug modes added or removed;</li> <li>Game rebalancing resulting in a harder or easier experience, sometimes significantly so;</li> <li>Two games combined into one;</li> <li>And more.</li> </ul> <p>Because of this variation and to avoid filling the database with unnecessary duplicates, our goal is to minimize the number of split sets. For a set to be split it needs compelling reasons; we take great care to determine when to approve these splits.</p>"},{"location":"Working-with-the-Right-ROM/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-12 18:39] shigutso:</code> Added PS2 on preferred group list</li> <li><code>[2022-02-25 20:41] televandalist:</code> Changed bonus set link to subset link - added a preferred group table for each console</li> <li><code>[2020-06-02 06:00] Sanaki:</code> Added revision and N64 format guidelines, removed entire section on region splitting procedure, made numerous grammar and detail updates</li> <li><code>[2019-08-13 19:49] Kvon:</code> Working with the right rom: text hooking tip added</li> <li><code>[2019-05-03 11:30] meleu:</code> typo</li> <li><code>[2019-05-03 10:55] meleu:</code> merge \"ROM Localization Policy\" into here</li> <li><code>[2018-11-17 08:07] Kvon:</code> changed one word, for clarifcation</li> <li><code>[2018-09-17 17:56] meleu:</code> capital 'R' in the title (Right)</li> </ul>"},{"location":"Writing-Policy/","title":"Writing Policy for Achievements and Leaderboards","text":""},{"location":"Writing-Policy/#achievement-titles","title":"Achievement Titles","text":"<p>Language It is required for all of your achievement titles to be in English. There are some exceptions to this rule however:</p> <ul> <li>QA approval needed: Using another language besides English could be more appropriate in specific cases to give more personality to your achievement set. For example, when the achievement references an existing country or fits a theme where the usage of Latin or \u201cOld English\u201d would make sense. However, it is required to reach out to QA with your reasoning for approval.</li> <li>No QA approval needed: There are both English and non-English games that have in-game foreign language, be it made-up by the developers or directly referencing another existing language. For the ease of comparison, such as songs in Rhythm games and items in other games, it may be more beneficial for the player to have the in-game usage and achievement title match each other.</li> </ul> <p>Capitalization For capitalization in titles, we recommend using https://capitalizemytitle.com/style/chicago/. This will capitalize every word that should be capitalized. While this may not always give perfect results on longer achievement titles, for consistency it is recommended to choose this option when unsure about which words to capitalize, with the recommended style being either Chicago or MLA for the most aesthetically pleasing results.</p> <p>Punctuation Since achievement titles are not full sentences, they should not end with punctuation. Exceptions to this include an exclamation or question mark, as well as the usage of ellipses (three periods) to emphasize there is more to the story or idea.</p> <p>Emojis Adding emojis to achievement titles is not allowed. Not only will they reduce readability, but as unicode they are also more prone to breaking in emulators, as well as on the site depending on what language the user currently has enabled on their desktop, or what browser they are using. Keep in mind that emoticons (e.g. :-], &lt;3) are also not allowed.</p> <p>Creative Titles Creative titles for achievements are more enjoyable for players than exact descriptions of what the players must do to obtain the achievement. If you\u2019re not sure how to add some style to your achievements, you can review the list below for some ideas.</p> <ul> <li>Themes - A good theme can help you name a lot of similar achievements in a way that communicates their similarity while also being interesting. Themes can also be combined with the other writing techniques in this list.<ul> <li>Example 1: Pokemon Pinball\u2019s achievements for catching specific groups of Pokemon (catch Bulbasaur, Squirtle, and Charmander, etc.) have a theme of \u201cgroup words\u201d that unites them. \u201cRoute 2 Gang\u201d, \u201cAngry Crew\u201d, \u201cBrock\u2019s Brotherhood\u201d, all of these titles convey that the achievements are similar, while also communicating the specific flavor of each achievement.</li> <li>Example 2: Dragon Quest 2 (NES)\u2019s achievements all use the same silly \u201cOld English\u201d that the game itself does. If your game has a distinctive writing style of its own, consider theming your achievement titles to match.</li> </ul> </li> </ul> <ul> <li>Rhyme and Alliteration - Rhyme and alliteration are easy ways to construct achievement titles that are nice to read. Take a word relevant to what the player is doing, and attach it to another word or phrase that starts with the same letter or rhymes with the first word. This additional word or phrase should usually be related to what is going on in the game during the section related to the achievement, but doesn\u2019t have to be.<ul> <li>Example 1: A boss is named Sanson and you have made an achievement for defeating him. Since his name starts with an S, you can use alliteration to name the achievement \u201cSanson Slayer\u201d or \u201cSo Long, Sanson\u201d.</li> <li>Example 2: A boss is named Lance and you have made an achievement for defeating him. A lot of words rhyme with his name, so you can come up with a variety of creative titles, such as \u2018\u2019The Last Dance of Lance\u2019\u2019 or \u2018\u2019No Romance For Lance\u2019\u2019.</li> </ul> </li> </ul> <ul> <li>Progression and Grouping - Do you have multiple achievements for the same objective but with higher numbers, such as increasing the score with increments? Consider using a consistent naming scheme, such as good - great - excellent. Something similar can also be used for achievements following the exact same structure, such as achievements that ask you to get every treasure chest in a dungeon. Depending on how many there are, using a similar naming scheme for each such as \u201cTreasure Hunter: Fire Cave\u201d keeps them neatly together.</li> </ul> <ul> <li>References - References are always a fun idea for achievements, especially when you are designing achievements for a game of a bigger franchise. If the same level appears in an earlier/later game for example, using a title that emphasizes that familiarity will always be pleasing to fans of the game. Please keep in mind that references to current events in the world as well as memes are generally discouraged due to them eventually losing relevance.<ul> <li>Example 1: There is a zone called Default Zone in game 1, and game 2 has another variation of it. \u201cThis Looks\u2026 Familiar\u201d could therefore be a good title.</li> <li>Example 2: In the animated TV series of the game you are developing for, when defeating the villain he screams \u2018\u2019This Isn\u2019t the End!!!\u2019\u2019. Making that the title or a variation such as \u2018\u2019Actually, This Is the End!\u2019\u2019always works.</li> </ul> </li> </ul> <ul> <li>Puns - Puns can give a lot of life to an otherwise boring achievement title. To construct a pun, take a word that is related to what the player is doing to earn the achievement and combine it with another common word or phrase in a humorous way.<ul> <li>Example 1: There is an elephant boss that has no relevance to the story. The achievement title could use something with the word \u2018\u2019irrelephant\u2019\u2019, like \u2018\u2019That Was Irrelephant!\u2019\u2019</li> <li>Example 2: There is an achievement for killing 50 enemies that are skeletal. Skeleton bones usually have marrow, so an example of an achievement title could be \u201cMarrow-Minded\u201d.</li> </ul> </li> </ul> <ul> <li>In-game achievement system names - Some games have an in-game achievement system. Using the names these in-game achievements come with is a solid option to use.</li> </ul> <ul> <li>Just describing what happens in a fancy way - The last and perhaps most boring creative option is to just describe what happens in a fancy way. Sometimes doing just that results in a solid title as well, and it can very well be combined with puns, references, and rhyming.<ul> <li>Example 1: Something in the story happens that results in a permanent night. Titles that could work here are \u2018\u2019The Cold Embrace of Darkness\u2019\u2019, \u2018\u2019The Disappearance of Warmth\u2019\u2019 etc.</li> </ul> </li> </ul>"},{"location":"Writing-Policy/#achievement-descriptions","title":"Achievement Descriptions","text":"<p>Language Achievement descriptions, just like titles, are expected to be in English completely. Unlike titles however, it is not allowed under any circumstances to use another language even when it fits the achievement, with the only exception being in-game items and songs for comparing purposes. Everyone should be able to understand a description without the necessity to look up any other language than English.</p> <p>Capitalization In general, only the first letter of a new sentence is capitalized. In English, words are not capitalized due to their type (noun, verb, etc.) or for emphasis, unlike in some languages. Of course, there are exceptions to this:</p> <ul> <li>Names - A person\u2019s names should almost always be capitalized.<ul> <li>Examples: John Smith, Samus Aran, Bowser</li> </ul> </li> </ul> <ul> <li>Titles  - When you are naming a person who has an honorary title or degree, the first letter of the title should be capitalized and ended with a period if it is an abbreviation.<ul> <li>Examples: Dr. Tree, Mrs. Stone, General Shrub</li> </ul> </li> </ul> <ul> <li>In-universe names - Named levels or locations, objects specific to a game or franchise, and character names including bosses should usually be capitalized. However, they should only be capitalized when the game itself does so, and when it is a specific object in that game.<ul> <li>Do NOT capitalize if:     - A level is called \"1-1\". Therefore, it should be \u2018\u2019level 1-1\u2019\u2019.     - There is a generic arrow to be found. Therefore, it should be \u2018\u2019arrow\u2019\u2019.</li> <li>DO capitalize if:     - The level is called \u2018\u2019Level 1-1\u2019\u2019. Due to the game marking that as its full name, it must be capitalized as \u2018\u2019Level 1-1\u2019\u2019.     - The game gives you a variation of a regular arrow called the Ice Arrow. Given its specific name, it must be capitalized as \u2018\u2019Ice Arrow\u2019\u2019.     - The game contains a specific item named \u201cArrow\u2019\u2019. The game usually capitalizes this item when this is the case, and so should you.</li> </ul> </li> </ul> <p>Punctuation Whether or not your achievement descriptions end in periods is up to you, but generally, it is preferred for achievement descriptions to not end with periods. However, consistency across a set is key, so please avoid having some achievement descriptions end in periods while others don\u2019t.</p> <p>Abbreviations</p> <p>Abbreviations should generally only be used for honorary titles or degrees such as Dr. and Mrs. The exception to this rule is when the achievement description you are creating involves an abbreviation being used in-game. Examples include 1P mode (One player mode), ATK stat (Attack stat), and named objects such as the BFG. Do not abbreviate single words such as difficulty to dif, seconds to secs, levels to lvls etc. unless the game itself does.</p> <p>Brackets/Parentheses Brackets have often been used by developers to note conditions that have to be met, such as being on a specific difficulty or playing a specific game mode. While there are situations where this is appropriate, for example when there are too many conditions to make a coherent description that doesn\u2019t result in a long list of \u2018\u2019ands\u2019\u2019, achievement descriptions are easier to read and more stylish when presented as a single phrase or sentence rather than divided into multiple parts through the use of brackets and parentheses.</p> <p>When there are only a few conditions, we ask you to write your descriptive sentence to include this condition naturally.</p> <p>Example of how you should write the description: \u2018\u2019Beat the game on hard difficulty without losing a life\u2019\u2019. Example of how you should NOT write the description: \u2018\u2019Beat the game without losing a life [hard difficulty]\u2019\u2019.</p> <p>Symbols and Emojis Just like with brackets, symbols have been used to describe conditions but are also discouraged. The most common ones are to describe a condition being lower (&lt; / &lt;=) or higher (&gt; / =&gt;). For this, we also ask you to rewrite the text of the description with this condition in mind. </p> <p>Example of how you should write the description: \u2018\u2019Beat the game on hard mode without losing more than five lives\u2019\u2019. Example of how you should NOT write the description: \u2018\u2019Beat the game on hard mode [lives lost &lt;= 5]\u2019\u2019.</p> <p>Just like achievement titles, the usage of emojis is not allowed in descriptions.</p> <p>Quotation Marks Quotation marks are used on RetroAchievements mostly to wrap works such as movies, books, and songs, seen commonly in Rhythm games for example. Other uses may include to set apart a specific word for irony or sarcasm, differentiate a nickname from a given name, or directly taking a quote from somewhere.</p> <ul> <li>Wrapping works example: Finish the track \u201cOver the Mountain\u201d with an A rank or higher.</li> <li>Irony/sarcasm example: Finish off the \u201ctough\u201d demon.</li> <li>Differentiate a nickname: Help out T.K. \u201cDance King\u201d Johnson with his new movie.</li> </ul> <p>You should ONLY use double quotation marks. Single quotation marks are only used for quotes within quotes, and should not be used elsewhere.</p> <p>Consistency As an international community, we don\u2019t expect every developer to write with perfect grammar, or to agree exactly on what perfect grammar is. Simple and relatively universal guidelines of English grammar, like leaving a space after a comma, should be followed closely. However, more obscure or controversial guidelines, such as the Oxford Comma (the final comma in a list of things, often placed before the final entry starting with \u201cand\u201d), are not a necessity. However, please be consistent within a set in your usage of grammar. Do not use the Oxford Comma in one achievement while not using it in another where it would also be appropriate.</p> <p>Consistency is also preferred in the use of common words to describe an achievement. For finishing a level or boss for example, the most common words used are \u201cbeat\u201d, \u201cfinish\u201d, \u201cclear\u201d, \u201cdefeat\u201d as well as a few others. Please only use one of them when working with multiple achievements that have the same theme - if the achievement description for finishing level 1 says \u201cDefeat the boss of level 1\u201d, the achievement description for level 2 shouldn\u2019t say \u201cBeat the boss of level 2\u201d unless there is a good reason to use the different word. Stick to using the same words to describe the same things within a group of similar achievements.</p> <p>If a challenge condition, such as \u201con normal difficulty or higher\u201d or \u201cno cheats\u201d, applies to almost every achievement in the set, it is recommended to note this condition through a zero-point achievement (usually awarded at the start of the game), a forum post, or comments rather than repeating \u201con normal difficulty or higher\u201d in the description of every achievement.</p> <p>The Description Itself The most important role of an achievement description is to describe exactly what is needed to obtain the achievement in as few words as possible while not excluding important information. It needs to be clear and concise, and both native and non-native English speakers must be able to understand what they need to do by reading the description in combination with the badge and title.</p> <p>There is a generous character limit of 255 characters to work with to describe what needs to be done for an achievement. Absolutely avoid redirecting people to the achievement comments for a full explanation, as emulator-only users do not have access to this information. If your achievement uses a lot of complex conditions and is difficult to explain within the character limit, consider simplifying the logic of the achievement so that it is easier to explain to users, rather than trying to fit all of the complexity within the character limit in a sub-optimal way.</p> <p>In some cases, achievement descriptions are intentionally written to avoid explaining what needs to be done word-for-word. For example, perhaps you want to avoid spoiling a story segment or you want to encourage the player to find out how to obtain the achievement without directly telling them what to do, like discovering a secret. This is a great idea, but one that needs to be approached with care. Remember, the description needs to be clear and concise for everyone to understand. It is important that the title, badge, and/or the description gives a solid hint on what the player needs to do. Consider reaching out to fellow community members with your planned achievement and see if they understand what needs to be done.</p>"},{"location":"Writing-Policy/#leaderboards","title":"Leaderboards","text":"<p>Leaderboard Titles Like achievement titles, the language, capitalization, punctuation, and emoji guidelines do apply to leaderboard titles. However, we will not ask you to give the leaderboards creative titles.</p> <p>Unlike achievement titles, we ask you to get directly to the point with leaderboard titles in as few words as possible while still remaining clear and concise. The reasoning behind this is that when a user is playing a game and a leaderboard becomes available, the pop-up will only show the title. It is important that players\u2013especially emulator-only players\u2013immediately know why this leaderboard is currently active and what it is about so they can decide on the fly whether to partake in this leaderboard or not.</p> <p>Typically leaderboards fall under a specific category, such as speedruns, score attacks, or something not too dissimilar. In these categories, specific parts of the games are what the leaderboard focuses on, such as a specific boss, stage, or the entire game. This is why we recommend you to structure the leaderboard title starting with the category, followed by the part of the game, and finally followed by a potential extra condition such as a specific character or vehicle.</p> <p>Examples include:</p> <ul> <li>Speedrun - Default Zone 1 (Pete)</li> <li>Score Attack - L.A. Streets (Hyundai I-20)</li> <li>Challenge - Creatures defeated consecutively</li> </ul> <p>Important to keep in mind is that when the leaderboard is based on an in-game named mode (such as Time Trial) that this is the name used as the challenge.</p> <p>Leaderboard Descriptions The leaderboard descriptions essentially follow the exact same guidelines as the achievement descriptions. The two most important rules remain consistency, and a clear and concise description of what the leaderboard is about. Implement correct usage of all the other guidelines of the achievement descriptions.</p> <p>However, there are two things to keep in mind specifically for leaderboards:</p> <ol> <li>Sometimes you may want to specify at what exact point a leaderboard starts- and ends. A leaderboard may end on the final hit of a boss, or after the death animation happens. Given how competitive leaderboards can be, it is important to state such information when it\u2019s not as obvious as the player may think.</li> <li>Descriptions are technically optional. While we always encourage a description still, sometimes you may end up in a situation where you have so many leaderboards all following a similar structure easily explained by the leaderboard title that it would be unnecessary to add a description. </li> </ol>"},{"location":"Writing-Policy/#common-grammatical-errors","title":"Common Grammatical Errors","text":"<p>It is not uncommon for grammatical errors to find their way into achievements, be it in the titles or the descriptions. As mentioned before, we do not expect everyone to have a perfect handle on the English language and the grammar that comes with it. With our years of experience, we have identified some mistakes that are more common than others, and these are listed down below to prevent them for future use, as well as show some examples to give you a better understanding of them.</p> <p>If reading the explanations below still raises questions, consider checking out a grammar tool such as LanguageTool or Grammarly. It is not recommended to use said tools for complete sentences, to avoid correcting grammar that doesn\u2019t need correction, but they can be used for simpler fixes such as the below-mentioned aspects.</p> <p>Articles Articles are by far the most common grammatical error identified on the site. Articles are words that identify a noun as being specific/definite (\u201cthe\u201d) or unspecific/indefinite (\u201ca\u201d/\u201dan\u201d). To give you a few examples of how they can be used in achievements:</p> <ul> <li>Specific/definitive<ul> <li>Example 1: You need to slay an enemy with a weapon called the Master Sword, of which only one exists. You want to define that the enemy can only be slain with this weapon, therefore you are tasked to slay it with the Master Sword.</li> <li>Example 2: A single rock is blocking your path that you need to destroy. While this rock is unnamed, you should still specify that you need to destroy the rock blocking your path.</li> <li>Example 3: There are multiple mountains to climb, but you are tasked with climbing the highest. As indicated, you should climb the highest mountain.</li> </ul> </li> </ul> <ul> <li>Unspecific/indefinite<ul> <li>Example 1: You need to slay an enemy with any sword in a game with multiple weapon types. Therefore, you are tasked to slay it with a sword.</li> <li>Example 2: Multiple rocks are blocking your path that you need to destroy. For the achievement you need to only destroy one of the rocks, so you don\u2019t need to specify which one to destroy and can just say a rock.</li> <li>Example 3: There are multiple mountains to climb, and you are free to choose any of them. Therefore, you should climb a mountain.</li> </ul> </li> </ul> <p>Most of these are pretty straightforward. Note that for unspecific/indefinite articles, you may also want to use different words to designate an amount. Using the above examples, you can slay an enemy with a sword, but also with any sword.</p> <p>Another possibility is that it is not necessary to use an article. This mostly applies to named words, such as locations. While \u201cArrive at the Baron Castle\u201d is technically correct, preferred would be to use \u201cArrive at Baron Castle\u201d. If you are unsure which one to go for in this situation, speaking the sentence out loud may just give you the hint you need!</p> <p>However, more people have an issue with the usage of the unspecific articles, \u201ca\u201d and \u201can\u201d. While they both have the same function, they cannot be used before some words. This is dependent on if the word that follows it starts with a consonant- or vowel sound when spoken in correct English. This also applies to abbreviations that are spoken one letter at a time.</p> <ul> <li>\u201ca\u201d is used as an article before words starting with consonant sounds (every letter except a, e, i, o, u).<ul> <li>a level - pronounced leh-vl.</li> <li>a unique item - pronounced yoo-neek.</li> <li>a BFG - pronounced bee-eff-gee.</li> <li>a URL - pronounced yoo-are-ell.</li> </ul> </li> </ul> <ul> <li>\u201can\u201d is used as an article before words starting with vowel sounds (a, e, i, o, u).<ul> <li>an item - pronounced ai-tm.</li> <li>an honest deed - pronounced o-nuhst.</li> <li>an ETA - pronounced ee-tee-a.</li> <li>an LCD - pronounced el-see-dee.</li> </ul> </li> </ul> <p>Possessive/Contraction Another common mistake is with words that use an apostrophe, such as \"you\u2019re\" and \"it\u2019s\". These are very commonly used in the English language, but removing the apostrophe  changes the entire meaning of the word. Therefore, it is good to check beforehand if you are using it as a possessive form, or as a contraction of multiple words.</p> <ul> <li>When you are not using the apostrophe, you are using the word in a possessive form. The word you are describing afterwards belongs to something- or someone.<ul> <li>Example 1: Use your sword to defeat the enemy. The sword is in your possession.</li> <li>Example 2: The magic book has its pages torn out. The pages belong to the book.</li> </ul> </li> </ul> <ul> <li>When you are using the apostrophe, you are combining two words into one as a contraction. The rule of thumb is always that when you are using an apostrophe, it is not a singular word. Note that it is always allowed (and sometimes even preferred!) to separate the words in writing rather than using them as a contraction.<ul> <li>Example 1: You\u2019re the hero of this story. It combines the words \u201cyou\u201d and \u201care\u201d.</li> <li>Example 2: It\u2019s super effective. It combines the words \u201cit\u201d and \u201cis\u201d. </li> </ul> </li> </ul> <p>Separated words and the usage of hyphens Another common grammatical mistake we find involves words such as \u201catleast\u201d and \u201calot\u201d, where two words are forced together into one word. This is not allowed in English - these examples should be \u201cat least\u201d and \u201ca lot\u201d.</p> <p>You should also watch out for correct usage of hyphens (the \u201c-\u201d symbol). This symbol is generally used to combine words, but only if they are followed by a noun. When they come after the noun, they are not combined with a hyphen and are instead written as two separate words.</p> <ul> <li>Example of when the hyphen is used:<ul> <li>Defeat the well-known artist. As the two words come before the noun that they are describing, they are combined with a hyphen.</li> </ul> </li> <li>Example of when the hyphen is not used:<ul> <li>Defeat the artist that is well known. As the two words come after the noun they are describing, they are not combined with a hyphen.</li> </ul> </li> </ul> <p>Written numbers, such as twenty-five, are always written with hyphens.</p> <p>Number Formatting All numbers should be formatted according to the conventions accepted in most English-speaking locations to avoid confusion about whether a number is very large or very small.</p> <ul> <li>Decimal point - A point should be used to convey the separation between the integer and fractional part of a number, not a comma.<ul> <li>Example: The number 3 + \u215b     - Correct: 3.125     - Incorrect: 3,125</li> </ul> </li> </ul> <ul> <li>Thousands separator - A comma should be used to separate a number into thousands, not a point.<ul> <li>Example: The number fifty thousand, five hundred and twenty-five     - Correct: 50,525     - Incorrect: 50.525</li> </ul> </li> </ul> <p>Deceptive Similarity Between Languages Many languages are related to each other, distantly or closely, and have words that are spelled similarly with similar meanings - but which are not identical. This may include your native language and English. Please check your spelling carefully to ensure you are using the English spelling for the word.</p> <ul> <li>Examples<ul> <li>An object in a player\u2019s inventory     - Correct: \u201citem\u201d     - Incorrect: \u201citen\u201d</li> </ul> </li> </ul>"},{"location":"Writing-Policy/#username-references","title":"Username References","text":"<p>Username references are a good way to acknowledge the work of a fellow user in the community. However, the references should be limited as most references are only understood by a small subset of the community. Username references must not carry a negative connotation. Username references must be explicitly requested by the developer and approved by the user being referenced unless otherwise specified below. Username references are appropriate in the following situations:</p> <ul> <li>Specialty Sets: In specialty set such as events or community-submitted sets, usernames may be referenced. Username references in these cases implies recognition of the individual's contribution and does not need to be approved by the user whose name is being referenced. Examples of these sets are:<ul> <li>Irritating Stick [Subset - IrRAtating Custom Courses]</li> <li>Pokemon Mystery Dungeon: Explorers of Sky [Subset - Zero Isle South Runs]</li> <li>~Hack~ UzeMaze RA</li> <li>Achievement of the Week 2022 Champions</li> </ul> </li> </ul> <ul> <li>Subtle References: Subtle username references may be included. However, these references must be clearly distinguishable from the main text and be relevant to the achievement theme.<ul> <li>BlazeKickn Hot</li> <li>Blended Sea Water</li> </ul> </li> </ul> <ul> <li>Good Reasons: In cases where there is a compelling reason to reference username, such as a significant achievement or notable contribution to the community, usernames may be included.</li> </ul> <p>Users retain full control over the use of their name. They have the right to request that their username be removed from any achievement at any time, developers must abide by this. For users who share the their name with an everyday term (Bedtime, Fridge, Gloves, Griffin, etc.), this only applies if their likeliness is directly referenced.</p> <p>The use of banned users is strictly prohibited. Any achievement that includes a banned username should be updated promptly upon becoming aware of the ban.</p>"},{"location":"Writing-Policy/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:09] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:14] Andrew Comer:</code> Updated Writing Policy (markdown)</li> <li><code>[2024-01-12 20:47] Andrew Comer:</code> Added initial \"Username References\" section</li> <li><code>[2023-12-18 18:45] Andrew Comer:</code> Updated Writing Policy (markdown)</li> <li><code>[2023-12-18 10:08] suspect15:</code> Updated Writing policy (markdown)</li> </ul>"},{"location":"_Footer/","title":"Footer","text":"<p>RetroAchievements Documentation</p> Official Website RADocs Discord Server"},{"location":"_Sidebar/","title":"Wiki Home Page","text":""},{"location":"_Sidebar/#guidelines","title":"Guidelines","text":"<ul> <li>User Guidelines<ul> <li>RetroAchievements Manifesto</li> <li>Users Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> </ul> </li> <li>Developer Guidelines<ul> <li>Developer's Code of Conduct</li> <li>Creating Entries</li> <li>Claims System</li> <li>Handling Tickets</li> </ul> </li> <li>Content Guidelines<ul> <li>Achievement Set Requirements</li> <li>Unwelcome Concepts</li> <li>Progression and Win Condition Typing</li> <li>Set Plagiarism</li> <li>Naming Conventions</li> <li>Writing Policy</li> <li>Badge and Icons</li> <li>Code Notes</li> <li>Editing Leaderboards</li> <li>Achievement Set Revisions</li> <li>Achievements for ROM hacks</li> <li>Subsets</li> <li>Working with the Right ROM</li> <li>Hash Labels</li> </ul> </li> </ul>"},{"location":"_Sidebar/#general","title":"General","text":"<ul> <li>FAQ</li> <li>Setup Guide</li> <li>Emulator Support and Issues</li> <li>Ways to Contribute</li> <li>RABot, the RA Discord Robot</li> <li>Events</li> <li>Overlay Themes</li> <li>Useful Links</li> <li>Contributing with the docs</li> <li>About Us</li> <li>Tutorials<ul> <li>How to configure OBS Studio to see the popups</li> <li>Multi-Disc Games Tutorial</li> <li>Working with DLC for the PlayStation Portable</li> </ul> </li> </ul>"},{"location":"_Sidebar/#achievement-development","title":"Achievement Development","text":"<ul> <li>Developer Docs</li> <li>How to Become an Achievement Developer</li> <li>Getting Started as an Achievement Developer</li> <li>Game Identification</li> <li>Achievement Design</li> <li>Achievement Scoring</li> <li>Difficulty Scale and Balance</li> <li>Progression and Win Condition Typing</li> <li>Badge and Icon Creation</li> <li>Achievement Development Overview</li> <li>Flags<ul> <li>ResetIf Flag</li> <li>ResetNextIf Flag</li> <li>PauseIf Flag</li> <li>AndNext and OrNext Flags</li> <li>AddSource Flag</li> <li>SubSource Flag</li> <li>AddHits and SubHits Flag</li> <li>AddAddress Flag</li> <li>Measured Flag</li> <li>Trigger Flag</li> </ul> </li> <li>BitCount Size</li> <li>Alt Groups</li> <li>Hit Counts</li> <li>Delta Values</li> <li>Prior Values</li> <li>Value Definition</li> <li>Condition Syntax</li> <li>Minimum Required Versions for Logic Features</li> <li>Memory Inspector</li> <li>Real Examples</li> <li>Set Development Roadmap</li> <li>Achievement Templates</li> <li>Tips and Tricks</li> <li>Leaderboards</li> <li>Rich Presence</li> <li>RATools</li> <li>Console Specific Tips</li> <li>Emulator Hotkeys for Developers</li> <li>libretro core support</li> </ul>"},{"location":"_Sidebar/#wip","title":"WIP","text":"<ul> <li>Docs To Do List</li> <li>WIP User Code of Conduct</li> <li>WIP CoC FAQ</li> <li>WIP Content Guidelines</li> <li>WIP-Jr</li> <li>WIP---Dev-Tips---Code-Notes-En-Masse</li> </ul>"},{"location":"_Sidebar/#portugues","title":"Portugues","text":"<ul> <li>Introdu\u00e7\u00e3o</li> </ul>"},{"location":"_Sidebar/#geral","title":"Geral","text":"<p>- Manifesto RetroAchievements   - C\u00f3digo de Conduta do Usu\u00e1rio   - FAQ - Perguntas Frequentes   - Como contribuir se voc\u00ea n\u00e3o \u00e9 um desenvolvedor   - Tutorial para Jogos Multi-Discos</p>"},{"location":"_Sidebar/#desenvolvedores","title":"Desenvolvedores","text":"<p>- Introdu\u00e7\u00e3o   - Primeiros Passos como um Desenvolvedor de Conquistas   - Recursos de L\u00f3gica para Achievements   - Exemplos Reais     - Introdu\u00e7\u00e3o     - Usando Hit Counts e ResetIf     - Usando Delta Values e ResetIf     - Simples Exemplo de como Evitar Abuso de Load State   - Dicas e Truques   - Dicas Espec\u00edficas de Console   - Modelos de Achievement   - Escala de Dificuldade e Equil\u00edbrio   - Roteiro de Desenvolvimento de um Set de Conquistas   - Cria\u00e7\u00e3o de \u00cdcones e Emblemas   - Leaderboards   - Rich Presence   - Design de Conquistas</p>"},{"location":"_Sidebar/#espanol","title":"Espa\u00f1ol","text":"<ul> <li>Introducci\u00f3n</li> </ul>"},{"location":"_Sidebar/#general_1","title":"General","text":"<p>- Manifesto RetroAchievements   - C\u00f3digo de Conducta del Usuario   - FAQ - Preguntas Frecuentes   - Tablas Globales y Reglas para la Caser\u00eda de Logros   - Mi juego no esta cargando los logros   - Como contribuir si no eres un desarrollador   - Por que no deber\u00edas utilizar la funci\u00f3n de cargar estado   - Contribuyendo con los documentos   - Como funciona la Documentaci\u00f3n de RA   - Descargas</p>"},{"location":"_Sidebar/#desarrolladores","title":"Desarrolladores","text":"<p>- Intro   - C\u00f3digo de Conducta del Desarrollador   - Como convertirme en un Desarrollador de Logros   - Primeros pasos como un Desarrollador de Logros   - Un vistazo al Inspector de Memoria   - Caracter\u00edsticas en la Logica de un Logro     - Intro     - Contador de Golpes (Hit Counts)     - Valores Delta     - Bandera ResetIf     - Bandera PauseIf     - Bandera AddSource     - Bandera SubSource     - Bandera AddHits     - Combinando Banderas     - Alt Groups     - Versiones M\u00ednimas Requeridas para Funciones en la L\u00f3gica   - Ejemplos Reales     - Intro     - Utilizando Hit Counts como un Temporizador     - Utilizando Valores Delta y Hit Counts para Detectar un Incremento     - Un Ejemplo Simple en como evitar el Abuso de Estados de Guardado     - Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame     - Creando un Temporizador con un ResetIf Hits bas\u00e1ndote en la Velocidad de un Juego   - Plantillas para Logros   - Tips y Trucos   - Escala de Dificultad y Balance   - Dise\u00f1o de Logros   - Mapa de Desarrollo de Set   - Revisiones en Set de Logros   - Creaci\u00f3n de Iconos y Badges   - Tablas de Clasificaci\u00f3n   - Rich Presence   - Trabajando con el ROM apropiado   - Identificaci\u00f3n del Juego   - Gu\u00eda para Sets Bonus   - Logros para ROM hacks   - Tips Espec\u00edficos por Consola</p>"},{"location":"home-pl/","title":"Home pl","text":""},{"location":"home-pl/#_1","title":"Home pl","text":"<p>Witaj w dokumentacji RetroAchievements!</p> <p>Na pocz\u0105tek, musisz zna\u0107 Or\u0119dzie RetroAchievements wraz z Kodeksem post\u0119powania U\u017cytkownika.</p> <p>Je\u017celi szukasz dokumentacji o tworzeniu osi\u0105gni\u0119\u0107, sprawd\u017a nasz\u0105 sekcje Dokumentacje Developerskie.</p> <p>Zach\u0119camy wszystkich cz\u0142onk\u00f3w spo\u0142eczno\u015bci aby do\u0142\u0105czyli do naszego Serwera Discord, u\u017cywamy go do wi\u0119kszo\u015bci komunikacji</p> <p>Pe\u0142na lista stron jest na bocznym pasku, lecz tu jest kr\u00f3tki opis paru z nich:</p> <ul> <li>FAQ: Cz\u0119sto zadawane pytania (na przyk\u0142ad Kt\u00f3rego rdzenia Retroarch powinienem u\u017cywa\u0107).</li> </ul> <ul> <li>Globalna Tablica Wynik\u00f3w i Zasady Zdobywania Osi\u0105gni\u0119\u0107: Wyja\u015bnia zasady globalnej tablicy wynik\u00f3w, czym jest status \"Untracked\", co mo\u017ce by\u0107 uznawane za oszukiwanie itd.</li> </ul> <ul> <li>Pliki do \u015aci\u0105gni\u0119cia: alternatywna strona do \u015bci\u0105gania plik\u00f3w.</li> </ul> <ul> <li>Darmowe Gry: Gry, kt\u00f3re s\u0105 darmowe i legalne do \u015bci\u0105gni\u0119cia i grania na emulatorze.</li> </ul> <ul> <li>Moja gra nie \u0142aduje osi\u0105gni\u0119\u0107: Co musisz zrobi\u0107, gdy gra nie \u0142aduje osi\u0105gni\u0119\u0107.</li> </ul> <ul> <li>Czemu nie powiniene\u015b u\u017cywa\u0107 funkcji Wczytaj Stan: Czemu powiniene\u015b oczekiwa\u0107 problem\u00f3w u\u017cywaj\u0105\u0107 funkcji Utw\u00f3rz/Wczytaj Stan podczas gry.</li> </ul> <ul> <li>Wiadomo\u015b\u0107 do \u0141owc\u00f3w osi\u0105gni\u0119\u0107 i Komplecjonist\u00f3w o rewizjach: Czemu nie powiniene\u015b si\u0119 denerwowa\u0107 jak osi\u0105gni\u0119cia zosta\u0142y poddane rewizji.</li> </ul> <ul> <li>Jak mo\u017cesz wspom\u00f3c nie b\u0119d\u0105c developerem: Je\u015bli nie wiesz, jak tworzy\u0107 osi\u0105gni\u0119cia, jest wiele sposob\u00f3w aby pom\u00f3c naszej spo\u0142eczno\u015bci.</li> </ul> <p>Mo\u017cesz wspom\u00f3c t\u0119 dokumentacje poprzez tworzenie/edytowanie stron na Wikipedii RetroAchievements.</p>"},{"location":"home-pl/#tumaczenia","title":"T\u0142umaczenia","text":"<ul> <li>Portugalski</li> <li>Hiszpa\u0144ski</li> <li>Francuski</li> </ul>"},{"location":"libretro-core-support/","title":"libretro core support","text":"<p>For a libretro core to support RetroAchievements, it must expose memory and it must not modify the game files. Everything else should be handled by the libretro frontend (i.e. RetroArch or RALibretro).</p> <ul> <li>Exposing Memory</li> <li>Immutable Game Data</li> <li>Core Settings</li> <li>Save States</li> <li>Disabling Support</li> </ul>"},{"location":"libretro-core-support/#exposing-memory","title":"Exposing Memory","text":"<p>First, find the memory regions expected by RetroAchievements by looking for the mapping associated to the console in consoleinfo.c. It will look something like this:</p> <pre><code>static const rc_memory_region_t _rc_memory_regions_pc_engine[] = {\n    { 0x000000U, 0x001FFFU, 0x1F0000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM\" },\n    { 0x002000U, 0x011FFFU, 0x100000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"CD RAM\" },\n    { 0x012000U, 0x041FFFU, 0x0D0000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"Super System Card RAM\" },\n    { 0x042000U, 0x0427FFU, 0x1EE000U, RC_MEMORY_TYPE_SAVE_RAM,   \"CD Battery-backed RAM\" }\n};\n</code></pre> <p>This example defines four regions of memory for the PC-Engine console. The first two fields are the starting and ending RetroAchievements address for the region. The third field is the starting real address for the region. The fourth field identifies the type of memory stored in the region, and the last field is a label for the region.</p> <p>Achievements rely almost entirely on system RAM and save RAM. There may be additional blocks in the memory map flagged as other types of memory. Those blocks are leftover from the way the memory way initially exposed by a standalone emulator. They can only be exposed by <code>RETRO_ENVIRONMENT_SET_MEMORY_MAPS</code>, and are almost never needed for achievement logic, so it's usually acceptable to not worry about them initially.</p> <p>If no memory map is provided, RetroAchievements doesn't support the system yet. Please contact us if you believe your core/system is ready to be supported.</p>"},{"location":"libretro-core-support/#exposing-via-retro_get_memory_data","title":"Exposing via retro_get_memory_data","text":"<p>Memory can be exposed in two ways. The simplest is using the <code>retro_get_memory_data</code>/<code>retro_get_memory_size</code> functions. These functions will be called with <code>RETRO_MEMORY_SYSTEM_RAM</code> and <code>RETRO_MEMORY_SAVE_RAM</code> (when applicable). The functions return a single pointer and a size for a block of memory. This block of memory is then distributed to the memory regions until no more is available.</p> <p>Using the above example, the expectation would be that <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code> would return 0x42000 and <code>retro_get_memory_size(RETRO_MEMORY_SAVE_RAM)</code> would return 0x800, and <code>retro_get_memory_data</code> would return pointers to blocks of memory of the specified sizes. The 0x42000 bytes of system RAM would be distributed to the three blocks of <code>RC_MEMORY_TYPE_SYSTEM_RAM</code>, and the 0x800 bytes of save RAM would be associated to the one block of <code>RC_MEMORY_TYPE_SAVE_RAM</code>.</p> <p>If less than 0x42000 bytes is returned by <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code>, it will be associated to the three blocks of <code>RC_MEMORY_TYPE_SYSTEM_RAM</code> in a first-come, first-serve basis. The first 0x2000 bytes will be allocated to the first block. The next 0x10000 to the second block, and whatever is left to the third block. Whatever addresses could not be filled will be unavailable to the achievement code and achievements dependent on those addresses will be disabled.</p> <p>If more than 0x42000 bytes is returned by <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code>, only the first 0x42000 bytes will be allocated and the rest will be ignored.</p>"},{"location":"libretro-core-support/#exposing-via-retro_environment_set_memory_maps","title":"Exposing via RETRO_ENVIRONMENT_SET_MEMORY_MAPS","text":"<p>The other way to expose memory is the <code>RETRO_ENVIRONMENT_SET_MEMORY_MAPS</code> environment callback. This callback allows the core to specify disparate chunks of memory without having to join them into a single byte array for access by <code>retro_get_memory_data</code>. Using the example above, unique pointers could be returned for each of the three blocks of system RAM, or even for subsections of each of the three blocks of system RAM.</p> <p>The RetroAchievements code will using the provided map to translate it's addresses to the appropriate core memory through the start/select/disconnect properties of the exposed memory. Addresses that cannot be mapped will be unavailable to the achievement code and achievements dependent on those addresses will be disabled.</p>"},{"location":"libretro-core-support/#special-considerations","title":"Special considerations","text":"<p>Some maps contain comments indicating special considerations should be applied for the console. These usually have to do with paged memory. As the achievement code needs access to all memory, not just the currently paged memory, we often request that the entire unpaged memory be accessible.</p> <pre><code>    { 0x00C000U, 0x00CFFFU, 0x00C000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (fixed)\" },\n    { 0x00D000U, 0x00DFFFU, 0x00D000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (bank 1)\" },\n\n    /* GameBoy Color provides six extra banks of memory that can be paged out through the $DXXX \n     * memory space, but the timing of that does not correspond with blanks, which is when achievements \n     * are processed. As such, it is desirable to always have access to these extra banks. We do this\n     * by expecting the extra banks to be addressable at addresses not supported by the native system. */\n    { 0x010000U, 0x015FFFU, 0x010000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (banks 2-7, GBC only)\" }\n</code></pre> <p>The GameBoy Color has 32KB of RAM broken into eight 4KB banks. Normally, the first bank is exposed at $C000, and the other seven banks are paged into the $D000 memory space. As RetroAchievements only process data once per frame, we can't rely on the correct data being in the $D000 page when we evaluate our logic, so we ask that $D000 always only contains bank 1, and banks 2-7 are exposed at $10000-$15FFF (addresses which are not normally used by the GameBoy Color).</p>"},{"location":"libretro-core-support/#immutable-game-data","title":"Immutable Game Data","text":"<p>The other important thing for a core to consider is that the game files should not be modified.</p> <p>RetroAchievements hashes a portion of the game data (usually most or all of it) to ensure the player is using a compatible version of the game. If the hash doesn't match exactly, we don't enable achievements. This ensures that regional variants are only allowed if their memory lines up correctly. It also ensures players aren't playing on a hacked version where they have infinite health or some other cheat applied.</p> <p>If the game files are modified by the core, the hash may change and the game will no longer be identified.</p> <p>Any modifications to the game files should be handled through the <code>retro_serialize</code> interface.</p>"},{"location":"libretro-core-support/#core-settings","title":"Core Settings","text":"<p>If a user can manually change settings in the core that could make playing a game easier, please inform us so we can add them to a blacklist that disables hardcore when they're set. Common examples are:  * running NTSC games in PAL mode slows them down by 16%  * disabling layers allows players to see through fog-of-war  * core provided cheats give infinite health/ammo/etc</p>"},{"location":"libretro-core-support/#save-states","title":"Save States","text":"<p>While not required, save state support makes it much easier to develop and debug/fix achievements using the core.</p> <p>No special logic is required to support achievements in the save states - the frontend will handle that.</p>"},{"location":"libretro-core-support/#disabling-support","title":"Disabling Support","text":"<p>If a core wishes to opt-out of achievement support, it can explicitly call the <code>RETRO_ENVIRONMENT_SET_SUPPORT_ACHIEVEMENTS</code> with <code>false</code>/<code>0</code>. This will disable the achievement subsystem while the core is loaded, which will avoid any attempts to identify if the loaded content has achievements, and disable all functionality limited by having achievement hardcore mode enabled (rewind, loading save states, slow-motion, cheats).</p>"},{"location":"libretro-core-support/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:05] televandalist:</code> Added ToC</li> <li><code>[2022-01-06 07:40] Jamiras:</code> Created libretro core support (markdown)</li> </ul>"}]}
\ No newline at end of file
+{"config":{"lang":["en","pt","es"],"separator":"[\\s\\-\\.]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Index","text":"<p>Welcome to the RetroAchievements documentation!</p> <p>The docs are currently under heavy construction so be sure to check back often! Each section appears in the sidebar, but here is a brief explanation of the categories:</p> <ul> <li>Guidelines: Details community, user/player, developer, and content policies.</li> <li>General: FAQ, getting started, support/troubleshooting, and other info that can be useful to all members of the community.</li> <li>Achievement Development: Extensive information on both the conceptual and technical aspects of making achievements.</li> </ul> <p>We encourage all community members to join our Discord Server; we use this for most communication.</p> <p>Translations</p> <ul> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 14:29] televandalist:</code> Removed the RA logo from the top since the link was broken</li> <li><code>[2023-06-30 12:36] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-30 12:14] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-06 10:35] televandalist:</code> Fix broken link</li> <li><code>[2023-04-13 15:08] televandalist:</code> Removed the links to pages that deal with specific support questions. They should/will be merged with a support section or the FAQ to declutter the home page.</li> <li><code>[2023-04-13 14:51] televandalist:</code> Removed link to \"Free Games\" section. While they are free homebrews, the downloads are typically on site if they actually have a set. If they aren't, they should be.</li> <li><code>[2022-08-23 20:22] Jazerus:</code> grammar fixes</li> <li><code>[2022-02-18 21:24] televandalist:</code> Add Event page link</li> <li><code>[2021-04-21 10:23] meleu:</code> french docs are yet incomplete</li> <li><code>[2020-09-07 09:06] meleu:</code> add Manifesto</li> </ul>"},{"location":"A-message-for-Achievement-Hunters-and-Completionists-about-revisions/","title":"A message for Achievement Hunters and Completionists about revisions","text":"<p>Let's start jumping directly to the conclusion:</p> <p>If you mastered a game and then it received a revision, don't feel frustrated! Keep in mind that changes come for a better quality.</p> <p>Now let's elaborate why we are saying that.</p> <p>RetroAchievements is a \"young\" project and is constantly evolving. It was launched in the late 2012, and in the early days the emulators and the site (database stuff, PHP, HTML, CSS, JavaScript, etc.) were developed by a single person: Scott. Therefore the evolution occurred slowly.</p> <p>Another thing that was occurring very slowly in the early days was the diffusion of knowledge about achievement creation. Specially about good practices when creating achievements. There wasn't documentation at that time (RADocs only started in November/2017). People were learning to create achievements by sharing knowledge on forum threads and/or by personal messages.</p> <p>In the early days the community didn't have a very clear a concept of what a good achievement design is. And it resulted in many poorly designed sets compared to our current standards (e.g. sets with only progress-based achievements). We also didn't have much experience of how achievements could be protected against in-game cheats or battery save abusing. That's why from time to time some achievement sets receive revisions. We make set revisions with quality in mind, and to show actual respect for the game.</p> <p>When a revision is going to happen, we try to involve the community by discussing on our forums (usually the official game's topic) and/or on our discord server. We are aware that this is insufficient to reach all interested people, but it is the way we are currently using.</p> <p>We are working on new ways to discuss revisions with the community by implementing some new social features on the RA website, but while those features are not implemented, we'll keep using the forums and discord.</p> <p>If you would like to propose new methods for discussing revisions, we are open to suggestions.</p>"},{"location":"About-Us/","title":"About Us","text":""},{"location":"About-Us/#ra-staff","title":"RA Staff","text":"<p>The RetroAchievements project started as a personal project of Scott Breen and in the early days the project had only administrators, achievement creators, and regular users (and it's still like that on the website). At that time administrators were responsible to do things like:</p> <ul> <li>keep an eye on the quality of achievements</li> <li>keep an eye if someone is changing other people's achievements (accidentally or intentionally)</li> <li>welcome new achievement creators and show them the information they need to start contributing</li> <li>review the work of new achievement creators</li> <li>get rid of trolls</li> <li>get rid of cheaters</li> <li>avoid legal problems related to piracy</li> <li>sometimes host gaming events</li> <li>besides all those chores, RAdmins also have interest in playing old games, you know...</li> </ul> <p>As the community continues to grow, the amount of work, time, and energy required to keep it running also grows. In order to assure the project thrives, without administrators having burnouts and ragequitting the project, various roles with specific tasks were created.</p> <p>These roles are not really visible in the website, but they are on discord and here in this page we list the roles and their responsibilities.</p> <ul> <li>Team Accounts</li> <li>Root</li> <li>Administrators</li> <li>Moderators</li> <li>Developer Compliance Team</li> <li>Quality Assurance Team</li> <li>Code Reviewer Team</li> <li>Tech Team</li> <li>Sub-Team Leads</li> </ul>"},{"location":"About-Us/#team-accounts","title":"Team Accounts","text":"<p>Shared accounts used by their respective team members:</p> <ul> <li>DevCompliance</li> <li>DevQuest</li> <li>QATeam</li> <li>RAdmin</li> <li>RAEvents</li> <li>RANews</li> <li>TheUnwanted</li> </ul>"},{"location":"About-Us/#root","title":"Root","text":"<p>Members who have direct access to the webserver.</p> <ul> <li>KickMeElmo</li> <li>luchaos</li> <li>MrOwnership</li> <li>Scott</li> </ul>"},{"location":"About-Us/#administrators","title":"Administrators","text":"<p>A group of dedicated and trusted users with varied responsibilities, the heaviest being decision-making regarding the direction of the project and community:</p> <ul> <li>AuburnRDM</li> <li>Hotscrock</li> <li>Jamiras</li> <li>KickMeElmo</li> <li>luchaos</li> <li>MrOwnership</li> <li>Scott</li> <li>Snow</li> <li>SporyTike</li> <li>televandalist</li> </ul>"},{"location":"About-Us/#moderators","title":"Moderators","text":"<p>The team responsible to keep the this community a healthy place (at least for those who adhere to the User's Code of Conduct and agree with the RetroAchievements Manifesto):</p> <ul> <li>AuburnRDM</li> <li>BahamutVoid</li> <li>Hotscrock</li> <li>KickMeElmo</li> <li>pinguupinguu</li> <li>Searo</li> <li>Snow</li> <li>SporyTike</li> <li>Suffa28</li> </ul>"},{"location":"About-Us/#developer-compliance-team","title":"Developer Compliance Team","text":"<p>The team responsible for the adherance and driving updates to the Developer's Code of Conduct.</p> <ul> <li>Bryan1150</li> <li>DoctorV</li> <li>Etron</li> <li>GalacticSpear</li> <li>Hotscrock</li> <li>malasdair</li> <li>MrOwnership</li> <li>pinguupinguu</li> <li>psyduck</li> <li>televandalist</li> <li>TheMysticalOne</li> <li>timenoe</li> </ul>"},{"location":"About-Us/#quality-assurance-team","title":"Quality Assurance Team","text":"<p>The team responsible for ensuring the overall quality of achievement sets: including logic, correct titles and descriptions, working leaderboards, working rich presence and hash compatibility:</p> <ul> <li>Bartis1989</li> <li>DoctorV</li> <li>Falcus</li> <li>Hotscrock</li> <li>MrOwnership</li> <li>psyduck</li> <li>Searo</li> <li>Soulsderfuchs</li> <li>StingX2</li> <li>televandalist</li> <li>xnaivx</li> </ul>"},{"location":"About-Us/#code-reviewer-team","title":"Code Reviewer Team","text":"<p>The team responsible for helping Jr. Devs learn how to make achievements sets and review their work to ensure their understanding is enough to make sets on their own:</p> <ul> <li>blendedsea</li> <li>Brandovsky</li> <li>Bryan1150</li> <li>DarkyAndreas</li> <li>DoctorV</li> <li>Etron</li> <li>Falcus</li> <li>Fridge</li> <li>gollawiz</li> <li>LogicalFallacy</li> <li>MrOwnership</li> <li>Ryudo</li> <li>Searo</li> <li>Shmelyoff</li> <li>SlashTangent</li> <li>SporyTike</li> <li>suspect15</li> <li>thegotoguyy</li> <li>TheMysticalOne</li> <li>xnaivx</li> </ul>"},{"location":"About-Us/#tech-team","title":"Tech Team","text":"<p>The team that is more involved with the tech side of things, whether it be the website, emulators, Discord bots, etc.:</p> <ul> <li>AlmightyXor</li> <li>amine456</li> <li>clymax</li> <li>DanielARP</li> <li>drisc</li> <li>Jamiras</li> <li>KickMeElmo</li> <li>Krylan</li> <li>LootusMaximus</li> <li>luchaos</li> <li>[meleu](https://retroachievements.org/user/meleu</li> <li>mosquitobird11</li> <li>MrOwnership</li> <li>oddgoo</li> <li>Scott</li> <li>Searo</li> <li>TeddyWestside</li> <li>televandalist</li> <li>WCopeland</li> <li>Xymjak</li> </ul>"},{"location":"About-Us/#sub-team-leads","title":"Sub-Team Leads","text":"<p>Users who oversee one of the QA sub-teams:</p> <ul> <li>Bendyhuman - Events Team lead</li> <li>Nydaxn - Art Team lead</li> </ul>"},{"location":"About-Us/#short-history","title":"Short History","text":"<p>The RetroAchievements project was created by Scott Breen in 2012. He hacked some open source emulators to add the RetroAchievements feature and coded all the backend/website mostly alone.</p> <p>By January 2014, there were 4 RA emulators, over 5000 achievements to earn (thanks to the devotion of many passionate achievement developers) and over 1000 players registered. After a couple of years Scott was called by the real life the website development went into a period of hiatus with just a few sporadic improvements (the achievement developers were continually working on more and more games, though).</p> <p>In late 2015 leiradel started to work to integrate the RetroAchievements feature into RetroArch. And, as RetroArch is able to run on a wide variety of platforms (such as Mac and Linux) and devices (such as Android phones and Raspberry pi), it helped a lot to increase the popularity of the RetroAchievements project.</p> <p>As the site slowly grew, so did the bandwidth costs, so in late 2016, Scott reached out to the community and they suggested doing a Patreon to keep the site going. After implementing it, the community response was fantastic, which allowed the site to continue completely ad-free.</p> <p>Mid 2017 the RetroAchievements Discord server was started and it made communication across the community much easier. Since then, many knowledgeable members (coders, web developers, etc.) joined the scene volunteering to contribute to the project.</p> <p>Up to this point all the achievement creation knowledge was scattered in several forum posts, making it very tough for a newbie to learn how to create achievements. Then in the late 2017 meleu started the RADocs project and thanks to contributions from many experienced achievement creators it is now a reasonably solid resource of information. Helping dozens of Jr. Developers (and even the experienced ones) to create content for our community.</p> <p>In the early 2018 Scott opened the source of the back-end/website, which was a turning point in the history of the development of the whole RetroAchievements project (see us at github).</p> <p>Later in the same year a more concise staff began to take shape and is now an awesome team. These talented guys keep the ball rolling and make it very clear that the RA community is alive and stronger than ever.</p> <p>In some areas the project may still look like a beta version, but we are continually working hard to make things better.</p>"},{"location":"About-Us/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-08-04 23:23] Snow:</code> Updated users in roles</li> <li><code>[2023-04-13 14:37] televandalist:</code> Updated the list.</li> <li><code>[2022-06-09 19:04] Searo:</code> Swap QA and DevComp descriptions</li> <li><code>[2022-06-09 18:45] Searo:</code> Add DevComp, Update QA after the split, Add CR, Suffa28 to Mods, SnowPin to Admins</li> <li><code>[2022-04-16 12:07] snowpin:</code> Updated Staff &amp; Tech Team members</li> <li><code>[2022-03-21 15:08] ScottFromDerby:</code> I am now Breen instead of Davies :)</li> <li><code>[2022-03-13 21:11] televandalist:</code> Updated according to current roles.</li> <li><code>[2022-01-28 18:40] SporyTike:</code> added RAdmin and QATeam as contacts to the lists, I got feedback from users that it might be good to put them here</li> <li><code>[2021-11-28 14:14] televandalist:</code> Update team lists</li> <li><code>[2021-06-01 09:19] meleu:</code> add missing human being to be listed in the mod team</li> </ul>"},{"location":"Achievement-Design-es/","title":"Dise\u00f1o de Logros","text":"<p>Esta es una gu\u00eda en como pensar en un buen dise\u00f1o de logros. No el lado t\u00e9cnico sino el conceptual.</p> <p>Este contenido es un resumen de lo que originalmente escribi\u00f3 el usuario de RA cirellio en un tema del foro.</p>"},{"location":"Achievement-Design-es/#logros-basados-en-progresion","title":"Logros basados en Progresi\u00f3n","text":"<p>Hay 3 tipos de logros basados en progresi\u00f3n: progresi\u00f3n simple, progresi\u00f3n basada en historia, y logros de progresi\u00f3n/colecci\u00f3n.</p>"},{"location":"Achievement-Design-es/#progresion-simple","title":"Progresion Simple","text":"<p>Logros basados en progresi\u00f3n son usualmente los mas simples, especialmente si el juego que estas haciendo es nada mas que eso. O no tiene mucho que ver con una trama/historia o algo parecido. En este caso, veamos algunos BUENOS y MALOS ejemplos sobre esto:</p> <ul> <li>Bueno: Completa el stage 1. </li> <li>Malo: Llega al stage 2. </li> </ul> <p>Toma ligeramente mas trabajo programar un logro donde el jugador necesita completar un stage en vez de simple llegar al siguiente. Pero es aparte mas satisfactorio para el jugador, y se ve mucho mas profesional. Aparte tambi\u00e9n es menos susceptible a problemas donde los jugadores cargan partidas de guardado o estados de guardado (savestates) para logros gratis. </p> <ul> <li>Bueno: Completa el juego. </li> <li>Malo: Empieza el juego. </li> </ul> <p>Es cierto que los logros basados en progresi\u00f3n son usualmente logros regalados, pero generalmente todos estamos de acuerdo en que un logro sobre empezar el juego es demasiado f\u00e1cil, y no del todo memorable para el jugador. Es simplemente es una norma, sin embargo es muchas veces la parte mas memorable de un juego para el jugador, y completar un juego es definitivamente un logro en si. Es correcto hacer un logro que funcione de la siguiente manera \"Completa el ultimo mundo y completa el juego\".</p> <ul> <li>Bueno: Completa los stages con tem\u00e1tica de nieve, Completa los primeros cinco stages, o Completa los primeros diez stages. </li> <li>Malo: Completa el Stage 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (todos los logros por separado) </li> </ul> <p>Una de las peores cosas que puedes hacer es spammear logros. Juegos de Puzzle son notorios por tener ese tipo de problemas, porque los stages son cortos y por lo regular, hay cientos o hasta mas. Como resultado, el feed de la pagina principal termina con un mont\u00f3n de micro-actualizaciones, y sacan a los logros de otros usuarios r\u00e1pidamente del feed. La manera de corregir esto de la manera mas profesional posible es espaciar los logros un poco mas, en grupos de stages. Por ejemplo, si los stages 1-10 todos tienen tem\u00e1tica de fuego, y los stages 11-20 todos tienen tem\u00e1tica del espacio, puedes crear logros basados en esas tem\u00e1ticas. Se creativo. </p>"},{"location":"Achievement-Design-es/#progresion-basada-en-historia","title":"Progresion Basada en Historia:","text":"<p>Los momentos mas memorables en la historia de los videojuegos usualmente no est\u00e1n relacionados a coleccionar un \u00edtem o a misiones secundarias, sino a escenas especificas relacionadas con la historia. </p> <p>Ejemplos:</p> <ul> <li>Primer encuentro con Pyramid Head en la serie de Silent Hill. </li> <li>Encontrando la verdad sobre Darth Revan en Knights of the Old Republic. </li> <li>Encontrando que es lo que va a pasar en el futuro en Chrono Trigger. </li> <li>Lanzando la Vaca en Earthworm Jim. </li> <li>Casi cualquier muerte de alg\u00fan personaje. </li> </ul> <p>La cosa es de ser extremadamente cuidados con los spoilers. Si encuentras alg\u00fan logro relacionado con historia y cuenta con un spoiler, contacta al desarrollador responsable. Y a los desarrolladores, por favor sean comprensivos cuando se trate de critica constructiva, el numero y el porcentaje de este tipo de logros varia de juego en juego--Esto realmente se vasa en que tan fuertemente el juego esta enfocado en su historia. </p>"},{"location":"Achievement-Design-es/#progresioncoleccion","title":"Progresi\u00f3n/Colecci\u00f3n","text":"<p>Progresi\u00f3n/Colecci\u00f3n es com\u00fanmente un h\u00edbrido. No solo estas coleccionando un \u00edtem, sino tambi\u00e9n sale una memorable (y mandataria) escena.</p> <p>Ejemplos:</p> <ul> <li>Obtener la Master Sword en A Link to the Past, que levanta la maldici\u00f3n en Lost Woods. </li> <li>Encontrar la espada en la playa en Link's Awakening, y sale la primer escena en el que el sabio b\u00faho habla contigo. </li> <li>Escoger tu Pokemon, el cual sucede en escena del principio, pero b\u00e1sicamente es 'un ritual' para la mayor\u00eda de jugadores.</li> </ul> <p>Logros en esta categor\u00eda h\u00edbrida tipicamente mas satisfactorios ya que hacen doble-trabajo. El jugador no esta solamente obteniendo un \u00edtem, sino tambi\u00e9n viendo una escena memorable y obteniendo un logro a la vez. Bastante dosis de endorfinas! </p>"},{"location":"Achievement-Design-es/#progresion-pros-y-contras","title":"Progresion Pros y Contras","text":"<p>Logros basados en progresi\u00f3n son garantizados que le van a salir al jugador en un play-through normal. Entonces para que tenerlos en primer lugar? </p>"},{"location":"Achievement-Design-es/#pros","title":"Pros","text":"<ul> <li>Un jugador merece puntos por jugar un jugar! A si lo es! Recuerda, bastantes usuarios estan jugando estos juegos por primera vez, y la mayor\u00eda de los juegos son algo dif\u00edciles de pasar. Porque no deber\u00edamos de recompensarlos por un buen y cl\u00e1sico play-through? </li> </ul> <ul> <li>Logros de progresi\u00f3n constantes a largo plazo motivan a los jugadores a completar el juego. </li> </ul> <ul> <li>Algunos jugadores en este sitio web son mas casuales y no intentan hacer muchos mas que pasar juegos. No todos sienten la necesidad de Masterizar cada juego en Hardcore mode. Muchos son perfectamente felices agarrando uno que otro logro aparte durante su play-through normal, y no hay nada malo con eso. </li> </ul> <ul> <li>Algunas escenas son memorables, y merecen sus propio logros! Gente que creci\u00f3 con estos juegos mueren por ver esas escenas en la lista de logros, y tal vez les llegue un poco al coraz\u00f3n cuando vean que ya consiguieron ese logro. </li> </ul> <ul> <li>Los Logros basados en progresi\u00f3n ayudan a otros usuarios a medir que tan lejos esta un jugador en el juego, un poco como  Rich Presence. Podemos decirle algo al jugador como, \"Buena suerte!\" porque sabemos que la siguiente secci\u00f3n sera bastante complicada. Motiva a la comunidad a interactuar. </li> </ul> <ul> <li>El orden importa! Logros de Progresion nos pueden decir sobre un play-through simplemente con el orden en el que salieron. Si sacaste un logro por ese jefe opcional y te ahorraste un mill\u00f3n de dolares DESPU\u00c9S de a ver hecho todas las  sidequests, ese es mucho meno impresionante si conseguiste hacerlo antes de la mitad del juego. En otras palabras, Logros de Progresion nos dan la oportunidad de mostrar un poco como jugamos! Podemos mostrarle al mundo que vencimos al ultimo jefe antes de llegar al nivel 10, o que pudimos vence el modo experto en nuestra primera pasada sin a ver intentado anteriormente F\u00e1cil o Normal. Incluso puede revelar si utilizamos glitches o trucos para saltarnos cierta parte del juego. As\u00ed que, como puedes ver, Logros de Progresion tienen una gran SINERGIA con otros tipos de logros.</li> </ul> <ul> <li>Este tipo de logros son los mas f\u00e1ciles de programar y est\u00e1n generalmente libre de errores. </li> </ul>"},{"location":"Achievement-Design-es/#contras","title":"Contras","text":"<ul> <li>Demasiados logros de progresi\u00f3n pueden sobre-saturar un juego con logros 'regalados', y eso es algo Muy Malo. </li> </ul> <ul> <li>Si tu juego tiene nada mas que este tipo de logros, es simplemente otro play-through aburrido para los jugadores. Llega al stage 2, Llega al stage 3, Llega al stage 4, Completa el Juego. Esta es una buena 'base' para agregar logros de otras categor\u00edas, pero no dejes tu lista en solamente logros de Progresion. De otra manera simplemente estas regalando puntos por algo que los jugadores han hecho un mill\u00f3n de veces anteriormente. </li> </ul>"},{"location":"Achievement-Design-es/#logros-de-sidequestsopcionales","title":"Logros de Sidequests/Opcionales","text":"<p>Los juegos de anta\u00f1o, por lo general, ofrecen de muy poco a nada por vencer un modo extra, mas all\u00e1 de simplemente hacerlo en un d\u00eda lluvioso despu\u00e9s de pasar el juego. Los juegos viejos no contaban con una conexi\u00f3n a Internet. Y no contaban con aspectos sociales mas all\u00e1 del modo de 2-jugadores, y tal vez decirle a tus amigos que pasaste algo. Pero ahora, con RetroAchievements.org, podemos mostrar nuestros logros de anta\u00f1o (incluso si implica volver a hacer lo que hicimos hace a\u00f1os atr\u00e1s). Estos Trofeos son medallas de honor. Puedes observar con ver los logros de otro compa\u00f1ero y empezar a entender que tan lejos a llegado, que tanta habilidad tiene. Junto con eso tambi\u00e9n viene el respeto hacia otros compa\u00f1eros. Socializamos, felicitamos a cualquiera que hubiera hecho un buen trabajo. Sentimos como si perteneci\u00e9ramos, y estuvi\u00e9ramos en buena compa\u00f1\u00eda.</p>"},{"location":"Achievement-Design-es/#misiones-secundarias","title":"Misiones Secundarias","text":"<p>A menudo hay cosas que el jugador puede hacer, pero no son necesarias de completar. En otras palabras, un reto hecho por los desarrolladores. Usualmente son divertidas, o algunas veces no tanto, pero merecen un precio porque requieren de trabajo duro y persistencia para lograrlos. Tienes que caminar por una cuerda floja entre si los jugadores dedicados har\u00e1n algo al respecto, vs. si la meta es algo est\u00fapido. La gente simplemente le va a dar la vuelta, as\u00ed que ten eso en mente.</p> <p>Algunas veces, este tipo de logros son incluso Easter Eggs o cosas que el jugador en toda su vida jam\u00e1s supo que exist\u00edan! Muchos jugadores adoran este tipo de logros. Yo pienso porque aprenden algo nuevo de un juego con el que crecieron, o pensaban que eran los \u00fanicos que saben sobre ello y se emocionan al verlo como un logro aqu\u00ed. Es realmente importante para nosotros los desarrolladores REALMENTE conocer el juego por dentro y por fuera antes de crear un set de logros.</p> <p>Ejemplos de Misiones Secundarias:</p> <ul> <li>Entregar colas al Colector de Colar en Final Fantasy IV. </li> <li>Encontrar el due\u00f1o del \u00cdtem Insignificante en Earthbound. </li> <li>Entregar el Jerky a el Rey en el Castillo de Guardia. </li> <li>La misi\u00f3n de Anju en Majora's Mask. </li> <li>Saber mas del pasado de Wrex en Mass Effect. </li> <li>Las misiones de escolta de Diplomacia/VIP en Flashback: The Quest for Identity. </li> <li>Descubrir un cuarto secreto. </li> </ul> <p>Las misiones secundarias son mas com\u00fanmente encontradas en RPGs, pero especialmente en estos d\u00edas, las sidequests se encuentra pr\u00e1cticamente en cualquier genero. Manten los ojos bien abiertos - Incluso el plataformero que menos piensas podr\u00eda tener una o dos sidequests. La serie de Kirby, en algunos casos, cuenta con \u00e1reas y cuartos escondidos. Algunas veces, las sidequests terminan otorgando un \u00edtem, que cae en un hibrido de: Misiones Secundarias/Colleccionables.</p>"},{"location":"Achievement-Design-es/#logros-opcionales","title":"Logros Opcionales","text":"<p>Ejemplos de Logros Opcionales:</p> <ul> <li>Jefes opcionales. </li> <li>Completar un calabozo de reto (que es un h\u00edbrido de una Sidequest). </li> <li>Completar el Modo Experto (que es un h\u00edbrido de Progresion). </li> <li>Completar un nivel de reto secreto. </li> <li>Conseguir un \u00edtem bastante raro de un monstruo. </li> <li>Completar el juego con un personaje opcional. </li> <li>Obtener alguna puntuaci\u00f3n. </li> <li>Completar caracter\u00edsticas que solo se desbloquean en la segunda pasada. </li> <li>Modos de juego que solo se desbloquean en m\u00faltiples pasadas. </li> <li>Finales del juego opcionales. </li> <li>C\u00f3digos que puedes introducir en la pantalla de t\u00edtulo para hacer el juego mas dificil. </li> </ul> <p>Estos son los desarrolladores del juego esperando a que te guste su juego lo suficiente para que vuelvas a el aun mas, incluso despu\u00e9s que hubieran rodado los cr\u00e9ditos. Ellos intentan recompensar al jugador por completar su juego, y crear un poco mas de re-jugabilidad. Si los desarrolladores del juego se dieron la molestia de hacer cosas como estas una parte integral del juego, nosotros como desarrolladores de logros deber\u00edamos de reconocer estos retos y crear los logros adecuados tan siquiera para algunos de ellos.</p> <p>Chrono Trigger, Chrono Cross, y Star Ocean: The Second Story son famosos por hacer esto. Las entregas para el Game Boy Advance de Castlevania tambi\u00e9n hacen esto. En efecto, muchos juegos lo hacen. Si no estas completamente seguro de que tu juego cuente con modos extras o retos, procura hacer un poco de research y checar algunos FAQs. O tambi\u00e9n puedes preg\u00fantale a la comunidad de aqu\u00ed, varios de nosotros somo expertos en varios juegos de aqu\u00ed. </p>"},{"location":"Achievement-Design-es/#sidequestsopcionales-pros-y-contras","title":"Sidequests/Opcionales Pros y Contras","text":"<p>Los logros de Sidequests/Opcionales son fant\u00e1sticos suplementos para los logros de Progresion. </p>"},{"location":"Achievement-Design-es/#pros_1","title":"Pros","text":"<ul> <li>Esta es el pan-y-mantequilla de los logros. Chances hay de que, una buena cantidad de tus logros vengan de esta categor\u00eda. Todos los juegos tienen cosas opcionales que hacer. Colecciona todas las monedas en un nivel! Consigue 9 vidas! Crear logros de este tipo es f\u00e1cil, y recompensa al jugador por su dedicaci\u00f3n. </li> </ul> <ul> <li>Los desarrolladores de juegos aman a los jugadores que aprecian las cosas. Les gusta cuando los jugadores se toman la molestia de adentrarse profundamente en sus juegos, apreciando su trabajo duro, de otra manera no mirar\u00edamos  cosas 'divertidas' escondidas en juegos como Easter Eggs, escenas bonus, etc. Si los desarrolladores de juegos recompensan al jugador por hacerlo, porque nosotros no? Nosotros desarrolladores tambi\u00e9n tenemos que reconocer cuando el jugador a recorrido una milla extra.</li> </ul> <ul> <li>Los jugadores aman decirle a sus amigos cuando encuentran algo inusual y fuera de lo com\u00fan en un juego. Con este sitio, ellos pueden mostrarle a sus amigos que si mataron a la 'rana amarilla' que rara vez se ve en el pantano, o encontraron el transportador a la 'dimensi\u00f3n desconocida'. Si incluimos estas curiosidades en nuestras listas de logros, le estamos demostrando a los jugadores que 'estamos informados', que crea confianza en que podemos guiarlos completamente por el juego. </li> </ul> <ul> <li>Logros de Sidequests/Opcionales le dan a los jugadores algo por lo que esforzarse despu\u00e9s de haber pasado el juego.</li> </ul> <ul> <li>Estos tipos de logros pueden ser com\u00fanmente conseguidos en cualquier momento. Los jugadores sienten un llegue mas fuerte de endorfinas cuando un logro sale cuando ellos no esperaban conseguirlo, pero se le fue premiado. </li> </ul> <ul> <li>Estos tipos de logros son por lo general f\u00e1ciles de programar, despu\u00e9s de los logros tipo progresi\u00f3n. </li> </ul>"},{"location":"Achievement-Design-es/#contras_1","title":"Contras","text":"<ul> <li>A algunos jugadores no les interesa explorar mas all\u00e1 de lo que ofrece el t\u00edpico play-through, as\u00ed que un set con un gran porcentaje de este tipo de logros pueden sentir al jugador como si no se le hubiera premiado lo suficiente. (Por supuesto, este tipo de jugador es un poco raro en un sitio web centrado en logros.) </li> </ul> <ul> <li>Alguna gente podr\u00eda sentir que un reto en especifico es muy complicado, incluso si es algo que originalmente los desarrolladores incluyeron para que los jugadores lo consigan. </li> </ul> <ul> <li>Cuando creas un logro de Sidequests/Opcional digamos, por ejemplo, escapa de 999 batallas (u otro logro de llegar a un  nivel-m\u00e1ximo), te arriesgas a que la gente del sitio tal vez sientan que el logro no ofrece realmente un reto sino que  simplemente es un 'grind-fest'. Logros de este tipo son muy probables que sean dados de baja al menos que tenga un segundo prop\u00f3sito, como en Final Fantasy V donde el hecho escapar de batallas le da energ\u00eda a un arma que se llama 'Chicken Knife'. Esto tiene una SINERGIA con el juego, en comparaci\u00f3n a crear un logro en el que se basa solamente en llegar al x nivel mas alto sin ning\u00fan otro prop\u00f3sito.</li> </ul>"},{"location":"Achievement-Design-es/#logros-basados-en-coleccionables","title":"Logros Basados en Coleccionables","text":"<p>La mayor\u00eda de los logros basados en coleccionables son opcionales, al menos que los items sean MacGuffins, que en ese caso ya cae en Progresi\u00f3n/Colecci\u00f3n.</p> <p>Ejemplos:</p> <ul> <li>Encontrar los sombreros de Mickey escondidos para conseguir 1-ups en Aladdin de Genesis. </li> <li>Encontrar items excepcionalmente escondidos. </li> <li>Bestiarios. </li> <li>Desbloquear un personaje opcional. </li> <li>Llegar al M\u00e1ximo de Dinero/Bajas/Habilidades. </li> <li>Encontrar todas las diferentes maneras de morir en juegos como Prince of Persia o Shadowgate. </li> <li>Abrir todos los cofres en un juego/encontrar cada powerup. </li> <li>Todos los items/Coleccionar 99 o 255 (etc.) un \u00edtem en particular. </li> <li>Atrapar todos los Pokemon (cualquier colecci\u00f3n de monstruos, en general.) </li> </ul> <p>Si el juego almacena cierta stat/habilidad, los desarrolladores pr\u00e1cticamente te est\u00e1n motivando a que lo maximices. Ahora, podr\u00edas ser ese tipo de jugador, o tal vez no. Eso tienes que pregunt\u00e1rtelo a ti mismo, como un desarrollador, como quieras o no, otros jugadores si podr\u00edan ser capaz de conseguir esas 9999 bajas de murci\u00e9lagos vampiro por ejemplo, incluso si tu no lo hicieras. Las ventajas de esto es que la gente que no lo haria normalmente ahora tiene algo por lo que volver cuando tengan ganas de volver a jugar el juego. La desventaja es que hay otros jugadores que no llegarian tan lejos como para hacerlo, pero tambi\u00e9n sienten que tienen que MASTERIZAR cada juego r\u00e1pidamente (algo un poco raro), al final se van a quejar. Y si consigues bastantes quejas, tal vez quieras dar de baja ese logro de haz 9999 o a algo un poco mas razonable, como 500. Si nadie se divierte haciendo alg\u00fan logro, ese simplemente no es el esp\u00edritu de jugar juegos y de hacer logros. </p> <p>Tienes que utilizar tu criterio y pensar que es lo que el jugador disfrutar\u00eda mas. Como una regla de oro, es mejor tener algunos logros sobre Sidequests/Opcionales que ni siquiera ninguno. Pero con un poco de empe\u00f1o extra, estos logros pueden hacer tu lista mucho mas memorable. </p> <p>Siguiente, a llegado el momento de que nos subamos nuestras mangas como desarrolladores y nos pongamos MUY creativos, hemos llegado cuando el desarrollador reta al jugador a retos que van mucho mas all\u00e1 de las reglas del juego.</p>"},{"location":"Achievement-Design-es/#logros-por-diversion","title":"Logros por Diversi\u00f3n","text":"<p>Este tipo de logros usualmente otorgan solamente algunos puntos, pero siguen siendo divertidos</p> <p>Ejemplos de Por Diversi\u00f3n:</p> <ul> <li>Deja que el reloj llega a las 99:59 en Valkyrie Profile. </li> <li>Fondos Interactivos, as\u00ed como el cad\u00e1ver colgando en el stage 1 de Castlevania: Bloodlines. </li> <li>Cocinar el hamster en el micro-ondas en Maniac Mansion. </li> <li>Ver el apocal\u00edpsis en Majora's Mask. </li> <li>Encontrar a John Romero en Doom 2. </li> </ul> <p>Algunas veces, los desarrolladores dejan divertidos easter eggs. Ellos se van la milla extra para entrener al jugador con \u00a8que pasar\u00eda si...\u00a8. De nuevo, es nuestro trabajo identificar este tipo de casos y as\u00ed darles soporte como desarrolladores.</p>"},{"location":"Achievement-Design-es/#retos","title":"Retos","text":"<p>Una cosa que tienes que recordar sobre jugadores retro - y los juegos que juegan - es que la mayor\u00eda de las veces nosotros hemos jugado estos juegos un mill\u00f3n de veces anteriormente. Esta es la misma vieja canci\u00f3n y baile para la mayor\u00eda de nosotros, e inclusive a veces necesitamos algo de motivaci\u00f3n para hacerlo de nuevo. Algunos de nosotros hemos terminado Contra sin perder una sola vida. Bueno, a llegado la hora que lo demostremos! </p> <p>A lo que me refiero es que, pi\u00e9nsalo: Antes de este sitio web, la \u00fanica manera de demostrarle a alguien que te pasaste Contra perfectamente era invitar a un amigo para que lo viera, o moverle a un software de grabaci\u00f3n de v\u00eddeo y subir un a YouTube. Pero incluso hay, muchos de esos v\u00eddeos est\u00e1n modificados para que se vean que fue un playthrough perfectos. En cambio, este sitio, cuenta con Hardcore mode, que te ayuda a indicar que nadie esta haciendo trampa. </p> <p>Tal vez ya cuentes con logros de progresi\u00f3n y logros sobre Sidequests/Opcionales, pero si tu quieres crear una lista de logros que sea realmente grandiosa, necesitas al menos algunos logros sobre Retos. Intenta pensar atr\u00e1s a cerca de todos los juegos que haz jugado en este sitio web. Cuales son algunos de los logros mas memorables? Te puedo garantizar que son Logros sobre Retos. Hay excepciones en la regla, claro, pero el jugador tipico no va a realmente recordar un logro sobre, 'Completa el Stage 2-6', o 'Llega al Nivel 30'. Es mas probable que recuerden logros que convirtieron a su playthrough en una experiencia \u00fanica, as\u00ed como...</p> <ul> <li>completa todo el juego sin nunca haber recogido un power-up o moneda</li> <li>derrota a un jefe sin nunca haber recibido un golpe</li> <li>completa un stage sin perder una sola vida</li> </ul> <p>Esto es lo que hace a este sitio tan especial, y lo que hace a los logros algo mucho mas de simplemente completar el juego. </p> <p>Incluso los jugadores que odian la simple idea de los Logros podr\u00edan decir, \"Bueno, excepto por ESTE. Este si estaba bien.\" y te puedo garantizar que el ejemplo del que ESE ejemplo del que estaban hablando fue un logro sobre un reto, algo que reta al jugador mas all\u00e1 del juego en si. </p> <p>Un buen desarrollador de logros va a mantener sus ojos bien abiertos, y sus sentidos al m\u00e1ximo cuando se trate de desarrollar un juego, buscando buenos e inusuales retos. Tal vez notes algo en el juego que seria una haza\u00f1a bastante complicada y que vale la pena.</p>"},{"location":"Achievement-Design-es/#retos-de-speedruns","title":"Retos de Speedruns","text":"<p>Los Timers introducen una presi\u00f3n a los jugadores en sus juegos favoritos que tal vez jamas hubieran sentido. Muy pocas cosas hacen que el coraz\u00f3n se acelere tanto que un reloj haciendo tik-tok. A\u00f1ade un timer, y un juego que era anteriormente tan f\u00e1cil que se poda completar con los ojos cerrados se va a convertir transformar de repente en la prueba jugabilista definitiva de sus vidas. </p> <p>Ejemplos de Retos de Speedruns:</p> <ul> <li>Completa un juego en menos de una hora. </li> <li>Completa un nivel en especifico en menos de tres minutos. </li> <li>Completa un nivel antes de que el contador llega a ciertos segundos. </li> <li>Derrota a 30 murci\u00e9lagos vampiro durante la secuencia de escape. </li> <li>Colecciona 99 monedas bonus antes que termine la secuencia bonus. </li> <li>Llega al punto A a el punto B antes de que el d\u00eda cambie a noche. </li> <li>Tabla de Clasificaci\u00f3n - Completa el juego en el tiempo mas r\u00e1pido posible. </li> <li>Tabla de Clasificaci\u00f3n - Completa un Stage en el tiempo mas r\u00e1pido posible. </li> </ul> <p>Un desarrollador tal vez quiera ir a YouTube o Twitch y ver que tan r\u00e1pido la gente esta terminando un juego (Y por favor ignora v\u00eddeos que utilicen TAS - \"Tool Assisted Speedruns\"). Algunos pro speed-runners son muy r\u00e1pidos que el jugador t\u00edpico no tendr\u00eda la posibilidad de lograrlo en ese tiempo establecido, tienes que encontrar una manera que sea un buen balance. Y si no puedes encontrar un buen tiempo el cual retar a los jugadores, para eso est\u00e1n las tablas de clasificaci\u00f3n - Convi\u00e9rtelo en una competici\u00f3n! De hecho, algunos de tus celebridades favoritas del mundo del speedrun podr\u00edan venir a este sitio y meter uno que otro tiempo. </p> <p>Tu sabes cuando un logro te esta metiendo presi\u00f3n cuando te empiezan a sudar las manos y te encuentras nervioso mientras observas y observas el reloj. Como dije anteriormente, nada grita mas fuerte, \"Despierta!\" que un timer, especialmente cuando los desarrolladores empiezan a\u00f1adir este tipo de logros con OTROS tipos de logros (e incluso tablas de clasificaci\u00f3n) durante una secci\u00f3n contrarreloj del juego. Los Retos de Tiempo tienen una sinergia muy grande con otros tipos de logros. </p>"},{"location":"Achievement-Design-es/#retos-de-limitaciones","title":"Retos de Limitaciones","text":"<p>Ejemplos de Retos con Limitaciones:</p> <ul> <li>Completa un combate o inclusive el juego completo solamente con los personajes de cierta clase en especifico. (Un famoso ejemplo es completar Final Fantasy con un grupo de Magos Blancos.) </li> <li>Vence al jefe final sin equipo puesto. </li> <li>Completa un stage sin brincar. </li> <li>Completa un puzzle con solo dos movimientos. </li> <li>One-hit KOs. </li> <li>Low level games (LLGs). </li> <li>Logros sin que te peguen. </li> <li>Nunca presiones cierto bot\u00f3n(es) durante un reto. </li> <li>Nunca pierdas invisibilidad en un nivel completo de Mario 3, encontrando los suficientes Starmen. </li> <li>Derrota a cierto enemigo sin utilizar cierto movimiento. </li> <li>Llega con Ganon en The Legend of Zelda, sin espada. </li> <li>Derreto a cierto enemigo utilizando SOLAMENTE cierto movimiento. </li> <li>Completa un laberinto mientras estas ebrio/confundido. </li> <li>Completa el juego mientra te encuentras en un estado alterado. </li> </ul> <p>Sitios web basados en juegos en especifico son un recurso fant\u00e1stico para encontrar estos tipos de logros ellos tienen una muy buena idea de que es posible y que es imposible, e inclusive han asta escrito FAQs discutiendo retos alternos y maneras diferente de jugar el juego. </p> <p>Algunas veces, pasara de que no hay en si una comunidad. No FAQs. No tablas de mensajes. E inclusive tal vez no all\u00e1 v\u00eddeos \u00fatiles. En esos casos, tu necesitas ser una persona con la idea de crear nuevos e interesantes retos para el jugador. Ten en cuenta que ese tipo de logros toman mucha practica, tiempo, y experiencia para ser creados. </p> <p>La clave de esto es que SEAS CREATIVO! Y recuerda mantenerlo DIVERTIDO! </p>"},{"location":"Achievement-Design-es/#retos-de-puntuacion","title":"Retos de Puntuaci\u00f3n","text":"<p>Ejemplos de Retos de Puntuaci\u00f3n:</p> <ul> <li>Completa un juego o un nivel con la puntuaci\u00f3n mas baja posible. </li> <li>Completa un minijuego con la puntuaci\u00f3n perfecta (no simplemente le ganas al CPU en las tablas de clasificaci\u00f3n). </li> <li>Tablas de Clasificaci\u00f3n - Completa el juego con la puntuaci\u00f3n mas alta/mas dinero/mejor cantidad de bajas/etc. posible. </li> <li>Tablas de Clasificaci\u00f3n - Completa un nivel en especifico con la puntuaci\u00f3n mas alta/mas dinero/mejor cantidad de bajas/etc. posible.</li> </ul>"},{"location":"Achievement-Design-es/#retos-pros-y-contras","title":"Retos Pros y Contras","text":"<p>Logros sobre retos son tu oportunidad para mostrarle a los jugadores como jugar sus juegos favoritos de una manera diferente, \u00fanica, y inclusive en maneras alucinantes. A pesar de que este tipo de logros le dan un respiro de vida a un set aburrido, tu generalmente solo quieres que una peque\u00f1a parte de este tipo de logros est\u00e9n en tu lista final. </p>"},{"location":"Achievement-Design-es/#pros_2","title":"Pros","text":"<ul> <li>A los jugadores Hardcore les encantan esforzarse en este tipo de logros. </li> </ul> <ul> <li>Si algunos jugadores son bastante hardcore, puedes encontrar un buen punto medio implementando tablas de clasificaci\u00f3n, que satisface a los dos a la vez al cazador de logros casual y los jugadores hardcore. </li> </ul> <ul> <li>Esta es tu oportunidad para ponerte bastante creativo y venir con nuevos retos que los jugadores jamas se esperar\u00edan. Esta puede ser una grata sorpresa y podr\u00eda hacer tus listas verdaderamente memorables. </li> </ul>"},{"location":"Achievement-Design-es/#contras_2","title":"Contras","text":"<ul> <li>Estos tipos de logros requiere una cantidad justa de creatividad, aunque hay muchas maneras de encontrar maneras inusuales de completar juegos como por ejemplo viendo cosas como speed runs. </li> </ul> <ul> <li>Podr\u00eda requerir bastante b\u00fasqueda previa. </li> </ul> <ul> <li>Estos logros son notoriamente complicados de codificar. Estos requieren que hagas bastantes notas de c\u00f3digo, hacer bastante observaciones en las mec\u00e1nicas del juego, e inclusive a veces requieren testear bugs incluso antes que funcionen correctamente. De hecho, tal vez no te encuentres listo para hacer este tipo de logros asta que cuentes con bastantes bastantes sets de logros hechos. Afortunadamente, Logros sobre Retos siempre pueden ser agregados despu\u00e9s. </li> </ul>"},{"location":"Achievement-Design-es/#recursos-externos","title":"Recursos Externos","text":"<ul> <li>Gu\u00eda en las Mejores practicas en la creaci\u00f3n de logros escrito por  Jeff Sullivan, Desarrollador en Administraci\u00f3n de Cuentas de XNA Developer Connection (XDC) respecto a los logros de Xbox 360.</li> <li>Hazlos trabajar por eso una gu\u00eda de dise\u00f1o de logros escrita por Darran Jamieson el 1 de Enero del 2013.</li> <li>La Maquina de Logros: Entendiendo los Logros de Xbox 360 en practicas videojugables - de Mikael Jakobsson</li> </ul>"},{"location":"Achievement-Design-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 13:11] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-11 18:54] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-10 17:08] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-10 11:58] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-05-08 17:30] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-25 19:25] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-24 16:49] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-23 17:38] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-22 17:12] eldexterr:</code> Updated Achievement Design es (markdown)</li> <li><code>[2019-04-17 17:45] eldexterr:</code> Updated but still not finished</li> </ul>"},{"location":"Achievement-Design-pt_BR/","title":"Design de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Achievement Design</p> <p>Este \u00e9 um guia de como pensar sobre e desenvolver boas conquistas. N\u00e3o o lado t\u00e9cnico, mas o lado conceitual.</p> <p>Este conteudo \u00e9 um resumo do que foi originalmente escrito pelo usu\u00e1rio cirellio em um forum.  <code>texto em ingl\u00eas</code></p>"},{"location":"Achievement-Design-pt_BR/#conquistas-baseadas-em-progresso","title":"Conquistas Baseadas em Progresso","text":"<p>H\u00e1 3 tipos de conquistas baseadas em progresso: progresso simples, progresso baseado na hist\u00f3ria, e conquistas baseadas em progresso/coletagem.</p>"},{"location":"Achievement-Design-pt_BR/#progresso-simples","title":"Progresso Simples","text":"<p>Conquistas baseadas em Progresso s\u00e3o geralmente mais simples, especialmente se o jogo que voc\u00ea est\u00e1 fazendo n\u00e3o passa de fases lineares. Ou n\u00e3o tem muita coisa acontecendo na hist\u00f3ria. Neste caso, vamos dar uma olhadas em alguns exemplos BONS e RUINS disto:</p> <ul> <li>Bom: Clear Stage 1. (Conclua o 1 estagio)</li> <li>Ruim: Reach Stage 2. (Chegue o 2 estagio)</li> </ul> <p>\u00c9 preciso um pouco mais de trabalho para codificar uma conquista em que o jogador precisa concluir a fase, em vez de simplesmente chegar a pr\u00f3xima. Mas tamb\u00e9m \u00e9 muito mais satisfat\u00f3rio para o jogador, e tem muito mais um olhar profissional. Tamb\u00e9m \u00e9 menos suscet\u00edvel a problemas com jogadores que carregam save games ou savestates para ganhar conquistas em massa <code>Nota do tradutor: Em outras palavras: Evitar Cheats</code></p> <ul> <li>Bom: Complete o jogo.</li> <li>Ruim: Inicie o jogo.</li> </ul> <p>Enquanto as conquistas baseadas em progresso s\u00e3o frequentemente brindes, geralmente \u00e9 concordado aqui que uma conquista para come\u00e7ar o jogo \u00e9 um pouco f\u00e1cil demais, e n\u00e3o \u00e9 nada memor\u00e1vel para o jogador. \u00c9 apenas uma formalidade. E finalizando o jogo, no entanto, \u00e9 frequentemente a parte do jogo mais memor\u00e1vel para um jogador, e completar um jogo \u00e9 definitivamente uma conquista em si. \u00c9 uma boa pr\u00e1tica fazer essas conquistas como \"Derrote o ultimo chefe/fase e conclua o jogo\"</p> <ul> <li>Bom: Conclua as fases tem\u00e1ticas de gelo, ou Conclua as cinco primeiras fases, ou Conclua as dez primeiras fases.</li> <li>Ruim: Complete a fase 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (todas as conquistas separadas)</li> </ul> <p>Uma das piores coisas que voc\u00ea pode fazer \u00e9 criar spams de conquistas. Jogos de Puzzles s\u00e3o not\u00e1veis por esses tipos de problemas, porque as fases s\u00e3o curtas e existem centenas delas ou mais. Como um resultado, o feed da p\u00e1gina principal fica com muitas micro-atualiza\u00e7\u00f5es, que \"spama\" as conquistas das outras pessoas para baixo e pra fora da p\u00e1gina principal rapidamente. A maneira de se mostrar mais profissional nessa quest\u00e3o \u00e9 ampliar um pouco mais as conquistas, em grupos de fases. Por exemplo, se os est\u00e1gios 1-10 s\u00e3o todas tem\u00e1ticas de fogo, e as fases 11-20 s\u00e3o tem\u00e1ticas de espa\u00e7o sideral, voc\u00ea pode criar conquistas ao redor desses temas. Seja criativo.</p>"},{"location":"Achievement-Design-pt_BR/#progresso-baseado-na-historia","title":"Progresso Baseado na hist\u00f3ria:","text":"<p>Os momentos mais memor\u00e1veis na hist\u00f3ria dos jogos muitas vezes n\u00e3o est\u00e3o relacionados \u00e0 cole\u00e7\u00e3o de itens ou sidequests, mas para cenas espec\u00edficas relacionadas \u00e0 hist\u00f3ria</p> <p>Exemplos: - O primeiro encontro com Pyramid Head na s\u00e9rie Silent Hill - Encontrar a verdade sobre Darth Revan em Knights of the Old Republic - Encontrar o que ir\u00e1 acontecer no futuro em Chrono Trigger - Lan\u00e7ar a vaca em Earthworm Jim. - Praticamente qualquer morte de personagem.</p> <p>A coisa que voc\u00ea tem que ter cuidado extra \u00e9 com os spoilers. Se voc\u00ea pegar uma conquista baseada em progresso que tem um spoiler, contacte um desenvolvedor sobre isso. E os desenvolvedores, por favor, seja receptivo quando vier cr\u00edticas construtivas! Al\u00e9m disso, o n\u00famero e at\u00e9 a porcentagem deles ir\u00e3o variar de jogo para jogo--E depende muito de como o jogo \u00e9 baseado na hist\u00f3ria.</p>"},{"location":"Achievement-Design-pt_BR/#progressocoletagem","title":"Progresso/Coletagem","text":"<p>Progresso/Coletagem \u00e9 um h\u00edbrido comum. N\u00e3o apenas em voc\u00ea coletar um item, mas tamb\u00e9m inicia uma cena memor\u00e1vel (e obrigat\u00f3ria).</p> <p>Exemplos - Obter a Master Sword em Link to the Past, que sustenta a maldi\u00e7\u00e3o em Lost Woods - Encontrar a espada na praia em Link's Awakening, na primeira cena em que a coruja s\u00e1bia fala com voc\u00ea. - Pegar o seu Pokemon inicial, que acontece durante uma cena inicial, mas \u00e9 um \"ritual de passagem\" para a maioria dos jogadores.</p> <p>Conquistas nesta categoria h\u00edbrida podem oferecer muito mais satisfa\u00e7\u00e3o porquer eles s\u00e3o Conquistas nesta categoria h\u00edbrida geralmente s\u00e3o mais satisfat\u00f3rios pois eles desempenham um papel duplo. O jogador n\u00e3o est\u00e1 apenas pegando um item, mas tamb\u00e9m assistindo uma cena memor\u00e1vel e farturando uma conquista, tudo de uma vez. Que enxurrada de endorfina!</p>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-em-progresso","title":"Pr\u00f3s e Contras em Progresso","text":"<p>Conquistas em Progresso s\u00e3o garantidos ao jogador em uma jogada normal. Ent\u00e3o, por que t\u00ea-los?</p>"},{"location":"Achievement-Design-pt_BR/#pros","title":"Pr\u00f3s","text":"<ul> <li>Um jogador merece os pontos por jogar! Fa\u00e7a eles! Lembre, um monte de pessoas estar\u00e3o jogando esses jogos pela primeira vez, e muitos jogos s\u00e3o um pouco dificeis para se zerar. Por que n\u00e3o devemos recompensar os jogadores por uma boa e normal jogada?</li> </ul> <ul> <li>Pr\u00eamios de progress\u00e3o peri\u00f3dicos ajudam a encorajar os jogadores a completar um jogo.</li> </ul> <ul> <li>Alguns jogadores s\u00e3o mais casuais e n\u00e3o pretendem fazer muito mais do que zerar jogos neste site. Nem todo mundo sente a necessidade de platinar todos os jogos no modo Hardcore. Muitos ficam perfeitamente felizes em conseguir qualquer conquista que possam ter durante uma jogada normal, e n\u00e3o h\u00e1 nada de errado com isso.</li> </ul> <ul> <li>Algumas cenas s\u00e3o t\u00e3o memor\u00e1veis que merecem conquistas pr\u00f3prias! As pessoas que cresceram com esses jogos e os amam, tem o costume de procurar essas cenas em listas de conquistas, e isso pode apenas aquecer seu cora\u00e7\u00e3o quando elas perceberem que isso foi reconhecido.</li> </ul> <ul> <li>Conquistas de progresso ajudam outras pessoas no site a avaliar a dist\u00e2ncia de um jogador em um jogo, parecido com o Estado de Presen\u00e7a. N\u00f3s podemos \"soltar uma linha\" para o jogador e dizer: \"Boa sorte!\" porque sabemos que a pr\u00f3xima parte \u00e9 bem complicada. Encoraja a comunidade a interagir.</li> </ul> <ul> <li>A ordem importa! Conquistas em Progresso podem nos dizer muito sobre o progresso apenas pela ordem que elas ocorram. Se voc\u00ea ativar aquela conquista de boss opcional e conseguiu um milh\u00e3o de dolares, ent\u00e3o voc\u00ea est\u00e1 fazendo todas as sidequests, isso \u00e9 muito menos impressionante do que se voc\u00ea conseguir tir\u00e1-lo bem antes do meio do jogo. Em outras palavras, conquistas em progresso nos permite mostrar um pouco! Podemos mostrar ao mundo que podemos vencer o chefe final antes de chegarmos ao n\u00edvel 10, ou que podemos finalizar o Expert Mode antes de ir primeiro no Facil e Normal. Pode at\u00e9 revelar se usamos falhas ou truques para pular certas partes do jogo. Ent\u00e3o, como voc\u00ea pode ver, conquistas em progresso tem grande SINERGIA com outros tipos de conquistas.</li> </ul> <ul> <li>Esses tipos de conquistas s\u00e3o as mais faceis de codificar e s\u00e3o geralmente livres de erros.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#contras","title":"Contras","text":"<ul> <li>Muitas Conquistas em Progresso podem saturar um jogo com 'brindes', e isto \u00e9 uma Coisa Muito Ruim.</li> </ul> <ul> <li>Se todo o seu jogo n\u00e3o \u00e9 nada alem do que esses tipos de conquistas, entao \u00e9 apenas uma jogatina chata para os jogadores. Chegue a fase 2, Chegue a fase 3, Chegue a fase 4, Complete o Jogo. Estas as uma grande 'base' para voc\u00ea come\u00e7ar a adicionar conquistas de outras categorias, mas n\u00e3o deixe que listas apenas com conquistas em progresso se voc\u00ea pode ajudar com isso. Outra coisa al\u00e9m disso voc\u00ea apenas estar\u00e1 recompensando jogadores por fazer coisa que eles j\u00e1 fizeram um milh\u00e3o de vezes antes.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#sidequestconquistas-opcionais","title":"Sidequest/Conquistas Opcionais","text":"<p>Os jogos antigos, por si s\u00f3, oferecem pouco ou nenhum incentivo para zerar um bonus, al\u00e9m de que \u00e9 algo para fazer em um dia chuvoso depois de voc\u00ea ter zerado o jogo. Jogos antigos n\u00e3o tinham conectividade com a Internet. E eles n\u00e3o tinham aspectos sociais al\u00e9m de 2 jogadores, e talvez dizendo a seus amigos da escola que voc\u00ea vencesse alguma coisa. Mas agora, com o Retroachievements.org, nos podemos mostrar seus trof\u00e9is antigos (mesmo que isso nos obrigue a refazer o que provavelmente j\u00e1 fizemos h\u00e1 muitos anos). Estes trof\u00e9is s\u00e3o emblemas de honra. Voc\u00ea pode olhar as conquistas de outros membros e come\u00e7ar a entender o qu\u00e3o longe eles foram, o qu\u00e3o h\u00e1beis eles s\u00e3o. Junto com isso vem o respeito dos outros membros. N\u00f3s socializamos, n\u00f3s parabenizamos uns aos outros por um trabalho bem feito. E n\u00f3s somos uma boa compania.</p>"},{"location":"Achievement-Design-pt_BR/#sidequests","title":"Sidequests","text":"<p>Muitas vezes h\u00e1 coisas que o jogador pode fazer que est\u00e3o confinados \u00e0s regras do jogo, mas n\u00e3o s\u00e3o necess\u00e1rias para complet\u00e1-lo. Em outras palavras, um desafio contruido para o jogo pelos desenvolvedores originais do jogo. Geralmente elas s\u00e3o divertidos, mas merecem ser ganhos porque elas requerem trabalho duro e pesistencia para ganhar. Voc\u00ea tem que caminhar em uma corda bamba bem entre se jogadores dedicados s\u00e3o propensos a fazer algo, vs. se o objetivo \u00e9 estupido. As pessoas ter\u00e3o vis\u00f5es diferentes sobre isso, ent\u00e3o fortale\u00e7a-se.</p> <p>Muitas vezes, esses tipos de conquistas s\u00e3o at\u00e9 Easter Eggs ou coisas que o jogador nunca soube que existiam em toda a sua vida! Muitos jogadores adoram esses tipos de conquistas. Provavelmente porque eles acabam conhecendo algo novo  sobre um jogo que eles cresceram jogando, ou talvez por perceber que aquele segredo do jogo que \"s\u00f3 ele conhece\" est\u00e1 sendo suportado aqui. \u00c9 muito importante para n\u00f3s desenvolvedores conhecer MUITO BEM o jogo antes de criar um set de conquistas.</p> <p>Exemplos de Sidequests:</p> <ul> <li>Entregando caudas para o Coletor de Caudas em Final Fantasy IV.</li> <li>Encontrar ao dono do Item Insignificante em Earthbound.</li> <li>Entregar o \"Jerky\" para o Rei em Guardia Castle.</li> <li>Fazer a sidequest do Anju em Majora's Mask.</li> <li>Aprender sobre o passado de Wrex em Mass Effect</li> <li>Escoltar Uma pessoa muito Importante em Flashback: The Quest for Identity.</li> <li>Descobrir uma sala secreta.</li> </ul> <p>Sidequests s\u00e3o mais frequentemente encontrados em RPGs, mas especialmente nesses dias, sidequests s\u00e3o encontrandas em quase todos os g\u00eaneros. Mantenha seus olhos abertos, jogos de plataforma pode tem uma ou tr\u00eas sidequests. Os jogos da s\u00e9rie Kirby por exemplo, tem muitas salas e \u00e1reas escondidas. Muitas vezes, sidequests acabam com \"ganhando um item\" no qual acaba sendo um hibrido: Sidequest/Coletagem.</p>"},{"location":"Achievement-Design-pt_BR/#conquitas-opcionais","title":"Conquitas Opcionais","text":"<ul> <li>Chefes Opcionais</li> <li>Concluir o desafio de uma dungeon (Que \u00e9 um h\u00edbrido de Sidequest)</li> <li>Completar o Modo Expert (que \u00e9 um h\u00edbrido de progress\u00e3o)</li> <li>Completar um desafio secreto.</li> <li>Conseguir a exce\u00e7\u00e3o de de conseguir pegar um item de um monstro. (Pegar um item raro)</li> <li>Completar o jogo com um personagem opcional.</li> <li>Conseguir uma pontua\u00e7\u00e3o alta</li> <li>Conseguir coisas que apenas s\u00e3o desbloqueadas em uma segunda jogatina</li> <li>Modos de jogos que s\u00e3o apenas desbloqueadas em multiplas jogatinas</li> <li>Ver finais opcionais</li> <li>Colocar c\u00f3digos para deixar o jogo mais dificil (Passwords e senhas)</li> </ul> <p>Estes s\u00e3o os criadores do jogo esperando que voc\u00ea goste de seu jogo o suficiente para continuar voltando para mais, mesmo depois que esses cr\u00e9ditos terminarem. Eles est\u00e3o tentando recompensar o jogador por completar seu jogo e criar alguma forma de satisfazer uma segunda jogatina. Se os criadores do jogo tem problemas de fazer essas coisas como parte integral do jogo, nos como desenvolvedores de conquistas devemos reconhecer esses desafios e criar conquistas apropriadas para pelo menos alguns deles.</p> <p>Chrono Trigger, Chrono Cross, and Star Ocean: The Second Story s\u00e3o famosos por isso. De fato, muitos jogos fazem isso. Se voc\u00ea n\u00e3o tem certeza se o seu jogo tem modos extras ou desafios, tenha certeza de fazer alguma pesquisa e chegar alguns FAQs. Ou perguntar na nossa comunidade, muitos de n\u00f3s somos experts nos jogos que s\u00e3o suportados aqui.</p>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-de-sidequestsopcionais","title":"Pr\u00f3s e Contras de Sidequests/Opcionais","text":"<p>Conquistas de Sidequests/Opcional fazem complementos fant\u00e1sticos para Conquistas de Progresso.</p>"},{"location":"Achievement-Design-pt_BR/#pros_1","title":"Pr\u00f3s","text":"<ul> <li>Isto \u00e9 uma m\u00e3o-na-roda de fazer conquistas. As chances s\u00e3o, uma boa parte das conquistas que voc\u00ea ir\u00e1 fazer ser\u00e3o desta categoria. Todos os jogos tem coisas opcionais para se fazer. Como coletar todas as moedas em uma fase! Ganhar 9 vidas! Criar conquistas com esse tipo de conte\u00fado \u00e9 facil, e recompensar o jogar pela sua dedica\u00e7\u00e3o.</li> </ul> <ul> <li>Criadores de jogos amam jogadores apreciativos. Eles adoram quando os jogadores se incomodam em procurar fundo em seus jogos, apreciam seu trabalho duro, caso contr\u00e1rio, n\u00e3o ver\u00edamos coisas 'divertidas' escondidas em jogos como Easter Eggs, cenas bonus, etc. Se um criador de jogos recompensa os jogadores por fazer isso, por n\u00f3s n\u00e3o? Nos desenvolvedores devemos reconhecer que o jogador foi al\u00e9m.</li> </ul> <ul> <li>Os jogadores adoram contar aos seus amigos quando encontram algo incomum e fora do comum em um jogo. Neste site, eles podem mostrar aos seus amigos que eles realmente mataram o 'sapo amarelo' raramente visto no p\u00e2ntano, ou encontar o portal para a 'dimens\u00e3o misteriosa'. Se nos incluimos essas curiosidade em nossa lista de conquistas, n\u00f3s mostramos aos jogadores que estamos \"no conhecimento\" que cria confian\u00e7a de que podemos gui\u00e1-los competentemente atrav\u00e9s do jogo.</li> </ul> <ul> <li>Conquistas de Sidequests/Opcionais d\u00e3o aos jogadores algo para se esfor\u00e7ar por depois que eles zerarem o jogo.</li> </ul> <ul> <li>Esses tipos de conquistas podem frequentemente serem ganhados em qualquer tempo e n\u00e3o est\u00e3o em um cronograma programado. Jogadores sentem uma corrida extra de endorfinas quando aparece uma conquista que eles n\u00e3o esperavam, mas foi conquistada.</li> </ul> <ul> <li>Esses tipos de conquistas s\u00e3o geralmente faceis de fazer, segundo, apenas para conquistas de estilo de progresso</li> </ul>"},{"location":"Achievement-Design-pt_BR/#contras_1","title":"Contras","text":"<ul> <li>Alguns jogadores n\u00e3o se importam em explorar al\u00e9m de uma jogatina t\u00edpica do que ofecere, ent\u00e3o uma alta porcentagem desses tipos de conquistas em um jogo pode deixar o jogador abaixo da recompensa. (Este tipo de jogador \u00e9 um pouco raro em um site concentrado em conquistas.)</li> </ul> <ul> <li>Algumas pessoas podem sentir um desafio espec\u00edfico muito dif\u00edcil, mesmo se \u00e9 algo que os desenvolvedores do jogo original incluiram no jogo para os jogadores conseguirem.</li> </ul> <ul> <li>Quando voc\u00ea cria uma conquista de Sidequest/Opcional para, digamos, fugir de 999 batalhas (ou outras conquistas de maximizar o status), voc\u00ea corre o risco de que as pessoas neste site n\u00e3o sintam que essa conquista em particular ofere\u00e7a um desafio e \u00e9 apenas um grind (grind \u00e9 quando se h\u00e1 repeti\u00e7\u00e3o de uma parte para se ganhar experi\u00eancia). Conquistas como essas podem muito bem acabar sendo envias para o \"N\u00e3o-oficial\", a menos que sirvam a um segundo prop\u00f3sito como em Final Fantasy V quando correr de batalhas pode melhor uma arma chamada 'Chicken Knife'. Isto tem SINERGIA com o jogo, ao contr\u00e1rio de criar uma conquista baseada no aumento de n\u00edvel que n\u00e3o tem utilidade.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#conquistas-baseadas-em-coletas","title":"Conquistas baseadas em coletas","text":"<p>A maioria das conquistas baseadas em coleta s\u00e3o opcionais, a menos que os itens em si sejam MacGuffins, que, nesse caso, cairiam diretamente em Progress\u00e3o / Cole\u00e7\u00e3o.</p> <p>Exemplos:</p> <ul> <li>Encontrar os chap\u00e9us de Mickey escondidos no cen\u00e1rio para obter 1 vida em Aladdin (Mega Drive).</li> <li>Encontrar itens excepcionalmente bem escondidos</li> <li>Besti\u00e1rios.</li> <li>Desbloquear um personagem opcional.</li> <li>Maximizar dinheiro / kills / status.</li> <li>Encontrar todas as maneiras diferentes de morrer em jogos como Prince of Persia ou Shadowgate.</li> <li>Abrindo todos os ba\u00fas do tesouro em um jogo / encontrando cada powerup.</li> <li>Todos os itens / Coletando 99 ou 255 (etc.) de um item.</li> <li>Capturando todos os Pokemon (qualquer cole\u00e7\u00e3o de monstros, na verdade.)</li> </ul> <p>Se o jogo acompanhar uma estat\u00edstica, o desenvolvedor do jogo est\u00e1 praticamente desafiando voc\u00ea a maximiz\u00e1-lo. Agora, voc\u00ea pode ser esse tipo de jogador, e voc\u00ea pode n\u00e3o ser. Voc\u00ea tem que perguntar a si mesmo, como um desenvolvedor, se os outros jogadores provavelmente obter\u00e3o 9999 mortes de um inimigo, mesmo que voc\u00ea n\u00e3o o fa\u00e7a. As vantagens disso s\u00e3o que as pessoas que normalmente n\u00e3o fazem isso sempre t\u00eam algo para voltar e trabalhar quando sentem vontade de jogar novamente. A desvantagem \u00e9 que outros jogadores que normalmente n\u00e3o ir\u00e3o t\u00e3o longe e talvez n\u00e3o o fa\u00e7a, mas tamb\u00e9m sentem que precisam PLATINAR rapidamente todos os jogos (raros de encontrar), v\u00e3o reclamar. Se voc\u00ea receber reclama\u00e7\u00f5es suficientes, voc\u00ea pode querer reduzir 9999 algo mais razo\u00e1vel, como 500. Se ningu\u00e9m est\u00e1 se divertindo com uma conquista, n\u00e3o \u00e9 no esp\u00edrito de jogar ou fazer uma conquista.</p> <p>Voc\u00ea tem que usar seu melhor julgamento aqui e pensar no que o jogador mais gosta. Como regra geral, \u00e9 melhor ter algumas conquistas paralelos / opcionais do que nenhuma. Mas com um pouco de esfor\u00e7o extra, essas conquistas podem tornar sua lista muito memor\u00e1vel.</p> <p>Em seguida, \u00e9 hora de arrega\u00e7ar as mangas como desenvolvedores e ser REALMENTE criativos quando os pr\u00f3prios desenvolvedores desafiam o jogador al\u00e9m das regras do jogo.</p>"},{"location":"Achievement-Design-pt_BR/#conquistas-divertidas","title":"Conquistas divertidas","text":"<p>Este tipo de conquistas geralmente vale apenas alguns pontos, mas eles ainda s\u00e3o divertidos</p> <p>Exemplos de divers\u00e3o:</p> <ul> <li>Deixando o rel\u00f3gio marcar 99:59 em Valkyrie Profile.</li> <li>Fundos interativos, como cutucar o cad\u00e1ver pendurado no est\u00e1gio 1 de Castlevania: Bloodlines.</li> <li>Cozinhando o hamster no microondas em Maniac Mansion.</li> <li>Assistindo o apocalipse em Majora's Mask.</li> <li>Encontrando John Romero em Doom 2.</li> <li>\u00c0s vezes, criadores de jogos adicionam easter eggs (segredos) divertidos. Para entreter o jogador com 'e se isso estivesse ali?'. Mais uma vez, \u00e9 nosso trabalho, como desenvolvedores, reconhec\u00ea-los e apoi\u00e1-los o m\u00e1ximo que pudermos.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#desafios","title":"Desafios","text":"<p>Uma coisa que voc\u00ea deve lembrar sobre os jogadores retr\u00f4 - e os jogos que eles jogam - \u00e9 que a maioria de n\u00f3s j\u00e1 jogou esses jogos um milh\u00e3o de vezes antes. Esta \u00e9 a mesma velha m\u00fasica e dan\u00e7a para a maioria de n\u00f3s, e muitas vezes precisamos de motiva\u00e7\u00e3o para faz\u00ea-lo novamente. Alguns de n\u00f3s podem terminar o Contra sem perder uma \u00fanica vida. Bem, agora \u00e9 a nossa chance de provar isso!</p> <p>Quero dizer, pense nisso: antes deste site, a \u00fanica maneira de provar que voc\u00ea pode fazer uma corrida impec\u00e1vel de Contra era convidar um amigo, sentar e mostrar a ele, ou descobrir software de grava\u00e7\u00e3o e fazer um v\u00eddeo no YouTube. Mas mesmo assim, muitos desses v\u00eddeos s\u00e3o manipulados para se parecer com jogos perfeitos. Este site, no entanto, tem o modo Hardcore, que ajuda a indicar que ningu\u00e9m est\u00e1 trapaceando.</p> <p>Voc\u00ea pode ter Conquistas progressivas e Sidequest / Conquistas Opcionais, mas se voc\u00ea quiser criar uma lista de conquistas que seja realmente \u00f3tima, voc\u00ea precisa de pelo menos algumas Conquistas de Desafio. Tente pensar em todos os jogos que voc\u00ea jogou aqui neste site. Quais s\u00e3o algumas das realiza\u00e7\u00f5es mais memor\u00e1veis? Eu quase posso garantir que eles eram Conquistas de Desafio. Existem exce\u00e7\u00f5es \u00e0 regra, \u00e9 claro, mas o jogador t\u00edpico n\u00e3o vai se lembrar com carinho, Concluir a fase 2-6', ou 'Chegar ao nivel 30'. Eles s\u00e3o mais propensos a se lembrar com carinho de realiza\u00e7\u00f5es que fizeram de seus jogatinas uma experi\u00eancia \u00fanica, como ...</p> <ul> <li>passar o jogo inteiro sem nunca pegar um powerup ou moeda</li> <li>derrotar um chefe sem ser atingido</li> <li>terminar um est\u00e1gio sem perder uma vida</li> </ul> <p>Isso \u00e9 o que torna este site t\u00e3o especial, e o que faz das conquistas algo mais do que apenas vencer um jogo.</p> <p>Mesmo os cr\u00edticos mais contundentes que odeiam a id\u00e9ia de realiza\u00e7\u00f5es podem dizer: \"Bem, exceto por este. Esse foi bom\". E eu garanto que UM exemplo de que eles est\u00e3o falando \u00e9 uma conquista de desafio, algo que desafiou o jogador al\u00e9m do pr\u00f3prio jogo.</p> <p>Um bom desenvolvedor de realiza\u00e7\u00f5es manter\u00e1 seus olhos abertos, sua intelig\u00eancia sobre eles e seus sentidos afiados ao desenvolver um jogo, procurando por desafios bons e incomuns. Eles podem perceber algo no jogo que \u00e9 um feito dif\u00edcil.</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-speedrun","title":"Desafios de Speedrun","text":"<p>Os timers apresentam uma press\u00e3o adicional que os jogadores podem nunca ter sentido antes enquanto jogam seus jogos favoritos. Poucas coisas fazem o cora\u00e7\u00e3o bombear mais do que um rel\u00f3gio imponente. Adicione um elemento de temporizador, e um jogo que anteriormente era t\u00e3o f\u00e1cil que eles poderiam venc\u00ea-lo de olhos vendados poderia de repente ser transformado no maior desafio de jogo de suas vidas.</p> <p>Exemplos de desafios do Speedrun:</p> <ul> <li>Concluindo um jogo em menos de uma hora.</li> <li>Limpando um est\u00e1gio espec\u00edfico em menos de tr\u00eas minutos.</li> <li>Passe o temporizador em um certo n\u00famero de segundos.</li> <li>Mate 30 morcegos durante a sequ\u00eancia de fuga.</li> <li>Colete 99 moedas b\u00f4nus antes que a tela b\u00f4nus desapare\u00e7a.</li> <li>V\u00e1 do ponto A ao ponto B antes que o dia mude para a noite.</li> <li>Leaderboard - Complete o jogo com o menor tempo poss\u00edvel.</li> <li>Leaderboard - Complete um determinado est\u00e1gio com o menor tempo poss\u00edvel.</li> </ul> <p>Um desenvolvedor pode querer ir ao YouTube ou Twitch e ver o qu\u00e3o r\u00e1pido as pessoas est\u00e3o terminando um jogo (E, por favor, ignore o TAS - \"Tool Assisted Speedruns\"). Alguns corredores profissionais de velocidade s\u00e3o t\u00e3o r\u00e1pidos que o jogador t\u00edpico n\u00e3o ter\u00e1 a menor chance de competir, mas voc\u00ea deve ser capaz de encontrar um ponto m\u00e9dio entre o melhor tempo dele e o seu. E se voc\u00ea n\u00e3o consegue descobrir um bom momento para desafiar os jogadores aqui, \u00e9 para isso que os Leaderboards s\u00e3o - Transforme isso em uma competi\u00e7\u00e3o! Na verdade, alguns de seus favoritos speed-runners podem vir a este site e colocar seus tempos.</p> <p>Voc\u00ea saber\u00e1 quando voc\u00ea est\u00e1 enfrentando uma conquista de press\u00e3o quando as palmas das m\u00e3os est\u00e3o suando e voc\u00ea se v\u00ea nervosamente olhando para o cron\u00f4metro. Como eu disse antes, nada grita: \"Aten\u00e7\u00e3o!\" mais alto que um cron\u00f4metro, especialmente quando os desenvolvedores come\u00e7am a tecer esse tipo de conquista com OUTROS tipos de conquistas (e at\u00e9 placares de l\u00edderes) durante uma parte cronometrada de um jogo. Os Desafios Temporizadores t\u00eam uma quantidade insana de sinergia com outros tipos de conquistas.</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-limitacao","title":"Desafios de Limita\u00e7\u00e3o","text":"<p>Exemplos de Desafios de Limita\u00e7\u00e3o:</p> <ul> <li>Limpar uma batalha ou at\u00e9 mesmo um jogo inteiro com todos os personagens de uma classe espec\u00edfica. (Um exemplo famoso disso \u00e9 terminar o Final Fantasy original com um grupo de White Mages.)</li> <li>Derrote um chefe final sem equipamento.</li> <li>Conclua um est\u00e1gio sem nunca saltar.</li> <li>Resolva um quebra-cabe\u00e7a em apenas dois movimentos.</li> <li>One-hit KOs.</li> <li>Jogos de baixo n\u00edvel (LLGs).</li> <li>Nenhuma conquista de sucesso.</li> <li>Nunca aperte em determinado bot\u00e3o durante um desafio.</li> <li>Nunca perca a invencibilidade atrav\u00e9s de uma etapa inteira do Mario 3 encontrando estrelas suficientes.</li> <li>Derrote um certo inimigo sem usar um certo movimento.</li> <li>Alcan\u00e7ando Ganon em Legend of Zelda, sem espada.</li> <li>Derrote um certo inimigo SOMENTE usando um certo movimento.</li> <li>Trope\u00e7ar no caminho atrav\u00e9s de um labirinto, enquanto b\u00eabado / confuso.</li> <li>Limpe o jogo com uma doen\u00e7a no status.</li> </ul> <p>Os sites da comunidade constru\u00eddos em torno de determinados jogos s\u00e3o um recurso fant\u00e1stico para esses tipos de realiza\u00e7\u00f5es. Eles ter\u00e3o uma boa id\u00e9ia sobre o que \u00e9 poss\u00edvel e imposs\u00edvel, e provavelmente escreveram perguntas frequentes discutindo maneiras alternativas e desafiadoras de jogar o jogo inteiro.</p> <p>Muitas vezes, por\u00e9m, n\u00e3o haver\u00e1 comunidade. N\u00e3o h\u00e1 perguntas frequentes. Nenhum quadro de mensagens. E talvez nem v\u00eddeos \u00fateis. Nesses casos, voc\u00ea precisar\u00e1 ser uma pessoa de ideias para criar maneiras novas e interessantes de desafiar o jogador. Esteja ciente de que esse tipo de conquista requer muita pr\u00e1tica, tempo e experi\u00eancia para criar.</p> <p>O jeito aqui \u00e9 ser criativo! E lembre-se de mant\u00ea-lo divertido!</p>"},{"location":"Achievement-Design-pt_BR/#desafios-de-pontuacao","title":"Desafios de pontua\u00e7\u00e3o","text":"<p>Exemplos de desafios de pontua\u00e7\u00e3o:</p> <ul> <li>Completando um jogo ou n\u00edvel com a menor pontua\u00e7\u00e3o poss\u00edvel.</li> <li>Complete um minigame com uma pontua\u00e7\u00e3o perfeita (n\u00e3o apenas no topo do ranking da CPU).</li> <li>Leaderboard - Complete o jogo com a maior pontua\u00e7\u00e3o / mais dinheiro / melhor contagem de mortes / etc. poss\u00edvel.</li> <li>Leaderboard - Complete um estagio com a maior pontua\u00e7\u00e3o / mais dinheiro / melhor contagem de mortes / etc. poss\u00edvel.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#pros-e-contras-dos-desafios","title":"Pr\u00f3s e Contras dos desafios","text":"<p>As conquistas de desafio s\u00e3o a sua chance de mostrar aos jogadores como jogar seus jogos favoritos de maneiras diferentes, \u00fanicas e at\u00e9 alucinantes. Embora essas conquistas possam dar vida a um conjunto de realiza\u00e7\u00f5es que, de outra forma, \u00e9 mon\u00f3tono, voc\u00ea geralmente quer que apenas um pequeno grupo delas esteja na sua lista final.</p> <p>Pr\u00f3s</p> <ul> <li>Jogadores hardcore amam deixar suas marcas nesses tipos de conquistas.</li> </ul> <ul> <li>Se alguns jogadores s\u00e3o muito hardcore, voc\u00ea pode encontrar um meio feliz implementando o Leaderboards, que satisfaz tanto os ca\u00e7adores de conquistas ocasionais quanto os jogadores hardcore de uma s\u00f3 vez.</li> </ul> <ul> <li>Esta \u00e9 a sua chance de ser muito criativo e criar novos desafios para jogadores que eles nunca esperaram. Isso pode ser uma surpresa agrad\u00e1vel e realmente tornar suas listas memor\u00e1veis.</li> </ul> <p>Contras</p> <ul> <li>Esses tipos de realiza\u00e7\u00f5es exigem uma boa quantidade de criatividade, embora haja muitas maneiras de pesquisar, maneiras incomuns de jogar, observando coisas como corridas de velocidade.</li> </ul> <ul> <li>Pode exigir uma pesquisa profunda.</li> </ul> <ul> <li>Estes podem ser notoriamente dif\u00edceis de codificar. Eles exigem que voc\u00ea fa\u00e7a muitas anota\u00e7\u00f5es de c\u00f3digo, fa\u00e7a toneladas de observa\u00e7\u00f5es mec\u00e2nicas do jogo e, muitas vezes, eles exigem testes de erros antes mesmo de funcionar. Na verdade, voc\u00ea pode nem estar pronto para enfrentar conquistas como essa at\u00e9 ter alguns jogos em seu curr\u00edculo com um conjunto de conquistas b\u00e1sicas. Felizmente, as Conquistas do Desafio sempre podem ser adicionadas mais tarde.</li> </ul>"},{"location":"Achievement-Design-pt_BR/#fontes-externas","title":"Fontes externas","text":"<ul> <li>Best practices achievement creation guide escrito por Jeff Sullivan, gerente de contas de desenvolvedor do XNA Developer Connection (XDC) sobre Conquistas do XBox 360. <code>texto em ingl\u00eas</code></li> <li>Make them Work for it , um guia de design de conquistas escrito por Darran Jamieson em 1\u00ba de janeiro de 2013. <code>texto em ingl\u00eas</code></li> <li>The Achievement Machine: Understanding Xbox 360 Achievements in Gaming Practices - por Mikael Jakobsson <code>texto em ingl\u00eas</code></li> </ul>"},{"location":"Achievement-Design-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-25 12:10] meleu:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-04-01 00:18] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-31 15:03] meleu:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 22:15] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 22:08] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 21:25] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 21:16] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 20:59] 7Mogami7:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 18:50] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> <li><code>[2018-03-30 18:47] KingDice001:</code> Updated Achievement Design pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Design/","title":"Achievement Design","text":"<p>This is a guide on how to think about and design good achievements. Not the technical side, but the conceptual.</p>"},{"location":"Achievement-Design/#progression-based-achievements","title":"Progression Based Achievements","text":"<p>There are 3 types of progression-based achievements: simple progression, story-based progression, and progression/collection achievements.</p>"},{"location":"Achievement-Design/#simple-progression","title":"Simple Progression","text":"<p>Progression-based achievements are usually simplest ones, especially if the game you are doing is nothing but linear stages. Or doesn't have much going on in the way of storylines. In this case, let's look at some GOOD and BAD examples of this:</p> <ul> <li>Good: Clear stage 1. </li> <li>Bad: Reach stage 2. </li> </ul> <p>It takes slightly more work to code an achievement where the player is required to clear the stage rather than simply reach the next one. But it is also much more satisfying for the player, and it is much more professional-looking. It is also less susceptible to problems with players loading save games or save states for freebie achievements en masse. </p> <ul> <li>Good: Complete the game. </li> <li>Bad: Start the game. </li> </ul> <p>While it is true progression-based achievements are often freebies, it is generally agreed upon here that an achievement to start the game is a bit too easy, and not at all memorable for the player. It's just a formality. The ending of the game, however, is often the most memorable part of a game for a player, and completing a game is definitely an achievement in itself. It's a good practice to make such achievement work like \"Beat last stage and beat the game\".</p> <ul> <li>Good: Cleared the ice theme stages, or Cleared the first five stages, or Cleared the first ten stages. </li> <li>Bad: Complete Stage 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11-200 (all separate achievements) </li> </ul> <p>One of the worst things you can do is create achievement spam. Puzzle games are notorious for these kinds of problems, because the stages are short and often, there are one-hundred of them or more. As a result, the main page feed ends up with a lot of micro-updates, which spams other folks' achievements down and off the front page quickly. The way to come off as more professional in this matter is to space out the achievements a bit more, into groups of stages. For instance, if stages 1-10 are all fire themed, and stages 11-20 are all outer-space themed, you can create achievements around these themes. Be creative. </p>"},{"location":"Achievement-Design/#story-based-progression","title":"Story Based Progression:","text":"<p>The most memorable moments in gaming history are often not related to item collection or sidequests, but to specific scenes relating to the story. </p> <p>Examples:</p> <ul> <li>First encounter with Pyramid Head in the Silent Hill series. </li> <li>Finding out the truth about Darth Revan in Knights of the Old Republic. </li> <li>Finding out what will happen in the future in Chrono Trigger. </li> <li>Launching the Cow in Earthworm Jim. </li> <li>Pretty much any character death. </li> </ul> <p>The thing you have to be extra-careful with here is spoilers. If you catch a progression-based achievement that has a spoiler in it, by all means contact the dev about it. And devs, please be receptive when it comes to constructive criticism! Also, the number and even percentage of these will vary from game to game--The dependence lies heavily upon how story-driven the game is. </p>"},{"location":"Achievement-Design/#progressioncollection","title":"Progression/Collection","text":"<p>Progression/Collection is a common hybrid. Not only are you collecting an item, but it also launches into a memorable (and mandatory) scene. </p> <p>Examples:</p> <ul> <li>Obtaining the Master Sword in Link to the Past, which lifts the curse in the Lost Woods. </li> <li>Finding the sword on the beach in Link's Awakening, which launches into the first scene where the wise owl speaks to you. </li> <li>Picking your starter Pokemon, which happens during a beginning scene, but is a 'rite of passage' for most gamers. </li> </ul> <p>Achievements in this hybrid category are often more satisfying because they are pulling double-duty. The player is not only obtaining an item, but watching a memorable scene and nabbing an achievement all at once. Quite the rush of endorphins! </p>"},{"location":"Achievement-Design/#progression-pros-and-cons","title":"Progression Pros and Cons","text":"<p>Progression Achievements are guaranteed to the player on a normal play-through. So why even have them? </p>"},{"location":"Achievement-Design/#pros","title":"Pros","text":"<ul> <li>A player deserves points for playing through a game! They do! Remember, a lot of folks are playing through these games for the very first time, and most games are quite hard to beat. Why shouldn't we reward players for a good ol' normal play-through? </li> </ul> <ul> <li>Periodic progression awards go a long way to encourage players to complete a game. </li> </ul> <ul> <li>Some players are more casual and don't intend to do much more than beat games on this website. Not everyone feels the need to Master every game in Hardcore mode. Many are perfectly happy grabbing whatever convenient side-achievements they can during a normal play-through, and there's nothing wrong with that. </li> </ul> <ul> <li>Some scenes are so memorable, they deserve achievements all their own! People who grew up with these games and love them look for these scenes in achievement lists, and it might just warm their heart when they see it was acknowledged. </li> </ul> <ul> <li>Progression Achievements help other people on the website gauge how far along a player is in a game, a bit like Rich Presence. We can drop a line to the player and say, \"Good luck!\" because we know the next section is pretty tricky. It encourages the community to interact. </li> </ul> <ul> <li>Order matters! Progression Achievements can tell us a lot about a play-through just by the order they occurred. If you pop that optional boss achievement and saved up a million dollars AFTER you've already done all the sidequests, that's much less impressive than if you manage to pull it off well before the mid-point of the game. In other words, Progression Achievements allow us to show-off a bit! We can show the world that we can beat that final boss before we've reached level 10, or that we can beat Expert mode on our first go before Easy and Normal. It can even reveal if we've used glitches or cheats to skip certain portions of the game. So, as you can see, Progression Achievements have great SYNERGY with other kinds of achievements.</li> </ul> <ul> <li>These kinds of achievements are the easiest to code and are generally error-free. </li> </ul>"},{"location":"Achievement-Design/#cons","title":"Cons","text":"<ul> <li>Too many Progression Achievements can over-saturate a game with 'freebies', and that's a Very Bad Thing. </li> </ul> <ul> <li>If your entire game has nothing but these kinds of achievements, it's just another boring run through the game for players. Reach stage 2, Reach stage 3, Reach stage 4, Complete the Game. This is a great 'base' for you to start adding achievements from the other categories, but don't leave your list at just Progression Achievements if you can help it. Otherwise you're just rewarding players full points for going through the motions like they've done a million times before. </li> </ul>"},{"location":"Achievement-Design/#sidequestoptional-achievements","title":"Sidequest/Optional Achievements","text":"<p>Vintage games, on their own, offer little-to-no incentive to beat a bonus mode, other than that it's something to do on a rainy day after you've beaten the game. Old games didn't have internet connectivity. And they had no social aspects other than 2-player mode, and maybe telling your friends at school that you beat something. But now, with RetroAchievements.org, we can display our vintage trophies (even though it requires us to redo what we've probably already done many years ago). These trophies are badges of honor. You can look at another member's Challenge Achievements and begin to understand how far they went, how skilled they are. Along with that comes respect from the other members. We socialize, we congratulate each other on a job well done. We feel like we belong, and we are in good company.</p>"},{"location":"Achievement-Design/#sidequests","title":"Sidequests","text":"<p>There are often things the player can do that are confined to the rules of the game, but aren't necessary to complete it. In other words, a challenge built into the game by the original game developers. Usually they are fun, or sometimes not so fun, but deserve an award because they require hard work and persistence to achieve. You have to walk a fine tightrope between if dedicated players are likely to do something, vs. if the goal is stupid. People will have differing views over this, so steel yourself.</p> <p>Often times, these types of achievements are even Easter Eggs or things the player never knew existed in their entire lives! Many players adore these types of achievements. I think it's because they learn something new about a game they grew up with, or feel like maybe they were the only ones who knew about a given secret and were excited to see it supported here. It's important for us developers to REALLY know a game inside-and-out before creating an achievement set.</p> <p>Examples of Sidequests:</p> <ul> <li>Delivering tails to the Tail Collector in Final Fantasy IV. </li> <li>Finding the owner of the Insignificant Item in Earthbound. </li> <li>Giving the Jerky to the King in Guardia Castle. </li> <li>Anju sidequest in Majora's Mask. </li> <li>Learning about Wrex's past in Mass Effect. </li> <li>Diplomat/VIP escort missions in Flashback: The Quest for Identity. </li> <li>Discovering a secret room. </li> </ul> <p>Sidequests are most often found in RPGs, but especially these days, sidequests are finding their way into just about every genre. Keep your eyes peeled - Even the unsuspecting platformer may have a sidequest or three. The Kirby series, for instance, has many hidden rooms and areas. Often times, sidequests end up awarding an item, which falls under a hybrid: Sidequest/Collection.</p>"},{"location":"Achievement-Design/#optional-achievements","title":"Optional Achievements","text":"<p>Examples of Optional Achievements:</p> <ul> <li>Optional bosses. </li> <li>Clearing a challenge dungeon (which is a hybrid of Sidequest). </li> <li>Completing Expert Mode (which is a hybrid of Progression). </li> <li>Completing a secret challenge level. </li> <li>Getting an exceptionally rare drop off of a monster. </li> <li>Clearing the game with an optional character. </li> <li>Getting a high score. </li> <li>Completing features only unlocked on a second playthrough. </li> <li>Game modes that are only unlocked on multiple playthroughs. </li> <li>Optional game endings. </li> <li>Codes you can enter during the title screen to make the game harder. </li> </ul> <p>This is the game makers hoping you'll like their game enough to keep coming back for more, even after those ending credits scroll by. They are trying to reward the player for completing their game, and create some form of satisfying re-playability. If the game makers went to the trouble making things like this an integral part of the game, we as achievement developers should recognize these challenges and create appropriate achievements for at least a few of them.</p> <p>Chrono Trigger, Chrono Cross, and Star Ocean: The Second Story are famous for this. The Game Boy Advance Castlevania entries also do this. In fact, many games do this. If you aren't sure if your game has any extra modes or challenges, be sure to do some research and check out some FAQs. Or ask the community here, many of us are experts on the games supported here. </p>"},{"location":"Achievement-Design/#sidequestoptional-pros-and-cons","title":"Sidequest/Optional Pros and Cons","text":"<p>Sidequest/Optional Achievements make fantastic supplements to Progression Achievements. </p>"},{"location":"Achievement-Design/#pros_1","title":"Pros","text":"<ul> <li>This is the bread-and-butter of achievement making. Chances are, a good deal of your achievements will come from this category. All games have optional things to do. Collect all the coins in a stage! Gain 9 lives! Creating achievements for this stuff is easy, and it rewards the player for their dedication. </li> </ul> <ul> <li>Game makers love appreciative players. They like it when players bother to dig deeper into their games, appreciating their hard work, otherwise we wouldn't see hidden 'fun' things in games like Easter Eggs, bonus scenes, etc. If game makers reward the players for doing it, why shouldn't we? Us devs should also recognize that the player has gone the extra mile.</li> </ul> <ul> <li>Game players love telling their friends when they find something unusual and off the beaten path in a game. With this site, they can show their friends that they did indeed slay the elusive 'yellow frog' rarely seen in the marsh, or found the warp to the 'mystery dimension'. If we include these curiosities in our achievement lists, we show the players that we are 'in the know', which builds confidence that we can competently guide them through the game. </li> </ul> <ul> <li>Sidequest/Optional Achievements give players something to strive for after they've beaten the game.</li> </ul> <ul> <li>These kinds of achievements can often be earned at any time and are not on a predictable schedule. Players feel an extra rush of endorphins when an achievement pops that they weren't expecting, but it was earned. </li> </ul> <ul> <li>These kinds of achievements are usually easy to code, second only to progression-style achievements. </li> </ul>"},{"location":"Achievement-Design/#cons_1","title":"Cons","text":"<ul> <li>Some players don't care to explore beyond what a typical play-through has to offer, so a high percentage of these types of achievements in a game can leave a player under-rewarded. (Granted, this type of gamer is a bit of a rare bird on a website centered around achievements.) </li> </ul> <ul> <li>Some people may feel a specific challenge is too hard, even if it's something the original game developers included in-game for players to achieve. </li> </ul> <ul> <li>When you create a Sidequest/Optional Achievement for, say, running away from 999 battles (or other stat-maxing achievements), you risk that the people on this website may not feel this particular achievement offers a challenge and is just a 'grind-fest'. Achievements like this may very well end up getting demoted unless they serve a second purpose, like in Final Fantasy V where running away from battles actually powers up a weapon called the 'Chicken Knife'. This has SYNERGY with the game, as opposed to creating an achievement based upon raising a stat that has no other use.</li> </ul>"},{"location":"Achievement-Design/#collection-based-achievements","title":"Collection Based Achievements","text":"<p>Most collection-based achievements are optional, unless the items themselves are MacGuffins, which in that case they would fall squarely under Progression/Collection.</p> <p>Examples:</p> <ul> <li>Finding the Mickey hats hidden in the background to obtain 1-ups in Genesis Aladdin. </li> <li>Finding exceptionally well-hidden items. </li> <li>Bestiaries. </li> <li>Unlocking an optional character. </li> <li>Maxing out Money/kills/stats. </li> <li>Finding all the different ways to die in games like Prince of Persia or Shadowgate. </li> <li>Opening every treasure chest in a game/finding every powerup. </li> <li>All items/Collecting 99 or 255 (etc.) of an item. </li> <li>Catching them all in Pokemon (any monster collection, really.) </li> </ul> <p>If the game keeps track of a stat, the game developer is practically daring you to max it out. Now you might be that kind of player, and you might not. You have to ask yourself, as a dev, whether or not other players are likely to get 9999 vampire bat kills, even if you wouldn't. The advantages to this are that people who wouldn't normally do this always have something to come back and work for when they feel like playing the game again. The disadvantage is that other players who wouldn't normally go that far and never would, but also feel like they have to MASTER every game quickly (a rare breed), will complain. If you get enough complaints, you might want to bring down that 9999 to something more reasonable, like 500. If no one's having fun with an achievement, it's not in the spirit of playing games or making achievements. </p> <p>You have to use your better judgment here and think of what the player would enjoy the most. As a rule of thumb, it's better to have a few Sidequest/Optional Achievements than none at all. But with a little extra effort, these achievements can make your list very memorable. </p> <p>Next, it's time to roll up our sleeves as devs and get REALLY creative when the devs themselves challenge the player beyond the rules of the game.</p>"},{"location":"Achievement-Design/#for-fun-achievements","title":"For-Fun achievements","text":"<p>This kind of achievements usually worths just a few points, but they are still fun</p> <p>Examples of For Fun:</p> <ul> <li>Letting the clock hit 99:59 in Valkyrie Profile. </li> <li>Interactive backgrounds, such as poking the hanging dead body in stage 1 of Castlevania: Bloodlines. </li> <li>Cooking the hamster in the microwave in Maniac Mansion. </li> <li>Watching the apocalypse in Majora's Mask. </li> <li>Finding John Romero in Doom 2. </li> </ul> <p>Sometimes, game makers add fun easter eggs. They went the extra mile to entertain the player with 'what if's'. Again, it is our job as devs to recognize and support these as much as we can.</p>"},{"location":"Achievement-Design/#challenges","title":"Challenges","text":"<p>One thing that you have to remember about retro gamers - and the games they play - is that most of us have played these games a million times before. This is the same old song and dance for most of us, and we often need motivation to do it again. Some of us can clear Contra without losing a single life. Well, now is our chance to prove it! </p> <p>I mean, think about it: Before this website, about the only way to prove you can do a flawless run of Contra was to invite a friend over, sit him down, and show him, or figure out recording software and make a YouTube video. But even then, a lot of those videos are doctored to look like flawless playthroughs. This site, however, has Hardcore mode, which help to indicate no one is cheating. </p> <p>You may have Progression Achievements and Sidequest/Optional Achievements, but if you want to create an achievement list that's truly great, you need at least a few Challenge Achievements. Try to think back to all the games you've played here at this website. What are some of the most memorable achievements? I can almost guarantee you that they were Challenge Achievements. There are exceptions to the rule, of course, but the typical player isn't going to fondly recall, 'Cleared Stage 2-6', or 'Reached Level 30'. They are more likely to fondly remember achievements that made their play-throughs a unique experience, such as...</p> <ul> <li>get through the entire game without ever picking up a powerup or coin</li> <li>defeat a boss without getting hit</li> <li>finish a stage without losing a life</li> </ul> <p>That is what makes this website so special, and what makes achievements something more than just beating a game. </p> <p>Even the most vocal critics who hate the idea of Achievements may say, \"Well, except for THIS one. This one was okay.\" And I guarantee you that ONE example they're talking about is a Challenge Achievement, something that challenged the player beyond the game itself. </p> <p>A good achievement developer will keep their eyes peeled, their wits about them, and their senses sharp when developing a game, looking for good, unusual challenges. They may notice something in the game that's a difficult feat.</p>"},{"location":"Achievement-Design/#speedrun-challenges","title":"Speedrun Challenges","text":"<p>Timers introduce an added pressure players may have never felt before while playing their favorite games. Few things get the heart pumping more than an imposing ticking clock. Add a timer element, and a game that was previously so easy they could beat it blindfolded could suddenly be transformed into the ultimate gaming challenge of their lives. </p> <p>Examples of Speedrun Challenges:</p> <ul> <li>Completing a game in under one hour. </li> <li>Clearing a specific stage in under three minutes. </li> <li>Undercut the timer by a certain number of seconds. </li> <li>Kill 30 vampire bats during the escape sequence. </li> <li>Collect 99 bonus coins before the bonus screen fades away. </li> <li>Go from point A to point B before day changes to night. </li> <li>Leaderboard - Complete the game with the fastest time possible. </li> <li>Leaderboard - Complete a given stage with the fastest time possible. </li> </ul> <p>A dev may want to head out to YouTube or Twitch and see how fast people are finishing a game (And please ignore TAS - \"Tool Assisted Speedruns\"). Some pro speed-runners are so fast, the typical player here won't stand a chance at the times being posted, but you should be able to find a happy medium. And if you can't figure out a good time to challenge the players here, that's what Leaderboards are for - Turn it into a competition! In fact, some of your favorite celebrity speed-runners may come to this very site and submit a time or two. </p> <p>You'll know when you're facing a pressure achievement when your palms are sweating and you find yourself nervously glancing at the timer. Like I said before, nothing screams, \"Wake up!\" louder than a timer, especially when developers start weaving this kind of achievement with OTHER kinds of achievements (and even leaderboards) during a timed portion of a game. Timer Challenges have an insane amount of synergy with other types of achievements. </p>"},{"location":"Achievement-Design/#limitation-challenges","title":"Limitation Challenges","text":"<p>Examples of Limitation Challenges:</p> <ul> <li>Clear a battle or even an entire game with all characters of a specific job class. (One famous example of this is clearing the original Final Fantasy with a group of White Mages.) </li> <li>Beat a final boss with no equipment on. </li> <li>Clear a stage without ever jumping. </li> <li>Solve a puzzle in only two moves. </li> <li>One-hit KOs. </li> <li>Low level games (LLGs). </li> <li>No hit achievements. </li> <li>Never hit certain button(s) during a challenge. </li> <li>Never lose invincibility through an entire Mario 3 stage by finding enough Starmen. </li> <li>Defeat a certain enemy without using a certain move. </li> <li>Reaching Ganon in Legend of Zelda, sword-less. </li> <li>Defeat a certain enemy ONLY using a certain move. </li> <li>Stumble your way through a maze while drunk/confused. </li> <li>Clear the game with a status ailment. </li> </ul> <p>Community websites built around certain games are a fantastic resource for these kinds of achievements They'll have a good idea about what's possible and impossible, and have likely written up FAQs discussing alternative and challenging ways to play the entire game. </p> <p>Often times, though, there will be no community. No FAQs. No Message Board. And maybe even no useful videos. In these cases, you'll need to be an idea person to come up with new and interesting ways to challenge the player. Be aware that these kinds of achievements take a lot of practice, time, and experience to create. </p> <p>The takeaway here is to BE CREATIVE! And remember to keep it FUN! </p>"},{"location":"Achievement-Design/#score-challenges","title":"Score Challenges","text":"<p>Examples of Score Challenges:</p> <ul> <li>Completing a game or level with the lowest possible score. </li> <li>Complete a minigame with a perfect score (not just topping the CPU leaderboard). </li> <li>Leaderboard - Complete the game with the highest score/most money/best kill count/etc. possible. </li> <li>Leaderboard - Complete a given stage with the highest score/most money/best kill count/etc. possible. </li> </ul>"},{"location":"Achievement-Design/#challenge-pros-and-cons","title":"Challenge Pros and Cons","text":"<p>Challenge Achievements are your chance to show players how to play their favorite games in different, unique, and even mind-bending ways. While these achievements can breathe life into an otherwise dull achievement set, you generally only want a small handful of these to be in your final list. </p>"},{"location":"Achievement-Design/#pros_2","title":"Pros","text":"<ul> <li>Hardcore players love sinking their teeth into these kinds of achievements. </li> </ul> <ul> <li>If some players are too hardcore, you can find a happy medium by implementing Leaderboards, which satisfies both the casual achievement hunters and the hardcore players all at once. </li> </ul> <ul> <li>This is your chance to be very creative and come up with new challenges for players they never expected. This can be a pleasant surprise and really make your lists memorable. </li> </ul>"},{"location":"Achievement-Design/#cons_2","title":"Cons","text":"<ul> <li>These types of achievements require a fair amount of creativity to dream up, though there are many ways to research unusual ways to play games by watching things like speed runs. </li> </ul> <ul> <li>May require a deep research. </li> </ul> <ul> <li>These can be notoriously difficult to code. They require you to make a lot of code notes, make tons of game mechanic observations, and often times they require bug testing before they even work. In fact, you may not even be ready to tackle achievements like this until you've had a few games under your belt with a set of baseline achievements. Fortunately, Challenge Achievements can always be added later. </li> </ul>"},{"location":"Achievement-Design/#external-resources","title":"External Resources","text":"<ul> <li>Best practices achievement creation guide written by Jeff Sullivan, Developer Account Manager of XNA Developer Connection (XDC) regarding XBox 360 Achievements.</li> <li>Make them Work for it an achievement design guide written by by Darran Jamieson on 1 Jan 2013.</li> <li>The Achievement Machine: Understanding Xbox 360 Achievements in Gaming Practices - by Mikael Jakobsson</li> </ul>"},{"location":"Achievement-Design/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-02 19:40] televandalist:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-05-08 16:36] meleu:</code> fixed some lists formatation</li> <li><code>[2018-02-01 17:29] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-30 23:04] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-28 18:50] meleu:</code> removed \"unique achievements\" section - it's the same thing as for-fun achievements</li> <li><code>[2018-01-28 14:57] meleu:</code> added one more link to an external resource and put them at the end of the doc</li> <li><code>[2018-01-28 11:42] meleu:</code> changed link to jeff sullivan article (better formatation)</li> <li><code>[2018-01-27 18:25] meleu:</code> Updated Achievement Design (markdown)</li> <li><code>[2018-01-27 13:22] Kvon:</code> added two links to guilds</li> <li><code>[2018-01-27 13:12] meleu:</code> summing up the cirellio's posts</li> </ul>"},{"location":"Achievement-Development-Overview/","title":"Achievement Development Overview","text":""},{"location":"Achievement-Development-Overview/#intro","title":"Intro","text":"<p>Page is heavily WIP, but the goal is to dive deep into achievement creation. Will probably end up merging the \"Real Examples\" into this section somehow. Each flag, type, size, comparison, etc. will have its own page to show the various ways they can be used. Will also include several tips, case studies, etc. </p>"},{"location":"Achievement-Development-Overview/#basics","title":"Basics","text":"<p>- Adding Games to the Database     - Everything you ever wanted to know (but were too scared to ask) about hashes     - Patch Guide   - RAM digging     - Utilizing Game Genie, Game Shark, Codebreaker, Action Replay, etc. codes    - Code Notes     - Formatting conventions</p>"},{"location":"Achievement-Development-Overview/#achievement-editor","title":"Achievement Editor","text":"<p>There are several tools and options available to a developer. Knowing how to properly utilize them will improve the quality of your sets. These tools/options can be used in the Achievement Editor:</p> <p></p>"},{"location":"Achievement-Development-Overview/#flags","title":"Flags","text":"<ul> <li><code>PauseIf</code> Flag     - <code>PauseIf</code> with hit counts</li> </ul> <ul> <li><code>ResetIf</code> Flag     - <code>ResetIf</code> with hit counts</li> </ul> <ul> <li><code>ResetNextIf</code> Flag</li> </ul> <ul> <li><code>AddSource</code> Flag</li> </ul> <ul> <li><code>SubSource</code> Flag     - Checking for a negative result</li> </ul> <ul> <li><code>AddHits</code> and <code>SubHits</code> Flag</li> </ul> <ul> <li><code>AddAddress</code> Flag</li> </ul> <ul> <li><code>AndNext</code> and <code>OrNext</code> Flags</li> </ul> <ul> <li><code>Measured</code> and <code>MeasuredIf</code> Flags</li> </ul> <ul> <li><code>Trigger</code> Flag</li> </ul>"},{"location":"Achievement-Development-Overview/#types","title":"Types","text":"<p>- Mem   - Value   - Delta     - <code>Mem &gt; Delta</code> Comparisons   - Prior   - BCD   - Float</p>"},{"location":"Achievement-Development-Overview/#sizes","title":"Sizes","text":"<p>- bit0 - bit7   - 8-Bit   - 16-Bit   - 24-Bit   - 32-Bit   - Lower4 and Upper4   - 16-Bit BE   - 24-Bit BE   - 32-Bit BE   - BitCount   - Float   - MBF32</p>"},{"location":"Achievement-Development-Overview/#general-comparisons","title":"General Comparisons","text":"<p>- <code>=</code>   - <code>&lt;</code>   - <code>&lt;=</code>   - <code>&gt;</code>   - <code>&gt;=</code>   - <code>!=</code></p>"},{"location":"Achievement-Development-Overview/#flag-specific-comparisons","title":"Flag Specific Comparisons","text":"<p>- <code>*</code>   - <code>/</code>   - <code>&amp;</code></p>"},{"location":"Achievement-Development-Overview/#other-toolkit-features","title":"Other Toolkit Features","text":"<p>- Hit Counts     - Using with Reset If     - Using with Pause If   - Alt Groups</p>"},{"location":"Achievement-Development-Overview/#protections","title":"Protections","text":"<p>- Demo Protection     - Finding and testing demo addresses   - Save Protection     - Delta and Prior     - Using in-game timers     - Using event flags   - Password Protection   - Cheat Protection   - Multiplayer Protection   - Other     - Dipswitch     - BIOS (PlayStation and Saturn)</p>"},{"location":"Achievement-Development-Overview/#logic-tips-and-tricks","title":"Logic Tips and Tricks","text":"<p>- Checkpoints hits   - Pause Locks   - Using Hit Counts as a timer   - Using Delta Values and Hit Counts to Detect an Increment   - Circumvent the Problem of a Counter Incrementing Twice in the Same Frame     - <code>note: need to add something about how the toolkit still uses hex even if the value is in BCD</code>   - Various types of chains   - When to use Reset If or Pause If   - When to use Delta or Prior   - Using BitCount for collectables   - Using Add Source with <code>Mem / Mem</code> comparisons   - Creating a Timer with Reset If hits based on the speed of the game   - Using <code>bit0</code> to include or exclude odd-numbered values</p>"},{"location":"Achievement-Development-Overview/#lesser-known-features","title":"Lesser-Known Features","text":"<p>- Double-Clicking bitflags while in 8-bit view   - Right-Clicking addresses in the editor to jump to them in the Memory Inspector (also works with offsets to jump to the current address)   - Highlighting conditions and holding CTRL while clicking to change a field in multiple conditions at once</p>"},{"location":"Achievement-Development-Overview/#workflow-tips","title":"Workflow Tips","text":"<p>- Using Google Sheets and Notepad++   - Editing local file</p>"},{"location":"Achievement-Development-Overview/#things-to-avoid-and-why","title":"Things to Avoid and Why","text":"<p>- Redundant Reset Ifs   - Single-Condition achievements   - Text-Based addresses</p>"},{"location":"Achievement-Development-Overview/#see-also","title":"See Also","text":"<p>- Point Distribution   - Badge Creation   - Rich Presence   - Leaderboards   - RATools   - Making Tutorial Videos   - Syntax Table</p>"},{"location":"Achievement-Development-Overview/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-02 20:08] televandalist:</code> Updated Achievement Development Tutorials (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features-es/","title":"Intro","text":"<p>Estas son algunas severas herramientas y opciones disponibles para el desarrollador. Saber como utilizarlas apropiadamente mejorara la calidad en tus sets. Estas herramientas/opciones pueden ser utilizadas en el Editor de Logros (Achievement Editor):</p> <p></p> <p>Para mas ayuda relacionada con esto, nuestro servidor de Discord esta siempre abierto para ayuda.</p> <p>Aqui hay una lista de funciones disponibles:</p> <ul> <li>Hit Counts (contador de golpes)</li> </ul> <ul> <li>Valores Delta</li> </ul> <ul> <li>Bandera <code>ResetIf</code>     - <code>ResetIf</code> con hit counts (contador de golpes)</li> </ul> <ul> <li>Bandera <code>PauseIf</code>     - <code>PauseIf</code> con hit counts (contador de golpes)</li> </ul> <ul> <li>Bandera  <code>AddSource</code></li> </ul> <ul> <li>Bandera <code>SubSource</code>     - Buscando un resultado negativo</li> </ul> <ul> <li>Bandera <code>AddHits</code></li> </ul> <ul> <li>Combinando Banderas</li> </ul> <ul> <li>Alt Groups (Grupos Alternos)</li> </ul> <ul> <li>Versiones Minimas para Funciones de Logica</li> </ul>"},{"location":"Achievement-Logic-Features-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:30] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Achievement Logic Features ES (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features-pt_BR/","title":"Recursos de l\u00f3gica para achievements","text":"<p>Link para o texto em ingl\u00eas: Achievement Logic Features</p> <p>Existem v\u00e1rias ferramentas e op\u00e7\u00f5es dispon\u00edveis para o desenvolvedor, saber como utiliz\u00e1-las adequadamente melhorar\u00e1 a qualidade de seus sets. Essas ferramentas/op\u00e7\u00f5es podem ser usadas no Achievement Editor:</p> <p></p> <p>Para ajuda sobre esses, o nosso servidor do Discord estar\u00e1 sempre aberto para ajudar.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#valores-delta","title":"Valores Delta","text":"<p>Um valor <code>Delta</code> \u00e9 o valor do frame anterior.</p> <p>Exemplos de como ele pode ser usado:</p> <ul> <li>Detectar se o n\u00edvel foi aumentado: <code>level &gt; delta level</code>. Significa que \"o n\u00edvel atual \u00e9 maior que o n\u00edvel do frame anterior\".</li> <li>Detectar danos: <code>health &lt; delta health</code>. Significa que \"a sa\u00fade atual \u00e9 menor do que a sa\u00fade do frame anterior\". Ou voc\u00ea pode apenas tornar o valor do frame anterior um requisito. <code>delta health = 1</code> significa que \"o valor do frame anterior para a sa\u00fade deve ser 1\". Voc\u00ea pode ver como isso funciona no Exemplos Reais</li> </ul>"},{"location":"Achievement-Logic-Features-pt_BR/#hit-counts","title":"Hit Counts","text":"<p>No Achievement Editor, o campo do lado direito \u00e9 Hit Count.</p> <p>Zero \u00e9 o valor padr\u00e3o. Isso significa que a condi\u00e7\u00e3o deve ser verdadeira quando a conquista aparecer.</p> <p>Se voc\u00ea definir manualmente uma contagem (hit), por exemplo 1, significa que a condi\u00e7\u00e3o deve ser verdadeira por pelo menos 1 frame e, uma vez que a contagem de hits seja atendida, ela n\u00e3o precisa ser atendida novamente em outro momento.</p> <p>ATEN\u00c7\u00c3O: se uma condi\u00e7\u00e3o tiver uma contagem de hits e atingir o n\u00famero necess\u00e1rio, esta condi\u00e7\u00e3o n\u00e3o \u00e9 mais testada. Ela \u00e9 verdadeira e permanece verdadeira, A MENOS que voc\u00ea tenha um <code>Reset If</code>, o qual discutiremos abaixo.</p> <p>Voc\u00ea pode ver como isso funciona no Exemplos Reais</p>"},{"location":"Achievement-Logic-Features-pt_BR/#special-flags","title":"Special Flags","text":"<p>No Achievement Editor, \u00e9 o campo intitulado como Special?.</p> <p>Essas flags condicionais s\u00f3 funcionam se voc\u00ea definir uma contagem de hits para uma condi\u00e7\u00e3o.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#pauseif","title":"<code>PauseIf</code>","text":"<p>Isso pausar\u00e1 a atividade para todas as condi\u00e7\u00f5es no mesmo grupo.</p> <p>Nota: tenha em mente que isso n\u00e3o ir\u00e1 pausar as condi\u00e7\u00f5es em outros grupos.</p> <p>O <code>PauseIf</code> \u00e9 usado para pausar a contagem de hits em uma situa\u00e7\u00e3o espec\u00edfica (como pausar o jogo). \u00c9 usado quando voc\u00ea deseja manter a contagem de hits previamente conquistada, mas n\u00e3o deseja reinici\u00e1-la quando algu\u00e9m simplesmente faz uma pausa no jogo, por exemplo.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#resetif","title":"<code>ResetIf</code>","text":"<p>Isso ir\u00e1 zerar a contagem de hits para todas condi\u00e7\u00f5es em que voc\u00ea definiu uma contagem de hits. Ele \u00e9 muito mais comum de usar do que <code>PauseIf</code></p> <p>Nota: Ao contr\u00e1rio do <code>PauseIf</code>, le ir\u00e1 zerar as condi\u00e7\u00f5es em todos os grupos</p> <p>Voc\u00ea pode ver como isso funciona no Real Examples</p>"},{"location":"Achievement-Logic-Features-pt_BR/#add-source","title":"<code>Add Source</code>","text":"<p>Quando uma condi\u00e7\u00e3o tem a flag <code>Add Source</code> o valor daquele endere\u00e7o de mem\u00f3ria \u00e9 adicionado ao valor do endere\u00e7o na condi\u00e7\u00e3o logo abaixo, e a compara\u00e7\u00e3o \u00e9 feita na condi\u00e7\u00e3o abaixo daquela com o <code>Add Source</code>. Isso pode soar um pouco confuso, mas o exemplo a seguir vai esclarecer como funciona:</p> <p></p> <p>Neste exemplo o valor em <code>0x8010</code> ser\u00e1 adicionado ao valor em <code>0x8020</code> e a compara\u00e7\u00e3o \u00e9 se esta soma \u00e9 maior ou igual a zero.</p> <p>Se o valor em <code>0x8010</code> \u00e9 <code>1</code> e o valor em <code>0x8020</code> \u00e9 <code>2</code>, a compara\u00e7\u00e3o ser\u00e1 <code>1 + 2 &gt; 0</code>, ou <code>3 &gt; 0</code>.</p> <p>Nota: todos os campos de compara\u00e7\u00e3o na condi\u00e7\u00e3o com a flag <code>Add Source</code> s\u00e3o ignorados.</p> <p>Tentando resumir esta explica\u00e7\u00e3o com uma imagem:</p> <p></p> <p>Nota: voc\u00ea pode usar <code>Add Source</code> para somar mais endere\u00e7os, como no exempo abaixo:</p> <p></p>"},{"location":"Achievement-Logic-Features-pt_BR/#sub-source","title":"<code>Sub Source</code>","text":"<p>Funciona muito semelhante ao <code>Add Source</code>, por\u00e9m o <code>Sub Source</code> faz o valor naquele endere\u00e7o de mem\u00f3ria ser negativo.</p> <p>Nota 1: <code>Sub Source</code> N\u00c3O \u00e9 um flag de subtra\u00e7\u00e3o. Ele apenas torna o valor negativo.</p> <p>Nota 2: A linha final (sem <code>Add Source</code> ou <code>Sub Source</code>) ainda \u00e9 adicionada para a compara\u00e7\u00e3o final.</p> <p>Usando aquele exemplo de uso de <code>Add Source</code> example, se n\u00f3s o substitu\u00edssemos por <code>Sub Source</code> e com os mesmos valores (<code>valor(0x8010) = 1</code> e <code>valor(0x8020) = 2</code>), a compara\u00e7\u00e3o seria <code>-1 + 2 &gt; 0</code>, or <code>1 &gt; 0</code>.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#add-hits","title":"<code>Add Hits</code>","text":"<p>Tamb\u00e9m funciona de maneira de similar ao <code>Add Source</code>, por\u00e9m relacionado aos hitcounts.</p> <p>O <code>Add Hits</code> adiciona o hitcount da condi\u00e7\u00e3o atual \u00e0 pr\u00f3xima condi\u00e7\u00e3o. O hitcount total a ser checado ser\u00e1 aquele definido na condi\u00e7\u00e3o logo ap\u00f3s a \u00faltima condi\u00e7\u00e3o com <code>Add Hits</code>. Se a condi\u00e7\u00e3o logo ap\u00f3s o \u00faltimo <code>Add Hits</code> n\u00e3o tiver um hitcount definido, todas as condi\u00e7\u00f5es com <code>Add Hits</code> ser\u00e3o ignoradas.</p> <p>Diferentemente do <code>Add Source</code>, todos os campos s\u00e3o usados numa condi\u00e7\u00e3o <code>Add Hits</code>, inclusive os campos de compara\u00e7\u00e3o. Se uma condi\u00e7\u00e3o \u00e9 verdadeira, o hitcount para esta condi\u00e7\u00e3o \u00e9 incrementada (e parar\u00e1 de incrementar se assim que o n\u00famero de hitcount definido for atingido).</p> <p>As condi\u00e7\u00f5es com <code>Add Hits</code> n\u00e3o precisam ser verdadeiras para a conquista disparar. Por\u00e9m primeira condi\u00e7\u00e3o ap\u00f3s o \u00faltimo <code>Add Hits</code>, sim, precisa ser verdadeira.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#groups","title":"Groups","text":"<p>Os achievements podem ter grupos adicionados a eles que podem atuar como requisitos alternativos para desbloquear um achievement. Estes s\u00e3o chamados de  Alt Groups.</p> <p>Uma coisa extremamente importante a notar: para uma conquista desbloquear, deve ter o Core group E pelo menos um Alt group ser verdadeiro. Se n\u00e3o houver nenhum grupo Alt presente, apenas as condi\u00e7\u00f5es do Core group's precisam ser verdadeiras.</p> <p>Dica: devido ao grupo Core sempre precisar ser verdadeiro, normalmente voc\u00ea colocaria l\u00e1 condi\u00e7\u00f5es que sejam \u00e0 todos os requisitos alternativos. No entanto, um truque que voc\u00ea pode usar para basicamente para ignorar a necessidade de um grupo Core \u00e9 dar-lhe uma condi\u00e7\u00e3o que \u00e9 sempre verdadeira, como:</p> <p><code>Mem 0x0001 = Mem 0x0001</code></p> <p>Como o grupo Core agora \u00e9 sempre verdadeiro, agora voc\u00ea pode se concentrar em diferenciar os grupos Alt.</p>"},{"location":"Achievement-Logic-Features-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-07-14 13:33] meleu:</code> melhorando explica\u00e7\u00f5es sobre AddSource/SubSource e afins</li> <li><code>[2018-07-14 13:17] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-28 19:57] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-28 19:56] meleu:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-25 11:46] KingDice001:</code> Updated Achievement Logic Features pt_BR (markdown)</li> <li><code>[2018-03-23 01:17] meleu:</code> Updated Achievement Logic Features.pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Logic-Features/","title":"Achievement Logic Features","text":"<p>There are several tools and options available to a developer. Knowing how to properly utilize them will improve the quality of your sets. These tools/options can be used in the Achievement Editor:</p> <p></p> <p>For more help regarding these, our Discord server is always open for assistance.</p> <p>Here is the list of features available:</p> <ul> <li>Hit Counts</li> </ul> <ul> <li>Delta Values</li> </ul> <ul> <li><code>ResetIf</code> Flag     - <code>ResetIf</code> with hit counts</li> </ul> <ul> <li><code>PauseIf</code> Flag     - <code>PauseIf</code> with hit counts</li> </ul> <ul> <li><code>AddSource</code> Flag</li> </ul> <ul> <li><code>SubSource</code> Flag     - Checking for a negative result</li> </ul> <ul> <li><code>AddHits</code> and <code>SubHits</code> Flag</li> </ul> <ul> <li>Combining Flags</li> </ul> <ul> <li>Alt Groups</li> </ul> <ul> <li>Minimum Required Versions for Logic Features</li> </ul>"},{"location":"Achievement-Scoring/","title":"Achievement Scoring","text":""},{"location":"Achievement-Scoring/#scoring","title":"Scoring","text":"<p>There is no set point cap. When scoring achievements match your scores to one of these 5 tiers.</p> Point Tiers Difficulty Significance (Level of Importance) 0-5 Easy Minor- Collecting a power-up- Beating a stage 10 Medium Intermediate- Beating a boss 25 Hard Major - Beating the Game 50 Very Hard Completion Level 100 \"Impossible\" Typically for Bonus Sets <p>There are other factors you should consider as well, such as achievement spread and game length.</p> <p>Scoring from set to set will never perfectly match up, but this scoring system allows the points earned to more closely match skill and effort.</p>"},{"location":"Achievement-Scoring/#factors-to-consider-while-scoring-achievements","title":"Factors to Consider While Scoring Achievements","text":""},{"location":"Achievement-Scoring/#difficulty","title":"Difficulty","text":"<p>Consider for the whole set:</p> <ul> <li>What percent of players earned the achievement?</li> <li>How hard were the achievements for you?</li> <li>What is the current score compared to others achievements?</li> <li>How much time, effort and practice does it take to learn the necessary skills to complete the achievement, game and entire set?</li> </ul>"},{"location":"Achievement-Scoring/#achievement-spread","title":"Achievement Spread","text":"<p>Imagine you had two versions of the same set, with the same difficulty:</p> <ul> <li>If the set has many similar achievements they should each be scored lower.</li> <li>If it has few they should be scored higher.</li> </ul>"},{"location":"Achievement-Scoring/#game-length","title":"Game Length","text":"<ul> <li>For long games achievements should be scored somewhat higher than short games.</li> <li>RPGs are often much longer than other genres. Game length should be a factor in scoring but is lesser than the other three.</li> <li>Examples.</li> </ul>"},{"location":"Achievement-Scoring/#rescoring","title":"Rescoring","text":"<p>Up until June 2019, RetroAchievements had a 400-point cap per set, with no restrictions on individual achievements. The set cap was removed to put less focus on set totals and more on the achievements themselves. This initiative was also meant to eliminate the misconception that a set worth 400 points is a \"complete\" set. </p> <p>As with revisions and aesthetic changes, a rescore typically requires community approval. You can find more information on rescores here.</p>"},{"location":"Achievement-Scoring/#exceptions","title":"Exceptions","text":"<p>Some games may come up as exceptions to the normal scoring tiers and will be listed here.</p> <ul> <li>Picross and Sudoku achievements fall under a special scoring category as follows based on difficulty:<ul> <li>Easy - 1 point,</li> <li>Medium - 2-3 points,</li> <li>Hard - 4-5 points</li> </ul> </li> <li>Picross 3D is an exception to this rule and is scored normally</li> <li>Further exceptions can be requested by Code Reviewers and/or Admins on a case by case basis</li> </ul>"},{"location":"Achievement-Scoring/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-29 22:14] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2023-06-02 19:21] televandalist:</code> Changed the point tiers to a table format. Got rid of the \"Significance\" section and put the info into the table.</li> <li><code>[2022-05-07 14:33] Searo:</code> Update Achievement Scoring with section noting exceptions such as picross and sudoku</li> <li><code>[2021-08-20 06:44] meleu:</code> fix markdown format (lists)</li> <li><code>[2020-03-23 06:37] televandalist:</code> Removed most info regarding rescores and redirected to the revision page.</li> <li><code>[2019-08-08 03:19] Kvon:</code> Achievement Scoring: typo</li> <li><code>[2019-08-08 03:18] Kvon:</code> Achievement Scoring: Added details for phase four of rescoring</li> <li><code>[2019-07-11 08:44] Kvon:</code> create page</li> </ul>"},{"location":"Achievement-Set-Requirements/","title":"Achievement Set Requirements","text":""},{"location":"Achievement-Set-Requirements/#every-achievement-set-must-have","title":"Every Achievement Set MUST Have","text":"<ul> <li>All game page information filled out, and game images uploaded (if you're not a full-dev, send the images to the code-reviewers).</li> <li>Game Badges for each achievement (they don't need to be distinct from each other, just don't leave them blank).</li> <li>Content covering up to completion so long as the game can be beaten. Whether it be defeating the final boss, completing a first loop, or completing all puzzles, achievement sets that do not cover at least beating the game are deemed unfinished and therefore subject to demotion. Arcade-style games where the focus is on high scores (such as Pac-Man and Crystal Castles) are exempt from this rule.<ul> <li>Regarding compilation games, such as Intellivision Classic Games (PlayStation), it is not required for every game in the compilation to have achievements. However, those that do have achievements must adhere to the above policy.</li> </ul> </li> <li>Progression and Win Conditions marked on applicable achievements. See Progression and Win Condition Typing for full guidelines</li> <li>Protection for situations where the players can get achievements without effort, such as:<ul> <li>Demo mode;</li> <li>In-game cheat codes;</li> <li>Battery saves;</li> <li>Passwords.</li> <li>See also: Achievement Templates and Real Examples for some well known protection techniques.</li> </ul> </li> </ul>"},{"location":"Achievement-Set-Requirements/#recommended-but-not-required","title":"Recommended but Not Required","text":"<ul> <li>Basic Rich Presence (only available for full-devs).</li> <li>Leaderboards for scores and time challenges.</li> <li>Adding the Missable Type to applicable achievements, especially for RPGs and long games.     - Avoid overuse. If most of an achievement set is marked as missable, the mark becomes meaningless for that set.     - Prior to the addition of Missable-Typing, the use of <code>[m]</code> in the end of achievement's title was the standard format to mark missables. Do Not mark missable achievements in this way. Use the achievement-type system instead.</li> <li>An achievement guide. Guides can be created and posted here. </li> <li>For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</li> </ul>"},{"location":"Achievement-Set-Requirements/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-06 08:48] The Mystical One:</code> Updated Achievement Set Requirements (markdown)</li> <li><code>[2024-02-06 08:47] The Mystical One:</code> Updated to clarify that [m] should no longer be used to mark missables.</li> <li><code>[2023-11-03 08:11] The Mystical One:</code> Adds requirement to mark progression and win conditions</li> <li><code>[2023-06-05 20:54] televandalist:</code> Added the note about compilation games</li> <li><code>[2023-06-03 02:16] televandalist:</code> Updated Achievement Set Requirements (markdown)</li> <li><code>[2023-06-02 20:27] televandalist:</code> Updated WIP Achievement Set Requirements (markdown)</li> </ul>"},{"location":"Achievement-Set-Revisions-es/","title":"Revisiones en Set de Logros","text":""},{"location":"Achievement-Set-Revisions-es/#revisiones-trabajando-con-sets-con-logros-existentes","title":"Revisiones -Trabajando con Sets con logros existentes","text":"<p>Revisiones, osea trabajar en un set el cual ya cuenta con logros existentes tipicamente requiere aprovacion por la comunidad, presentando tu plan en el foro y en el canal de #revision-voting channel en Discord. No todos los cambios requieren aprovacion.</p>"},{"location":"Achievement-Set-Revisions-es/#preparando-tu-plan","title":"Preparando tu plan","text":"<p>Cualquier desarrollador que quiera revisar un set necesita:</p> <ol> <li> <p>Preparar un plan para cada uno de los siguientes puntos (cuando tu no eres el autor original)     - Adicci\u00f3n     - Eliminaci\u00f3n     - Retrabajo de Logros     - Posibilidad de cambiar las tablas de clasificaci\u00f3n     - Actualizaci\u00f3n de rich presence</p> </li> <li> <p>Resuelve los tickets abiertos de todos los logros que quedan en el set.</p> </li> <li> <p>Presenta tu plan     - Tu plan completo en el foro del juego     - En #revision-voting publica un link al post del foro</p> </li> </ol>"},{"location":"Achievement-Set-Revisions-es/#obtener-aprobacion-de-la-comunidad","title":"Obtener aprobaci\u00f3n de la comunidad","text":"<p>Cualquiera en la comunidad puede expresar sus preocupaciones u objeciones. Permitiendo tiempo para discutirlo y para el desarrollador ajustar su plan si es que as\u00ed lo decide. Si cualquier queja u objeciones son expresadas, de acuerdo al desarrollador ajustando el plan, una votaci\u00f3n se tiene que llevar acabo.</p> <p>Una vez que la discusi\u00f3n se all\u00e1 terminado, la votaci\u00f3n tiene que ser publicada por un desarrollador en el canal de #revision-voting . </p> <p>La votaci\u00f3n es aprobada/rechazada despu\u00e9s de 72 horas. Si pasa/falla por la mayor\u00eda de la gente.</p>"},{"location":"Achievement-Set-Revisions-es/#cuando-haces-una-revision","title":"Cuando haces una revisi\u00f3n","text":"<ul> <li>No hagas copias de logros existentes, o clona y elimina copias existentes. Si hay problemas con logros actuales haz las correcciones a los que ya est\u00e1n creados.</li> </ul> <ul> <li>Si estas agregando un concepto similar a uno que ya se encuentra en el set y donde es posible re-utilizar el antiguo concepto y actualizarlo en vez de hacer uno nuevo, simplemente actualiza el antiguo.</li> </ul> <p>Esto previene que los jugadores necesiten innecesariamente volver a conseguir los logros, restringe cambios que no son necesarios a sets, y preserva una buena calidad de desarrollador en tu trabajo y en tus conceptos.</p>"},{"location":"Achievement-Set-Revisions-es/#despues-de-la-aprobacion","title":"Despu\u00e9s de la Aprobaci\u00f3n","text":"<p>Si producir la revisi\u00f3n esta tomando tiempo mucho mas largo, cada dos meses (+/- 2 semanas) haz un nuevo post en la pagina del juego explicando el progreso actual de la revisi\u00f3n. No hacer esto invalida tu revisi\u00f3n; el plan de revisi\u00f3n necesitar\u00eda volver a tener una nueva aprobaci\u00f3n.</p>"},{"location":"Achievement-Set-Revisions-es/#no-se-necesita-aprobacion","title":"No se necesita aprobaci\u00f3n","text":"<ul> <li>A\u00f1adir rich presence a un juego que no cuenta con una.</li> </ul> <ul> <li>Hacer cambios a un logro donde tu eres el autor original.</li> </ul> <ul> <li>Resolver tickets o bugs en logros hechos por otros desarrolladores que cuentan con 10 o mas tickets abiertos y llevan 2 o mas meses abiertos (puedes ver sus tickets abiertos de el Administrador de Tickets (Ticket Manager)). Este desarrollador se le considera como inactivo en sus tickets. En esos caso tu solo tienes el permiso de corregir que el logro haga lo que esta en su descripci\u00f3n; no cambies la intenci\u00f3n de logro sin antes pasar por el proceso de revisi\u00f3n de arriba. Si encuentras un problema con un logro que cuenta con un desarrollador activo ya sea puedes crear un ticket  o contactarlo para que te ayude en una soluci\u00f3n.</li> </ul> <ul> <li>A\u00f1adir protecci\u00f3n contra archivos de guardado, c\u00f3digos, o passwords a logros donde el desarrollador es inactivo. (percatate de testear apropiadamente tus cambios). Si es activo, puedes crear un ticket o contactarlo para que te ayude a aplicar las mejoras.</li> </ul> <ul> <li>Haciendo cambios a la informaci\u00f3n y screenshots de la pagina del juego (pero haz un respaldo de las im\u00e1genes previas en el foro del juego. De acuerdo al icono del juego, checa el proceso de Game Icon Gauntlet)</li> </ul> <ul> <li>Actualizando badges (ten en cuenta las reglas de aqu\u00ed)</li> </ul>"},{"location":"Achievement-Set-Revisions-es/#haciendo-cambios-a-iconostrofeos-de-juegos","title":"Haciendo cambios a iconos/trofeos de juegos","text":"<p>De acuerdo a la importancia en los iconos de juegos hacer cambios a estos son tomados por votaci\u00f3n de la comunidad. Mira Game Icon Gauntlet.</p>"},{"location":"Achievement-Set-Revisions-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 14:28] eldexterr:</code> Created Achievement Set Revisions es (markdown)</li> </ul>"},{"location":"Achievement-Set-Revisions/","title":"Achievement Set Revisions","text":""},{"location":"Achievement-Set-Revisions/#revision-types","title":"Revision Types","text":"<p>Any changes to a set with existing achievements is considered a revision. They typically happens after someone present a plan in the game's forum topic and in the <code>#revision-voting</code> channel on Discord and the plan is approved by the achievement creators community.</p> <p>There are three types of revisions:</p> <ul> <li>Standard Revisions - Changes to an achievement set that affect another developer's work. These include adding achievements, removing achievements, and reworking existing achievements, and adding progression and win condition types to achievements.</li> <li>Rescores - Changes to the point value of an achievement.</li> <li>Icon-Gauntlet - Changes to a game page's icon that is awarded upon mastering a set and changes to the individual achievement badges.</li> </ul> <p>Each are assigned their own Discord role:</p> Type Role Getting the role Who can get the role Standard Revisions <code>@revision-voting</code> React with \ud83d\uddf3\ufe0f here achievement creators Rescores <code>@rescore</code> React with \ud83d\udcaf here achievement creators Icon Gauntlet <code>@icon-gauntlet</code> React with \ud83c\udfa8 here any verified discord user"},{"location":"Achievement-Set-Revisions/#standard-revisions","title":"Standard Revisions","text":"<p>Any developer wanting to revise a set need to:</p> <ol> <li> <p>Prepare a plan for each (where you're not the original author)     - Addition     - Demotion     - Achievement rework</p> </li> <li> <p>Contact each active author of the set. They may have valuable insight or resources that you can utilize to help your revision. Wait for a response (after 72 hours have passed, you may proceed without a response).     - Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</p> </li> <li> <p>Post the plan in the game's forum topic. NOTE: Be as specific as possible, but if you have only a vague plan, provide a general idea of what you want to do and don't go too far from that idea.</p> </li> <li> <p>Start a vote by posting a link to that topic in <code>#revision-voting</code>. If you're not on Discord, another developer can do it for you. Whomever creates the vote must ping <code>@revision-voting</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</p> </li> <li> <p>Address concerns: Once a revision vote is posted, the developer can address any comments, concerns, and objections the community may have to the plan.</p> </li> <li> <p>The vote is approved/rejected after 24 hours and is pass/fail by simple majority.</p> </li> </ol> <p>Note: Anonymous revision proposals - If desired, a developer can choose to propose a revision plan while remaining anonymous throughout the voting process.  Simply contact a mod or admin to request that the plan be presented on your behalf.</p>"},{"location":"Achievement-Set-Revisions/#when-making-a-revision","title":"When Making a Revision","text":"<ul> <li>Making a revision should always be done with the goal of it being the final revision, with the set fully realized upon completion of the revision.</li> </ul> <ul> <li>Avoid making a revision claim on a set after releasing it 'just in case' you missed anything. Research the game thoroughly before release. Check online resources and consider reaching out to knowledgeable players who may know of hidden content.</li> </ul> <ul> <li>Making a revision in order to attain a higher rank on the mastery leaderboard is prohibited.</li> </ul> <ul> <li>Do not make copies of existing achievements and demote existing equivalent achievements. Doing this is a reauthor and requires permission of Developer Compliance. If there are issues with current achievements make fixes to the existing ones.</li> </ul> <ul> <li>Resolve any open tickets for achievements that will be kept in the set. Tickets for achievements that are being demoted can simply be closed with the demotion cited. In cases where the revision is simply the demotion of one or more achievements, the developer does not need to handle the tickets for other achievements in the set.</li> </ul> <ul> <li>If you are adding a similar concept to one found in the set, where possible reuse the old concept and update it rather than make a new one. This prevents players from having to unnecessarily re-earn achievements, restricts needless changes to sets, and preserves good quality developer work and concepts.</li> </ul> <ul> <li>Since revisions vary in the amount of adjusted content, they are treated the same as an achievement set reservation. If three months have passed since your revision plan was approved, you will need to provide an update that details the current progress. Not doing so will invalidate the revision and the plan will need to be approved again with a new vote.</li> </ul>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote","title":"No Need for Approval Vote","text":"<ul> <li>Making changes to an achievement or to an achievement set where you are the original author and no other developer has revised it; it is still a good idea to post the plan for your changes in the forum.</li> <li>Adding achievements where all revision authors are already authors on the set and all other active authors on the set agree.</li> <li>Resolving tickets or bugs on achievements made by developers who are listed as inactive in the list of developers. <ul> <li>Changing the description to clarify or correct it to match the logic that is already present does NOT require a revision vote</li> <li>Altering the achievement's objective in any way DOES require a revision vote as always. In these cases you're only allowed to fix the achievement to match the description; do not change the intention of the achievement without going through the revision process above. If you find a problem with an achievement that has an active developer either create a ticket or contact them to assist in resolution.</li> </ul> </li> <li>Adding battery save, cheat code, or password protections to achievements where the developer is inactive. (be sure to properly test your changes). If they are active, either create a ticket or contact them to assist applying the improvements.</li> <li>Fixing misspellings, grammatical errors, and other typos in the achievement names or descriptions. In some cases, these are intentional, so be sure to make note of it in the forum. </li> <li>Making updates to game page information and title / screenshot / box art images.</li> <li>Adding a standard \"beat the game\" achievement if one is missing and there are no active developers on the set. A standard \"beat the game\" achievement is an achievement for completing the game at its normal/default difficulty without additional requirements. Plan for adding the beat the game achievement must still be posted on the forum. If uncertain how to proceed, please contact DevCompliance</li> <li>Setting an achievement's type to Missable when it is otherwise indicated as missable in the title or description.<ul> <li>All other additions of a missable mark on a set with all inactive authors shall require a revision vote.</li> <li>The revising developer shall note the changes in the forum for the set.</li> </ul> </li> <li>Adding progression and win condition types to an inactive developer's set if the set is missing progression and win conditions<ul> <li>Make a post in the forum with the details of your change</li> <li>Any developer who changes the 'Type' of an achievement becomes responsible for the typing of that achievement and is treated as the author for purposes of type revision only.</li> </ul> </li> </ul>"},{"location":"Achievement-Set-Revisions/#not-allowed","title":"Not Allowed","text":"<ul> <li>Adding missable types to an active author's achievements without their permission. This rule shall be revisited if and when user-preference hiding of missable indicators is implemented. </li> </ul>"},{"location":"Achievement-Set-Revisions/#merging-sets","title":"Merging Sets","text":"<p>In the event that a revision includes merging two sets together (e.g. the Pokemon Red/Blue merge), the developer who does the revision needs to keep track of achievements in the demoted set and their equivalent achievements in the set it is being merged with. If the revision vote passes, this information must be sent to an admin so the achievements from the merged set can be manually awarded to the earners of the demoted set.</p>"},{"location":"Achievement-Set-Revisions/#respecting-revision-plans","title":"Respecting Revision Plans","text":"<p>If you are one of or the original set developer(s) for a set that is currently undergoing a revision, you must communicate with the developer carrying out the revision before making changes to the set. This is to prevent potential extra work for the revision, overlapping or redundant changes, etc. </p>"},{"location":"Achievement-Set-Revisions/#rescores","title":"Rescores","text":"<p>Up until June 2019, RetroAchievements sets had a cap of 400 points, with no restrictions on individual achievements. The set cap was removed to focus less on overall set totals and more on the achievements themselves. This initiative was also meant to eliminate the misconception that a set worth 400 points is a \"complete\" set, but is also an ongoing community effort to promote fairness across the board. Information on the scoring process can be found here.</p> <p>Anyone wanting to rescore a set needs to:</p> <ol> <li> <p>Prepare a rescore plan that shows the original scores and the proposed scores. A quick and easy way to do this is by utilizing this sheet; you can enter the Game ID in F2 to bring up a full list of that game's achievements and scores.</p> </li> <li> <p>Contact each active author of the set. They may have valuable insight into the chosen scores. You do not need to wait for a response.</p> </li> </ol> <ul> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul> <ol> <li> <p>Post the plan in the game's forum topic.</p> </li> <li> <p>Start a vote by posting a link to the topic in the <code>#revision-voting</code> channel on Discord. Whomever creates the vote must  ping <code>@rescore-voting</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</p> </li> <li> <p>Address concerns: Prepare to do some negotiating with other users and try to find a good middle-ground.</p> </li> <li> <p>Voting will be active for 24 hours. If a rescore passes, you can make the necessary changes.</p> </li> </ol>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote_1","title":"No Need for Approval Vote","text":"<p>Some achievement sets can be rescored without going through the voting process:</p> <ul> <li>If you are the only credited author of an achievement set being rescored and no other developer has rescored it. </li> </ul> <ul> <li>If a co-author you collaborated with on an achievement set gives you their blessing to do a rescore and no other developer has rescored it. </li> </ul>"},{"location":"Achievement-Set-Revisions/#icon-gauntlet","title":"Icon Gauntlet","text":"<p>The Icon Gauntlet is used to vote for new game icons or new badges for a set. With the vote it is checked which version is preferred by the community.</p> <p>Any user wanting to change the game icon or badges of a set need to:</p> <ol> <li>Contact each active author or claimant of the set. Wait for a response (after 72hours have passed, you may proceed without a response).</li> </ol> <ul> <li>They may have design considerations for the icon or badges to best fit the set.</li> <li>Doing this might also avoid needing a gauntlet vote if your icon or badges are preferred by them.</li> <li>Ideally Both parties should work together to come to a satisfactory proposal.</li> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of this revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul> <ol> <li> <p>Create the game icon or new badges. For more info, see Badge and Icon Creation.</p> </li> <li> <p>Upload the work on an image sharing site.</p> </li> <li> <p>Consider sharing samples of your badges or icons in <code>#gauntlet-discussion</code> prior to starting the revision vote. This will help polish any issues and avoid multiple updates to the gauntlet.</p> </li> <li> <p>Start a vote by posting links to the old icon/badges and their contenders in the <code>#icon-gauntlet</code> channel on Discord.</p> </li> </ol> <ul> <li>Whomever creates the vote must ping <code>@icon-gauntlet</code>. Ping active authors that did not respond to contact. Ping active authors that requested a ping at vote start after the contact.</li> <li>Use the a template to create the poll:        Discord Templates       \ud83d\udcca 1 vs. 1 proposal: <code>?quickpoll (game/hub page link) | Current (current icon/badges link) | Contender (contender icon/badges link)</code>        \ud83d\udcca 1 vs. 2 or 3 proposal: <code>?quickpoll (game/hub page link) | Current (current icon link) | Contender 1 (contender 1 icon link) | Contender 2 (contender 2 icon link) | Contender 3 (contender 3 icon link)</code>        Discord only embeds 4 images at maximum in a single post (current icon vs. 3 contenders), so if there's at least 5 images required (current icon vs. 4+ contenders), you'll have to do a montage with all icons:       \ud83d\udcca 1 vs. 4+ proposal: <code>?quickpoll (game/hub page link) | Current | Contender 1 | Contender 2 | Contender 3 | Contender 4 | Contender 5 | Contender 6 (single image montage link with all icons)</code> </li> </ul> <ol> <li>Voting will be active for 24 hours.</li> </ol> <ul> <li>If the voting passes, the Art Team or Gauntlet Helpers will handle replacing the images and logging the change.</li> <li>If you created a badge set, upload the badge set to <code>#icon-gauntlet-uploads</code><ul> <li>Badges should be named using numbers (1.png, 2.png, 3.png, etc) based on the order of the achievements in the set, or named using the achievement titles</li> </ul> </li> </ul> <p>Notes:</p> <ul> <li>In cases where there are several designs, the contender list can be extended. Remember to add the letter emojis, in alphabetical order, as soon as you post the proposal so people can vote by clicking on them. </li> <li>If you are not active on Discord, you may have someone else post the vote on your behalf. </li> </ul>"},{"location":"Achievement-Set-Revisions/#no-need-for-approval-vote_2","title":"No Need for Approval Vote","text":"<ol> <li> <p>The game does not have an achievement set, nor is it reserved by a developer.</p> </li> <li> <p>The entry has no game icon or badges.</p> </li> <li> <p>The new icon/badge(s) display the same content, but are of better quality.</p> </li> <li> <p>You are the existing set's sole developer and no other developer has changed the icon/badge(s).</p> </li> <li> <p>You are one of the existing set's original developers as part of a collaborative set, all parties agree to the change, and no other developer has changed the icon/badge(s).</p> </li> </ol>"},{"location":"Achievement-Set-Revisions/#voting-and-discussion","title":"Voting and Discussion","text":"<p>Revision voting is currently dev-only. While voting is exclusive to Discord, please remember that anyone can express their comments, questions, concerns, criticisms, etc. in the forum thread in which the plan was posted. The issues regarding Discord exclusivity will be addressed in a future version of the website.</p> <ul> <li>If you vote against changes in an achievement set, please state your reasoning in the discussion channel. This is so potential compromises can be made for a broader acceptance of the changes.</li> </ul> <ul> <li>Hijacking revision, rescore, or icon-gauntlet votes will not be tolerated. Votes from alt accounts will be discarded if discovered and repeated occurrences will result in the alt account being removed from the server. If the alt's primary account is confirmed, they will have their vote(s) discarded and may face suspension from future votes.</li> </ul> <ul> <li>If a revision plan that involves the demotion of achievements is proven to contain misleading or false information regarding the in-game requirements, the current proposal will be considered invalid. If evidence of this is found after a vote has already passed, the demoted achievements must be reinstated until a new vote is held.</li> </ul>"},{"location":"Achievement-Set-Revisions/#contacting-an-active-author","title":"Contacting an Active Author","text":"<ul> <li>All revision types require you to contact active authors of the set and any developer with an active claim.</li> <li>You may contact them in any manner in which you can be reasonably certain they will see it (DMs preferred)</li> <li>If you believe you may be blocked by the user, send a message to DevCompliance asking them to contact the author on your behalf. The 72hr maximum wait time will begin upon sending the message to DevCompliance. When doing so, state the user's name, type of revision, and the brief description of what your revision entails as if you were contacting the author directly.</li> <li>Some authors opt out of requiring contact. Check the Public Opt-Out Sheet. If the author is listed as opting out of the revision type, they do not need to be contacted. To update your own Opt-Out information, use this form.</li> </ul>"},{"location":"Achievement-Set-Revisions/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-02 12:33] The Mystical One:</code> Reordered the 'reauthor' clause so it's clearer.</li> <li><code>[2024-01-26 08:41] The Mystical One:</code> Added additional new revision guidelines to the 'When Making a Revision' section to clarify what is expected from a revision. Updated section on achievement clones to clearly indicate that reauthoring requires Developer Compliance Permission.</li> <li><code>[2023-12-07 14:05] The Mystical One:</code> Updated rules for missable types now that there is a missable typing.</li> <li><code>[2023-11-06 18:20] Andrew Comer:</code> Formatting updates.</li> <li><code>[2023-11-03 08:18] The Mystical One:</code> Added rules for progression and win typing to Standard Revisions</li> <li><code>[2023-08-15 10:28] The Mystical One:</code> Reduces requirements for when to ping active authors at vote start.</li> <li><code>[2023-08-01 13:47] The Mystical One:</code> Adjusted bullet list formatting.</li> <li><code>[2023-07-14 10:35] The Mystical One:</code> Fix a minor capitalization typo. Add the word 'Vote' after 'No Need for Approval' just for extra clarification.</li> <li><code>[2023-07-13 09:59] The Mystical One:</code> Added opt-out form and public sheet. Added section about contacting an active author.</li> <li><code>[2023-07-11 10:46] The Mystical One:</code> Clarify \"No Need for Approval\" for revisions that are collaborations. Add in revision rule alignment changes (contact, waiting for response, pinging authors). Add bold highlights for the main ideas of each step. Add post-vote process to icon gauntlet.</li> </ul>"},{"location":"Achievement-Templates-es/","title":"Plantillas para Logros","text":""},{"location":"Achievement-Templates-es/#precaucion-cada-juego-es-diferente","title":"PRECAUCI\u00d3N: CADA JUEGO ES DIFERENTE!","text":"<p>Aqu\u00ed encontraras varios ejemplos de varios logros t\u00edpicos. Puedes utilizarlo como una inspiraci\u00f3n para crear tu propio logro. Pero ten en mente lo siguiente:</p> <p>CADA JUEGO ES DIFERENTE! La memoria tiene un comportamiento diferente de juego en juego.</p> <p>A si que NO tomes estas plantillas como una regla. Simplemente son para motivos educativos.</p> <p>En estos ejemplos utilizamos la siguiente definici\u00f3n, 0xNIVEL es el valor en memoria que representa el ID del Nivel; 0xVIDA es el valor utilizado para la vida de nuestro personaje; 0xTIEMPO para el tiempo, 0xITEM por obtener un item, etc...</p>"},{"location":"Achievement-Templates-es/#coleccionando-un-item-n-veces","title":"Coleccionando un Item N veces","text":"<p>Abra situaciones en las que quieras otorgar un logro por coleccionar un item (como una moneda o anillo) N numero de veces. Vas a necesitar encontrar el valor en memoria responsable en contar cuantas veces tienes un item. Una vez que tengas la variable, esta l\u00f3gica usualmente hace el trabajo:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCONTADOR &gt; Delta 0xCONTADOR (N) <p>Pero es mas probable que quieras ser mas especifico, por ejemplo \"obt\u00e9n el item N veces sin morir\". Entonces tendr\u00edas que utilizar otra condici\u00f3n con un <code>ResetIf</code>, de la siguiente manera:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCONTADOR &gt; Delta 0xCONTADOR (N) 2 ResetIf 0xVIDAS &lt; Delta 0xVIDAS <p>La condici\u00f3n del <code>ResetIf</code> podr\u00eda ser \"mientras est\u00e9s en el nivel X\", \"sin utilizar una bomba\", etc.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n","title":"Termina el Nivel N","text":"<p>En este ejemplo queremos otorgar el logro cuando el jugador termino el nivel <code>N</code> y pasa al nivel <code>N+1</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO <p>Requisitos</p> <ul> <li>1: En el nivel <code>N</code> m\u00ednimo una vez</li> <li>2: Actualmente en el nivel <code>N+1</code></li> <li>3: El nivel a incrementado</li> <li>4: Resetea el contador de hit cuando se vuelva a la pantalla de titulo</li> </ul> <p>El valor 0xTITULO significa \"en la pantalla de titulo del juego\". Tu necesitas poner un <code>ResetIf</code> en la pantalla de titulo para evitar que se dispare en el momento equivocado.</p> <p>Aqui hay un ejemplo de una situacion de un juego en el que podria hacer que el logro se dispare en el momento equivocado si no estuviera el ResetIf:</p> <ol> <li>Empieza el juego y llega al nivel 2 (esto hace que el contador valla a 1)</li> <li>Obtiene un game over mientras estaba en el nivel 2</li> <li>Vuelve a la pantalla de titulo</li> <li>Utiliza una contrase\u00f1a para llegar al nivel 3</li> </ol> <p>Si no utilizamos el ResetIf tendr\u00edamos estas condiciones:</p> <ol> <li>Hit nivel 2: VERDADERO</li> <li>Nivel actual = nivel 3: VERDADERO</li> <li>Nivel incrementado (de pantalla de titulo/passwords a nivel 3): VERDADERO</li> </ol> <p>Y seria lo suficiente para que el logro se dispare (en un momento equivocado). Por eso estamos utilizando el ResetIf en este ejemplo.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-antes-de-que-el-tiempo-llegue-a-t","title":"Termina el Nivel N antes de que el tiempo llegue a T","text":"<p>En este ejemplo vamos a considerar un juego en el que el tiempo decrementa  (ej.: Super Mario Bros). Adapta el logro de acuerdo al comportamiento del tiempo de tu juego.</p> <p>Queremos premiar el logro si el jugador termina el nivel <code>N</code> mientras el tiempo es mayor que <code>T</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xTIEMPO &gt;= Value T <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que la plantilla Termina el Nivel N.</p> <ul> <li>5: el contador es mas grande que <code>T</code>.</li> </ul> <p>Ten en cuenta que mas all\u00e1 de saber como funciona el contador en tu juego tambi\u00e9n necesitas saber como se maneja en la memoria del juego.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-sin-morir-o-sin-que-te-peguen-usar-un-arma-etc","title":"Termina el Nivel N sin Morir (o sin que te peguen, usar un arma, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xPANTALLA = Value NVL_N_INTRO (1) 6 ResetIf 0xVIDA &lt; Delta 0xVIDA <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que los de la plantilla Termina el Nivel N.</p> <ul> <li>5: un checkpoint para representar el punto donde el jugador se supone que empieza el reto sin perder una vida. Si el nivel tiene una pantalla de intro por nivel, este puede ser un buen checkpoint.</li> <li>6: se resetea el hit count si la vida se decrementa.</li> </ul> <p>El requisito 6 tambi\u00e9n puede ser utilizado para resetear el si se utiliza un arma, se recibe da\u00f1o, o cualquier otra cosa que NO quieras que el jugador haga.</p>"},{"location":"Achievement-Templates-es/#termina-el-nivel-n-con-un-item","title":"Termina el Nivel N con un Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xITEM = Value VERDADERO <p>Requisitos</p> <p>Los Requisitos 1-4 son los mismos que los de la plantilla Termina el Nivel N.</p> <ul> <li>5: el jugador tiene un item</li> </ul>"},{"location":"Achievement-Templates-es/#colecciona-un-item-en-un-nivel-en-especifico","title":"Colecciona un item en un nivel en especifico","text":"<p>Esta plantilla es para salvados de bater\u00eda o protecci\u00f3n contra passwords para items. Evita premiar \"obten x item\" cargando cuando el jugador ya cuenta con ese item. Checa que el item se obtenga en nivel/habitacion donde se supone que tenga que ser obtenido, y solo lo premia cuando se hace de esa manera.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSO (1) 2 0xITEM = Value VERDADERO 3 ResetIf 0xNIVEL != Value nivel donde se colecciona <p>Requisitos</p> <ul> <li>1: No tener el item cuando se entra al nivel en el que se obtiene, el hit es un checkpoint asi que 1&amp;2 pueden ser verdaderos al mismo tiempo.</li> <li>2: Tener el item</li> <li>3: Resetea el hit counter si se esta en un nivel diferente del cual se obtiene el item</li> </ul> <p>Los Requisitos 1 y 3 juntos significan \"llego al ID de nivel/habitacion sin el item\".</p> <p>Incluso si el jugador carga un estado de guardado y va al nivel requerido el no seria capaz de a\u00f1adir hits a la condici\u00f3n 1, ya que no se pueden conseguir solamente por gameplay normal.  </p> <p>No necesita ser necesariamente un ID de nivel/habitaci\u00f3n. Hay otros m\u00e9todo para enfrentar este problema, por ejemplo ejemplo un valor en memoria \u00fanico que solo ocurre cuando lo coleccionas. Etc.</p>"},{"location":"Achievement-Templates-es/#colecciona-100-en-algo","title":"Colecciona 100% en algo","text":"<p>Esta es proteccion limitada de salvado de bateria /proteccion de password cuando el jugador coleccione 100% de algo como pasar cada stage en Super Mario world, u obtener 100% en el porcentaje de coleccionables en Super Metroid. Es necesario que el jugador no pueda simplemente cargar un save con 100% y obtener el logro de a gratis. (Como siempre hay otras maneras de enfrentar este problema tambi\u00e9n.)</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xPorcentajeColeccionado &lt; Value valor 100% 2 Mem 0xPorcentajeColeccionado = Value valor 100% 3 PauseIf Mem 0xEstadoJugador != Value Modo especifico/punto donde % es incrementado <p>Usar la variable y el valor indicado en la condici\u00f3n 3 es especialmente importante. Necesitas encontrar una variable que represente un momento \u00fanico en el juego cuando este porcentaje aumenta. Tu no quieres que el logro salte cuando el jugador cargue su archivo de guardado, que quiere decir que el logro tiene que ser pausado en ese momento.</p> <p>Ejemplo: En Super Mario World este cambio pasa cuando el jugador observa el mapa del mundo despu\u00e9s de a ver completado un stage.</p> <p>Nota: Este comportamiento es similar y el resultado a Colecciona un item en un nivel en especifico.</p>"},{"location":"Achievement-Templates-es/#evitando-el-problema-de-que-un-contador-se-incremente-dos-veces-en-el-mismo-frame","title":"Evitando el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame","text":"<p>En Coleccionando un item N veces estamos contando que tantas veces este contador aumenta. Pero en algunos juegos hay algunas situaciones en el que el contador aumenta al doble en el mismo frame, y el hit counter se incremente solo por uno. Este comportamiento, obviamente, arruina nuestra l\u00f3gica. Vamos a ver una manera para evitar este problema.</p> <p>La t\u00e9cnica utilizada aqu\u00ed se baza en otras dos:</p> <ul> <li>Utilizando SubSource para Contar Incrementos Especificos</li> <li>Bandera <code>AddHits</code></li> </ul> <p>Aqu\u00ed esta el truco:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 SubSource Delta 0xCONTADOR 2 AddHits Mem 0xCONTADOR = Value 0x02 3 Mem 0xCONTADOR &gt; Delta 0xCONTADOR (N) 4 ResetIf Mem 0xVIDAS &lt; Delta 0xVIDAS <p>Podr\u00eda verse un poco confuso a primera vista, pero talvez utilizando un ejemplo de verdad pueda ser todo mas claro. Checa Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame.</p>"},{"location":"Achievement-Templates-es/#checar-el-cambio-de-un-valor-especifico-a-otro-valor-especifico-diez-veces","title":"Checar el cambio de un valor especifico a otro valor especifico diez veces","text":"<p>En este ejemplo queremos detectar que un valor cambie de <code>V1</code> a <code>V2</code> diez veces:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xADDRESS = Value 0xV1 (10) 2 Mem 0xADDRESS = Value 0xV2 (10) 3 PauseIf Mem 0xADDRESS = Delta 0xADDRESS <p>Requisitos</p> <ul> <li>1: Si el valor en <code>0xADDRESS</code> en el frame anterior es <code>0xV1</code>, aumenta el hitcount (hasta  10).</li> <li>2: Si el valor en <code>0xADDRESS</code> es igual a <code>0xV1</code>, aumenta el hitcount (hasta 10).</li> <li>3: No aumente los hitcounts en 1 y 2 si cambian en <code>0xADDRESS</code>.</li> </ul>"},{"location":"Achievement-Templates-es/#resets-condicionales","title":"Resets Condicionales","text":"<p>Resets Condicionales se pueden utilizar para muchas cosas.</p> <p>Digamos que quieres tener un reset si el jugador entra a cierta zona X e Y del nivel:</p> <p>CORE </p> <ul> <li>En el Core ira cualquier condiciones que necesites para que el logro sea verdadero. Tambien puede contener un Reset   con comportamiento normal.</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xNIVEL = Value NIVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONE 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONE 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONE 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONE <ul> <li>El reset solo va a pasar si todas las condiciones Pauseif no son verdaderas.</li> <li>El pause es local en el alt pero el reset resetea todo el logro.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Cualquier condici\u00f3n que sea verdadera. (para satisfacer el comportamiento de un alt teniendo una condici\u00f3n que siempre es verdadera es necesaria)</li> </ul> <ul> <li>Nota: Puedes utilizar m\u00faltiples resets condicionales, cada uno en su propio alt group para tener un control mas grande del comportamiento de los reseteos.</li> </ul>"},{"location":"Achievement-Templates-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 19:57] meleu:</code> fix broken link</li> <li><code>[2019-04-16 11:16] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Achievement-Templates-pt_BR/","title":"Modelos de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Achievement Templates</p>"},{"location":"Achievement-Templates-pt_BR/#atencao-todo-jogo-e-diferente","title":"ATEN\u00c7\u00c3O: TODO JOGO \u00c9 DIFERENTE!","text":"<p>Aqui voc\u00ea ir\u00e1 ver exemplos de algumas conquistas tip\u00edcas. Voc\u00ea pode usar elas como inspira\u00e7\u00e3o para criar suas conquistas. Mas mantenha em mente o seguinte:</p> <p>TODO O JOGO \u00c9 DIFERENTE! A mem\u00f3ria tem uma diferen\u00e7a de comportamento de jogo para jogo.</p> <p>Ent\u00e3o N\u00c3O fa\u00e7a desses exemplos como regras. Elas est\u00e3o aqui apenas para fins educacionais.</p> <p>Nesses exemplos n\u00f3s usamos a seguinte conven\u00e7\u00e3o  0xNIVEL \u00e9 o endere\u00e7o de mem\u00f3ria (memory address) com o ID de n\u00edvel; 0xVIDA \u00e9 o endere\u00e7o usado para a vida do personagem; 0xTEMPO para obter um item, etc...</p>"},{"location":"Achievement-Templates-pt_BR/#termine-nivel-n","title":"Termine N\u00edvel N","text":"<p>Neste exemplo n\u00f3s queremos premiar quando o jogador terminar o n\u00edvel <code>N</code> e v\u00e1 para o n\u00edvel <code>N+1</code></p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO <p>Requerimentos</p> <ul> <li>1: No n\u00edvel <code>N</code> pelo menos uma vez</li> <li>2: Atualmente no n\u00edvel <code>N+1</code></li> <li>3: O n\u00edvel foi aumentado</li> <li>4: Resete o contador de hits quando voltar para a tela de titulo</li> </ul> <p>O valor 0xTITULO significa \"na tela de t\u00edtulo do jogo\". Voc\u00ea precisa do <code>ResetIf</code> indo para a tela de t\u00edtulo para evitar uma premia\u00e7\u00e3o na hora errada</p> <p>Aqui est\u00e1 um exemplo do fluxo de jogo que poderia fazer a conquista ser ativada em uma hora errada se n\u00e3o fosse pelo ResetIf:</p> <ol> <li>Inicie o jogo e chegue ao n\u00edvel 2 (isso far\u00e1 o contador de hits ir para 1)</li> <li>Obtenha um game over enquanto estiver no n\u00edvel 2</li> <li>Volte para a tela de t\u00edtulo</li> <li>Use um password para o n\u00edvel 3</li> </ol> <p>Se n\u00e3o estiver usando o ResetIf, teremos estas condi\u00e7\u00f5es:</p> <ol> <li>N\u00edvel de Hit 2: VERDADEIRO</li> <li>N\u00edvel Atual = n\u00edvel 3: VERDADEIRO</li> <li>N\u00edvel aumentado (Do titulo/tela de password para o n\u00edvel 3): VERDADEIRO</li> </ol> <p>E seria o suficiente para ativar a conquista (no momento errado). \u00c9 por isso que nos estamos usando o <code>ResetIf</code> neste exemplo</p>"},{"location":"Achievement-Templates-pt_BR/#termine-nivel-n-antes-que-o-tempo-atinja-t","title":"Termine N\u00edvel N antes que o Tempo atinja T","text":"<p>Neste exemplo vamos considerar um jogo quando o tempo diminuir (ex: Super Mario Bros). Adaptar-lo de acordo com o tempo no seu jogo tem um comportamento diferente.</p> <p>N\u00f3s queremos premiar se o jogardor finalizar o n\u00edvel <code>N</code> enquanto o tempo for maior que <code>T</code></p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xNIVEL &gt;= Value T <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: O tempo \u00e9 maior que <code>T</code>.</li> </ul> <p>Mantenha em mente que por tr\u00e1s de al\u00e9m saber como o tempo se comporta no jogo, al\u00e9m disso voc\u00ea precisa pesqusar como se comporta na mem\u00f3ria</p>"},{"location":"Achievement-Templates-pt_BR/#terminar-nivel-n-sem-morrer-ou-ser-atingido-usando-uma-arma-etc","title":"Terminar N\u00edvel N sem Morrer (ou ser atingido, usando uma arma, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITLE 5 0xTELA = Value NVL_CM_INTRO (1) 6 ResetIf 0xVIDA &lt; Delta 0xVIDA <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: um checkpoint para representar o ponto de onde o jogador supostamente iniciar\u00e1 o desafio de n\u00e3o perder uma vida. Se o jogo tem um n\u00edvel na tela de introdu\u00e7\u00e3o, isto pode ser um bom checkpoint.</li> <li>6: resete o contador de hits se a vida diminuir.</li> </ul> <p>O requerimento 6 pode tamb\u00e9m ser usando para resetar o contador de hits se uma arma for usada, tomado dano, ou qualquer coisa al\u00e9m daquilo que voc\u00ea n\u00e3o quer que o jogador fa\u00e7a</p>"},{"location":"Achievement-Templates-pt_BR/#termine-o-nivel-n-com-item","title":"Termine o N\u00edvel N com Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xNIVEL = Value N (1) 2 0xNIVEL = Value N+1 3 0xNIVEL &gt; Delta 0xNIVEL 4 ResetIf 0xNIVEL = Value TITULO 5 0xITEM = Value VERDADEIRO <p>Requerimentos</p> <p>Requerimentos 1-4 s\u00e3o os mesmos como o modelo Terminar o N\u00edvel N.</p> <ul> <li>5: o jogador tem o item</li> </ul>"},{"location":"Achievement-Templates-pt_BR/#colete-o-item-em-um-nivel-especifico","title":"Colete o Item em um n\u00edvel espec\u00edfico","text":"<p>Aqui est\u00e1 uma forma de checar se o item foi coletado em um n\u00edvel/sala que deve ser coletado. Isto evita a premia\u00e7\u00e3o \u00e0 \"consiga item X\" por carregando um savestate onde o jogador j\u00e1 tem o item.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSO (1) 2 0xITEM = Value VERDADEIRO 3 ResetIf 0xNIVEL != Value nivl de coleta <p>Requerimentos</p> <ul> <li>1: N\u00e3o tenha o item quando entrou no n\u00edvel de coleta, o hit \u00e9 um checkpoint ent\u00e3o o 1&amp;2 podem ser verdadeiro ao mesmo tempo</li> <li>2: Tenha o item</li> <li>3: Reseta o contador de hits se estiver em uma fase diferente daquela que o item deve ser obtido</li> </ul> <p>Requerimentos 1 e 3 juntos significa \"chegou ao n\u00edvel/sala sem o item\"</p> <p>Mesmo se o jogador carregar um savestave e for para o n\u00edvel requerido eles n\u00e3o poder\u00e3o adicionar hits para a condi\u00e7\u00e3o 1, portanto eles n\u00e3o podem conseguir exceto em gameplay normal</p> <p>N\u00e3o precisa ser necessariamente n\u00edvel/sala. H\u00e1 outras maneiras de abordar esse problema, por exemplo uma \u00fanica Mem\u00f3ria/Valor que apenas ocorre na coletagem. Etc</p>"},{"location":"Achievement-Templates-pt_BR/#cheque-por-um-valor-especifico-mudando-para-outro-valor-especifico-dez-vezes","title":"Cheque por um valor espec\u00edfico mudando para outro valor espec\u00edfico dez vezes","text":"<p>Neste exemplo n\u00f3s queremos para detectar uma mudan\u00e7a de valor de <code>V1</code> para <code>V2</code> dez vezes:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Mem 0xENDERE\u00c7O = Value 0xV1 (10) 2 Delta 0xENDERE\u00c7O = Value 0xV2 (10) 3 PauseIf Mem 0xENDERE\u00c7O = Delta 0xENDERE\u00c7O"},{"location":"Achievement-Templates-pt_BR/#resets-condicionais","title":"Resets Condicionais","text":"<p>Resets Condicionais podem ser usado para muitas coisas.</p> <p>Vamos dizer que voc\u00ea quer para resetar se um jogador entrar ema certa zona X e Y de um n\u00edvel:</p> <p>CORE </p> <ul> <li>O Core \u00e9 qualquer condi\u00e7\u00e3o que voce precisa para a sua conquista ser verdadeira. Isto pode tambem incluir comportamentos normais de resets</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xNIVEL = Value NIVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONA 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONA 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONA 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONA <ul> <li>O reset ir\u00e1 acontecer apenas se todas as condi\u00e7\u00f5es Pauseif n\u00e3o forem verdadeiras.</li> <li>O pause \u00e9 local para o alt mas o reset reseta a conquista inteira.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Qualquer condi\u00e7\u00e3o que seja sempre verdadeira (isso \u00e9 necess\u00e1rio para que o Alt1 tenha o comportamento que desejamos)</li> </ul> <ul> <li>Nota: Voc\u00ea pode usar multiplos resets condicionais, cada um em seu pr\u00f3prio grupo alt para ter um controle muito maior do comportamento de reset. </li> </ul>"},{"location":"Achievement-Templates-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:07] KingDice001:</code> Updated Achievement Templates pt_BR (markdown)</li> <li><code>[2018-03-25 11:51] KingDice001:</code> Updated Achievement Templates pt_BR (markdown)</li> <li><code>[2018-03-24 04:22] KingDice001:</code> Created Achievement Templates pt_BR (markdown)</li> </ul>"},{"location":"Achievement-Templates/","title":"Achievement Templates","text":""},{"location":"Achievement-Templates/#warning-every-game-is-different","title":"WARNING: EVERY GAME IS DIFFERENT!","text":"<p>Here you'll see examples of some typical achievements. You can use them as inspiration to create your own achievement. But keep in mind the following:</p> <p>EVERY GAME IS DIFFERENT! The memory has a different behavior from game to game.</p> <p>So do NOT take these templates as a rule. They are here just for educational purposes.</p> <p>In these examples we use the following convention 0xLEVEL is the memory address with the level ID; 0xLIFE is the address used for the character life; 0xTIME for time, 0xITEM for getting an item, etc...</p> <ul> <li>Collecing an Item N Times</li> <li>Finish Level N</li> <li>Finish Level N Before Time Reaches T</li> <li>Finish Level N without Dying (or getting hit, using a weapon, etc.)</li> <li>Finish Level N with Item</li> <li>Collect an Item in a Specific Level</li> <li>Collected 100 Percent of Something</li> <li>Circumvent the Problem of a Counter Incrementing Twice in the Same Frame</li> <li>Check for a Specific Value Changing to Another Specific Value Ten Times</li> <li>Conditional Resets</li> </ul>"},{"location":"Achievement-Templates/#collecting-an-item-n-times","title":"Collecting an Item N times","text":"<p>There are some situations where you want to award an achievement for collecting an item (like a coin or a ring) N times. You'll need to find in the memory the address responsible to count how much of the item you have. Once you have the address, this logic usually does the job:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCOUNT &gt; Delta 0xCOUNT (N) <p>But you most likely will want to be more specific, for example \"get item N times without dying\". Then you should use another condition with a <code>ResetIf</code>, like this:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCOUNT &gt; Delta 0xCOUNT (N) 2 ResetIf 0xLIVES &lt; Delta 0xLIVES <p>The <code>ResetIf</code> condition could be \"while in level X\", \"without using a bomb\", etc.</p>"},{"location":"Achievement-Templates/#finish-level-n","title":"Finish Level N","text":"<p>In this example we want to award when the player finish the level <code>N</code> and goes to level <code>N+1</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE <p>Requirements</p> <ul> <li>1: On level <code>N</code> at least one time</li> <li>2: Currently at level <code>N+1</code></li> <li>3: The level has been increased</li> <li>4: Reset the hit counter when back to title screen</li> </ul> <p>The value 0xTITLE means \"at game's title screen\". You need to <code>ResetIf</code> going to the title screen to avoid the awarding at a wrong time.</p> <p>Here is an example of game flow that could make the achievement trigger at a wrong time if it wasn't for that ResetIf:</p> <ol> <li>Start the game and reach level 2 (this make the hit counter goes to 1)</li> <li>Get a game over while on level 2</li> <li>Go back to the title screen</li> <li>Use a password for level 3</li> </ol> <p>If not using the ResetIf we will have these conditions:</p> <ol> <li>Hit level 2: TRUE</li> <li>Current level = level 3: TRUE</li> <li>Level increased (from title/password screen to level 3): TRUE</li> </ol> <p>And it would be enough to trigger the cheevo (at a wrong time). That's why we're using the <code>ResetIf</code> in this example.</p>"},{"location":"Achievement-Templates/#finish-level-n-before-time-reaches-t","title":"Finish Level N Before Time Reaches T","text":"<p>In this example we consider a game where the time decreases (e.g.: Super Mario Bros). Adapt it accordingly the time on your game has a different behavior.</p> <p>We want to award if the player finishes the level <code>N</code> while time is greater than <code>T</code>.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xTIME &gt;= Value T <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: timer is greater than <code>T</code>.</li> </ul> <p>Keep in mind that besides knowing how the time behaves in game you also need to research how it behaves in memory.</p>"},{"location":"Achievement-Templates/#finish-level-n-without-dying-or-getting-hit-using-a-weapon-etc","title":"Finish Level N without Dying (or getting hit, using a weapon, etc.)","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xSCREEN = Value LVL_N_INTRO (1) 6 ResetIf 0xLIFE &lt; Delta 0xLIFE <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: a checkpoint to represent the point from where the player is suposed to start the chalenge of not losing a life. If the game has a level intro screen, it can be a good checkpoint.</li> <li>6: reset hit count if life decreased.</li> </ul> <p>The requirement 6 can also be used to reset hit count if a weapon was used, damage taken, or anything else that you want the player to NOT do.</p>"},{"location":"Achievement-Templates/#finish-level-n-with-item","title":"Finish Level N with Item","text":"ID Special? Memory Cmp Type Mem/Val Hits 1 0xLEVEL = Value N (1) 2 0xLEVEL = Value N+1 3 0xLEVEL &gt; Delta 0xLEVEL 4 ResetIf 0xLEVEL = Value TITLE 5 0xITEM = Value TRUE <p>Requirements</p> <p>Requirements 1-4 are the same as Finish Level N template.</p> <ul> <li>5: the player have the item</li> </ul>"},{"location":"Achievement-Templates/#collect-an-item-in-a-specific-level","title":"Collect an Item In a Specific Level","text":"<p>This template is for battery save or password protection for items. It avoids awarding \"get item X\" by loading to where player already has the item. It checks that an item is collected in the level/room ID it is supposed to be collected, and only allows it be earned at that time.</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xITEM = Value FALSE (1) 2 0xITEM = Value TRUE 3 ResetIf 0xLEVEL != Value collect level <p>Requirements</p> <ul> <li>1: Do not have the item when entered the collect level, the hit is a checkpoint so 1&amp;2 can both be true at once.</li> <li>2: Have the item</li> <li>3: Reset hit counter if in a level different than the one where the item must be obtained</li> </ul> <p>Requirements 1 and 3 together mean \"arrived the level/Room ID without the item\".</p> <p>Even if the player loads a savestate and goes to the required level they will not be able to add hits to condition 1, thus they can't get it except in normal gameplay.  </p> <p>It does not necessarily have to be level/Room ID. There are other ways to approach this problem, for example a unique Mem/Val that only occurs on collection. Etc.</p>"},{"location":"Achievement-Templates/#collected-100-percent-of-something","title":"Collected 100 Percent of Something","text":"<p>This is limited battery save /password protection for when a player will collect 100% of something like clearing each stage in Super Mario world, or getting a 100% collection rate in Super Metroid. It's necessary so that a player cannot just load a save at 100% and get the achievement for free. (As usual there are other ways to approach this problem too.)</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 Delta 0xCollectPercent &lt; Value 100% value 2 Mem 0xCollectPercent = Value 100% value 3 PauseIf Mem 0xPlayerState != Value Specific mode/point in game where % is increased <p>Using the correct address value for condition 3 is especially important. You need to find an address that represents a unique time in the game where this percent increases. You'd not want the achievement to trigger when the player is loading their in game save file, which means this achievement must be paused at that time.</p> <p>Example: In Super Mario World this change happens while the player sees the world map after completing a stage.</p> <p>Note: This is similar in behavior and result to Collect an Item in a specific Level.</p>"},{"location":"Achievement-Templates/#circumvent-the-problem-of-a-counter-incrementing-twice-in-the-same-frame","title":"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame","text":"<p>In the Collecting an Item N times we are counting how many times the counter goes up. But in some games there are situations where the counter goes up twice in the same frame, and the hit counter is incremented only by one. This behavior, obviously, ruins our logic. We're going to see a way to circumvent this issue.</p> <p>The technique used here relies on two other ones:</p> <ul> <li>using <code>SubSource</code> to count specific increments</li> <li><code>AddHits</code> Flag</li> </ul> <p>Here's the trick:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 SubSource Delta 0xCOUNT 2 AddHits Mem 0xCOUNT = Value 0x02 3 Mem 0xCOUNT &gt; Delta 0xCOUNT (N) 4 ResetIf Mem 0xLIVES &lt; Delta 0xLIVES <p>It can looks a bit confusing at a first sight, but maybe using a real example it can be more clear. Check the Circumvent the Problem of a Counter Incrementing Twice in the Same Frame.</p>"},{"location":"Achievement-Templates/#check-for-a-specific-value-changing-to-another-specific-value-ten-times","title":"Check for a Specific Value Changing to Another Specific Value Ten Times","text":"<p>In this example we want to detect a value changing from <code>V1</code> to <code>V2</code> ten times:</p> ID Special? Type Memory Cmp Type Mem/Val Hits 1 AndNext Delta 0xADDRESS = Value 0xV1 2 Mem 0xADDRESS = Value 0xV2 (10) <p>Requirements</p> <ul> <li>1: If value in <code>0xADDRESS</code> in the previous frame is <code>0xV1</code></li> <li>2: AND If the current value in <code>0xADDRESS</code> is <code>0xV2</code>, increases the hitcount (up to 10).</li> </ul>"},{"location":"Achievement-Templates/#conditional-resets","title":"Conditional Resets","text":"<p>Conditional resets can be used for many things.</p> <p>Lets say you want to have a reset if a player enters a certain X and Y zone of a level:</p> <p>CORE </p> <ul> <li>The Core is whatever condition(s) you need for your achievement to be true. It can also include normal reset behavior.</li> </ul> <p>ALT1</p> ID Special? Type Memory Cmp Type Mem/Val 1 ResetIf Mem 0xLEVEL = Value LEVELID 2 PauseIf Mem 0xX-COORDS &gt; Value RESET-X-ZONE 3 PauseIf Mem 0xX-COORDS &lt; Value RESET-X-ZONE 4 PauseIf Mem 0xY-COORDS &gt; Value RESET-Y-ZONE 5 PauseIf Mem 0xY-COORDS &lt; Value RESET-Y-ZONE <ul> <li>The reset will only happen if all of the Pauseif conditions are not true.</li> <li>The pause is local to the alt but the reset resets the entire achievement.</li> </ul> <p>ALT2</p> ID Special? Type Memory Cmp Type Mem/Val 1 Mem 0x1 = Mem 0x1 <ul> <li>Any true condition. (to satisfy alt behavior having an always true alt is needed)</li> </ul> <ul> <li>Note: You can use multiple conditional resets, each one in their own alt group to have far greater control of reset behavior.</li> </ul>"},{"location":"Achievement-Templates/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:17] televandalist:</code> Added ToC</li> <li><code>[2021-05-01 07:24] meleu:</code> fix link to AddHits page</li> <li><code>[2020-09-01 09:50] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:31] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:28] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 09:23] Brandon D:</code> Updated as per feedback from Keltron</li> <li><code>[2020-09-01 09:04] Brandon D:</code> Updated Achievement Templates (markdown)</li> <li><code>[2020-09-01 08:47] Brandon D:</code> Took a real usage case from my game Dicing Knight Period and condensed it down to something more manageable. The AddHits docs are also a bit vague on some things and this hopefully will help out there.</li> <li><code>[2019-12-02 11:25] Searo:</code> Updating \"Check for a specific value changing to another specific value ten times\" to use AndNext to simplify the logic</li> <li><code>[2019-02-17 21:19] meleu:</code> add \"Collecting an Item N times\" and \"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame\"</li> </ul>"},{"location":"Achievements-for-ROM-hacks-es/","title":"Logros para ROM hacks","text":"<p>\u00bfEste hack que encontr\u00e9/Que hice puede tener un set en RetroAchievements?</p> <p>RetroAchievements abre la puerta a todos esos divertidos hacks para el disfrute de los jugadores.  Pero esto tambi\u00e9n abre el tema de \"Que es permitido, y que no esta permitido que tenga un set en RetroAchievements?\"</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-para-game-trainers","title":"Parches Para Game Trainers","text":"<p>No est\u00e1n permitidos sobre cualquier circunstancia</p> <p>Hacks que incluyan \"game trainers\" o funciones de integradas de cheats (por razones obvias) no est\u00e1n permitidos.</p>"},{"location":"Achievements-for-ROM-hacks-es/#hacks-de-dificultad-e-historia","title":"Hacks de Dificultad e Historia","text":"<p>Posiblemente Permitido</p> <p>Si un hack tiene suficiente diferencias que la versi\u00f3n licenciada del juego, tanto que incluso el juego puede ser considerado un juego completamente diferente, usualmente la creaci\u00f3n de un set es usualmente aceptable.  Consulta con un administrador para una aprobaci\u00f3n mas especifica.</p> <p>Ejemplo: Metroid - Rogue Dawn</p>"},{"location":"Achievements-for-ROM-hacks-es/#lanzamiento-beta-prototipo-correccion-de-un-bug-re-balanceo-y-hacks-para-testing","title":"Lanzamiento Beta, prototipo, correcci\u00f3n de un bug, re-balanceo, y hacks para \"testing\"","text":"<p>No est\u00e1n permitidos</p> <p>Hacks para corregir un bug, parches de balance, versiones prototipo, hacks que est\u00e1n a nivel desarrollador y que cuentan con herramientas integradas (Selecci\u00f3n de Niveles f\u00e1cil de accesar, menus de debuging, menus que muestran informaci\u00f3n o proveen funciones de prueba y que no son normalmente accesibles en el juego normal), no pueden ser agregadas a un set core, y son tipicamente no permitidas que cuenten con su propio set de logros.</p> <p>Si un rom hack esta en un estado de beta con potenciales glitches que puedan romper el juego, crasheos, o bugs, intactos siendo un resultado del hack, esto no esta permitido.</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-de-traduccion","title":"Parches de Traducci\u00f3n","text":"<p>Posiblemente Permitidos</p> <p>Ingles es el Lenguaje Primario en RetroAchievements. Parches de traducci\u00f3n son algunas veces aplicados por los desarrolladores a t\u00edtulos que no son en Ingles cuando en el MD5 principal de un set de logros no existe un versi\u00f3n licenciada en ingles. En este tipo de casos instrucciones de como parchear el juego tienen que ser agregadas al foro del juego.  Proveer una traducci\u00f3n completa a un titulo existente es posiblemente permitido para que as\u00ed un juego sea mas accesible a gente que hable otros idiomas.  Recuerda que tienes que inspeccionar profundamente la memoria del juego entre el parche y el set core y meter una solicitud de aprobaci\u00f3n antes de que esta se entregue al desarrollador del set para que la postee en el foro junto con el parche.</p> <p>Algunas veces los parches de traducci\u00f3n pueden diferir cr\u00edticamente de como trabaja la memoria de acuerdo al MD5 del desarrollador.  Antes de linkear estos parches checa con el desarrollador original o haz algunas pruebas profundas en memoria para asegurarte que sea completamente compatible. Puedes agregar parches de traducci\u00f3n que encuentres en linea siempre y cuanto todos los logros core funcionen de manera correcta y estos no se hagan mas o menos dif\u00edciles.</p>"},{"location":"Achievements-for-ROM-hacks-es/#hacks-cosmeticos-sprites","title":"Hacks Cosm\u00e9ticos / Sprites","text":"<p>Posiblemente permitidos</p> <ul> <li>Hacks Cosm\u00e9ticos / Sprites que no hacen nada mas que cambiar las gr\u00e1ficas del juego no est\u00e1n permitidos que tengan su propio set.  Tal vez sean un experiencia algo divertida pero siguen siendo el mismo juego.</li> </ul> <ul> <li>Recuerda que:  Si un rom hack tiene suficientes diferencias del juego licenciado tantas que el juego puede ser considerado como un juego completamente diferente, es usualmente aceptable.  Consulta con un administrador para una aprobaci\u00f3n mas especifica.  Un simple hack de sprites no es suficiente para que tenga su propio set entero.</li> </ul> <p>Ejemplo: Roll-chan Evolution, Episode I - Roll-chan Gaiden</p>"},{"location":"Achievements-for-ROM-hacks-es/#parches-para-sets-bonus","title":"Parches para Sets Bonus","text":"<p>Hacks Cosm\u00e9ticos que producen un MD5 \u00fanico para un Set Bonus son usualmente permitidos para que sean agregados al proceso de revisi\u00f3n.  Inclusive este tipo de parches tienen que ser testeada profundamente la memoria con el set core para asegurarte que todos los logros funcionan de manera correcta.  Esto envuelve artas ediciones a la pantalla de titulo para que pueda conseguir los requisitos de los lineamientos. Para parches cosmeticos para Sets Bonus para que permitan que el jugador pueda jugar el Set Bonus en vez del juego original, por favor habla con Salsa si necesitas ayuda en el proceso de creaci\u00f3n.  Salsa maneja la sub-comunidad de creaci\u00f3n de parches IPS para desarrollo de Sets Bonus de RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks-es/#consultando","title":"Consultando","text":"<p>Consulta a la comunidad por medio del foro y/o Discord para meter tu solicitud de aprobaci\u00f3n.  Puedes darte una buena idea de que es lo que le gusta ver a la comunidad preguntando.  Preguntar por una aprobaci\u00f3n antes de agregar un parche es una practica integra de un Desarrollador, y cae en tu c\u00f3digo de conducta como desarrollador aqu\u00ed en RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-21 11:56] eldexterr:</code> Created Achievements for ROM hacks es (markdown)</li> </ul>"},{"location":"Achievements-for-ROM-hacks/","title":"Achievements for ROM hacks","text":"<p>RetroAchievements opens the doorway to include fun hack sets for players to enjoy.  The issue arising in such a broad category open to world of creativity being \"What is allowed, and what is not allowed to have a set at RetroAchievements?\" This page will go over the various types of hacks that are not allowed to have their own set and whether or not they are allowed to be linked to a base set.</p> <ul> <li>Game Trainer Patches</li> <li>Difficulty and Story Hacks</li> <li>Bug-fix, Re-balancing and Utility Hacks</li> <li>Beta Release, Prototype and \"Testing\" Hacks</li> <li>Cosmetic Hacks</li> <li>Consultation</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#game-trainer-patches","title":"Game Trainer Patches","text":"<ul> <li>These are hacks that have integrated cheat features. For those familiar with GoodTool's naming scheme, ROMs with <code>[t1]</code>, <code>[t2]</code>, etc. in the title are examples of this.</li> <li>These are not allowed to have their own sets or be linked to base sets under any circumstance. In fact, thousands of known hashes for these are linked to dummy game entries, such as this one.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#difficulty-and-story-hacks","title":"Difficulty and Story Hacks","text":"<ul> <li>If a hack has sufficient enough differences from the base game insomuch that the hack can be considered an entirely different game, then yes, a unique set is usually acceptable. Linking these to the base set is not recommended since they will likely break the set.<ul> <li>Examples include Metroid - Rogue Dawn, Castlevania: The Holy Relics, Super Mario 64: Last Impact, and Super Metroid: Redesign.</li> </ul> </li> <li>If the hack does not have enough differences from the base game, but there are good achievement ideas exclusive to the hack, then consider doing a compilation of hacks or incorporating them into a bonus set.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#bug-fix-re-balancing-and-utility-hacks","title":"Bug-fix, Re-balancing and Utility Hacks","text":"<ul> <li>Hacks that include development-level integrated utilities such as easily accessible level select, debug menus, menus that display information or provide testing features not normally accessible via the normal game, are almost never allowed to be linked to core sets or get their own set.<ul> <li>Example: Metroid + Saving for Metroid</li> </ul> </li> <li>Hacks that offer gameplay utilities where it doesn't exist in the release version are allowed at the discretion of the active developer (or Revision vote if the developer is inactive). Utilities such as easy weapon select, in game maps, new minor upgrades or abilities, improved controls, faster movement.<ul> <li>Example: Castlevania 2: Improved Controls for Castlevania 2: Simon's Quest</li> </ul> </li> <li>Utilities and bug-fix hacks that improve or patch glitches found in the released version of games are allowed at the discretion of the active developer (or Revision vote if the developer is inactive).<ul> <li>Example: Sonic 1 Bugfix for Sonic the Hedgehog</li> <li>Example: Double Dragon III - Difficulty Fix for Double Dragon III - The Sacred Stones</li> </ul> </li> <li>Cosmetic bug fixes which don't alter gameplay might be allowed, see cosmetic/sprite hacks.</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#beta-release-prototype-and-testing-hacks","title":"Beta Release, Prototype and \"Testing\" Hacks","text":"<p>Usually not allowed</p> <p>If a rom hack is incomplete or in a beta/prototype/testing state with potential game-breaking glitches, crashes, or bugs, intact as a result of hacking, it is usually not allowed.</p> <p>Examples:</p> <ul> <li>List of abandoned incomplete hacks</li> <li>Pokemon LeafYellow Beta 1.3 for Pokemon FireRed</li> <li>Fire Emblem TSS Hack INCOMPLETE testing for Fire Emblem: The Sacred Stones</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#translation-patches","title":"Translation Patches","text":"<p>Usually allowed</p> <p>English is the Primary language of RetroAchievements. Translation Patches are sometimes applied by developers to non-English titles as the main MD5 for an achievement set where no licenced English version exists. In these cases patching instructions will be provided in the forum thread of that title.  Providing an up-to-spec translation patch for an existing title is usually allowed to make a game more accessible to other native language speakers.  You must deep-memory inspect your translation contribution against the core set and submit it for approval before handing it over to the developer of the set for posting in their thread along with the game.</p> <p>Sometimes translation patches may critically differ from the developer MD5 in memory differences that you may find online.  Before linking these patches check with the original developer or do deep memory tests to ensure total compatibility. You can link translation patches you find online to core sets as long as the game's core achievements all function correctly and do not make the game more or less difficult.</p> <p>Tip: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</p> <p>Examples:</p> <ul> <li>Bahamut Lagoon, T+Eng1.3-Copier_DeJap; Japanese to English translation for Bahumut Lagoon</li> <li>Clock Tower, T+Eng1.01_Aeon Genesis; Japanese to English translation for Clock Tower</li> <li>Chrono Trigger, T+Rus_Chief-NET; English to Russian Translation for Chrono Trigger</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#cosmetic-hacks","title":"Cosmetic Hacks","text":"<p>Usually allowed</p> <ul> <li>Cosmetic / Sprite hacks that do nothing to change the original game other than its graphics are not allowed to become their own set. They may be a little fun experience but they are still the same game. When linked they will be linked to the primary set.</li> </ul> <p>Examples:</p> <ul> <li>Castlevania - High Budget Remake for Castlevania (NES)</li> <li>Super Waluigi 64 for Super Mario 64</li> <li>Chrono Trigger MSU-1 (with FMV's) for Chrono Trigger</li> </ul>"},{"location":"Achievements-for-ROM-hacks/#consultation","title":"Consultation","text":"<p>Consult the community via the forum and Discord for review and approval.  You can get a good view-port of what the community likes to see by asking.  Asking for approval before linking is an integral Developer practice, and falls within your code of conduct as a developer here at RetroAchievements.</p>"},{"location":"Achievements-for-ROM-hacks/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-03 20:09] televandalist:</code> Updated Achievements for ROM hacks (markdown)</li> <li><code>[2023-06-05 21:43] televandalist:</code> Updated Achievements for ROM hacks (markdown)</li> <li><code>[2021-03-01 01:06] televandalist:</code> Removed section about using cosmetic patches for Bonus sets. It's not a good practice and should have been in the Bonus set guide anyway.</li> <li><code>[2020-07-06 09:53] meleu:</code> markdown fix</li> <li><code>[2020-02-17 05:32] meleu:</code> speak with BenGhazi for bonus set patches</li> <li><code>[2019-08-13 19:45] Kvon:</code> Achievements for Romhacks, text hooking tip</li> <li><code>[2019-07-22 17:14] Kvon:</code> minor edit. Changed capitalization</li> <li><code>[2019-07-22 14:38] Kvon:</code> Achievements for romhacks: Added much clarification, more examples, split out \"Beta Release...\" into is own section. Updated what might be allowed to match status quo.</li> <li><code>[2018-09-09 20:27] Kvon:</code> Listed translation patches as possibly allowed</li> <li><code>[2018-02-03 22:10] meleu:</code> changed the title</li> </ul>"},{"location":"AddAddress-Flag/","title":"AddAddress Flag","text":"<p><code>AddAddress</code> modifies the memory address(es) of the following condition by the calculated value. It works similar to <code>AddSource</code>, but modifies the address, not the resulting value. Additionally, it affects addresses on both sides of the condition.</p> <p><code>AddAddress</code> only affects the next condition. If multiple <code>AddAddress</code> lines are chained together, each lookup in the chain will be altered; the values won't all be added to the final lookup.</p> <p></p> <p>The 32-bit value at 0x0112F8 is a pointer to the data for the first character in the party. When the party order changes, the pointer will point at a different block of memory, but data within the block will have the same structure.</p> <ul> <li>The value is an address in the actual system representation and differs from the addresses provided by the memory inspector. However, you can rely on the fact that the memory inspector represents the same memory, so while the actual address may differ, the sequence of bytes does not.</li> </ul> <p>To translate the real pointer to a memory inspector address, we compare the two values. For example:</p> <ul> <li>The 32-bit value at 0x0112F8 is 0x800110B8.</li> <li>The memory we're interested in is at 0x011114 in the memory inspector.</li> <li>Using a 24-bit read instead of a 32-bit read gives us 0x0110B8</li> <li>0x011114 - 0x0110B8 = 0x00005C, so that becomes the \"base address\" in the second condition.</li> </ul>"},{"location":"AddAddress-Flag/#types-of-pointers","title":"Types of Pointers","text":"<p><code>AddAddress</code> is how RAIntegration handles pointers. There are four major types of pointer support:</p> <p>Direct Pointer: The pointer contains another address that is referenced without modification. These are most commonly used for string pointers. To use a direct pointer, the base address to which the pointer is added would be 0.</p> <p>Indirect Pointer: The pointer contains another address that indicates the start of some block of data. The data of interest is a fixed number of bytes into the block of data. These are commonly used for attributes of a character/object.</p> <p>For both Direct and Indirect Pointers, the <code>AddAddress</code> line should reference the pointer, and the address in the following line should be the offset into the block of data for the information relevant to the condition. While you would typically use 0 for a Direct Pointers, the following line would also contain any value necessary to convert between a real address and a memory inspector address.</p> <p>The example above is an Indirect Pointer, where the data is 0x5C bytes into a block of data. The conversion from a real address to a memory inspector address is handled by using a 24-bit read instead of a 32-bit read.</p> <p>Array Index: The pointer contains an offset to apply to a fixed pointer.</p> <p>Scaled Array Index: The pointer contains an offset to apply to a fixed pointer after it has been scaled.</p> <p>For Array Indices, the <code>AddAddress</code> line should reference the offset to apply, and the following line should contain the address of the first element of the array (index 0). For example:</p> <pre><code>AddAddress 16-bit Mem 0x1234\n           8-bit  Mem 0x4567\n</code></pre> <p>Would read a 16-bit number from 0x1234 and read the single byte that is that many bytes after 0x4567.</p> <p>To scale an array index, click on the space in the Cmp column for the array index address and select the <code>*</code> symbol. Then enter the size of each array item in the second mem/val column. For example:</p> <pre><code>AddAddress 16-bit Mem 0x1234 * Value 4\n           8-bit  Mem 0x4567\n</code></pre> <p>Would read a 16-bit number from 0x1234, multiply it by 4, and read the single byte that is that many bytes after 0x4567.</p>"},{"location":"AddAddress-Flag/#chaining-pointers","title":"Chaining Pointers","text":"<p><code>AddAddress</code> can be chained to perform multi-step lookups, but only one step at a time. As such, you can reference data pointed at by a pointer that's pointed at by another pointer, but you can't reference data in an array that's pointed at by another pointer unless either the array or the array index is at a fixed address.</p>"},{"location":"AddAddress-Flag/#using-delta-with-chained-pointers","title":"Using Delta with Chained Pointers","text":"<p>To do a delta check on an <code>AddAddress</code> chain, you should only put the delta on the final condition. You want to use the current value for each step of the chain to derive the final result, and you only care about the changes in the final value. Using previous values for the pointers will have you reading invalid memory and will likely cause problems.</p> <pre><code>A) AddAddress Mem   0000\nB) AddAddress Mem   0000\nC)            Delta 0000\n</code></pre> <p>Assuming Mem: $0000=0, $0001=2, and $0002=4, this will evaluate to 0 for the first few frames, and when Mem 0 changes to 1, the following happens:</p> <pre><code>Frame N  : A = Mem[0] = 1 (delta[0] = 0), B = Mem[A] = Mem[1] = 2 (delta B = 0), C = Mem[B] = Mem[2] = 4 (delta C = 0)\nFrame N+1: A = Mem[0] = 1 (delta[0] = 1), B = Mem[A] = Mem[1] = 2 (delta B = 2), C = Mem[B] = Mem[2] = 4 (delta C = 4)\n</code></pre> <p>You can see the entire delta chain updates in the same frame (one frame after the change occurs).</p> <p>If you use Delta for A and B, something different happens:</p> <pre><code>A) AddAddress Delta 0000\nB) AddAddress Delta 0000\nC)            Delta 0000\n</code></pre> <pre><code>Frame N  : Mem[0] = 1 (delta[0] = 0), B = Mem[deltaA] = Mem[0] = 1 (delta B = 0), C = Mem[deltaB] = Mem[0] = 1 (delta C = 0)\nFrame N+1: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 1), C = Mem[deltaB] = Mem[1] = 2 (delta C = 1)\nFrame N+2: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 2), C = Mem[deltaB] = Mem[2] = 4 (delta C = 2)\nFrame N+3: Mem[0] = 1 (delta[0] = 1), B = Mem[deltaA] = Mem[1] = 2 (delta B = 2), C = Mem[deltaB] = Mem[2] = 4 (delta C = 4)\n</code></pre> <p>Not only does it take two extra frames for delta C to be correct, it has two intermediate values that are not correct. The value went from 0 to 4 in a single frame and never was 1 or 2. </p>"},{"location":"AddAddress-Flag/#calculating-your-offset","title":"Calculating your offset","text":"<p>Once you think that you've found your data and something that points at (or near) your data, you need to calculate the offset to use to read that data. * 32-bit data at <code>0x821448</code> (RetroAchievements address) * Pointer at <code>0xA1CA14</code> (RetroAchievements address) (value is <code>0x8C821440</code>)</p> <p>First, determine how much of the pointer you need. For a system with 16MB of RAM, you need 24-bits to address it all (2^24 = 16777216). For 32MB, you'd need 25-bits. For 8MB, you'd only need 23-bits.</p> <p>For the data provided above, we have 16MB of memory, so we only need 24-bits of the pointer (<code>0x8C821440</code> &amp; <code>0x00FFFFFF</code> = <code>0x821440</code>)</p> <p>Then, subtract that value from the data address to calculate the offset: <code>0x821448</code> - <code>0x821440</code> = <code>0x000008</code></p> <p>Now, you can construct the logic. Place the pointer address and size/mask in the <code>AddAddress</code> condition and the offset/logic in the second line:</p> <pre><code>AddAddress Mem 24-bit 0x00A1CA14\n           Mem 32-bit 0x00000008 &lt; 1000\n</code></pre> <p>Executing this example with the provided data: * Read 24-bit data at <code>0x00A1CA14</code>: <code>0x00821440</code> * Add the offset: <code>0x00821440</code> + <code>0x00000008</code> = <code>0x00821448</code> * Read 32-bit data at new address (<code>0x00821448</code>)</p>"},{"location":"AddAddress-Flag/#second-example","title":"Second example","text":"<ul> <li>16-bit data at <code>0x1B385E0</code> (RetroAchievements address)</li> <li>Pointer at <code>0xE7B054</code> (RetroAchievements address) (value is <code>0x09B42F0C</code>)</li> <li>System has 32MB of RAM (25 bits needed) <code>0x09B42F0C</code> &amp; <code>0x01FFFFFF</code> = <code>0x1B42F0C</code></li> <li>Calculate offset: <code>0x1B385E0</code> - <code>0x1B42F0C</code> = <code>0xFFFFFFFFFFFF56D4</code> (truncate to 32-bits: <code>0xFFFF56D4</code>)</li> <li>Construct the logic:   <code>AddAddress Mem 32-bit 0x00E7B054 &amp; 0x1FFFFFF              Mem 16-bit 0xFFFF56D4 = 0x0E</code></li> </ul> <p>In this case, the pointer is actually pointing backwards, so the offset is a really big number. That's how computers represent negative values. Due to the rules of twos-compliment and overflow, you can add the really big number to perform subtraction. Executing this example with the provided data: * Read 32-bit data at <code>0x00E7B054</code>: <code>0x09B42F0C</code> * Mask off 25-bits: <code>0x09B42F0C</code> &amp; <code>0x01FFFFFF</code> = <code>0x01B42F0C</code> * Add the offset: <code>0x1B42F0C</code> + <code>0xFFFF56D4</code> = <code>0x101B385E0</code> (truncated to 32-bits: <code>0x01B385E0</code>) * Read 16-bit data at new address (<code>0x01B385E0</code>)</p>"},{"location":"AddAddress-Flag/#video-tutorial","title":"Video Tutorial","text":"<p>The experienced achievement creator wilhitewarrior made a nice video showing how to work with pointers and AddAddress flag.</p> <p>You can check it here: https://www.youtube.com/watch?v=_gk0vYYlm-E.</p>"},{"location":"AddAddress-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-01-26 08:53] Jamiras:</code> add calculating offset section</li> <li><code>[2021-10-06 19:35] Jamiras:</code> Updated AddAddress Flag (markdown)</li> <li><code>[2021-08-08 18:59] Jamiras:</code> update for scaled array index support</li> <li><code>[2020-08-05 02:06] meleu:</code> cosmetic</li> <li><code>[2020-08-05 01:58] meleu:</code> add link to wilhitewarrio's video tutorial</li> <li><code>[2019-11-17 22:18] meleu:</code> fix markdown formats</li> <li><code>[2019-11-16 07:53] Jamiras:</code> Updated AddAddress Flag (markdown)</li> <li><code>[2019-11-14 20:25] Jamiras:</code> Created AddAddress Flag (markdown)</li> </ul>"},{"location":"AddHits-Flag-es/","title":"Bandera AddHits","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>La bandera de <code>AddHits</code> puede ser seleccionada en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Cuando una condicion con la bandera de <code>AddHits</code> es verdadera, el contador de hits (hit count) de la siguiente condicion sin el <code>AddHits</code> es incrementada.</p> <p>Si la siguiente condicion si el <code>AddHits</code> no tiene un numero de hits especificos (hit target), la condicion <code>AddHits</code> no tiene un efecto en el logro.</p> <p>La condicion <code>AddHits</code> no tiene que ser verdadera para el logro se dispare, pero la siguiente condicion sin el <code>AddHits</code> si tiene que serlo, que es afectada por la condicion que si tiene el <code>AddHits</code>.</p>"},{"location":"AddHits-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:01] meleu:</code> Updated AddHits Flag ES (markdown)</li> </ul>"},{"location":"AddHits-and-SubHits-Flag/","title":"AddHits and SubHits Flag","text":"<p>NOTE: This technique is not needed for simple games, so it is not mandatory for jr-devs.</p> <p><code>AddHits</code> and <code>SubHits</code> can be chosen in the Flag column of the Achievement Editor.</p> <p>The <code>AddHits</code>/<code>SubHits</code> conditions do not have to be true for the achievement to trigger. They modify the hit count of another condition, which does have to be true for the achievement to trigger. The sequence of conditions is referred to as a <code>AddHits</code> chain (even if it contains <code>SubHits</code>).</p> <p>When a condition with the <code>AddHits</code>/<code>SubHits</code> flag is true, the hit count for that condition is incremented. A hit target may be placed on the condition to keep it from tallying too many times.</p> <p>The total hit count of the final condition in a chain is incremented by the hit counts of any <code>AddHits</code> conditions in the chain, and decremented by any <code>SubHits</code> conditions in the chain. If the total hit count meets or exceeds the target hit count of the final condition, it's considered true.</p> <p>If the final condition of the chain does not have a hit target, the <code>AddHits</code>/<code>SubHits</code> conditions have no effect on the achievement. The final condition will be true if, and only if, it is true by itself.</p> <p>NOTE: The hit target on the final condition of the chain serves as both the overall target hit count and the maximum hit count for that condition. As a result, it is impossible to use <code>SubHits</code> without <code>AddHits</code>, as any hits subtracted by the <code>SubHits</code> could not be recovered without a separate <code>AddHits</code>. Similarly, if you need to put a condition-specific limit on the final condition of the chain, you should pull it out as an <code>AddHits</code> condition with the appropriate limit and use a dummy final condition with the overall hit target (i.e. <code>0=1 (10)</code>). The dummy condition would never accumulate any hits of its own, and only serve to tally the other values in the chain.</p>"},{"location":"AddHits-and-SubHits-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-30 12:40] Jamiras:</code> Updated AddHits Flag (markdown)</li> </ul>"},{"location":"AddSource-Flag-es/","title":"Bandera AddSource","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>Un <code>AddSource</code> puede ser seleccionado en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Cuando una condicion tiene la bandera de <code>Add Source</code>, el valor de esa variable es a\u00f1adido al valor de la variable de la condicion de abajo, y la comparacion es hecha en la condicion que se encuentra abajo de la que si tiene la bandera de  <code>Add Source</code>. Puede sonar un poco confuso, pero el ejemplo de aqui abajo va a aclarar como funciona:</p> <p></p> <p>En este ejemplo el valor en <code>0x8010</code> va a ser agregado a el valor en <code>0x8020</code> y la comparacion es si la suma es mas grande que cero.</p> <p>Si el valor en <code>0x8010</code> es <code>1</code> y el valor en <code>0x8020</code> is <code>2</code>, la comparacion seria <code>1 + 2 &gt; 0</code>, o <code>3 &gt; 0</code>.</p> <p>Nota:  Todo lo que este en los campos de comparacion (Cmp) en una condicion con una bandera de <code>Add Source</code> son ignorados.</p> <p>Intentando resumir la explicacion con una imagen:</p> <p></p> <p>Nota: puedes utilizar la bandera <code>Add Source</code> para sumar mas variables, como en el siguiente ejemplo:</p> <p></p>"},{"location":"AddSource-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:00] meleu:</code> Updated AddSource Flag ES (markdown)</li> </ul>"},{"location":"AddSource-Flag/","title":"AddSource Flag","text":"<p>Note: most likely this technique is not needed for simple games. So, it's not mandatory for jr-devs.</p> <p>The <code>AddSource</code> can be chosen in the Flag column of the Achievement Editor</p> <p>When a condition has the <code>Add Source</code> flag, the value on that memory address is added to the accumulator. When a condition is reached that does not modify the accumulator, the accumulator is added to value of the address on that condition before the comparison is made, and the accumulator will be reset to 0. It may sound a bit confusing, but the example below will clarify how this works:</p>"},{"location":"AddSource-Flag/#simple-example","title":"Simple example","text":"ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>In this example the value in <code>0x8010</code> will be added to the value in <code>0x8020</code> and the comparison will check is if this sum is greater than four.</p> <p>If the value in <code>0x8010</code> is <code>1</code> and the value in <code>0x8020</code> is <code>2</code>, the comparison will be <code>1 + 2 &gt; 4</code>, or <code>3 &gt; 4</code>.</p> <p>Trying to summarize the explanation in an image:</p> <p></p>"},{"location":"AddSource-Flag/#chaining","title":"Chaining","text":"<p>You can use the <code>Add Source</code> flag to sum more addresses, like in the example below:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 AddSource Mem 8-bit 0x8011 3 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>This represents <code>value(0x8010) + value(0x8011) + value(0x8020) &gt; 4</code>.</p>"},{"location":"AddSource-Flag/#independence","title":"Independence","text":"<p>The accumulator is reset after its used, so you can have multiple <code>AddSource</code> chains in one trigger without having to worry about them interfering with each other.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) 3 AddSource Mem 8-bit 0x8030 4 Mem 8-bit 0x8040 &lt; Value 0x80 0 (0) <p>This represents <code>value(0x8010) + value(0x8020) &gt; 4 AND value(0x8030) + value(0x8040) &lt; 0x80</code>.</p>"},{"location":"AddSource-Flag/#overflow","title":"Overflow","text":"<p>The accumulator and all logic being performed is limited to 32-bits. If the total value exceeds 0xFFFFFFFF, there will be an overflow and only the 32 least significant bits will be used in the comparison.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Mem 32-bit 0x8010 2 Mem 32-bit 0x8020 &gt; Value 0x30000000 0 (0) <p>If 0x8010 is 0xC0000000 and 0x8020 is 0x54321ABC, then the total will be 0x114321ABC, which is more than 32-bits and will be truncated to 0x14321ABC, which is not more then 0x30000000, so the logic will evaluate false.</p>"},{"location":"AddSource-Flag/#using-modifiers","title":"Using Modifiers","text":"<p>Additionally, you can use AddSource to modify a value. By clicking on the \"Cmp\" column, a dropdown will open with three operators: <code>*</code>, <code>/</code>, and <code>&amp;</code>. This allows you to modify the value before adding it to the accumulator.</p> <p><code>*</code>: Multiply the left side by the right side.   - <code>AddSource 8-bit Mem 0x8010 * Value 0x14</code> would read the 8-bit value from $8010, multiply it by 20 (0x14 hex) and then add that to the accumulator.</p> <p><code>/</code>: Divide the left side by the right side.   - <code>AddSource 8-bit Mem 0x8010 / Value 0x14</code> would read the 8-bit value from $8010, divide by 20 (rounding down) and then add that to the accumulator.</p> <p><code>&amp;</code>: Bitwise-mask the left side with the right side.   - <code>AddSource 8-bit Mem 0x8010 &amp; Value 0x3f</code> would read the 8-bit value from $8010, discard bits 6 and 7 (0x3f is 00111111 in binary) and then add that to the accumulator.</p> <p>You can use memory references on the right side as well. <code>AddSource 8-bit Mem 0x8010 * 8-bit Mem 0x8011</code> would read the two 8-bit values, multiply them together, and add that to the accumulator.</p>"},{"location":"AddSource-Flag/#interaction-with-floats","title":"Interaction with floats","text":"<p>The accumulator is typed based on the first thing added to it. If the first <code>AddSource</code>/<code>SubSource</code> of a chain is an integer, the accumulator will be an integer and any floats added to the accumulator will be floored before they're added to the accumulator. If the first <code>AddSource</code>/<code>SubSource</code> of a chain is a float, the accumulator will be a float and any integers added to the accumulator will be converted to floats before they're added to the accumulator.</p> <p>Note that when the accumulator is added to the final condition, the type of the final condition is used. So if the final condition is float and the accumulator is an integer, the accumulator will be converted to a float before it's added to the final condition.</p> <p>To force all floats in an <code>AddSource</code> chain to be floored, you need an extra first and last condition:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 AddSource Value 0 2 AddSource Mem Float 0x1000 3 AddSource Mem Float 0x1004 4 AddSource Mem Float 0x1008 5 Value 0 &gt; Value 12 0 (0) <p>Line 1 primes the accumulator as an integer, so lines 2-4 will be floored before they're added to the accumulator. Line 5 ensures the final value is an integer before doing the comparison. Without line 1, lines 2-4 would be accumulated as floats. Without line 5, the accumulator would be added to the last float without it being floored.</p>"},{"location":"AddSource-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-02 07:13] Jamiras:</code> add interaction with floats section</li> <li><code>[2021-11-27 08:38] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:20] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:17] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2021-11-27 08:14] Jamiras:</code> Updated AddSource Flag (markdown)</li> <li><code>[2019-02-12 09:37] meleu:</code> Updated AddSource (markdown)</li> </ul>"},{"location":"Alt-Groups-es/","title":"Alt Groups","text":"<p>Un logro puede tener grupos agregados a el que permiten requisitos alternativos para que el logro se desbloquee. A esto se le conoce como Alt Groups, (Grupos Alternativos)</p> <p>Cuando utilizamos Alt groups, para que se dispare un logro, todas las condiciones en Core group TIENEN que ser verdaderas. Y as\u00ed tambi\u00e9n todas las condiciones de CUALQUIER Alt group tienen que ser verdaderas. En otras palabras, cada Alt group utiliza la logica <code>OR</code>.</p>"},{"location":"Alt-Groups-es/#ejemplo","title":"Ejemplo","text":"<p>En este simple ejemplo para Contra (NES) el logro requiere, \"En un Stage mira hacia arriba o ag\u00e1chate.\" Veamos que hay en el Core group y en los Alt groups: </p> <p> En el grupo core: <code>0x18 = 5</code>. Esto checa si el jugador se encuentra en un Stage.</p> <p> En <code>Alt 01</code>: <code>0xbc = 1</code>. Esto checa si el jugador esta viendo hacia arriba.</p> <p> En <code>Alt 02</code>: <code>0xbc = 2</code>. Esto checa si el jugador esta agachado.</p> <p>Mientras el jugador se encuentre en un stage. El grupo core es verdadero. Si el jugador mira hacia arriba, Alt 01 es verdadero. Si el jugador se agacha, Alt 02 es verdadero. Si core + Alt 01 \u00d3 Alt 02 es verdadero, este logro se dispararia.</p>"},{"location":"Alt-Groups-es/#datos-sobre-los-alt-groups","title":"Datos sobre los Alt Groups","text":"<ul> <li>Para a\u00f1adir o remover Alt groups haz click en el boton <code>+</code> o <code>-</code> en la parte inferior izquierda del editor de logros (achievement editor). </li> </ul> <ul> <li>Si quieres simplemente checar ESTE <code>O</code> ESO puedes dejar el core group en blanco y a\u00f1adir ESTE en <code>Alt 01</code>, y ESO en <code>Alt 02</code>.</li> </ul> <ul> <li>No importa cuantos <code>Alt groups</code> tenga un logro, si el grupo Core es verdadero, solo un Alt tiene que ser verdadero para que el logro se dispare.</li> </ul> <ul> <li>Cuando utilizamos un ResetIf y PauseIf, el PauseIf solo pausa el grupo en el que se encuentre, pero el ResetIf resetea los hit counts en todos los grupos e impide que el logro se dispare mientras el reset se encuentre activado.</li> </ul>"},{"location":"Alt-Groups-es/#utilizando-alt-groups-para-resets-condicionales","title":"Utilizando Alt Groups para Resets Condicionales","text":"<p>Avanzado: Un Alt group puede ser utilizado para crear una condici\u00f3n ResetIf que solo se activa por cierto tiempo.</p> <p>Si tu creas un Alt group que contenga una condici\u00f3n PauseIf y una condicion ResetIf, puedes utilizar la condici\u00f3n PauseIf para pausar la condici\u00f3n ResetIf sobre ciertas circunstancias y sin deshabilitar todo el logro. - Un Reset afecta a todos los grupos, incluyendo el grupo core. El Pause solo pausara el Alt group que contenga el PauseIf. - Esta l\u00f3gica puede ser aplicada a m\u00faltiples Alt groups en el mismo logro para proteger varios Reset de ser disparados por separado.  - Ten en cuenta de tener m\u00ednimo un Alt group que sea verdadero o el logro no se disparara. La manera mas facil de hacer esto es crear un alt group extra que tenga una condici\u00f3n que sea <code>Valor 1 = Valor 1</code>. - Cuidado: Si tu condici\u00f3n Pause es falsa, y la condici\u00f3n Reset tambi\u00e9n es falsa, el grupo va a ser considerado como verdadero al menos que tengas otra condici\u00f3n falsa en el grupo. Cuando utilizamos un Alt group para segregar un PauseIf, ten en cuenta de incluir siempre una condici\u00f3n que sea falsa como <code>Valor 1 = Valor 0</code>.</p>"},{"location":"Alt-Groups-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Alt-Groups/","title":"Alt Groups","text":"<p>Achievements can have groups added to them that allow for alternative requirements to unlock an achievement. These are called Alt Groups,</p> <p>When using Alt groups, for the achievement to trigger, all the conditions in the Core group MUST be true. And then all the conditions of ANY Alt group must be true. In other words, each Alt group uses <code>OR</code> logic.</p>"},{"location":"Alt-Groups/#example","title":"Example","text":"<p>In this dummy example for Contra (NES) the achievement requires, \"While on stage look up or crouch.\" Lets look at what's in the Core group and in the Alt groups: </p> <p> In the core group: <code>0x18 = 5</code>. This checks that the player is on stage.</p> <p> In <code>Alt 01</code>: <code>0xbc = 1</code>. This checks that the player is looking up.</p> <p> In <code>Alt 02</code>: <code>0xbc = 2</code>. This checks that the player is crouching.</p> <p>As long as the player is on stage. The core group is true. If the player looks up, Alt 01 is true. If the player crouches, Alt 02 is true. If core + Alt 01 OR Alt 02 are true, the achievement will trigger.</p>"},{"location":"Alt-Groups/#facts-about-alt-groups","title":"Facts about Alt Groups","text":"<ul> <li>To add or remove Alt groups click the <code>+</code> or <code>-</code> button in the bottom left of the achievement editor. </li> </ul> <ul> <li>If you want to simply test for this <code>OR</code> that you can leave the core group blank and add this in <code>Alt 01</code>, and that in <code>Alt 02</code>.</li> </ul> <ul> <li>No matter how many <code>Alt groups</code> an achievement has, if the Core group is true, only one Alt has to be true for the achievement to trigger.</li> </ul> <ul> <li>When using ResetIf and PauseIf, PauseIf only pauses the group that it's in, but ResetIf resets hit counts in all groups and prevents achievements from triggering so long as the reset is active.</li> </ul>"},{"location":"Alt-Groups/#using-alt-groups-for-conditional-resets","title":"Using Alt Groups for Conditional Resets","text":"<p>Advanced: An Alt group can be used to create a ResetIf condition that is only active some of the time.</p> <p>If you create an Alt group containing a PauseIf condition and a ResetIf condition, you can use the PauseIf condition to disable the ResetIf condition under certain circumstances without disabling the entire achievement.</p> <ul> <li>The Reset will still affect all groups, including your core group. The Pause will only pause the Alt group containing the PauseIf.</li> </ul> <ul> <li>This logic can be applied to multiple Alt groups in the same achievement to protect several separate Reset statements.</li> </ul> <ul> <li>Make sure that you have at least one Alt group that will be true or the achievement won't trigger. The easiest way to do this is to create an extra alt group that has one condition that is <code>Value 1 = Value 1</code>.</li> </ul> <ul> <li>Beware: If your Pause condition is false, and the Reset condition is also false, the group will be considered true unless you have another always false condition in the group. When using an Alt group to segregate a PauseIf, make sure to include an always false condition like <code>Value 1 = Value 0</code>.</li> </ul>"},{"location":"Alt-Groups/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-06-18 15:48] Jamiras:</code> add whitespace so bullets are joined when document is published</li> <li><code>[2019-03-07 21:00] Jamiras:</code> Updated Alt Groups (markdown)</li> <li><code>[2019-02-12 09:38] meleu:</code> Created Alt Groups (markdown)</li> </ul>"},{"location":"AndNext-and-OrNext-Flags/","title":"AndNext and OrNext Flags","text":"<p><code>AndNext</code> and <code>OrNext</code> are used to associate more than one condition to a ResetIf, PauseIf, or Hit Count.</p> <p><code>AndNext</code> and <code>OrNext</code> can be chosen in the Flag column of the Achievement Editor</p> <p>When a condition has the <code>AndNext</code> flag, the condition must be true in addition to the following condition for the following condition to be considered true. </p> <p>When a condition has the <code>OrNext</code> flag, the condition or the following condition must be true for the following condition to be considered true.</p> <p>You can chain multiple <code>AndNext</code> and <code>OrNext</code> conditions to create complex requirements for a single <code>ResetIf</code>, <code>PauseIf</code>, or <code>Hit Count</code>.</p> <p>When evaluating a combination of <code>AndNext</code> and <code>OrNext</code> conditions, each line is evaluated individually.</p> <pre><code>AndNext A=1\nOrNext  B=1\nAndNext C=1\nOrNext  D=1\nAndNext E=1\nResetIf F=1\n</code></pre> <p>Represents the following logical statement:</p> <pre><code>reset if (((((A = 1 &amp;&amp; B = 1) || C = 1) &amp;&amp; D = 1) || E = 1) &amp;&amp; F = 1)\n</code></pre> <p>Alt Groups are still preferred over <code>OrNext</code> for most use cases. They allow for multiple conditions to be present in each clause of the OR, and support more than two clauses.</p> <p><code>AndNext</code> is not required for simple logic. All conditions in a group are automatically AND'd together. <code>AndNext</code> just allows for two or more conditions to affect a single <code>PauseIf</code>, <code>ResetIf</code>, or <code>Hit Count</code>.</p>"},{"location":"AndNext-and-OrNext-Flags/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-01-25 13:18] meleu:</code> fix markdown links</li> <li><code>[2020-05-17 14:01] Jamiras:</code> update title</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/","title":"Creaci\u00f3n de Iconos y Badges","text":"<p>Tabla de Contenidos - Iconos de Juegos    - Dise\u00f1ando mis nuevos iconos - gu\u00eda est\u00e9tica       - Flexibilidad para la gu\u00eda est\u00e9tica       - Tengo que seguir esta gu\u00eda de est\u00e9tica?    - Otros Tips de Dise\u00f1o de Iconos       - Archivo y Tama\u00f1o del Icono - mejores practicas    - Subiendo Iconos de juegos (Desarrollador)    - Subiendo Iconos de Juegos (no-Desarrollador)    - Game Icon Gauntlet       - Reglas para proponer un nuevo icono de juego       - La votaci\u00f3n en Icon Gauntlet    - Que pasa con la imagen cuando subes el icono de un juego    - Servidores de los Archivos de Iconos - Badges de Logros    - Gu\u00edas y Tips en la Creaci\u00f3n de Badges       - Tama\u00f1o y Archivo del Badge - mejores practicas    - Subiendo un Badge (Desarrollador)    - Subiendo un Badge (No-Desarrollador)    - Que pasa con la imagen cuando subes un Badge    - Servidor de los archivos de Badges - Donde se muestran los Badges e Iconos</p>"},{"location":"Badge-and-Icon-Creation-es/#iconos-de-juegos","title":"Iconos de Juegos","text":"<p>Los Iconos son im\u00e1genes subidas por el usuario que sirven para representar a un juego por medio de la pagina. Debido a la prominencia en las pagina de juego y de usuarios estas reciben una atenci\u00f3n especial.</p> <ul> <li> <p>Icono en Sonic the Hedgehog's </p> <p> </p> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#disenando-mis-nuevos-iconos-guia-estetica","title":"Dise\u00f1ando mis nuevos iconos - gu\u00eda est\u00e9tica","text":"<p>Cuando dise\u00f1es el nuevo icono de un juego considera los siguientes puntos: La mayor\u00eda de la comunidad prefiere que los iconos utilicen el artwork original del juego; - que se encuentre dentro del juego,  - o en documentos del juego,  - o en el manual,  - o material promocional, - y un sin fin; arte creado por el equipo original.</p> <p>Utilizar dise\u00f1os mas actuales (o fan art) para personajes cl\u00e1sicos de v\u00eddeo juegos tal vez parezca prudente. Pero varios podr\u00edan encontrar esto como irrespetuoso al material original.</p> <p></p>"},{"location":"Badge-and-Icon-Creation-es/#flexibilidad-para-la-guia-estetica","title":"Flexibilidad para la gu\u00eda est\u00e9tica","text":"<ul> <li>Para juegos no licenciados o <code>~hacks~</code>donde hay muy poco material original disponible, utilizar arte no-official podr\u00eda ser razonable.</li> <li>Hacer modificaciones a los assets de arte disponibles usualmente es razonable.</li> <li>Utilizar assets de fuera o hechos a mano, digamos un titulo o un borde, mientras tanto el tema principal sea el arte oficial tambi\u00e9n es razonable.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#tengo-que-seguir-esta-guia-de-estetica","title":"Tengo que seguir esta gu\u00eda de est\u00e9tica?","text":"<p>El estilo que escoges para tus dise\u00f1os ya depende de ti. Puedes romper estas reglas siempre y cuando no rompas alguna lei de copyright, o subas algo vulgar, ofensivo o pornogr\u00e1fico.</p>"},{"location":"Badge-and-Icon-Creation-es/#otros-tips-de-diseno-de-iconos","title":"Otros Tips de Dise\u00f1o de Iconos","text":"<ul> <li>Checa la lista de juegos, para encontrar iconos que resuenen contigo. Simulalos e innova los estilos de tus favoritos.</li> <li>Mucho de los tips de creaci\u00f3n de Medallas aplican aqu\u00ed tambi\u00e9n.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#archivo-y-tamano-del-icono-mejores-practicas","title":"Archivo y Tama\u00f1o del Icono - mejores practicas","text":"<ul> <li>Los logros que se suban tienen que ser cuadrados (tener las misma dimensiones X y Y), de otra manera la imagen resultar\u00eda distorsionada y fea.</li> <li>Sube im\u00e1genes en formato PNG que no est\u00e9n entrelazadas; evita utilizar capaz de transparencia ya que al final va a salir con un fondo blanco.</li> <li>Dise\u00f1a im\u00e1genes en 96x96 (preferido), 64x64, 48x48 o 32x32 para una calidad mas marcada. Iconos y badges tienen que ser hechos de una manera que sean claros en 32x32 ya que son normalmente reducidas a este tama\u00f1o, como en el feed global de notificaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-iconos-de-juegos-desarrollador","title":"Subiendo Iconos de Juegos (Desarrollador)","text":"<p>Los desarrolladores de logros tienen permitido cambiar iconos de juegos en entradas que no cuenten con logros. Como desarrollador si tu quieres postear un respaldo de la antigua imagen eres libre de hacerlo pero no es realmente un requisito. Mientras creas un nuevo set de logros tu eres libre de crear o escoger que icono quieres para el juego.</p> <p>Para cambiar el Icono de un juego primero ve a la pagina del juego y haz click en Dev tools: </p> <p>Luego haz click en el bot\u00f3n de choose file que se encuentra resaltado. Encuentra el archivo en tu PC, y luego presiona el bot\u00f3n resaltado de submit: </p> <p>Si un juego que ya cuenta con logros el cambio de Icono tiene que pasar por medio de Icon Gauntlet.</p>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-iconos-de-juegos-no-desarrollador","title":"Subiendo Iconos de Juegos (no-Desarrollador)","text":"<p>Si, absolutamente puedes, pero recuerda leer las regla de Icon Gauntlet. Tambien seria bueno darle un vistazo a las reglas de dise\u00f1o para nuevos iconos de juegos.</p>"},{"location":"Badge-and-Icon-Creation-es/#game-icon-gauntlet","title":"Game Icon Gauntlet","text":"<p>El game Icon Gauntlet enfrenta un icono posteado por un usuario en una pelea cara-a-cara con el icono actual. El voto popular es lo que toma lugar en #Icon-Gauntlet este canal de Discord es lo que determina que se queda y que se va. Todos los usuarios verificados de Discord son elegibles de ingresar su voto. Spawncalibur es el administrador en todos los aspectos de esta din\u00e1mica.</p>"},{"location":"Badge-and-Icon-Creation-es/#reglas-para-proponer-un-nuevo-icono-de-juego","title":"Reglas para proponer un nuevo icono de juego","text":"<ul> <li>Cualquier usuario verificado de RetroAchievments puede subir un nuevo icono de juego.</li> <li>Solo proponer iconos para juegos que ya cuentan con logros.</li> <li>Propuestas de iconos tienen que estar relacionadas con el juego, no gr\u00e1ficos nuevos.</li> <li>Recomendado: Iconos se ven mejor creados en 96x96, 64x64 o 32x32. Crea una imagen PNG en formato para mejores resultados.</li> <li>Posteala en este tema del foro.<ul> <li>Para mostrar la imagen apropiadamente posteala utilizando el tag de foro <code>[img=http://YourImageURL.png]</code></li> <li>Deja en claro cual es el juego el cual quieres que tu icono quiere remplazar. (Incluso mejor si utilizas el tag del foro de <code>[game=GameID]</code>. Puedes encontrar el ID del juego viendo el URL de la pagina de este)</li> </ul> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#la-votacion-en-icon-gauntlet","title":"La votaci\u00f3n en Icon Gauntlet","text":"<ul> <li>El voto toma lugar en el canal de Discord de #Icon-Gauntlet y esta abierto a todos los usuarios de Discord Verificados (usuarios de Discord con (nombre verde))</li> <li>Nuevas votaciones son posteadas semanalmente y duran una semana.</li> <li>Se gana por mayor\u00eda de votos.</li> <li>Si pasa un empate van a suceder unas re-votaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#que-pasa-con-la-imagen-cuando-subes-el-icono-de-un-juego","title":"Que pasa con la imagen cuando subes el icono de un juego","text":"<p>Cuando se sube, tu imagen es reducida a un PNG de 32-bits colores y a un tama\u00f1o de 96x96. Si subes un icono que sea mas peque\u00f1o que 96x96 la imagen va a retener su tama\u00f1o original. </p> <p>Lo mismo pasa para los Badges, excepto que el tama\u00f1o maximo para los badges es de 64x64. (El de Imagenes de Perfil es de   128x128.)</p>"},{"location":"Badge-and-Icon-Creation-es/#servidores-de-los-archivos-de-iconos","title":"Servidores de los Archivos de Iconos","text":"<p>Los Iconos son almacenados en el sitio de la siguiente manera y lugar: <code>i.retroachievements.org/Images/000705.png</code>. Ellos son almacenados en el mismo folder donde se almac\u00e9n todas las dem\u00e1s im\u00e1genes como las caratulas y las screenshots por ejemplo. </p>"},{"location":"Badge-and-Icon-Creation-es/#badges-de-logros","title":"Badges de Logros","text":"<p>Los Badges (Emblemas) son las imagenes creadas por el usuario para cada logro en individuo de un juego.</p> <ul> <li>Sonic the Hedgehog's primer Badge - #00199)   ## </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#guias-y-tips-en-la-creacion-de-badges","title":"Gu\u00edas y Tips en la Creaci\u00f3n de Badges","text":"<ul> <li>Los Badges tienen que estar relacionados con lo que se trate el logro - por ejemplo: la foto de un jefe, nivel o coleccionable que requiere que el jugador consiga. </li> <li>Checa dise\u00f1os de varios de tus juegos favoritos. Algunos usuarios ponen un gran esfuerzo en crear badges realmente atractivos:</li> </ul> <ul> <li>Aqu\u00ed esta un tema del foro lleno de grandes tips. </li> <li>En el caso de logros de juegos de muy baja-resoluci\u00f3n, puede ser dificil conseguir que un badge que se mire bien y que este no se mira tosco o borroso, en estos casos un look mas tosco es mucho mas preferible, ya que las im\u00e1genes tiene esa sensaci\u00f3n retro en ellas.</li> <li>Puedes hacer que cada Badge tengan un peque\u00f1os bordes pandeados como un Badge/Emblema actual o algunos bordes extras punteados para mas \u00e9nfasis o una corona de rey para los mas dif\u00edciles.  Es tu dise\u00f1o.  Deber\u00eda de presentar el logro de una manera visual, o que sea una pista para evadir secretos del juego.</li> <li>Estar a la par con el estilo de arte del juego tambi\u00e9n funciona bien. Buscar en Google Image \"Sprite Sheets\" es tambi\u00e9n otro \u00fatil tip para incluir alg\u00fan arte del juego.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#tamano-y-archivo-del-badge-mejores-practicas","title":"Tama\u00f1o y Archivo del Badge - mejores practicas","text":"<ul> <li>Los badges que se suban tienen que ser cuadrados (tener las misma dimensi\u00f3n X y Y), de otra manera la imagen resultar\u00eda distorsionada y fea.</li> <li>Subir im\u00e1genes PNG en formato no-entrelazado; evita utilizar una capa de transparencia ya que va a salir un fondo blanco en el.</li> <li>Dise\u00f1a im\u00e1genes en 64x64, 48x48 o 32x32 por la mejor calidad. Los logros se tienen que hacer de una manera que la tem\u00e1tica se sea clara incluso en 32x32, ya que son reducidas a este tama\u00f1o com\u00fanmente en el sitio, como en el feed global de notificaciones.</li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-badges-desarrollador","title":"Subiendo Badges (Desarrollador)","text":"<p>Si te encuentras creando logros eres libre de subir badges para ellos. </p> <p>Los Badges se suben con las herramientas de desarrollador del emulador por medio del editor de logros: </p> <p>O tambi\u00e9n puedes seleccionar una imagen prefabricada o encontrar otras im\u00e1genes que haz subido por medio de la lista desglosable: </p> <p>Subir archivos <code>.jpg</code>, <code>.jpg</code> o <code>.gif</code>. No es completamente importante el formato, pero si es completamente recomendable que la imagen sea cuadrada.</p> <p>Si el juego ya cuenta con badges existentes \u00e9chale una checada y sigue el procedimiento para Subiendo Badges (No-Desarrollador).</p>"},{"location":"Badge-and-Icon-Creation-es/#subiendo-badges-no-desarrollador","title":"Subiendo Badges (No-Desarrollador)","text":"<p>Postea todas las im\u00e1genes nuevas que quieres remplazar en el foro oficial del juego. Tambi\u00e9n enlista cuales badges quieres remplazar. Un desarrollador o un moderador va a evaluar tu trabajo y decidir si, s\u00ed ser\u00e1n remplazados. Si as\u00ed lo deciden se posteara un respaldo de los iconos actuales en el foro, y tambi\u00e9n se remplazaran por los nuevos.</p> <p>Este respaldo es necesario si llega a existir el caso en el que hay desacuerdos con los nuevos badges. En estos casos algunos o todos los badges podr\u00edan ser revertidos a los anteriores.</p> <p>Es mas f\u00e1cil hacer una referencia a los viejos y nuevos badges como links de <code>img</code>: - ejemplo: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code> - (Dev) percatate de capturar los antiguos ID de los badges del Editor de Logros antes de subir los nuevos - El ID de los nuevos badges aparecer\u00e1n en el Editor de Logros despu\u00e9s de que sean subidos. - ambos valores tambi\u00e9n pueden ser capturados desde el sitio web, pero tienes que copiar el link de la imagen como el hover link del logro.</p> <p>Aqu\u00ed hay un ejemplo perfecto de como hacer un respaldo apropiado de Badges reci\u00e9n cambiados.</p>"},{"location":"Badge-and-Icon-Creation-es/#que-pasa-con-la-imagen-cuando-subes-un-badge","title":"Que pasa con la imagen cuando subes un Badge","text":"<p>Cuando se sube, tu archivo es convertido a lo siguiente: - 64x64 PNG de 32-bit de color. Ejemplo:</p> <pre><code>![00136](https://user-images.githubusercontent.com/8508804/37221161-b9b0bb02-23a7-11e8-81b2-3d09fa7456af.png)\n</code></pre> <ul> <li>64x64 PNG borroso y con escala de grises. Ejemplo:<p></p> </li> </ul>"},{"location":"Badge-and-Icon-Creation-es/#servidor-de-los-archivos-de-badges","title":"Servidor de los Archivos de Badges","text":"<p>Estos se almacenan en el sitio de la siguiente manera y lugar: <code>i.retroachievements.org/Badge/00136.png</code>; el numero coincide con el ID de Badges que se encuentra con el Editor de Logros.</p>"},{"location":"Badge-and-Icon-Creation-es/#donde-se-muestran-los-badges-e-iconos","title":"Donde se muestran los Badges e Iconos","text":"<ul> <li>En tablas de Clasificacion: 96x96 (Solamente Iconos)</li> <li>En emuladores de RA: 64x64</li> <li>Paginas de Juego: 64x64</li> <li>Paginas de Usuarios: 48x48</li> <li>Actualmente jugando/Rich Presence y en el Feed Global: 32x32</li> </ul> <p>La im\u00e1genes actuales no se les cambia el tama\u00f1o. La imagen es escalada por el navegador al tama\u00f1o correspondiente. Algunos navegadores como el de Android muestran de una manera mas clara las im\u00e1genes mas grandes. Tambi\u00e9n puedes aumentar el zoom de tu navegador para ver aun mas claro.</p> <p>Se espera que en la versi\u00f3n futura del sitio, los Iconos y Badges se muestren en tama\u00f1o completo en otros lugares.</p>"},{"location":"Badge-and-Icon-Creation-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-15 10:10] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-15 10:06] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-15 09:58] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-05-12 16:01] eldexterr:</code> Updated Badge and Icon Creation es (markdown)</li> <li><code>[2019-04-18 17:26] eldexterr:</code> Document created but still not finished</li> </ul>"},{"location":"Badge-and-Icon-Creation-pt_BR/","title":"Cria\u00e7\u00e3o de \u00cdcones e Emblemas","text":"<p>Link para o texto em ingl\u00eas: Badge and Icon Creation</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#introducao","title":"Introdu\u00e7\u00e3o","text":"<p>Emblemas e \u00edcone s\u00e3o usados em todo o site e s\u00e3o uma boa maneira de representar a conquista no jogo.</p> <p>Emblemas s\u00e3o as imagens para os achievements de um jogo. Eles s\u00e3o armazenados no site da seguinte maneira e local: <code>i.retroachievements.org/Badge/00136.png</code>; o n\u00famero coincide com o ID do emblema encontrado no Achievement editor.</p> <p>Os \u00edcones s\u00e3o armazenados no site da seguinte maneira e colocam: <code>i.retroachievements.org/Images/000705.png</code>, armazenados na mesma pasta que outras imagens do jogo, como a caixa do jogo (game box) e screenshots do jogo.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#formato-de-emblema","title":"Formato de Emblema","text":"<p>Quando carregado, seu arquivo \u00e9 convertido no seguinte:</p> <ul> <li>PNG em cores de 32 bits 64x64. Exemplo:</li> </ul> <p></p> <ul> <li>64x64 em escala de cinza e PNG desfocado. Exemplo:</li> </ul> <p></p> <p>N\u00e3o \u00e9 totalmente importante como o arquivo \u00e9 formatado antes do upload, mas, desde que seja quadrado, o arquivo ser\u00e1 carregado e convertido facilmente. Naturalmente, \u00e9 importante n\u00e3o infringir nenhuma lei de direitos autorais ou fazer upload de algo vulgar, ofensivo ou pornogr\u00e1fico, com as poss\u00edveis consequ\u00eancias de ser advertido, potencialmente reportado e potencialmente removido da RetroAchievements.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#formato-de-icone","title":"Formato de \u00edcone","text":"<p>Quando carregadas, as imagens do seu \u00edcone s\u00e3o reduzidas para um PNG em cores de 32 bits 96x96 no m\u00e1ximo. Se voc\u00ea fizer o upload de um \u00edcone menor que 96x96, a imagem enviada manter\u00e1 seu tamanho original.</p> <p>O mesmo vale para os emblemas, exceto que o tamanho m\u00e1ximo dos emblemas \u00e9 64x64. (O m\u00e1ximo de imagens do perfil \u00e9 128x128.)</p> <p>Lugares e tamanhos Os \u00edcones s\u00e3o exibidos:</p> <ul> <li>Nas tabelas de classifica\u00e7\u00e3o: 96 x 96</li> <li>P\u00e1ginas de Jogo: 64x64</li> <li>P\u00e1ginas de Usu\u00e1rio: 48x48</li> <li>Jogando Atualmente e Feed Global: 32x32</li> </ul> <p>A mesma coisa que com os emblemas, a imagem real n\u00e3o est\u00e1 sendo redimensionada apenas o tamanho da tela, se voc\u00ea usar o Android ou aumentar o zoom do seu navegador, voc\u00ea ver\u00e1 as imagens com mais clareza.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#diretrizes-e-dicas","title":"Diretrizes e Dicas","text":"<ul> <li>As imagens enviadas para emblemas devem ser quadradas, como um n\u00famero igual de x e y, caso contr\u00e1rio, a imagem resultante ser\u00e1 distorcida e feia.</li> </ul> <ul> <li>O formato PNG n\u00e3o-entrela\u00e7ado (Non-interlaced PNG) recomendado, evite usar uma camada de transpar\u00eancia, pois ela sair\u00e1 no final com uma caixa branca e plana.</li> </ul> <ul> <li>\u00c9 recomendado fazer emblemas em 64x64 para maior clareza. Os \u00edcones devem ser feitos de maneira que o tema seja claro mesmo quando dimensionado em 32x32.</li> </ul> <ul> <li>Os emblemas devem se referir de alguma forma ao que \u00e9 o achievement, ou seja, uma imagem do chefe, n\u00edvel ou colecion\u00e1vel que o achievement requer que o jogador alcance.</li> </ul> <ul> <li>Nos casos de achievements de jogos de baixa resolu\u00e7\u00e3o, pode ser dif\u00edcil conseguir um distintivo com boa apar\u00eancia sem que ele pare\u00e7a muito colorido ou emba\u00e7ado. Nesses casos, o visual de blocos \u00e9 geralmente prefer\u00edvel, de modo que as imagens tenham uma apar\u00eancia retr\u00f4.</li> </ul> <ul> <li>Voc\u00ea pode fazer com que cada distintivo tenha pequenas bordas arredondadas, como um distintivo real ou alguns cantos pontiagudos extras para dar \u00eanfase ou uma coroa do rei para os mais dif\u00edceis. \u00c9 o seu design. Deve representar visualmente o achievement em si, ou sugerir a localiza\u00e7\u00e3o no jogo em busca de segredos.</li> </ul> <ul> <li>Combinar com o estilo de arte do jogo funciona bem. Pesquisas de imagens do Google para \"Sprite Sheets\" \u00e9 outra dica \u00fatil para incluir algumas artes do jogo.</li> </ul>"},{"location":"Badge-and-Icon-Creation-pt_BR/#mudancas-e-rebaixamentos","title":"Mudan\u00e7as e Rebaixamentos","text":"<p>Como o site n\u00e3o tem, na maioria dos casos, um rollback permanente / estilo git-rollback / estilo wiki para todas as a\u00e7\u00f5es tomadas em um conjunto, \u00e9 recomendado que quando um desenvolvedor faz altera\u00e7\u00f5es de qualquer tipo em um conjunto dele no f\u00f3rum para esse jogo.</p> <p>Em rela\u00e7\u00e3o aos emblemas, publique na p\u00e1gina do f\u00f3rum do jogo uma das seguintes op\u00e7\u00f5es:</p> <ul> <li>Deixando uma c\u00f3pia antiga do crach\u00e1 no t\u00f3pico do jogo (exemplo: <code>[img = \"https://retroarchievement.org/badge/1234]</code>)</li> </ul> <ul> <li>Anota\u00e7\u00e3o do antigo ID do emblema (n\u00famero exibido no URL da imagem do emblema)</li> </ul> <p>Aqui est\u00e1 um exemplo perfeito de como fazer o backup corretamente de emblemas alterados.</p> <p>\u00e9 recomendado, para ajudar a manter tudo em ordem, de modo que, nos casos em que as revers\u00f5es ou altera\u00e7\u00f5es sejam adequadas, \u00e9 muito mais f\u00e1cil faz\u00ea-las.</p>"},{"location":"Badge-and-Icon-Creation-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-10-11 00:45] CoolCanuck:</code> https</li> <li><code>[2018-03-26 23:01] meleu:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-26 02:52] KingDice001:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-26 02:52] KingDice001:</code> Updated Badge and Icon Creation pt_BR (markdown)</li> <li><code>[2018-03-25 23:13] 7Mogami7:</code> Created Badge and Icon Creation pt_BR (markdown)</li> </ul>"},{"location":"Badge-and-Icon-Creation/","title":"Badge and Icon Creation","text":""},{"location":"Badge-and-Icon-Creation/#game-icons","title":"Game Icons","text":"<p>Icons are user uploaded images that are used throughout the site to represent a game. Due to their prominence on game and user pages they are worth special attention. These icons should be representative of the game and its common themes, and therefore should be instantly recognizable.</p> <ul> <li> <p>Sonic the Hedgehog's game Icon </p> <p> </p> </li> </ul>"},{"location":"Badge-and-Icon-Creation/#designing-new-game-icons-styling-guide","title":"Designing New Game Icons - Styling Guide","text":""},{"location":"Badge-and-Icon-Creation/#game-mastery-icons-must-represent-the-associated-game-by-using-official-art-only","title":"Game Mastery Icons must represent the associated game by using 'Official' art only.","text":"<ul> <li>Sprites from the game (or models)</li> <li>Box Art / Regional Box Art</li> <li>Concept Art</li> <li>CD / OST Art</li> <li>Manual Art</li> <li>Guidebook Art</li> <li>Advertisements</li> <li>Or any other 'Official' Source of artwork.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#mastery-icons-must-not","title":"Mastery Icons must not","text":"<ul> <li>Use art from a different port</li> <li>Use fan art sourced from external sources</li> <li>Contain anything vulgar, offensive or pornographic</li> </ul>"},{"location":"Badge-and-Icon-Creation/#mastery-icons-may","title":"Mastery Icons may","text":"<ul> <li>Add in custom borders or other adornments</li> <li>Stylize official art or combine different official art sources</li> <li>Use official art from a different regional release on the same console, unless that regional release has its own game page entry</li> <li>Use fan art created by the icon creator, but it must be approved by the art team prior to uploading or any icon gauntlet vote.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#exceptions","title":"Exceptions","text":"<ul> <li>If two different ports use the same key art, that art may be used for either port.</li> <li>Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.</li> <li>Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#other-icon-design-tips","title":"Other Icon Design Tips","text":"<ul> <li>Browse the games list, to find Icons that speak to you. Mimic and innovate on the style of your favorites.</li> <li>Many of the Badge creation tips apply here as well.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#icon-file-and-size-best-practices","title":"Icon File and Size - Best Practices","text":"<ul> <li>Upload using non-interlaced PNG format; avoid using a transparency layer for the background as it will come out in the end with a flat white box.</li> <li>Design mastery Icons images at 96x96</li> <li>Icons should be made in a way that the subject is clear even when sized at 32x32 as they are often reduced to this size, like on the global feed.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#uploading-game-icons-developer","title":"Uploading Game Icons (Developer)","text":"<p>Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.</p> <p>To change a game icon first go to the game page and click on the Dev tools: </p> <p>Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted: </p> <p>If a game has existing achievements, game icon changes need to go through revision process.</p>"},{"location":"Badge-and-Icon-Creation/#uploading-game-icons-non-developer","title":"Uploading game icons (non-Developer)","text":"<p>Yes, you absolutely can, but they are subject to revisions. It will also be good to review the guidelines for designing new game icons.</p>"},{"location":"Badge-and-Icon-Creation/#what-happens-to-the-image-when-you-upload-a-game-icon","title":"What happens to the image when you upload a game Icon","text":"<p>When uploaded, your Icon images will be rejected unless they are a 96x96 32-bit colour PNG. If you upload an Icon that is smaller than 96x96 the image uploaded will retain its original size.</p> <p>The same is true for Badges, except Badge size is 64x64. (Profile images maximum is 128x128.)</p>"},{"location":"Badge-and-Icon-Creation/#icon-server-files","title":"Icon server files","text":"<p>Icons are stored on the site in the following manner and place: <code>i.retroachievements.org/Images/000705.png</code>. They are stored in the same server folder as other game images such as the game box and game screenshots. </p>"},{"location":"Badge-and-Icon-Creation/#achievement-badges","title":"Achievement Badges","text":"<p>Badges are the user created images for individual achievements of a game.</p> <ul> <li>Sonic the Hedgehog's first Badge - #00199) </li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-creation-guidelines-and-tips","title":"Badge creation guidelines and tips","text":"<ul> <li>Badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to. </li> <li>Check out the designs of some of your favorite games. Some users go to great effort to make visually appealing badges:</li> </ul> <ul> <li>Here's a forum topic full of great tips. </li> <li>In the cases of low-resolution games' achievements, it can be hard to get a Badge looking good without it looking blocky or blurry, in these cases the blocky look is often preferable, so that the images have a retro feel to them.</li> <li>You can make each Badge have little rounded borders like an actual Badge or some extra spiky corners for emphasis or a king's crown for difficult ones.  Its your design.  It should visually represent the achievement itself, or hint at the location in the game for secrets.</li> <li>Matching to the game's art style works well. Google Image searches for \"Sprite Sheets\" is another useful tip to include some game art.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-file-and-size-best-practices","title":"Badge file and size - best practices","text":"<ul> <li>Upload using non-interlaced PNG format; avoid using a transparency layer as it will come out in the end with a flat white box.</li> <li>Design images at 64x64. You may wish to check them at 48x48 and 32x32 just to see how they will look in contexts where the site resizes them to those smaller sizes.</li> <li>Badges should be made in a way that the subject is clear even when sized at 32x32, as they are often reduced to this size, like on the global feed.</li> </ul>"},{"location":"Badge-and-Icon-Creation/#uploading-a-badge-for-new-achievements-developer","title":"Uploading a Badge for new achievements (Developer)","text":"<p>If you are creating new achievements you are free to upload badges for them. </p> <p>Badges are uploaded from within the emulator developer tools while in the achievement editor: </p> <p>Or you can select a prefabricated image or find other images you've uploaded in the drop down box: </p> <p>Upload <code>.png</code> file types.</p> <p>If the game has existing badges review and follow the procedure for Uploading Badges (Non-Developer).</p>"},{"location":"Badge-and-Icon-Creation/#making-new-badges-for-existing-achievements","title":"Making new Badges for existing achievements","text":"<p>If you'd like to make improved badges for existing achievements, you can. Your images will go through the revision process, which will put your creations to a community vote.</p> <p>Post all the new images you'd like to replace current ones in the Icon Gauntlet Forum Topic. Also post all the badges that the new images are meant to replace. They will be placed for a community review by as a single vote. After a community vote is complete if you are a dev you can replace the Badges or if you are not, ask for help in the #help-me channel on Discord or in the Icon Gauntlet Forum Topic.</p> <p>It's easiest to just reference the old and new Badges as <code>img</code> links:</p> <ul> <li>Example: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code></li> <li>(Dev) Make sure to capture the old Badge ID from the Achievement Editor before uploading the new Badge</li> <li>The new Badge ID will appear in the Achievement Editor after uploading it.</li> <li>Both values can also be captured from the web site, but you have to copy the image links as the hover link is for the achievement.</li> </ul> <p>Here is a perfect example of how to effectively post new and old Badges.</p>"},{"location":"Badge-and-Icon-Creation/#what-happens-to-the-image-when-you-upload-a-badge","title":"What happens to the image when you upload a Badge","text":"<p>When uploaded, your file is converted into the following: - 64x64 32-bit colour PNG. Example:</p> <pre><code>![00136](https://user-images.githubusercontent.com/8508804/37221161-b9b0bb02-23a7-11e8-81b2-3d09fa7456af.png)\n</code></pre> <ul> <li>64x64 greyscale and blurred PNG. Example:<p></p> </li> </ul>"},{"location":"Badge-and-Icon-Creation/#badge-server-files","title":"Badge Server Files","text":"<p>They are stored on site in the following manner and place: <code>i.retroachievements.org/Badge/00136.png</code>; the number coincidences with the badge ID found in the Achievement.</p>"},{"location":"Badge-and-Icon-Creation/#where-youll-see-badges-and-icons-are-displayed","title":"Where you'll see Badges and Icons are displayed","text":"<ul> <li>On leaderboards: 96x96 (Icon only)</li> <li>In RA Emulators 64x64</li> <li>Game Pages: 96x96</li> <li>User Pages: 48x48</li> <li>Currently Playing (front page), New Achievements, Similar Games: 32x32</li> </ul> <p>The actual images are not being resized. The image is scaled by the browser to the display size. Some browsers such as Android's browser will display larger images more clearly. You can also increase your browser zoom to see them more clearly.</p> <p>It's anticipated that in a future website version, Icons and Badges will be displayed at full size in other places.</p>"},{"location":"Badge-and-Icon-Creation/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-21 07:59] The Mystical One:</code> Removed jpg and gif references.</li> <li><code>[2023-06-13 13:05] The Mystical One:</code> Added new rules about game icons as proposed by art team and approved by DevCompliance. Cleaned up a few other details.</li> <li><code>[2023-05-31 10:21] The Mystical One:</code> Fixing badge and icon size design rules.</li> <li><code>[2021-07-01 09:00] StingX2:</code> Added \"These icons should be representative of the game and its common themes, and therefore should be instantly recognizable.\"</li> <li><code>[2021-05-10 21:09] HolyShinx:</code> Updated Badge and Icon Creation (markdown)</li> <li><code>[2021-04-26 13:26] meleu:</code> fix links</li> <li><code>[2020-10-25 18:30] meleu:</code> Updated Badge and Icon Creation (markdown)</li> <li><code>[2020-03-23 06:31] televandalist:</code> Fixed several typos. Removed Game Icon Gauntlet information (going to merge it with revisions) and linked to the revision page where applicable.</li> <li><code>[2019-11-17 22:14] meleu:</code> remove Table of Contents (it was bad formatted)</li> <li><code>[2019-08-08 04:05] Kvon:</code> Badge and Icon Creation; minor typo</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/","title":"Badge and Icons","text":"<ul> <li>Overview</li> <li>Badge Format and Sizes</li> <li>Designing New Badges</li> <li>Uploading Game Icons</li> <li>Uploading Badges</li> <li>Badge Server Files</li> <li>Making New Badges for Existing Achievements</li> <li>To Do</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#overview","title":"Overview","text":"<p>When someone mentions badges, they could be talking about one of two things: - Achievement badges, which are user-created images associated with the individual achievements of a set.   - Sonic the Hedgehog's first Badge - #00199)     -  - Game icons, also known as mastery badges, which is a single image used to represent an achievement set.   - Sonic the Hedgehog's game icon     - </p>"},{"location":"Badge-and-Icon-Guidelines/#badge-format-and-sizes","title":"Badge Format and Sizes","text":"<ul> <li>For best results, game icons and achievement badges should be in 32-bit non-interlaced PNG format.<ul> <li>JPG and GIF are also supported.</li> </ul> </li> <li>Avoid using transparency in the background layer since it will not display properly on the site and emulators.</li> <li>Achievement badges must be 64x64.</li> <li>Game icons must be 96x96.</li> <li>Badges should be made in a way that the subject is clear even when scaled down to 48x48 or 32x32, as they often are on various pages on the site.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#designing-new-badges","title":"Designing New Badges","text":"<p>Achievement badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to. </p>"},{"location":"Badge-and-Icon-Guidelines/#designing-new-game-icons","title":"Designing New Game Icons","text":""},{"location":"Badge-and-Icon-Guidelines/#game-mastery-icons-must-represent-the-associated-game-by-using-official-art-only","title":"Game Mastery Icons must represent the associated game by using 'Official' art only.","text":"<ul> <li>Sprites from the game (or models)</li> <li>Box Art / Regional Box Art</li> <li>Concept Art</li> <li>CD / OST Art</li> <li>Manual Art</li> <li>Guidebook Art</li> <li>Advertisements</li> <li>Or any other 'Official' Source of artwork.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#mastery-icons-must-not","title":"Mastery Icons must not","text":"<ul> <li>Use art from a different port</li> <li>Use fan art sourced from external sources</li> <li>Contain anything vulgar, offensive or pornographic</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#mastery-icons-may","title":"Mastery Icons may","text":"<ul> <li>Add in custom borders or other adornments</li> <li>Stylize official art or combine different official art sources</li> <li>Use official art from a different regional release on the same console, unless that regional release has its own game page entry</li> <li>Use fan art created by the icon creator, but it must be approved by the art team prior to uploading or any icon gauntlet vote.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#exceptions","title":"Exceptions","text":"<ul> <li>If two different ports use the same key art, that art may be used for either port.</li> <li>Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.</li> <li>Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#uploading-game-icons","title":"Uploading Game Icons","text":"<p>Developers: - Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.   - To change a game icon first go to the game page and click on the Dev tools:      - Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted: </p> <p>If a game has existing achievements, game icon changes need to go through revision process.</p> <p>Non-Developers: - Yes, you absolutely can, but they are subject to revisions. It will also be good to review the guidelines for designing new game icons.</p>"},{"location":"Badge-and-Icon-Guidelines/#uploading-badges","title":"Uploading Badges","text":"<p>For Developers:</p> <p>If you are creating new achievements you are free to upload badges for them. </p> <p>Badges are uploaded from within the emulator developer tools while in the achievement editor: </p> <p>Or you can select a prefabricated image or find other images you've uploaded in the drop down box: </p>"},{"location":"Badge-and-Icon-Guidelines/#badge-server-files","title":"Badge Server Files","text":"<ul> <li>Game icons are stored on the site in the following manner and place: <code>i.retroachievements.org/Images/000705.png</code>. They are stored in the same server folder as other game images such as the game box and game screenshots.</li> <li>Achievement badges are stored on site in the following manner and place: <code>i.retroachievements.org/Badge/00136.png</code>; the number coincidences with the badge ID found in the Achievement.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#making-new-badges-for-existing-achievements","title":"Making New Badges for Existing Achievements","text":"<p>If you'd like to make improved badges for existing achievements, you can. Your images will go through the revision process, which will put your creations to a community vote.</p> <p>Post all the new images you'd like to replace current ones in the Icon Gauntlet Forum Topic. Also post all the badges that the new images are meant to replace. They will be placed for a community review by as a single vote. After a community vote is complete if you are a dev you can replace the Badges or if you are not, ask for help in the #help-me channel on Discord or in the Icon Gauntlet Forum Topic.</p> <p>It's easiest to just reference the old and new Badges as <code>img</code> links: - Example: <code>[img=https://retroachievements.org/Badge/01234.png] -&gt; [img=https://retroachievements.org/badge/56789.png]</code> - (Dev) Make sure to capture the old Badge ID from the Achievement Editor before uploading the new Badge - The new Badge ID will appear in the Achievement Editor after uploading it. - Both values can also be captured from the web site, but you have to copy the image links as the hover link is for the achievement.</p> <p>Here is a perfect example of how to effectively post new and old Badges.</p>"},{"location":"Badge-and-Icon-Guidelines/#to-do","title":"To Do","text":"<ul> <li>Needs info on adding achievement badges via the website.</li> <li>Add \"collager\" info.</li> </ul>"},{"location":"Badge-and-Icon-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-21 09:42] The Mystical One:</code> Adding the Mastery Icon to these guidelines.</li> <li><code>[2023-06-03 03:55] televandalist:</code> Created Badge and Icon Guidelines (markdown)</li> </ul>"},{"location":"BitCount-Size/","title":"BitCount Size","text":"<p><code>BitCount</code> is a shortcut for counting the number of bits set in a byte.</p> <pre><code>BitCount Mem 0x1234 == Value 6\n</code></pre> <p>is the same as</p> <pre><code>AddSource Bit0 Mem 0x1234\nAddSource Bit1 Mem 0x1234\nAddSource Bit2 Mem 0x1234\nAddSource Bit3 Mem 0x1234\nAddSource Bit4 Mem 0x1234\nAddSource Bit5 Mem 0x1234\nAddSource Bit6 Mem 0x1234\n          Bit7 Mem 0x1234 == Value 6\n</code></pre> <p>and would be true for <code>0x3F</code> (00111111), <code>0xDB</code> (11011011), <code>0xEE</code> (11101110), etc.</p> <p>Its most common use is counting collectibles for a Measured condition.</p> <p>It can be combined with other flags like Delta.</p> <pre><code>BitCount Mem 0x1234 != BitCount Delta 0x1234\n</code></pre> <p>If you just want to make sure all the bits are set and don't need to worry about some subset of bits being set, you should check for concrete values (i.e. <code>Eight Bit 0x1234 = 0xFF</code> or <code>Lower4 0x1234 = 0x0F</code>).</p> <p>WARNING: BitCount always counts all eight bits in a byte. If you only need 6 or 7 bits, you should use the AddSource chain in case the other bits are used for something else.</p>"},{"location":"BitCount-Size/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-07-09 15:18] RALordAndrew:</code> Double-bracket links do not work on docs.retroachievements.org</li> <li><code>[2021-04-22 09:12] Jamiras:</code> Updated BitCount Size (markdown)</li> <li><code>[2021-04-22 09:06] Jamiras:</code> Updated BitCount Size (markdown)</li> <li><code>[2020-05-17 14:09] Jamiras:</code> add BitCount</li> </ul>"},{"location":"Bonus-Sets-es/","title":"Gu\u00eda para Sets Bonus","text":"<p>Tema Avanzado para Desarrolladores</p>"},{"location":"Bonus-Sets-es/#que-es-un-set-bonus","title":"\u00bfQue es un Set Bonus?","text":"<p>\u00bfSe te ocurren algunos verdaderos retos para retar al jugador mas masoquista mientras dise\u00f1as un set?  O tal vez \u00bfalgunos extras que no est\u00e1n incluidos en el set core?  \u00bfTuviste muchas solicitudes de algo que no encajaba del todo en el set core? RetroAchievements da la bienvenida y motiva todos esos retos y diversi\u00f3n, pero como siempre nos gusta hacerlo de una manera organizada. Puntos Bonus para sets populares es una grandiosa idea!</p>"},{"location":"Bonus-Sets-es/#que-deberia-de-incluir-en-un-set-bonus","title":"\u00bfQue deber\u00eda de incluir en un Set Bonus?","text":"<p>Sets dise\u00f1ados para probar la maestr\u00eda en un juego y proveer nuevos y divertidos retos. Siempre deber\u00edas seguir el estandarte de \"\u00bfEs esto realmente diferente?\" cuando te encuentres haciendo Sets Bonus.</p> <ul> <li>Extras Divertidos: Algunas veces un juego simplemente necesita mas diversi\u00f3n! \u00bfTienes cosas que no se ajustar\u00edan muy bien en un set core?  Un Set Bonus es un buen lugar para ellos.</li> </ul> <ul> <li>Muy retadores: Si generalmente se a escuchado que un logro es demasiado dificil para el jugador casual, este es un candidato principal para un Set Bonus. Ten en cuenta que tambi\u00e9n necesitas limitar la dificultad de un modo que un humano puede obtenerlo. La mayor\u00eda de los jugadores expertos aun no son calidad speed-runners.</li> </ul> <ul> <li>Super Secretos o Secciones de Grindeo: Estos usualmente frustran al jugador casual asta el final. Pero un jugador de un Set Bonus va a disfrutar el reto. Ejemplos:  \"Consigue que todos los personajes llegan hasta el m\u00e1ximo nivel\", \"M\u00e1xima Fuerzo, M\u00e1xima Defensa, Magia en todos los jugadores\", \"P\u00e9gale al objeto X numero de veces\", \"Gana # Mini-Juegos\", \"Consigue X items raros\".</li> </ul>"},{"location":"Bonus-Sets-es/#como-creo-un-set-bonus","title":"\u00bfComo creo un Set Bonus?","text":"<p>Tu obviamente deber\u00edas comentar la idea primero .  Es tu trabajo y una regla que se tiene que cumplir.</p> <p>Actualmente, crear un set Bonus no es f\u00e1cil.  Tienes que b\u00e1sicamente aplicar un hack que no destruya el ROM a una copia de la ROM original y lanzar el parche IPS que incluye las diferencias para que la gente lo pueda disfrutar.  Parchear un ROM con el parcheador IPS es relativamente f\u00e1cil.  Un jugador que disfrute de muchos ROM hacks para probar retos adicionales a de estar bastante acostumbrado.  Sin embargo es algo que tienes que aceptar para lanzar tu Set Bonus, crear un parche no-destructivo.</p> <p>Algunas veces un administrador (as\u00ed como Salsa, que es la cabecilla del proyecto de los Sets Bonus y del creado de parches) puede ser capaz de guiarte por la direcci\u00f3n correcta.  Si tu solamente desarrollas logros, adentrarte en la creaci\u00f3n del parche puede llegar a ser algo complicado y confuso.</p> <p>Si tu eres un programador o un artista y ya estas consiente del uso apropiado de las herramientas de hacking, los pasos se encuentras mas abajo para como generar un parche IPS cosmetico.  Recuerda seguir los lineamientos!</p> <p>NOTA</p> <p>Este meto cambiara cuando los Sets Bonus sea una funci\u00f3n integrada de RetroAchievements.  Mientras tanto puede proveer parches IPS mientras esta funci\u00f3n aun es agregada.</p>"},{"location":"Bonus-Sets-es/#paso-1-obten-el-juego-original","title":"Paso 1 - Obt\u00e9n el juego original","text":"<p>El primer paso para dise\u00f1ar un Set Bonus es conseguir el ROM original del juego.  Recuerda que nosotros no podemos proveer un m\u00e9todo descarga para eso.  \u00bfYa tienes tu Dumpeador/Extractor de ROMs a la mano?</p>"},{"location":"Bonus-Sets-es/#paso-2-crea-una-copia-del-rom-original","title":"Paso 2 - Crea una copia del ROM original","text":"<p>Este es el archivo que vas a utilizar para editar para convertirlo en el ROM para tu set Bonus</p>"},{"location":"Bonus-Sets-es/#paso-3-agarra-un-editor-hexadecimal-o-una-herramienta-de-modificacion-de-sprites-sprite-hacking-tool","title":"Paso 3 - Agarra un editor hexadecimal o una herramienta de modificaci\u00f3n de sprites (sprite-hacking tool).","text":"<p>Puedes saltarte este paso si es que ya cuentas con uno.  Algunos juegos ya cuenta con herramientas de hackeo especializadas.  Algunas de ellas se encuentran aqu\u00ed disponibles en github, y tambi\u00e9n hay bastantes de ellas en  ROMHacking.net, que esto aria tu trabajo aun mas f\u00e1cil.  Vas a necesitar un editor mas gen\u00e9rico si el juego no cuenta con una herramienta.  La edici\u00f3n tiene que ser lo suficiente para que se puede crear un nuevo MD5sum para el archivo del ROM.  Herramientas para editar tu ROM pueden ser encontradas en la Pagina de Utilidades de ROMHacking.net's. </p> <p>Aqu\u00ed hay algunas b\u00fasquedas que te podr\u00edan resultar \u00fatiles:</p> <ul> <li>Sprite Hacking tools - ROMHacking.net Filtered Search</li> <li>Texto y Editores Hex - ROMHacking.net Filtered Search</li> </ul>"},{"location":"Bonus-Sets-es/#paso-4-siguiendo-las-reglas-y-editando","title":"Paso 4 - Siguiendo las Reglas y Editando!","text":"<p>Por favor \u00e9chale a la sesi\u00f3n de Parches Cosm\u00e9ticos para Sets Bonus de los lineamientos del Linkeado de ROMs para mas informaci\u00f3n.</p> <p>ESTE PASO REQUIERE PEDIR APROBACI\u00d3N ANTES DE SEGUIR AVANZANDO</p> <p>Es algo integro que solicites una aprobaci\u00f3n antes de agregar/linkear cualquier cosa a RetroAchievements.  Es tu trabajo y es parte del C\u00f3digo de Conducta del Desarrollador de RetroAchievements.</p>"},{"location":"Bonus-Sets-es/#paso-5-agrega-el-md5-al-nuevo-set-bonus","title":"Paso 5 - Agrega el MD5 al nuevo Set Bonus","text":"<p>Despu\u00e9s de recibir la aprobaci\u00f3n, carga tu ROM parcheado en un Emulador de RA, y sigue las instrucciones de como linkear tu nuevo Set Bonus a tu ROM en el sitio web.  Si tu juego produce un MD5 igual al de otro juego, procura hacer mas modificaciones al ROM para que este genere un MD5 nuevo otra vez y lo cargue como un juego nuevo.</p>"},{"location":"Bonus-Sets-es/#paso-6-modifica-la-pagina-de-detalles-del-set","title":"Paso 6 - Modifica la pagina de detalles del set","text":"<p>Navega por tu perfil de usuario y procede a la nueva pagina de tu juego que deber\u00eda de aparecer ahora.  Puedes editar los detalles del juego, capturas de pantalla, e informaci\u00f3n desde el panel de Dev Options en la nueva pagina del set.</p> <p>PREG\u00daNTALE A UN ADMINISTRADOR PARA QUE RESE\u00d1E TU TRABAJO DESPU\u00c9S QUE HUBIERAS COMPLETADO ESTE PASO</p>"},{"location":"Bonus-Sets-es/#paso-7-crea-logros-para-el-set-anuncialo-y-lanzalo","title":"Paso 7 - Crea logros para el set, an\u00fancialo y l\u00e1nzalo.","text":"<p>Ahora ya puedes empezar a desarrollar logros para tu Set Bonus.  Cuando termines, anuncia tu set e incluye tu parche IPS en el tema del foro despu\u00e9s de a ver pasado los logros a Core.  Actualmente los miembros necesitan aplicar tu parche al juego original as\u00ed como lo hiciste en tus pruebas para que ellos puedan jugar tu Set Bonus.  No esta permitido lanzar el ROM parcheado en si.  Tu tienes que SOLAMENTE lanzar el Parche IPS para cumplir con los lineamientos del sitio de no compartir p\u00fablicamente material con derechos de autor/copyright en RetroAchievements).</p>"},{"location":"Bonus-Sets-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-21 11:01] eldexterr:</code> Updated Bonus Sets es (markdown)</li> <li><code>[2019-05-21 11:00] eldexterr:</code> Created Bonus Sets es (markdown)</li> </ul>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame-es/","title":"Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame","text":"<p>En este ejemplo veras como evitar el problema de que un contador se incremente dos veces en el mismo frame combinando un SubSource y AddHits.</p> <p>En la libreria del Game Boy Advance hay un plataformero Navide\u00f1o conocido como Santa Claus Jr. Advance. Hay algunos logros de coleccionar varios dulces en cada uno de los Stages Bonus.</p> <p>Esos logros se suponen que tendrian que ser algo simple, como esto:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xDULCES != Delta 0xDULCES (N) 2 ResetIf 0xSTAGE != Value 0xBONUS <p>Esto se traducir\u00eda \"checa si el contador de dulces cambio <code>N</code> veces en el stage bonus\".</p> <p>Nota: estamos utilizando <code>0xDULCES != Delta 0xDULCES</code> (utilizando <code>!=</code>, y no <code>&gt;</code>) porque cuando el jugador cuenta con 99 dulces y colecciona uno mas el contador se va a cero.</p> <p>Sin embargo, hay un aspecto en este juego (y muchos otros) donde si el jugador colecciona 2 dulces a la vez el contador va a aumentar por 2 en el mismo frame. Cuando pasa el contador de hits es aumentado por uno mientras que el contador de dulces aumento en dos. Esto, obviamente, arruina la l\u00f3gica que utilizamos arriba.</p> <p>En manera que podamos evitar este problema tenemos que utilizar la t\u00e9cnica de utilizar <code>SubSource</code> para contar incrementos espec\u00edficos combinado con una   <code>AddHits</code> flag.</p> <p>Echemos un vistazo a la l\u00f3gica del logro y as\u00ed poder ver la explicaci\u00f3n:</p> <p>Variables (Addresses)</p> <ul> <li><code>0x80dc</code>: Contador de Dulces.</li> <li><code>0x809c</code>: ID de Stage.</li> </ul> <p>As\u00ed que ahora la estructura de logro seria de esta manera:</p> <p></p> <p>Condiciones</p> <ol> <li> <p>Junto con la condici\u00f3n 2, es un truco para ver si <code>0xDULCES - Delta 0xDULCES = 2</code>. En otras palabras, el contador de dulces fue incrementado por dos.</p> </li> <li> <p>Utilizando a la vez con la condici\u00f3n 1 (como se explica arriba) y 3. Como se explica en su respectiva pagina, cuando la condici\u00f3n de <code>AddHits</code> es verdadera, el hit counter en la siguiente condici\u00f3n es incrementado. Entonces , en nuestro ejemplo de aqu\u00ed, cuando condici\u00f3n 2 es verdadera, el hitcounter en condici\u00f3n 3 es incrementado.</p> </li> <li> <p>Contador cuando el contador de dulces cambia.</p> </li> <li> <p>Resetear contador si no se encuentra en un Stage Bonus.</p> </li> </ol> <p>Todas esta condiciones se pueden traducir como \"mientras est\u00e9s en un stage bonus, salta el logro si el contador de dulces cambia 99 veces, y si el contador de dulces es incrementado por 2 en el mismo frame, a\u00f1ade un cambio extra al contador de dulces.\"</p>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:33] meleu:</code> fix broken links</li> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Circumvent-the-Problem-of-a-Counter-Incrementing-Twice-in-the-Same-Frame/","title":"Circumvent the Problem of a Counter Incrementing Twice in the Same Frame","text":"<p>In this example you'll see how to circumvent the problem of a counter incrementing twice in the same frame by combining SubSource and AddHits.</p> <p>In the Game Boy Advance library there's a Christmas platformer game called Santa Claus Jr. Advance. There are some achievements for collecting all candy canes in each one of the bonus stages.</p> <p>Such achievements were supposed to be quite simple, like this:</p> ID Special? Memory Cmp Type Mem/Val Hits 1 0xCANDIES != Delta 0xCANDIES (N) 2 ResetIf 0xSTAGE != Value 0xBONUS <p>This translates into \"check if the candy canes counter changed <code>N</code> times in the bonus stage\".</p> <p>Note: we're using <code>0xCANDIES != Delta 0xCANDIES</code> (using <code>!=</code>, and not <code>&gt;</code>) cause when the player has 99 candies and collect one more, the counter goes to zero.</p> <p>However, there is an aspect in this game (and many others) where if the player collect 2 candy canes simultaneously the counter is increased by 2 in the same frame. When it happens the hit counter is increased by one while the candy counter is increased by two. This, obviously, ruins the logic used above.</p> <p>In order to circumvent this issue we have to use that technique of using <code>SubSource</code> to count specific increments combined with the <code>AddHits</code> flag.</p> <p>Let's take a look at the achievement logic and then we'll see the explanation:</p> <p>Addresses</p> <ul> <li><code>0x80dc</code>: Candy Canes counter.</li> <li><code>0x809c</code>: Stage ID.</li> </ul> <p>So now the structure of the achievement is going to be like this:</p> <p></p> <p>Conditions</p> <ol> <li> <p>Together with condition 2, is a trick used to check if <code>0xCANDIES - Delta 0xCANDIES = 2</code>. In other words, the candy counter was incremented by two.</p> </li> <li> <p>Used together with condition 1 (as explained above) and 3. As explained in its respective page, when the <code>AddHits</code> condition is true, the hit counter in the next condition is incremented. Therefore, in our example here, when condition 2 is true, the hitcounter in condition 3 is incremented.</p> </li> <li> <p>Count when the candy counter changes.</p> </li> <li> <p>Reset the counter if not in the Bonus stage.</p> </li> </ol> <p>All these conditions could be translated as \"while in the bonus stage, trigger the achievement if the candy counter changes 99 times, and if the candy counter is incremented by 2 in the same frame, count an extra change in the candy counter.\"</p> <p>So, now it is 100% solved, right? Well, actually, almost. There is still a very minor exception. Remember it was said before that <code>!=</code> was being used instead of <code>&gt;</code> because <code>when the player has 99 candies and collect one more, the counter goes to zero</code>?</p> <p>This means that, if we get two canes in the same frame (which is already rare), there's a very small possibility that this change will be from <code>98 -&gt; 00</code> or from <code>99 -&gt; 01</code>. In these only two cases our code won't work, because <code>00 - 98</code> is not 2, it is <code>-98</code>. Same thing for <code>01 - 99</code>, it is not 2, it is also <code>-98</code>.</p> <p>Despite being a very unlikely possibility, we should treat this case too. So we're gonna add two more requirements to the code, and it will end up looking like this:</p> <p></p> <p>It is the same as before, with the only changes being lines 3 and 4, which represents an extra <code>SubSource + Add Hits</code> to check if <code>0xCANDIES - Delta 0xCANDIES = -98</code>, only to take care of this very minor exception just mentioned.</p> <p>And now it is solved!</p>"},{"location":"Claims-System/","title":"Claims System","text":"<ul> <li>Claims System Guidelines</li> <li>Making a Claim</li> <li>Dropping a Claim</li> <li>Extending a Claim</li> <li>How to Complete a Claim</li> <li>Collaboration Claims</li> <li>Viewing Claim Info</li> <li>Claim Allotment</li> <li>Important Notes</li> </ul>"},{"location":"Claims-System/#claims-system-guidelines","title":"Claims System Guidelines","text":"<ul> <li>The right to work on a set is made by utilizing the site's Claim System. This is the only valid way to reserve a set. Posting plans in the forum, leaving code notes, telling everyone you want to work on it, or any other forms of declaration are not considered valid claims.</li> <li>Claims should be made as soon as you want to start working on a set, not as you are finishing your work.</li> <li>Do not claim sets that you are not actually interested in working on and especially do not do it just to block others from working on it.</li> <li>Only claim games when you are free of unaddressed tickets. If you are not, a prompt will appear when attempting to claim a set.</li> </ul>"},{"location":"Claims-System/#making-a-claim","title":"Making a Claim","text":"<p>To make a claim, go to the Developer panel of a game entry, which will contain one of the following links: - Make Claim - Make Claim and Forum Topic (Junior Developers require a forum topic to be made on their behalf) - Make Revision Claim - Make Collaboration Claim - Make Collaboration Revision Claim</p>"},{"location":"Claims-System/#dropping-a-claim","title":"Dropping a Claim","text":"<p>Dropping a claim is as simple as selecting the \"Drop Claim\" link in the Developer panel.</p>"},{"location":"Claims-System/#extending-a-claim","title":"Extending a Claim","text":"<ul> <li>When a claim is within a week of expiring, an \"Extend Claim\" link will become available. Selecting it will extend the claim an additional three months.</li> <li>Progress Reporting: Prior to extending a claim, post your progress in a new forum post. Progress should comment on RAM digging/code notes, a roadmap of achievements and your progress towards them. As further extensions are made, reports are expected to become more detailed and development priority is expected to increase.<ul> <li>At Developer Compliance discretion, additional requirements may be given if there is insufficient progress during a claim period, including claim drop. Game length, total claim duration, and other considerations will factor into any decision.</li> <li>Prior to the 3rd extension (the one-year mark) and all subsequent extensions, a thorough progress report must be made and the progress report must also be sent to Developer Compliance for consideration in allowing the extension.</li> <li>Any claim with no progress during the standard claim duration (3 months since claim/extension) may be subject to a claim drop.</li> </ul> </li> <li>Once a claim has expired, the set is available to be claimed by another developer.</li> <li>If a reservation reaches the point where it's more than a year old, a detailed progress report must be sent to <code>Developer Compliance</code> for subsequent renewals. The report should provide an overview of the development situation and include details such as:<ul> <li>List of planned achievements</li> <li>List of achievements already coded (local or unofficial)</li> <li>Memory digging status</li> <li>Progress of badges creation</li> <li>Rich Presence and Leaderboards Status (if applicable)</li> </ul> </li> <li>If the renewal is denied or dropped due to no-progress, a cooldown of one month will be applied. After this period, the developer may reserve the set again, if available. Detailed progress reports will continue to be required for any further renewals.</li> <li>If a claim is dropped and resumed in within a month, the initial claim date before dropping the set will be maintained.</li> </ul>"},{"location":"Claims-System/#how-to-complete-a-claim","title":"How to Complete a Claim","text":"<p>To mark a claim as complete, you can select the \"Complete Claim\" link in the Developer panel. Doing so will free the claim slot and notify users who have a set request for the game, via email, that new achievements have been added for that game.</p> <p>When selecting \"Complete Claim\" within 24 hours of making the claim, a prompt will inform the developer that they should have approval before marking it as complete. Approval must be from someone on the Developer Compliance team.</p>"},{"location":"Claims-System/#collaboration-claims","title":"Collaboration Claims","text":"<p>Collaboration claims are made when there is already a primary claim on a game and acts as a \"child\" of said primary claim. It will inherit the primary claim's expiration date. Extending or completing a collaboration claim can only be done by the developer with the primary claim.</p> <ul> <li>Let others know if you welcome collaborators.</li> <li>If you have claimed a set and someone expresses desire to work on it beyond suggesting ideas, consider ways in which you can collaborate with them.</li> <li>If someone claims a set that you were interested in, do not get frustrated. You are encouraged to contact the developer and request a collaboration. If denied, you have the option of presenting a revision plan after the set is published.</li> </ul>"},{"location":"Claims-System/#viewing-claim-info","title":"Viewing Claim Info","text":"<p>There are several ways to view claim information: - Every game entry will show if it has a claim or not - A developer's profile will show which claims they currently have active. - The site navbar contains <code>New Sets &amp; Revisions</code>, <code>Sets in Progress</code>, <code>My Claims</code>, and <code>Expiring Claims</code>. - The set request list will show if a game has an active claim.</p>"},{"location":"Claims-System/#claim-allotment","title":"Claim Allotment","text":"<p>Each developer is allowed four primary claims. Junior developers are allowed one primary claim. However, the following claim types can be marked as free claims and therefore will not take up a slot: - Claims made specifically for console rollouts. This is due to the unpredictable nature of rollouts as well as a way to reduce stress/pressure on developers. - If a developer makes a revision or subset claim, the claim can be set to \"Own Revision\" depending on criteria I haven't copy-pasted into this section yet. - Collaboration claims.</p>"},{"location":"Claims-System/#important-notes","title":"Important Notes","text":"<ul> <li>It is recommended that you post a complete plan in the forum topic. When doing so, be open to suggestions; you can get excellent input and suggestions this way.</li> </ul>"},{"location":"Claims-System/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-07 16:40] The Mystical One:</code> Updated Claims System (markdown)</li> <li><code>[2024-02-02 13:08] The Mystical One:</code> Updated emphasis on new forum post.</li> <li><code>[2024-02-02 13:07] The Mystical One:</code> Removed a redundancy where the 'one month' cooldown unnecessarily appeared twice.</li> <li><code>[2024-01-26 09:08] The Mystical One:</code> Updated Claims System (markdown)</li> <li><code>[2024-01-26 08:56] The Mystical One:</code> Added new claims enforcement rules, including requirement to comment on progress prior to extending a claim, and clearer guidelines for what to do at the one-year mark.</li> <li><code>[2023-06-05 18:08] televandalist:</code> Typos</li> <li><code>[2023-06-04 19:37] televandalist:</code> Added the notes under the section for collaboration claims. These were taken from the DevCoC and slightly reworded.</li> <li><code>[2023-06-03 04:56] televandalist:</code> Updated Claims System (markdown)</li> <li><code>[2023-06-03 04:39] televandalist:</code> Updated Claim System (markdown)</li> </ul>"},{"location":"Code-Notes/","title":"Code Notes","text":""},{"location":"Code-Notes/#code-notes","title":"Code Notes","text":"<p>Code notes are a vital part of achievement development. They provide valuable context to memory addresses used in achievement creation. Good code notes can make future achievement troubleshooting a breeze for developers, while bad code notes can make it a nightmare. This guide will help developers create clear, helpful, and consistent code notes that can be used by any developer looking at their sets in the future.</p>"},{"location":"Code-Notes/#how-to-make-code-notes","title":"How to Make Code Notes","text":"<p>Code notes are made by the developer in the Memory Inspector as they are RAM digging a game. This allows for easily seeing where sizes of notable addresses as well as areas in the RAM that hold important values. Code notes can be added, deleted and updated from the Memory Inspector. Code notes that are already created can be updated or deleted from the games' \"Code Notes\" page on the website. This is intended for quick fixes to notes and not intended as the main form of code note modification.</p> <ul> <li>Developers are free to add any code notes to any game without declaring intentions to work on the game. Just be careful to not delete previous notes added by someone else unless you are certain they are incorrect.</li> <li>Junior Developers shall limit their code notes to the game they have claimed. Juniors are unable to delete or overwrite notes made by other users.</li> </ul>"},{"location":"Code-Notes/#recommendations","title":"Recommendations","text":"<ul> <li>Be Clear and Informative: Code notes should clearly document what the address represents such that it can easily be understood by other developers.</li> <li>Specify the Address Size: Code notes should specify the size of the address being noted. This helps to easily know the address size during achievement logic creation and also to correctly color the address values within the Memory Inspector.</li> <li>Include Important Values: Code notes should include all values that are used within the achievement logic. Undocumented values make debugging much more complicated, especially if you didn't create the note.</li> <li>Document Extensively: It's better to document any useful addresses that you find, even if you know you won't need them in the achievement logic. You never know what addresses may be needed later on if the set is revised.</li> </ul>"},{"location":"Code-Notes/#specifying-memory-addresses-size","title":"Specifying Memory Addresses Size","text":"<p>There are multiple ways to specify a memory address that will be recognized by the Memory Inspector highlighting. Any code note that does not specify a valid size will cause the Memory Inspector to highlight the byte the note is for. Any number of bit and byte lengths will be recognized by the Memory Inspector highlighting. Many developers will enclose the address size in square brackets (<code>[]</code>) to make it more noticeable in the full note.</p> <ul> <li><code>[Lower4]</code>, <code>[Upper4]</code></li> <li><code>[8-bit]</code>, <code>[16-bit]</code>, <code>[24-bit BE]</code>, <code>[32-bit]</code>, <code>[Float]</code></li> <li><code>[1 byte]</code>, <code>[2 bytes]</code>, <code>[4 bytes]</code>, <code>[8-bytes]</code></li> <li><code>[128 bits]</code>, <code>[78 bytes]</code>, <code>[428 bits]</code>, <code>[1024 bytes]</code></li> </ul>"},{"location":"Code-Notes/#bit-fields-and-bit-flags","title":"Bit Fields and Bit Flags","text":"<p>Very often you will run into an address that uses each bit within the address to store data. Noting the individual bits won't affect any Memory Inspector highlighting, though each bit should be properly noted in the code note. Some people choose to mark the size for these as [Bitfield] or [Bitflags] instead of [8-Bit].</p>"},{"location":"Code-Notes/#adding-values-and-labels","title":"Adding values and labels.","text":"<p>When you need to label specific values or bit meanings in a note, here are some things to keep in mind.</p> <ul> <li>Always prefix hexadecimal values with <code>0x</code> so that it is clear the value is in hex. This is especially important if none of your values use characters A-F.</li> <li>If values are in decimal, consider putting a note in the description to this effect: <code>(Values below are decimal)</code></li> <li>Put each value on a separate line - This is usually the easiest way to visually distinguish each value. You should usually use this when there are more than two values to label.</li> <li>If there are only two values (Example: Yes/No), consider placing them inline with the description, if the description and labels are short.</li> <li>Put a separator between the value and its label. This can be an equals sign, a colon, or a dash, and you may put whitespace as needed. Tip: Using an equals sign without spaces lets you easily copy the value list into a Rich Presence lookup.</li> </ul>"},{"location":"Code-Notes/#examples","title":"Examples","text":""},{"location":"Code-Notes/#simple-types","title":"Simple Types","text":"<p>Simple address types cover the very basic address that are needed for nearly every achievement set and are often the some of first addresses noted when RAM digging. Often easily described in a line or two. These may include health, lives, in game currency, level, X/Y positions, etc...</p>"},{"location":"Code-Notes/#good-examples","title":"Good Examples","text":"<p>Good examples here include size, description, and different values or affects on the values.</p> <pre><code>[8-bit] Difficulty\n0x01 - Easy\n0x02 - Normal\n0x03 - Hard\n</code></pre> <pre><code>[16-bit] Player Health\nMax health is 0x1200, each hit reduces it by 0x8\n</code></pre>"},{"location":"Code-Notes/#bad-examples","title":"Bad Examples","text":"<pre><code>Difficulty\n</code></pre> <pre><code>health\n</code></pre>"},{"location":"Code-Notes/#map-or-screen-id-types","title":"Map or Screen ID Types","text":"<p>Map and Screen ID type code notes are very often used to determine location within the game and commonly used in level completion or item collection achievements.</p>"},{"location":"Code-Notes/#good-example","title":"Good Example","text":"<p>Good examples here include the various values that the address can take throughout the game. All addresses used in the achievement logic are noted in detail.</p> <pre><code>[8-bit] Screen ID\nChapter I\n0x36 - Initial Screen with woman's face\n0x0b - Taxi ride opening scene\n0x07 - Outside of apartment (Day 1)\n0x04 - Apartment main hall (Day 1)\n0x16 - Apartment main hall (Day 2)\n\nChapter II\n0x37 - Driving intro cutscene\n0x2b - Outside of Inn (Day 1)\n0x2c - Inn main room (Day 1)\n</code></pre>"},{"location":"Code-Notes/#bad-example","title":"Bad Example","text":"<pre><code>screen id\n</code></pre>"},{"location":"Code-Notes/#scores","title":"Scores","text":"<p>There are numerous way a game can store the players scores with memory, as such there are numerous ways to write the score code note out.</p>"},{"location":"Code-Notes/#good-examples_1","title":"Good Examples","text":"<p>Good examples here will specify the size, which digits of the score are being represented, how the on screen score is calculated from the value in memory, Binary Coded Decimal (BCD) notation if applicable, as well any any other important details.</p> <pre><code>[1 byte] 1P display score, digits 0000XX00 in BCD\n</code></pre> <pre><code>[16bit][DEC] P2 Score XXXX0000\n</code></pre> <pre><code>Score [24-Bit BE BCD] (Determines Rank)\n0-9=Pauper\n0-99=Peasant\n100-999=Prosperous\n1000+=Professional\n</code></pre>"},{"location":"Code-Notes/#bad-example_1","title":"Bad Example","text":"<pre><code>Player 1 score\n</code></pre>"},{"location":"Code-Notes/#bits","title":"Bits","text":"<p>It's very common to run into games that need to store event or item flags. Often these will be stored as individual bits rather than taking up an entire byte per flag. It's assumed that a bit value of 0 is off/no/false, if this is not the case then that should be noted.</p>"},{"location":"Code-Notes/#good-examples_2","title":"Good Examples","text":"<p>Good examples here will specify each bit as well as what they represent.</p> <pre><code>[Bitflags] Requests completed\nBit1 = No. 01 - Retrieve 1 Beetle Shell.\nBit2 = No. 02 - Retrieve the first old document.\nBit3 = No. 03 - I'd like to sip a Muscle Drink.\nBit4 = No. 04 - Retrieve 3 Old Lanterns.\nBit5 = No. 05 - Retrieve the second old document.\nBit6 = No. 06 - Create Jack Frost with Dia.\nBit7 = No. 07 - Retrieve 1 Lead Metal.\n</code></pre> <pre><code>Bonuses Unlocked\nbit0 - All Replay Items\nbit1 - Unlimited Ammo (Mission 1)\nbit2 - Silver Bullets (Mission 3)\nbit3 - Bullet Shield (Mission 4)\nbit4 - Rubber Grenades\nbit5 - Men With Hats (Mission 5)\nbit6 - Always Sniper\nbit7 - Achilles Head (Mission 6)\n</code></pre> <pre><code>[Treasure Flags 03]\nBit0=[Altair - Rebel Hideout] Potion\nBit1=[Fynn - Pub Basement] Scott's Ring\nBit2=[Castle Deist 1F - South Treasure Room] Stun Tome\nBit3=[Castle Deist 1F - South Treasure Room] Stop Tome\nBit4=[Castle Deist 1F - South Treasure Room] Curse Tome\nBit5=[Cave of Mysidia B4 - Treasure Room] Bell of Silence\nBit6=[Castle Deist 1F] Phoenix Down\nBit7=[Castle Deist 1F - NW Treasure Room] Gold Needle\n</code></pre>"},{"location":"Code-Notes/#bad-example_2","title":"Bad Example","text":"<pre><code>The bits here represent the unlocked bonuses\n</code></pre>"},{"location":"Code-Notes/#pointers","title":"Pointers","text":"<p>Pointers are more commonly found in newer consoles and their notes typically include information for various addresses that the pointer can point to. The pointer notes will typically include numerous offset values to the important addresses used by the developer.</p> <ul> <li>If offsets with labels are written correctly, the memory inspector and assets editor will generate indirect code notes at the pointer address + offset of the correct size.</li> <li>Use a plus sign <code>+</code> before the offset value.<ul> <li>For pointers with multiple layers, many people will use additional pluses to indicate that it is an offset of a pointer being pointed to by the original pointer. However, this will break all indirect code notes for that pointer. Consider using a vertical pipe before these layered offsets instead to allow for the top layer to generate indirect code notes.</li> </ul> </li> <li>Use <code>0x</code> to indicate a hexadecimal offset value; the memory inspector will treat it as a decimal offset if this is not present.</li> <li>You can separate the offset value and its label with any number of spaces, and a separator character like an equals sign, a colon, or a vertical pipe.</li> <li>You should specify the size of the data at the offset like any normal code note. Indirect notes and highlighting will use this.</li> <li>If multiple lines are present after the offset value, they will all be part of the indirect note for that address.</li> </ul>"},{"location":"Code-Notes/#good-examples_3","title":"Good Examples","text":"<p>Good examples here will include various address offsets, each of which including details and size of the address being pointed to.</p> <pre><code>Pointer to P1 Data [16-Bit]\n+0x68 P1 Character ID [8-Bit]\n+0xba P1 Health [8-Bit]\n+0xc4 P1 Move ID [16-Bit]\n</code></pre> <pre><code>[32-bit] Data Pointer\n+0x638 | Pointer to pointer to smells pointer\n++0x6d0 | Pointer to woofs\n+++0xb8 | Total Woofs [32-bit]\n+++0x380 | Sniff Level [32-bit]\n0x00 = Sniff Apprentice\n0x01 = Sniff Artisan\n0x02 = Sniff Expert\n0x03 = Sniff Master\n0x04 = Grand Sniff Master\n+++0x3c8 | Pointer to Racing Data [32-bit]\n++++0x15a8 | Checkpoint Count [32-bit]\n++++0x15ac | Frame Timer [32-bit]\n++0x13d8 | Pointer to smells pointer\n+++0x04 | Total Smells [32-bit]\n</code></pre> <pre><code>*US* Pointer [32-bits]\n\n--Player Kratos--\n+0x97898=Health [Float]\n+0x6f570=Combo [32-bits]\n+0x977a0=Coordinates Y [Float]\n+0x977a4=Coordinates Z [Float]\n+0x977a8=Coordinates X [Float]\n\n--Unlockables (Alternative)--\n+0x6f594=Poseidon's Trident [Bit0]\n+0x6f598=Poseidon's Rage [Bit0]\n+0x6f59c=Medusa's Gaze [Bit0]\n+0x6f5a0=Zeus' Fury [Bit0]\n+0x6f5a4=Army of Hades [Bit0]\n+0x6f5a8=Blade of Artemis [Bit0]\n</code></pre>"},{"location":"Code-Notes/#bad-example_3","title":"Bad Example","text":"<pre><code>Pointer for player information. Includes player data and unlockables.\n</code></pre>"},{"location":"Code-Notes/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:08] Andrew Comer:</code> Updated Code Notes (markdown)</li> <li><code>[2024-03-11 14:03] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:57] Andrew Comer:</code> Updated Code Notes (markdown)</li> <li><code>[2024-03-11 13:53] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:14] Andrew Comer:</code> Removed WIP header</li> <li><code>[2024-01-15 13:27] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-10 07:05] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 16:36] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 16:33] The Mystical One:</code> Updated Code Notes (markdown)</li> <li><code>[2024-01-09 15:29] The Mystical One:</code> Added another score example to replace the one that was removed.</li> </ul>"},{"location":"Code-Review-Checklist/","title":"Code Review Checklist","text":"<p>This is a list of things that code reviewers usually check when someone submits a set to be reviewed.</p>"},{"location":"Code-Review-Checklist/#code-notes","title":"Code Notes","text":"<ul> <li>[ ] Clearly written. Example</li> <li>[ ] For all addresses used in logic</li> <li>[ ] Describing appropriate values used where applicable</li> </ul>"},{"location":"Code-Review-Checklist/#achievement-logic","title":"Achievement Logic","text":"<ul> <li>[ ] No achievements with only one condition.</li> <li>[ ] Demo mode protection (when applicable).</li> <li>[ ] Cheat codes protection (when applicable).</li> <li>[ ] No redundant logic (like <code>0xADDRESS = 1</code> and <code>ResetIf 0xADDRESS != 1</code>).</li> <li>[ ] Understanding the difference and the right use of PauseIf and ResetIf.</li> <li>[ ] On a \"get 100 coins\" like achievement, use <code>&gt;= 100</code> rather than <code>= 100</code>.</li> </ul>"},{"location":"Code-Review-Checklist/#achievement-design","title":"Achievement Design","text":"<ul> <li>[ ] No unwelcome concepts.</li> <li>[ ] Achievements for \"Finish level N\" rather than \"Reach level N+1\".</li> <li>[ ] No \"two for one\" achievements (like one for defeating a boss and another one for getting the dropped item).</li> </ul>"},{"location":"Combining-Flags-es/","title":"Combinando Banderas","text":"<p>Un <code>ResetIf</code> y <code>PauseIf</code> pueden ser aplicados al numero que sea de condiciones <code>Add Hits</code>, <code>Add Source</code>, y <code>Sub Source</code>.</p> <p>Volviendo al ejemplo del <code>Add Source</code> de arriba, si un <code>ResetIf</code> se aplicara a la condicion 2, el logro se reiniciar\u00eda porque <code>1 + 2 &gt; 0</code>.</p>"},{"location":"Combining-Flags-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:34] meleu:</code> fix broken link</li> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Combining-Flags/","title":"Combining Flags","text":"<p><code>ResetIf</code> and <code>PauseIf</code> can be applied to a condition following any number of <code>Add Hits</code>, <code>Add Source</code>, or <code>Sub Source</code> conditions. </p> <p>Going back to the <code>Add Source</code> example above, if <code>ResetIf</code> were applied to condition 2, the achievement would reset because <code>1 + 2 &gt; 0</code>.</p>"},{"location":"Condition-Syntax/","title":"Condition Syntax","text":""},{"location":"Condition-Syntax/#memory-sizes","title":"Memory sizes","text":"Size Prefix Example Bit0 <code>0xM</code> <code>0xM01234</code> Bit1 <code>0xN</code> <code>0xN01234</code> Bit2 <code>0xO</code> <code>0xO01234</code> Bit3 <code>0xP</code> <code>0xP01234</code> Bit4 <code>0xQ</code> <code>0xQ01234</code> Bit5 <code>0xR</code> <code>0xR01234</code> Bit6 <code>0xS</code> <code>0xS01234</code> Bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x 01234</code> 24bit <code>0xW</code> <code>0xW01234</code> 32bit <code>0xX</code> <code>0xX01234</code> 16bit BE <code>0xI</code> <code>0xI01234</code> 24bit BE <code>0xJ</code> <code>0xJ01234</code> 32bit BE <code>0xG</code> <code>0xG01234</code> BitCount <code>0xK</code> <code>0xK01234</code> Float <code>fF</code> <code>fF01234</code> MBF32 <code>fM</code> <code>fM01234</code>"},{"location":"Condition-Syntax/#prefixes","title":"Prefixes","text":"Modifier Prefix Example Delta <code>d</code> <code>d0xH1234</code> Prior <code>p</code> <code>p0xH1234</code> BCD <code>b</code> <code>b0xH1234</code> Invert <code>~</code> <code>~0xH1234</code>"},{"location":"Condition-Syntax/#logical-flags","title":"Logical Flags","text":"Flag Prefix Example ResetIf <code>R:</code> <code>R:0xH1234=1</code> ResetNextIf <code>Z:</code> <code>Z:0xH1234=1</code> PauseIf <code>P:</code> <code>P:0xH1234=1</code> AndNext <code>N:</code> <code>N:0xH1234=1</code> OrNext <code>O:</code> <code>O:0xH1234=1</code> AddSource <code>A:</code> <code>A:0xH1234=1</code> SubSource <code>B:</code> <code>B:0xH1234=1</code> AddHits <code>C:</code> <code>C:0xH1234=1</code> SubHits <code>D:</code> <code>D:0xH1234=1</code> AddAddress <code>I:</code> <code>I:0xH1234=1</code> Measured <code>M:</code> <code>M:0xH1234=1</code> Measured% <code>G:</code> <code>G:0xH1234=1</code> MeasuredIf <code>Q:</code> <code>Q:0xH1234=1</code> Trigger <code>T:</code> <code>T:0xH1234=1</code>"},{"location":"Condition-Syntax/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-03-05 08:16] Jamiras:</code> Updated Condition Syntax (markdown)</li> <li><code>[2022-02-04 17:32] Jamiras:</code> Created Condition Syntax (markdown)</li> </ul>"},{"location":"Console-ID-List/","title":"Console ID List","text":"Console ID Name Supported? 001 Mega Drive Yes 002 Nintendo 64 Yes 003 SNES Yes 004 Game Boy Yes 005 Game Boy Advance Yes 006 Game Boy Color Yes 007 NES Yes 008 PC Engine Yes 009 Sega CD Yes 010 32X Yes 011 Master System Yes 012 PlayStation Yes 013 Atari Lynx Yes 014 Neo Geo Pocket Yes 015 Game Gear Yes 016 GameCube 017 Atari Jaguar Yes 018 Nintendo DS Yes 019 Wii 020 Wii U 021 PlayStation 2 Yes 022 Xbox 023 Magnavox Odyssey 2 Yes 024 Pokemon Mini Yes 025 Atari 2600 Yes 026 DOS 027 Arcade Yes 028 Virtual Boy Yes 029 MSX Yes 030 Commodore 64 031 ZX81 032 Oric 033 SG-1000 Yes 034 VIC-20 035 Amiga 036 Atari ST 037 Amstrad CPC Yes 038 Apple II Yes 039 Saturn Yes 040 Dreamcast Yes 041 PlayStation Portable Yes 042 Philips CD-I 043 3DO Interactive Multiplayer Yes 044 ColecoVision Yes 045 Intellivision Yes 046 Vectrex Yes 047 PC-8000/8800 Yes 048 PC-9800 049 PC-FX Yes 050 Atari 5200 051 Atari 7800 Yes 052 X68K 053 WonderSwan Yes 054 Cassette Vision 055 Super Cassette Vision 056 Neo Geo CD 057 Fairchild Channel F 058 FM Towns 059 ZX Spectrum 060 Game &amp; Watch 061 Nokia N-Gage 062 Nintendo 3DS 063 Watara Supervision Yes 064 Sharp X1 065 TIC-80 066 Thomson TO8 067 PC-6000 068 Sega Pico 069 Mega Duck Yes 070 Zeebo 071 Arduboy Yes 072 WASM-4 Yes 073 Arcadia 2001 074 Interton VC 4000 075 Elektor TV Games Compueter 076 PC Engine CD 077 Atari Jaguar CD Yes 078 Nintendo DSi Yes 079 TI-83 080 Uzebox 100 Hubs N/A 101 Events N/A"},{"location":"Console-Specific-Tips-es/","title":"Tips Espec\u00edficos por Consola","text":"<p>Cuando escavamos en memoria en estas viejas consolas ayuda saber que los creadores originales de estos juegos trabajaron en ellos alguna vez. Si te familiarizas bien en la manera en la que trabaja tu consola favorita entonces hacer un set va a resultar mas sencillo y preciso.</p>"},{"location":"Console-Specific-Tips-es/#nes-ranes","title":"NES (RANes)","text":""},{"location":"Console-Specific-Tips-es/#duplicado-de-direcciones","title":"Duplicado de Direcciones","text":"<p>Cuando utilices el inspector de memoria para encontrar variables en juegos de NES, va a ver 4 copias de todo lo que encuentres. Si te estas preguntando \"cual deber\u00eda de utilizar?\" o \"deberia probar cada una de ellas?\" no es tan complicado como parece.</p> <p>Esta es una caracter\u00edstica que el NES le da a los desarrolladores para encontrar mas maneras para buscar en memoria. Porque el NES en si solo tiene 2KB de RAM, el primer resultado (el que va abajo de 0x800) tiene que ser usado para consistencia, y aplicar condiciones adicionales en los otros realmente no hace nada.</p> <p>Esto tambi\u00e9n aplica para RPS y tablas clasificatorias tambi\u00e9n.</p>"},{"location":"Console-Specific-Tips-es/#game-boy-ravba","title":"Game Boy (RAVBA)","text":""},{"location":"Console-Specific-Tips-es/#mapa-de-memoria","title":"Mapa de Memoria","text":"<p>Algunos rangos de valores significan diferentes cosas en el contexto del hardware del Game Boy, as\u00ed que tener un mapa de lo que te puede resultar \u00fatil puede ayudar a eliminar esos valores que no sirven. As\u00ed es como se desplaya:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: Informaci\u00f3n del ROM (No hay raz\u00f3n para utilizarlo. Esta \u00e1rea contiene informaci\u00f3n del header que solamente la leen algunos emuladores.)</li> <li>\u274c 0x8000 - 0x9FFF: Informaci\u00f3n de Gr\u00e1ficos (Algunas veces algunas cosas tal vez tengan sentido si lo que estas buscando es el ID de mapa o animaci\u00f3n , pero siempre va a ver otras maneras mejores de hacer las cosas as\u00ed intenta evitar el uso de cualquiera de estas)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: RAM del Cartucho (Ej. archivos de guardado. Algunas veces utilizar estas direcciones puede ser inevitable porque entonces tu set seria vulnerable a trampas cargando archivos de guardado de 100%. Mas informaci\u00f3n de como proteger tus logros contra archivos de guardado mas adelante)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: RAM de trabajo (Aqu\u00ed esta la bueno; casi todo lo que necesitas se encuentra en este rango)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (No la utilices, mira mas abajo)</li> <li>\u274c 0xFE00 - 0xFE9F: Mas Informaci\u00f3n de Gr\u00e1ficos (lo mismo que informaci\u00f3n de gr\u00e1ficos de arriba)</li> <li>\u274c 0xFEA0 - 0xFFFF: Variado (No lo utilices)</li> </ul> <p>Para mas informaci\u00f3n mira: http://gameboy.mongenel.com/dmg/asmmemmap.html</p>"},{"location":"Console-Specific-Tips-es/#echo-ram","title":"ECHO RAM","text":"<p>Similar que el NES, algunas variables tal vez se muestren mas de una vez cuando te encuentres buscando en el inspector de memoria. El segundo resultado es lo que se le conoce como ECHO RAM, que es un espejo de la memoria actual. Aunque algunos emuladores tienden a ignorar esta \u00e1rea o a emularla incorrectamente, se recomienda NO utilizarla para nada y siempre utilizar el primer resultado.</p> <p>El Game Boy tiene 8KB de RAM empezando en 0xC000. La ECHO RAM empieza en 0xE000, as\u00ed que si tus direcciones empiezan con una E vas a tener que remplazar el primer car\u00e1cter que no tenga un cero con una C. Recuerda: C es lo correcto, E es la echo!</p>"},{"location":"Console-Specific-Tips-es/#gbc","title":"GBC","text":"<p>En el GBC, los 4KB de memoria de 0xD000-0xDFFF son un banco para un bloque de memoria mas grande de 32kb que no es directamente accesible por el procesador. Los Bits 0-2 de 0xFF70 indican cual banco esta cargado en el bloque de memoria 0xD000-0xDFFF. Es una \"funci\u00f3n\" utilizada para expandir el almacenamiento de los ROMs del GBC mientras aun se tiene el soporte para ROMs del GB original.</p> <p>Cambiar de Banco (cambiar el valor de 0xFF70) provoca que la memoria en el rango 0xD000-0xDFFF se actualice. Esto aparece como un flickering/parpadeando en el Visor de Memoria y provoca que la b\u00fasqueda de memoria sea mas complicada. Si estas escribiendo condiciones dependiendo de la memoria que se encuentra en ese bloque, tambi\u00e9n vas a requerir que 0xFF70 tenga un valor en especifico para asegurarte que estas utilizando el banco correcto. Los 4KB de memoria de 0xC000-0xCFFF no se cambian como el banco y pueden ser utilizados sin preocupaciones sin condiciones adicionales.</p> <p>No es muy recomendable que utilices estas direcciones en tus logros si es que cuentas con al menos una alternativa para no utilizarnos. Desde Enero del 2018, RALibretro solamente muestra el banco de 0x00 a 0xFF70. RetroArch a estado fluctuando los bancos de memoria, pero algunos valores no funcionan de la misma manera que en RAVisualBoyAdvance. Al menos asta que RetroArch reciba una inspector de memoria, logros que utilicen direcciones en 0xD000-0xDFFF solamente van a funcionar en RAVisualBoyAdvance.</p>"},{"location":"Console-Specific-Tips-es/#gbgbc-bios","title":"GB/GBC BIOS","text":"<p>RALibRetro y RetroArch cuenta con soporte para el BIOS de GB/GBC, que muestra los logos de \"Nintendo\" y \"GameBoy\" antes de empezar el juego. Esto provee aproximadamente cuatro segundo donde la memoria principal ($C000-$DFFF) aun no a sido inicializada, y podr\u00eda provocar que algunos logros se disparen cuando se cargue el juego por algunos usuarios que tienen el BIOS habilitado.</p> <p>Para habilitar esta caracter\u00edstica, pon el archivo del bios (de nombre <code>gb_bios.bin</code> o <code>gbc_bios.bin</code>) en el folder del directorio del sistema ya sea el de RALibRetro o RetroArch. Cuando empieces el juego, vas a ver los logos de \"Nintendo\" y \"GameBoy\" antes de proceder al juego actual.</p> <p>Si esto te esta causando problemas, tal vez necesites agregar un poco de l\u00f3gica para prevenir que los logros salten cuando se encuentre el jugador en el BIOS, pero seria preferible que agregues l\u00f3gica del juego si es posible (ej. cuando se muestra una pantalla en especifico).</p> <p>El c\u00f3digo del BIOS es cargado en $0000-$00FF, as\u00ed que identifica ese pedazo de memoria cuando est\u00e9s en el BIOS y haz que lo ignore tu logro. Por ejemplo, los \u00faltimos cuatro bytes del bloque del BIOS del GBC son <code>3E 11 E0 50</code>, asi que podr\u00edas agregar esta condici\u00f3n al logro para prevenir que el logro salte cuando el BIOS se encuentra corriendo.</p> <pre><code>32-bit 0x00FC != 0x50E0113E\n</code></pre> <p>Despu\u00e9s de que el BIOS se termina, el bloque es rellenado con puras FF's, y es re-asignado para vectores de interrupci\u00f3n. Para mas detalles, mira Un vistazo a la pantalla de inicio del GameBoy.</p> <p>NOTA: Los \u00faltimos cuatro bytes del BIOS del GB son <code>3E 01 E0 50</code>. As\u00ed que la condici\u00f3n para el BIOS seria:</p> <pre><code>32-bit 0x00FC != 0x50E0013E\n</code></pre>"},{"location":"Console-Specific-Tips-es/#nintendo-64-rap64","title":"Nintendo 64 (RAP64)","text":""},{"location":"Console-Specific-Tips-es/#utilizando-codigos-gameshark-para-direcciones","title":"Utilizando c\u00f3digos GameShark para Direcciones","text":"<p>Los c\u00f3digos de GameShark pueden ser un valioso recurso para encontrar direcciones que no puedes o sientes que no las puedes encontrar. Estos cuentan con 12 caracteres por linea y son sencillamente f\u00e1ciles de compilar.</p> <p><code>[AA][BBBBBB] [CCCC]</code></p> <p>[AA] es el tipo de c\u00f3digo. Esta es una peque\u00f1a instrucci\u00f3n para el GameShark que define que hacer con el siguiente valor. Si entiendes que es lo que hace ese c\u00f3digo GameShark puedes utilizar como ayuda para crear una condici\u00f3n.</p> <ul> <li>80, 88: La direcci\u00f3n es de 8-bit. Pone el valor en [00CC] en la direcci\u00f3n [BBBBBB].</li> <li>81, 89: La direcci\u00f3n es de 16-bit. Pone el valor en [CCCC] en la direcci\u00f3n [BBBBBB].</li> <li>D0: La direcci\u00f3n es de 8-bit. Checa si [00CC] es igual al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D2: La direcci\u00f3n es de 8-bit. Checa si [00CC] es DIFERENTE al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D1: La direcci\u00f3n es de 16-bit. Checa si [CCCC] es igual al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> <li>D3: La direcci\u00f3n es de 16-bit. Checa si [CCCC] es DIFERENTE al valor en la direcci\u00f3n [BBBBBB] entonces ejecuta la siguiente linea si as\u00ed lo es.</li> </ul> <p>Aqu\u00ed est\u00e1n algunos ejemplos: * Paper Mario: HP Infinito:</p> <p><code>[80][10F292] [0032]</code></p> <p>Cambia el valor de 8-bit en 0x10F292 a 0x32 (50). Entonces esto significa que el HP de Mario es un valor de 8-bit en 0x10F292.</p> <ul> <li>Donkey Kong 64: Juega como Rambi: </li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Cambia el valor de 8-bit en 0x74E77C a 6. Entonces esto significa que el personaje el cual estas utilizando ahora es un valor de 8-bit en 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Deja presionado L para hacer el Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Estamos revisando este</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Checa si el valor de 8-bit en 0x18BAB5 es igual a 0x20. Esto significa que 0x18BAB5 contiene una variable de presionado de bot\u00f3n y el Bit5 (0x20) corresponde a la L.</p> <p>Anti-GSC y GameHacking los dos son buenos recursos para encontrar c\u00f3digos de GameShark.</p>"},{"location":"Console-Specific-Tips-es/#neo-geo","title":"Neo Geo","text":""},{"location":"Console-Specific-Tips-es/#proteccion-obligatoria-del-unibios","title":"Protecci\u00f3n Obligatoria del UniBIOS","text":"<p>UniBIOS permite severas opciones de desarrollador, y tambi\u00e9n accesa a la base de datos de cheats de cada juego. Por eso mismo todos los logros para Neo Geo necesitan estar protegidos de esto. La soluci\u00f3n mas simple para hacer esto es desabilitar el uso del UniBIOS completamente, directamente desde el c\u00f3digo de logro.</p> <p>Afortunadamente la parte de la data del UniBIOS parece ser reflejada en dos cadenas de direcciones en la RAM: <code>0x00fe30</code> y <code>0x00fe50</code>. Mientras el UniBIOS este activo <code>0x00fe30</code> en 32-bit parece mostrar siempre el mismo valor (para cada uno de los juegos de Neo Geo game) que es <code>80025632</code>, y no parece que cambie despu\u00e9s que el ROM ya fue cargado. Para cualquier otro BIOS, el valor siempre es 0, (excepto en el momento en el que la RAM es cargada de nuevo en el programa de diagnostico, despu\u00e9s de haber cargado el ROM).</p> <p>Para proteger tus logros del uso completo del UniBIOS lo \u00fanico que necesitamos hacer es incluir una simple protecci\u00f3n que se va resetear cuando el valor de 32-bit en <code>0x00fe30</code> no sea igual a <code>0</code>. Esto adicionalmente protege, al logro de que salte durante el proceso de diagnostico de RAM.</p> <p>As\u00ed es como se deber\u00eda de ver la protecci\u00f3n (seleccionada en el Editor de Logros): </p> <p>As\u00ed es como se ve la misma regi\u00f3n de la RAM cuando se utilizan otros BIOS (utilizando MSV): </p>"},{"location":"Console-Specific-Tips-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-23 10:07] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-23 09:59] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-23 09:59] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-22 14:57] eldexterr:</code> Updated Console Specific Tips es (markdown)</li> <li><code>[2019-05-22 11:42] eldexterr:</code> Created Console Specific Tips es (markdown)</li> </ul>"},{"location":"Console-Specific-Tips-pt_BR/","title":"Dicas Espec\u00edficas de Console","text":""},{"location":"Console-Specific-Tips-pt_BR/#dicas-especificas-do-console","title":"Dicas Espec\u00edficas do Console","text":"<p>Link para texto em ingl\u00eas: Console Specific Tips</p> <p>Ao escavar a mem\u00f3ria desses antigos consoles, ajuda saber em primeiro lugar com o que os criadores originais dos jogos estavam trabalhando. Se voc\u00ea se familiarizar com as peculiaridades do seu console favorito, a configura\u00e7\u00e3o ser\u00e1 mais f\u00e1cil e precisa.</p>"},{"location":"Console-Specific-Tips-pt_BR/#nes-ranes","title":"NES (RANes)","text":""},{"location":"Console-Specific-Tips-pt_BR/#game-boy-ravba","title":"Game Boy (RAVBA)","text":""},{"location":"Console-Specific-Tips-pt_BR/#mapa-de-memoria","title":"Mapa de mem\u00f3ria","text":"<p>Determinadas variedades de valores significam coisas diferentes no contexto do hardware do Game Boy, portanto, ter um mapa  pode ajud\u00e1-lo a eliminar endere\u00e7os in\u00fateis. Aqui est\u00e1 o resumo:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: Dados da ROM (normalmente n\u00e3o h\u00e1 raz\u00e3o para usar. Se voc\u00ea for um desenvolvedor super dedicado, poder\u00e1 usar o valor de 16 bits em 0x14E junto com os grupos alt para oferecer suporte a v\u00e1rias vers\u00f5es / regi\u00f5es da ROM)</li> <li>\u274c 0x8000 - 0x9FFF: Dados gr\u00e1ficos (algumas coisas aqui podem estar correlacionadas com o que voc\u00ea est\u00e1 procurando, se voc\u00ea estiver tentando encontrar uma ID ou anima\u00e7\u00e3o de mapa, mas sempre haver\u00e1 uma maneira melhor de lidar com o que voc\u00ea est\u00e1 fazendo do que usando qualquer um deles)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: Cartridge RAM (ou seja, salvar dados. \u00c0s vezes, usar esses endere\u00e7os ser\u00e1 inevit\u00e1vel, mas o seu conjunto pode ser propenso a fazer batota ao carregar arquivos salvos em 100%. Mais informa\u00e7\u00f5es sobre como proteger contra arquivos salvos)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: RAM de trabalho (as coisas boas; quase tudo que voc\u00ea deve usar cair\u00e1 dentro deste intervalo)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (n\u00e3o use, veja abaixo)</li> <li>\u274c 0xFE00 - 0xFE9F: Mais dados gr\u00e1ficos (igual aos dados gr\u00e1ficos acima)</li> <li>\u274c 0xFEA0 - 0xFFFF: Diversos (n\u00e3o use)</li> </ul> <p>Para mais informa\u00e7\u00f5es, consulte: http://gameboy.mongenel.com/dmg/asmmemmap.html <code>texto em ingl\u00eas</code></p>"},{"location":"Console-Specific-Tips-pt_BR/#echo-ram","title":"ECHO RAM","text":"<p>Similarmente ao NES, certas vari\u00e1veis podem aparecer duas vezes ao pesquisar no Memory Inspector. O segundo resultado est\u00e1 no que \u00e9 chamado de RAM ECHO, que \u00e9 um espelho da mem\u00f3ria real. Como alguns emuladores tendem a ignorar essa \u00e1rea ou emular incorretamente, recomenda-se N\u00c3O us\u00e1-la e sempre usar o primeiro resultado.</p> <p>O Game Boy tem 4KB de RAM a partir de 0xC000. ECHO RAM come\u00e7a em 0xE000, ent\u00e3o se o seu endere\u00e7o come\u00e7ar com um E voc\u00ea vai querer substituir o primeiro caractere diferente de zero por um C. Lembre-se: C est\u00e1 correto, E \u00e9 echo!</p>"},{"location":"Console-Specific-Tips-pt_BR/#nintendo-64-rap64","title":"Nintendo 64 (RAP64)","text":""},{"location":"Console-Specific-Tips-pt_BR/#usando-codigos-gameshark-para-enderecos","title":"Usando c\u00f3digos GameShark para endere\u00e7os","text":"<p>Os c\u00f3digos GameShark podem ser um recurso valioso para encontrar endere\u00e7os que voc\u00ea n\u00e3o pode ou n\u00e3o deseja encontrar. Eles t\u00eam 12 caracteres por linha e s\u00e3o f\u00e1ceis de analisar.</p> <p><code>[AA] [BBBBBB] [CCCC]</code></p> <p>[AA] \u00e9 o tipo de c\u00f3digo. Esta \u00e9 uma breve instru\u00e7\u00e3o para o GameShark que define o que fazer com o pr\u00f3ximo valor. Se voc\u00ea entende o c\u00f3digo do GameShark, voc\u00ea pode us\u00e1-lo para ajudar na cria\u00e7\u00e3o de condi\u00e7\u00f5es.</p> <ul> <li>80, 88: O endere\u00e7o \u00e9 de 8 bits. Define o valor [00CC] para o endere\u00e7o [BBBBBB].</li> <li>81, 89: O endere\u00e7o \u00e9 de 16 bits. Define o valor [CCCC] para o endere\u00e7o [BBBBBB].</li> <li>D0: o endere\u00e7o \u00e9 de 8 bits. Verifica se [00CC] \u00e9 igual ao valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> <li>D2: o endere\u00e7o \u00e9 de 8 bits. Verifica se [00CC] \u00e9 DIFERENTE para o valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> <li>D1: o endere\u00e7o \u00e9 de 16 bits. Verifica se [CCCC] \u00e9 igual ao valor no endere\u00e7o [BBBBBB] e executa a pr\u00f3xima linha, se for.</li> <li>D3: o endere\u00e7o \u00e9 de 16 bits. Verifica se [CCCC] \u00e9 DIFERENTE para o valor no endere\u00e7o [BBBBBB] e, em seguida, executa a pr\u00f3xima linha, se for.</li> </ul> <p>aqui est\u00e3o alguns exemplos:</p> <ul> <li>Paper Mario: HP infinito:</li> </ul> <p><code>[80] [10F292] [0032]</code></p> <p>Define o valor de 8 bits em 0x10F292 para 0x32 (50). Ent\u00e3o, isso significa que o HP de Mario \u00e9 um valor de 8 bits em 0x10F292.</p> <ul> <li>Donkey Kong 64: Jogando com Rambi:</li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Define o valor de 8 bits em 0x74E77C para 6. Portanto, isso significa que o caractere que voc\u00ea est\u00e1 jogando \u00e9 um valor de 8 bits em 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Seguro L para Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Looking at this one</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Verifica se o valor de 8 bits em 0x18BAB5 \u00e9 igual a 0x20. Isso significa que 0x18BAB5 cont\u00e9m uma vari\u00e1vel de pressionamento de bot\u00e3o e Bit5 (0x20) corresponde a L.</p> <p>Anti-GSC e GameHacking ambos s\u00e3o bons recursos para encontrar c\u00f3digos de GameShark.</p>"},{"location":"Console-Specific-Tips-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-10-11 00:47] CoolCanuck:</code> https</li> <li><code>[2018-03-29 18:29] KingDice001:</code> Updated Console Specific Tips pt_BR (markdown)</li> <li><code>[2018-03-28 21:13] 7Mogami7:</code> Updated Console Specific Tips pt_BR (markdown)</li> <li><code>[2018-03-28 20:45] 7Mogami7:</code> Created Console Specific Tips pt_BR (markdown)</li> </ul>"},{"location":"Console-Specific-Tips/","title":"Console Specific Tips","text":"<p>When excavating the memory of these old consoles it helps to know what the original creators of the games were working with in the first place. If you familiarize yourself with the quirks of your favorite console then set making will be easier and more accurate.</p> <ul> <li>NES<ul> <li>Memory Mirroring</li> </ul> </li> <li>Game Boy<ul> <li>Memory Map</li> <li>ECHO RAM</li> <li>GBC</li> <li>GB and GBC BIOS</li> </ul> </li> <li>Game Boy Advance<ul> <li>Memory Map</li> </ul> </li> <li>Nintendo 64<ul> <li>Using GameShark Codes for Addresses</li> </ul> </li> <li>Nintendo DS</li> <li>Nintendo DSi (Bizhawk)</li> <li>Neo Geo<ul> <li>Mandatory UniBIOS protection</li> </ul> </li> <li>PlayStation</li> <li>PlayStation Portable</li> </ul>"},{"location":"Console-Specific-Tips/#nes","title":"NES","text":""},{"location":"Console-Specific-Tips/#memory-mirroring","title":"Memory Mirroring","text":"<p>When using the memory inspector to find variables for NES games, there will be 4 copies of everything you find. If you're wondering \"which one do I use?\" or \"should I check for all of them?\" it's not as complicated as it seems.</p> <p>This is a feature of the NES that gave developers more ways of looking at memory. Because the NES itself only has 2KB of RAM, the first result (the one below 0x800) should be used for consistency, and applying additional conditions on the others will do nothing.</p> <p>This applies to RPS and leaderboards as well.</p>"},{"location":"Console-Specific-Tips/#game-boy","title":"Game Boy","text":""},{"location":"Console-Specific-Tips/#memory-map","title":"Memory Map","text":"<p>Certain ranges of values mean different things in the context of the Game Boy hardware, so having a map of what's where can help you with eliminating useless addresses. Here's the lowdown:</p> <ul> <li>\u274c 0x0000 - 0x7FFF: ROM Data (No reason to use. This area contains header information that's only read on certain emulators.)</li> <li>\u274c 0x8000 - 0x9FFF: Graphics Data (Some things here might correlate with what you're looking for if you're trying to find a map ID or animation, but there will always be a better way of going about what you're doing than using any of these)</li> <li>\u2714\ufe0f 0xA000 - 0xBFFF: Cartridge RAM (IE. save data. Sometimes using these addresses will be unavoidable but then your set could be prone to cheating by loading 100% save files. More info on protecting against save files to come)</li> <li>\u2714\ufe0f 0xC000 - 0xDFFF: Work RAM (The good stuff; almost everything you should use will fall inside this range)</li> <li>\u274c 0xE000 - 0xFDFF: ECHO RAM (Do not use, see below)</li> <li>\u274c 0xFE00 - 0xFE9F: More Graphics Data (same as Graphics Data above)</li> <li>\u274c 0xFEA0 - 0xFF7F: Miscellaneous (Do not use)</li> <li>\u2714\ufe0f 0xFF80 - 0xFFFF: Miscellaneous (Okay to use)</li> </ul> <p>For more info see: http://gameboy.mongenel.com/dmg/asmmemmap.html</p>"},{"location":"Console-Specific-Tips/#echo-ram","title":"ECHO RAM","text":"<p>Similarly to the NES, certain variables may show up twice when searching in the Memory Inspector. The second result is in what's called the ECHO RAM, which is a mirror of the actual memory. Since some emulators tend to ignore this area or emulate it incorrectly, it's recommended to NOT use it at all and always use the first result.</p> <p>The Game Boy has 8KB of RAM starting at 0xC000. ECHO RAM starts at 0xE000, so if your address begins with an E you'll want to replace the first non-zero character with a C. Remember: C is correct, E is echo!</p>"},{"location":"Console-Specific-Tips/#gbc","title":"GBC","text":"<p>On the GBC, the 4KB of memory from 0xD000-0xDFFF is a bank from a larger 32KB memory block not directly accessible by the processor. Bits 0-2 of 0xFF70 indicate which bank is loaded into the 0xD000-0xDFFF memory block. It's a \"feature\" used to expand the storage available to GBC ROMs while still supporting GB ROMs.</p> <p>Bank switching (changing the value of 0xFF70) causes the memory in the 0xD000-0xDFFF range to update. This appears as flickering in the Memory Viewer and makes tracking down values in that memory range difficult. If you are writing conditions dependent on memory in that block, you should also require that 0xFF70 have a specific value to ensure you are looking at the correct bank. The 4KB of memory from 0xC000-0xCFFF is not bank-switched and can be used safely without additional conditions.</p> <p>It is not advisable to use these addresses for achievements if there is any alternative to doing so. As of January 2018, RALibretro will only display bank 0x00 at 0xFF70. RetroArch has fluctuating memory banks, but the various addresses do not function in the same manner as RAVisualBoyAdvance. At least until RetroArch receives a memory inspector, achievements using addresses from 0xD000-0xDFFF will only work within RAVisualBoyAdvance.</p>"},{"location":"Console-Specific-Tips/#gb-and-gbc-bios","title":"GB and GBC BIOS","text":"<p>RALibRetro and RetroArch support the GB/GBC BIOS, which shows the \"Nintendo\" and \"GameBoy\" logo before starting the game. This provides approximately four seconds where the main memory ($C000-$DFFF) hasn't been initialized and can't be trusted, and may cause achievements to trigger while loading the game for a subset of users who have the BIOS enabled.</p> <p>To enable this feature, put the bios file (named <code>gb_bios.bin</code> or <code>gbc_bios.bin</code>) into the system directory of either RALibRetro or RetroArch. When you start the game, you will see the \"Nintendo\" and \"GameBoy\" logos before proceeding into the actual game.</p> <p>If this is causing you problems, you may need to add logic to prevent the achievements from triggering while the BIOS is executing, but it would be preferable to use in-game logic if possible (i.e. a specific screen is being displayed).</p> <p>The BIOS code is loaded from $0000-$00FF, so identify some chunk of that memory that's unique while the BIOS is running and ignore it. For example, the last four bytes of the GBC BIOS block are <code>3E 11 E0 50</code>, so you could add this condition to the achievement to prevent it from triggering while the BIOS is running.</p> <pre><code>32-bit 0x00FC != 0x50E0113E\n</code></pre> <p>After the BIOS completes, the block is blanked out with FF's, and repurposed for interrupt vectors. For more detail, see A Look at the GameBoy bootstrap.</p> <p>NOTE: The last four bytes of the GB BIOS are <code>3E 01 E0 50</code>. So the GB condition would be:</p> <pre><code>32-bit 0x00FC != 0x50E0013E\n</code></pre>"},{"location":"Console-Specific-Tips/#game-boy-advance","title":"Game Boy Advance","text":""},{"location":"Console-Specific-Tips/#gba-memory-map","title":"GBA Memory Map","text":"Name Physical Address Range Virtual Address Range Offset (Virtual to Physical) On-chip Working RAM (WRAMC) 0x00000000 - 0x00007fff 0x03000000 - 0x03007fff -0x03000000 On-board Working RAM (WRAMB) 0x00008000 - 0x00047fff 0x02000000 - 0x0203ffff -0x01ff8000 Game Pak SRAM (SRAM) 0x00048000 - 0x00057fff 0x0e000000 - 0x0e00ffff -0x0dfb8000"},{"location":"Console-Specific-Tips/#nintendo-64","title":"Nintendo 64","text":""},{"location":"Console-Specific-Tips/#using-gameshark-codes-for-addresses","title":"Using GameShark Codes for Addresses","text":"<p>GameShark codes can be a valuable resource for finding addresses you can't or don't feel like finding. They have 12 characters per line and are fairly easy to parse.</p> <p><code>[AA][BBBBBB] [CCCC]</code></p> <p>[AA] is the codetype. This is a short instruction to the GameShark that defines what to do with the next value. If you understand what the GameShark code does you can use it to help with condition-making.</p> <ul> <li>80, 88: The address is 8-bit. Sets the value [00CC] to the address [BBBBBB].</li> <li>81, 89: The address is 16-bit. Sets the value [CCCC] to the address [BBBBBB].</li> <li>D0: The address is 8-bit. Checks if [00CC] is equal to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D2: The address is 8-bit. Checks if [00CC] is DIFFERENT to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D1: The address is 16-bit. Checks if [CCCC] is equal to the value at address [BBBBBB] then executes the next line if it is.</li> <li>D3: The address is 16-bit. Checks if [CCCC] is DIFFERENT to the value at address [BBBBBB] then executes the next line if it is.</li> </ul> <p>Here are some examples: * Paper Mario: Infinite HP:</p> <p><code>[80][10F292] [0032]</code></p> <p>Sets the 8-bit value at 0x10F292 to 0x32 (50). So this means Mario's HP is an 8-bit value at 0x10F292.</p> <ul> <li>Donkey Kong 64: Play as Rambi: </li> </ul> <p><code>[80][74E77C] [0006]</code></p> <p>Sets the 8-bit value at 0x74E77C to 6. So this means the character you're playing as is an 8-bit value at 0x74E77C.</p> <ul> <li>Chameleon Twist 2: Hold L to Moon Jump:</li> </ul> <p><code>[D0][18BAB5] [0020] &lt;- Looking at this one</code></p> <p><code>[81][18B9E0] [4200]</code></p> <p>Checks if the 8-bit value at 0x18BAB5 is equal to 0x20. This means 0x18BAB5 contains a button press variable and Bit5 (0x20) corresponds to L.</p> <p>Anti-GSC and GameHacking are both good resources for finding GameShark codes.</p>"},{"location":"Console-Specific-Tips/#nintendo-ds","title":"Nintendo DS","text":"<p>Pointers always start with a <code>0x02</code>. For example, a pointer pointing directly to <code>0x13f944</code> will be <code>0x0213f944</code>.</p>"},{"location":"Console-Specific-Tips/#nintendo-dsi-bizhawk","title":"Nintendo DSi (Bizhawk)","text":"<ul> <li>0xfffe00: DSi Mode String ASCII String that identifies the DSi Game being played. Can be used to check if you are in the game rather than on the DSi home screen, etc.</li> </ul>"},{"location":"Console-Specific-Tips/#neo-geo","title":"Neo Geo","text":""},{"location":"Console-Specific-Tips/#mandatory-unibios-protection","title":"Mandatory UniBIOS protection","text":"<p>UniBIOS allows several debugging options, and also access the database of individual cheats for every game. Therefore all achievements for Neo Geo need to be protected from abusing it. The simpliest solution here is disallowing UniBIOS usage completely, directly from the level of achievement code.</p> <p>Fortunately part of UniBIOS data seems to be reflected in two address strings in the RAM: <code>0x00fe30</code> and <code>0x00fe50</code>. While UniBIOS is active <code>0x00fe30</code> in 32-bit size seems to always brings the same value (for every Neo Geo game) which is <code>80025632</code>, and it doesn't seem to change after the ROM was loaded. For any other BIOS, the value is always 0, (except for the moment the RAM is overloaded by the diagnostic program, after the ROM was loaded).</p> <p>To protect achievements from using UniBIOS all we need to do is to include a simple protection which will reset when <code>0x00fe30</code> in 32-bit size is not equal to <code>0</code>. This additionally, eventually protect the achievement from unlocking during RAM diagnostic process.</p> <p>Here is how the protection should look alike (selected in the Achievement Editor): </p> <p>Here is how the same RAM region looks when other BIOS are used (here MSV): </p>"},{"location":"Console-Specific-Tips/#playstation","title":"PlayStation","text":"<p>NOTE: If a core doesn't require a BIOS, this memory may not be initialized.</p> <p>The RAM from $0000-$FFFF is reserved for the kernel. The boot executable name appears to reliably be placed at $9E18 AND $B8B0. The boot executable name almost always contains the disc serial, which is unique per region, so this can often be used to determine which version of a game the player is using. </p> <pre><code>Spyro the Dragon                         SCUS_942.28\n\n9E18 5C 53 43 55 53 5F 39 34 32 2E 32 38 3B 31\n      \\  S  C  U  S  _  9  4  2  .  2  8  ;  1\n\nB8B0 63 64 72 6F 6D 3A 5C 53 43 55 53 5F 39 34 32 2E 32 38 3B 31\n      c  d  r  o  m  :  \\  S  C  U  S  _  9  4  2  .  2  8  ;  1\n</code></pre>"},{"location":"Console-Specific-Tips/#playstation-portable","title":"PlayStation Portable","text":"<p>When working with PSP make sure to check if your game has any DLC as this form of content is able to be accessed by players without altered saves or patched versions of the game and will need to be accounted for and in some cases protected against if it provides advantages that you don't want players to exploit.</p>"},{"location":"Console-Specific-Tips/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-26 13:40] Biendeo:</code> Added a memory map reference for the GBA.</li> <li><code>[2023-06-06 10:58] televandalist:</code> Added ToC</li> <li><code>[2023-05-30 01:46] Riley Nielsen:</code> Add info about Nintendo DS pointers</li> <li><code>[2023-05-04 11:44] The Mystical One:</code> Added information about Nintendo DSi's DSi Mode String.</li> <li><code>[2023-04-14 11:24] The Mystical One:</code> Adjusted the miscellaneous GB section because the upper end of that range is okay to use (and some game devs put some data only there).</li> <li><code>[2023-03-24 20:29] LiquifiedSnow:</code> Updated Console Specific Tips (markdown)</li> <li><code>[2023-03-04 14:25] televandalist:</code> Updated Console Specific Tips (markdown)</li> <li><code>[2023-03-04 13:58] televandalist:</code> Added note about US BIOS for PSX Beetle</li> <li><code>[2020-04-25 09:30] Jamiras:</code> add note about disc serial for PSX games</li> <li><code>[2019-05-13 22:03] Jamiras:</code> small difference in gb vs gbc bios</li> </ul>"},{"location":"Contributing-with-the-docs-es/","title":"Contribuyendo con los documentos","text":"<p>Resumiendo las cosas:</p> <ol> <li>Inicia sesi\u00f3n en tu cuenta de github (o crea una cuenta si no cuentas con una).</li> <li>Edita una pagina (o crea una nueva) en la RAwiki. Tienes que utilizar el lenguaje de marcado Markdown (mas informaci\u00f3n mas abajo).</li> <li>Tarde o temprano un moderador va a generar las paginas para RAdocs.</li> </ol> <p>La diferencia entre RAwiki y RAdocs es explicada en Como funciona la documentaci\u00f3n de RA.</p>"},{"location":"Contributing-with-the-docs-es/#markdown","title":"Markdown","text":"<p>Markdown es un lenguaje de marcado extremadamente ligero y f\u00e1cil de aprender con una sintaxis de formateado de texto simple. Para contribuir en nuestro proyecto tienes que m\u00ednimo conocer los b\u00e1sicos de markdown. Aqui hay una buena pagina de referencia: http://commonmark.org/help/, y aqu\u00ed puedes probar 10 minutos del tutorial.</p> <p>Ademas, esta wiki necesita ser escrita en cierto formato para que as\u00ed se puedan convertir en las bonitas paginas est\u00e1ticas de ya conoces. Esto es debido a que utilizamos mkdocs) y este utiliza el markdown de python y github utiliza el markdown de github, entonces hay algunos peque\u00f1os problemas de formato que se tienen que tomar en cuenta.</p>"},{"location":"Contributing-with-the-docs-es/#encabezados","title":"Encabezados","text":"<p>Los t\u00edtulos (definidos por un <code>#</code>) necesitan seguir una progresi\u00f3n natural de la jerarqu\u00eda del contenido de la pagina. Pero tu NO PUEDES dos encabezados de titulo (esos que tienen solamente un s\u00edmbolo de <code>#</code>). De otra manera no se mostraran en la tabla de contenidos a la derecha de la pagina</p> <p>Ej.</p> <pre><code># Titulo\n## Encabezado principal uno\n### Sub Encabezado uno\n### Sub Encabezado dos\n## Encabezado Principal dos\n</code></pre> <p>etc.</p>"},{"location":"Contributing-with-the-docs-es/#enlaces","title":"Enlaces","text":"<p>Los enlaces tienen que seguir la siguiente sintaxis</p> <pre><code>[Enlace](ruta del enlace.md)\n</code></pre> <p>Nota: Si este es un enlace a otra pagina de la wiki esto se hace con una ruta relativa:</p> <pre><code>[Tips y Trucos](Tips-and-Tricks-es.md)\n</code></pre> <p>NO utilices el URL completo cuando est\u00e9s linkeando a otra pagina de la wiki, como esto (si, este es un ejemplo de lo que NO tienes que llegar a hacer):</p> <pre><code>[Tips y Trucos](https://github.com/RetroAchievements/docs/wiki/Tips-and-Tricks-es)\n</code></pre>"},{"location":"Contributing-with-the-docs-es/#imagenes","title":"Im\u00e1genes","text":"<p>Enlaces para im\u00e1genes tienen que seguir la misma sintaxis que el ejemplo de abajo:</p> <pre><code>![Imagen](http://url/a.png) \n</code></pre> <p>Nota:: Si quieres llegar a almacenar im\u00e1genes para este proyecto de documentaci\u00f3n, puedes publicarlas en este tema de aqu\u00ed y utilizar el hack de almacenamiento de im\u00e1genes de github.</p>"},{"location":"Contributing-with-the-docs-es/#tablas","title":"Tablas","text":"<p>Una tabla simple se mira de esta manera:</p> <pre><code>Primer Encabezado     | Segundo Encabezado     | Tercer Encabezado\n--------------------- | ---------------------- | ---------------------\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\nContenido de la Celda | Contenido de la Celda  | Contenido de la Celda\n</code></pre> <p>Y se deber\u00eda de renderizar de esta manera:</p> Primer Encabezado Segundo Encabezado Tercer Encabezado Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda <p>Puedes especificar una formaci\u00f3n en especifico por cada columna agregando dos puntos a las lineas del separador:</p> <pre><code>Primer Encabezado      | Segundo Encabezado       | Tercer Encabezado\n:--------------------- | :----------------------: | ---------------------:\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\nContenido de la Celda  | Contenido de la Celda    | Contenido de la Celda\n</code></pre> <p>Resultado:</p> Primer Encabezado Segundo Encabezado Tercer Encabezado Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda Contenido de la Celda"},{"location":"Contributing-with-the-docs-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 13:43] eldexterr:</code> Created Contributing with the docs es (markdown)</li> </ul>"},{"location":"Contributing-with-the-docs/","title":"Contributing with the docs","text":""},{"location":"Contributing-with-the-docs/#summing-up","title":"Summing up","text":"<ol> <li>Log into your github account (or create an account if you don't have one).</li> <li>Edit a page (or create a new one) on the RAwiki. You must use the Markdown markup language. Just check the Markdown caveats below.</li> <li>Sooner or later a maintainer will generate the pages for RAdocs.</li> </ol>"},{"location":"Contributing-with-the-docs/#rawiki-and-radocs","title":"RAWiki and RADocs","text":"<p>The RetroAchievements Documentation is divided into two parts:</p> <ol> <li>RetroAchievements wiki</li> <li>RetroAchievements docs</li> </ol> <p>The wiki is where these documents are created and edited. Anyone (with a github account) is able to edit the wiki's content. Then, if you have something to share, please edit the wiki!</p> <p>The RetroAchievements docs website has (almost) the same content as the wiki, but with a more pleasant look. The content of this website is generated by its maintainers using the wiki's content as input.</p> <p>When a change is made in the wiki this change is NOT instantaneously reflected in the docs. The conversion is performed by a maintainer from time to time.</p>"},{"location":"Contributing-with-the-docs/#markdown-caveats","title":"Markdown caveats","text":"<p>Markdown is a lightweight and extremely easy to learn markup language with plain text formatting syntax. In order to contribute in our project you must know at least the basics of markdown. Here is a good one-page reference: http://commonmark.org/help/, and here you can try a 10 minutes tutorial.</p> <p>Moreover, this wiki needs to be written in a certain format in order to convert cleanly to the pretty static pages. It's because we use mkdocs) and it uses python markdown and github uses github flavoured markdown, so there are some minor issues of formatting that will need to be addressed.</p>"},{"location":"Contributing-with-the-docs/#headings","title":"Headings","text":"<p>The headings (defined by <code>#</code>) should follow a natural progression of the hierarchy of the page contents. But you CANNOT have two title headings (those with only one <code>#</code> symbol). Otherwise they won't show up on the table of contents on the right side of the page</p> <p>E.G.</p> <pre><code># Title\n## Main heading one\n### Sub Heading one\n### Sub heading two\n## Main heading two\n</code></pre> <p>etc.</p>"},{"location":"Contributing-with-the-docs/#links","title":"Links","text":"<p>Links should follow this syntax</p> <pre><code>[Link](path to link)\n</code></pre> <p>Note: If it is a link to another wiki page it should be a relative path:</p> <pre><code>[Tips and Tricks](Tips-and-Tricks)\n</code></pre> <p>Do NOT use complete a full URL when linking to another wiki page, like this (yeah, this is an example of you should NOT do):</p> <pre><code>[Tips and Tricks](https://github.com/RetroAchievements/docs/wiki/Tips-and-Tricks)\n</code></pre>"},{"location":"Contributing-with-the-docs/#images","title":"Images","text":"<p>Links to images should follow the same syntax as the example below:</p> <pre><code>![Image](http://url/a.png) \n</code></pre> <p>Note:: In order to host images for this documentation project, you can post them in this issue thread here and use the github image hosting hack.</p>"},{"location":"Contributing-with-the-docs/#tables","title":"Tables","text":"<p>A simple table looks like this:</p> <pre><code>First Header | Second Header | Third Header\n------------ | ------------- | ------------\nContent Cell | Content Cell  | Content Cell\nContent Cell | Content Cell  | Content Cell\nContent Cell | Content Cell  | Content Cell\n</code></pre> <p>It should render like this:</p> First Header Second Header Third Header Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell Content Cell <p>You can specify alignment for each column by adding colons to separator lines:</p> <pre><code>First Header | Second Header | Third Header\n:----------- |:-------------:| -----------:\nLeft         | Center        | Right\nLeft         | Center        | Right\nLeft         | Center        | Right\n</code></pre> <p>Results:</p> First Header Second Header Third Header Left Center Right Left Center Right Left Center Right"},{"location":"Contributing-with-the-docs/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-29 12:15] meleu:</code> merging \"How RA Documentation Works\" page here</li> <li><code>[2019-02-14 10:53] meleu:</code> fix broken link</li> <li><code>[2018-04-25 07:12] meleu:</code> new link for radocs</li> <li><code>[2018-04-04 15:55] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-04 15:53] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-03 15:20] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-03 15:02] meleu:</code> Updated Contributing with the docs (markdown)</li> <li><code>[2018-04-02 18:52] meleu:</code> Updated Editing the Wiki (markdown)</li> </ul>"},{"location":"Creating-Entries/","title":"Creating Entries","text":"<p>WIP Page</p> <ul> <li>Naming Conventions<ul> <li>Regional Titles</li> <li>Tags<ul> <li>Multiple Tags</li> <li>Unlicensed vs Hack</li> </ul> </li> <li>Articles and Pipe Separators</li> </ul> </li> <li>Hubs<ul> <li>Linking Bootlegs</li> </ul> </li> </ul>"},{"location":"Creating-Entries/#naming-conventions","title":"Naming Conventions","text":""},{"location":"Creating-Entries/#regional-titles","title":"Regional Titles","text":"<p>When both English and Japanese titles are used in an RA entry's title, the Japanese title should only be first when the game was never officially released in English, making whatever English title used an unofficial title.  - Example: <code>Trials of Mana | Seiken Densetu 3</code>, which is fine because an official English release came much later. Before that, everyone used Secret of Mana 2 as the English title, in which case the RA entry's title would have been <code>Seiken Densetsu 3 | Secret of Mana 2</code>.</p>"},{"location":"Creating-Entries/#tags","title":"Tags","text":"<ul> <li><code>~Demo~</code></li> <li><code>~Hack~</code></li> <li><code>~Homebrew~</code></li> <li><code>~Prototype~</code></li> <li><code>~Test Kit~</code></li> <li><code>~Unlicensed~</code></li> </ul>"},{"location":"Creating-Entries/#multiple-tags","title":"Multiple Tags","text":"<p>In cases where <code>~Demo~</code> or <code>~Prototype~</code> are used alongside <code>~Hack~</code> or <code>~Homebrew~</code>, they are to be listed after the latter. - Example: <code>~Homebrew~ ~Demo~ Bob's Game</code> instead of <code>~Demo~ ~Homebrew~ Bob's Game</code>.  The reason for this is that no matter what stage the game is in, it will always be a homebrew or a hack; therefore, those tags should take priority.</p>"},{"location":"Creating-Entries/#unlicensed-vs-hack","title":"Unlicensed vs Hack","text":"<p>In cases where a game is unlicensed and is actually just a hack of another game, then <code>~Hack~</code> would be used instead of <code>~Unlicensed~</code> - Example: Final Fantasy VII on NES, which is a bootleg/pirate release, but it's actually just a hack of Final Fantasy III that was put on a cartridge. So the RA entry would be Hack Final Fantasy VII.</p>"},{"location":"Creating-Entries/#articles-and-pipe-separators","title":"Articles and Pipe Separators","text":"<p>Since the A/An/The articles are moved to the back of a title (but BEFORE a subtitle), then we should also do this when there is a pipe separator between regional titles.  - Example: instead of <code>Garfield Labyrinth | The Real Ghostbusters | Mickey Mouse IV</code>, which is what it is currently, we use <code>Garfield Labyrinth | Real Ghostbusters, The | Mickey Mouse IV</code>. The reason for this is because we may eventually have a way to set which titles we view by default.</p>"},{"location":"Creating-Entries/#hubs","title":"Hubs","text":""},{"location":"Creating-Entries/#linking-bootlegs","title":"Linking Bootlegs","text":"<p>Bootleg/Pirate games are NOT to be linked to hubs for the series they're ripping off.</p>"},{"location":"Creating-Entries/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-04 20:34] televandalist:</code> Updated Creating Entries (markdown)</li> <li><code>[2023-06-04 20:24] televandalist:</code> Created Creating Entries (markdown)</li> </ul>"},{"location":"Creating-a-Timer-with-Reset-If-Hits-based-on-the-Speed-of-the-Game/","title":"Creating a Timer with Reset If Hits based on the Speed of the Game","text":"<p>In this example you will learn how to create an ingame Timer based on the framerate speed of the game.</p> <p>Every game has an address which is constantly increasing, it functions like a engine in a car which is constantly moving despite what you do and starts as soon you start the game, the game itself is your car and some cars are faster than others.</p> <p>Please note that PAL Games (50hz) have a lower framerate than NTSC Games (60hz) and aren't compatible with this method. It is recommended to create every Timer based on the NTSC version of the game, unless PAL version is the only version existing and there is no NTSC Patch available.</p> <p>Addresses</p> <ul> <li><code>0x19</code>: Demo Mode: <code>01</code>=Active, <code>00</code>=Inactive</li> <li><code>0x1a</code>: Game Engine (speed based on framerate)</li> <li><code>0x25</code>: Game Paused: <code>01</code>=Yes. <code>00</code>=No</li> <li><code>0x2c</code>: Game Progression: <code>03</code>=Before Stage starts, <code>04</code>=Stage started, <code>08</code>=Stage finished</li> <li><code>0x30</code>: Stage ID (in this example, Stage 1)</li> </ul> <p></p> <p>Link to Cheevo: Contra Speedrun</p> <p>YouTube: ResetIfHits Demo: Contra Stage 1 60 seconds Speedrun </p> <p>Conditions</p> <ol> <li> <p>Activates the Cheevo's 'Hit' when entering a Stage (<code>03</code>only appears once in each Stage).</p> </li> <li> <p>Triggers the Cheevo when a Stage has been finished.</p> </li> <li> <p>Current Stage (in this example, Stage 1).</p> </li> <li> <p>Paused the Cheevo if the Game is 'Paused' (Stops the Timer in the Cheevo).</p> </li> <li> <p>Resets the Cheevo if <code>60</code> seconds <code>3600</code> Hits are reached. <code>1</code> second = <code>60Hits</code> (NTSC 60fps), <code>50Hits</code> (PAL 50fps).</p> </li> <li> <p>Resets the Cheevo if <code>Demo Mode</code> is active.</p> </li> <li> <p>Resets the Cheevos Timer when entering a new Stage.</p> </li> </ol>"},{"location":"Creating-a-Timer-with-ResetIf-Hits-based-on-the-Speed-of-the-Game-es/","title":"Creando un Temporizador con un ResetIf Hits bas\u00e1ndote en la Velocidad de un Juego","text":"<p>En este ejemplo vas a aprender como crear un temporizador dentro del juego en base a la velocidad del framerate speed del juego.</p> <p>Cada juego tiene una variable que esta constantemente aumentando, esta funciona como el motor de un carro, se esta constantemente moviendo sin importar lo que est\u00e9s haciendo y empieza tan pronto como inicias el juego, el juego en si es tu carro y varios carros son mas r\u00e1pidos que otros.</p> <p>Ten en cuenta que juegos PAL (50hz) tiene un framerate mas bajo a los juegos NTSC (60hz) y no son compatibles con este m\u00e9todo. Es recomendable crear cada temporizador utilizando la versi\u00f3n NTSC  del juego, a menos que la versi\u00f3n PAL sea la uncia versi\u00f3n existente y no exista un parche NTSC disponible.</p> <p>Variables (Addresses)</p> <ul> <li><code>0x19</code>: Modo Demo: <code>01</code>=Activo, <code>00</code>=Inactivo</li> <li><code>0x1a</code>: Motor del Juego (velocidad basada en el framerate)</li> <li><code>0x25</code>: Juego Pausado: <code>01</code>=Si. <code>00</code>=No</li> <li><code>0x2c</code>: Progresion del Juego: <code>03</code>=Antes que empiece el Stage, <code>04</code>=Stage iniciado, <code>08</code>=Stage terminado</li> <li><code>0x30</code>: ID de Stage (en este ejemplo, Stage 1)</li> </ul> <p></p> <p>Link al Logro: Contra Speedrun</p> <p>YouTube: ResetIfHits Demo: Contra Stage 1 60 segundos Speedrun </p> <p>Condiciones</p> <ol> <li> <p>Se activa el Hit del Logro cuando se entra al Stage (<code>03</code>solo aparece una vez por cada Stage).</p> </li> <li> <p>Salta el Logro cuando un Stage a sido terminado.</p> </li> <li> <p>Stage Actual (en este ejemplo, Stage 1).</p> </li> <li> <p>Pausa el logro si el juego esta Pausado' (Pausa el Temporizador en el Logro).</p> </li> <li> <p>Resetea el logro si se alcanzan <code>60</code> segundos (<code>3600</code> Hits). <code>1</code> segundo = <code>60Hits</code> (NTSC 60fps), <code>50Hits</code> PAL 50fps).</p> </li> <li> <p>Resetea el logro si el <code>Modo Demo</code> esta activo.</p> </li> <li> <p>Resetea el Temporizador del Logro cuando se entra a un nuevo Stage.</p> </li> </ol>"},{"location":"Creating-a-Timer-with-ResetIf-Hits-based-on-the-Speed-of-the-Game-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:16] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Delta-Values-es/","title":"Valores Delta","text":"<p>Un valor <code>Delta</code> es el valor del fotograma (frame) pasado. Nota: cuando utilizas <code>Delta</code> es implicito que te refieras a una direccion y no a un valor.</p> <p>Ejemplos de como puede ser utilizado:</p> <ul> <li>Detectar si el nivel a sido incrementado: <code>nivel &gt; nivel delta</code>. A lo que significas \"el nivel actual es mas grande que el nivel encontrado en el fotograma pasado\".</li> <li>Detectar da\u00f1o: <code>salud &lt; salud delta</code>. Que significa \"la salud actual es mas peque\u00f1a la salud encontrada en el fotograma pasado\". O simplemente puedes poner el antiguo valor del fotograma como un requisito. <code>salud delta = 1</code> que significa \"el valor de salud tiene que ser 1 en el fotograma pasado para que salte el logro.\"</li> </ul> <p>En la seccion de Ejemplos Reales hay algunos buenos ejemplos:</p> <ul> <li>Utilizando Hit Counts como un Contador</li> <li>Utilizando Valores Delta y Hit Counts para detectar un Incremento</li> <li>Simple ejemplo de como evadir el abuso en Estados de Guardado (Load States)</li> </ul>"},{"location":"Delta-Values-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:38] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Delta Values ES (markdown)</li> </ul>"},{"location":"Delta-Values/","title":"Delta Values","text":"<p>A <code>Delta</code> value is the previous frame's value. Note: when you use <code>Delta</code> it is implicit that you are referring to an address and not a value.</p> <p>Examples of how it can be used:</p> <ul> <li>Detect if the level has been increased: <code>level &gt; delta level</code>. It means \"current level  is greater than the previous frame's level\".</li> <li>Detect damage: <code>health &lt; delta health</code>. It means \"current health is smaller than the previous frame's health\". Or you can just make the previous frame's value a requirement. <code>health delta = 1</code> means \"the previous frame's value for health must be 1 when the achievement pops up.\"</li> </ul> <p>In the Real Examples section there are some good examples:</p> <ul> <li>Using Hit Counts as a Timer</li> <li>Using Delta Values and Hit Counts to Detect an Increment</li> </ul>"},{"location":"Delta-Values/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 10:37] televandalist:</code> Removed link to a page that doesn't exist</li> <li><code>[2019-02-18 16:53] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:22] meleu:</code> Created Delta Values (markdown)</li> </ul>"},{"location":"Dev-CoC---Frequently-Asked-Questions/","title":"Dev CoC   Frequently Asked Questions","text":"<p>This page is intended to address questions asked about the Dev CoC, as well as expand on points made, usually to clarify guidelines concerning \"special cases.\" It's a brand new page, so give it some time!</p>"},{"location":"Dev-CoC---Frequently-Asked-Questions/#unwelcome-concepts","title":"Unwelcome Concepts","text":""},{"location":"Dev-CoC---Frequently-Asked-Questions/#regarding-unfinished-sets","title":"Regarding Unfinished Sets","text":"<ul> <li>Q: How does the policy about unfinished sets affect compilation games, such as Intellivision Classic Games (PlayStation)?</li> <li>A: If at least one game in the compilation adheres to said policy, then there's no need to worry. A \"proper\" compilation set would take a long time to develop, so adding achievements for one or two games at a time seems like an expected workflow. </li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/","title":"DevJam I \u2010 SG\u20101000","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2023-07-01</li> <li>Launch Date: 2023-09-30</li> </ul>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#point-system","title":"Point System","text":"<p>Max Earnable Points: 6</p> <p>This table details earnable points for the SG-1000 DevJam:</p> Points Set Submission 2 Licensed Games 1 Collaboration\u2022 1 point per dev\u2022 Must be evenly split 1 Subsets, Homebrews, Unlicensed Games 1 Hacks, Prototypes, Demos 1 Late Submissions\u2022 Sets can still qualify up until the following DevJam's launch date!"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#quarterly-goals","title":"Quarterly Goals","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Current quarterly goals:</p> Point Value Quarterly Goal Details 2 Double the amount of existing sets 26 sets 1 Develop sets for all SG-1000 games with set requests \u2022 Bomb Jack\u2022 Elevator Action\u2022 Flicky\u2022 Q-Bert\u2022 Rock N' Bolt\u2022 Sinbad Mystery\u2022 Yie Ar Kung-Fu\u2022 Yie Ar Kung-Fu II 1 Develop sets for all SG-1000 games released in 1983 \u2022 Borderline\u2022 Champion Baseball\u2022 Champion Golf\u2022 Champion Tennis\u2022 ~Congo Bongo~\u2022 Exerion\u2022 Mahjong\u2022 Monaco GP\u2022 N-Sub\u2022 <sub>Pacar</sub>\u2022 Pachinko\u2022 Pop Flamer\u2022 Safari Hunting\u2022 ~Sega Flipper~\u2022 <sub>Sega-Galaga</sub>\u2022 ~Serizawa Hachidan no Tsume Shougi~\u2022 Sindbad Mystery\u2022 ~Space Slalom~\u2022 Star Jacker\u2022 Yamato\u2022 Zippy Race 1 Develop sets for all Othello Multivision Games \u2022 007 James Bond\u2022 Challenge Derby\u2022 Guzzler\u2022 Okamoto Ayako no Match Play Golf\u2022 Othello\u2022 Q-Bert\u2022 San-nin Mahjong\u2022 Space Armor\u2022 Space Mountain"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#stats","title":"Stats","text":"<p>as of 2023-07-01 (start date) - Current number of sets: 26   - 18 licensed games, 4 homebrews, and 4 unlicensed games. - Current number of achievements: 660 worth 5912 points. - Current number of leaderboards: 168</p> <p>as of 2023-09-30 (end date) - Current number of sets: 88   - 63 licensed games, 1 subset, 14 homebrews, and 10 unlicensed games. - Current number of achievements: 1,644 worth 14,511 points. - Current number of leaderboards: 272</p>"},{"location":"DevJam-I-%E2%80%90-SG%E2%80%901000/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/","title":"DevJam II \u2010 Sega Saturn","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2023-10-01</li> <li>Launch Date: 2024-01-31</li> </ul>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#point-system","title":"Point System","text":"<p>Max Earnable Points: 8</p> <p>This table details earnable points for the Saturn DevJam:</p> Points Set Submission 4 Licensed RPGs 3 Other Licensed Games 2 Collaboration\u2022 2 points per dev\u2022 Must be evenly split 2 Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed Games 2 Late Submissions (Licensed Games)\u2022 Sets can still qualify up until the following DevJam's launch date! 1 Late Submissions (Collabs, Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed)"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#quarterly-goals","title":"Quarterly Goals","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Goals that are focused on getting the number of sets to a certain number will grant bonus points to everyone who does a set, even after that goal is met. See the Sega Saturn goals here.</p>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#stats","title":"Stats","text":"<p>as of 2023-10-01 (start date) - Current number of sets: 65   - 61 licensed games, 1 subset, 2 homebrews, and 1 demo. - Current number of achievements: 3,505 worth 29,853 points - Current number of leaderboards: 348</p> <p>as of 2024-01-31 (end date) - Current number of sets: 128   - 117 licensed games, 7 subsets, 2 homebrews, 1 prototype, and 1 demo. - Current number of achievements: 6,370 worth 53,047 points - Current number of leaderboards: 869</p>"},{"location":"DevJam-II-%E2%80%90-Sega-Saturn/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/","title":"DevJam III \u2010 PC Engine and PC Engine CD","text":"<ul> <li>Time and Duration</li> <li>Point System</li> <li>Quarterly Goals</li> <li>Stats</li> <li>See Also</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#time-and-duration","title":"Time and Duration","text":"<ul> <li>Start Date: 2024-02-01</li> <li>Launch Date: 2024-04-30</li> </ul>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#point-system","title":"Point System","text":"<p>Max Earnable Points: 6</p> <p>This table details earnable points for the Saturn DevJam:</p> Points Set Submission 3 Licensed Games 2 Collaboration\u2022 2 points per dev\u2022 Must be evenly split 2 Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed Games 2 Late Submissions (Licensed Games)\u2022 Sets can still qualify up until the following DevJam's launch date! 1 Late Submissions (Collabs, Hacks, Prototypes, Demos, Subsets, Homebrews, Unlicensed)"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#quarterly-goals-wip","title":"Quarterly Goals (WIP)","text":"<p>While the main goal is to promote a bunch of a sets, there are secondary goals that we can work on as a group. If a goal is met, bonus points will be applied to those who helped reach it. Goals that are focused on getting the number of sets to a certain number will grant bonus points to everyone who does a set, even after that goal is met. See the PC Engine and PC Engine CD goals here.</p>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#stats","title":"Stats","text":"<p>as of 2024-02-01 (start date) - Current number of sets:     - PC Engine: 94 (85 licensed games, 1  unlicensed game, 2 subsets, and 6 homebrews)     - PC Engine CD: 38 (35 licensed games, 1 unlicensed game, and 2 homebrews) - Current number of achievements:     - PC Engine: 3,222 achievements worth 33,103 points     - PC Engine CD: 1,782 achievements worth 15,663 - Current number of leaderboards:     - PC Engine: 225     - PC Engine CD: 91 - Current number of open tickets: 4     - PC Engine: 15     - PC Engine CD: 4</p>"},{"location":"DevJam-III-%E2%80%90-PC-Engine-and-PC-Engine-CD/#see-also","title":"See Also","text":"<ul> <li>Main DevJam Page</li> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevJam/","title":"DevJam","text":"<ul> <li>Basic Info</li> <li>Time and Duration</li> <li>Guidelines</li> <li>The Badge</li> <li>FAQ</li> <li>DevJam List</li> <li>Planned DevJams</li> <li>See Also</li> </ul>"},{"location":"DevJam/#basic-info","title":"Basic Info","text":"<p>DevJam is an ongoing developer event that is heavily inspired by our console rollouts: Developers sign up, get locked into developing sets for a specific console, get signed off once completed, and then we release all the sets at once on the launch date. However, with DevJam, the primary focus will be rollouts for supported consoles that did not get them. Some DevJams will focus on a single console. Others may focus on two consoles.</p> <p>Once we \"break even\" and run out of consoles, the focus will shift to quarterly goals, completing sets for hubs, genre-specific crunch times, etc.</p>"},{"location":"DevJam/#time-and-duration","title":"Time and Duration","text":"<p>DevJams will take place quarterly. The first one started July 1st, 2023 with a launch date of September 30th, 2023, the second one will be October 1st, 2023 through December 31st, 2023, etc.</p>"},{"location":"DevJam/#guidelines","title":"Guidelines","text":"<ul> <li>Notify the event host(s) when you make a claim!</li> <li>Sets claimed for the event will be marked as \"Free Rollout\" claims so they will not count against a developer's claim total. However, they will only be \"free\" during that quarter! Early and existing claims won't be marked as \"free\" until the start of the quarter. If a set isn't done in time for launch, it will become a standard claim. Also, like rollouts, devs can only have one free claim at a time!</li> <li>Once a set has been signed off, it will be marked as \"Release Scheduled\" and is to be promoted on the launch date.</li> <li>Event host(s) may request permission to promote your set(s) to core on the launch date in case you are unavailable.</li> <li>If a set is promoted early, it will be disqualified from DevJam. The developer may make another submission if they wish.</li> </ul>"},{"location":"DevJam/#the-badge","title":"The Badge","text":"<ul> <li>The event badge consists of 24 achievements and each achievement will be unlocked for every point earned at the end of the quarter.</li> <li>There will be at least 6 earnable achievements per quarter. These can be split up, which allows for devs to take part in the event at their own pace, but will require some dedication. They could get 1 achievement in the first quarter, 3 in the second quarter, 2 in the third quarter, etc.</li> <li>Point values may vary between quarters depending on the console(s) selected.</li> <li>A chart detailing the current quarter's point system is at the bottom of this page.</li> </ul>"},{"location":"DevJam/#faq","title":"FAQ","text":"<p>Are late submissions still eligible for bonus points from Quarterly Goals? - They wouldn't be quarterly goals then, would they? No.</p> <p>Can I double-dip with DevQuest, CL100, and other events? - Yes.</p> <p>Will there be a second badge? - If this goes well and there's enough demand for a 'Round Two' badge, sure.</p> <p>Can Junior Devs participate? - The nature of the event goes against several aspects of the Junior Dev program so as of now, no. - Junior Devs may feel encouraged to rush a set. - The promotion of Junior Dev sets is a big part of the process so having a set be \"Release Scheduled\" would waste a lot of time. - Code Reviewers would need to work around the DevJam schedule. - The amount of Junior Devs that end up losing the role due to inactivity or do 1-2 sets and disappear far outnumber those who stick around to get full dev. This could result in locked claims!</p>"},{"location":"DevJam/#devjam-list","title":"DevJam List","text":"<p>Check the links here for console-specific guidelines and info:</p> Number Quarter Console(s) Number of Participants Sets Promoted 01 2023-07-01 - 2023-09-30 Sega SG-1000 30 60 02 2023-10-01 - 2024-01-31 Sega Saturn 28 56 03 2024-02-01 - 2024-04-30 PC Engine/PC Engine CD TBA TBA 04 TBA TBA TBA TBA"},{"location":"DevJam/#planned-devjams","title":"Planned DevJams","text":"<p>Solo Console DevJams: - 3DO - PC-8001/8801 - Apple II - MSX - Arcade - Famicom Disk System</p> <p>Multi-Console DevJams: - Sega CD | Sega 32X - Master System | Game Gear - Neo Geo Pocket | WonderSwan | Atari Lynx - Atari 2600 | Atari 7800 | Atari Jaguar - ColecoVision | Intellivision</p> <p>End of the Line for Console-Specific DevJams: - \"Bottom of the Barrel\" (Pokemon Mini, Virtual Boy, Magnavox Odyssey2, PC-FX) - \"The Magnificent Seven\" (Mega Drive, Nintendo 64, SNES, Game Boy, Game Boy Advance, Game Boy Color, NES)</p>"},{"location":"DevJam/#see-also","title":"See Also","text":"<ul> <li>DevJam Event Entry</li> <li>DevJam Forum Topic</li> </ul>"},{"location":"DevQuests/","title":"DevQuests","text":""},{"location":"DevQuests/#what-are-devquests","title":"What are DevQuests?","text":"<p>They're achievement development-related quests that developers can take part in at any time. Each one has a specific goal and upon reaching that goal, the achievement developer will earn the badge. </p>"},{"location":"DevQuests/#general-rules","title":"General Rules","text":"<ul> <li>All work done for for DevQuests must adhere to the Developer CoC. </li> <li>Put effort into what you do. Submitting shoddy work for the sake of getting a badge ASAP will result in penalties that could lead to disqualifications. </li> <li>All sets submitted for DevQuest must be full sets. No progression-only!</li> <li>By default, hacks, homebrews, prototypes, unlicensed, and subsets do not count. Exceptions vary per DevQuest and will be explicitly stated.</li> <li>Be respectful and responsible. The overall point to DevQuests is to improve existing work as well as generate new content. Let's stick to that.</li> <li>DevQuests do not stack with each other, but may stack with other events such as The Unwanted, Challenge League, or Daily DistRActions. So far, the only exceptions are DevQuest 004 - Veteran Developer and DevQuest 015 - Console Conqueror.</li> </ul>"},{"location":"DevQuests/#reporting","title":"Reporting","text":"<ul> <li>DevQuests that involve making new sets are generally reported by contacting the DevQuest team on site or on Discord. </li> <li>If a DevQuest has a specific contact point, they will be stated. </li> </ul>"},{"location":"DevQuests/#schedule-and-announcements","title":"Schedule and Announcements","text":"<ul> <li>DevQuests do not have a specific release schedule. Typically, they are announced shortly after their badge has been completed. </li> <li>New DevQuests and any updates to existing DevQuests will be announced in <code>#developer-news</code> on the RetroAchievements Discord and site news </li> </ul>"},{"location":"DevQuests/#the-quests","title":"The Quests","text":"Badge Number Name Info 001 Ticket Massacre(Badge-Based) Resolve/close 50 tickets\u2022 Falsifying ticket closures will result in disqualification\u2022 The following do not count toward the total: Network issues, tickets for achievements you developed, tickets you opened, tickets closed on behalf of Junior Developers, and tickets closed as a result of ticket spamming. 002 Summer Set Repair(Badge-Based) Repair 3 sets from provided batch\u2022 Upon selecting a game, you will be presented with a list of repairs that need to be made for the set\u2022 This DevQuest follows standard revision procedures\u2022 Resolve any open tickets for achievements that are kept in the set. Tickets for achievements being left demoted can simply be closed with the reason for demotion cited.\u2022 Revisions must fix all broken logic of kept achievements, fix broken challenges, etc. 003 Singles In Your Area(Badge-Based) Tighten up the logic for 20 single-condition achievements\u2022 Do not just add a bad and/or redundant condition and call it a day. They will be checked.\u2022 These do not require a revision vote since it is only tightening logic\u2022 Achievements cannot be your own; you should fix those anyway! 004 Veteran Developer(Achievement-Based) This DevQuest consists of several passive goals, each one being their own achievement, which are as followed:1. Has published at least 1000 achievements and worked on at least 25 sets as the sole or majority developer2. Has created achievements for at least ten different console IDs3. Has been an active developer for at least two years4. At least 85% of sets have dynamic rich presence (Vet Dev I required)5. Yielded unlocks have exceeded 50,0006. As a sole developer, submitted one or more sets for code review and received an overall grade of at least 207. Has used at least 75% of all currently available flags and features (Vet Dev I and VI required)8. Has obtained at least two DevQuest badges\u2022Note: A constantly evolving toolkit means that these requirements are subject to change at any time 005 Trigger Happy(Badge-Based) Update 20 sets with the Trigger and Measured flags\u2022 They need to actually make sense\u2022 You can do your own sets, but each one counts as half a set. 006 The Unwanted(Badge-Based) Develop a set for an unpopular system assigned to you at random\u2022 Eligible systems: PC Engine, PC Engine CD, Sega CD, 32X, Atari Lynx, Neo Geo Pocket, Neo Geo Pocket Color, Game Gear, Atari Jaguar, Virtual Boy, MSX/MSX2, SG-1000, Apple II, Saturn, 3DO, ColecoVision, Intellivision, Vectrex, PC-8800, Atari 7800, WonderSwan, and WonderSwan Color\u2022 No hacks or homebrew unless those are the only types of games left without sets.There are two ways to be able to re-spin:1. If your selected console is Atari Jaguar, Sega 32X, or Sega Saturn. The first two are fairly problematic to dev for and the last is a resource hog that many people have trouble running just to play, much less dev to set2. If your claim expires or you drop your claim. The penalty for dropping a set is still having to wait until the claim would have expired before getting a re-spin. For example, if you claim a set on September 1st and drop it on November 1st, you'll still need to wait until December 1st before the re-spin. You can only do this once 007 Most Wanted(Badge-Based) Develop a set for one of the most requested games. Must be in RANews at the time of claiming it\u2022 If you already have one claimed you must be under 50% progress for it to count 008 World Traveler(Badge-Based) Develop two sets for games that were never officially released in English\u2022 Games with translation patches DO count!\u2022 Hacks and hombrew do not count. Unlicensed titles may count as long as they are not blatant bootleg ports or hacks of another game. If you're unsure then ask!\u2022 If a game was released in English on another platform with RetroAchievements support, half credit may be granted. Games that only released in English on unsupported platforms will receive full credit. 009 Launch Party!(Badge-Based) Develop a set for a newly supported console within 6 months of RA support\u2022 PSP window: 2021-10-01 through 2022-04-01\u2022 Dreamcast window: 2022-02-12 through 2022-08-12\u2022  Amstrad CPC window: 2022-03-28 through 2022-09-28\u2022 Arduboy and WASM-4 window: 2022-05-08 through 2022-11-08 010 It Takes Two(Badge-Based) Join forces with other developers to publish two collab sets\u2022 Sets must have a fair share of the work done by each dev involved\u2022 Each developer must publish at least 20 achievements to countAchievements must make sense; no fluff to fulfill requirement! 011 Happy Birthday RA!(Badge-Based) Develop a set for the Mega Drive/Genesis to celebrate the anniversary of RA's first achievement\u2022 Must be either full sets or a major/significant revision\u2022 Sega CD and Sega 32X games are not eligible.\u2022 Neither are those Sega 32X CD games (nice try!)\u2022 If you already have one claimed, you must be under 50% progress for it to count\u2022 Collabs are allowed so long as the work is visibly split. 012 Hacker's Habit(Badge-Based) Create two new sets for robust hacks.\u2022 Sets intended for this quest must be complete and encompass all notable content specific to the hack.\u2022 Acceptable hacks must be either complete overhauls that drastically change the level design, or introduce new mechanics that greatly change how you progress through the game.\u2022 Meme hacks, single-level hacks, and other small modifications aren't eligible.\u2022 You're limited to one hack per franchise. As an example, if you create a set for an SMW or Mega Man 2 hack, you can't make a second one for SM64 or Mega Man 3. 013 complete.me(Badge-Based) Provide significant content to three sets that are progression-only or were demoted due to being incomplete.\u2022 Choose from a provided list or grab one from a hub, just make sure you let us know when you start so we can mark it!\u2022 Must go through the revision process as per usual!\u2022 Make sure you take care with the set and don't just throw in a bunch of filler\u2022 Don't hesitate to contact us with any questions or suggestion 014 Laudable Leaderboards(Badge-Based) Create leaderboards for 10 games that currently do not have any!\u2022 Cover different game modes/difficulties when applicable.\u2022 Try to cover leaderboards that make sense for the game. Some examples:- For Arcade-type games it is fine to just add High Score leaderboards, possibly highest in a single life- For Racing games time trials for tracks are pretty standard- Speedruns for Platformers- Minigames that track high scores or time are good candidates- And so on. Reach out if you have any questions about a specific game\u2022 You can do your own sets for half-credit as long as they were published prior to this DevQuest (2022-03-02)\u2022 Please leave comments on set page for what you added for log purposes 015 Console Conqueror(Achievement-Based) Publish a set for every supported console on RetroAchievements\u2022 Each console ID will have an achievement associated with it. Newly supported console IDs means new achievements!\u2022 Contact us to opt-in to being tracked for this. There will generally be no need for reports.\u2022 The only requirement for an unlock is that you are the sole or majority developer of a set on that console ID. Collabs require at least 20 achievements made. For the more dire consoles, specific requirements are in the achievements themselves.\u2022 This DevQuest is 100% retroactive! Potential future revisions of your work will not count against you, so no worries about losing eligibility for an unlock."},{"location":"DevQuests/#suggestions","title":"Suggestions","text":"<ul> <li>If you have suggestions for a DevQuest, send a message to the DevQuest account with the following info:<ul> <li>Quest Name</li> <li>Award Type - If there is one specific goal then you would want a badge-based award. If there are multiple goals then you would want an achievement-based award. </li> <li>Game Type - State whether hacks, homebrews, prototypes, unlicensed, and/or subsets are allowed.</li> <li>Goal(s) - A brief description of the DevQuest. Examples: \"Develop a set for such-and-such console,\" \"Develop a Holiday-Themed Set,\" \"Create Dynamic Rich Presence for 10 Games,\" etc.</li> <li>Rules - List any specific guidelines and criteria that submissions must meet. Is there a minimum achievement count? Are there minor exceptions that result in half-credit? Do submissions need to be pre-approved? The more simple they are, the better!</li> </ul> </li> </ul>"},{"location":"Developer-Docs/","title":"Developer Docs","text":"<p>If you want to be an achievement developer, check here how to become a developer.</p> <p>Every Developer must know and adhere the Developer's Code of Conduct.</p> <p>Now a brief description some pages you'll see in this section.</p> <ol> <li> <p>How to Become an Achievement Developer: overview of the steps required in obtaining developer status</p> </li> <li> <p>Getting Started as an Achievement Developer: it's for the very first contact with cheevos development tools (Memory Inspector and other Achievements dialogs). IF YOU ARE A COMPLETE NEWBIE, START HERE!</p> </li> <li> <p>Achievement Scoring: a guide to deciding point totals for achievements</p> </li> <li> <p>Memory Inspector Overview: detailed look at one of an achievement developer's most used tools.</p> </li> <li> <p>Achievement Logic Features: describes the available tools a developer have in order to improve the logic behind the achievements, such as delta values, hit counts, ResetIf, PauseIf, Alt groups, etc.</p> </li> <li> <p>Real Examples: showing real examples and breaking down the logic behind them. AWESOME LEARNING RESOURCE!</p> </li> <li> <p>Achievement Templates: some generic templates to get inspiration.</p> </li> <li> <p>Tips and Tricks: general tips and tricks about memory digging and achievement creation.</p> </li> <li> <p>Difficulty Scale and Balance: guidelines/suggestions on how to balance the difficulty of your achievement set.</p> </li> <li> <p>Achievement Design: a guide on how to think about and design good achievements, not the technical side but the conceptual.</p> </li> <li> <p>Set Development Roadmap: suggestions of steps to take in order to create a really neat achievement set.</p> </li> <li> <p>Achievement Set Revisions: information on revisions, rescores, and the icon gauntlet.</p> </li> <li> <p>Subsets: an advanced topic on creating special challenge sets and how to release them.</p> </li> <li> <p>Badge and Icon Creation: some guidelines and tips about badge/icon creation.</p> </li> <li> <p>Leaderboards: instructions on how to create Leaderboards for a game.</p> </li> <li> <p>Rich Presence: how to write Rich Presence Scripts.</p> </li> <li> <p>Working with the Right ROM: information on using correct ROMs and hashes.</p> </li> <li> <p>Game Identification: details on the hashing methods used for each system.</p> </li> <li> <p>Emulator Support and Issues: details on both supported and unsupported cores, testing progress, etc.</p> </li> <li> <p>Achievements for ROM Hacks:  a detailed guide for developers on the proper inclusion (and approval) of ROM Hacks.</p> </li> <li> <p>Console Specific Tips: knowing the peculiarities of your favorite console can help you with memory digging.</p> </li> </ol>"},{"location":"Developer-Docs/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-08 03:08] televandalist:</code> Updated Developer Docs (markdown)</li> <li><code>[2023-06-08 03:07] televandalist:</code> Updated Developer docs (markdown)</li> <li><code>[2017-11-28 08:41] meleu:</code> Destroyed Developer Docs (markdown)</li> <li><code>[2017-11-28 08:36] meleu:</code> Created Developer Docs (markdown)</li> </ul>"},{"location":"Developer-Projects/","title":"Developer Projects","text":""},{"location":"Developer-Projects/#entries-that-have-been-re-linked-or-checked-by-developers","title":"Entries that have been re-linked or checked by Developers","text":"<p>Dev Checked and Relinked MD5s list</p> <p>Recently game linking has been restricted to developers only. (Something many of us have been requesting for some time.) This creates new solutions, problems and responsibilities for all of us developers.</p> <p>What needs to happen over time is that every entry is checked that is only has supported ROMs linked to it. Many entries have unsupported ROMs and Trainers linked to them which cause bugs and allow for cheating.</p> <p>This Shared document linked is how we will keep track of the entries that have been reviewed by a developer, unlinked and then relinked with the correctly entries, when necessary.</p>"},{"location":"Developer-Projects/#battery-savecode-protection","title":"Battery Save/Code Protection","text":"<p>The goal is implement protections so that no one can unlock groups of achievements from a save file or by using passwords. A list of games that need save protection: Open gSheet master list</p>"},{"location":"Developer-Resources/","title":"Developer Resources","text":""},{"location":"Developer-Resources/#helpful-website-links","title":"Helpful Website Links","text":"<ul> <li>https://datacrystal.romhacking.net/wiki/Main_Page  - Defined RAM maps of many games.  </li> </ul> <ul> <li>http://www.thealmightyguru.com/Games/Hacking/Wiki/index.php?title=Category:Games - Defined RAM maps of many NES games.  </li> </ul> <ul> <li>https://gamehacking.org/ - Action Replay codes can be used to get defined memory address:  </li> </ul> <p>Y \u2013 Address, X \u2013 Value 1-2 digit value will always be 8 bit \u2013 use 2 in front \u2013 22YYYYYY 000000XX 3-4 digit value will always be 16 bit \u2013 use 1 in front \u2013 12YYYYYY 0000XXXX 5-8 digit value will always be 32 bit \u2013 use 0 in front \u2013 02YYYYYY XXXXXXXX This will work for Action replay codes.  </p> <p>For getting addresses out of GameGenie codes use this: (outdated link, getting 404) http://www.d.umn.edu/~bold0070/projects/game_genie_codes/javascript_game_genie_encoders-decoders.html</p> <ul> <li>https://www.romhacking.net/ - biggest repository of hacked roms.  </li> </ul> <ul> <li>https://tcrf.net/The_Cutting_Room_Floor - Great place to find Easter Eggs for your set plans.</li> </ul> <ul> <li>https://www.gamefaqs.com/ - Great place to find game guides, finding almost all you could want to know about game content, find cheat codes, for development utility and also for making proper protections against the codes.</li> </ul> <ul> <li>https://wiki.nesdev.com/w/index.php/CPU_memory_map - Shows sections of the NES memory so you'll know what area of the memory you're examining. For nes most useful addresses will be between 0x0000--0x07FF.</li> </ul> <ul> <li>https://datacrystal.romhacking.net/wiki/Hashes - Explains what hashes are. If you don't know what they are you should probably read this.</li> </ul> <ul> <li>https://emn178.github.io/online-tools/crc32_checksum.html - Drag and drop checksum checker utility. You can also get the checksum from the rom you have loaded from the retroachievements menu in the emulators.</li> </ul> <ul> <li>https://www.getpaint.net/ - Excellent freeware image editor. You can use it for making badges and icons.</li> </ul> <ul> <li>https://www.marcrobledo.com/RomPatcher.js/ - An online ROM patcher utility.</li> </ul> <ul> <li>https://gregstoll.dyndns.org/~gregstoll/floattohex/ - Floating point to decimal converter</li> </ul> <ul> <li>http://jsonviewer.stack.hu/ - Excellent for viewing raw achievements</li> </ul> <p>Turns this: </p> <p>Into this: </p> <p>Or get a plugin for Notepad++: - http://jsminnpp.sourceforge.net/ to do similar</p> <p>Speaking of Notepad++ - https://notepad-plus-plus.org/download/ - One of the best text editors and it's freeware (Windows only).</p>"},{"location":"Developer-Resources/#achievement-syntax","title":"Achievement Syntax","text":"<p>This is a good reference sheet, it's especially useful for Rich Presence and Leaderboards, getting your deltas and bit labels right.  For full size, right click an save image.</p> <p>A 32bit requires the prefix \"X\" as in 0xX63</p>"},{"location":"Developer-docs-es/","title":"Intro","text":"<p>Si estas interesado en ser desarrollador, deberias checar aqui, como convertirme en desarrollador.</p> <p>Todo desarrollador tiene que conocer el codigo de conducta del desarrollador.</p> <p>Ahora una breve descripcion de algunas de las paginas que encontraras en esta seccion</p> <ol> <li> <p>Empezando como un desarrollador de Logros: el primer contacto con las herramientas de desarrollo de logros (Inspector de Memoria y otros cuadros de dialogos). SI ERES COMPLETAMENTE UN NOVATO, EMPIEZA AQUI!</p> </li> <li> <p>Caracteristicas en la Logica de Logros: describe las herramientas disponibles con las que un desarrollador cuenta para trabajar la logica detras de un logro, como valores deltas, hit counts, ResetIf, PauseIf, Alt groups, etc.</p> </li> <li> <p>Ejemplos-Reales: mostrando resultados verdaderos y desglosando la logica detras de los logros. RECURSO INDISPENSABLE PARA APRENDER!</p> </li> <li> <p>Tips y Trucos: tips generales y trucos sobre como navegar en la memoria y creacion de logros.</p> </li> <li> <p>Tips especificos por Consola: conociendo las peculiaridades de tu consola favorita puede ayudar mientras nadas en la memoria.</p> </li> <li> <p>Plantillas para Logros: algunas plantillas genericas para que te inspires.</p> </li> <li> <p>Escala de Dificultad y Balance: guias/sugerencias en como balancear la dificultad de un set de logros.</p> </li> <li> <p>Creacion de Medallas e Iconos: algunas guias y tips sobre creacion de medallones/iconos.</p> </li> <li> <p>Tablas de Clasificaci\u00f3n: instrucciones en como crear tablas de clasificacion para un juego.</p> </li> <li> <p>Rich Presence: como escribir Scripts para Rich Presence.</p> </li> <li> <p>Mapa de desarrollo de un Set: pasos a considerar para crear realmente un gran set de logros.</p> </li> <li> <p>Dise\u00f1o de logros: una guia en como pensar y dise\u00f1ar buenos logros, no el lado tecnico sino el conceptual.</p> </li> <li> <p>Guia para Set Bonus: un tema avanzado para crear sets con retos especiales y como lanzarlos.</p> </li> <li> <p>Logros para Hacks de ROMs:  una guia detallada para desarrolladores en la inclusion apropiada (y el aprovamiento) para Hacks de ROMs.</p> </li> </ol>"},{"location":"Developer-docs-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 14:54] meleu:</code> Updated Developer docs pt_ES (markdown)</li> </ul>"},{"location":"Developer-docs-pt_BR/","title":"Introdu\u00e7\u00e3o","text":"<p>Estas s\u00e3o as p\u00e1ginas que todos os desenvolvedores novatos deveriam ler e entender primeiro:</p> <ol> <li>Come\u00e7ando como um desenvolvedor de conquistas</li> <li>Caracter\u00edsticas de L\u00f3gicas de Conquistas</li> <li>Exemplos Reais</li> <li>Modelos de Conquistas</li> </ol> <p>Agora uma breve descri\u00e7\u00e3o de cada p\u00e1gina que voc\u00ea ver\u00e1 nesta se\u00e7\u00e3o:</p> <ol> <li> <p>Come\u00e7ando como um desenvolvedor de conquistas: Est\u00e1 aqui para todo primeiro contato com as ferramenta de desenvolvimento de conquistas (Memory Inspector e outros Di\u00e1logos de conquistas). SE VOCE \u00c9 UM COMPLETO INICIANTE, INICIE AQUI!</p> </li> <li> <p>Recursos de L\u00f3gica para Achievements: Descreve as ferramentas dispon\u00edveis para um desenvolvedor tem em ordem para melhorar a l\u00f3gica por tr\u00e1s das conquistas como os valores desta, contador de Hits, ResetIf, PauseIf, Grupos Alt, etc.</p> </li> <li> <p>Exemplos Reais: mostrando exemplos reais e quebrando a l\u00f3gica por tr\u00e1s delas. RECURSO DE APRENDIZAGEM INCR\u00cdVEL!</p> </li> <li> <p>Dicas e Truques: Dicas e truques gerais sobre a escava\u00e7\u00e3o de mem\u00f3ria e cria\u00e7\u00e3o de conquistas.</p> </li> <li> <p>Dicas espec\u00edficas do Console: sabendo as peculiariedades do seu console (video-game) favorito pode ajudar voc\u00ea com a escava\u00e7\u00e3o de mem\u00f3ria</p> </li> <li> <p>Modelos de Conquistas: Alguns modelos gen\u00e9ricos para ganhar inspira\u00e7\u00e3o</p> </li> <li> <p>Escala de Dificuldade e Equilibrio: Sugest\u00f5es de como balancear a dificuldade da conquista de seu set.</p> </li> <li> <p>Cria\u00e7\u00e3o de \u00cdcone e Emblemas: Algumas sugest\u00f5es e dicas sobre a cria\u00e7\u00e3o de icone</p> </li> <li> <p>Leaderboards: Instru\u00e7\u00f5es de como criar Leaderboards para um jogo.</p> </li> <li> <p>Rich Presence: Como criar Scripts Rich Presence</p> </li> <li> <p>Roteiro de Desenvolvimento do Set: Sugest\u00f5es de passos para conduzir em ordem como criar um set arrumado</p> </li> <li> <p>Design de Conquistas: Um guia de como pensar e desenvolver boa conquistas, n\u00e3o a parte t\u00e9cnica, mas a parte conceitual.</p> </li> <li> <p>Guia de Bonus Set: Um t\u00f3pico avan\u00e7ado em criar set especiais de desafios e como lan\u00e7ar eles.</p> </li> <li> <p>Conquistas para Hack ROM: Um guia detalhado para desenvolvedores sobre a inclus\u00e3o apropriada (e aprova\u00e7\u00e3o) de Hack ROMs</p> </li> </ol>"},{"location":"Developer-docs-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-14 14:12] meleu:</code> typo</li> <li><code>[2018-05-14 14:11] meleu:</code> fixed achievement design link</li> <li><code>[2018-03-28 20:01] meleu:</code> Revert 3fbd6b9a6ffb69506933a1b1ab0940463f76256c...dfa2f71466a52945a73853134bea13c0068224ad on Developer docs pt_BR</li> <li><code>[2018-03-28 20:00] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-28 11:08] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-28 11:08] meleu:</code> Updated Developer docs pt_BR (markdown)</li> <li><code>[2018-03-24 23:39] meleu:</code> Created Developer docs pt_BR (markdown)</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/","title":"C\u00f3digo de Conducta del Desarrollador","text":"<p>Este documento expone los derechos, responsabilidades y reglas para desarrolladores.</p> <p>Si tu no eres un desarrollador deberias checar aqui, como me convierto en un desarrollador.</p> <p>Checa tambien: Codigo de conducta del usuario.</p>"},{"location":"Developers-Code-of-Conduct-es/#reglas-de-oro","title":"Reglas de Oro","text":"<ol> <li>Respeta a tu compa\u00f1ero desarrollador y comunica cualquier problema que tengas civilmente.</li> <li>Haz espacio para otros desarrolladores puedan trabajar en juegos que ellos tambien quieren, en su propia manera.</li> <li>Cualquiera puede convertirse en desarrollador si hace el suficiente esfuerzo.</li> <li>Todos los sets de logros estan abiertos para mejoras.</li> </ol>"},{"location":"Developers-Code-of-Conduct-es/#resumen-los-desarrolladores-tienen-que-seguir-lo-siguientes-puntos-para-estar-en-buenos-terminos","title":"Resumen - Los Desarrolladores tienen que seguir lo siguientes puntos para estar en buenos terminos","text":"<ul> <li>Cuando planees trabajar en un nuevo juego reservalo anunciando el plan basico en el foro del juego en un nuevo post.</li> <li>Solo anuncia nuevos planes cuando tu estes libre de tickets. Sigue las reglas de reservacion tambien.</li> <li>Espera 3 dias despues que hubieras posteado tus planes para promober cualquiera de los logros a core.</li> <li>Manten tu trabajo libre de conceptos-no bienvenidos.</li> <li>Usa codigo protectivo para prevenir cheating y exploits potenciales.</li> <li>Deja notas de codigo precisas para cada condicion de logro que utilices.</li> <li>Para revisiones de set, sigue la politica de revision.</li> <li>Resuelve tickets, y deja notas cada vez que lo hagas.</li> <li>Una vez que publiques tu trabajo, estas dejando que la comunidad rese\u00f1e y lo retrabaje a traves del tiempo.</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#antes-de-empezar","title":"Antes de empezar","text":""},{"location":"Developers-Code-of-Conduct-es/#estas-libre-de-tickets","title":"Estas libre de tickets?","text":"<p>Antes que trabajes en nuevos juegos tienes que resolver todos los tickets con los que cuentes. Una vez que estes libre tickets, entonces adelante.</p>"},{"location":"Developers-Code-of-Conduct-es/#el-juego-esta-presente-en-la-base-de-datos","title":"El juego esta presente en la base de datos?","text":""},{"location":"Developers-Code-of-Conduct-es/#no","title":"No","text":"<p>Entonces pregunta para que sea agregado por medio de Discord #help-me o en nuestros foros para que algun desarrollador lo agregue por ti. Es esencial que tu elijas el ROM(s) correcto para trabajar. Si quieres trabajar en un hack, checa logros para hacks de ROM doc first.</p>"},{"location":"Developers-Code-of-Conduct-es/#si","title":"Si","text":"<p>Bien! adelante.</p>"},{"location":"Developers-Code-of-Conduct-es/#el-juego-ya-cuenta-con-un-set-de-logros","title":"El juego ya cuenta con un set de logros?","text":""},{"location":"Developers-Code-of-Conduct-es/#yes","title":"Yes","text":"<p>Si existe un set, no te rindas. Aun lo puede mejorar, agregando/removiendo/re-trabajando logros, o haz cambios a titulos e imagenes, etc. Sin embargo tendras que pasar por el proceso de revision de tu set.</p>"},{"location":"Developers-Code-of-Conduct-es/#no_1","title":"No","text":"<p>Busca delicadamente. Algunas veces hay multiples entradas en la base de datos para el mismo juego con diferente titulos. Una vez que este seguro, ahora necesitas checar si hay otro desarrollador trabajando en el juego.</p> <p>Nota: Solo un set de logros es permitido por el mismo juego y consola. Para detalles mira trabajando con el ROM correcto.</p>"},{"location":"Developers-Code-of-Conduct-es/#hay-otros-desarrollor-trabajando-en-el-juego","title":"Hay otros desarrollor trabajando en el juego?","text":"<p>Para estar seguro que no hay otro desarrollador trabajando en ese juego, checa el foro oficial del juego (esa es la manera oficial de reservar el juego en el que quieres trabajar). Esto es necesario para evadir conflictos entre multiples desarrolladores trabajando en el mismo juego.</p>"},{"location":"Developers-Code-of-Conduct-es/#si_1","title":"Si","text":"<p>Podria ser posible que el desarrollor hubiera dejado de trabajar en ellos. Se espera que el desarrollador renueve su reservacion cada dos meses. Mira en las etiquetas de tiempo para ver cuando el desarrollador postio su reservacion de desarrollo. Si el desarrollador no a clarificado o renovado su reservacion despues de que hubieran pasado dos meses puedes asumir que fue abandonado y asi postear tus planes de trabajo.</p>"},{"location":"Developers-Code-of-Conduct-es/#no_2","title":"No","text":"<p>Perfecto! Adelante! El siguiente paso es anunciar tus planes para desarrollar logros para el juego.</p>"},{"location":"Developers-Code-of-Conduct-es/#anunciando-tus-planes-para-trabajar-en-un-juego","title":"Anunciando tus planes para trabajar en un juego","text":"<p>Anunciar tus planes para el set de logros se hace en el foro oficial del juego del que tienes en mente crear el set.</p> <p>Postear tus planes es tu manera de reservar oficialmente un juego, sin embargo hay algunas reglas sobre el apartado sets que tienes que tener en cuenta.</p>"},{"location":"Developers-Code-of-Conduct-es/#notas-importantes","title":"Notas Importantes","text":"<ul> <li>No hay necesidad de que dejes un plan completo y detallado! Simplemente una idea general de cuales son tus intenciones (tus planes son muy probables que cambien una vez que hubieras investigado la memoria del juego). Haz esto para que la comunidad pueda dejar recomendaciones y puede proveer retroalimentacion.</li> </ul> <ul> <li>Intenta estar abierto a recomendaciones. Si no estas de acuerdo con la retroalimentacion recivida, puedes continuar con tu concepto. Pero recuerda tener lo siguiente en mente:     - Tienes que aderirte al Reglamento de Dise\u00f1o Basico de Logros, de otra manera tu set no sera aprovado.     - Cuando tu publicas tu trabajo estas dejando a la comunidad para que sea rese\u00f1ado y re-trabajado sobre el paso del tiempo.</li> </ul> <ul> <li>Si alguien escogio un juego del cual tu estas interesado antes que tu, no te desesperes. Te animamos a solicitar una colaboraci\u00f3n. Puedes publicar tu deseos de colaborar en el foro o mandar un mensaje al desarrollador para obtener permiso para que publique tus contribuciones. Tambien puedes esperar e ir por una Revision de Set after the set is published.</li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#reglas-para-reservar-juegos-para-desarrollo","title":"Reglas para reservar juegos para desarrollo","text":"<p>Las siguientes reglas existen para saber facilmente quien esta trabajando en que, definir que es aceptable, prevenir que el desarrollo de juegos no se estanque, proteger a los desarrolladores de indebida presion social.</p> <ol> <li> <p>La unica manera de reservar un juego es posteando tu plan en el foro oficial del juego en un nuevo post.     - No otros planes o listas posteadas en cualquier otro luegar son consideradas en esto.     - Notas de codigo no reservan un juego (si agregaste notas pero no reservaste el juego en el foro, cualquier desarrollador es libre de trabajar en el).</p> </li> <li> <p>Numero maximo de juegos reservados a la vez:     - Desarrollador Junior: 1.     - Desarrollador: 4.     - Desarrollador Veterano: 8 (un Desarrollador Veterano es alguien que a sido un desarrollador por minimo 18 meses y a publicado un minimo de 20 sets de logros).     - Nota: Trabajar en una revision aprovada o unirte con otro desarrollador en un esfuerzo cooperativo no cuenta para este total.</p> </li> <li> <p>Solo reserva un juego para desarrollo cuando realmente ya vaz a empezar a trabajar en el. En otras palabras, no reserves juegos simplemenete para blockear otros usuarios en trabajar en ellos.</p> </li> <li> <p>Puedes renovar tu reservacion cada dos meses (+/- 2 semanas) si no haz terminado tu set aun.     - Para renovar tu reservacion, postealo en el foro oficial del juego.     - No edites tus antiguas declaraciones, haz un nuevo post hablando del progreso actual.     - Evita ignorar un set indefinidamente. Si parece que un desarrollador continua retrasando el desarrollo de un set con poco o sin progreso el staff puede intervenir.</p> </li> <li> <p>No pidas, presiones o desalentes a nadie en trabajar en cualquier juego, en publico o en privado (claramente, asumiendo que la persona esta siguiendo todos los otros estandartes de este Codigo de Conducta).</p> </li> <li> <p>Una vez que hubieras posteado tu plan, espera un minimo de 72 hours antes de promover cualquier logro a Core. Esto le da tiempo a la comunidad de renovar tu plan y dar retro-alimentacion. Este periodo de espera empieza despues que tu plan este presente y esta en su forma completa (o mayormente completa).</p> </li> </ol>"},{"location":"Developers-Code-of-Conduct-es/#reglamento-de-diseno-basico-de-logros","title":"Reglamento de Dise\u00f1o Basico de Logros","text":""},{"location":"Developers-Code-of-Conduct-es/#conceptos-no-bienvenidos","title":"Conceptos No-Bienvenidos","text":"<p>Tu puedes (y deberias) se lo mas creativo que puedas, pero hay algunos conceptos que NO estan bienvenidos para logros, como: - Requirir el uso de glitches (aceptable en Sets Bonus). - Requieren dos jugadores. - Requiere perfeccion por todo el juego (talvez aceptable in Sets Bonus). - Morir (simplemente), o juega mal sin ningun proposito. - Contenido no apropiado (NSFW) en la imagen o texto. - Logros saltando frecuentemente con poco esfuerzo del jugador (incluyendo multiples logros por hacer la misma tarea, como vencer al jefe y otro por conseguir el item que dejo el jefe , etc.) - Logros obtenibles con zero esfuerzo sin razon alguna (ejemplo: empieza el juego con x personaje, colecciona una moneda). Es acceptable si hay algo divertido/historico/interesante que quieres tocar. - Se requiere grinding repetitivo y excesivo, asi como llega a level 99 en un RPG, sin razon alguna (talvez aceptable en Sets Bonus). - Se basa completamente en suerte, especialmente cuando hay probabilidades realmente bajas. Sin embargo, para juegos que el factor aleatorio es un aspecto importante, podria ser apropiado. - \"Logros Secretos\", cuando los jugadores no tiene indicacion de que es lo que tienen que hacer. Si quieres prevenir spoilers da minimo una pista en el titulo o descripcion. De otra manera los jugadores van a empezar a buscar en la web o van a moverle al editor de Logros/Inspector de Memoria, y en el proceso pueden incluso toparse con peores spoilers.</p> <p>Con cada regla, hay un excepcion. Esta es especialmente verdad con conceptos no-bienvenidos. Todos los conceptos no-bienvenidos tienen un margen de aprovacion. cuando te encuentres en dudas puedes consultar con el equipo de administradores.</p>"},{"location":"Developers-Code-of-Conduct-es/#cada-set-de-logros-tiene-que-tener","title":"Cada Set de logros TIENE que tener","text":"<p>Proteccion para situaciones donde los jugadores puedes conseguir logros sin esfuerzo, como:</p> <ul> <li>Modo Demo;</li> <li>Cheat codes en el juego;</li> <li>Archivos de guardado;</li> <li>Passwords.</li> </ul> <p>Tambien mira: Plantillas para logros y Ejemplos reales para algunas tecnicas de proteccion bien conocidas.</p>"},{"location":"Developers-Code-of-Conduct-es/#cada-set-de-logros-deberia-tener","title":"Cada Set de logros DEBERIA tener","text":"<ul> <li>Minimo Rich Presence basico; </li> <li>Medallas (Badges) para cada Logro; </li> <li>Todo la informacion del juego llena, e imagenes del juego subidas.</li> </ul> <p>Nota: Rich Presence, Tablas de clasificacion, y paginas del juego imagenes/informacion solo pueden ser agregadas por verdaderos desarrolladores</p>"},{"location":"Developers-Code-of-Conduct-es/#recomendado-pero-no-requerido-por-cada-set-de-logros","title":"Recomendado pero no requerido por cada Set de logros","text":"<ul> <li>Tablas de clasificacion para puntajes y retos de tiempo.</li> <li>Logros Perdidisos flageados, especialmente para RPGs y juegos largos.      - Utiliza <code>[m]</code> al final del titulo del logro para flaggearlo como perdidiso.</li> <li>Una guia de logros. Guias pueden ser creadas y posteadas aqui. </li> </ul>"},{"location":"Developers-Code-of-Conduct-es/#herramientas-para-ayudarle-a-tener-exito","title":"Herramientas para ayudarle a tener \u00e9xito","text":"<p>Tenemos un We have a mapa que puedes utilizar como guia para crear un buen set de logros. Tambien tenemos una guia de dise\u00f1o de logros en como dise\u00f1ar buenos logros, no el lado tecnico pero si el conceptual. Crear un set balanceado es uno de los aspectos mas dificiles de desarrollo, tenemos una guia de balance de dificultad que te podria ayudar en pensar como crear un set que fluya.</p> <p>Es preferible y recomendado trabajar en un set a la vez. Pero si tienes mas, ten abiertas posibilidades para trabajar en equipo o incluso delegar la creacion de un set si otro desarrollador te contacta.</p>"},{"location":"Developers-Code-of-Conduct-es/#revisiones-trabajando-en-sets-que-ya-cuentan-con-logros","title":"Revisiones - Trabajando en Sets que ya cuentan con logros","text":"<p>Revisiones, si estas trabajando en un set que ya cuenta con logros tipicamente requiere aprovacion por la comunidad, presentando tu plan en el foro y en el canal de #revision-voting en Discord. No todos los cambios requieren aprovacion. Mira Revisiones de Sets de Logros para mas detalles.</p>"},{"location":"Developers-Code-of-Conduct-es/#notas-de-codigo","title":"Notas de Codigo","text":"<p>Deja notas precisas para cada valor que utilizes en un logro. Esto te ayuda a ti y a otros de mantener el set libre de bugs.</p> <p>Eres libre de agregar todos las notas que quieras en el juego sin incluso a ver declarado tus intenciones en trabajar en ese juego. Simplemente se cuidadoso en no borrar notas de codigo creadas por otros usuarios.</p>"},{"location":"Developers-Code-of-Conduct-es/#manejo-de-tickets","title":"Manejo de Tickets","text":"<p>Despues que hubieras publicado tus logros preparate para reportes de bugs.</p> <p>Se supone que tienes que dejar tu trabajo libre de bugs con el manejo de tickets y resolviendolos. Responde a todos los tickets lo mas pronto posible. Mientras mas pronto mejor, porque el problema esta fuera de la mente del jugador y puedes utilizarlo como ayuda para resolver el problema tambien.</p> <p>Mientras resuelves tickets, deja un peque\u00f1o resumen de lo que hiciste. Si tienes una indicacion o un reporte falso deja un mensaje cuales fueron tus conclusiones, y entonces cierra el ticket. Cerrar/Resolver un ticket sin dejar ningun comentario es una actitud no-bienvenida.</p> <p>No declares tus planes de trabajar en un juego si cuentas con tickets abiertos.</p> <p>Si tienes planeado resolver tickets o arreglar bugs en logros hechos por otro desarrollador, siempre es una buena practica intentar contactarlo si aun se encuentra activo antes de modificar su trabajo. Un desarrollador inactivo es alguien que cuenta con 10 o mas tickets abiertos y tienen un minimo de dos meses de antiguedad (puedes ver sus tickets abiertos desde el Ticket Manager).</p> <p>Si el desarrollador esta activo, puedes simplemente hecharle una ayuda con la solucion.</p> <p>Si el desarrollador esta inactivo puedes libremente resolverle sus tickets. Sin embargo solamente tienes permitido arreglar el logro con lo que dice en su descripcion; no cambies la intencion de logro sin haber pasado por el proceso de revision.</p>"},{"location":"Developers-Code-of-Conduct-es/#propiedad-de-los-logros","title":"Propiedad de los logros","text":"<p>Cuando tu publicas tu trabajo tu se lo estas dando a la comunidad para que sea rese\u00f1ado y re-trabajado con el paso del tiempo - mira Revisiones en un Set. </p> <p>Aunque los logros publicados por un desarrollador no son propiedad de el, el aun es el encargado en terminos de arreglar y dar mantenimiento. Si otro jugador corrige el logro el es el nuevo encargado de ese logro.</p>"},{"location":"Developers-Code-of-Conduct-es/#retroalimentacion-sobre-el-codigo-de-conducta-del-desarrollador","title":"Retroalimentacion sobre el Codigo de Conducta del Desarrollador","text":"<p>A pesar de que el Codigo de Conducta del Desarrollador es el resultado de un intenso debate, no es un documento absoluto. Si tiene sugerencias para nuevas mejoras, contactanos en nuestro servidor de Discord o manda un mensaje a RAdmin.</p>"},{"location":"Developers-Code-of-Conduct-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 14:58] meleu:</code> Updated Developers Code of Conduct ES (markdown)</li> </ul>"},{"location":"Developers-Code-of-Conduct/","title":"Developer's Code of Conduct","text":"<p>This document covers developers' rights, responsibilities, and rules for fair play.</p> <p>If you are not a dev, check how to become a developer.</p> <p>See Also: Users Code of Conduct.</p> <ul> <li>Golden Rules</li> <li>Developers must do the following to keep in good standing</li> <li>Revisions - Working on Sets with Existing Achievements</li> <li>Expiration of Developer Status</li> <li>Achievement Ownership</li> <li>Feedback about the Developer Code of Conduct</li> </ul>"},{"location":"Developers-Code-of-Conduct/#golden-rules","title":"Golden Rules","text":"<ul> <li>Follow the Developer and Content Guidelines the best you can. When in doubt, ask.</li> <li>Respect your fellow developer and communicate through any issues you have civilly.</li> <li>Make room for other developers to get a chance to work on games they like, in their own way.</li> <li>Do not discourage anyone from working on any game, in public or in private.</li> </ul>"},{"location":"Developers-Code-of-Conduct/#developers-must-do-the-following-to-keep-in-good-standing","title":"Developers must do the following to keep in good standing:","text":"<ul> <li>Keep your work free from unwelcome concepts.</li> <li>Use protective code, preventing potential cheating and exploits.</li> <li>Leave accurate code notes for each achievement condition you use.</li> <li>For set revisions, follow the revision policy.</li> <li>Resolve tickets and leave notes each time you do.</li> <li>Like a wiki, once you publish your work, you are giving it over to the community to be reviewed and reworked over time.</li> </ul>"},{"location":"Developers-Code-of-Conduct/#revisions-working-on-sets-with-existing-achievements","title":"Revisions - Working on Sets with Existing Achievements","text":"<p>Revisions, as in working on a set that has existing achievements typically requires community approval by presenting your plan in the forum and in the #revision-voting channel in Discord. Not all changes need approval. See Achievement Set Revisions for details.</p>"},{"location":"Developers-Code-of-Conduct/#expiration-of-developer-status","title":"Expiration of Developer Status","text":""},{"location":"Developers-Code-of-Conduct/#inactivity","title":"Inactivity","text":"<p>The developer status will expire and account type will be set to <code>[Registered]</code> if the following conditions are met: </p> <ul> <li>Developers: Inactivity as developer for 6 months or overall inactivity for 3 months. </li> <li>Jr. Developers: Inactivity as developer or overall inactivity for 1 month.</li> </ul> <p>It is important for developers to remember that this is NOT a punishment and is only done for security reasons!</p> <p>Inactivity as a developer will be defined as: - Has not made or renewed a set claim. - Has not created new achievements. - Has not performed maintenance on existing sets (revisions, rescores, badge changes, etc.) - Has not resolved, closed, or otherwise addressed any open tickets, theirs or otherwise.</p>"},{"location":"Developers-Code-of-Conduct/#negligence","title":"Negligence","text":"<p>Alternatively, developer status will be removed if the developer has 10 or more tickets that are at least 2 months old. If the developer has any active claims during this period, they will be given an additional 30 days or until the earliest claim renewal (whichever comes first) to resolve all 10 tickets. Not doing so will result in the developer falling into inactive status and the claim(s) being released.</p>"},{"location":"Developers-Code-of-Conduct/#reinstatement","title":"Reinstatement","text":"<p>If a user's developer status was removed due to inactivity and they wish to have it reinstated, they must contact Dev-Compliance. However, before doing so, it is recommended to review any changes that were made to the Developer Code of Conduct, updates to the achievement creation tools, and have a plan to address open tickets for their achievements, if applicable.</p> <p>The steps involved in reinstatement will vary from user to user depending on the following: - The amount of time elapsed since developer status was removed. - The amount of tickets that may have been opened on their achievements.  - Other QA issues that may have come up since developer status was removed. - Moderation warnings or actions the user may have received.</p> <p>A user may be required to submit work to code reviewers if more than a year has passed since their developer status was removed or if they initially obtained developer status before the junior developer program existed (July 2018) and did not retroactively obtain the Junior Developer badge.</p> <p>Note: Achievements edited by other developers will not count against a user seeking reinstatement.</p>"},{"location":"Developers-Code-of-Conduct/#achievement-ownership","title":"Achievement Ownership","text":"<p>When you publish your work you are giving it over to the community to be reviewed and reworked over time - see Achievement Set Revisions. </p> <p>While the original developer does not own published achievements, they are still the caretaker in terms of bug fixing and maintenance. If another developer revises the achievement, they are the new caretaker of that achievement.</p>"},{"location":"Developers-Code-of-Conduct/#changing-accounts","title":"Changing Accounts","text":"<p>If a user with either Developer or Jr. Developer status changes accounts, achievements and tickets under the old account will be re-authored and reassigned to the new account.</p>"},{"location":"Developers-Code-of-Conduct/#feedback-about-the-developer-code-of-conduct","title":"Feedback about the Developer Code of Conduct","text":"<p>Although the Developer Code of Conduct is the result of an intense debate, it's not an immutable document. If you have suggestions for improvements, contact us on our Discord server or send a message to RAdmin.</p>"},{"location":"Developers-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-25 18:42] Hotscrock:</code> Adjust on Jr. Developers inactivity rule</li> <li><code>[2023-06-11 22:48] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> <li><code>[2023-06-04 19:49] televandalist:</code> Removed Code Notes section in favor of the page under Content Guidelines</li> <li><code>[2023-06-04 19:38] televandalist:</code> Removed \"Reserving a game for achievement development\" section in favor of the \"Claims System\" page.</li> <li><code>[2023-06-04 19:11] televandalist:</code> Reverted the \"Developer and Content Guidelines\" change from the last edit.</li> <li><code>[2023-06-04 19:05] televandalist:</code> Golden Rules: \"Developer and Content Guidelines\" -&gt; \"Content Guidelines\" | \"Do not ask, pressure or discourage\" -&gt; \"Do not discourage\"</li> <li><code>[2023-06-04 18:53] televandalist:</code> Changed the Golden Rules based on a proposal and vote</li> <li><code>[2023-06-03 04:00] televandalist:</code> Removed \"Editing Leaderboards\" section since it has been moved to \"Content Guidelines\"</li> <li><code>[2023-06-02 20:36] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> <li><code>[2023-06-02 20:30] televandalist:</code> Updated Developers Code of Conduct (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-es/","title":"Escala de Dificultad y Balance","text":"<p>Este documento tiene algunas sugerencias sobre dificultad, balance de un set y sobre mantener un set divertido, amigable, y retador. Lo que estas apunto de ver no son reglas, solamente sugerencias.</p> <p>Nota: ten encenta el C\u00f3digo de Conducta del Desarrollador</p>"},{"location":"Difficulty-Scale-and-Balance-es/#escala-de-dificultad","title":"Escala de Dificultad:","text":"<ol> <li>Regalado</li> <li>Facil</li> <li>Medio</li> <li>Med-dificil</li> <li>Dificil</li> <li>Muy-Dificil</li> <li>Super-Dificil</li> </ol> <p>Mas detalles sobre estos al final.</p> <p>En general tiene que a ver un balance de dificultad uniforme. Uno tiene que pensar en la dificultad en general del set mientras los construyes. Uno no tiene que hacer sets excesivamente dif\u00edciles.</p> <p>Un buen balance en un set de 50 logros en promedio deber\u00eda de tener aproximadamente: 4 regalados, 6 logros f\u00e1ciles, 10 medianos, 10 med-dif\u00edcil, 14 dif\u00edciles, y 6 muy-dificiles, 0 kaizo (super-dif\u00edcil).</p> <p>Una distribuci\u00f3n de dificultad balanceada recompensa a cada tipo de jugador. Le da a cada nivel de habilidad algo que completar hasta que lo dominas por completo.</p> <p>Los logros no tienen que ser solamente una palomita por completar el juego, (muy f\u00e1cil) crea nuevas memorias divertidas con el juego (diversidad de logros).</p> <p>Deja espacio para logros regalados que cuenten con cosas curiosas o divertidas del juego. Se espera la suficiente dificultad para que puedes dominar un set y as\u00ed decir que eres un maestro del juego. Pero tampoco necesita pedir demasiado para el jugador.</p> <p>Tampoco no tienes que pedirle al jugador que haga tareas interminables y repetitivas solo para que un logro sea dificil. Hacer la misma tarea una y otro y otra vez no es dificil, es tipicamente aburrido. Tambi\u00e9n deber\u00edas de evitar hacer logros estilo marat\u00f3n con una colina hasta el final (aquellos que requiere un proceso largo con poca o repetitiva dificultad y entonces aparece un pico de dificultad enorme al final. No lo hagas!).</p> <p>Los Sets tienen que ser masterizados por un jugador con habilidad, que puso la dedicaci\u00f3n y esfuerzo necesario.</p> <p>Un Set tiene que reflejar el contenido del juego. Logros de \u00a8grindear\u00a8 en juegos que requieren grinding son razonables, que en otros cazos podr\u00edan ser inapropiados.</p> <p>Un Set tambi\u00e9n deber\u00eda de romper lo que se espera de un juego, motivando al jugador a encontrar nuevas soluciones a  problemas que ni un jugador veterano hubiera considerado.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#cantidad-del-set","title":"Cantidad del Set:","text":"<p>La cantidad de logros en un Set realmente no tiene reglas. La Calidad es un factor clave.</p> <p>La cantidad de logros depende fuertemente en la diversi\u00f3n y retos que un juego puede otorgar. Es por eso que el desarrollador del set tiene que conocer al juego muy bien.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#variedad-en-el-set","title":"Variedad en el Set:","text":"<p>Mantenlo divertido, entrega variedad, reto al jugador, entrega al jugador nuevas cosas que hacer.</p> <p>Algunos logros pueden pueden ser muy divertidos para el jugador cuando son como un meta-game. Cuando el jugador tiene que pensar el juego enteramente.</p> <p>Algunos ejemplos notables:</p> <ul> <li>Fabulous ComboFabulous Combo (15) - convierte al juego en un juego de puzzle, completar esto es bastante gratificante</li> </ul> <ul> <li>Swordless Adventurer (20) - sin espada estas obligado a repensar el juego por completo. Puedes incluso descubrir que tan \u00fatiles son las sub-armas. Muy divertido!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - retos pacifistas, cuando fuerzan al jugador a tener mas agilidad y romper viejos h\u00e1bitos. Muy divertido!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-es/#definiciones-sobre-la-dificultad","title":"Definiciones sobre la Dificultad","text":""},{"location":"Difficulty-Scale-and-Balance-es/#0-regalado","title":"0 - regalado","text":"<p>Tienen casi no esfuerzo para b\u00e1sicamente todo tipo de jugador para conseguirlo OR el jugador lo consigue sin poner consientemente un esfuerzo. El jugador lo obtiene por accidente y salta en la pantalla. Algunas veces el jugador ni siquiera tiene idea de porque lo consigui\u00f3. Algunos logros regalados son buenos algunos son malos.</p> <p>Ejemplos: Empezar el juego, seleccionar un personaje, coleccionar un \u00edtem facil de conseguir, vencer a tu primer enemigo.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#1-facil","title":"1 - Facil","text":"<p>La mayor\u00eda de jugadores lo pueden conseguir en su primer intento, Algunos en su segundo o tercero. Raramente los jugadores pueden arruinarlo.</p> <p>Ejemplo: Progresa en stages f\u00e1ciles, consigue 100 monedas, colecciona una pluma, colecciona 20 anillos. Obt\u00e9n la primer mejora, llega a un mundo secreto bastante conocido. Pelea contra un jefe muy simples: la mayor\u00eda de los jefes en Super Mario World, completa los primeros mundos en Sonic.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#2-medio","title":"2 - Medio","text":"<p>Varios jugadores pueden conseguir este en su primer intento. Algunos despu\u00e9s de varios intentos. Algunos necesitan practicar. Muy pocos van a batallar mucho con ellos.</p> <p>Ejemplos: Obt\u00e9n todos los switches de colores en Super Mario World, colecciona todos los items en un stage de Castlevania, obt\u00e9n un bonus en un \u00e1rea escondida, obt\u00e9n lunas en SMW. Vence Contra con el c\u00f3digo Konami.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#3-medio-dificil","title":"3 - Medio-Dif\u00edcil","text":"<p>Un porcentaje bajo de jugadores pueden conseguirlo en su primer intento. Algunos despu\u00e9s de varios intentos y la mayor\u00eda les va a tomar algo de esfuerzo y practica completar uno de estos. Algunos lo van a encontrar muy retador, y se rendir\u00e1n.</p> <p>Ejemplos: Obt\u00e9n una de las emeraldas chaos en Sonic 2. Completa Super Mario World.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#4-dificil","title":"4 - Dif\u00edcil","text":"<p>Muy pocos jugadores pueden conseguir uno en su primer intento, incluso si ya conocen el juego (realmente no es su primer intento o si?) la mayor\u00eda pueden completar estos con un esfuerzo solido, algunos intentos y algo de practica, y algunos necesitan practicar con otros juegos primero.</p> <p>Ejemplos: Obt\u00e9n todas las esmeraldas Chaos en Sonic 1,2,3. Pasa Contra sin el c\u00f3digo Konami.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#5-muy-dificil","title":"5 - Muy Dif\u00edcil","text":"<p>Solo los jugados mas extra\u00f1os pueden completar uno de estos en su primer intento. La mayor\u00eda puede completarlo despu\u00e9s de muchos intentos, Muchos jugadores lo van a dejar abandonado y no van a estar dispuestos a completar el set al menos que sean complecionistas o fan\u00e1ticos del juego. Muchos no son capases de completarlo despu\u00e9s de muchos intentos. Usualmente requiere practica significativa, altas habilidades, experiencia, b\u00fasqueda, o gu\u00edas para completarlo.</p> <p>Ejemplos: Completa Contra en una sola vida. Escapa de Zebes (Super Metroid) en 2 minutos o menos. Vence a los jefes de Megaman sin recibir da\u00f1o. Muchos de completa niveles sin recibir da\u00f1o, depende del juego.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#6-super-dificil","title":"6 - Super Dif\u00edcil","text":"<p>La mayor\u00eda de los jugadores no son capases de completarlo despu\u00e9s de decenas de intentos. Algunos jugadores tal vez nunca sean capases de completarlo ya que puede requerir noci\u00f3n del mando y el tiempo mas all\u00e1 de lo normal. Los jugadores con mas habilidad inclusive lo consideran bastante dificil. Puede reiniciar esfuerzos de maratones.</p> <p>Ejemplos: Completa un juego sin conseguir da\u00f1o especialmente si el jugador tiene una barra de vida, retos que restringen al jugador drasticamente y requieren precisi\u00f3n por frame perfecta. Completa Contra dos veces con una vida. Completa Mario Bros sin conseguir monedas. Completa Megaman sin recibir da\u00f1o.</p>"},{"location":"Difficulty-Scale-and-Balance-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-14 15:34] eldexterr:</code> Created Difficulty Scale and Balance es (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/","title":"Escala de Dificuldade e Equil\u00edbrio","text":"<p>Link para o texto em ingl\u00eas: Difficulty Scale and Balance</p> <p>Este documento tem algumas sugest\u00f5es sobre dificuldade, balanceamento do set e manuten\u00e7\u00e3o de um set divertido, e desafiador. O que voc\u00ea ir\u00e1 ver aqui n\u00e3o s\u00e3o regras, apenas sugest\u00f5es.</p> <p>Nota Seja conciente da C\u00f3digo de Conduta dos Desenvolvedores</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#escala-de-dificuldade","title":"Escala de Dificuldade","text":"<ol> <li>Brinde</li> <li>F\u00e1cil</li> <li>M\u00e9dio</li> <li>Medianos</li> <li>Dif\u00edcil</li> <li>Muito Dif\u00edcil</li> <li>Super Dif\u00edcil</li> </ol> <p>Mais detalhes sobre estes no fundo</p> <p>Em geral, deve haver um equil\u00edbrio est\u00e1vel de dificuldade. Deve-se pensar na dificuldade geral do set ao constru\u00ed-lo. N\u00e3o se deve tornar os set excessivamente dif\u00edceis.</p> <p>Um bom equil\u00edbrio nas 50 conquistas em um set m\u00e9dio teria aproximadamente: 4 Brindes, 6 super f\u00e1ceis. 10 m\u00e9dios, 10 medianos, 14 dif\u00edceis, 6 Muito dif\u00edceis e 0 kaizo.</p> <p>Uma distribui\u00e7\u00e3o de dificuldade bem balanceada tem recompensas para todos os tipos de jogadores. Isso se d\u00e1 a cada n\u00edvel de habilidade algo para realizar at\u00e9 a platina.</p> <p>Conquistas n\u00e3o devem ser apenas uma marca de conclus\u00e3o de um jogo, (muito f\u00e1cil) mas crie divertidas novas mem\u00f3rias para o jogo (diversividade de desafios).</p> <p>Isto deixa espa\u00e7o para os brindes que est\u00e3o apresentando elementos curiosos ou divertidos dos jogos. Isto lhe espera dificuldade suficiente que, uma vez que voc\u00ea platina o set, voc\u00ea \u00e9 o mestre do jogo. Mas isso n\u00e3o pede muito do jogador.</p> <p>Tamb\u00e9m n\u00e3o deve ser pedir ao jogador para fazer coisas aparentemente sem fim e repetitivas para fazer um set parecer dif\u00edcil. Fazendo a mesma tarefa denovo e denovo, n\u00e3o \u00e9 dif\u00edcil, \u00e9 tipicamente tedioso. Deve quase sempre evitar fazer tipos de maratonas com uma \"colina\" no final (Aquelas que requer um longo tempo ou dificuldade repetitiva com e depois uma eleva\u00e7\u00e3o de alta dificuldade no final. N\u00e3o fa\u00e7a isso!)</p> <p>Sets dever\u00e3o ser platin\u00e1veis por um jogador h\u00e1bil que d\u00e1 um esfor\u00e7o dedicado.</p> <p>Sets dever\u00e3o refletir o conte\u00fado do jogo. Farmar conquistas em jogos que exigem Farm s\u00e3o razo\u00e1veis, em outros lugares eles seriam fequentemente inapropriados</p> <p>Sets dever\u00e3o tambem quebrar o que \u00e9 esperado de um jogo, impulsionando o jogador a procurar encontrar novas solu\u00e7\u00f5es para problemas que um jogador veterano nunca considerou</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#quantidade-de-conquistas","title":"Quantidade de Conquistas:","text":"<p>A quantidade de conquistas n\u00e3o tem regras t\u00e3o duras. Quantidade \u00e9 um fator chave</p> <p>A quantidade de um set depende fortemente de o quanto divertido e desafiador o jogo pode oferecer. \u00c9 por isso que o desenvolvedor do set deve conhecer o jogo muito bem.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#variedade-de-conquistas","title":"Variedade de Conquistas:","text":"<p>Mantenha divertido, d\u00ea variedade, desafie o jogador, d\u00ea ao jogador novas coisas para se fazer.</p> <p>Algumas conquistas podem dar muito mais divers\u00e3o para o jogador do que um jogo de metas. Onde \u00e9 necessario que o jogador repense o jogo inteiramente.</p> <p>Alguns Exemplos Not\u00e1veis:</p> <ul> <li>Fabulous Combo (15) - isto transforma o jogo em um jogo de puzzle, completando isso pode ser realmente satisfat\u00f3rio.</li> </ul> <ul> <li>Swordless Adventurer (20) - voc\u00ea \u00e9 for\u00e7ado a repensar todo o jogo sem arma. Voc\u00ea pode descobrir o qu\u00e3o \u00fatil todas as sub-armas s\u00e3o. Muito legal!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - desafios pacifistas, quando possivelmente for\u00e7a muito mais a agilidade do jogador e quebrar velhos h\u00e1bitos. Muito legal!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#definicoes-de-dificuldade","title":"Defini\u00e7\u00f5es de Dificuldade","text":""},{"location":"Difficulty-Scale-and-Balance-pt_BR/#0-brinde","title":"0 - Brinde","text":"<p>N\u00e3o leva quase nenhum esfor\u00e7o para basicamente todos os jogadores para conquistar OU o jogador consegue sem nenhuma consci\u00eancia ou esfor\u00e7o. Al\u00e9m do jogador conseguir por acidente e aparecer na tela. Algumas vezes o jogador n\u00e3o tem nenhuma id\u00e9ia porque ganhou ele. Alguns conquistas brindes s\u00e3o boas e ruins.</p> <p>Exemplos: Iniciando o jogo, escolhendo um personagem, coletando um item de acesso f\u00e1cil, matando seu primeiro inimigo. Trope\u00e7ando em uma conquista que n\u00e3o levou a premedita\u00e7\u00e3o, mas destaca elementos do jogo</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#1-facil","title":"1 - F\u00e1cil","text":"<p>A maioria dos jogadores consegue estas na primeira tentativa, alguns na segunda ou terceira tentativa. Raramente os jogadores podem se confundir.</p> <p>Exemplos: Progresso em fases f\u00e1ceis, pegando 100 moedas, coletando uma pena, coletando 20 an\u00e9is. Pegando o primeiro upgrade, indo para uma fase secreta muito conhecida. Lutando com um chefe facil: a maioria dos chefes em Super Mario World, completando fases iniciais em Sonic The Hedgehog.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#2-medio","title":"2 - M\u00e9dio","text":"<p>A Maioria dos jogadores consegue pegar na primeira tentativa. Muitos poderiam depois de algumas tentativas. Alguns ir\u00e3o precisar praticar. Alguns poucos v\u00e3o lutar com eles.</p> <p>Exemplos: Conseguindo todos os switches coloridos no Super Mario World, coletando todos os itens em uma fase de Castlevania, conseguindo um item b\u00f4nus em uma \u00e1rea mais escondida como as lua em SMW. Zerando Contra com o Konami code</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#3-medianos","title":"3 - Medianos","text":"<p>Uma baixa quantidade de jogadores ir\u00e3o conseguir isso na primeira tentativa. Alguns depois de algumas tentativas e a maioria vai levar algum esfor\u00e7o e pr\u00e1tica para concluir. Alguns ir\u00e3o achar eles muito desafiantes e desistir.</p> <p>Exemplos: Conseguindo algumas das esmeraldas do caos em Sonic The Hedgehog 2, Zerar Super Mario World</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#4-dificil","title":"4 - Dif\u00edcil","text":"<p>Muitos poucos jogadores ir\u00e3o conseguir na primeira tentativa, possivelmente se ja conhece o jogo (n\u00e3o realmente a primeira tentativa?) Alguns podem completar com algum esfor\u00e7o solido, muitas tentativas e alguma pr\u00e1tica e precisa praticar outros jogos antes.</p> <p>Exemplos: Conseguindo todas as Esmeraldas do Caos em Sonic 1,2,3. Zerando Contra sem o Komani Code.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#5-muito-dificil","title":"5 - Muito Dif\u00edcil","text":"<p>Apenas o mais raro dos jogadores conseguem estas em uma primeira tentativa. A maioria consegue complet\u00e1-lo depois de muitas tentativas, Muitos jogadores ir\u00e3o desistir aqui e n\u00e3o estar\u00e1 disposto a completar o set a menos que eles s\u00e3o completistas ou f\u00e3s do jogo. Muitos n\u00e3o ser\u00e3o capazes depois de muitas tentativas. Geralmente pega uma pr\u00e1tica significante, altas habilidades, experi\u00eancia, pesquisas ou guias para completar</p> <p>Exemplos: Zerando Contra com uma vida. Escapando de Zebes (Super Metroid) abaixo de dois minutos. Derrotando muitos chefes de Megaman sem tomar dano. Muitos est\u00e1gios sem danos, dependendo do jogo.</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#6-super-dificil","title":"6 - Super Dif\u00edcil","text":"<p>A Maioria dos jogadores n\u00e3o ser\u00e3o capaz de completar isto depois de d\u00fazias de tentativas. Muitos jogadores nunca ser\u00e3o capazes de complet\u00e1-lo, pois podem exigir velocidades de rea\u00e7\u00e3o al\u00e9m das normais. Os jogadores mais qualificados ainda consideram isso extremamente dif\u00edcil. Pode levar os esfor\u00e7os de maratonas para reiniciar</p> <p>Exemplos: Completar um jogo sem tomar dano, especialmente se o jogador tiver uma barra de vida, desafios que restringem drasticamente o jogador e exigem precis\u00e3o quase perfeita para o sucesso. Zerar Contra duas vezes com uma vida. Zerando Megaman sem tomar dano. Zerar Super Mario Bros sem coletar power-ups, coletando apenas 2 moedas, e com a pontua\u00e7\u00e3o abaixo de 500</p>"},{"location":"Difficulty-Scale-and-Balance-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-26 02:38] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:37] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:36] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:35] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-26 02:19] KingDice001:</code> Updated Difficulty Scale and Balance pt_BR (markdown)</li> <li><code>[2018-03-25 16:34] KingDice001:</code> Created Difficulty Scale and Balance pt_BR (markdown)</li> </ul>"},{"location":"Difficulty-Scale-and-Balance/","title":"Difficulty Scale and Balance","text":"<p>This doc has some suggestions about difficulty, set balance and on keeping a set fun, approachable, and challenging. What you're going to see here are not rules, just suggestions.</p> <p>Note: be aware of Developers Code of Conduct</p>"},{"location":"Difficulty-Scale-and-Balance/#difficulty-scale","title":"Difficulty Scale:","text":"<ol> <li>Freebie</li> <li>Easy</li> <li>Medium</li> <li>Med-hard</li> <li>Hard</li> <li>Very-Hard</li> <li>Super-Hard</li> </ol> <p>More details on these at the bottom.</p> <p>In general there should be an steady sloping balance of difficulty. One should think of the overall difficulty of a set while building it. One should not make sets excessively difficult.</p> <p>A good set balance on a 50 cheeves in an average set would have roughly: 4 freebies, 6 easy cheeves, 10 medium, 10 med-hard, 14 hard, and 6 very-hard, 0 kaizo.</p> <p>A well balanced difficulty distribution has rewards for every type of player. It gives each skill level something to accomplish until mastery.</p> <p>Achievements should not just be a check-mark of completing a game, (too easy) but create fun new memories for the game (diversity of challenges).</p> <p>It leaves space for freebies that are featuring curious or fun elements of the game. It expects enough difficulty that once you've mastered the set you are a master of the game. But it doesn't ask too much from the player either.</p> <p>It also shouldn't ask the player to be doing seemingly endless repetitive grinding to make a set seem harder. Doing the same task over and over isn't hard, it's typically dull. It should almost always avoid making marathon types with a hill at the end (ones that require long setup times with low or repetitive difficulty and then a spike of high difficulty at the end. Don't do it!).</p> <p>Sets should be mastereable by a skilled player who gives a dedicated effort.</p> <p>Sets should reflect the content of the game. Grinding cheeves in games that require grinding are reasonable, where in other places they would often be inappropriate.</p> <p>Sets should also break out of just what is expected from a game, pushing the player to need to find new solutions for problems a veteran player never considered.</p>"},{"location":"Difficulty-Scale-and-Balance/#set-quantity","title":"Set Quantity:","text":"<p>Set quantity should not have such hard rules. Quality is the key factor.</p> <p>The set quantity strongly depends on how much fun and challenges the game can give. That's why the set developer must know the game very well.</p>"},{"location":"Difficulty-Scale-and-Balance/#set-variety","title":"Set Variety:","text":"<p>Keep it fun, give it variety, challenge the player, give the player new things to do.</p> <p>Some achievements can give much fun to the player when they are like a meta-game. Where the player is required to rethink the game entirely.</p> <p>Some notable examples:</p> <ul> <li>Fabulous Combo (25) - it turns the game into a puzzle game, completing this can be very satisfying.</li> </ul> <ul> <li>Swordless Adventurer (50) - with no sword you are forced to rethink the entire game. You can discover how useful all the sub-weapons are. Very fun!</li> </ul> <ul> <li>There Are No Bullets in the Energy Zone (10) - pacifist challenges, when possible, force a lot more agility from the player and break old habits. Very fun!</li> </ul>"},{"location":"Difficulty-Scale-and-Balance/#definitions-of-difficulty","title":"Definitions of Difficulty","text":""},{"location":"Difficulty-Scale-and-Balance/#0-freebie","title":"0 - freebie","text":"<p>Takes almost no effort for basically all players to achieve this OR the player gets it without any conscious effort. The player gets these on accident and they pop up on the screen. Sometimes the player will have no idea why they earned them. Some freebies are good some are bad.</p> <p>Examples: Starting the game, picking a character, collecting an easily accessible item, killing your first enemy. Stumbling on a cheeve that took no forethought but highlights elements of the game.</p>"},{"location":"Difficulty-Scale-and-Balance/#1-easy","title":"1 - Easy","text":"<p>Most players could get these on their first attempt, Some on their second or third attempt. Rarely players can mess it up.</p> <p>Examples: Progress on easy stages, getting 100 coins, collecting a feather, collecting 20 rings. Getting the first upgrade, getting to a well known secret stage. Fighting a simple boss: most bosses in Super Mario World, completing early stages in Sonic.</p>"},{"location":"Difficulty-Scale-and-Balance/#2-medium","title":"2 - Medium","text":"<p>Many players could get this on their first attempt. Many could after a few attempts. Some will need to practice. Very few will struggle with them.</p> <p>Examples: Getting all the colored switches in Super Mario World, collecting all of the items in a Castlevania stage, getting a bonus item in a more hidden area, like moons in SMW. Beating Contra with the Konami code.</p>"},{"location":"Difficulty-Scale-and-Balance/#3-medium-hard","title":"3 - Medium-Hard","text":"<p>A low amount of players could get this on their first attempt. Some after a few attempts and most will take some effort and practice to complete these. A few will find them very challenging, and give up.</p> <p>Examples: Getting some of the chaos emeralds in Sonic 2. Beating Super Mario World.</p>"},{"location":"Difficulty-Scale-and-Balance/#4-hard","title":"4 - Hard","text":"<p>Very few player can get these on their first attempt, perhaps if they already know the game (not really a first attempt is it?) Most can complete these with a solid effort, many attempts and some practice, and some need to practice other games first.</p> <p>Examples: Getting all of the Chaos emeralds in Sonic 1,2,3. Beating Contra without the Konami code.</p>"},{"location":"Difficulty-Scale-and-Balance/#5-very-hard","title":"5 - Very Hard","text":"<p>Only the rarest of players can complete these on a first attempt. Most can complete it after many attempts, Many players will drop off here and won't be willing to complete the set unless they are completionists or fans of the game. Many are not able to complete this after very many attempts. Usually takes significant practice, high skills, experience, research, or guides to complete.</p> <p>Examples: Beating Contra in one life. Escaping Zebes (Super Metroid) in under two minutes. Beating many of the Megaman bosses without taking damage. Many damagless stages, depending on the game.</p>"},{"location":"Difficulty-Scale-and-Balance/#6-super-hard","title":"6 - Super Hard","text":"<p>Most players are not able to complete this after dozens of attempts. Many players will never be able to complete it as it could require beyond normal reaction speeds. The top-most skilled players still consider these blisteringly hard. It may take marathon efforts to restart.</p> <p>Examples: Completing a game without taking damage especially if the player has a lifebar, challenges that drastically restrict the player and require near frame perfect accuracy tor success. Beating contra twice in one life. Penniless plumber. Beating Megaman without taking damage.</p>"},{"location":"Difficulty-Scale-and-Balance/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-02 15:52] monkey-bug:</code> Fix typos and points in notable examples</li> <li><code>[2022-10-09 22:11] ScottFromDerby:</code> /achievement links need to be lowercase to work</li> <li><code>[2017-11-26 00:26] Kvon:</code> Changed title from \"Achievement Difficulty Scale and Difficulty Balance\"</li> </ul>"},{"location":"Docs-To-Do-List/","title":"Docs To Do List","text":"<ul> <li>Add section about reporting cheaters in Global Leaderboard and Achievement Hunting Rules</li> <li>Add Dev Tips section</li> <li>Add sections for QA, DevComp, subteams, etc.</li> <li>Other info needed:<ul> <li>Collab workflow suggestions</li> <li>Achievement set suggestions</li> <li>Helping with site cleanup</li> <li>Playtesting</li> <li>Testing cores/emulators</li> <li>Contributing with RAGuides</li> <li>Contributing with RANews</li> <li>Contributing with RAPatches</li> </ul> </li> </ul>"},{"location":"Docs-To-Do-List/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-30 13:04] televandalist:</code> Updated Docs To Do List (markdown)</li> <li><code>[2023-06-30 13:01] televandalist:</code> Updated NEWTEST Overview (markdown)</li> </ul>"},{"location":"Downloads-es/","title":"Descargas","text":""},{"location":"Downloads-es/#paquetes-de-emuladores","title":"Paquetes de Emuladores","text":"<p>Estos no contienen temas para la Interfaz (Overlay), puedes descargar el est\u00e1ndar y los personalizados en los enlaces a continuaci\u00f3n. Estos enlaces se mantienen actualizados.</p> <ul> <li>RAGens - Sega Genesis/Mega Drive  </li> <li>RASnes9x - Super Nintendo Entertainment System  </li> <li>RAFCEUx - Nintendo Entertainment System  </li> <li>RAVBA - Nintendo Gameboy/Gameboy Color/Gameboy Advance  </li> <li>RAP64 - Nintendo 64</li> <li>Project64 Plugin Pack - Paquete de complementos actualizado, necesario para que Project64 funcione.</li> <li>RAMeka - Master System</li> <li>RALibretro - (Trabajo en Progreso) una interfaz de libetro que soporta varios sistemas. Mas informacion en RALibretro page.</li> <li>RetroArch - NOTA: se usa solo para jugar, no para el desarrollo de logros.</li> </ul>"},{"location":"Downloads-es/#temas-para-la-interfaz-overlay","title":"Temas para la Interfaz (Overlay)","text":"<p>Galer\u00eda de vista previa</p>"},{"location":"Downloads-es/#simple","title":"Simple","text":"<ul> <li>Est\u00e1ndar por Scott </li> <li>Crash Bandicoot por Dexterspet </li> <li>Mega Man Classic por Salsa </li> <li>Nintendo Mix (Slumber Party) por Salsa </li> <li>Roll-chan Evolution por Salsa </li> <li>The Legend of Zelda Classic por Salsa </li> <li>Ys Book I &amp; II por Salsa </li> <li>Sonic por matheus2653 </li> <li>Arnold Schwarzenegger por Salsa </li> <li>Reginaldo Rossi por Salsa </li> </ul>"},{"location":"Downloads-es/#multiple-personalizable","title":"M\u00faltiple (personalizable)","text":"<ul> <li>Saga The Legend of Zelda por kdecks</li> </ul>"},{"location":"Downloads-es/#herramientas","title":"Herramientas","text":"<ul> <li>Lunar IPS - Parcheador de ROMs para hacks y otros parches</li> <li>Alcohol Portable - Software de Virtual Drive (para PCEngine)</li> <li>7-Zip - Para extraer los archivos de las descargas de esta p\u00e1gina</li> </ul>"},{"location":"Downloads-es/#herramientas-en-linea","title":"Herramientas en l\u00ednea","text":"<ul> <li>CRC32 checksum - Para verificar que tienes la ROM correcta</li> <li>MD5 checksum - Para verificar que tienes la ROM correcta</li> <li>Marc Robledo's online RomPatcher - Parcheador en l\u00ednea de ROMs para hacks y otros parches</li> </ul>"},{"location":"Downloads-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-05-30 12:46] ShinyNinetalesTM:</code> created</li> </ul>"},{"location":"Editing-Leaderboards/","title":"Editing Leaderboards","text":""},{"location":"Editing-Leaderboards/#editing-leaderboards","title":"Editing Leaderboards","text":"<ol> <li>Before making updates to a leaderboard,  you must backup each modified conditional line on the comment (if too long use Pastebin link)</li> <li>After editing a leaderboard, if you are fixing, adding, or removing entries, you must leave a comment about changes you have made and why.</li> <li> <p>A leaderboard's concept/design should not be changed once players have begun submitting entries. Exceptions are as follows:</p> <p>A. If a leaderboard has a bug in which a correction would result in a discrepancy between between pre and post fix LB submissions, this would be considered a fundamental change and it may be most appropriate to \"retire\" the leaderboard and create a new corrected LB.</p> <p>B. If a protection needs to be added to the cancel field in a leaderboard, for example to eliminate point farming/leaching (Areas where a game generates an endless number of things, such as items, money, or enemies), it may be preferable to either \u201cretire\u201d or create an additional leaderboard. \"Retiring\" a leaderboard means preventing future submissions.</p> </li> <li> <p>If a developer wishes to create a new concept for a leaderboard, a new one should be added.</p> </li> <li> <p>If a developer wants to implement a fundamental change to a leaderboard while keeping it intact, a revision vote is required. \u201cFundamental changes\u201d involve the following:</p> <p>A. Changes to how players submit scores.</p> <p>B. Changes to submission requirements that impact difficulty and or strategy.</p> </li> <li> <p>A Jr. Developer may only change, add, or remove a leaderboard with a code-reviewer that goes through the revision process with them.</p> </li> </ol>"},{"location":"Editing-Leaderboards/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-03 03:58] televandalist:</code> Updated WIP Editing Leaderboards (markdown)</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/","title":"Emulator Hotkeys for Developers","text":""},{"location":"Emulator-Hotkeys-for-Developers/#bizhawk","title":"BizHawk","text":"<p>May be configured via the Config &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>ESC</code> (<code>Backspace</code> to close overlay)</li> <li>Pause: <code>Pause</code></li> <li>Frame Advance: <code>F</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#pcsx2-with-raintegration-command-line-parameter","title":"PCSX2 (with -raintegration command line parameter)","text":"<p>May be configured via the Settings &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>F1</code> (individual slots can be assigned via <code>Hotkeys</code> &gt; <code>Save State to Slot X</code>)</li> <li>Load State:  <code>F3</code> (individual slots can be assigned via <code>Hotkeys</code> &gt; <code>Save State to Slot X</code>)</li> <li>Change State Index: <code>Shift+F2</code> (prev) / <code>F2</code> (next)</li> <li>Show Overlay: <code>ESC</code></li> <li>Pause: <code>Space</code></li> <li>Frame Advance: Can be assigned via <code>Hotkeys</code> &gt; <code>Frame Advance</code></li> <li>Fast Forward (hold): <code>.</code></li> <li>Fast Forward (toggle): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ralibretro","title":"RALibRetro","text":"<p>May be configured via the Settings &gt; Input &gt; Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>ESC</code></li> <li>Pause: <code>P</code></li> <li>Frame Advance: <code>;</code></li> <li>Fast Forward (hold): <code>=</code></li> <li>Fast Forward (toggle): <code>-</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rameka","title":"RAMeka","text":"<ul> <li>Save State: <code>F5</code></li> <li>Load State: <code>F7</code></li> <li>Change State Index: <code>F6</code> (prev) / <code>F8</code> (next)</li> <li>Show Overlay: <code>F12</code></li> <li>Frame Advance: <code>Ctrl+F12</code></li> <li>Fast Forward (toggle): <code>F2</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ranes","title":"RANes","text":"<p>May be configured via the Config &gt; Map Hotkeys dialog</p> <ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>\\</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#raproject64","title":"RAProject64","text":"<p>May be configured via the Options &gt; Configuration dialog (Select Hotkeys &gt; Game playing (windowed))</p> <ul> <li>Save State: <code>F5</code></li> <li>Load State: <code>F7</code></li> <li>Change State Index: <code>1</code>-<code>0</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Fast Forward (toggle): <code>F4</code> (Must enable advanced settings: <code>Options</code> &gt; <code>Configuration</code> &gt; <code>General Settings</code> &gt; uncheck <code>Hide advanced settings</code>)</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rapplewin","title":"RAppleWin","text":"<ul> <li>Save State: <code>F11</code></li> <li>Load State: <code>F12</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>Shift+Pause</code></li> <li>Fast Forward (hold): <code>ScrollLock</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#raquasi88","title":"RAQUASI88","text":"<ul> <li>Save State: <code>F12</code> &gt; Misc &gt; Save</li> <li>Load State: <code>F12</code> &gt; Misc &gt; Load</li> <li>Show Overlay: Can be assigned via <code>F12</code> &gt; Key &gt; Assign <code>PAUSE</code> to a function key</li> <li>Fast Forward (hold): Can be assigned via <code>F12</code> &gt; Key &gt; Assign <code>NOWAIT</code> to a function key</li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#rasnes9x","title":"RASnes9x","text":"<ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>\\</code></li> <li>Fast Forward (hold): <code>Tab</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#ravba","title":"RAVBA","text":"<ul> <li>Save State: <code>Shift+F1</code> - <code>Shift+F10</code></li> <li>Load State: <code>F1</code> - <code>F10</code></li> <li>Show Overlay: <code>Pause</code></li> <li>Frame Advance: <code>Ctrl+N</code></li> <li>Fast Forward (toggle): Can be assigned via <code>Options</code> &gt; <code>Key Shortcuts</code> &gt; <code>Emulation</code> &gt; <code>Turbo Mode</code></li> </ul>"},{"location":"Emulator-Hotkeys-for-Developers/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-14 08:20] Jamiras:</code> Created Emulator Hotkeys for Developers (markdown)</li> </ul>"},{"location":"Emulator-Support-and-Issues/","title":"Emulator Support and Issues","text":""},{"location":"Emulator-Support-and-Issues/#console-support","title":"Console Support","text":""},{"location":"Emulator-Support-and-Issues/#3do-interactive-multiplayer","title":"3DO Interactive Multiplayer","text":"<ul> <li>\u2705 libretro core: Opera<ul> <li>Some issues depending on BIOS</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#amiga","title":"Amiga","text":"<ul> <li>\u2753 libretro core: FS-UAE</li> <li>\u274c libretro core: P-UAE<ul> <li>Needs memory map to see exposed memory</li> <li>Locks disk files so they can't be opened for hashing</li> <li>Hard disk support?</li> </ul> </li> <li>\u2753 libretro core: PUAE 2021</li> <li>\u2753 libretro core: UAE4ARM</li> </ul>"},{"location":"Emulator-Support-and-Issues/#amstrad-cpc","title":"Amstrad CPC","text":"<ul> <li>\u2705 libretro core: Caprice32<ul> <li>Core does not currently support writing to disk, which may affect hashing when implemented</li> </ul> </li> <li>\u274c libretro core: CrocoDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#apple-ii","title":"Apple II","text":"<ul> <li>\u2705 Standalone emulator: RAppleWin</li> <li>\u231b Bizhawk core: Virtu (Port)<ul> <li>Testing</li> <li>4 Jun 2023 - woz files are not supported</li> <li>4 Jun 2023 - joystick not supported. keyboard has to be manually mapped.</li> <li>4 Jun 2023 - have to manually create and load a multi-disk bundle for games with multiple disks. disks are generically labelled by index only.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#arcade","title":"Arcade","text":"<ul> <li>\u2705 libretro core: FinalBurn Neo<ul> <li>Some boards may not be fully exposed</li> </ul> </li> <li>\u2705 libretro core: flycast<ul> <li>Used for Atomiswave, NAOMI, and NAOMI2</li> </ul> </li> <li>\u274c libretro core: FB Alpha<ul> <li>Deprecated</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#arcadia-2001","title":"Arcadia 2001","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#arduboy","title":"Arduboy","text":"<ul> <li>\u2705 libretro core: Arduous</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-2600","title":"Atari 2600","text":"<ul> <li>\u2705 libretro core: Stella</li> <li>\u2753 libretro core: Stella 2014</li> <li>\u2705 Bizhawk core: AtariHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-5200","title":"Atari 5200","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: atari800<ul> <li>Appears to work fine, but the core is a bit of a headache to use.<ul> <li>The BIOS has to be configured within the core (F1 &gt; Emulator Configuration &gt; System ROM settings)</li> <li>Couldn't figure out controls - does the joystick need to be configured within the core too?</li> <li>Allows loading arbitrary files from the internal menu, which bypasses hashing</li> </ul> </li> </ul> </li> <li>\u274c libretro core: a5200<ul> <li>Does not expose memory</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-7800","title":"Atari 7800","text":"<ul> <li>\u2705 libretro core: ProSystem</li> <li>\u2705 Bizhawk core: A7800Hawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-jaguar","title":"Atari Jaguar","text":"<ul> <li>\u2705 libretro core: Virtual Jaguar<ul> <li>No save state support</li> <li>Many issues with emulation</li> </ul> </li> <li>\u2705 Bizhawk core: Virtual Jaguar</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-jaguar-cd","title":"Atari Jaguar CD","text":"<ul> <li>\u2705 Bizhawk core: Virtual Jaguar</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-lynx","title":"Atari Lynx","text":"<ul> <li>\u2705 libretro core: Handy<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Beetle Lynx</li> <li>\u2705 Bizhawk core: Handy (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#atari-st","title":"Atari ST","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Hatari<ul> <li>Memory not exposed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#cassette-vision","title":"Cassette Vision","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#chip-8","title":"CHIP-8","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: Emux CHIP-8</li> <li>\u274c libretro core: JAXE<ul> <li>16 Apr 22 - Seems ready when we are</li> <li>May need settings blacklist to prevent lowering speed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#commodore-64","title":"Commodore 64","text":"<ul> <li>\u274c libretro core: vice_x64<ul> <li>NOTE: Joystick is in port 2 by default. Use JOY button on virtual keyboard (select) to switch it to port 1.</li> <li>1 May 2022 - Reset does not autorun game</li> </ul> </li> <li>\u231b Bizhawk core: C64Hawk<ul> <li>Testing</li> </ul> </li> <li>\u2753 libretro core: Frodo</li> </ul>"},{"location":"Emulator-Support-and-Issues/#colecovision","title":"ColecoVision","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: blueMSX</li> <li>\u2705 Bizhawk core: ColecoHawk</li> <li>\u274c libretro core: Gearcoleco</li> </ul>"},{"location":"Emulator-Support-and-Issues/#elektor-tv-games-computer","title":"Elektor TV Games Computer","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#fairchild-channel-f","title":"Fairchild Channel-F","text":"<ul> <li>\u2705 libretro core: FreeChaF</li> <li>\u2753 Bizhawk core: ChannelFHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#famicom-disk-system","title":"Famicom Disk System","text":"<ul> <li>\u2705 Standalone emulator: RANes</li> <li>\u2705 libretro core: FCEUmm</li> <li>\u2705 libretro core: Mesen</li> </ul>"},{"location":"Emulator-Support-and-Issues/#fm-towns","title":"FM Towns","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-watch","title":"Game &amp; Watch","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: gw<ul> <li>Does not expose memory</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy","title":"Game Boy","text":"<ul> <li>\u2705 Standalone emulator: RAVBA</li> <li>\u2705 libretro core: Gambatte<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Gearboy</li> <li>\u2705 libretro core: mGBA</li> <li>\u2705 libretro core: VBA-M</li> <li>\u2753 libretro core: Emux GB</li> <li>\u2753 libretro core: fixGB</li> <li>\u2753 libretro core: SameBoy</li> <li>\u2753 libretro core: TGB Dual</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy-color","title":"Game Boy Color","text":"<ul> <li>\u2705 Standalone emulator: RAVBA<ul> <li>Cartridge RAM may appear as all FFs</li> </ul> </li> <li>\u2705 Standalone emulator: Pizza Boy GBC<ul> <li>Android devices only</li> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: Gambatte<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Gearboy</li> <li>\u2705 libretro core: mGBA</li> <li>\u2705 libretro core: VBA-M</li> <li>\u2705 Bizhawk core: Gambatte</li> <li>\u2705 Bizhawk core: GBHawk</li> <li>\u2753 libretro core: Emux GB</li> <li>\u2753 libretro core: fixGB</li> <li>\u2753 libretro core: SameBoy</li> <li>\u2753 libretro core: TGB Dual</li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-boy-advance","title":"Game Boy Advance","text":"<ul> <li>\u2705 Standalone emulator: RAVBA</li> <li>\u2705 Standalone emulator: Pizza Boy GBA<ul> <li>Android devices only</li> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: VBA-M</li> <li>\u2705 libretro core: Beetle GBA</li> <li>\u2705 libretro core: VBA Next</li> <li>\u2705 libretro core: mGBA<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: mGBA</li> <li>\u2753 libretro core: gpSP</li> <li>\u2753 libretro core: Meteor</li> <li>\u2753 libretro core: TempGBA</li> </ul>"},{"location":"Emulator-Support-and-Issues/#gamecube","title":"GameCube","text":"<ul> <li>\u231b Standalone emulator: Dolphin<ul> <li>Testing</li> </ul> </li> <li>\u231b libretro core: Dolphin<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#game-gear","title":"Game Gear","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: GearSystem</li> </ul>"},{"location":"Emulator-Support-and-Issues/#genesis-mega-drive","title":"Genesis / Mega Drive","text":"<ul> <li>\u2705 libretro core: Genesis Plus GX<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Picodrive</li> <li>\u274c libretro core: Blastem<ul> <li>While some achievements may work, the core has issues with the Game RAM portion of memory.</li> </ul> </li> <li>\u2705 Bizhawk core: Genplus-GX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#intellivision","title":"Intellivision","text":"<ul> <li>\u2705 libretro core: FreeIntV<ul> <li>Crashes when game is reset</li> <li>Some crashes which might be related to Intellivoice</li> </ul> </li> <li>\u2705 Bizhawk core: Intellihawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#interton-vc-4000","title":"Interton VC 4000","text":"<ul> <li>\u2705 Standalone emulator: WinArcadia</li> </ul>"},{"location":"Emulator-Support-and-Issues/#j2me","title":"J2ME","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: freej2me</li> </ul>"},{"location":"Emulator-Support-and-Issues/#magnavox-odyssey-2","title":"Magnavox Odyssey 2","text":"<ul> <li>\u2705 libretro core: O2EM</li> <li>\u2753 Bizhawk core: O2Hawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#master-system-mark-iii","title":"Master System | Mark III","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Gearsystem</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: Picodrive</li> <li>\u2753 Bizhawk core: SMSHawk</li> <li>\u2753 libretro core: Emux SMS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#mega-duck","title":"Mega Duck","text":"<ul> <li>\u2705 libretro core: SameDuck</li> </ul>"},{"location":"Emulator-Support-and-Issues/#ms-dos","title":"MS-DOS","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: dosbox-core</li> <li>\u274c libretro core: dosbox-SVN</li> <li>\u274c libretro core: dosbox-pure<ul> <li>Needs a way to prevent launching with user-specified command line parameters</li> <li>Needs a way to prevent TSRs</li> <li>Needs a way to deactivate achievements if game drops to command prompt</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#msx","title":"MSX","text":"<ul> <li>\u2705 libretro core: blueMSX<ul> <li>Hash relies on .DSK file not being modified</li> <li>.DSK files appear to be unsupported if they also require a cartridge. There is a core option for this, but it doesn't seem to function properly. See \"SD Snatcher\", which used a 'sound' cartridge.</li> </ul> </li> <li>\u2753 libretro core: fMSX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-cd","title":"Neo Geo CD","text":"<ul> <li>\u2705 libretro core: NeoCD</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-pocket","title":"Neo Geo Pocket","text":"<ul> <li>\u2705 libretro core: Beetle NeoPop</li> <li>\u2753 libretro core: RACE</li> <li>\u2705 Bizhawk core: Beetle NeoPop (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#neo-geo-pocket-color","title":"Neo Geo Pocket Color","text":"<ul> <li>\u2705 libretro core: Beetle NeoPop</li> <li>\u2753 libretro core: RACE</li> <li>\u2705 Bizhawk core: Beetle NeoPop (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nes-famicom","title":"NES / Famicom","text":"<ul> <li>\u2705 Standalone emulator: RANes</li> <li>\u2705 libretro core: FCEUmm<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Mesen</li> <li>\u2705 libretro core: QuickNES</li> <li>\u274c libretro core: NEStopia<ul> <li>Does not map SRAM</li> <li>PLEASE STOP USING THIS FOR ACHIEVEMENTS</li> </ul> </li> <li>\u2753 libretro core: Emux NES</li> <li>\u2753 libretro core: fixNES</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-3ds","title":"Nintendo 3DS","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Citra<ul> <li>Only exposes 64MB of memory - documentation suggests there should be 128MB.</li> <li>Does not support save states</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-64","title":"Nintendo 64","text":"<ul> <li>\u2705 Standalone emulator: RAProject64</li> <li>\u2705 libretro core: ParaLLEl N64</li> <li>\u2705 libretro core: Mupen64Plus-Next<ul> <li>Most recommended</li> </ul> </li> <li>\u231b Bizhawk core: Mupen64plus<ul> <li>Testing (there are some graphical issues that can be fixed using the angrylion plugin)</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-ds","title":"Nintendo DS","text":"<ul> <li>Limited microphone support</li> <li>\u2705 libretro core: DeSmuME</li> <li>\u2705 libretro core: DeSmuME 2015</li> <li>\u2705 libretro core: melonDS</li> <li>\u2705 Bizhawk core: MelonDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nintendo-dsi","title":"Nintendo DSi","text":"<ul> <li>\u2705 Bizhawk core: melonDS</li> <li>\u274c libretro core: DeSmuME</li> <li>\u274c libretro core: melonDS</li> </ul>"},{"location":"Emulator-Support-and-Issues/#nokia-n-gage","title":"Nokia N-Gage","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#oric","title":"Oric","text":"<ul> <li>\u274c Not supported</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-engine-turbografx-16-supergrafx","title":"PC Engine | TurboGrafx-16 | SuperGrafx","text":"<ul> <li>\u2705 libretro core: Beetle PCE Fast<ul> <li>SuperGrafx games do not work on the Beetle PCE Fast core</li> </ul> </li> <li>\u2705 libretro core: Beetle SuperGrafx<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: PCEHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-engine-cd-turbografx-cd","title":"PC Engine CD | TurboGrafx-CD","text":"<ul> <li>\u2705 libretro core: Beetle PCE Fast</li> <li>\u2705 libretro core: Beetle SuperGrafx<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 Bizhawk core: PCEHawk</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-6001","title":"PC-6001","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-8800","title":"PC-8800","text":"<ul> <li>\u2705 Standalone emulator: RAQuasi88<ul> <li>Most recommended</li> </ul> </li> <li>\u274c libretro core: quasi88<ul> <li>NOT RECOMMENDED</li> <li>PC-88VA not supported</li> <li>16 Apr 2022 - Cannot load m3u. Hash fails because core locks disk file.</li> <li>16 Apr 2022 - Attempting to load a single disk game in RALibretro just goes to \"How many disks?\" prompt. Seems to work in RetroArch</li> <li>16 Apr 2022 - RALibretro does not provide subsystem interface for loading multi-disk games</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-9800","title":"PC-9800","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: Neko Project II Kai<ul> <li>Memory is not exposed.<ul> <li>It appears to be exposed in some games depending on the RAM size selected, but it seems like the machine RAM and not actually related to the game.</li> </ul> </li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pc-fx","title":"PC-FX","text":"<ul> <li>\u2705 libretro core: Beetle PC-FX</li> <li>\u2705 Bizhawk core:</li> </ul>"},{"location":"Emulator-Support-and-Issues/#philips-cd-i","title":"Philips CD-I","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: SAME CDi</li> </ul>"},{"location":"Emulator-Support-and-Issues/#pico-8","title":"Pico-8","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: FAKE-08</li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation","title":"PlayStation","text":"<ul> <li>\u2705 Standalone emulator: DuckStation<ul> <li>There may be memory leak and/or burn-in when using save states. Softcore players beware!</li> </ul> </li> <li>\u2705 libretro core: Beetle PSX HW<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Beetle PSX</li> <li>\u2705 libretro core: ReARMed<ul> <li>BIOS are not required for this core and will zero out the Kernal RAM.</li> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u2705 libretro core: SwanStation</li> <li>\u2753 Bizhawk core: octoshock</li> <li>\u2753 Bizhawk core: Nymashock</li> <li>\u2753 libretro core: Rustation</li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation-2","title":"PlayStation 2","text":"<ul> <li>\u2705 Standalone emulator: PCSX2<ul> <li>PCSX2 is currently the only officially supported option for earning achievements.</li> </ul> </li> <li>\u274c libretro core: LRPS2<ul> <li>Still in alpha state</li> <li>Does not expose memory</li> </ul> </li> <li>\u274c libretro core: Play!<ul> <li>Low compatibility with most commerical games</li> <li>Black screen with stuttering sound</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#playstation-portable","title":"PlayStation Portable","text":"<ul> <li>\u2705 Standalone emulator: PPSSPP<ul> <li>Does not support RAIntegration at this time, so achievement developers are unable to troubleshoot potential issues.</li> </ul> </li> <li>\u2705 libretro core: PPSSPP<ul> <li>Loading save states too fast can cause it to crash</li> <li>Some games have graphical issues </li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pocketstation","title":"PocketStation","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method and memory map</li> <li>\u274c libretro core: pockystation<ul> <li>Core doesn't seem functional, even in RetroArch</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#pokemon-mini","title":"Pokemon Mini","text":"<ul> <li>\u2705 libretro core: PokeMini</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-32x","title":"Sega 32X","text":"<ul> <li>\u2705 libretro core: PicoDrive<ul> <li>Several games are problematic</li> <li>Appears to still have unmapped RAM</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-cd","title":"Sega CD","text":"<ul> <li>Appears to still have unmapped RAM</li> <li>\u2705 libretro core: Genesis Plus GX</li> <li>\u2705 libretro core: Picodrive</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-dreamcast","title":"Sega Dreamcast","text":"<ul> <li>\u2705 libretro core: flycast<ul> <li>Must disable threaded rendering to use save states</li> </ul> </li> <li>\u2753 libretro core: Flycast GLES2</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-pico","title":"Sega Pico","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: picodrive<ul> <li>Needs controls related to turning pages in the attached books</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sega-saturn","title":"Sega Saturn","text":"<ul> <li>\u2705 libretro core: Beetle Saturn<ul> <li>The only recommended core</li> </ul> </li> <li>\u274c libretro core: Yabause<ul> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u274c libretro core: Kronos<ul> <li>Saving and loading states often locks up the UI in RALibretro</li> <li>Technically supported; not recommended.</li> </ul> </li> <li>\u2753 libretro core: YabaSanshiro</li> <li>\u231b Bizhawk core: Saturnus     - Testing</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sg-1000","title":"SG-1000","text":"<ul> <li>\u2705 Standalone emulator: RAMeka</li> <li>\u2705 libretro core: Genesis Plus GX<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: blueMSX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#sharp-x1","title":"Sharp X1","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: X1 Millennium<ul> <li>16 Apr 2022 - Disk writes modify source media, which breaks hashing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#sharp-x68k","title":"Sharp X68K","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: px68k<ul> <li>Crashes RALibretro upon loading a game</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#snes-super-famicom-satellaview-sufami-turbo","title":"SNES | Super Famicom | Satellaview | Sufami Turbo","text":"<ul> <li>\u2705 Standalone emulator: RASnes9x</li> <li>\u2705 libretro core: Snes9x (Current)<ul> <li>Most recommended</li> </ul> </li> <li>\u2705 libretro core: Mesen-S</li> <li>\u2753 libretro core: Beetle bsnes</li> <li>\u2753 libretro core: Beetle Supafaust</li> <li>\u2753 libretro core: bsnes</li> <li>\u2753 libretro core: bsnes 2014 Accuracy</li> <li>\u2753 libretro core: bsnes 2014 Balanced</li> <li>\u2753 libretro core: bsnes 2014 Performance</li> <li>\u2753 libretro core: bsnes C++98 (v085)</li> <li>\u2753 libretro core: bsnes-hd beta</li> <li>\u2753 libretro core: bsnes-mercury Accuracy</li> <li>\u2753 libretro core: bsnes-mercury Balanced</li> <li>\u2753 libretro core: bsnes-mercury Performance</li> <li>\u2753 libretro core: higan Accuracy</li> <li>\u2753 libretro core: nSide Balanced</li> <li>\u2753 libretro core: Snes9x 2002</li> <li>\u2753 libretro core: Snes9x 2005</li> <li>\u2753 libretro core: Snes9x 2005+</li> <li>\u274c libretro core: Snes9x 2010<ul> <li>PLEASE STOP USING THIS FOR ACHIEVEMENTS!!!!</li> </ul> </li> <li>\u2753 Bizhawk core: BSNES</li> <li>\u2753 Bizhawk core: BSNESv115+</li> </ul>"},{"location":"Emulator-Support-and-Issues/#super-cassette-vision","title":"Super Cassette Vision","text":"<ul> <li>\u274c libretro core: EmuSCV<ul> <li>Unfinished according to libretro docs.</li> <li>Does not expose memory. Appears to export a save state via the RETRO_MEMORY_SAVE_RAM interface, which we try to shoehorn into $E000 as that's what's flagged as Cartridge RAM for the system.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#thomson-to8to8d","title":"Thomson TO8/TO8D","text":"<ul> <li>\u274c Not supported - needs hashing method</li> <li>\u274c libretro core: Theodore<ul> <li>Seems to work</li> <li>Uncertain how core handles writing to disk/tape. May affect hashing.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#ti-83","title":"TI-83","text":"<ul> <li>\u231b libretro core: Numero<ul> <li>Testing</li> </ul> </li> <li>\u231b Bizhawk core: TI83Hawk<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#tic-80","title":"TIC-80","text":"<ul> <li>\u274c Not supported - needs hashing method</li> <li>\u274c libretro core: TIC-80<ul> <li>Doesn't export memory correctly. Can only see 8 bytes.</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#uzebox","title":"Uzebox","text":"<ul> <li>\u2705 Bizhawk core: uzem</li> <li>\u2705 libretro core: Uzebox</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vectrex","title":"Vectrex","text":"<ul> <li>\u2705 libretro core: VecX</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vic-20","title":"VIC-20","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: VICE xvic</li> </ul>"},{"location":"Emulator-Support-and-Issues/#virtual-boy","title":"Virtual Boy","text":"<ul> <li>\u2705 libretro core: Beetle VB</li> <li>\u2705 Bizhawk core: VBoy</li> </ul>"},{"location":"Emulator-Support-and-Issues/#vmu","title":"VMU","text":"<ul> <li>\u274c Not supported - needs console ID, hashing method, and memory map</li> <li>\u274c libretro core: VeMUlator</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wasm-4","title":"WASM-4","text":"<ul> <li>\u2705 libretro core: wasm4</li> </ul>"},{"location":"Emulator-Support-and-Issues/#watara-supervision","title":"Watara Supervision","text":"<ul> <li>\u2705 libretro core: potator</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wii","title":"Wii","text":"<ul> <li>\u231b Standalone emulator: Dolphin<ul> <li>Testing</li> </ul> </li> <li>\u231b libretro core: Dolphin<ul> <li>Testing</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#wii-u","title":"Wii U","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wonderswan","title":"WonderSwan","text":"<ul> <li>\u2705 libretro core: Beetle Cygne</li> <li>\u2705 Bizhawk core: Cygne (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#wonderswan-color","title":"WonderSwan Color","text":"<ul> <li>\u2705 libretro core: Beetle Cygne</li> <li>\u2705 Bizhawk core: Cygne (Port)</li> </ul>"},{"location":"Emulator-Support-and-Issues/#xbox","title":"XBOX","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#zeebo","title":"Zeebo","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> </ul>"},{"location":"Emulator-Support-and-Issues/#zx81","title":"ZX81","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: EightyOne<ul> <li>Memory not exposed</li> </ul> </li> </ul>"},{"location":"Emulator-Support-and-Issues/#zx-spectrum","title":"ZX Spectrum","text":"<ul> <li>\u274c Not supported - needs hashing method and memory map</li> <li>\u274c libretro core: FUSE<ul> <li>Requires ability to map keyboard to port 3</li> <li>Uncertain about save support. Cannot seem to insert save disk</li> </ul> </li> <li>\u231b - Bizhawk core: ZXHawk<ul> <li>Hashing needs to be corrected</li> <li>Testing</li> </ul> </li> </ul> <p>More details on Bizhawk cores can be found here.</p>"},{"location":"Emulator-Support-and-Issues/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-27 11:17] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2024-01-12 16:54] Jamiras:</code> add mGBA to supported cores for GB/GBC</li> <li><code>[2023-12-29 03:19] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-12-29 03:15] televandalist:</code> Added Pizza Boy GBA+GBC and PPSSPP standalone. Hopefully fixed the line breaks for the deployed docs (it's not WYSIWYG)</li> <li><code>[2023-09-19 19:48] Jamiras:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-07-23 17:59] Joe Pizzimenti:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-24 07:11] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-04 16:16] Jamiras:</code> Updated Emulator Support and Issues (markdown)</li> <li><code>[2023-06-01 22:08] televandalist:</code> Updated DSi</li> <li><code>[2023-04-12 06:47] televandalist:</code> Updated Emulator Support and Issues (markdown)</li> </ul>"},{"location":"Events/","title":"Events","text":""},{"location":"Events/#current-events","title":"Current Events","text":"Event Name Current Host(s) Relevant Link More Info Achievement of the Week Various Challenge League 4 BahamutVoid Daily DistRActions Bendyhuman DevQuests Various Developer Event (Series) Leaderboard of the Month Searo Peak Streak Bendyhuman RetroAchievements Roulette (RAWR) StingX2 Retro Game Show Thoreau Rollouts Simple Monthly Master Hotscrock The Unwanted televandalist UserQuests(?) Various Player Event (Series)"},{"location":"Events/#past-or-seasonal-events","title":"Past or Seasonal Events","text":"Event Name Previous Host(s) Relevant Link More Info Bad Idea Game StingX2 Bendyhuman's Master Quest Bendyhuman CommuniPlay SporyTike Devember kdeckswilhitewarriorSlashTangent Developer Event Leapfrog BoldewinHolyShinxNevermond12televandalist Master of the Month JAM Rescoring Contributor kdecks RetroAchievements Tournament diegoplantes RetroOlympics Searovoiceofautumn Retro Battle Thoreau Retro Clean-Up 2019 SporyTike Developer Event Retro VGM Quiz Thoreau RPM JAMXymjak Spring Cleaning 2020 wilhitewarrior Developer Event \ud83d\udc80The Big Achievement 2020\ud83d\udc80 televandalist The Great Jacko StingX2 Developer Event The Pumpkin King kdecks VGM Contest RimsalaWateredWillow"},{"location":"Events/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-20 05:46] televandalist:</code> Fixed links</li> <li><code>[2022-03-13 21:23] televandalist:</code> Fix links</li> <li><code>[2022-02-08 22:56] televandalist:</code> Added links for DevQuest and Rollouts doc pages</li> <li><code>[2022-02-08 22:55] televandalist:</code> Updated Events (markdown)</li> <li><code>[2022-02-06 02:47] televandalist:</code> Start Event Page/Directory - will add more later</li> </ul>"},{"location":"FAQ-es/","title":"Preguntas Frecuentes","text":"<ul> <li>\u00bfQu\u00e9 es RetroAchievements.org?</li> <li>\u00bfQu\u00e9 emulador necesito usar?     - Emuladores oficiales de RetroAchievements.org         - \u00bfC\u00f3mo accedo a la interfaz (Overlay) de logros?     - Emulador RetroArch         - \u00bfQu\u00e9 n\u00facleos (Core) RetroArch deber\u00eda usar?         - \u00bfC\u00f3mo puedo ver la insignia (Badge) cuando gano un logro en RetroArch?</li> <li>RetroArch/RALibretro no corre mi juego de arcade. \u00bfQue tengo que hacer?</li> <li>\u00bfSer\u00e1 RetroAchievements compatible con PlayStation?</li> <li>\u00a1Mi correo electr\u00f3nico de bienvenida se ha perdido!</li> <li>\u00bfDonde puedo encontrar ROMs?</li> <li>\u00bfPor qu\u00e9 mi juego no est\u00e1 cargando sus logros?</li> <li>\u00bfQu\u00e9 es el modo \"Hardcore\"?</li> <li>\u00a1No obtuve este logro! (o lo obtuve en un momento equivocado)</li> <li>Complet\u00e9 un logro dif\u00edcil pero no se activ\u00f3, \u00bfse me puede desbloquear manualmente?</li> <li>\u00a1Yo tambi\u00e9n quiero hacer logros!</li> <li>\u00bfQue son los Puntos Blancos (White points)?</li> <li>\u00bfQu\u00e9 se considera hacer trampa (para el Hardcore)? \u00bfQu\u00e9 pasa si encuentro evidencia de un tramposo?</li> <li>\u00bfQu\u00e9 pasa si obtengo un logro que no gan\u00e9?</li> <li>\u00bfC\u00f3mo puedo restablecer mi contrase\u00f1a? (Si no la recuerdo)</li> <li>\u00bfPorque no puedo ver mi nueva foto de perfil?</li> <li>\u00bfVoy obtener alg\u00fan privilegio si me convierto en Patreon?</li> <li>\u00bfRetroAchievements esta haciendo dinero por medio de la emulaci\u00f3n?</li> </ul>"},{"location":"FAQ-es/#que-es-retroachievementsorg","title":"\u00bfQu\u00e9 es RetroAchievements.org?","text":"<p>RetroAchievements.org es una comunidad que colabora y compite para ganar logros personalizados en juegos cl\u00e1sicos a trav\u00e9s de la emulaci\u00f3n. Los logros son hechos por y para la comunidad. Ofrecemos varios emuladores personalizados para su uso, que detectar\u00e1n cuando hayas completado varios desaf\u00edos. Una vez que hayas iniciado sesi\u00f3n, los emuladores publicar\u00e1n los logros que hayas completado en el sitio, para que puedas verificar y comparar tu progreso con el de tus amigos.</p> <p>Aqu\u00ed hay un ejemplo de RAGens, jugando Streets of Rage 2. Ver\u00e1s dos contadores de intentos de tabla de clasificaci\u00f3n (abajo a la derecha), un logro desbloque\u00e1ndose y finalmente la interfaz (Overlay, presionando ESC):</p> <p></p>"},{"location":"FAQ-es/#que-emulador-necesito-usar","title":"\u00bfQu\u00e9 emulador necesito usar?","text":"<p>Los emuladores oficiales de RetroAchievements.org son todos basados en Windows. Para otros sistemas operativos, puedes usar RetroArch. M\u00e1s informaci\u00f3n a continuaci\u00f3n:</p>"},{"location":"FAQ-es/#emuladores-oficiales-de-retroachievementsorg","title":"Emuladores oficiales de RetroAchievements.org","text":"<p>Descarga el emulador de tu elecci\u00f3n en la p\u00e1gina de descargas, inicia sesi\u00f3n con tu nombre de usuario y contrase\u00f1a (s\u00ed, primero debes crearte una cuenta), luego carga una ROM \u00a1y juega!</p>"},{"location":"FAQ-es/#como-accedo-a-la-interfaz-overlay-de-logros","title":"\u00bfC\u00f3mo accedo a la interfaz (Overlay) de logros?","text":"<p>Normalmente, esto se configurar\u00e1 en la tecla de teclado 'ESC' o en la funci\u00f3n de pausa del juego. En la mayor\u00eda de los emuladores, un juego debe estar activo para que funcione.</p> <p>Algunos de los emuladores ya deber\u00edan estar configurados asignando un bot\u00f3n de controlador para ver la interfaz de logros. Generalmente 'ESC' en el teclado debe activarlo, pero si deseas asignarlo a un control, aqu\u00ed hay algunos trucos para algunos de los emuladores oficiales:</p> <ul> <li>Para RAVBA, ir a Tools &gt; Customize y asignar FilePause a un bot\u00f3n.</li> </ul> <ul> <li>Para RASNES, ir a Input &gt; Customize Hotkeys y cambiar Pause/Overlay en la p\u00e1gina 1.</li> </ul> <ul> <li>Para RANES, ir a Config &gt; Map Hotkeys y cambiar Pause a un bot\u00f3n (Nota: esto puede bloquear el emulador, es mejor hacerlo sin una ROM cargada para tener mejores oportunidades).</li> </ul>"},{"location":"FAQ-es/#emulador-retroarch","title":"Emulador RetroArch","text":"<p>Para sistemas operativos que no sean Windows, debes usar el emulador RetroArch.</p> <p>Actualmente se pueden obtener logros a trav\u00e9s de RetroArch en las siguientes plataformas:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (\u00a1s\u00ed, puedes conseguir logros mientras viajas con tu tel\u00e9fono Android!)</li> <li>PlayStation Vita (necesita estar pirateado con HENkaku)</li> <li>PlayStation 3</li> <li>Wii U</li> <li>Raspberry Pi (Sistemas recomendados: RetroPie, lakka y RecalBox)</li> </ul> <p>Se puede obtener RetroArch en los siguientes enlaces:</p> <ul> <li>stable</li> <li>nightly</li> </ul> <p>Una vez que lo hayas instalado y hecho la configuraci\u00f3n inicial, sigue esta gu\u00eda para configurar los logros: https://libretro.readthedocs.io/en/latest/guides/retroachievements/</p>"},{"location":"FAQ-es/#que-nucleo-core-retroarch-deberia-usar","title":"\u00bfQu\u00e9 n\u00facleo (Core) RetroArch deber\u00eda usar?","text":"<p>Hay que tener en cuenta que no todos los n\u00facleos (Core) de RetroArch son compatibles con RetroAchievements. Consulta esta lista para ver cu\u00e1l elegir.</p>"},{"location":"FAQ-es/#como-puedo-ver-la-insignia-badge-cuando-gano-un-logro-en-retroarch","title":"\u00bfC\u00f3mo puedo ver la insignia (Badge) cuando gano un logro en RetroArch?","text":"<p>Esta funci\u00f3n fue implementada en RetroArch 1.7.7 (May/2019), aunque aun hay algunas plataformas en las que aun no funciona (como en el PS Vita). Simplemente necesitas percatarte que la opci\u00f3n de Menu Widget este habilitada (que usualmente lo esta por default).</p>"},{"location":"FAQ-es/#retroarchralibretro-no-corre-mi-juego-de-arcade-que-tengo-que-hacer","title":"RetroArch/RALibretro no corre mi juego de arcade. \u00bfQue tengo que hacer?","text":"<p>Primero lo primero: percatate de estar utilizando el n\u00facleo de RetroArch correcto. Checa aqui cual nucleo deberias de utilizar para poder utilizar la funci\u00f3n de RetroAchievements en juegos de arcade: https://libretro.readthedocs.io/en/latest/guides/retroachievements/#arcade</p> <p>Segundo punto: Los ROMs de Arcade son mas complicados que los de consolas. Hay algunos conceptos y terminologias que necesitas entender y asi todo va a empezar a tener sentido. Aqu\u00ed hay un buen texto en ingles sobre este tema: Demystifying MAME ROMs.</p> <p>Tip Pro: utiliza tu motor de b\u00fasqueda preferido para buscar un \"set de referencia\" (utilizar ROMs de manera aleatoria de diferentes fuentes es un m\u00e9todo de \"prueba y error\" y lo mas probable es que te frustres demasiado).</p>"},{"location":"FAQ-es/#sera-retroachievements-compatible-con-playstation","title":"\u00bfSer\u00e1 RetroAchievements compatible con PlayStation?","text":"<p>Respuesta mem\u00e9tica: Cada vez que alguien pregunta sobre los logros de PSX, el desarrollo se retrasa un mes m\u00e1s. Asi que por favor, \u00a1DEJA DE PREGUNTAR!</p> <p>Respuesta corta: Si, lo ser\u00e1, pero aun no hay una fecha estimada para su llegada.</p> <p>Respuesta larga: El m\u00e9todo actual de creaci\u00f3n de logros tiene limitaciones que influyen directamente en la calidad de los logros. Los juegos de PlayStation son un poco m\u00e1s complejos que los de las consolas que ya son compatibles aqu\u00ed (excepto quiz\u00e1s, los de Nintendo 64). Y en consecuencia, los logros de los juegos de PS merecen una mayor elaboraci\u00f3n y cuidado. Todos tenemos un gran respeto por la consola de PlayStation, y esa es exactamente la raz\u00f3n por la que queremos implementar mejoras en el kit de herramientas utilizado para crear logros antes de agregar este soporte.</p> <p>Nota: si encuentras cualquier otro sitio con logros para PlayStation, ten en cuenta que no esta asociado con RetroAchievements.</p>"},{"location":"FAQ-es/#mi-correo-electronico-de-bienvenida-se-ha-perdido","title":"\u00a1Mi correo electr\u00f3nico de bienvenida se ha perdido!","text":"<p>Lamentablemente, es sabido que algunas veces se pierde el correo electr\u00f3nico de bienvenida. Si esto sucede, inicia sesi\u00f3n con tu nombre de usuario/contrase\u00f1a con el que te registraste, luego visita tu p\u00e1gina de configuraci\u00f3n. En la parte superior, encontrar\u00e1s la opci\u00f3n de volver a enviar tu correo electr\u00f3nico de registro.</p>"},{"location":"FAQ-es/#donde-puedo-encontrar-roms","title":"\u00bfDonde puedo encontrar ROMs?","text":"<p>Aqu\u00ed no. Lamentablemente, es ilegal alojar o distribuir ROMs con derechos de autor.</p>"},{"location":"FAQ-es/#por-que-mi-juego-no-esta-cargando-sus-logros","title":"\u00bfPor qu\u00e9 mi juego no est\u00e1 cargando sus logros?","text":"<p>Ya sea:</p> <ol> <li>No tiene logros.</li> <li>Es la ROM incorrecta.</li> </ol> <p>Una buena pr\u00e1ctica es verificar el tema oficial del foro del juego. Si a\u00fan no tienes una respuesta, consulta esta p\u00e1gina aqu\u00ed para m\u00e1s detalles: Mi juego no esta cargando los logros.</p>"},{"location":"FAQ-es/#que-es-el-modo-hardcore","title":"\u00bfQu\u00e9 es el modo \"Hardcore\"?","text":"<p>El modo Hardcore es una caracter\u00edstica adicional para separar a los buenos jugadores de los grandes jugadores: el modo Hardcore desactiva toda forma de salvado y cargado (savestates) en el emulador: no podr\u00e1s guardar y volver a cargar en cualquier momento. Tendr\u00e1s que completar el juego y obtener los logros la primera vez, al igual que en la consola original. En recompensa por esto, ganar\u00e1s tanto el logro est\u00e1ndar como el logro en modo Hardcore, en efecto, \u00a1ganando el doble de puntos! \u00a1Un juego que normalmente vale 400 puntos, vale 800 puntos si lo completas exitosamente en el modo Hardcore! Por ejemplo: si completas el juego por completo con 400 puntos, entonces tienes la oportunidad de ganar otros 400 en el modo Hardcore.</p> <p>Si quieres jugar con el modo Hardcore desactivado (tambi\u00e9n conocido como \"softcore\"), podr\u00e1s tener algunos problemas. M\u00e1s detalles aqu\u00ed: Why you shouldn't use the load state feature</p>"},{"location":"FAQ-es/#no-obtuve-este-logro-o-lo-obtuve-en-un-momento-equivocado","title":"\u00a1No obtuve este logro! (o lo obtuve en un momento equivocado)","text":"<p>Hay una caracter\u00edstica incorporada solo en los emuladores oficiales (no en RetroArch) que permite informar sobre logros rotos que se obtienen en el momento equivocado, o que no se obtienen del todo. Ir a RetroAchievements -&gt; Report Broken Achievements.</p> <p>Ejemplo:</p> <p>.</p> <p>Tambi\u00e9n hay una forma de informar sobre logros rotos directamente a trav\u00e9s del sitio web. En la p\u00e1gina de cada logro, hay un enlace que dice <code>Report an issue for this achievement</code>, como en la imagen a continuaci\u00f3n:</p> <p></p> <p>Agrega detalles del estado de tu juego, cu\u00e1ndo se activ\u00f3/no se activ\u00f3 el logro, en qu\u00e9 modo de juego ocurri\u00f3, d\u00f3nde estabas cuando sucedi\u00f3/no sucedi\u00f3, si reseteaste el juego recientemente, o cualquier otra cosa que creas que pueda ser relevante para el logro. Esto es necesario para nuestro sistema, para que los desarrolladores sepan d\u00f3nde esta el problema.</p>"},{"location":"FAQ-es/#complete-un-logro-dificil-pero-no-se-activo-se-me-puede-desbloquear-manualmente","title":"Complet\u00e9 un logro dif\u00edcil pero no se activ\u00f3, \u00bfse me puede desbloquear manualmente?","text":"<p>S\u00ed. Pero debes seguir los siguientes pasos:</p> <ol> <li>Envia un ticket describiendo con detalles el problema que tuvo con el logro. <code>Mira la pregunta/respuesta anterior para saber c\u00f3mo enviar un ticket.</code>     1. Si el logro no se registr\u00f3 en el sitio debido a un problema de red, no es necesario que envie un ticket.</li> <li>Obt\u00e9n una prueba/evidencia de que completaste el logro (ejemplo perfecto de evidencia proporcionado por gr1nya). Pruebas aceptables:     1. Capturas de pantalla que muestran que estas jugando en Hardcore y has completado el logro.     2. Un video de aquello (mucho mejor).     3. Ejemplos de logros que has obtenido que reemplazan o superan este logro, por ejemplo, obtuviste el logro de 10.000 puntos, pero no el de 5.000 puntos.</li> <li>Publ\u00edcalo en el canal <code>#help-me</code> de nuestro Servidor de Discord, mencionando a alg\u00fan @admin u otro usuario con el rol de admin, proporcionando la siguiente informaci\u00f3n:     1. En enlace a la p\u00e1gina del logro     2. En que modo estabas jugando (hardcore/softcore)     3. El enlace a la evidencia (captura de pantalla, video, etc.)</li> </ol>"},{"location":"FAQ-es/#yo-tambien-quiero-hacer-logros","title":"\u00a1Yo tambi\u00e9n quiero hacer logros!","text":"<p>\u00a1Es bueno escuchar eso! El mejor lugar para empezar es aqui: Getting Started as an Achievement Developer. Una vez que est\u00e9s familiarizado con el Memory Inspector y otros di\u00e1logos relacionados con los logros, puedes ir al resto de los Developer Docs.</p> <p>Por favor, no dudes en preguntar si necesitas ayuda, \u00a1no luches! Lo m\u00e1s importante es asegurarte de que est\u00e1s disfrutando lo que sea que est\u00e9s haciendo. Si no te est\u00e1s divirtiendo, no lo hagas. Pero si te sientes frustrado y quieres persistir, simplemente deja caer un mensaje en los foros o en el Servidor de Discord y alguien se comunicar\u00e1 contigo en breve.</p>"},{"location":"FAQ-es/#que-son-los-puntos-blancos-white-points","title":"\u00bfQue son los Puntos Blancos (White points)?","text":"<p>Los puntos blancos (White points) son secundarios seg\u00fan lo dif\u00edcil que sea un logro. Explicado en detalle aqu\u00ed.</p>"},{"location":"FAQ-es/#que-se-considera-hacer-trampa-para-el-hardcore-que-pasa-si-encuentro-evidencia-de-un-tramposo","title":"\u00bfQu\u00e9 se considera hacer trampa (para el Hardcore)? \u00bfQu\u00e9 pasa si encuentro evidencia de un tramposo?","text":"<p>Explotaci\u00f3n de conjuntos de logros y alteraci\u00f3n o modificaci\u00f3n deliberada de juego, emulador, memoria, velocidad (avance r\u00e1pido) o conjunto. Cargar bater\u00edas grabadas para obtener logros fuera de lugar sin ganarlos durante el juego normal.</p> <p>Se prohiben todas las trampas de los juegos, a menos que se especifique en la descripci\u00f3n o los comentarios del logro en la p\u00e1gina del logro.</p> <p>Vivimos por un c\u00f3digo de honor m\u00e1s que nada. Si encuentras evidencia de un tramposo, env\u00eda la evidencia a RAdmin, o env\u00eda un correo electr\u00f3nico a RAmodmail@gmail.com.</p>"},{"location":"FAQ-es/#que-pasa-si-obtengo-un-logro-que-no-gane","title":"\u00bfQu\u00e9 pasa si obtengo un logro que no gan\u00e9?","text":"<p>Lo mismo ocurre con no obtenerlo cuando deber\u00eda, en la mayor\u00eda de los casos, querr\u00e1s crear un informe de ticket (ver arriba), dejando una explicaci\u00f3n de lo que sali\u00f3 mal. Tambi\u00e9n querr\u00e1s eliminar estos logros de tu cuenta, para que puedas tener la satisfacci\u00f3n de realmente ganarlos por ti mismo.</p> <p> Restableciendo logros no ganados.</p>"},{"location":"FAQ-es/#como-puedo-restablecer-mi-contrasena-si-no-la-recuerdo","title":"\u00bfC\u00f3mo puedo restablecer mi contrase\u00f1a? (Si no la recuerdo)","text":"<p>Justo aqu\u00ed: https://retroachievements.org/resetPassword.php</p> <p>En el sitio, p\u00e1gina principal, mientras no est\u00e9 conectado:</p> <p></p>"},{"location":"FAQ-es/#porque-no-puedo-ver-mi-nueva-foto-de-perfil","title":"\u00bfPorque no puedo ver mi nueva foto de perfil?","text":"<p>Presiona <code>Ctrl + F5</code> (en la mayor\u00eda de navegadores). Algunas veces despu\u00e9s de haber cambiado tu foto de perfil (tambi\u00e9n conocido como avatar o foto de usuario) necesitas refrescar la cache de tu navegador; en la mayor\u00eda de los navegadores la manera mas r\u00e1pida de hacerlo es con <code>Ctrl + F5</code>.</p>"},{"location":"FAQ-es/#voy-obtener-algun-privilegio-si-me-convierto-en-patreon","title":"\u00bfVoy obtener alg\u00fan privilegio si me convierto en Patreon?","text":"<p>En el sitio web vas a obtener un badge que dice \"I helped fund RA!\". En el servidor de discord vas a tener acceso a un canal dedicado. Aunque estamos inmensamente agradecido por los aportes de nuestros Patreons, no hay otro bonus aparte de esos.</p> <p>Gracias a las contribuciones de Patreon el proyecto de RetroAchievements puede pagar un servidor decente en el sitio web, correr el bot de discord y tambi\u00e9n realizar respaldos cada cierto tiempo (para recuperar informaci\u00f3n en caso de un desastre), y todo esto con una experiencia libre de anuncios. La comunidad entera le merece un gran gracias a los patreons.</p>"},{"location":"FAQ-es/#retroachievements-esta-haciendo-dinero-por-medio-de-la-emulacion","title":"\u00bfRetroAchievements esta haciendo dinero por medio de la emulaci\u00f3n?","text":"<p>No. RetroAchievements es una comunidad de fans devotos que quieren rendirle homenaje a sus juegos favoritos creando y sacando logros! Aunque tambi\u00e9n aceptamos donaciones por medio de Patreon todo el dinero donado se utiliza para pagar los gastos de los servidores y mantener el sitio completamente libre de anuncios. Todos los programadores y desarrolladores entregan su tiempo a lo mejor para la comunidad a su propio costo.</p>"},{"location":"FAQ-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-04-21 03:38] luchaos:</code> update libretro docs links</li> <li><code>[2019-05-24 10:18] eldexterr:</code> Added missing information</li> <li><code>[2019-04-20 15:15] eldexterr:</code> Changed \"otorgar manualmente\" to \"desbloquear manualmente\"</li> <li><code>[2019-02-14 10:12] meleu:</code> fix broken link</li> <li><code>[2019-02-09 20:19] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:14] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:45] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-09 13:15] ShinyNinetalesTM:</code> edited the a link to https://github.com/RetroAchievements/docs/wiki/My-game-is-not-loading-achievements-es</li> <li><code>[2018-05-06 13:19] ShinyNinetalesTM:</code> fixed several words without accent mark (tilde) and some missing commas and parentheses</li> <li><code>[2018-05-04 10:33] meleu:</code> added a title to make it look better after mkdocs conversion</li> </ul>"},{"location":"FAQ-pl/","title":"FAQ pl","text":""},{"location":"FAQ-pl/#czym-jest-retroachievementsorg","title":"Czym jest RetroAchievements.org","text":"<p>RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit, kt\u00f3ra wsp\u00f3\u0142pracuje i rywalizuje \u017ceby zyska\u0107 w\u0142asne osi\u0105gni\u0119cia do klasycznych gier poprzez emulacje, osi\u0105gni\u0119cia s\u0105 tworzone przez i dla spo\u0142eczno\u015bci. My dajemy specjalnie przystosowane emulatory dla was, kt\u00f3re wykrywaj\u0105 gdy wykonasz jakie\u015b wyzwanie. Gdy si\u0119 zalogujesz, emulator wy\u015ble osi\u0105gni\u0119cia jakie zdoby\u0142e\u015b na stron\u0119, aby\u015b m\u00f3g\u0142 zobaczy\u0107 i por\u00f3wna\u0107 post\u0119p z przyjaci\u00f3\u0142mi </p> <p>Tutaj jest przyk\u0142ad RAGens, graj\u0105cy w \"Street of Rage 2\", wida\u0107 dwie Tablice Wynik\u00f3w (dolny prawy r\u00f3g), jedno osi\u0105gni\u0119cie wyskakuje, a na ko\u0144cu Nak\u0142adka Osi\u0105gni\u0119\u0107 (Naci\u015bnij <code>Escape</code>):</p> <p></p>"},{"location":"FAQ-pl/#czym-jest-tryb-hardcore","title":"Czym jest tryb HARDCORE?","text":"<p>Tryb HARDCORE jest dodatkow\u0105 funkcj\u0105 \u017ceby oddzieli\u0107 dobrych graczy od \u015bwietnych graczy: Tryb HARDCORE wy\u0142\u0105cza wszystkie funkcje stanu zapisu z emulatora:  Nie b\u0119dziesz m\u00f3g\u0142 zapisywa\u0107 i wczytywa\u0107 kiedy chcesz. B\u0119dziesz musia\u0142 zdoby\u0107 osi\u0105gni\u0119cia za pierwszym razem, tak jak na oryginalnej konsoli. W nagrod\u0119 za to, dostanie standardowe punkty jak i punkty HARDCORE, skutkuj\u0105c w podwojeniu zyskanych punkt\u00f3w! Zwyk\u0142a gra warta 400 punkt\u00f3w, jest teraz warta 800, je\u015bli przejdziesz gr\u0119 ca\u0142kiem w trybie HARDCORE!</p> <p>Notka: Je\u015bli chcesz gra\u0107 w wy\u0142\u0105czonym trybem HARDCORE (znany r\u00f3wnie\u017c jako SOFTCORE), oczekuj \u017ce mo\u017cesz mie\u0107 pewne problemy. Przeczytaj w tym linku czemu nie powiniene\u015b u\u017cywa\u0107 funkcji wczytania stanu.</p>"},{"location":"FAQ-pl/#ktorego-emulatora-musze-uzywac","title":"Kt\u00f3rego emulatora musz\u0119 u\u017cywa\u0107?","text":"<p>Oficjalne emulatory RetroAchievements.org s\u0105 bazowane na Windowsie. Dla innych system\u00f3w operacyjnych mo\u017cesz u\u017cy\u0107 Retroarch'a. Wi\u0119cej informacji poni\u017cej:</p>"},{"location":"FAQ-pl/#oficjalne-emulatory-retroachievementsorg","title":"Oficjalne emulatory RetroAchievements.org","text":"<p>Prosz\u0119 pobierz emulator twojego wyboru z strony pobierania, zalogowa\u0107 si\u0119 u\u017cywaj\u0105c swojego pseudonimu i has\u0142a (tak, musisz pierw stworzy\u0107 konto), potem za\u0142aduj ROM i zacznij gra\u0107!</p> <p>Co to jest Nak\u0142adka Osi\u0105gni\u0119\u0107 i jak w ni\u0105 wej\u015b\u0107?</p> <p>Nak\u0142adka Osi\u0105gni\u0119\u0107 jest wbudowanym ekranem RetroAchievements, kt\u00f3ry pokazuje osi\u0105gni\u0119cia kt\u00f3re mo\u017cesz zyska\u0107 i opisy tego co trzeba zrobi\u0107, kt\u00f3re osi\u0105gni\u0119cia zyska\u0142e\u015b, twoje punkty osi\u0105gni\u0119\u0107, szczeg\u00f3\u0142y o najlepszych wynikaj tablicy wynik\u00f3w i wi\u0119cej.</p> <p>Normalnie, aby w ni\u0105 wej\u015b\u0107, domy\u015blnym przyciskiem jest przycisk <code>Escape</code>, lub u\u017cywaj\u0105c funkcji pauzy. W wi\u0119kszo\u015bci emulator\u00f3w, gra musi by\u0107 aktywna \u017ceby nak\u0142adka dzia\u0142a\u0142a.</p> <p>Niekt\u00f3re emulatory maj\u0105 przycisk ustawiony na kontrolerze \u017ceby zobaczy\u0107 nak\u0142adk\u0119 osi\u0105gni\u0119\u0107. Og\u00f3lnie <code>Escape</code> na klawiaturze powinien j\u0105 w\u0142\u0105czy\u0107, lecz je\u015bli chcesz przywi\u0105za\u0107 przycisk z kontrolera, tutaj jest jak to ustawi\u0107 na paru oficialnych emulatorach:</p> <ul> <li>dla RAVBA wejd\u017a w Options \u21d2 Key Shortcuts \u21d2 Emulation, zaznaczasz Pause, Ustawiasz \"Shortcut key\" i klikasz \"Assign\"</li> <li>dla RASNES wejd\u017a w Input \u21d2 Customize Hotkeys i zmie\u0144 Pause na pierwszej stronie</li> <li>dla RANES, Config \u21d2 Map Hotkeys i zmie\u0144 \"Pause\" na przycisk (Notka: To mo\u017ce wywali\u0107 emulator, zr\u00f3b to bez za\u0142adowanego ROMu dla lepszych szans).</li> </ul>"},{"location":"FAQ-pl/#emulatory-retroarch","title":"Emulatory Retroarch","text":"<p>Dla system\u00f3w nie-Windowsowych musisz u\u017cy\u0107 Retroarcha</p> <p>aktualnie mo\u017cesz zdoby\u0107 osi\u0105gni\u0119cia za pomocy Retroarcha na podanych platformach:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (Tak! Mo\u017cesz zdobywa\u0107 osi\u0105gni\u0119cia przeno\u015bnie na swoim telefonie!)</li> <li>Playstation Vita (musi by\u0107 zhackowany za pomocy HENkaku</li> <li>Playstation 3</li> <li>Wii U</li> <li>Raspberry PI (zalecane systemy: RetroPie, lakka, RecalBox)</li> </ul> <p>Mo\u017cesz zdoby\u0107 RetroArch na podanych linkach:</p> <ul> <li>Stabilny</li> <li>Conocny</li> </ul> <p>Gdy ju\u017c zainstalowa\u0142\u0119\u015b zrobi\u0142e\u015b wst\u0119pn\u0105 konfiguracj\u0119, pod\u0105\u017caj za poradnikiem, aby ustawi\u0107 osi\u0105gni\u0119cia: https://docs.libretro.com/guides/retroachievements/ </p> <p>Jak mog\u0119 zobaczy\u0107 odznaki gdy zdob\u0119d\u0119 osi\u0105gni\u0119cie na RetroArch?</p> <p>Ta funkcja zosta\u0142a dodana do RetroArch 1.7.7 (Maj/2019), lecz s\u0105 platformy na kt\u00f3rych to ci\u0105gle nie dzia\u0142a, musisz si\u0119 upewni\u0107 \u017ce opcja Menu Wid\u017ceta jest w\u0142\u0105czona (i jest zwykle w\u0142\u0105czona domy\u015blnie).</p>"},{"location":"FAQ-pl/#czym-sa-biae-punkty","title":"Czym s\u0105 bia\u0142e punkty?","text":"<p>Bia\u0142e punkty, zwane r\u00f3wnie\u017c jako punkty \"Retro Ratio\", s\u0105 dodatkowymi punktami bazuj\u0105cymi na trudno\u015bci osi\u0105gni\u0119cia, lecz ta funkcja nie jest aktualnie do ko\u0144ca precyzyjna. Wyja\u015bniona jest tu w szczeg\u00f3\u0142ach</p>"},{"location":"FAQ-pl/#moj-email-powitalny-zagina","title":"M\u00f3j email powitalny zagin\u0105\u0142.","text":"<p>Niestety czasami email powitalny mo\u017ce zagin\u0105\u0107. Je\u015bli tak si\u0119 sta\u0142o, to zaloguj si\u0119 na pseudonim/has\u0142o na kt\u00f3rym si\u0119 zarejestrowa\u0142e\u015b, potem wejd\u017a w ustawienia. Na g\u00f3rze znajdziesz opcj\u0119 aby wys\u0142a\u0107 tw\u00f3j email rejestracyjny ponownie.</p>"},{"location":"FAQ-pl/#czemu-nie-widze-nowego-zdjecia-profilowego","title":"Czemu nie widz\u0119 nowego zdj\u0119cia profilowego?","text":"<p>Naci\u015bnij <code>Ctrl + F5</code> (na wi\u0119kszo\u015bci przegl\u0105darek). Czasami po tym jak zmieni\u0142e\u015b zdj\u0119cie profilowe (znane r\u00f3wnie\u017c jako awatar lub zdj\u0119cie u\u017cytkownika) musisz od\u015bwie\u017cy\u0107 pami\u0119\u0107 cache; w wi\u0119kszo\u015bci przegl\u0105darek <code>Ctrl + F5</code> jest najszybsz\u0105 metod\u0105.</p>"},{"location":"FAQ-pl/#gdzie-moge-znalesc-romy","title":"Gdzie mog\u0119 znale\u015b\u0107 ROMy?","text":"<p>Nie tutaj, jest nielegalne hostowanie lub udost\u0119pnianie ROM\u00f3w. Lecz mamy stron\u0119 o Darmowych Grach gdzie mo\u017cesz znale\u017a\u0107 par\u0119 fajny gier homebrew.</p>"},{"location":"FAQ-pl/#czemu-moja-gra-nie-wczytuje-osiagniec","title":"Czemu moja gra nie wczytuje osi\u0105gni\u0119\u0107?","text":"<p>Mo\u017ce by\u0107 to:</p> <ol> <li>Brak osi\u0105gni\u0119\u0107 dla tej gry.</li> <li>Masz z\u0142y rom.</li> </ol> <p>Dobrym nawykiem mo\u017ce by\u0107 sprawdzenie oficjalnego tematu gry na forum. Je\u015bli ci\u0105gle nie masz odpowiedzi sprawd\u017a t\u0105 stron\u0119 po wi\u0119cej szczeg\u00f3\u0142\u00f3w: Moja gra nie \u0142aduje osi\u0105gni\u0119\u0107.</p>"},{"location":"FAQ-pl/#retroarchralibretro-nie-uruchamia-mojej-gry-automatowej-co-powinienem-zrobic","title":"RetroArch/RALibretro nie uruchamia mojej gry automatowej. Co powinienem zrobi\u0107?","text":"<p>Najpierw: Upewnij si\u0119 \u017ce u\u017cywasz odpowiedniego rdzenia RetroArch. Kliknij tutaj aby dowiedzie\u0107 si\u0119 jaki rdze\u0144 obs\u0142uguje funkcje RetroAchievements dla gier automatowych.</p> <p>Potem: ROMy automatowe s\u0105 bardziej skomplikowane ni\u017c ROMy consolowe. Jest pare termin\u00f3w i koncept\u00f3w kt\u00f3re musisz zrozumie\u0107 aby to nabra\u0142o sens. Tutaj jest dobry tekst na ten temat: Obja\u015bnienie ROM\u00f3w MAME.</p> <p>Szybka rada: U\u017cyj swojej ulubionej przegl\u0105darki i znajd\u017a \"zestaw bazuj\u0105cy\" (u\u017cywanie ROM\u00f3w losowo wzi\u0119tych z r\u00f3\u017cnych \u017ar\u00f3de\u0142 polega na metodzie \"pr\u00f3b i b\u0142\u0119d\u00f3w\" i najprawdopodobniej prowadzi do sporej ilo\u015bci frustracji).</p>"},{"location":"FAQ-pl/#czy-retroachievements-bedzie-wspierac-ta-albo-tamta-konsole","title":"Czy RetroAchievements b\u0119dzie wspiera\u0107 t\u0105 albo tamt\u0105 konsol\u0119?","text":"<p>Kr\u00f3tka odpowied\u017a: Tak, b\u0119dzie</p> <p>D\u0142uga odpowied\u017a: Jedyn\u0105 poprawn\u0105 odpowiedzi\u0105 jest \"Kiedykolwiek kto\u015b z umiej\u0119tno\u015bci\u0105 i ch\u0119ci\u0105 kodowania wsparcia to zrobi.\" - Ka\u017cdy tutaj jest ochotnikiem wi\u0119c dodatkowe wsparcie b\u0119dzie si\u0119 dzia\u0142o, kiedy b\u0119dzie si\u0119 dzia\u0142o.</p>"},{"location":"FAQ-pl/#jak-poprosic-o-zestaw-osiagniec","title":"Jak poprosi\u0107 o zestaw osi\u0105gni\u0119\u0107?","text":"<p>Na ka\u017cdej stronie jest link \"Request set\"</p> <p></p> <p>Klikni\u0119cie tego doda twoj\u0105 nazwe do listy os\u00f3b kt\u00f3re prosz\u0105 o zestaw (lub set) osi\u0105gni\u0119\u0107 do tej gry. Klikni\u0119cie ponownie spowoduje usuni\u0119cie pro\u015bby. \u017beby zobaczy\u0107 list\u0119 os\u00f3b prosz\u0105cych o zestaw osi\u0105gni\u0119\u0107 do tej gry, naci\u015bnij link \"Set Requestors for this game\" w sekcji \"More Info\" na dole strony.</p> <p></p> <p></p> <p>Ca\u0142kowita lista pr\u00f3\u015bb jest podliczana i wy\u015bwietlana na stronie Najbardziej proszonych set\u00f3w, kt\u00f3ra mo\u017ce by\u0107 sortowana wed\u0142ug konsoli. Je\u015bli i kiedy set b\u0119dzie stworzony, pro\u015bby powr\u00f3c\u0105 do u\u017cytkownika, aby m\u00f3g\u0142 u\u017cy\u0107 je na innej grze.</p> <p>Liczba pr\u00f3\u015bb jest ustalana wed\u0142ug nast\u0119puj\u0105cej formu\u0142y:</p> <ul> <li>1 za ka\u017cdy rok posiadania konta</li> <li>1 za osi\u0105gni\u0119cie 2500, 5k, 10k, 15k, 20k</li> <li>1 za ka\u017cde 10k w przedziale 20-180k</li> <li>1 za ka\u017cde 20k dalej</li> </ul> <p>Notka: Wszyscy tw\u00f3rcy osi\u0105gni\u0119\u0107 s\u0105 ochotnikami, pro\u015bba o set nie gwarantuje powstanie osi\u0105gni\u0119\u0107 do tej gry. Cel tej funkcji jest pokazanie developerom tego, co gracze chc\u0105 najbardziej. Mo\u017cesz r\u00f3wnie\u017c zastanowi\u0107 si\u0119 nad zasugerowaniem osi\u0105gni\u0119\u0107 na temacie gry na forum, aby u\u0142atwi\u0107 zacz\u0119cie tworzenia nowego seta.</p>"},{"location":"FAQ-pl/#co-robic-gdy-osiagniecia-nie-dziaaja-prawidowo","title":"Co robi\u0107 gdy osi\u0105gni\u0119cia nie dzia\u0142aj\u0105 prawid\u0142owo?","text":"<p>Kiedy pojawi si\u0119 problem z osi\u0105gni\u0119ciami, gdy nie zosta\u0142e\u015b nagrodzony osi\u0105gni\u0119ciem, lub zosta\u0142e\u015b nagrodzony w nieodpowiednim momencie, istnieje rozwi\u0105zanie tego problemu i mo\u017cliwo\u015b\u0107 zostania poprawnie nagrodzonym. Najpierw powiniene\u015b Zg\u0142osi\u0107 popsute osi\u0105gni\u0119cie (Jest to solidny spos\u00f3b aby wnie\u015b\u0107 wk\u0142ad w popraw\u0119 spo\u0142eczno\u015bci!) To stworzy zg\u0142oszenie dla dewelopera osi\u0105gni\u0119\u0107, kt\u00f3ry potem oceni problem i poszuka rozwi\u0105zania.</p> <p>Je\u017celi nie zosta\u0142e\u015b nagrodzony osi\u0105gni\u0119ciem mo\u017cesz zosta\u0107 nagrodzony r\u0119cznie. B\u0119dziesz potrzebowa\u0142 Zg\u0142oszenie zepsutego osi\u0105gni\u0119cia i Dow\u00f3d jego wykonania</p>"},{"location":"FAQ-pt_BR/","title":"FAQ (Perguntas Frequentes)","text":"<p>Link para o texto em ingl\u00eas: FAQ</p>"},{"location":"FAQ-pt_BR/#o-que-e-o-retroachievementsorg","title":"O que \u00e9 o RetroAchievements.org?","text":"<p>RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos cujos membros colaboram para a sua manuten\u00e7\u00e3o e aperfei\u00e7oamento enquanto  competem entre si para ganhar conquistas personalizadas em jogos cl\u00e1ssicos por meio da emula\u00e7\u00e3o. Todas as conquistas s\u00e3o criadas e mantidas pela pr\u00f3pria comunidade e s\u00e3o presenteadas para os usu\u00e1rios atrav\u00e9s de emuladores especialmente customizados e disponibilizados em nossa p\u00e1gina. Uma vez logado em nossos emuladores, os programas ir\u00e3o informar \u00e0 central todas as conquistas que voc\u00ea conquistou para que voc\u00ea possa checar e comparar o seu progresso com o de seus amigos atrav\u00e9s do site.</p> <p>No exemplo a seguir, RAGens (nossa vers\u00e3o personalizada do emulador Gens do Mega Drive) est\u00e1 emulando o jogo Streets of Rage 2. Dois leaderboards especiais podem ser notados no canto inferior direito da tela (eles ir\u00e3o coletar informa\u00e7\u00f5es especiais como a pontua\u00e7\u00e3o, por exemplo). Ao completar uma s\u00e9rie de requisitos, uma conquista \u00e9 desbloqueada pelo jogador que \u00e9 informado sobre o evento atrav\u00e9s de um \"pop-up\" especial. Ao final do exemplo, um menu especial com v\u00e1rias informa\u00e7\u00f5es sobre o jogo (que pode ser ativado ao pressionar a tecla ESC) aparece na tela.</p> <p></p>"},{"location":"FAQ-pt_BR/#o-que-e-o-modo-hardcore","title":"O que \u00e9 o modo HARDCORE?","text":"<p>O modo HARDCORE \u00e9 um recurso adicional que separa os bons jogadores dos grandes jogadores! Ao habilitar esse modo, voc\u00ea ficar\u00e1 impossibilitado de carregar um arquivo de \"savestate\" previamente salvo, ou seja: o jogo n\u00e3o mais poder\u00e1 ser salvo e carregado a qualquer momento. Ao habilitar o modo HARDCORE, voc\u00ea dever\u00e1 completar o jogo assim como ele foi projetado em seu console original e ganhar as suas conquistas sem a ajuda de recursos extras. Como recompensa, toda vez que habilitar uma conquista nesse modo, duas vers\u00f5es da mesma conquista ser\u00e3o presenteadas: a sua vers\u00e3o normal (ou SOFTCORE) e a sua vers\u00e3o HARDCORE, cada uma delas somando a mesma quantidade de pontos ao seu placar totalizando o dobro de pontos que iriam ser ganhos com o modo HARDCORE desabilitado. Um jogo com um total de 400 pontos poder\u00e1 lhe conferir 800 pontos caso voc\u00ea ganhe todas as conquistas dispon\u00edveis no modo HARCORE!</p> <p>Nota: Ao jogar no modo \"SOFTCORE\" e usar as op\u00e7\u00f5es de \"savestate\" para salvar e carregar o seu jogo a qualquer momento, comportamentos inesperados por parte das conquistas poder\u00e3o ser observados. Para mais informa\u00e7\u00f5es, leia o informe em: Why you shouldn't use the load state feature</p>"},{"location":"FAQ-pt_BR/#qual-emulador-eu-preciso-usar","title":"Qual emulador eu preciso usar?","text":"<p>Os emuladores oficiais do RetroAchiements.org s\u00e3o todos baseados em Windows. Para outros sistemas operacionais, voc\u00ea pode usar o RetroArch. Mais informa\u00e7\u00f5es abaixo:</p>"},{"location":"FAQ-pt_BR/#emuladores-oficiais-do-retroachievementsorg","title":"Emuladores oficiais do RetroAchievements.org","text":"<p>Por favor, fa\u00e7a o download do emulador da sua escolha na pagina de download, fa\u00e7a login usando o seu username e senha, ent\u00e3o carregue uma ROM e jogue! Veja o v\u00eddeo a seguir para uma demonstra\u00e7\u00e3o:</p> <p>https://www.youtube.com/watch?v=rKY2mZjurJw</p>"},{"location":"FAQ-pt_BR/#como-eu-acesso-o-overlay-de-conquista","title":"Como eu acesso o Overlay de conquista?","text":"<p>Normalmente, isso \u00e9 configurado na tecla do seu teclado'ESC', ou na fun\u00e7\u00e3o de pause no jogo. Na maioria dos emuladores, um jogo deve ser ativo para isso ser funcional.</p> <p>Alguns dos emuladores j\u00e1 devem ser configurados atribuindo um bot\u00e3o do controle para ver o overlay de conquistas. Geralmente ESC no teclado deve ativ\u00e1-lo, mas se voc\u00ea quer associar isto para um controle, veja este link.</p>"},{"location":"FAQ-pt_BR/#emuladores-retroarch","title":"Emuladores Retroarch","text":"<p>Para sistemas operacionais \"N\u00e3o-Windows\" voc\u00ea deve usar o RetroArch.</p> <p>Atualmente voc\u00ea pode ganhar conquistas via RetroArch nessas seguintes plataformas:</p> <ul> <li>Windows</li> <li>Linux</li> <li>Mac</li> <li>Android (Sim! Voc\u00ea pode ganhar conquista onde quiser com o seu telefone Android!)</li> <li>PlayStation Vita (precisa ser desbloqueado com o HENkaku)</li> <li>PlayStation 3</li> <li>Wii U</li> <li>Raspberry Pi (Sistemas recomendados: RetroPie, lakka e RecalBox</li> </ul> <p>Voc\u00ea pode conseguir o RetroArch aqui.</p> <p>Uma vez voce instalado e feito a configura\u00e7\u00e3o inicial, seguindo este guia para configurar as Conquistas: https://libretro.readthedocs.io/en/latest/guides/retroachievements/</p> <p>Mantenha em mente que nem todos os cores do RetroArch \u00e9 compativel com o RetroAchievements. Confira esta lista para ver qual escolher.</p> <p><code>Nota do tradutor: Cores s\u00e3o arquivos que permitem que o RetroArch seja capaz de interpretar emuladores e posteriormente, ROMs.</code></p>"},{"location":"FAQ-pt_BR/#como-eu-posso-ver-o-icone-da-conquista-quando-eu-ganho-uma-conquista-no-retroarch","title":"Como eu posso ver o \u00edcone da conquista quando eu ganho uma conquista no RetroArch?","text":"<p>O RetroArch n\u00e3o tem suporte para esse recurso. Quando voc\u00ea ganha uma conquista, voc\u00ea apenas v\u00ea um texto com o t\u00edtulo da conquista e ent\u00e3o a descri\u00e7\u00e3o. Aqui est\u00e1 um t\u00f3pico sobre isso no rastrador de quest\u00f5es do RetroArch, mas isso n\u00e3o parece ser uma prioridade para qualquer desenvolvedor ativo. Voc\u00ea \u00e9 um programador em C e quer tentar? Qualquer contribui\u00e7\u00e3o \u00e9 muito bem vinda!</p>"},{"location":"FAQ-pt_BR/#meu-email-de-boas-vindas-sumiu","title":"Meu email de boas-vindas sumiu!","text":"<p>Infelizmente algumas vezes o email de boas-vindas \u00e9 conhecido por sumir. Se isso acontecer, por favor, fa\u00e7a login com o seu username e senha que voc\u00ea registrou, ent\u00e3o visite sua p\u00e1gina de configura\u00e7\u00f5es. No topo voce ir\u00e1 encontrar uma op\u00e7\u00e3o para reenviar o seu email de registra\u00e7\u00e3o.</p>"},{"location":"FAQ-pt_BR/#onde-eu-posso-encontrar-roms","title":"Onde eu posso encontrar ROMs","text":"<p>Aqui n\u00e3o. Infelizmente \u00e9 ilegal hospedar ou distribuir ROMs com copyright. Para extrair o arquivo de ROM do seus cartuchos, voc\u00ea pode usar uma ferramenta como o Retrode ou algo similar, ent\u00e3o voc\u00ea pode usar o arquivo de ROM nos nossos emuladores. Outros sites hospedam arquivos ROM que voc\u00ea poderia usar com nossos emuladores, mas n\u00e3o aceitamos baixar ou jogar ROMs para jogos que voc\u00ea n\u00e3o possui.</p>"},{"location":"FAQ-pt_BR/#porque-o-meu-jogo-nao-esta-carregando-as-conquistas","title":"Porque o meu jogo n\u00e3o est\u00e1 carregando as conquistas?","text":"<p>Motivos:</p> <ol> <li>N\u00e3o possui conquistas,</li> <li>Voc\u00ea possui a ROM incorreta.</li> </ol> <p>Para mais detalhes leia esta p\u00e1gina: Meu jogo n\u00e3o est\u00e1 carregando conquistas.</p> <p>Se voc\u00ea \u00e9 um usu\u00e1rio Linux, voc\u00ea pode usar essa ferramenta para checar se sua ROM est\u00e1 OK para o RetroAchievements: https://github.com/meleu/hascheevos</p>"},{"location":"FAQ-pt_BR/#esta-conquista-nao-ativou-ou-ativou-em-um-momento-errado","title":"Esta conquista n\u00e3o ativou! (ou ativou em um momento errado)","text":"<p>Esta \u00e9 uma fun\u00e7\u00e3o contruida para apenas emuladores oficiais (n\u00e3o no RetroArch) que permique que voc\u00ea reporte conquistas quebradas que ocorram no momento errado, ou nem ativar. V\u00e1 em RetroAchievements -&gt; Report Broken Achievements.</p> <p>Veja este exemplo:</p> <p>.</p> <p>Al\u00e9m disso, aqui est\u00e1 um video detalhado explicando como usar isto: https://www.youtube.com/watch?v=TTHbm700Y-Y <code>V\u00eddeo em ingl\u00eas</code></p> <p>Adicionando detalhes do seu estado do jogo quando ativou/n\u00e3o ativou, qual o modo de jogo, onde voc\u00ea estava quando aconteceu/n\u00e3o aconteceu, se voc\u00ea teve que resetar o jogo recentemente, tudo que voc\u00ea acha que pode ser relevante para a conquista. Isto \u00e9 necess\u00e1rio para o nosso sistema, ent\u00e3o os desenvolvedores sabem onde est\u00e1 o problema.</p> <p>Se voc\u00ea tiver evid\u00eancias de conclus\u00e3o, voc\u00ea pode tambem contatar um administrador e a conquista pode ser premiada manualmente para voc\u00ea. Fa\u00e7a provas e poste em <code>#help-me</code> no Discord com a tag @admin. ou envie um PM (Mensagem Pessoal) para um usu\u00e1rio com o nivel de administrador.</p> <p>Provas Qualificadas Capturas de Tela que mostra que est\u00e1 jogando no hardcore e que completou a conquista. Tal como v\u00eddeo (melhor ainda). Exemplos de conquistas que voc\u00ea ganhou que substituem esta conquista, ex. Voc\u00ea conseguiu a conquista por 10 mil pontos mas de 5 mil pontos n\u00e3o ativou.</p> <p>Aqui est\u00e1 um exemplo perfeito de prova fornecido pelo gr1nya.</p>"},{"location":"FAQ-pt_BR/#eu-quero-fazer-conquistas","title":"Eu quero fazer conquistas!","text":"<p>Que bom!! O melhor lugar para se iniciar \u00e9 aqui Come\u00e7ando como um desenvolvedor de conquistas. Uma vez que voc\u00ea se familiarizar com o Memory Inspector e outros di\u00e1logos relacionados a conquistas, voc\u00ea pode ir em outros Documentos para Desenvolvedores</p> <p>Por favor, n\u00e3o hesite em perguntar se voc\u00ea precisa de ajuda, n\u00e3o debata-se! A coisa mais importante \u00e9 ter certeza que est\u00e1 aproveitando qualquer coisa que voc\u00ea esteja fazendo, Se voc\u00ea n\u00e3o est\u00e1 se divertindo, n\u00e3o fa\u00e7a. Mas se voc\u00ea estiver frustrado e quer persistir, apenas mande uma mensagem nos foruns ou no Servidor do Discord e alguem ir\u00e1 lhe responder rapidamente.</p>"},{"location":"FAQ-pt_BR/#o-que-sao-os-pontos-brancos","title":"O que s\u00e3o os Pontos Brancos?","text":"<p>Pontos brancos s\u00e3o secund\u00e1rios baseados em qu\u00e3o dificil uma conquista \u00e9. Explicado Aqui em detalhes.</p>"},{"location":"FAQ-pt_BR/#o-que-e-considerado-trapaca-para-o-hardcore-e-se-eu-encontrar-evidencas-de-um-trapaceiro","title":"O que \u00e9 considerado trapa\u00e7a (para o hardcore)? E se eu encontrar evid\u00eancas de um trapaceiro?","text":"<p>A explora\u00e7\u00e3o de set de conquistas e a altera\u00e7\u00e3o ou modifica\u00e7\u00e3o deliberada de jogos, emuladores, mem\u00f3ria, velocidade (fast-forward \u00e9 permitido) ou set. Carregar saves para obter conquistas sem ganh\u00e1-los durante o jogo normal.</p> <p>Todas as trapa\u00e7as dos jogos n\u00e3o s\u00e3o permitidas a menos que seja especificado na descri\u00e7\u00e3o da conquista ou coment\u00e1rios na p\u00e1gina da conquista.</p> <p>Nos vivemos por um c\u00f3digo de honra acima de tudo. Se voc\u00ea encontar evid\u00eancias de um trapaceiro, envie a evid\u00eancia para o RAdmin ou para o email RAmodmail@gmail.com.</p>"},{"location":"FAQ-pt_BR/#e-se-eu-conseguir-uma-conquista-que-eu-nao-ganhei","title":"E se eu conseguir uma conquista que eu n\u00e3o ganhei?","text":"<p>Mesmo que voc\u00ea n\u00e3o consiga, na maioria dos casos, voc\u00ea deve criar um ticket report (veja abaixo), deixando uma explica\u00e7\u00e3o do que foi errado. Voc\u00ea pode tambem remover essas conquistas de sua conta para voc\u00ea ter a satisfa\u00e7\u00e3o de ganhar realmente ganhar elas.</p> <p> Resetando conquistas n\u00e3o ganhas</p>"},{"location":"FAQ-pt_BR/#como-eu-redefino-minha-senha-se-eu-nao-lembrar-minha-senha","title":"Como eu redefino minha senha? (Se eu n\u00e3o lembrar minha senha)","text":"<p>Aqui: https://retroachievements.org/resetPassword.php</p> <p>No site, na pagina frontal, enquanto n\u00e3o estiver logado </p>"},{"location":"FAQ-pt_BR/#porque-meu-jogo-nao-esta-carregando-as-conquistas","title":"Porque meu jogo n\u00e3o est\u00e1 carregando as conquistas?","text":"<p>Veja: Porque meu jogo nao est\u00e1 carregando as conquistas</p>"},{"location":"FAQ-pt_BR/#retroachievements-tem-alguma-finalidade-lucrativa","title":"RetroAchievements tem alguma finalidade lucrativa?","text":"<p>N\u00e3o. RetroAchievments \u00e9 uma comunidade de f\u00e3s devotados que dedicam tributos aos seus jogos favoritos criando conquistas e competindo entre si. Embora aceitemos doa\u00e7\u00f5es atrav\u00e9s do Patreon, todo o dinheiro arrecadado \u00e9 destinado \u00e0 manuten\u00e7\u00e3o do servidor e \u00e0s despesas originadas pelo nosso site que se mant\u00e9m inteiramente livre de propagandas. Todos os programadores e desenvolvedores dedicam o seu tempo \u00e0 melhora da comunidade sem nenhum retorno financeiro.</p>"},{"location":"FAQ-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-04-21 03:38] luchaos:</code> update libretro docs links</li> <li><code>[2019-03-24 23:58] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 23:42] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 23:41] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 22:06] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:50] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:49] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-03-24 21:48] MrGaussRA:</code> Updated FAQ pt_BR (markdown)</li> <li><code>[2019-02-10 16:05] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:17] CoolCanuck:</code> https</li> </ul>"},{"location":"FAQ/","title":"FAQ","text":"<p>Frequently asked questions regarding the RetroAchievements website and RetroAchievements in general: - What is HARDCORE mode? - What are the white points? - Will RetroAchievements support this or that console? - How are game entries added to the site? - How do I request an achievement set? - How do I make achievements? - How can I contribute?   - Testing   - Creating Tickets     - Saves and Save States</p> <p>Frequently asked questions regarding the emulators, earning achievements, etc.: - Where can I find ROMs? - Why do I get a message that some achievements are unsupported? - What do I do when the achievement isn't working right?   - Manual Unlocks - Why are achievements not loading? - Which emulators and/or cores should I use?</p> <p>Frequently asked questions regarding user accounts. - Why can't I see my new profile picture? - My welcome email has gone missing! - How do I reset my password? (If I don't remember my password) - Will I have any privilege if I become a patron? - How do I delete my account?</p>"},{"location":"FAQ/#retroachievements-faq","title":"RetroAchievements FAQ","text":""},{"location":"FAQ/#what-is-hardcore-mode","title":"What is HARDCORE mode?","text":"<p>If you want to have a one-to-one replication of how you used to play retro games in the distant past, then HARDCORE mode is what you are looking for. This feature restricts the player from ever loading save states (creating them is allowed for practice/ticket purposes when not playing on HARDCORE), using cheats, and any speed-altering features like rewinding, slow-motion, and advancing the game one frame at a time by using the emulator's built-in functions. Note that the only exception to altering speed is fast-forward which IS allowed. Basically, you are playing the game without the game-altering enhancements emulators come with.</p> <p>While you will still be able to get achievements in Softcore, playing on HARDCORE mode is the only way to earn a Mastery for a game, displaying your skill- and prowess to your fellow retro achievers and competitors by showing up on the game's page as a master of the game, as well as on the main leaderboard. Playing on HARDCORE will also allow you to set times, scores or participate in miscellaneous challenges on game-specific leaderboards.</p> <p>Note: If you want to play with the HARDCORE mode disabled (also known as \"Softcore\"), expect to have some issues. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"FAQ/#what-are-the-white-points","title":"What are the white points?","text":"<p>White points, known as Retro Ratio points, are secondary points based on how hard an achievement is, however this feature is not very accurate currently. Explained here in detail.</p>"},{"location":"FAQ/#will-retroachievements-support-this-or-that-console","title":"Will RetroAchievements support this or that console?","text":"<p>Short answer: Yes, it will.</p> <p>Long answer: The only correct answer to this question is \"Whenever someone with the skills and desire to code support, does just that.\" - Everyone here is a volunteer so additional support and features happen when they happen. In many cases support for a console is dictated by the emulator(core) developer and is outside of Retroachievement's control.</p> <p>For more information on specific consoles you can check here: System X When?</p>"},{"location":"FAQ/#how-do-i-request-an-achievement-set","title":"How do I request an achievement set?","text":"<p>On each game's page there is a link to \"Request Set\".  </p> <p></p> <p>Clicking this will add your name to the list of users who have requested a set for the game. Clicking again will withdraw the request. To see other users who have requested the set, click on the \"Set Requestors\" link below the game's box art.</p> <p></p> <p></p> <p>The total number of requests are tallied and displayed on the Most Requested Sets page which can also be sorted by console.  If and when a set is created the user request will be automatically returned to use for another game.</p> <p>The number of requests available to a user is determined as follows:</p> <ul> <li>1 for every year you've had your account</li> <li>1 for every event badge you have earned</li> <li>1 for reaching 1250, 2500, 5k, 7500, 10k</li> <li>1 for every 5k from 10k-100k</li> <li>1 for every 10k thereafter</li> <li>*Softcore points will count requests up to 10k points for a total of 5</li> </ul> <p>Note: All achievement developers are volunteers, requesting a set gives no guarantee that achievements will be made.  The purpose of the request feature is to give developers visibility to what players want most.  You might also consider making achievement suggestions on a game's forum page to help get a set off the ground.</p>"},{"location":"FAQ/#emulation-faq","title":"Emulation FAQ","text":""},{"location":"FAQ/#where-can-i-find-roms","title":"Where can I find ROMs?","text":"<p>Not here. It is illegal to host or distribute copyrighted ROMs. However we have a page about Free Games where you can find some really cool homebrews.</p>"},{"location":"FAQ/#why-do-i-get-a-message-that-some-achievements-are-unsupported","title":"Why do I get a message that some achievements are unsupported?","text":"<p>This message informs the user that some achievements cannot be activated either because their version of RetroArch and/or the core being used does not support some newer logic features, or because required areas of the RAM are not exposed for achievement processing.</p> <p>In most cases updating to the latest version of RetroArch will correct the problem, alternately updating or using a different supported core will resolve the problem. </p>"},{"location":"FAQ/#what-do-i-do-when-the-achievement-isnt-working-right","title":"What do I do when the achievement isn't working right?","text":"<p>When problems with achievements occur, either where the achievement wasn't awarded to you or it was awarded at the wrong time, there are solutions to get the problems fixed and for proper credit to be given to you! First you'll want to report the broken achievement. (This is an excellent way to contribute to the betterment of the community!) It creates a ticket report for the achievement developers who will then review the problem and look for a solution.</p> <p>If the achievement wasn't awarded, you can request a manual-unlock. You'll need to report the broken achievement and provide proof of completion.</p>"},{"location":"FAQ/#how-do-i-report-a-broken-achievement","title":"How do I report a broken achievement?","text":"<p>There are two ways to report broken achievements. In the emulator title bar go to RetroAchievements \u21d2 Report Broken Achievements:</p> <ol> <li>For Official RetroAchevement emulators only:</li> </ol> <p>.</p> <ol> <li>For RetroArch users you can submit the report directly via website. On every achievement's page you'll see a link saying <code>Report an issue for this achievement</code>, like in the image below:</li> </ol> <p></p> <p>If you use the Official RetroAchevement emulators you can also report problems from the website achievement page, but it is preferred that you use the method built into the emulators. </p>"},{"location":"FAQ/#what-details-i-have-to-add-to-a-broken-achievement-report","title":"What details I have to add to a broken achievement report?","text":"<p>You have to add those information in order for a developer to recognize an issue:</p> <ul> <li>Type of issue (doesn't trigger or triggers at the wrong time)</li> <li>Emulator you were using (and core if using RALib/Retroarch)</li> <li>RA hash (checksum) to recognize a version of the game</li> </ul>"},{"location":"FAQ/#what-details-should-i-add-to-a-broken-achievement-report","title":"What details should I add to a broken achievement report?","text":"<p>If possible, in the broken achievement report Comment paste a link to a screenshot or video (even better) of where the problem occurred. It's recommended to post screenshots on imgur and videos on YouTube.</p> <p>Also add details like:</p> <ul> <li>when it was/wasn't awarded;</li> <li>what game mode (HARDCORE/softcore);</li> <li>what difficulty level or other settings you've selected;</li> <li>how long you were playing;</li> <li>when you most recently died or continued;</li> <li>what you think the problem might be or any details you think could be helpful.</li> </ul> <p>This is necessary so the achievement developers know where the problem is.</p>"},{"location":"FAQ/#what-is-an-ra-hash","title":"What is an RA hash?","text":"<p>RA hash is an unique string of 32 hexadecimal numbers, to distinguish different games and versions of them, all of them have one. </p>"},{"location":"FAQ/#how-do-i-check-the-ra-hash-of-the-game-im-playing","title":"How do I check the RA hash of the game I'm playing?","text":"<ul> <li>For Retroarch - Quick Menu \u21d2 Information, then at the bottom there is \"RetroAchievements Hash\" which is, in fact an RA hash</li> <li>For Standalones/RaLibretro - RetroAchievement tab at the top \u21d2 Get ROM Checksum, and it shows the RA hash</li> </ul>"},{"location":"FAQ/#in-short-how-to-request-a-manual-unlock","title":"In short how to request a manual unlock","text":"<ul> <li>If you use Discord Post in the #manual-unlock channel a request that looks similar to one of these:  <p>@manual-unlock http://retroachievements.org/ticketmanager.php?i=9577 HARDCORE Proof: https://youtu.be/uqD-GTkZbLo</p> <p>@manual-unlock http://retroachievements.org/ticketmanager.php?i=16705 softcore Proof: https://i.imgur.com/83bJE43.png</p> </li> </ul> <ul> <li>If you don't use Discord  While signed into RetroAchievments.org send a private message to the RAdmin user with the title: Manual Unlock Request and a description that looks similar to this:<p>Hi. I'm requesting a manual unlock. http://retroachievements.org/ticketmanager.php?i=9577 HARDCORE Proof: https://youtu.be/uqD-GTkZbLo</p> </li> </ul>"},{"location":"FAQ/#in-detail-how-to-request-a-manual-unlock","title":"In detail how to request a manual unlock","text":"<ol> <li>Open a ticket describing with details the problem you had with the achievement. (How do I report a broken achievement?)     1. If the achievement wasn't registered on the site due to a network problem, you don't need to open a ticket.</li> <li>Get a proof/evidence that you completed the achievement. Acceptable proofs:     1. Screenshots that show that one is playing in HARDCORE and have completed the achievement.     2. Video of such (even better) (perfect example of ideal proof provided by gr1nya).     3. Examples of achievements you've earned that prove you've earned this achievement. Example: You got the achievement for 10k points but the one for 5k points wasn't awarded to you.</li> <li>If you're on our discord server, send a message on the <code>#manual-unlock</code> channel tagging the @manual-unlock role; if you're not on Discord, send a private message message to the RAdmin user. Your message must have:     1. The link to the ticket url. You can find the ticket here: http://retroachievements.org/ticketmanager.php     2. What mode you were playing (HARDCORE/softcore)     3. Link to your qualified proof of completion. Include proof that the achievement was earned in HARDCORE, if you were playing in HARDCORE.</li> </ol> <p>Note: Manual unlocks are intended for players with proof of earning achievements that did not trigger on site due to a bug or network issue.</p> <p>They are not indented for, and will not be awarded to players who have played the game prior to a set being available, or on an another inherently unsupported platform (original hardware for example).</p>"},{"location":"FAQ/#what-if-i-got-an-achievement-i-didnt-earn","title":"What if I got an achievement I didn't earn?","text":"<p>Same with not getting it when you should in most cases you'll want to create a ticket report, leaving an explanation of what went wrong. You'll also want to reset these achievements from your earn history so you can get the satisfaction of truly earning them.</p>"},{"location":"FAQ/#how-do-i-reset-achievements","title":"How do I reset achievements?","text":"<p>There are three ways to do this:</p> <ul> <li>On the achievement page: </li> </ul> <ul> <li>On the game page (when you want or need to reset all earns in a game): </li> </ul> <ul> <li>Near the bottom of your user settings page: </li> </ul>"},{"location":"FAQ/#am-i-the-only-one-with-an-issue","title":"Am I the only one with an issue?","text":"<p>If an achievement doesn't work correctly for you, there is a very good chance it doesn't work for other people. You can check in the achievement's page and look for where it says 'The achievement has 'X' open tickets':</p> <p></p> <p>If the game has tickets, click on the 'open tickets' link. There will be a list to show any reports of broken achievements. You can comment on these to add helpful details or say you have a problem with this achievement too.</p>"},{"location":"FAQ/#account-faq","title":"Account FAQ","text":""},{"location":"FAQ/#why-cant-i-see-my-new-profile-picture","title":"Why can't I see my new profile picture?","text":"<p>Press <code>Ctrl + F5</code> (on most browsers). Sometimes after you've changed your profile picture (also known as avatar or user pic) and you need to refresh your browser cache; in most browsers <code>Ctrl + F5</code> is the quickest way to do it.</p>"},{"location":"FAQ/#my-welcome-email-has-gone-missing","title":"My welcome email has gone missing!","text":"<p>Unfortunately sometimes the welcome email has been known to go missing. If this happens, please log in with your username/password you registered with, then visit your settings page. At the top you'll find the option to resend your registration email.</p>"},{"location":"FAQ/#how-do-i-reset-my-password-if-i-dont-remember-my-password","title":"How do I reset my password? (If I don't remember my password)","text":"<p>Right Here: https://retroachievements.org/resetPassword.php</p> <p>On Site, front page, while not logged in:</p> <p></p>"},{"location":"FAQ/#will-i-have-any-privilege-if-i-become-a-patron","title":"Will I have any privilege if I become a patron?","text":"<p>On the website you'll have a badge to mean \"I helped fund RA!\". On the discord server you'll have access to a dedicated channel. Although we are all immensely grateful for the contributions of the patrons, there is no other bonus besides those ones.</p> <p>Thanks to the Patreon contributions the RetroAchievements project can pay for a decent server to run the website, run the discord bot and also have periodic backups (to recover data in the event of a disaster), and all this with an ad-free experience. The whole community owe a big thank you to the patrons.</p>"},{"location":"FAQ/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-08-03 15:50] Nepiki:</code> Added that players can get a set request from every event badge</li> <li><code>[2023-06-30 12:53] televandalist:</code> Updated FAQ (markdown)</li> <li><code>[2023-06-05 22:04] televandalist:</code> Added a few placeholder questions</li> <li><code>[2023-04-20 05:39] televandalist:</code> Separated into categories (Account, Emulation, and RetroAchievements)</li> <li><code>[2023-04-20 05:30] televandalist:</code> Updated the set request images since they were out-of-date and gigantic.</li> <li><code>[2023-04-20 05:21] televandalist:</code> Got rid of out-of-date info and sections that have their own dedicated pages.</li> <li><code>[2023-04-19 23:43] televandalist:</code> Removed part about getting errors from using words like \"drop\" and \"select\" - it's no longer relevant.  Removed part asking if RA profits off of emulation. It's covered in the RA Manifesto.</li> <li><code>[2023-01-11 22:48] pingus:</code> Change outdated cores list link from libretro to RADocs.</li> <li><code>[2022-09-09 12:37] Nepiki:</code> Updated Hardcore paragraph regarding leaderboards to account for scores/miscellaneous challenges</li> <li><code>[2022-09-08 16:30] Nepiki:</code> Changed the marketing for Hardcore mode.</li> </ul>"},{"location":"Free-Games/","title":"Free Games","text":"<p>In this page you can find games that are completely and legally free download and play on your emulators. Many of them have an achievement set at RetroAchievements.org.</p>"},{"location":"Free-Games/#atari-2600","title":"Atari 2600","text":"<p>AtariAge has plenty of Atari homebrew on their website that you can either purchase physical cartridges of or (most of the time) download from their forums for free with a quick google search.</p> <p>Some examples of AtariAge Atari 2600 homebrew:</p> <ul> <li>Amoeba Jump - by Dionoid</li> <li>AVGN K.O. Boxing - by Devin Cook</li> <li>Flappy - by Michael Haas</li> <li>Go Fish! - by Bob Montgomery</li> <li>Halo 2600 - by Ed Fries</li> <li>INV+ - by Erik Mooney, Piero Cavina</li> <li>Oystron - by Piero Cavina</li> <li>Pac-Man 4K - by Dennis Debro</li> <li>Princess Rescue - by Chris Spry (Due to complications with Nintendo, you can no longer purchase physical copies of this one)</li> <li>Sheep It Up! - by Dr. Ludos</li> <li>Snake-2600 - by Wickeycolombus</li> <li>Tetris26 - by Colin Hughes</li> <li>Video Simon - by Mark De Smet</li> <li>Wall Jump Ninja - by Walaber</li> <li>Zippy the Porcupine - by Chris Spry</li> </ul>"},{"location":"Free-Games/#game-boy","title":"Game Boy","text":"<ul> <li>Dangan GB - by snorpung</li> <li>Deadeus - by -IZMA-</li> <li>Deep Forest - by Kevin Trepanier</li> <li>Dino's Offline Adventure - by gaming monster</li> <li>DMG Deals Damage - by Dr. Ludos</li> <li>Flappy Boy - by zurashu</li> <li>Petite Professional GB - by ocarson</li> <li>Pretty Princess' Castle Escape - by sergeeo</li> <li>Popcorn Caravan - by cabbage</li> <li>Snake - by Donald Hays</li> <li>The Binding of Isaac: Game Boy Edition - by Joshua Robertson</li> <li>Tobu Tobu Girl - by TangramGames</li> <li>Waifu Clicker - by Refresh Games</li> </ul>"},{"location":"Free-Games/#game-boy-color","title":"Game Boy Color","text":"<ul> <li>Hong Kong 2099 - by Bl4h8L4hBl4h</li> <li>Tobu Tobu Girl Deluxe - by TangramGames</li> <li>Warp Coin Catastrophe - by Proximity Sound</li> </ul>"},{"location":"Free-Games/#game-boy-advance","title":"Game Boy Advance","text":"<ul> <li>Celeste Classic - by Maddy Thorson and Noel Berry</li> <li>Pocket Meat - by BomberDev</li> <li>Snakes - by BadMrFrostyXXX</li> </ul>"},{"location":"Free-Games/#nintendo-ds","title":"Nintendo DS","text":"<ul> <li>Anguna DS - by Nathan Tolbert</li> <li>Bubble Wrap DS - by Prodigy Games</li> <li>Crocodingus in Cube Island - by PXLteam</li> <li>EunHye DS - by beadeulpiri</li> <li>Slide Puzzles - by Neumann(Puzzle), roronoa(Migraine), Dustin(15-16)</li> <li>Ultimate Sliding Puzzle - by Kukulcan, LOBO (Warning! some of the puzzles are NSFW!)</li> </ul>"},{"location":"Free-Games/#mega-drivegenesis","title":"Mega Drive/Genesis","text":"<ul> <li>30 Years of Nintendon't by Dr. Ludos</li> <li>Cave Story MD by andwn</li> <li>Double Cooked - by Zhamul, mipelius, Miranda</li> <li>L'ABBAYE DES MORTS - by </li> <li>Mega Flappy Sis - by Lennart</li> <li>Mighty Mighty Missile - by Locomalito(https://www.locomalito.com/)</li> <li>Pringles Game - by MtChocolate</li> <li>Uwol - Quest For Money - by Shiru</li> <li>ZOOMING SECRETARY: GOING PANIC - by Playonretro</li> </ul>"},{"location":"Free-Games/#nes","title":"NES","text":"<ul> <li>2048 - by tsone</li> <li>Alter Ego - by Shiru</li> <li>Blade Buster - by High Level Challenge</li> <li>B\u00f6bl - by Morphcat Games</li> <li>Bootee - by [Mojo Twins](https://www.mojontwins.com/</li> <li>Cookie Clicker - by Damian Yerrick</li> <li>D-Pad Hero - by Kent Hansen, Andreas Pedersen</li> <li>D-Pad Hero 2 - by Kent Hansen, Andreas Pedersen</li> <li>Filthy Kitchen - by dustmop</li> <li>Function</li> <li>Gotta Protectors - Amazon's Running Diet - by Ancient Corp</li> <li>Gruniozerca - by emunes.pl</li> <li>Gruniozerca 2</li> <li>Hot Seat Harry - by Memblerz</li> <li>I Wanna Flip the Sky - by TomL</li> <li>Indivisible - by Kasumi</li> <li>Lala The Magical</li> <li>LAN Master - by Shiru</li> <li>Lawn Mower - by Shiru</li> <li>Legends of Owlia, The by Gradual Games</li> <li>Lunar Limit</li> <li>Melo-Jellos 2 - by Adrian Makes Games</li> <li>Miedow - by Mojo Twins</li> <li>MilioNESy</li> <li>Nebs 'n Debs</li> <li>NES Virus Cleaner</li> <li>NeSnake 2</li> <li>Project Blue</li> <li>SplatooD - by SplatooD Team</li> <li>Streemerz - by Mr. Podunkian</li> <li>Sudoku: NESWORLD Edition - by Al Bailey</li> <li>Super Bat Puncher - by Morphcat Games</li> <li>Zooming Secretary - by Shiru</li> </ul>"},{"location":"Free-Games/#snes","title":"SNES","text":"<ul> <li>Christmas Craze - by Shiru</li> <li>Super Boss Gaiden - by superfamicom.org (??)</li> <li>Super Sudoku - by Rapha\u00ebl Ass\u00e9nat</li> <li>Super Road Blaster (MSU-1) - by dforce3000</li> </ul>"},{"location":"Free-Games/#n64","title":"N64","text":"<ul> <li>Pyoro 64 - by n64squid</li> </ul>"},{"location":"Free-Games/#virtual-boy","title":"Virtual Boy","text":"<ul> <li>BLOX by KR155E</li> <li>Fishbone by thunderstruck and Virtual_Ben</li> <li>Mario Kart: Virtual Cup by DogP</li> <li>Tron by Alberto Covarrubias</li> <li>VB Racing by M.K.</li> </ul>"},{"location":"Game-Identification-es/","title":"Identificaci\u00f3n del Juego","text":"<p>Esta pagina detalla los m\u00e9todos de hashing para cada consola soportada en RA:</p>"},{"location":"Game-Identification-es/#nes","title":"NES","text":"<p>Si el ROM empieza con <code>NES\\1a</code>($4E $45 $53 $1A), los primeros 16 bytes son ignorados y lo que queda del archivo es linkeado/hashed. Si el ROM no empieza con <code>NES\\1a</code> ($4E $45 $53 $1A), el archivo entero es linkeado/hashed.</p>"},{"location":"Game-Identification-es/#famicom-disk-system","title":"Famicom Disk System","text":"<p>El archivo entero es linkeado/hashed.</p> <p>NOTA: Como salvar muta la data de los discos, copias locales de las im\u00e1genes cargadas son necesarias para asegurarte que los hashes no cambien entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#snes","title":"SNES","text":"<p>Si el tama\u00f1o del archivo es de 512 bytes mas que un multiplo de 8K, los primeros 512 bytes son ignorados y lo que queda del archivos es linkeado/hashed. Si el tama\u00f1o del archivo no es de 512 bytes mas que un multiplo de 8K, el archivo entero es linkeado/hashed.</p>"},{"location":"Game-Identification-es/#n64","title":"N64","text":"<p>El archivo entero es es agregado al hash. </p> <p>Esto talvez pueda resultar en tres diferentes hashes para cada juego. La extensi\u00f3n z64 es big endian (ABCD). La extensi\u00f3n n64 es little endian (DCBA). Y la extensi\u00f3n v64 es middle endian (BADC).</p>"},{"location":"Game-Identification-es/#gb","title":"GB","text":"<p>El archivo entero es agregado al hash.</p> <p>NOTA: Parece que RAVBA hace 0-pad la informaci\u00f3n si el tama\u00f1o especifico del ROM (address $148) es mas grande que el archivo. Aun tengo que encontrar un caso donde esto ocurra.</p>"},{"location":"Game-Identification-es/#gbc","title":"GBC","text":"<p>El archivo entero es agregado al hash.</p> <p>NOTA: Parece que RAVBA hace 0-pad la informaci\u00f3n si el tama\u00f1o especifico del ROM (address $148) es mas grande que el archivo. Aun tengo que encontrar un caso donde esto ocurra.</p>"},{"location":"Game-Identification-es/#gba","title":"GBA","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#virtualboy","title":"VirtualBoy","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#master-system","title":"Master System","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#megadrive-genesis","title":"MegaDrive (Genesis)","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#sega-32x","title":"Sega 32X","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#sega-cd","title":"Sega CD","text":"<p>Cosas que hacer: Se necesita investigar esto mas a fondo. Este sistema es incluso soportado?</p> <p>Un buffer de 1KB es agregado al hash. Lo primeros 512 bytes del buffer estan en los primeros 512 bytes del track 0. No estoy seguro de lo que se encuentra en los segundos 512 bytes.</p>"},{"location":"Game-Identification-es/#gamegear","title":"GameGear","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-2600","title":"Atari 2600","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-7800","title":"Atari 7800","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#atari-lynx","title":"Atari Lynx","text":"<p>Si el ROM empieza con <code>LYNX\\0</code>, los primeros 64 bytes son ignorados y el contenido restante del archivo es agregado al hash. Si el ROM no empieza con <code>LYNX\\0</code>, el archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#colecovision","title":"ColecoVision","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#neogeo-pocket","title":"NeoGeo Pocket","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#pcengine-turbografx16","title":"PCEngine (TurboGrafx16)","text":"<p>El archivo entero es agregado al hash.</p>"},{"location":"Game-Identification-es/#pcengine-cd","title":"PCEngine CD","text":"<p>Tareas que hacer: No estoy completamente seguro de ocmo trabaja este. RAPCE linkea/hashes la \"Placa Madre del ROM principal\", pero no puedo lograr que funcione. RALibRetro parece que no linkea nada, y no hay ningun codigo especial en  RetroArch, as\u00ed que por lo que parece esta linkeando/hashing el archivo entero, pero cual archivo pero cual archivo? El zup es un bin/cue con m\u00faltiples archivos.</p>"},{"location":"Game-Identification-es/#fba-arcade","title":"FBA (Arcade)","text":"<p>El string del nombre del archivo sin la extensi\u00f3n es linkeado/hashed (xxx.zip). Detecta min\u00fasculas y may\u00fasculas.</p>"},{"location":"Game-Identification-es/#pc-8001-pc-8801","title":"PC-8001 / PC-8801","text":"<p>Im\u00e1genes de cintas y discos cargadas en el drive 1 (program disk data) son completamente linkeadas/hashed.</p> <p>NOTA: Como salvar y otras manipulaciones pueden mutar la informaci\u00f3n del disco, copias locales del disco son requeridas para asegurar que los hashes no han cambiado entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#apple-ii","title":"Apple II","text":"<p>Im\u00e1genes de Disco (las dos, disquete y disco duro) cargadas en el drive 1 son completamente linkeadas/hashed.</p> <p>NOTA: Como salvar y otras manipulaciones pueden mutar la informaci\u00f3n del disco, copias locales del disco son requeridas para asegurar que los hashes no han cambiado entre cesiones de juego.</p>"},{"location":"Game-Identification-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-20 10:49] eldexterr:</code> Created Game Identification es (markdown)</li> </ul>"},{"location":"Game-Identification/","title":"Game Identification","text":"<p>This page details the hashing method used for each supported system.</p>"},{"location":"Game-Identification/#the-3do-company","title":"The 3DO Company","text":"<ul> <li>3DO Interactive Multiplayer uses a custom hash.<ul> <li>The volume header (first 132 bytes of sector 0) and the contents of the LaunchMe file are hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#amstrad","title":"Amstrad","text":"<ul> <li>Amstrad CPC uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#apple","title":"Apple","text":"<ul> <li>Apple II uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#arcade","title":"Arcade","text":"<ul> <li>Arcade uses a custom hash.<ul> <li>The filename string without the extension (<code>path/galaga.zip</code> -&gt; <code>galaga</code>) is hashed. It is case-sensitive.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#arduboy-inc","title":"Arduboy Inc.","text":"<ul> <li>Arduboy uses a custom hash.<ul> <li>Arudboy .hex files contain ASCII text. We normalize to Unix line endings, then perform a full file hash.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#atari","title":"Atari","text":"<ul> <li>Atari 2600 uses the MD5 checksum.</li> </ul> <ul> <li>Atari 7800 uses the MD5 checksum unless the ROM has a header.<ul> <li>If the ROM starts with <code>\\1ATARI7800</code>, the first 128 bytes are ignored and the remaining file contents are hashed. If the ROM does not start with <code>\\1ATARI7800</code>, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Atari Jaguar uses the MD5 checksum.</li> </ul> <ul> <li>Atari Jaguar CD uses a custom hash.<ul> <li>A header block is located within the first sector of the disc. This block indicates the location and size of the boot code, which is loaded and hashed.</li> <li>If the resulting hash is <code>254487b59ab21bc005338e85cbf9fd2f</code>, it's a common bootloader for homebrew games and the actual game code is located in track 2. If a separate header block containing a new location and size is found in track 2, then that data is loaded and hashed.</li> </ul> </li> </ul> <ul> <li>Atari Lynx uses the MD5 checksum unless the ROM has a header.<ul> <li>If the ROM starts with <code>LYNX\\0</code>, the first 64 bytes are ignored and the remaining file contents are hashed. If the ROM does not start with <code>LYNX\\0</code>, the entire file is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#bandai","title":"Bandai","text":"<ul> <li>WonderSwan uses the MD5 checksum.</li> </ul> <ul> <li>WonderSwan Color uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#coleco","title":"Coleco","text":"<ul> <li>ColecoVision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#fairchild","title":"Fairchild","text":"<ul> <li>Channel F uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#gce","title":"GCE","text":"<ul> <li>Vectrex uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#magnavox","title":"Magnavox","text":"<ul> <li>Odyssey2 uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#mattell","title":"Mattell","text":"<ul> <li>Intellivision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#microsoft","title":"Microsoft","text":"<ul> <li>MSX / MSX2 uses the MD5 checksums of each disk.<ul> <li>As saving mutates disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions. We do not believe this is working, but have yet to find a game where saving to disk actually works.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#nec","title":"NEC","text":"<ul> <li>PC-8001/PC-8801 uses the MD5 checksums of each disk.<ul> <li>As saving and other manipulations can mutate disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul> <ul> <li>PC Engine / TurboGrafx 16 / SuperGrafx use the MD5 checksum unless the ROM has a header.<ul> <li>If the size of the file is 512 bytes more than a multiple of 128KB, the first 512 bytes are ignored and the remaining file contents are hashed. If the size of the file is not 512 bytes more than a multiple of 128KB, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>PC Engine CD / TurboGrafx-CD - uses a custom hash. The boot code and disc title are hashed as follows:<ul> <li>Read 128 bytes from sector 1 of the data track (PCE predates ISO-9660, so there's no file system to read).</li> <li>If <code>\"PC Engine CD-ROM SYSTEM\"</code> does not exist at 32 bytes into the data, discard as invalid.</li> <li>Copy the last 22 bytes of the data into a buffer. This is the disc title, and usually identifies the game.</li> <li>The first three bytes of the data are a little-endian sector index for the boot code.</li> <li>The fourth byte is the number of sectors that the boot code occupies.</li> <li>The boot code is appended to the buffer (N sectors, starting at sector X)</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PC-FX uses a custom hash. The boot code and disc title are hashed as follows:<ul> <li>Read 32 bytes from sector 0 of the data track (PC-FX predates ISO-9660, so there's no file system to read).</li> <li>If <code>\"PC-FX:Hu_CD-ROM\"</code> was not read, discard as invalid.</li> <li>Read 128 bytes from sector 1 of the data track into a buffer. This is the volume header and includes the disc title.</li> <li>The 32-bit value at 32-bytes into the buffer is the first sector of the boot code.</li> <li>The 32-bit value at 36-bytes into the buffer is the number of sectors that the boot code occupies.</li> <li>The boot code is appended to the buffer (N sectors, starting at sector X)</li> <li>The buffer is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#nintendo","title":"Nintendo","text":"<ul> <li>Famicom Disk System uses the MD5 checksum unless the file has a header.<ul> <li>If the ROM starts with <code>FDS\\1a</code>, the first 16 bytes are ignored and the remaining file contents are hashed. </li> <li>If the ROM does not start with <code>FDS\\1a</code>, the entire file is hashed. </li> <li>As saving mutates disk data, local copies of loaded images are required to ensure that their hashes do not change across sessions.</li> </ul> </li> </ul> <ul> <li>Game Boy uses the MD5 checksum.</li> </ul> <ul> <li>Game Boy Advance uses the MD5 checksum.</li> </ul> <ul> <li>Game Boy Color uses the MD5 checksum.</li> </ul> <ul> <li>GameCube uses a custom hash. Initially loaded program code is hashed as follows:<ul> <li>The Apploader is loaded and added to a buffer.</li> <li>Each DOL segment (code and data) referenced in the Apploader is loaded and added to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Nintendo 64 uses the MD5 checksum for Big Endian (<code>.z64</code>) ROMs.<ul> <li>ByteSwapped (<code>.v64</code>) and Little Endian (<code>.n64</code>) use the MD5 checksum for its Big Endian counterpart.</li> </ul> </li> </ul> <ul> <li>Nintendo DS uses a custom hash.<ul> <li>A NDS ROM has a 0x160 byte header. In this header are pointers to icon/title information and to the boot code for both processors. The hash method combines the header, the two pieces of boot code, and the icon/title information and hashes the result.</li> <li>The icon/title information is 0xA00 bytes starting at the address stored in the header at $68</li> <li>The arm9 code address is stored at $20 in the header, and the size is stored at $2C in the header</li> <li>The arm7 code address is stored at $30 in the header, and the size is stored at $3C in the header</li> </ul> </li> </ul> <ul> <li>Nintendo Entertainment System / Famicom uses a custom hash.<ul> <li>If the ROM starts with <code>NES\\1a</code>, the first 16 bytes are ignored and the remaining file contents are hashed.</li> <li>If the ROM does not start with <code>NES\\1a</code>, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Pokemon Mini uses the MD5 checksum.</li> </ul> <ul> <li>Super Nintendo Entertainment System / Super Famicom / Satellaview / Sufami Turbo use the MD5 unless the ROM has a header.<ul> <li>If the size of the file is 512 bytes more than a multiple of 8KB, the first 512 bytes are ignored and the remaining file contents are hashed. </li> <li>If the size of the file is not 512 bytes more than a multiple of 8KB, the entire file is hashed.</li> </ul> </li> </ul> <ul> <li>Virtual Boy uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#snk","title":"SNK","text":"<ul> <li>Neo Geo CD uses a custom hash. Initially loaded program code is hashed as follows:<ul> <li>The <code>IPL.TXT</code> file is loaded and parsed.</li> <li>Each line of the file is data to load. PRG files are executable code. Each PRG file is loaded and added to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Neo Geo Pocket uses the MD5 checksum.</li> </ul> <ul> <li>Neo Geo Pocket Color uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#sega","title":"Sega","text":"<ul> <li>32X uses the MD5 checksum.</li> </ul> <ul> <li>Dreamcast uses a custom hash. The disc metadata and primary executable are hashed as follows:<ul> <li>The first 512 bytes of sector 0 are appended to the buffer. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGA SEGAKATANA \"</code>. If not, discard as invalid.</li> <li>The contents of the primary executable (as identified by the volume header) are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>Game Gear uses the MD5 checksum.</li> </ul> <ul> <li>Master System uses the MD5 checksum.</li> </ul> <ul> <li>Mega Drive / Genesis uses the MD5 checksum.</li> </ul> <ul> <li>SG-1000 uses the MD5 checksum.</li> </ul> <ul> <li>Saturn uses a custom hash.<ul> <li>The first 512 bytes of track 0 are hashed. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGADISCSYSTEM  \"</code> for Sega CD or <code>\"SEGA SEGASATURN \"</code> for Sega Saturn. If not, discard as invalid.</li> <li>Immediately following those 512 bytes are an arbitrary amount of code that validates the region and loads the primary executable. Without processing the code, we cannot determine what additional file(s) to hash, so this was determined to be sufficient as an alternative to hashing the entire CD.</li> </ul> </li> </ul> <ul> <li>Sega CD uses a custom hash.<ul> <li>The first 512 bytes of track 0 are hashed. This contains the volume header and ROM header. The first 16 bytes must be <code>\"SEGADISCSYSTEM  \"</code> for Sega CD or <code>\"SEGA SEGASATURN \"</code> for Sega Saturn. If not, discard as invalid.</li> <li>Immediately following those 512 bytes are an arbitrary amount of code that validates the region and loads the primary executable. Without processing the code, we cannot determine what additional file(s) to hash, so this was determined to be sufficient as an alternative to hashing the entire CD.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#sony","title":"Sony","text":"<ul> <li>PlayStation uses a custom hash. The primary executable and its name are hashed as follows:<ul> <li>The <code>SYSTEM.CNF</code> file is loaded and parsed. The primary executable is identified by the BOOT= line within.</li> <li>The primary executable name (and its path) are extracted from <code>SYSTEM.CNF</code> and written to a buffer.</li> <li>The contents of the primary executable are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PlayStation 2 uses a custom hash. The primary executable and its name are hashed as follows:<ul> <li>The <code>SYSTEM.CNF</code> file is loaded and parsed. The primary executable is identified by the BOOT2= line within.</li> <li>The primary executable name (and its path) are extracted from <code>SYSTEM.CNF</code> and written to a buffer.</li> <li>The contents of the primary executable are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul> <ul> <li>PlayStation Portable uses a custom hash. The disc metadata and primary executable are hashed as follows:<ul> <li>The contents of the <code>PSP_GAME\\PARAMS.SFO</code> file are written to a buffer. This contains the game attributes displayed in the menu, including the name and serial.</li> <li>The contents of the primary executable (<code>PSP_GAME\\SYSDIR\\EBOOT.BIN</code>) are appended to the buffer.</li> <li>The buffer is hashed.</li> </ul> </li> </ul>"},{"location":"Game-Identification/#wasm-4","title":"WASM-4","text":"<ul> <li>WASM-4 uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#watara","title":"Watara","text":"<ul> <li>Supervision uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#wellback","title":"Wellback","text":"<ul> <li>Mega Duck uses the MD5 checksum.</li> </ul>"},{"location":"Game-Identification/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-04 21:00] televandalist:</code> Changed to a new format</li> <li><code>[2023-06-03 02:03] televandalist:</code> Removed the \"Pending Explanation\" section since it only contained Wii, which is a ways away.</li> <li><code>[2023-05-25 11:16] Jamiras:</code> add hash algorithms for Arduboy, GameCube, Jaguar CD and Neo Geo CD</li> <li><code>[2023-04-11 03:01] televandalist:</code> Added Amstrad CPC, Arduboy, Atari Jaguar CD, Fairchild Channel F, Game Cube, Intellivision, Magnavox Odyssey 2, Mega Duck, Neo Geo CD, SG-1000, and Wii. Added \"Pending Explanation\" section. Made some naming corrections and some formatting tweaks.</li> <li><code>[2021-12-16 13:02] Jamiras:</code> add dreamcast</li> <li><code>[2021-10-10 11:20] Jamiras:</code> add psp</li> <li><code>[2021-04-30 13:05] Jamiras:</code> Updated Game Identification (markdown)</li> <li><code>[2020-12-25 00:07] televandalist:</code> Corrected PC Engine CD name and fixed a minor grammatical error. :bomber:</li> <li><code>[2020-06-13 17:45] Jamiras:</code> add PC-FX</li> <li><code>[2020-06-07 11:41] Jamiras:</code> update for new systems</li> </ul>"},{"location":"Game-Page-Improvement-ideas/","title":"Game Page Improvement ideas","text":""},{"location":"Game-Page-Improvement-ideas/#new-data-points-for-each-entry","title":"New data points for each entry","text":"<ol> <li>Provide to regular users (not only devs) access to the link to opened tickets for a game.</li> <li>Status of set <code>e.g. beta, work in progress, stable, unstable, incomplete</code></li> <li>Shows RA checksum, CRC32 and supported rom names</li> <li>[DONE] Set Developer(s)</li> <li>Publish/Revision Date</li> <li>Players numbers</li> <li>Clickable Genre tags. <code>e.g. Platformer, easy, difficult, long, rpg, jrpg, buggy, etc.</code></li> <li>Special? <code>e.g. awards won, game of the month/week, leaderboard of the month</code></li> </ol>"},{"location":"Game-Page-Improvement-ideas/#other-changes","title":"Other changes","text":"<ol> <li>Follow game button <code>receive updates on changes</code></li> <li>Mark as favorite <code>would show up on user page</code></li> <li>[DONE] Fix or prune \"sort by...\"</li> <li>High scores that are matching are either: <code>Randomized, grouped, King of the hill (Latest winner goes on top) or are sortable to show all of these.</code></li> <li>Gameplay video embed <code>Possibly allow this video to be turned off from game page.</code></li> <li>Average time to master/fastest master/your mastery? <code>: possibly could even log how much time you are in a game on hardcore/softcore, and pause when you go to the overlay or are developing.</code></li> <li>Recent players</li> <li>Allow widgets to be customized, show information more dynamically on page, be removed, moved.</li> </ol> <p>Strikethrough is for issues that are on RAweb</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/","title":"Primeros pasos como un Desarrollador de Logros","text":"<p>Bienvenido al mundo de Creacion de Logros!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#conceptos-basicos","title":"Conceptos Basicos","text":"<p>Tecnicamente un logro es un grupo de condiciones que tienen que ser cumplidas en un punto particular en un video juego.</p> <p>Cuando abres un juego en un emulador con las funciones de RetroAchievements, el emulador esta siempre checando si esas condiciones se cumplen en el punto exacto. Cuando todas las condiciones de un logro en particular son cumplidas, se dispara el logro y el emulador deja de checar las condiciones para ese logro.</p> <p>El proceso de creaci\u00f3n de un logro basicamente se divide en 3 pasos:</p> <ol> <li> <p>Encontar un lugar en la Memoria RAM del juego donde se almacene la informacion que buscas (ejemplos: nivel, barra de vida, tiempo, monedas, sacar un arma, obtener un item, etc.).</p> </li> <li> <p>Crear las condiciones que tienen que ser cumplidas para que se dispare el logro.</p> </li> <li> <p>Probar si tu logro funciona como es debido.</p> </li> </ol> <p>La mayoria de las veces vaz a tener que volver al punto 2 y 3 muchisimas veces para refinar la logica de tu logro.</p> <p>En este documento vamos a ver como lograr los pasos de arriba.</p> <p>Una vez que estes seguro que tu logro esta saltando con las condiciones que tu quieres, puedes subirlo al servidor. Vamos a ver mas sobre eso en un momento.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#primeros-pasos","title":"Primeros Pasos","text":"<p>Antes que nada necesitas estar seguro que tienes un emulador de RA de la pagina de descargas de RetroAchievements y tambien haberte creado una cuenta para poder iniciar seccion en el emulador.</p> <p>En esta guia vamos a utilizar RAGens como demostracion, y el juego Sonic the Hedgehog. Estamos utilizando RAGens pero lo mismo aplica para cualquier otro emulador.</p> <p>Para empezar abre el ejecutable de RAGens, e inicia seccion cuando salga la venta de inicio. Siguiente, ve a File -&gt; Open y selecciona el ROM del que quieres trabajar los logros.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#inspector-de-memoria","title":"Inspector de Memoria","text":"<p>Ahora deberias tener en tu ventana principal corriendo Sonic. Hay otras 3 ventanas que vamos a estar utilizando, que se pueden encontrar sobre la pesta\u00f1a de RetroAchievements en el menu. Vamos a trabajar con el Inspector de Memoria primero:</p> <p></p> <p>El inspector de memoria se puede utilizar para encontrar variables en la RAM que podamos utilizar. Esencialmente estas en una caseria de tesoros por encontrar los lugares en memoria - esta ventana te ayudara a examinar y filtrar la RAM del juego que se encuentra corriendo.</p> <p>NOTA: Si deseas un video paso por paso explicando como encontra valores en la memoria, este viejo video puede llegar a ser util.</p> <p>Tambien mira: Un vistaso al Inspector de Memoria y Tips en la busqueda de Memoria.</p> <p>Para empezar o reiniciar una prueba, haz click en New 8-bit Test en la parte casi superior del medio.</p> <p>Para manter las cosas simple, vamos a empezar a buscar el valor en memoria que guarda el numero de anillos que hemos recolectado. Nuestros pasos son los siguientes:</p> <ol> <li> <p>Carga el ROM y empieza una nueva partida.</p> </li> <li> <p>Resetea la ventana de memoria: Haz click en New 8-bit Test.</p> </li> <li> <p>Regresa al juego y cambia el numero de anillos en la memoria. Por ejemplo, colecciona un anillo</p> </li> <li> <p>En la ventana de memoria, ahora vamos a filtrar los valores que son 'mas grandes que los antiguos valores' (simbolo <code>&gt;</code>). Seleccionamos esto y, entonces hacemos click en Filter.</p> </li> </ol> <p>Cuando ya estes haciendo esto por una 3ra y 4ta vez, el numero de posibilidades o 'candidatos' va a ir disminuyendo. Vamos a seguir haciendo esto asta que lleguemos a un numero muy peque\u00f1o (el mas peque\u00f1o que sea posible), puede llegar a tomar entre 4-5 intentos. Ahora podemos hacer click en la ventana de resultados, y monitoriar los valores en memoria, hasta abajo en el visor de memoria. Continua en el juego y deberias de ver como los valores en la memoria cambian cada vez que coleccionas anillos. Si no es asi, o si algo no se ve bien, intenta otro valor. Con el primer Sonic the Hedgehog, el valor en memoria para el numero de anillos deberia de ser <code>0xfe20</code>.</p> <ul> <li>Nota 1: Utilizando estados de guardados (save states)(F5 para salvar un estado, F8 para cargar un estado, F6-F7 para cambiar que estados utilizar), puedes brincar entre estados de guardado permitiendo esto alterar la RAM, y utilizarlo para filtrar malos candidatos. Puedes buscar resultados que permanescan iguales (Es decir si es que sabes que un valor no tuvo que haber cambiado, utiliza <code>=</code>), o para valores que son diferentes (utiliza 'no igual', simbolo <code>!=</code>).</li> </ul> <ul> <li>Nota 2: Afortunadamente no hay una garantia de un juego a otro para saber como los desarrolladores almacenaban la informacion (4-bit, 8-bit, 16-bit, decimales con codigo binario, negativo/invertido. Por ejemplo utilizando 0xff/0xffff para representar 'fijo', o algo completamente aleatorio), pero eventualmente deberias de encontrarte con varios buenos valores. Nota si estas batallando en encontrar buenos valores, postea en el Foro de Ayuda de RetroAchievements.org, o en el Servidor de Discord de RetroAchievements. Hay bastante gente que estaria dispuesta en ayudarte con mucho gusto!!</li> </ul> <ul> <li>Tip: Si te gusta experimentar con la memoria, intenta ingresar valores directamente en el visor de la RAM. Esto puede causar efectos devastadores en un juego, o podria hacer exactamente lo que deseas que pase, (o inclusive nada!) De todos modos podria ser util, ver si ingresas un valor y paso el resultado que esperas. Utilizalo con cuidado!</li> </ul> <p>Cuando encuentres un valor del que te sientes feliz con el, puedes escriber una peque\u00f1a nota de lo que es haciendo click en Save Note, esto lo va a guardar en la base de datos, y va a ser automaticamente cargado la siguiente vez que cargues el visor de memoria para ese juego, donde sea que te encuentres! Nota despues que haces click en 'Save Note', la nota va a ser automaticamente guardada en la base de datos y compartida, la cual todos los desarrolladores tendran acceso a ella. Todos van a descargar esa nota cuando carguen su ROM. Si intentas sobre-escribir una nota, te va a salir una ventana de confirmacion antes de guardarla.</p> <p>Puedes encontrar mas utiles Tips en Busqueda de Memoria aqui.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#sets-de-logros","title":"Sets de Logros","text":"<p>Ok asi que el valor en memoria para el numero de anillos se encuentra almacenado en <code>0xfe20</code> - nota para un no-programador, estamos manejando numeros en el sistema numerico Hexadecimal que puede llegar a ser desalentador, pero no te preocupes, esencialmente simplemente son numeros y letras en vez de solo numeros, y no olvides <code>0x</code> al principio para mostrar que es un valor en memoria en hexadecimal. Hemos encontrado un valor en el que estamos interesado y lo hemos guardado con Save Note. Ahora queremos crear un nuevo logro.</p> <p>Ve a la pesta\u00f1a de RetroAchievements en el menu de tu emulador, escoje Achievement Sets y vas a ver esta ventana:</p> <p></p> <p>Aqui agrupamos todos los logros disponibles en tres sets:</p> <ol> <li> <p>Logros Core (los principales, set publico de logros),</p> </li> <li> <p>Unofficial/User Achievements (publicos, pero no otorgan puntos: para revision),</p> </li> <li> <p>Local Achievements (personales, en tu PC).</p> </li> </ol> <p>En la venta de Logros, haz click en Local Achievements (superior izquierda), luego en Add New Achievement (superior derecha). Esto va a\u00f1adir una entrada vacia en la lista del centro. Haz doble click en ella: si aun no esta abierta, esto deberia de abrir la ventana del Achievement Editor (editor de logros).</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#editor-de-logros","title":"Editor de Logros","text":"<p>A si es como se ve:</p> <p></p> <p>Esta es la ventana final en la que vamos a poner toda la informacion junta. La mayoria de los campos de arriba se explican solos, ejemplo: Titulo, Descripcion, Puntos. La principal seria la parte de 'Requisitos'</p> <p>Vamos a decir que queremos agregar un logro por coleccionar cierto numero de anillos. Vamos a decir 15 por simplicidad. Despues de llenar los campos de arriba y a ver seleccionado un icono apropiado (en este ejemplo estamos utilizando la medalla del trofeo dorado (00136), pero tu puedes subir una nueva), ocupamos llenar los requisitos. Tenemos un requisito, ese numero de anillos tiene que ser minimo 15. El siguiente click seria en Add New Requirement.</p> <p>Clickear este boton va a agregar algunos valores por default a la lista de requisitos. Los valores por defaults simplemente se percatan que algo relativamente sensible se agrego a la lista. Por ahora, ignorando el campo 'Special?'. Cuando clickeamos en crear, el valor default en memoria va a ser el ultimo valor que dejaste en la ventana de memoria.</p> <p>Lo siguiente seria cambiar estos valores a los siguientes:</p> <ul> <li>Size: <code>16-bit</code></li> <li>Memory: <code>0xfe20</code></li> <li>Cmp: <code>&gt;=</code> - esta es la comparacion que vamos a hacer. Podemos tener cualquier comparacion aqui, pero es sencible que tengas un \"mayor que e igual a\". Esto es importante porque si tenemos 10 anillos y despues obtenemos 10 anillos de una caja de 10 anillos vamos a tener 20, y vamos a perder el logro ya que tendriamos que tener exactamente 15 anillos.</li> <li>Type: <code>Value</code> - estamos comparando este valor en memoria con un valor fijo: 15</li> <li>Size: <code>Empty</code> - Esto es solamente relevante cuando estemos comparando valor en memoria con otro valor en memoria</li> <li>Mem/Val: <code>15</code> - el numero de anillos requirido: el valor del que estamos comparando la memoria</li> <li>Hit Count: <code>0</code> - ignora esto por ahora, es util cuando necesitas que algo paso un cierto numero de veces</li> </ul> <p>Con esto establecido, no necesitamos ninguna otra condicion que agregar, asi que podemos regresar a Achievements Dialog (Ventana de Logros). Para estar seguros, tenemos que guardar nuestro progreso presionando Save Local! Esto guarda todo localmente para asegurar que no perdamos ningun progreso.</p> <ul> <li>Nota: usualmente un logro tiene mas de un requisito para evadir que salte en un momento equivocado (por ejemplo: jugando en modo demo). En este ejemplo estamos utilizando solamente un requisito para simplificar la explicacion. Mira mas Tips en la Creacion de Logros aqui.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#probando-el-logro","title":"Probando el logro","text":"<p>Ahora podemos 'activar' este logro localmente presionando en Activate a mano derecha de la ventana. Esto va a empezar a monitoriar estos valores en memoria y va a entregar el logro una vez que todas las condiciones se hubieran cumplido de manera verdadera. Ahora podemos avanzar y probar si este logro sirve!</p> <p></p> <p>Si presionamos <code>Esc</code> mientras jugamos, vas a ver como se miraria el logro desde la interfaz de RetroAchievements!</p> <p></p> <p>A pesar de que el logro funciono bien en nuestras pruebas, un logro con una logica como esa no esta listo para ser oficialmente lanzado. Primero que nada: tiene una sola condicion: \"anillos coleccionados &gt;= 15\". El problema es que ese mismo valor es el mismo que se utiliza para almacenar el numero de anillos cuando el juego corre en \"modo demo\" (Cuando la computadora juega el juego automaticamente cuando duras mucho tiempo en la pantalla de titulo). A si que, si Sonic colecciona 15 anillos en modo demo el logro tambien saldria, que es algo que no queremos.</p> <p>Checa los tips en la siguiente seccion de abajo para conocer como mejorar la logica de tu logro y hacerlo aceptable para que sea oficialmente lanzado.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#tips-importantes","title":"Tips Importantes","text":"<p>Aqui estan algunos tips que tienes que tener en mente cuando te encuentres creando logros:</p> <ul> <li>Nunca Evade hacer logros con una sola condicion lo mas que puedas. De otra manera es muy probable que el logro se dispare en una parte no deseada. Este es el error mas comun por un desarrollador</li> </ul> <ul> <li>Si el juego tiene un modo demo (El CPU juega despues que esperas un tiempo en la pantalla de titulo), percatate de encontrar el valor para eso y agrega una condicion para que tus logros no se disparen en modo demo. Tambien necesitas saber como utilizar PauseIf y ResetIf.</li> </ul> <ul> <li>PauseIf cheat codes: Si el juego tiene un cheat para aumentar vidas, seleccionar niveles, etc. Percatate de encontrar el valor para eso y agregar algo de proteccion en tus logros. OK, talvez no es un tema muy sencillo, pero es algo que tienes que tener en cuenta cuando estes creando un set oficial de logros.</li> </ul> <ul> <li>Evita crear logros de simplemente llegar a un nivel. Esto puede ser conseguido por medio de un password o un cheat. Mejor haz logros por terminar un nivel, como en la plantilla de aqui. Tambie, no hagas logros por simplemente empezar un juego o \"empieza el juego con X personaje\".</li> </ul> <ul> <li>Si quieres crear un logro por conseguir un item especifico y unico, agrega algunas condiciones para estar seguro que el jugador obtuvo el item donde se suponia que se tenga que obtener, como en esta plantilla de aqui. De otra manera el logro podra ser conseguible utilizando un codigo o cargando una partida de cargado.</li> </ul> <ul> <li>Evita hacer muchos logros sobre simples cosas que necesitan casi cero esfuerzo. Ejemplos de que NO tienes que hacer: obten una moneda o un hongo en Super Mario Bros.</li> </ul> <ul> <li>Ten encuenta los conceptos no-bienvenidos en el dise\u00f1o de logros.</li> </ul> <ul> <li>Se creativo con tus logros. Esos que abarcan caracteristicas y detalles unicos son los mas bienvenidos. Los jugadores aman cuando un peque\u00f1o detalle de un juego que aman es apoyado por un logro. Leer un Walkthrough en GameFAQs te puede dar un poco de inspiracion tambien.</li> </ul> <ul> <li>Intentar pasar la mayor cantidad de tiempo posible con el juego, especialmente si es la primera vez que desarrollas logros. Toma mas tiempo conocer el juego por dentro, trabajar con la memoria funciona ya que es la mejor fuente de ideas para logros unicos.</li> </ul> <p>Puedes encontrar mas en la pagina de Tips y Trucos.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#siguientes-pasos","title":"Siguientes pasos","text":"<p>Ahora que ya sabes como utilizar el Inspector de Memoria, y el Editor de Logros. Llego la hora de que aprendas nuevas tecnicas y practiques:</p> <ul> <li>En orden que refines la logica de tus logros, puedes ver con que funciones cuentas en la pagina de Funciones en la Logica de los Logros.</li> </ul> <ul> <li>Puedes aprender viendo logros existentes que otros desarrolladores han hecho con una explicacion extra en la pagina de Ejemplos Reales.</li> </ul> <ul> <li>Tambien puedes ver algunos ejemplos genericos en la pagina de Plantillas para Logros.</li> </ul> <ul> <li>Una vez que hubieras aprendido todas las tecnicas basicas, si quieres obtener el estatus de Desarrollador tienes que seguir los pasos explicados aqui: Como convertirme en un desarrollador de logros.</li> </ul> <p>Que te diviertas!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:36] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:58] meleu:</code> Updated Getting Started as an Achievement Developer ES (markdown)</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/","title":"Primeiros Passos como um Desenvolvedor de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Getting Started as an Achievement Developer</p> <p>Bem-vindo ao mundo do desenvolvimento de conquisttas!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#conceitos-basicos","title":"Conceitos b\u00e1sicos","text":"<p>Tecnicamente, uma conquista (no contexto de RetroAchievements) \u00e9 um grupo de condi\u00e7\u00f5es que devem ser cumpridas em um determinado frame do jogo.</p> <p>Quando voc\u00ea inicia um jogo em um emulador com o recurso RetroAchievements, o emulador sempre verifica se essas condi\u00e7\u00f5es s\u00e3o atendidas no frame atual. Quando todas as condi\u00e7\u00f5es para uma conquista particular s\u00e3o atendidas, esta conquista \u00e9 ativada e o emulador deixa de verificar as condi\u00e7\u00f5es para essa conquista.</p> <p>O processo de cria\u00e7\u00e3o de uma conquista envolve basicamente 3 etapas:</p> <ol> <li> <p>Encontrar um lugar na RAM do jogo onde a informa\u00e7\u00e3o que voc\u00ea deseja \u00e9 armazenada (exemplos: n\u00edvel, barra de vida, tempo, moedas, segurando uma arma, obter um item, etc.).</p> </li> <li> <p>Criar condi\u00e7\u00f5es que devem ser cumpridas para ativar uma conquista.</p> </li> <li> <p>Testar se a sua conquista est\u00e1 funcionando como esperado.</p> </li> </ol> <p>Provavelmente voc\u00ea voltar\u00e1 para os passos 2 e 3 muitas vezes para refinar a l\u00f3gica de sua conquista.</p> <p>Neste documento, veremos como realizar as etapas acima.</p> <p>Depois de ter certeza de que sua conquista est\u00e1 funcionando nas condi\u00e7\u00f5es desejadas, voc\u00ea pode envi\u00e1-la para o servidor. Veremos mais sobre isso adiante.</p> <p>Tutoriais em V\u00eddeo: o usu\u00e1rio Thoreau \u00e9 um criador de conquistas experiente e criou uma s\u00e9rie de v\u00eddeos mostrando todo o processo de cria\u00e7\u00e3o de conquistas em portugu\u00eas. Confira os v\u00eddeos no youtube.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#primeiros-passos","title":"Primeiros passos","text":"<p>Antes de come\u00e7ar, certifique-se de ter um emulador RA da p\u00e1gina do RetroAchievements Download Page primeiro e crie uma conta para que voc\u00ea possa fazer login usando o emulador.</p> <p>Neste guia, estaremos usando RAGens para demonstrar, e o jogo  Sonic the Hedgehog. Estamos usando RAGens, mas o mesmo se aplica aos outros emuladores.</p> <p>Para come\u00e7ar, execute o RAGens e fa\u00e7a o login quando solicitado. Em seguida, use File -&gt; Open e selecione qualquer ROM que voc\u00ea deseja encontrar conquistas.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#memory-inspector","title":"Memory Inspector","text":"<p>Agora voc\u00ea deve ter sua janela principal executando o Sonic. Existem 3 outros di\u00e1logos que usaremos, que podem ser encontrados em RetroAchievements no menu. Em primeiro lugar, tratamos primeiro o Memory Inspector:</p> <p></p> <p>O Memory Inspector pode ser usado para encontrar endere\u00e7os na RAM para que possamos usar. Essencialmente, voc\u00ea est\u00e1 em uma ca\u00e7ada ao tesouro para locais de mem\u00f3ria - este di\u00e1logo ir\u00e1 ajud\u00e1-lo a examinar e filtrar a RAM do jogo enquanto o jogo est\u00e1 sendo executado.</p> <p>NOTA: Se voc\u00ea quer uma explica\u00e7\u00e3o passo a passo de v\u00eddeo para encontrar endere\u00e7os de mem\u00f3ria, este video esse v\u00eddeo pode ser muito \u00fatil. <code>V\u00eddeo em ingl\u00eas</code></p> <p>Para iniciar ou reiniciar um teste, clique em New 8-bit Test  perto do meio na parte superior.</p> <p>Para manter as coisas simples, come\u00e7aremos procurando pelo endere\u00e7o de mem\u00f3ria que contenha o n\u00famero de an\u00e9is que coletamos. Nossas etapas ser\u00e3o as seguintes:</p> <ol> <li> <p>Carregue a ROM e comece um novo jogo.</p> </li> <li> <p>Redefinir a caixa de di\u00e1logo de mem\u00f3ria: clique em New 8-bit Test.</p> </li> <li> <p>Retorne ao jogo e altere o n\u00famero de an\u00e9is na mem\u00f3ria. Por exemplo, colete um anel.</p> </li> </ol> <p>Na caixa de di\u00e1logo de mem\u00f3ria, agora queremos filtrar por valores que sejam \"maiores do que valores anteriores\" (s\u00edmbolo&gt;). Selecionamos isso, ent\u00e3o, clique em Filter.</p> <p>Cada vez que voc\u00ea executa 3 e 4, o n\u00famero de possibilidades ou 'candidatos' diminuir\u00e1. Continuaremos a faz\u00ea-lo at\u00e9 que o n\u00famero de candidatos alcance um n\u00famero muito pequeno (o menor poss\u00edvel), pode demorar 4-5 tentativas. Em seguida, podemos clicar na janela de resultados e monitorar o endere\u00e7o de mem\u00f3ria no visor de mem\u00f3ria na parte inferior. Continue usando o jogo e voc\u00ea deve ver os valores em mudan\u00e7a de mem\u00f3ria \u00e0 medida que voc\u00ea coleciona an\u00e9is. Se voc\u00ea n\u00e3o, ou se algo n\u00e3o parece direito, tente outro valor. Com o primeiro Sonic the Hedgehog, o endere\u00e7o da mem\u00f3ria para o n\u00famero de an\u00e9is deve ser 0xfe20.</p> <ul> <li>Nota: Usando estados de salvamento (F5 para salvar o estado, F8 para carregar o estado, F6-F7 para alternar o estado a ser usado), voc\u00ea pode alternar entre estados diferentes, permitindo alterar o que est\u00e1 na RAM e usar isso para filtrar fora candidatos ruins. Voc\u00ea pode procurar por valores que permanecem os mesmos (ou seja, se voc\u00ea sabe que o valor n\u00e3o mudou, use =) ou valores diferentes (use 'not equal', symbol! =).</li> </ul> <ul> <li>Nota: Infelizmente nenhuma garantia de jogo para jogo sobre como os desenvolvedores armazenaram seus dados (decimais de codigo bin\u00e1rio de 4 bits, 8 bits, 16 bits, negativos / invertidos, ou seja, usando 0xff / 0xffff para representar 'set' , ou simples, aleatoriamente), mas, eventualmente, voc\u00ea deve encontrar um bom endere\u00e7o. Observe se voc\u00ea est\u00e1 lutando para encontrar bons valores, postar o f\u00f3rum de Ajuda de desenvolvimento RetroAchievements.org Development Help forum ou o servidor  RetroAchievements Discord server. H\u00e1 muitas pessoas que ficar\u00e3o muito felizes em ajudar!</li> </ul> <ul> <li>Dica: se voc\u00ea quiser experimentar a mem\u00f3ria, tente inserir novos valores diretamente no visualizador de RAM. Isso pode ter efeitos devastadores no jogo, ou pode fazer exatamente o que voc\u00ea espera, (ou nada!) Pode ser \u00fatil, para ver se voc\u00ea pode inserir um valor e obter o resultado esperado. Use com cuidado!</li> </ul> <p>Quando voc\u00ea encontrou um endere\u00e7o com o qual voc\u00ea est\u00e1 feliz, voc\u00ea pode escrever uma nota curta para o que \u00e9 e clicar em Salvar nota, isso ir\u00e1 armazen\u00e1-lo no banco de dados e ser\u00e1 restaurado automaticamente na pr\u00f3xima vez que voc\u00ea carregar o visor de mem\u00f3ria para isso jogo onde quer que esteja! Note que depois de clicar em \"Salvar nota\", a nota ser\u00e1 armazenada automaticamente no banco de dados, e compartilhada para que todos os desenvolvedores compartilhem o acesso a essas notas de mem\u00f3ria. Todos ser\u00e3o baixados de novo quando voc\u00ea carregar uma ROM. Se voc\u00ea tentar substituir uma nota, verificar\u00e1 com voc\u00ea primeiro antes de enviar.</p> <p>Voc\u00ea pode encontrar Dicas de Escava\u00e7\u00e3o de Mem\u00f3ria aqui.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#achievement-sets","title":"Achievement Sets","text":"<p>OK para que a localiza\u00e7\u00e3o da mem\u00f3ria para o n\u00famero de an\u00e9is seja armazenada em <code>0xfe20</code> - nota para um n\u00e3o programador, estamos lidando com um sistema de numera\u00e7\u00e3o hexadecimal que pode ser assustador, mas n\u00e3o se preocupe, essencialmente s\u00e3o apenas n\u00fameros e letras em vez de apenas n\u00fameros, e n\u00e3o esquecendo <code>0x</code> no in\u00edcio para mostrar que \u00e9 uma localiza\u00e7\u00e3o de mem\u00f3ria em hexadecimal. Encontramos um endere\u00e7o em que nos interessamos e armazenamos usando Save Note. Agora queremos criar uma nova conquista.</p> <p>V\u00e1 para o RetroAchievements no menu, escolha Achievement Sets e voc\u00ea ver\u00e1 esta caixa de di\u00e1logo:</p> <p></p> <p>Aqui agrupamos todas as conquistas que conhecemos em tr\u00eas conjuntos:</p> <ol> <li> <p>Core Achievements (o principal, conjunto de conquistas p\u00fablico),</p> </li> <li> <p>Unofficial/User Achievements (p\u00fablico, mas n\u00e3o ir\u00e1 premiar pontos, \u00e9 apenas para outros desenvolvedores revisarem),</p> </li> <li> <p>Local Achievements (pessoais no seu PC).</p> </li> </ol> <p>Na caixa de di\u00e1logo Conquistas, clique em Local Achievements (canto superior esquerdo), depois em Add New Achievement (inferior esquerda). Isso ir\u00e1 adicionar uma entrada em branco \u00e0 lista no centro. Clique duas vezes nele: se ainda n\u00e3o est\u00e1 aberto, isso deve selecion\u00e1-lo e abrir a caixa de di\u00e1logo Editor de conquista (Achievement Editor).</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#achievement-editor","title":"Achievement Editor","text":"<p>O Achievement Editor se parece com isso:</p> <p></p> <p>Esta \u00e9 a \u00faltima caixa de di\u00e1logo onde reunimos todos os dados juntos. A maioria dos principais campos s\u00e3o auto-explicativos, ou seja, Title, Description, Points. A principal \u00e9 a parte de 'Requirements' (Requisitos).</p> <p>Digamos que queremos adicionar uma conquista para colecionar um certo n\u00famero de an\u00e9is. Digamos 15 an\u00e9is para simplificar. Depois de preencher os campos na parte superior e selecionar um \u00edcone adequado (neste exemplo, usamos o distintivo de trof\u00e9u de ouro (00136), mas voc\u00ea pode carregar um novo), precisamos preencher os Requisitos. Temos um requisito, que o n\u00famero de an\u00e9is \u00e9 pelo menos 15. O pr\u00f3ximo clique \u00e9 Add New Requirement.</p> <p>Ao clicar neste bot\u00e3o, ser\u00e3o adicionados v\u00e1rios valores padr\u00e3o \u00e0 lista Requisitos. Esses padr\u00f5es apenas garantem que algo relativamente sens\u00edvel seja adicionado \u00e0 lista. Por enquanto, ignorando o campo 'Special?'. Quando clicamos em criar, o valor de mem\u00f3ria padr\u00e3o ser\u00e1 o valor que voc\u00ea deixou pela \u00faltima vez na caixa de di\u00e1logo de mem\u00f3ria.</p> <p>Em seguida, alteraremos esses valores para o seguinte:</p> <ul> <li>Size: <code>16 bits</code>.</li> </ul> <ul> <li>Memory: <code>0xfe20</code>.</li> </ul> <ul> <li>Cmp: <code>&gt;=</code> - esta \u00e9 a compara\u00e7\u00e3o a fazer. Podemos ter alguma compara\u00e7\u00e3o aqui, mas \u00e9 sensato ter \"maior ou igual\". Isso \u00e9 importante porque, se conseguimos 10 an\u00e9is, ent\u00e3o uma caixa de super anel para ter 20, perder\u00edamos exatamente 15 an\u00e9is.</li> </ul> <ul> <li>Type: <code>Value</code> - estamos comparando esse valor de mem\u00f3ria com um valor fixo: 15.</li> </ul> <ul> <li>Size: <code>Empty</code> - isso s\u00f3 \u00e9 relevante ao comparar a mem\u00f3ria com a mem\u00f3ria.</li> </ul> <ul> <li>Mem/Val: <code>15</code> - o n\u00famero de an\u00e9is necess\u00e1rios: o valor com o qual estamos comparando a mem\u00f3ria</li> </ul> <ul> <li>Hit Count: <code>0</code> - ignore isso por enquanto, \u00e9 \u00fatil para quando algo precisa acontecer um certo n\u00famero de vezes.</li> </ul> <p>Com esse conjunto, n\u00e3o temos mais condi\u00e7\u00f5es para adicionar, ent\u00e3o retornamos \u00e0 caixa de di\u00e1logo Achievements. Para estar seguro, devemos salvar nosso progresso ao clicar em Save Local! Isso salva tudo para arquivar localmente para garantir que n\u00e3o perderemos nenhum progresso.</p> <ul> <li>Nota: geralmente as conquistas t\u00eam mais de um requisito para evitar que ele acione em um momento errado (ou seja, jogando o modo de demonstra\u00e7\u00e3o). Neste exemplo, estamos usando apenas um requisito apenas para simplificar a explica\u00e7\u00e3o. Veja mais dicas de cria\u00e7\u00e3o de conquistas aqui.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#testando-a-conquista","title":"Testando a conquista","text":"<p>Agora podemos \"ativar\" essa conquista localmente ao clicar Activate no lado direito. Isso come\u00e7ar\u00e1 a monitorar esses locais de mem\u00f3ria e atribuir\u00e1 a conquista uma vez que todas as condi\u00e7\u00f5es s\u00e3o verdadeiras. Agora, podemos prosseguir e testar para ver se essa conquista funciona!</p> <p></p> <p>Se pressionarmos no jogo Esc, voc\u00ea ver\u00e1 a conquista aparecer como uma demonstra\u00e7\u00e3o do que seria semelhante \u00e0 sobreposi\u00e7\u00e3o no jogo!</p> <p></p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#evitando-bugs","title":"Evitando bugs","text":"<p>O cheevo (achievement) que criamos neste tutorial \u00e9 muito simples, tem apenas uma condi\u00e7\u00e3o: \"an\u00e9is coletados\" &gt;= 15 \". Mas o endere\u00e7o para gravar o n\u00famero de an\u00e9is coletados tamb\u00e9m \u00e9 usado quando o jogo \u00e9 executado em \"modo de demonstra\u00e7\u00e3o\" (AI jogando o jogo depois de esperar um pouco na tela de t\u00edtulo). Ent\u00e3o, se Sonic coletar 15 an\u00e9is no modo de demonstra\u00e7\u00e3o, essa conquista ir\u00e1 desencadear, o que \u00e9 indesej\u00e1vel.</p> <p>Ent\u00e3o, aqui est\u00e3o algumas dicas que voc\u00ea sempre deve ter em mente ao criar suas conquistas:</p> <ul> <li>Nunca use/Evite ao m\u00e1ximo usar apenas uma condi\u00e7\u00e3o. Caso contr\u00e1rio, a conquista provavelmente ir\u00e1 aparecer na hora errada. Este \u00e9 o erro mais comum cometido por um desenvolvedor.</li> </ul> <ul> <li>Use <code>PauseIf</code> demo mode (modo demonstra\u00e7\u00e3o): Se o jogo tiver um modo de demonstra\u00e7\u00e3o, certifique-se de encontrar o endere\u00e7o para ele e adicionar o modo! = Demo ou algo semelhante em suas conquistas. Mais informa\u00e7\u00f5es sobre PauseIf na p\u00e1gina Caracter\u00edsticas da l\u00f3gica de conquista.</li> </ul> <ul> <li>Use <code>PauseIf</code> usando macetes (cheat codes): se o jogo tiver um c\u00f3digo secreto de macete para aumentar vidas, selecionar fases, etc. Certifique-se de encontrar os endere\u00e7os para isso e adicionar algum tipo de prote\u00e7\u00e3o em suas conquistas. OK, talvez n\u00e3o seja um t\u00f3pico muito b\u00e1sico, mas voc\u00ea deve ter em mente ao criar um conjunto de conquistas real.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#ok-o-achievement-funciona-e-agora","title":"OK, o achievement funciona. E agora?","text":"<p>Depois de testarmos que a conquista funciona localmente, h\u00e1 um processo de confirma\u00e7\u00e3o em duas etapas:</p> <ol> <li> <p>Primeiro, na caixa de di\u00e1logo Conquistas, selecionamos nossa conquista e pressione Commit Selected e concordamos com a caixa de di\u00e1logo. Isso ir\u00e1 empurrar nossa conquista para o servidor e armazen\u00e1-lo em Unofficial User-submitted Achievements</p> </li> <li> <p>Para que a conquista seja apreciada por muitos, ela deve ser empurrada para o conjunto Core Achievement (Core Achievement set). Para as suas poucas primeiras conquistas, ele deve ser revisado por um membro da equipe antes que possa ser empurrado para o Core. Depois de ter carregado um conjunto de conquistas para o Unofficial, voc\u00ea precisa entrar em contato com um administrador que, usando seu julgamento e padr\u00f5es pessoais de qualidade, aprovar\u00e1 o conjunto e lhe dar\u00e1 um status de desenvolvedor no site (Developer status). Nesse caso, voc\u00ea pode empurrar qualquer conquista para o Core voc\u00ea mesmo.</p> </li> </ol> <p>Naturalmente, \u00e9 melhor enviar apenas conquistas \u00fanicas e interessantes no grupo de conquistas principais. Se houver duplicatas no grupo Core, as duplicatas adicionadas mais recentemente ser\u00e3o manualmente moderadas e exclu\u00eddas. Se voc\u00ea n\u00e3o quer sua conquista no grupo Core, ou voc\u00ea acha que pode n\u00e3o ser apropriado para o grupo Core (ou seja, se est\u00e1 incompleto, ou se \u00e0s vezes ele parece se desencadear quando n\u00e3o \u00e9 suposto, como quando o jogo est\u00e1 mostrando um demo), deixe-o na se\u00e7\u00e3o N\u00e3o oficial / Se\u00e7\u00e3o submetida pelo usu\u00e1rio.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#proximos-passos","title":"Pr\u00f3ximos passos","text":"<p>Agora que voc\u00ea sabe como usar o Memory Inspector e o Editor de Conquistas. \u00c9 hora de aprender novas t\u00e9cnicas e pr\u00e1ticas:</p> <ul> <li>Para refinar a l\u00f3gica de sua conquista, voc\u00ea pode ver quais recursos voc\u00ea possui na p\u00e1gina Achievement Logic Features.</li> </ul> <ul> <li>Voc\u00ea pode aprender observando as conquistas existentes que outros desenvolvedores fizeram com uma explica\u00e7\u00e3o extra na p\u00e1gina Real Examples.</li> </ul> <ul> <li>Voc\u00ea tamb\u00e9m pode ver alguns exemplos gen\u00e9ricos na p\u00e1gina Achievement Templates.</li> </ul> <p>Diverta-se! Obrigado pela leitura!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:27] meleu:</code> fix links</li> <li><code>[2020-06-20 18:15] meleu:</code> adicionado link para a playlist do Thoreau</li> <li><code>[2018-06-10 10:51] lilbud:</code> Updated Discord Link</li> <li><code>[2018-03-28 20:09] meleu:</code> Updated Getting Started as an Achievement Developer pt_BR (markdown)</li> <li><code>[2018-03-25 01:09] meleu:</code> Updated Getting Started as an Achievement Developer pt_BR (markdown)</li> <li><code>[2018-03-23 01:19] meleu:</code> Updated Getting Started as an Achievement Developer.pt_BR (markdown)</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer/","title":"Getting Started as an Achievement Developer","text":"<p>Welcome to the world of Achievement Creation!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#basic-concepts","title":"Basic Concepts","text":"<p>Technically an achievement is a group of conditions that must be met in a particular frame of the video game.</p> <p>When you launch a game on an emulator with the RetroAchievements feature, the emulator is always checking if those conditions are met in the current frame. When all conditions for a particular achievement are met, it is awarded and the emulator stops checking the conditions for that achievement.</p> <p>The process of creating an achievement basically involves 3 steps:</p> <ol> <li> <p>Finding a place in the game's RAM where the information you want is stored (examples: level, life bar, time, coins, holding a weapon, get an item, etc.).</p> </li> <li> <p>Create conditions that must be met in order to award an Achievement.</p> </li> <li> <p>Test if your achievement is working as expected.</p> </li> </ol> <p>Most likely you'll go back to step 2 and 3 many times to refine the logic of your Achievement.</p> <p>In this doc we'll see how to accomplish the steps above.</p> <p>After you're sure your achievement is triggering at the conditions you want, you can submit it to the server. We'll see more about it later.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#first-steps","title":"First Steps","text":"<p>Before start ensure you have an RA emulator from the RetroAchievements Download Page first and create an account so you can log in using the emulator.</p> <p>In this guide we'll be using RALibRetro with the Genesis Plus GX core to demonstrate, and the game Sonic the Hedgehog. We are using RALibRetro but the same applies for the standalone emulators.</p> <p>To begin, run the RALibRetro executable and login when prompted. If you have not used the Genesis Plus GX core before, you can install it by going to Settings -&gt; Manage Cores -&gt; selecting Sega Genesis in the drop down menu -&gt; clicking Download to the right of the core name. Once the core is installed, go to File -&gt; Select Core -&gt; Sega Genesis -&gt; Genesis Plus GX. Now that you have the core selected, you'll need to load the game. Go to File -&gt; Load Game and select the Sonic the Hedgehog ROM (we recommend using No Intro ROMs by default). </p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#memory-inspector","title":"Memory Inspector","text":"<p>You should now have your main window running Sonic. There are 3 other dialogs we'll be using, which can be found under RetroAchievements in the menu. We'll be dealing with the Memory Inspector first:</p> <p></p> <p>The Memory Inspector can be used to find addresses in RAM for us to use. Essentially you are on a treasure hunt for memory locations - this dialog will help you examine and filter the game's RAM while the game is running.</p> <p>NOTE: If you want a step-by-step video explanation on finding memory addresses, you can view this updated video. For another video resource, you can view this older video.</p> <p>See also: Memory Inspector Overview and Memory Digging Tips.</p> <p>To start or restart a test, click Reset near the top left.</p> <p>To keep things simple, we'll start by looking for the memory address which holds the number of rings we have collected. Our steps will be the following:</p> <ol> <li> <p>Load the ROM and start a new game.</p> </li> <li> <p>Reset the memory dialog: click Reset.</p> </li> <li> <p>Run the first filter: click Filter Once.</p> </li> <li> <p>Return to the game and change the number of rings in memory. For example, collect a ring.</p> </li> <li> <p>In the memory dialog, we now want to filter for values that are 'greater than previous values' (symbol <code>&gt;</code>). We select this, then hit Filter again.</p> </li> </ol> <p>Each time you perform 4 then 5, the number of possibilities or 'candidates' will get smaller. We will continue doing this until the number of candidates reaches a very small number (as few as possible), it can take several attempts. Next we can click in the results window, and monitor the memory address in the memory viewer at the bottom. Continue using the game and you should see the values in memory change as you collect rings. If you don't, or if something doesn't look right, try another value. With the first Sonic the Hedgehog, the memory address for the number of rings should be <code>0xfe20</code>.</p> <ul> <li>Note 1: Using save states (Shift+F1-F10 to save states, F1-F10 to load states), you can switch back and forth between different states allowing you to alter what is in RAM, and use this to filter out bad candidates. You can search for values that remain the same (I.e. If you know the value didn't change, use <code>=</code>), or values that are different (use 'not equal', symbol <code>!=</code>). Using the example above, you can collect a ring then use the \"&gt;\" filter, take a few steps then use the \"=\" filter (since the number of rings did not change), collect more rings and use the \"&gt;\" filter again, etc.</li> </ul> <ul> <li>Note 2: There's unfortunately no guarantee from game to game on how the developers have stored their data (4-bit, 8-bit, 16-bit, binary-coded decimals, negative/inverted, i.e. using 0xff/0xffff to represent 'set', or plain randomly), but eventually you should come across some good addresses. Note if you are struggling to find good values, post in RetroAchievements.org Development Help forum, or RetroAchievements Discord server. There are plenty of people who will be very happy to help!!</li> </ul> <ul> <li>Tip: if you'd like to experiment with memory, try entering new values directly into the RAM viewer. This can have devastating effects on the game, or it might do exactly what you expect, (or nothing at all!) It can be useful though, to see if you can enter a value and get the result you expect. Use with caution!</li> </ul> <p>When you've found an address you're happy with, you can write a short note for what it is and hit Save Note, this will store it on database, and will be automatically restored next time you load up the memory viewer for this game, wherever you are! Note that after clicking 'Save Note', the note will be automatically stored on the database, and shared so all developers will share access to these memory notes. They will all be downloaded afresh when you load a ROM. If you try to overwrite a note, it will check with you first before submitting.</p> <p>You can find more useful Memory Digging Tips here.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#achievement-sets","title":"Achievement Sets","text":"<p>So the memory location for the number of rings is stored at <code>0xfe20</code> - note to a non-programmer, we're dealing in hexadecimal numeral system which can be daunting, but don't worry, essentially it's just numbers and letters instead of only numbers, and not forgetting <code>0x</code> at the start to show that it's a memory location in hex. We've found an address we're interested in and stored it using Save Note. We now want to create a new achievement.</p> <p>Go to the RetroAchievements in the menu, choose Achievement Sets and you'll see this dialog:</p> <p></p> <p>Here we group all the achievements we know about into three sets:</p> <ol> <li> <p>Core Achievements (the main, public Achievement set),</p> </li> <li> <p>Unofficial/User Achievements (public, but will not award you points: for peer review),</p> </li> <li> <p>Local Achievements (exclusive to your PC).</p> </li> </ol> <p>In the Achievements dialog, click Local Achievements (top left), then Add New Achievement (top right). This will add a blank entry to the list in the center. Double click on it: if it's not already open, this should select it and open the Achievement Editor dialog.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#achievement-editor","title":"Achievement Editor","text":"<p>This is how it looks:</p> <p></p> <p>This is the final dialog where we bring all the data together. Most of the top fields are self explanatory, I.e. Title, Description, Points. The main one is the 'Requirements' part.</p> <p>Let's say we want to add an achievement for collecting a certain number of rings. Let's say 15 rings for simplicity. After filling out the fields at the top and selecting a suitable icon (in this example we used the gold trophy badge (00136), but you can upload a new one), we need to fill out Requirements. We have one requirement, that the number of rings is at least 15. Next click is Add New Requirement.</p> <p>Clicking this button will add several default values to the Requirements list. These defaults just ensure that something relatively sensible is added to the list. For now, ignoring the field 'Special?'. When we clicked create, the default memory value will be whatever value you last left in the memory dialog.</p> <p>Next we will change these values to the following:</p> <ul> <li>Size: <code>16-bit</code> - we're using 16-bit because the value can exceed 255 (which is 0xff in hex)</li> <li>Memory: <code>0xfe20</code></li> <li>Cmp: <code>&gt;=</code> - this is the comparison to make. We could have any comparison here, but it's sensible to have \"greater than or equal to\". This is important because if we get 10 rings then a super ring box to have 20, we would miss out having exactly 15 rings.</li> <li>Type: <code>Value</code> - we're comparing this memory value to a fixed value: 15</li> <li>Size: <code>Empty</code> - this is only relevant when comparing memory to memory</li> <li>Mem/Val: <code>15</code> - the number of rings required: the value we are comparing the memory to</li> <li>Hit Count: <code>0</code> - ignore this for now, its useful for when something needs to happen a certain number of times</li> </ul> <p>With that set, we don't have any more conditions to add, so we return to the Achievements Dialog. To be safe, we should save our progress by hitting Save Local! This saves everything to file locally to ensure that we won't lose any progress.</p> <ul> <li>Note: An achievement should have more than one requirement to avoid it triggering at the wrong time (i.e. playing demo mode). In this example, we are using only one requirement to simplify the explanation. See more Achievement Creation Tips here.</li> </ul>"},{"location":"Getting-Started-as-an-Achievement-Developer/#testing-the-achievement","title":"Testing the Achievement","text":"<p>We can now 'activate' this achievement locally by checking the box next to Active on the right-hand side in the Achievement Editor or by selecting the achievement in Achievement Sets and clicking Activate Selected. This will start monitoring these memory locations and will award the achievement once all the conditions are true. Now we can go ahead and test to see if this achievement works!</p> <p></p> <p>If we press <code>Esc</code> in-game, you will see the achievement show up as a demonstration of what it would look like in the in-game overlay!</p> <p></p> <p>Although the achievement worked fine in our tests, an achievement with logic like that is not ready to be officially released. First of all, it has only one condition: \"collected rings &gt;= 15\". The problem is that the memory address used to record the number of collected rings is also used when the game runs in \"demo mode\" (AI playing the game after you wait a while on the title screen). So, if Sonic collects 15 rings in demo mode this achievement will trigger, which is unwanted.</p> <p>Check the tips in the next section below to know how to improve the logic of your achievement and then make it acceptable to be officially released.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#important-tips","title":"Important Tips","text":"<p>Here are some tips you have to keep in mind when creating your achievements:</p> <ul> <li>Never Avoid making achievements with only one condition as much as you can. Otherwise it will most likely pop at the wrong time. This is the most common error by a developer</li> </ul> <ul> <li>If the game has a demo mode (AI plays the game after you wait a while on the title screen), make sure to find the address for it and add a condition so your achievements don't trigger in demo mode. You'll also need to know how to use PauseIf and ResetIf.</li> </ul> <ul> <li>PauseIf cheat codes: If the game has a cheat code to increase lives, select stages, etc., make sure to find the addresses for it and add some kind of protection in your achievements. OK, maybe it's not a very basic topic, but you have to keep it in mind when creating an official achievement set.</li> </ul> <ul> <li>Avoid creating achievements for just entering a stage. As it can be earned by a password or a stage select cheat code. It is preferred to make achievements for finishing stages, like in this template here. Also, do not create achievements for just starting a game or \"starting a game with character X\".</li> </ul> <ul> <li>If you want to create an achievement for getting a unique item in the game, add some conditions to make sure the player obtained the item where it is supposed to be obtained, like in this template here. Otherwise the achievement can be earned by using password or loading a saved game.</li> </ul> <ul> <li>Avoid making too many achievements about simple things that require minimal effort. Examples of what NOT to do: get one coin or one mushroom on Super Mario Bros.</li> </ul> <ul> <li>Be aware of the unwelcome achievement's design concepts.</li> </ul> <ul> <li>Be creative with your achievements. Those covering unique features and details of the game are the most welcome. The players love when that little detail of a game they love is supported on an achievement. Reading a walkthrough on GameFAQs can give some inspiration too.</li> </ul> <ul> <li>It can take a while to understand how the memory works in a game, so try spending as much time with it as you can, especially if it's your first attempt at developing achievements. </li> </ul> <p>You can find more in the Tips and Tricks page.</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#next-steps","title":"Next Steps","text":"<p>Now that you know how to use the Memory Inspector, and the Achievement Editor. It's time to learn new techniques and practice:</p> <ul> <li>In order to refine your achievement logic, you can see what features you have in the Achievement Logic Features page.</li> </ul> <ul> <li>Another way to learn is by looking at existing achievements that other devs made with an extra explanation in the Real Examples page.</li> </ul> <ul> <li>You can also see some generic examples in the Achievement Templates page.</li> </ul> <ul> <li>Once you have learned the basic techniques, you can continue your quest to become an achievement developer by following the steps explained here: How to Become an Achievement Developer</li> </ul> <p>Have fun!</p>"},{"location":"Getting-Started-as-an-Achievement-Developer/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-01-28 22:59] OvenOverlord:</code> Added Fridge's video link to the step-by-step video explanation links</li> <li><code>[2021-07-08 09:31] televandalist:</code> Fix image links</li> <li><code>[2020-05-15 02:15] televandalist:</code> Changed the Save/Load State method to match that of RALib rather than RAGens.</li> <li><code>[2020-05-15 02:13] televandalist:</code> Quick typo fix.</li> <li><code>[2020-05-15 02:04] televandalist:</code> Reworded instructions to apply to RALibRetro instead of RAGens. Added note about why the 16-bit address was selected in the editor. Fixed multiple typos, grammatical errors, and reworded some 'casual' speak.</li> <li><code>[2020-05-15 00:05] televandalist:</code> Recreated the old images with RALib. Old ones were using RAGens and had the old overlay.</li> <li><code>[2019-02-09 20:44] meleu:</code> mentioning PauseIf with hitcounts on this doc can lead to confusion (if we had a template/example for this technique it would be OK)</li> <li><code>[2019-02-08 10:53] meleu:</code> cosmetic</li> <li><code>[2019-02-08 02:12] Kvon:</code> pauseif link, added critical line for adding cheat protection, typically</li> <li><code>[2019-02-08 02:07] Kvon:</code> added a link to the demo mode tips</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/","title":"Tablas Globales y Reglas para la Caser\u00eda de Logros","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#en-resumen-las-reglas-de-oro","title":"En Resumen - Las Reglas de Oro","text":"<p>Participantes de las Tablas de Clasificaci\u00f3n Globales necesitan conseguir sus logros de manera justa y legitima.</p> <p>En general, un jugador tiene que desbloquear logro de la siguiente manera:</p> <ol> <li>utilizando la ultima versi\u00f3n de un emulador con soporte de RA;</li> <li>dentro del juego con acciones en el juego;</li> <li>que el lo controle;</li> <li>sin modificar los archivos del juego o el c\u00f3digo del juego;</li> <li>sin utilizar el archivo de guardado de otro jugador, y;</li> <li>sin utilizar programas externos de cheats.</li> </ol> <p>Esta reglas son dise\u00f1adas para mantener a los jugadores honestos en sus partidas y que sean honestos con todos los demas jugadores en la competencia de Tablas Globales.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#tabla-de-contenidos","title":"Tabla de Contenidos","text":"<ul> <li>Tablas Globales</li> <li>Modo Hardcore</li> <li>No Trackeado/Untracked</li> <li>No Permitido</li> <li>Permitido</li> <li>Sanciones por hacer trampa</li> <li>Como limpiar tu nombre y apelar el hacer trampa</li> <li>Si necesitas ayuda</li> <li>Agradecimientos Especiales</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#tablas-globales","title":"Tablas Globales","text":"<p>Las tablas globales de RetroAchievements es la competencia principal y oficial. Este incluye un rango \u00fanico del sitio basado en tu suma de puntos de logros en comparaci\u00f3n con todos los dem\u00e1s jugadores rankeados. Cualquier cuenta con puntos mayor a 0 es rankeada autom\u00e1ticamente.</p> <p>Lo que es considerado como una partida justa y legitima contra lo que se considera que no es justo (cheating) en las tablas globales a ido tomando forma por la comunidad desde sus or\u00edgenes. La reglas de abajo son lo que se espera de cada jugador que participa en en el rankeado global. Cualquier indicaci\u00f3n de que un jugador no este siguiendo las reglas este puede llegar a perder el uso de las tablas globales, tambi\u00e9n conocido como el estatus No Trackeado/Untracked.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#modo-hardcore","title":"Modo Hardcore","text":"<p>El modo Hardcore es una funci\u00f3n donde el emulador desactiva completamente la habilidad de estados de guardado (savestate), rebobinar (rewind) y c\u00e1mara lenta (slow motion). La funci\u00f3n de fast-forward es la \u00fanica excepci\u00f3n aceptada.</p> <p>Cuando juegas en modo hardcore los puntos que consigas valen el doble. Entonces si el set de logros tiene un valor de 400 puntos y lo terminas en modo hardcore vas a obtener 800 puntos.</p> <p>Los usuarios que se toman en serio las tablas de clasificaci\u00f3n son mas probables que consigan puntos en modo hardcore.</p> <p>NOTA: cuando se juega con el modo hardcore desactivado (tambi\u00e9n conocido como \"softcore\"), espera tener algunos problemas. Lee en este enlace porque no deber\u00edas de utilizar la funci\u00f3n de cargado de estado.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#no-trackeadountracked","title":"No Trackeado/Untracked","text":"<p>Una cuenta no trackeada no aparece en el ranking global, sus actividades no aparecen en el feed, no se muestra con todos los dem\u00e1s usuarios que consiguieron alg\u00fan logro (en la pagina del logro) y sus entradas en las tablas de clasificaciones no son publicamente visible.</p> <p>Sin embargo una cuenta No Trackeada aun puede disfrutar de RetroAchievements y conseguir los emblemas por completar juegos.</p> <p>Este estatus fue creado para que la gente puede hacer lo que quiera con sus cuentas (como hacer trampa o compartir contenido en sus amigos/familia) sin meterse con el aspecto justo y competitivo de las tablas globales. As\u00ed que, si quieres disfrutar de RetroAchievements pero no quieres competir en las tablas globales puedes solicitar que tu cuenta se deje de trackear. Simplemente manda un mensaje a RAdmin solicitandolo.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#no-permitido","title":"No Permitido","text":"<ol> <li>No utilices m\u00e9todos que alteren el c\u00f3digo del logro para desbloquearlos inmediatamente.</li> <li>No consigas logros en una manera en la que no fueron las intenciones del desarrollador del logro.</li> <li>No utilices archivos de guardado que no sean tuyos o fueron hechos para jugar con otras condiciones.</li> <li>De ninguna manera modifiques el(los) archivo(s) o memoria del juego.</li> <li>No utilices archivos de juego o programas conocidos como \"trainers\".</li> <li>No utilices TAS (tool-assisted speedrunning), bots, o escritura compleja para conseguir logros.</li> <li>No permitas que otra gente acceda a tu cuenta y consiga logros por ti.</li> <li>No seas abusivo/a con los desarrolladores.</li> <li>No crees o compartas m\u00e9todos para hacer trampa.</li> <li>No utilices c\u00f3digos dentro del juego al menos que sea permitido por el desarrollador.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#1-no-utilices-metodos-que-alteren-el-codigo-del-logro-para-desbloquearlos-inmediatamente","title":"1. No utilices m\u00e9todos que alteren el c\u00f3digo del logro para desbloquearlos inmediatamente.","text":"<p>Incluso si \"tu tuviste\" que haber conseguido ese logro. Incluso si el juego estaba buggeado. Incluso si el logro esta completamente roto o removido. Cuando esto es detectado es muy probable que tu cuenta se pase a Untracked.</p> <p>En los casos en que el logro tuvo que haberse desbloqueado pero no paso o no se registro en el sitio debido a un problema de red, deber\u00e1s de seguir los pasos descritos en el FAQ para solicitar un desbloqueo manual.</p> <p>NOTA: percatate de utilizar la ultima versi\u00f3n disponible para ese emulador.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#2-no-consigas-logros-en-una-manera-en-la-que-no-fueron-las-intenciones-del-desarrollador-del-logro","title":"2. No consigas logros en una manera en la que no fueron las intenciones del desarrollador del logro.","text":"<p>Si descubres un atajo a un logro esto es un bug. Por favor reporta este bug creando un ticket de reporte.</p> <p>Tambien mira la regla permitida 2.</p> <p>Ejemplos: </p> <ul> <li>Desbloqueaste logros terminando niveles por medio de un c\u00f3digo de selecci\u00f3n de niveles, y tiene que ser reportado/arreglado.</li> <li>Te diste cuenta que si entras y sales entre dos cuartos desbloqueas logros intencionados para progresi\u00f3n del juego.</li> <li>Encontraste un m\u00e9todo para conseguir logros de no recibir da\u00f1o contra un jefe mientras consegu\u00edas da\u00f1o en la pelea.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#3-no-utilices-archivos-de-guardado-que-no-sean-tuyos-o-fueron-hechos-para-jugar-con-otras-condiciones","title":"3. No utilices archivos de guardado que no sean tuyos o fueron hechos para jugar con otras condiciones.","text":"<p>Incluso si tu archivo esta perdido/corrupto o necesitas un archivo de guardado de cierta parte en el juego por que se te paso algo.</p> <p>Ejemplos:</p> <ul> <li>Descargar un archivo de guardado en linea.</li> <li>Rogarle a un amigo que te mande su archivo de guardado por que se incendio tu casa y se perdieron todos tus archivos de la PC.</li> <li>Cargar un archivo de guardado que creaste en un emulador sin soporte para RA, a uno con soporte para RA.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#4-de-ninguna-manera-modifiques-ellos-archivos-o-memoria-del-juego","title":"4. De ninguna manera modifiques el(los) archivo(s) o memoria del juego.","text":"<p>Ejemplos:</p> <ul> <li>Abrir los archivos del juegos con un editor de texto/hex y cambiar los valores a tu gusto; editar propiedades para archivos del juego de \"solo-lectura\"; etc. </li> <li>Editar las estad\u00edsticas o desbloqueables del juego, y despu\u00e9s guardar tu partida.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#5-no-utilices-archivos-de-juego-o-programas-conocidos-como-trainers","title":"5. No utilices archivos de juego o programas conocidos como \"trainers\".","text":"<p>Programas que pueden potenciar tus poderes en juegos, desbloquear modo de desarrollador, aumentar la velocidad del juego, modificar el c\u00f3digo del juego, etc.</p> <p>Ejemplos:</p> <ul> <li>Utilizar un programa trainer para lo que sea.</li> <li>Utilizar ROMs modificados para cualquier juego (estos no ni siquiera deber\u00edan de ser linkeados).</li> <li>Utilizar emuladores no-oficiales/antiguos-mods que actuan como trainers o herramientas de desarrollo/cheats.</li> <li>Game Genie / Action Replay y cualquier otra herramienta de cheats similar.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#6-no-utilices-tas-tool-assisted-speedrunning-bots-o-escritura-compleja-para-conseguir-logros","title":"6. No utilices TAS (tool-assisted speedrunning), bots, o escritura compleja para conseguir logros.","text":"<p>Estos ya es scripting avanzado que va mas alla de tareas simples (algunas veces incluso sincronizado con la velocidad de reloj del procesador) para permitir que secciones del juegos que sean jugadas de una manera compleja/\u00fanica/o no-monotona/no-repetitiva y sin interacci\u00f3n humana alguna.</p> <p>Ejemplos:</p> <ul> <li>Utilizar TAS para completar un speedrun complicado o un logro de no morir.</li> <li>Utilizar un script complejo con funciones avanzadas.</li> <li>Utilizar scripts complejos que te completan un juego por completo o porciones grandes del juego sin ninguna interacci\u00f3n humana pero que requieren algunas acciones especiales.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#7-no-permitas-que-otra-gente-acceda-a-tu-cuenta-y-consiga-logros-por-ti","title":"7. No permitas que otra gente acceda a tu cuenta y consiga logros por ti.","text":"<p>Incluyendo tu \"hermano peque\u00f1o\" o tu \"primo\". Tu tienes que conseguir logros por ti mismo. Permitir que otra gente consiga logros en tu cuenta no esta permitido en general y si alguien hace trampa o rompe las reglas en tu cuenta tu vas a ser el responsable por sus acciones.</p> <p>Ejemplos:</p> <ul> <li>Permitir que un amigo que esta mas amaestrado en un juego complete secciones mas dif\u00edciles en un juego de single-player.</li> <li>Permitir que alguien inicie secci\u00f3n en tu cuenta para que pase alguna parte complicada de un juego por ti.</li> <li>Permitir que tu hermano peque\u00f1o trabaje en un logro de grindear por ti.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#8-no-seas-abusivoa-con-los-desarrolladores","title":"8. No seas abusivo/a con los desarrolladores.","text":"<p>Por medio del foro, Mensajes Privados, Discord, email, etc. Tienes permitido quejarte, solicitar cambios, dejar comentarios/rese\u00f1as negativas y otras criticas de manera respetuosa, pero tu das un nombre muy mal en la comunidad de cazadores de logros cuando hostigas/atacas a desarrolladores debido a lo que hicieron con los logros de su juego.</p> <p>Ejemplos: Mandar amenazas o insultos a desarrolladores porque agregaron logros a su juego que a ti no te gusta; utilizando una agresividad extrema/excesiva mientras exiges al desarrollador que remueva cambie los logros; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#9-no-crees-o-compartas-metodos-para-hacer-trampa","title":"9. No crees o compartas m\u00e9todos para hacer trampa.","text":"<p>Ejemplos:</p> <ul> <li>Ense\u00f1arle a laguien como utilizar herramientas de hackeado de memoria.</li> <li>Postear en los foros, promoviendo un metodo para editar un archivo de juego.</li> <li>Mandarle a alguien un link a una herramienta de hackeado de memoria o para programas trainer.</li> <li>Ense\u00f1arle a alguien como hacer trampa sin que se note.</li> <li>Crear un script complejo no-permitido y compartirlo inclusive si tu nunca lo utilizaste personalmente.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#10-no-utilices-codigos-dentro-del-juego-al-menos-que-sea-permitido-por-el-desarrollador","title":"10. No utilices c\u00f3digos dentro del juego al menos que sea permitido por el desarrollador.","text":"<p>El otro lado de la moneda para permitido 2. Cheat codes y modos debug no est\u00e1n permitidos mientras el desarrollador a hecho una nota en la que dice donde y cuando es permitido. Incluso si los logros son conseguibles con cheat codes este usualmente es un comportamiento no permitido, considerando que utilizaste cheats de una manera intencional, deber\u00edas de reportarlo como un bug con el sistema de tickets.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#permitido","title":"Permitido","text":"<ol> <li>Fast-forward esta permitido.</li> <li>Cuando dice explicitamente en la descripci\u00f3n de logro, cheat codes/modo dentro del juego est\u00e1n permitidos y herramientas de desarrollo/debug est\u00e1n permitidas.</li> <li>Hacer uso de glitches dentro del juego, exploits, y tacticas \"cheesy\" es permitido.</li> <li>Utilizar guias/walkthroughs en linea es permitido.</li> <li>Jugar juegos en co-op/competitivo con otro jugador o jugadores es permitido.</li> <li>Turbo esta permitido.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#1-fast-forward-esta-permitido","title":"1. Fast-forward esta permitido.","text":"<p>Incluso en modo hardcore el fast-forward esta permitido, como una conveniencia de la actualidad. Es casi un hecho de que el fast-forward ofrece una partida justa y por eso esta disponible para que todos lo utilicen.</p> <p>NOTA:en modo softcore savestates, rewind y camara-lenta tambi\u00e9n est\u00e1n permitidos, pero ten en cuenta que podrias llegar a tener algunos problemas. Checa este link de Porque no deber\u00edas de utilizar la funci\u00f3n de cargado de estado.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#2-cuando-dice-explicitamente-en-la-descripcion-de-logro-cheat-codesmodo-dentro-del-juego-estan-permitidos-y-herramientas-de-desarrollodebug-estan-permitidas","title":"2. Cuando dice explicitamente en la descripci\u00f3n de logro, cheat codes/modo dentro del juego est\u00e1n permitidos y herramientas de desarrollo/debug est\u00e1n permitidas.","text":"<p>Este es un complemento a la regla no permitida numero 2.</p> <p>El desarrollador de logros deber\u00eda de estar capacitado en proteger su trabajo para que estos no se desbloqueen f\u00e1cilmente simplemente ingresando cheat codes. Sin embargo, algunos retos muy cool y divertidos puedes ser creados si tomamos ventaja de los cheats. En estos casos en especifico, utilizar cheats del juego esta permitido.</p> <p>NOTA: si encuentras logros desbloqueables con uso de cheats y que en estos no este descrito que se puedan utilizar, considera abrir un ticket y reportarlo.</p> <p>Ejemplos:</p> <ul> <li>En Tetris (Game Boy) necesitas activar el c\u00f3digo de velocidad para conseguir el   logro Reto de los Dioses (Challenge of the Gods), donde necesitas limpiar 20 lineas en velocidad 19.</li> <li>En Guerrilla War (NES) tienes permitido utilizar el c\u00f3digo de \"selecci\u00f3n de niveles y dificultad\" para conseguir logros donde necesitas completar stages sin acecinar a ning\u00fan reh\u00e9n.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#3-hacer-uso-de-glitches-dentro-del-juego-exploits-y-tacticas-monotonas-cheesy-tactics-es-permitido","title":"3. Hacer uso de glitches dentro del juego, exploits, y t\u00e1cticas \"mon\u00f3tonas\" (cheesy tactics) es permitido.","text":"<p>Glitches/exploits/tacticas-mon\u00f3tonas esta permitido, aunque los desarrolladores pueden programar sus logros para desactivarlos. Esto es usualmente mencionado en la descripci\u00f3n del logro.</p> <p>Esto no incluye cuando hay fallas en el c\u00f3digo del logro del desarrollador. En esos casos, por favor crea un ticket de reporte, y consigue el logro como se supone que el desarrollador quer\u00eda que se obtuviera. Tambi\u00e9n mira regla no permitida 2.</p> <p>Ejemplos:</p> <ul> <li>Traspasar la colisi\u00f3n para evadir enemigos.</li> <li>Hacer algo raro dentro del juego para \"buggearlo de cierta manera\" y consigas invisibilidad.</li> <li>Conseguir items poderosos antes de lo intencionado.</li> <li>Ponerte en un lugar donde los enemigos no te puedan golpear.</li> </ul> <p>Ejemplos cuando los desarrolladores lo desabilitan: Megaman (NES) - vence a los jefes sin recibir da\u00f1o sin utilizar el glitch de pausa.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#4-utilizar-guiaswalkthroughs-en-linea-es-permitido","title":"4. Utilizar gu\u00edas/walkthroughs en linea es permitido.","text":"<p>Ejemplos: v\u00eddeo gu\u00edas de youtube; GameFAQs; soluciones de puzzles; lista de coleccionables; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#5-jugar-juegos-en-co-opcompetitivo-con-otro-jugador-o-jugadores-es-permitido","title":"5. Jugar juegos en co-op/competitivo con otro jugador o jugadores es permitido.","text":"<p>Jugar co-op esta permitido, sin embargo los desarrolladores pueden codificar sus logros para desactivarlo. Esto es usualmente mencionado en la descripci\u00f3n del logro.</p> <p>Tambi\u00e9n mira regla no permitida 2.</p> <p>Ejemplos: un amigo con experiencia jugando Streets of Rage o Goof Troop contigo; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#6-turbo-esta-permitido","title":"6. Turbo esta permitido.","text":"<p>Turbo es cuando dejas presionado solamente un bot\u00f3n y el bot\u00f3n es autom\u00e1ticamente presionado una y otra vez. Esta funci\u00f3n ya sea que esta integrada en el control, o en el emulador. En los dos de los casos esta permitido.</p> <p>En casos en los que hay un scripting mas complejo aparte de solamente presionar un bot\u00f3n repetidamente, esto ya no esta permitido. Mira regla No Permitida 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#sanciones-por-hacer-trampa","title":"Sanciones por hacer trampa","text":"<p>Cuando se detecte que se hace trampa, la cuenta va a ser puesta como Untracked. Hay algunos casos en donde la cuenta puede llegar a ser banneada.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#como-limpiar-tu-nombre-y-apelar-el-hacer-trampa","title":"Como limpiar tu nombre y apelar el hacer trampa","text":"<p>La manera mas r\u00e1pida: Resetea todos tus puntos. Si fuiste previamente puesto como untracked y te gustar\u00eda que se te regresara al estado normal por favor informalo con RAdmin para que tomen la acci\u00f3n necesaria.</p> <p>Si tienes maneras de demostrar que jugabas sin hacer trampa, manda un mensaje a RAdmin, pero ten en cuenta que todo el staff de RA son voluntarios y puede llegar a tomar un tiempo para que revisen tu caso.</p> <p>Si deseas tener la iniciativa de admitir que hac\u00edas trampa, esto es realmente apreciado y se toma en consideraci\u00f3n durante tu caso.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#si-necesitas-ayuda","title":"Si necesitas ayuda","text":"<p>Si alguna vez tuviste una pregunta, comentario, o sugerencias - si\u00e9ntete libre de contactar a RAdmin o al staff de RA (@mods y @admins) en el servidor de discord.</p> <p>Estas reglas ser\u00e1n corregidas cada cierto tiempo si esto es requerido.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#agradecimientos-especiales","title":"Agradecimientos Especiales","text":"<p>Este documento esta fuertemente basado en las reglas de caser\u00eda de logros de 100Pals. Aunque esta versi\u00f3n esta un poco mas resumida y modificada con temas relevantes en cuanto al contexto de RetroAchievements.</p> <p>100Pals es una comunidad con cazadores de logros experimentados que existe desde que los logros fueron implementados en Steam por primera vez en 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:28] meleu:</code> fix link</li> <li><code>[2019-06-03 10:27] meleu:</code> fix broken link</li> <li><code>[2019-05-31 10:09] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-31 10:08] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-31 10:05] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-30 10:50] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-29 11:34] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-27 11:41] eldexterr:</code> Updated Global Leaderboard and Achievement Hunting Rules es (markdown)</li> <li><code>[2019-05-26 15:27] eldexterr:</code> Created Global Leaderboard and Achievement Hunting Rules es (markdown)</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/","title":"Global Leaderboard and Achievement Hunting Rules fr [In progress]","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#tlpl-regles-dor","title":"TL;PL - R\u00e8gles d'or","text":"<p>Les participants du Classement global doivent gagner leurs succ\u00e8s de mani\u00e8re l\u00e9gitime et dans les r\u00e8gles.</p> <p>De mani\u00e8re g\u00e9n\u00e9rale, un joueur doit d\u00e9bloquer des succ\u00e8s :</p> <ol> <li>en utilisant la derni\u00e8re version en date d'un \u00e9mulateur approuv\u00e9 ;</li> <li>en jouant \u00e0 un jeu directement ;</li> <li>par ses propres moyens ;</li> <li>sans utiliser de fichiers tiers ou de codes permettant de modifier le jeu ;</li> <li>sans utiliser la sauvegarde d'un autre joueur ou des mots-de-passe, et ;</li> <li>sans utiliser de logiciels tiers de tricherie.</li> </ol> <p>Ces r\u00e8gles ont \u00e9t\u00e9 con\u00e7ues pour maintenir une comp\u00e9tition dans le Classement global dont l'objectif est de maintenir une honn\u00eatet\u00e9 envers soi-m\u00eame et ses capacit\u00e9s de jeu et envers tous les autres joueurs.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#table-des-matieres","title":"Table des mati\u00e8res","text":"<ul> <li>Classement global</li> <li>Mode Hardcore</li> <li>Non class\u00e9s</li> <li>Interdit</li> <li>Ce qui est permis</li> <li>Sanctions pour tricherie</li> <li>Comment effacer l'ardoise ou faire appel de tricherie</li> <li>Si vous avez besoin d'aide</li> <li>Remerciements sp\u00e9ciaux</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#classement-global","title":"Classement global","text":"<p>Le classement global de RetroAchievements est la comp\u00e9tition officielle \u00e0 laquelle participe toute la communaut\u00e9. Cela se traduit sur le site par un unique rang au sein de la communaut\u00e9 bas\u00e9 sur la somme des points des succ\u00e8s acquis. Chaque compte dont les points sont sup\u00e9rieurs \u00e0 500 est concern\u00e9.</p> <p>Au sein du classement global, ce qui est consid\u00e9r\u00e9 comme l\u00e9gitime et dans les r\u00e8gles par opposition \u00e0 ill\u00e9gitime (tricherie) a \u00e9t\u00e9 fa\u00e7onn\u00e9 continuellement par la communaut\u00e9 depuis les origines. Il est attendu que les r\u00e8gles ci-dessous doivent \u00eatre respect\u00e9es par tous les joueurs souhaitant participer au syst\u00e8me de classement global. Tout indice menant \u00e0 la conclusion qu'un joueur n'aurait pas respect\u00e9 ces r\u00e8gles entra\u00eenera la bascule du compte parmi les Non class\u00e9s.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#mode-hardcore","title":"Mode Hardcore","text":"<p>Le mode Hardcore est une fonctionnalit\u00e9 qui permet \u00e0 l'\u00e9mulateur de d\u00e9sactiver TOUS les retours en arri\u00e8res, ralentissements et sauvegardes d'\u00e9tat. La fonctionnalit\u00e9 d'acc\u00e9l\u00e9ration est la seule exception accept\u00e9e.</p> <p>Lorsque vous jouez en mode Hardcore, vous gagnez le double des points initialement pr\u00e9vus pour le succ\u00e8s. Donc si une s\u00e9rie de succ\u00e8s vaut 400 points et que vous la compl\u00e9tez en mode Hardcore, vous gagnerez 800 points.</p> <p>Les joueurs qui prennent le classement global au s\u00e9rieux compl\u00e8teront sans aucun doute les s\u00e9ries de succ\u00e8s en mode Hardcore pour obtenir plus de points.</p> <p>NOTE : si vous d\u00e9sactivez le mode Hardcore (ce qu'on appelle le mode \"softcore\"), attendez-vous \u00e0 avoir des probl\u00e8mes. Consultez le lien :  Pourquoi il ne faut pas utiliser le chargement d'\u00e9tat.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#non-classes","title":"Non class\u00e9s","text":"<p>Un compte non class\u00e9 n'appara\u00eet plus dans le classement global, son activit\u00e9 dispara\u00eet du fil et il n'est plus list\u00e9 parmi les joueurs ayant acquis chaque succ\u00e8s (sur la page du succ\u00e8s). Tout ce qui le concerne n'est plus public.</p> <p>Cependant, un compte non class\u00e9 peut encore profiter de RetroAchievements et gagner des badges pour avoir compl\u00e9t\u00e9 des jeux.</p> <p>Ce statut a \u00e9t\u00e9 cr\u00e9\u00e9 pour que chacun puisse faire ce qu'il veut avec son compte (comme tricher, partager son compte avec des amis ou de la famille) sans pour autant fausser l'aspect comp\u00e9titif du classement global. Donc, si vous appr\u00e9ciez RetroAchievements mais ne souhaitez pas participer \u00e0 la comp\u00e9tition du classement global, vous pouvez demander \u00e0 basculer votre compte en non class\u00e9. Il suffit d'envoyer un message \u00e0 RAdmin.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#interdit","title":"Interdit","text":"<ol> <li>Ne pas utiliser de m\u00e9thode qui contournerait le code du succ\u00e8s afin de le d\u00e9bloquer instantan\u00e9ment. .</li> <li>Ne pas gagner le succ\u00e8s d'une mani\u00e8re qui n'a pas \u00e9t\u00e9 pr\u00e9vue par le d\u00e9veloppeur de succ\u00e8s.</li> <li>Ne pas utiliser de sauvegardes ou mots de passe fournis par un autre joueur ou issus de conditions de jeu diff\u00e9rentes.</li> <li>Ne pas modifier les fichiers du jeu ou la m\u00e9moire par quelque moyen que ce soit.</li> <li>Ne pas utiliser de fichiers de jeu ou de logiciels connus comme \u00e9tant des \"trainers\".</li> <li>Ne pas utiliser de TAS (tool-assisted speedrunning), bots, ou scripts complexe pour d\u00e9bloquer des succ\u00e8s.</li> <li>Ne pas partager son compte pour que d'autres d\u00e9bloquent des succ\u00e8s \u00e0 votre place.</li> <li>Ne soyez pas insultant avec les d\u00e9veloppeurs.</li> <li>Ne cr\u00e9ez et partagez aucune m\u00e9thode de tricherie.</li> <li>N'utilisez pas de code de tricherie \u00e0 moins que ce ne soit sp\u00e9cifiquement permis par le d\u00e9veloppeur.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#1-ne-pas-utiliser-de-methode-qui-contournerait-le-code-du-succes-afin-de-le-debloquer-instantanement","title":"1. Ne pas utiliser de m\u00e9thode qui contournerait le code du succ\u00e8s afin de le d\u00e9bloquer instantan\u00e9ment.","text":"<p>M\u00eame si vous \"auriez d\u00fb\" le d\u00e9bloquer. M\u00eame si le jeu est bogu\u00e9. M\u00eame si le succ\u00e8s est retir\u00e9 ou qu'il ne fonctionne plus. Lorsque c'est d\u00e9tect\u00e9, le compte incrimin\u00e9 bascule dans les comptes Non class\u00e9s.</p> <p>Si vous deviez d\u00e9bloquer un succ\u00e8s, mais que \u00e7a n'a pas \u00e9t\u00e9 le cas, ou que l'enregistrement sur le site Internet n'a pas eu lieu \u00e0 cause de probl\u00e8me r\u00e9seau, vous devez suivre la proc\u00e9dure d\u00e9crite dans la FAQ pour d\u00e9bloquer un succ\u00e8s manuellement.</p> <p>NOTE : Assurez-vous de bien utiliser la derni\u00e8re version en date de l'\u00e9mulateur approuv\u00e9.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#2-ne-pas-gagner-le-succes-dune-maniere-qui-na-pas-ete-prevue-par-le-developpeur-de-succes","title":"2. Ne pas gagner le succ\u00e8s d'une mani\u00e8re qui n'a pas \u00e9t\u00e9 pr\u00e9vue par le d\u00e9veloppeur de succ\u00e8s.","text":"<p>Si vous d\u00e9couvrez une porte d\u00e9rob\u00e9e pour accomplir un succ\u00e8s, signalez-la en envoyant un rapport.</p> <p>Consultez aussi Ce qui est permis 2.</p> <p>Exemples : </p> <ul> <li>Vous d\u00e9bloquez un succ\u00e8s pour avoir fini un niveau en utilisant un code de tricherie de s\u00e9lection de niveau. C'est un bogue qui doit \u00eatre rapport\u00e9 et corrig\u00e9.</li> <li>Vous d\u00e9clenchez un succ\u00e8s de progression de niveau en revenant en arri\u00e8re puis en avant entre deux salles.</li> <li>Vous d\u00e9couvrez un moyen de faire un succ\u00e8s 0 dommages sur un boss alors que vous en prenez.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#3-ne-pas-utiliser-de-sauvegardes-ou-mots-de-passe-fournis-par-un-autre-joueur-ou-issus-de-conditions-de-jeu-differentes","title":"3. Ne pas utiliser de sauvegardes ou mots de passe fournis par un autre joueur ou issus de conditions de jeu diff\u00e9rentes.","text":"<p>\u00c0 l'occasion, un d\u00e9veloppeur peut \u00e9ventuellement fournir une sauvegarde ou un mot de passe afin de d\u00e9bloquer un succ\u00e8s. C'est appropri\u00e9 dans le sens o\u00f9 c'est le d\u00e9veloppeur qui l'a d\u00e9cid\u00e9 ainsi.</p> <p>Exemples :</p> <ul> <li>T\u00e9l\u00e9charger une sauvegarde d'un jeu \u00e0 clics.</li> <li>Supplier un ami pour qu'il vous envoie sa sauvegarde car votre maison a br\u00fbl\u00e9 et vous avez perdu tous vos fichiers.</li> <li>Utiliser une sauvegarde en Hardcore que vous avez cr\u00e9\u00e9e sur un \u00e9mulateur non support\u00e9 par RA.</li> <li>Utiliser une sauvegarde en Hardcore cr\u00e9\u00e9e en Softcore pour gagner des points suppl\u00e9mentaires.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#4-ne-pas-modifier-les-fichiers-du-jeu-ou-la-memoire-par-quelque-moyen-que-ce-soit","title":"4. Ne pas modifier les fichiers du jeu ou la m\u00e9moire par quelque moyen que ce soit.","text":"<p>Exemples :</p> <ul> <li>Ouvrir les fichiers d'un jeu avec un \u00e9diteur de texte ou hexad\u00e9cimal et changer une valeur pour obtenir ce que l'on veut, changer les propri\u00e9t\u00e9s d'un fichier et notamment \"lecture seule\", etc. </li> <li>Modifier dans un jeu les statistiques ou l'avancement et sauvegarder les donn\u00e9es.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#5-ne-pas-utiliser-de-fichiers-de-jeu-ou-de-logiciels-connus-comme-etant-des-trainers","title":"5. Ne pas utiliser de fichiers de jeu ou de logiciels connus comme \u00e9tant des \"trainers\".","text":"<p>Les logiciels qui peuvent augmenter votre puissance en jeu, d\u00e9bloquer les modes d\u00e9bogage, acc\u00e9l\u00e9rer le jeu, modifier le code du jeu, etc.</p> <p>Exemples :</p> <ul> <li>Utiliser un logiciel \"trainer\" pour quoi que ce soit.</li> <li>Utiliser une ROM modifi\u00e9e (\"trainer\") qu'importe le jeu (elle ne sera pas associ\u00e9e \u00e0 la s\u00e9rie de succ\u00e8s).</li> <li>Utiliser un \u00e9mulateur non officiel, un vieux mod qui agit comme un \"trainer\" ou comme outil de d\u00e9bogage ou de tricherie.</li> <li>Game Genie / Action Replay et tout autre outil similaire de tricherie.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#6-ne-pas-utiliser-de-tas-tool-assisted-speedrunning-bots-ou-scripts-complexe-pour-debloquer-des-succes","title":"6. Ne pas utiliser de TAS (tool-assisted speedrunning), bots, ou scripts complexe pour d\u00e9bloquer des succ\u00e8s.","text":"<p>Il s'agit de scripts avanc\u00e9s pour le jeu qui vont bien au-del\u00e0 de la simple fonction (parfois li\u00e9e \u00e0 l'horloge interne) qui permettent de maintenir une activit\u00e9 complexe et unique en jeu sans interaction humaine et qui ne suivent pas un sch\u00e9ma r\u00e9current.</p> <p>Exemples :</p> <ul> <li>utiliser un TAS pour accomplir un speedrun difficile ou un succ\u00e8s 0 mort.</li> <li>utiliser un script complexe avec des fonctionnalit\u00e9s avanc\u00e9es.</li> <li>utiliser un script complexe impliquant des actions uniques qui finit de larges portions du jeu voire le jeu compl\u00e8tement sans intervention humaine.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#7-ne-pas-partager-son-compte-pour-que-dautres-debloquent-des-succes-a-votre-place","title":"7. Ne pas partager son compte pour que d'autres d\u00e9bloquent des succ\u00e8s \u00e0 votre place.","text":"<p>M\u00eame votre \"petit fr\u00e8re\" ou votre \"cousin\". Vous devez d\u00e9bloquer les succ\u00e8s par vous-m\u00eame. Laisser d'autres personnes d\u00e9bloquer des succ\u00e8s sur votre compte n'est pas permis et si quelqu'un d'autre que vous triche ou enfreint les r\u00e8gles sur votre compte, c'est vous qui serez tenu pour responsable.</p> <p>Exemples :</p> <ul> <li>Un ami plus talentueux d\u00e9bloque une partie difficile du jeu.</li> <li>Laisser quelqu'un se connecter \u00e0 votre compte pour compl\u00e9ter une partie difficile d'un jeu.</li> <li>Laisser votre petit fr\u00e8re s'occuper du farm d'un succ\u00e8s.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#8-ne-soyez-pas-insultant-avec-les-developpeurs","title":"8. Ne soyez pas insultant avec les d\u00e9veloppeurs.","text":"<p>Via forums, MPs, discord, courriel, etc. Vous n'\u00eates pas autoris\u00e9 \u00e0 vous plaindre, solliciter des changements, poster des analyses ou commentaires n\u00e9gatifs ou tout autre critique irrespectueuse. En attaquant, harcelant les d\u00e9veloppeurs au sujet de leur travail sur les succ\u00e8s, c'est notre image au sein de la communaut\u00e9 des chasseurs de succ\u00e8s que vous salissez.</p> <p>Exemples : Poster des menaces ou des insultes flagrante envers un d\u00e9veloppeur pour avoir ajouter \u00e0 un jeu un succ\u00e8s que vous n'aimez pas. Faire preuve d'incivilit\u00e9 en demandant \u00e0 un d\u00e9veloppeur de retirer ou modifier un succ\u00e8s, etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#9-ne-creez-et-partagez-aucune-methode-de-tricherie","title":"9. Ne cr\u00e9ez et partagez aucune m\u00e9thode de tricherie.","text":"<p>Exemples :</p> <ul> <li>Enseigner \u00e0 quelqu'un comment utiliser des outils de piratage de m\u00e9moire.</li> <li>Poster sur le forum pour promouvoir une m\u00e9thode flagrante d'\u00e9dition.</li> <li>Envoyer \u00e0 quelqu'un un lien vers des outils de piratage de m\u00e9moire ou un programme \"trainers\".</li> <li>Apprendre \u00e0 quelqu'un comment tricher et s'en cacher.</li> <li>Cr\u00e9er un script complexe non autoris\u00e9 et le partager m\u00eame si vous ne l'avez jamais utilis\u00e9 vous-m\u00eame.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#10-nutilisez-pas-de-code-de-tricherie-a-moins-que-ce-ne-soit-specifiquement-permis-par-le-developpeur","title":"10. N'utilisez pas de code de tricherie \u00e0 moins que ce ne soit sp\u00e9cifiquement permis par le d\u00e9veloppeur.","text":"<p>Le c\u00f4t\u00e9 face de Ce qui est permis 2. Les codes de tricherie et les modes de d\u00e9bogage ne sont pas permis \u00e0 moins que le d\u00e9veloppeur n'ait indiqu\u00e9 le contraire et dans quelles conditions. M\u00eame si les succ\u00e8s sont d\u00e9blocables via un code de tricherie, il ne s'agit pas d'un comportement attendu et consid\u00e9r\u00e9 comme de la tricherie si intentionnel. Cela doit \u00eatre signal\u00e9 en tant que bogue via le syst\u00e8me de signalement.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#ce-qui-est-permis","title":"Ce qui est permis","text":"<ol> <li>L'acc\u00e9l\u00e9ration du jeu est permise.</li> <li>Lorsque la description du succ\u00e8s l'indique explicitement, les codes/modes de tricherie et les outils de d\u00e9bogage sont autoris\u00e9s.</li> <li>Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis.</li> <li>Utiliser un guide en ligne est permis.</li> <li>Jouer \u00e0 un jeu comp\u00e9titif/co-op avec un ou plusieurs joueurs est autoris\u00e9.</li> <li>Le Turbo est autoris\u00e9.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#1-lacceleration-du-jeu-est-permise","title":"1. L'acc\u00e9l\u00e9ration du jeu est permise.","text":"<p>M\u00eame en mode hardcore, l'acc\u00e9l\u00e9ration du jeu est autoris\u00e9e en tant que commodit\u00e9 moderne. Il est commun\u00e9ment admis que l'acc\u00e9l\u00e9ration ne pr\u00e9sente pas de risque de fausser le classement. Elle est donc disponible pour tous.</p> <p>NOTE : en mode softcore les sauvegardes d'\u00e9tat, les retours en arri\u00e8re et les ralentissements sont autoris\u00e9s, mais attendez vous \u00e0 des probl\u00e8mes. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#2-lorsque-la-description-du-succes-lindique-explicitement-les-codesmodes-de-tricherie-et-les-outils-de-debogage-sont-autorises","title":"2. Lorsque la description du succ\u00e8s l'indique explicitement, les codes/modes de tricherie et les outils de d\u00e9bogage sont autoris\u00e9s.","text":"<p>Vient en compl\u00e9ment de Interdit 2.</p> <p>Les d\u00e9veloppeurs de succ\u00e8s ont pour instruction de prot\u00e9ger leur travail de telle sorte que le succ\u00e8s ne puisse \u00eatre simplement d\u00e9bloqu\u00e9 par un code de tricherie. Toutefois, quelques challenges cools et funs peuvent \u00eatre cr\u00e9\u00e9s en exploitant des m\u00e9thodes de tricherie. Dans ce cas particulier, les m\u00e9thodes de tricherie sont autoris\u00e9es.</p> <p>NOTE: si vous d\u00e9couvrez qu'un succ\u00e8s est d\u00e9blocable en trichant sans que ce soit indiqu\u00e9 dans son descriptif, proc\u00e9dez \u00e0 un signalement.</p> <p>Examples :</p> <ul> <li>Dans Tetris (Game Boy) vous pouvez activer la tricherie d'acc\u00e9l\u00e9ration pour d\u00e9bloquer le succ\u00e8s Challenge of the Gods, pour lequel vous devez nettoyer 20 lignes \u00e0 la vitesse 19.</li> <li>Dans Guerrilla War (NES) vous \u00eates autoris\u00e9s \u00e0 utiliser l'\u00e9cran de s\u00e9lection des niveaux et de difficult\u00e9 pour d\u00e9bloquer le succ\u00e8s pour lequel vous devez finir des niveaux sans tuer d'otages.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#3-utiliser-des-glitchs-exploits-ou-des-strategies-non-prevues-mais-efficaces-est-permis","title":"3. Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis.","text":"<p>Utiliser des glitchs, exploits ou des strat\u00e9gies non pr\u00e9vues mais efficaces est permis, cependant les d\u00e9veloppeurs peuvent l'emp\u00eacher dans le code. C'est g\u00e9n\u00e9ralement indiqu\u00e9 dans la description du succ\u00e8s.</p> <p>Cette r\u00e8gle n'est pas valable dans le cas de pr\u00e9sence de failles dans le code du d\u00e9veloppeur. Dans ce cas pr\u00e9cis, proc\u00e9dez \u00e0 un signalement et d\u00e9bloquez le succ\u00e8s comme pr\u00e9vu initialement par le d\u00e9veloppeur. Consultez aussi Interdit 2.</p> <p>Exemples :</p> <ul> <li>Franchir les limites permises par le jeu pour \u00e9viter des ennemis.</li> <li>Faire quelque chose d'\u00e9trange dans un jeu afin de le faire buguer et devenir invincible.</li> <li>Obtenir des objets puissant plus t\u00f4t que pr\u00e9vu.</li> <li>Se positionner hors de port\u00e9e des ennemis tout en pouvant les toucher.</li> </ul> <p>Exemple pour lequel les d\u00e9veloppeurs l'emp\u00eachent: Megaman (NES) - battre les boss sans prendre de d\u00e9g\u00e2ts sans utiliser le glitch de la pause.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#4-utiliser-un-guide-en-ligne-est-permis","title":"4. Utiliser un guide en ligne est permis..","text":"<p>Exemples: guides vid\u00e9o sur Youtube; GameFAQs; solutions d'enigmes; listes d'objets \u00e0 collectionner.</p> <p>Pr\u00e9cision d'honn\u00eatet\u00e9: Utiliser un r\u00e9solveur pour sudoku/picross est consid\u00e9r\u00e9 comme de la tricherie. De la tricherie qu'on ne peut punir et donc tol\u00e9r\u00e9e mais de la tricherie tout de m\u00eame.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#5-jouer-a-un-jeu-competitifco-op-avec-un-ou-plusieurs-joueurs-est-autorise","title":"5. Jouer \u00e0 un jeu comp\u00e9titif/co-op avec un ou plusieurs joueurs est autoris\u00e9.","text":"<p>Jouer \u00e0 un jeu en co-op est autoris\u00e9. Cependant, les d\u00e9veloppeurs peuvent l'emp\u00eacher dans le code du succ\u00e8s. C'est g\u00e9n\u00e9ralement indiqu\u00e9 dans la description du succ\u00e8s.</p> <p>Consultez aussi Interdit 2.</p> <p>Exemples : un ami talentueux qui joue \u00e0 Streets of Rage ou Goof Troop avec vous; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#6-le-turbo-est-autorise","title":"6. Le Turbo est autoris\u00e9.","text":"<p>Le Turbo, c'est quand vous pressez un bouton et qu'il est automatiquement press\u00e9 de nouveau de mani\u00e8re r\u00e9p\u00e9titive et rapide. Le Turbo est soit inclus avec une manette soit logiciel avec l'\u00e9mulateur. Dans les deux cas, c'est autoris\u00e9.</p> <p>Dans le cas o\u00f9 un script plus complexe (plus qu'un bouton) est r\u00e9p\u00e9t\u00e9, ce n'est pas autoris\u00e9. Consultez Interdit 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#sanctions-pour-tricherie","title":"Sanctions pour tricherie","text":"<p>Aussit\u00f4t qu'une tricherie aura \u00e9t\u00e9 d\u00e9tect\u00e9e, le compte sera bascul\u00e9 dans la cat\u00e9gorie Non class\u00e9. Dans certains cas, le compte sera banni.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#comment-effacer-lardoise-ou-faire-appel-de-tricherie","title":"Comment effacer l'ardoise ou faire appel de tricherie","text":"<p>Le moyen le plus rapide : remise \u00e0 0 de tous vos points. Si votre compte a \u00e9t\u00e9 bascul\u00e9 dans les non class\u00e9s et que vous souhhaitez l'annuler, merci d'informer Radmin de votre action.</p> <p>ATTENTION : d\u00e9bloquer des succ\u00e8s en utilisant des m\u00e9thodes non support\u00e9es par l'\u00e9mulateur entra\u00eene le basculement du compte dans les non class\u00e9s. Quand cela arrive, la seule solution pour revenir dans le classement global est de supprimer l'int\u00e9gralit\u00e9 des succ\u00e8s de votre compte. Il n'y aura pas ni recours ni exceptions.</p> <p>Si vous avez des preuves que vous avez jou\u00e9 sans tricher, envoyez un message \u00e0 RAdmin, mais gardez \u00e0 l'esprit que l'\u00e9quipe RA sont tous volontaires et que cela peut prendre du temps pour que votre situation soit \u00e9tudi\u00e9e.</p> <p>Si vous voulez aller de l'avant et admettre d'avoir trich\u00e9, un tel comportement sera grandement appr\u00e9ci\u00e9 et nous en tiendrons compte pour la d\u00e9cision.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#besoin-daide","title":"Besoin d'aide","text":"<p>Si vous avez des questions, un commentaire, des suggestions n'h\u00e9sitez pas \u00e0 contacter RAdmin ou l'\u00e9quipe RA (@mods and @admins) sur notre serveur Discord.</p> <p>Ces r\u00e8gles seront modifi\u00e9es \u00e0 l'occasion quand le besoin s'en fera sentir.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules-fr-%5BIn-progress%5D/#remerciements-speciaux","title":"Remerciements sp\u00e9ciaux","text":"<p>Ce document est fortement inspir\u00e9 de 100Pals Unified Achievement Hunting Rules. Cette version a \u00e9t\u00e9 adapt\u00e9e au contenu de RetroAchievements.</p> <p>100Pals est une communaut\u00e9 de chasseurs de succ\u00e8s exp\u00e9riment\u00e9s qui existe depuis la sortie des premiers succ\u00e8s sur Steam en 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/","title":"Global Leaderboard and Achievement Hunting Rules","text":""},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#tldr-golden-rules","title":"TL;DR - Golden Rules","text":"<p>Participants of the Global Leaderboard are required to earn their achievements fairly and legitimately.</p> <p>In general, a player must unlock achievements: - Uusing the latest release version of an approved supported emulator; - Inside of a game by in-game actions; - By their own control; - Without outside-modifying game files or game code; - Without using another player\u2019s save files or passwords, and; - Without using outside cheat programs.</p> <p>These rules are designed to keep players honest in their gameplay and honest towards each other in Global Leaderboard competition.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#table-of-contents","title":"Table of Contents","text":"<ul> <li>Global Leaderboard</li> <li>Hardcore vs Softcore</li> <li>Untracked</li> <li>Not Allowed</li> <li>Allowed</li> <li>Special Thanks</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#global-leaderboard","title":"Global Leaderboard","text":"<p>The RetroAchievements global leaderboard is the main official community competition. This includes a unique site rank based on the sum of achievement points earned in comparison with every other ranked player. Each account with points greater than 0 is ranked by default.</p> <p>What is considered fair and legitimate play versus unfair (cheating) on the global leaderboard has been shaped continually by the community since it's inception. The rules below are what we expect from every player who would like to participate in the ranking system. Any indication of a player's failure to follow the rules herein may lose use of the global leaderboard, also known as Untracked status.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#hardcore-vs-softcore","title":"Hardcore vs Softcore","text":"<p>There are two modes of play: Hardcore and Softcore. - Hardcore mode is a feature where the emulator disables save state loading, rewind and slow motion. The fast-forward feature is the only accepted exception. Users who take the global leaderboard seriously will most likely earn achievements in hardcore. Also, events will almost always require achievements to be earned in Hardcore.   - Note: Creating save states is allowed in hardcore and can be done to help practice an area later on in softcore, or help developers resolve tickets. - Softcore mode allows for emulator features such as save states, rewind, slow motion, emulator cheats, etc. This mode is much less competitive and is geared toward players who just want to do their own thing. This mode can be somewhat problematic when it comes to achievement processing; therefore, error reports are often taken with a grain of salt.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#untracked","title":"Untracked","text":"<p>Users who have the Untracked status are omitted from all rankings. Their activity is hidden from view outside of their user page and their unlocks do not affect achievement statistics. This status is for users who share their accounts, have zero interest in hardcore and softcore rankings, are suspected of cheating, or actually are cheating. Untracked users can still earn achievements how they normally would, obtain mastery badges, etc. </p> <p>Voluntary untracks can be reversed by resetting all progress and contacting RAdmin.</p> <p>Involuntary untracks are generally the result of being flagged for suspicious timestamps. If your account becomes untracked, you can contact RAdmin to find out the cause and how to get it reversed.</p> <p>If you notice a player has become untracked: do not harass them, accuse them of cheating, make a public scene, etc. Do not ask moderators or admin why a user was untracked. It is none of your business.</p> <p>WARNING: Unlocking achievements using methods outside supported emulators results in having your account set as untracked. When this happens, the only way to be on the global leaderboard again is by doing a full reset of all achievements on your profile. There are no exceptions and no appeals. Severe cases of this can also result in a ban.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#not-allowed","title":"Not Allowed","text":"<ol> <li>Do not use methods that circumvent achievement code to instantly unlock achievements.</li> <li>Do not earn achievements in a way that contradicts what the description asks.</li> <li>Do not use save files or passwords that are not your own or were made by under other conditions of play.</li> <li>Do not modify the game's file(s) or memory by any means.</li> <li>Do not use game files or programs known as \"trainers\".</li> <li>Do not use TAS (tool-assisted speedrunning), bots, or complex scripting to gain achievements.</li> <li>Do not allow other people to access your account and earn achievements for you.</li> <li>Do not be abusive to developers.</li> <li>Do not create or share cheating methods.</li> <li>Do not use in-game cheat codes unless it is specified as allowed by the developer.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#1-do-not-use-methods-that-circumvent-achievement-code-to-instantly-unlock-achievements","title":"1. Do not use methods that circumvent achievement code to instantly unlock achievements.","text":"<p>Even if you \"should have\" unlocked the achievement. Even if the game is bugged. Even if the achievement is removed or broken entirely. When it's detected, it will lead the account to be Untracked.</p> <p>In the cases where you should have unlocked the achievement but it didn't trigger or it didn't get registered in the site due to a network problem, you should follow the steps described in FAQ to request a manual unlock.</p> <p>NOTE: make sure you are using the latest release version of an approved supported emulator.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#2-do-not-earn-achievements-in-a-way-that-contradicts-what-the-description-asks","title":"2. Do not earn achievements in a way that contradicts what the description asks.","text":"<p>If you discover a back-door to an achievement, it is a bug. Please report this bug using a ticket report.</p> <p>See also the allowed rule 2.</p> <p>Examples: </p> <ul> <li>You unlock achievements for finishing levels via a level select cheat code; it's a bug and must be reported/fixed.</li> <li>You notice that if you go back and forth between two rooms, you unlock achievements intended for progressing though the game.</li> <li>You've found a method of earning damageless boss achievements while taking damage during the fights.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#3-do-not-use-save-files-or-passwords-that-are-not-your-own-or-were-made-under-other-conditions-of-play","title":"3. Do not use save files or passwords that are not your own or were made under other conditions of play.","text":"<p>Occasionally a developer might provide a save file or password for you to use to earn certain achievements. This is appropriate according to the judgement of the set developer.</p> <p>Examples:</p> <ul> <li>Downloading a clicker game save online.</li> <li>Begging a friend to send you his save file because your house burned down and you lost all your PC files.</li> <li>Loading a save file for Hardcore you created while playing on a non-RA emulator.</li> <li>Loading a save file for Hardcore you created in Softcore in order to gain Hardcore points.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#4-do-not-modify-the-games-files-or-memory-by-any-means","title":"4. Do not modify the game's file(s) or memory by any means.","text":"<p>Examples:</p> <ul> <li>Opening up specific game files with a text/hex editor and changing values to what you want; editing properties such as \"read-only\" for game files; etc. </li> <li>Editing the stats or unlocks in a game, and then saving the data.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#5-do-not-use-game-files-or-programs-known-as-trainers","title":"5. Do not use game files or programs known as \"trainers\".","text":"<p>Programs which can boost your powers in games, unlock debug modes, speed the game up, modify game code, etc.</p> <p>Examples:</p> <ul> <li>Using a trainer program for anything.</li> <li>Using trained ROMs for any game (they will not be linked).</li> <li>Using unofficial/old mods/emulators that act as trainers or debug/cheat toolsets.</li> <li>Game Genie / Action Replay and other similar cheat tools.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#6-do-not-use-tas-tool-assisted-speedrunning-bots-or-complex-scripting-to-gain-achievements","title":"6. Do not use TAS (tool-assisted speedrunning), bots, or complex scripting to gain achievements.","text":"<p>These are all advanced scripting of a game far beyond simple tasks (sometimes even synced to clockspeed) to allow complex, unique, and/or non-monotonous/non-repetitive sections of a game to be played without human interaction.</p> <p>Examples:</p> <ul> <li>using a TAS to complete a difficult speedrun or no-death achievement.</li> <li>using a complex script with advanced functionality.</li> <li>using complex scripts that complete entire games or large portions of games with no human input but requiring many unique actions.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#7-do-not-allow-other-users-to-access-your-account-and-earn-achievements-for-you","title":"7. Do not allow other users to access your account and earn achievements for you.","text":"<p>Including your \"little brother\" or your \"cousin\". You must earn your achievements yourself. Letting people earn achievements on your account is not allowed in general and if anyone cheats or breaks the rules on your account, you will still be held accountable.</p> <p>Examples:</p> <ul> <li>Having a friend who is more skilled at a game complete a difficult section for you in a single-player game.</li> <li>Letting someone log into your RA account to beat a difficult part of a game for you.</li> <li>Letting your little brother work on a grindy achievement for you.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#8-do-not-be-abusive-to-developers","title":"8. Do not be abusive to developers","text":"<p>Via forums, PMs, discord, email, etc. You\u2019re allowed to complain, ask for changes, leave negative reviews/comments and other such respectful criticisms, but you give all of us in the achievement hunting community a really bad name when you harass/attack developers because of what they did to their game\u2019s achievements.</p> <p>Examples: Issuing threats or flagrant insults to devs because they added achievements to their game that you do not like; using extreme/excessive rudeness while demanding a developer remove or change achievements; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#9-do-not-create-or-share-cheating-methods","title":"9. Do not create or share cheating methods.","text":"<p>Examples:</p> <ul> <li>Teaching someone how to use memory hacking tools.</li> <li>Posting on the forums to promote an egregious game file edit method.</li> <li>Sending someone a link to memory hacking tools or trainer programs.</li> <li>Teaching someone how to hide cheating.</li> <li>Creating a non-allowed complex script and sharing it around, even if you never use it yourself.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#10-do-not-use-in-game-cheat-codes-unless-it-is-specified-as-allowed-by-the-developer","title":"10. Do not use in-game cheat codes unless it is specified as allowed by the developer.","text":"<p>The other side of the coin for allowed 2. Cheat codes and debug modes are not allowed unless the developer has made note of which and when it is allowed. Even if the achievements are earnable with cheat codes, this is usually unintended behavior, considered cheating if done intentionally, and should be reported as a bug via the ticket system.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#allowed","title":"Allowed","text":"<ol> <li>Fast-forward is allowed.</li> <li>When explicitly said in achievement's description, in-game cheat codes/modes and in-game debug tools are allowed.</li> <li>Making use of in-game glitches, in-game exploits, and \"cheesy\" tactics are allowed.</li> <li>Using online guides/walkthroughs is allowed.</li> <li>Playing co-op/competitive games with another player or players is allowed.</li> <li>Turbo is allowed.</li> </ol>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#1-fast-forward-is-allowed","title":"1. Fast-forward is allowed.","text":"<p>Even in hardcore mode fast-forward is allowed, as a modern convenience. It's almost a consensus that fast-forward offers no risk to the fairplay and then it's available for everyone to use it.</p> <p>NOTE: in softcore mode savestates, rewind and slow motion are also allowed, but expect to have some issues. Read in this link Why you shouldn't use the load state feature.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#2-when-explicitly-said-in-achievements-description-in-game-cheat-codesmodes-and-in-game-debug-tools-are-allowed","title":"2. When explicitly said in achievement's description, in-game cheat codes/modes and in-game debug tools are allowed.","text":"<p>This is a complement to the not allowed rule 2.</p> <p>The achievement developers are instructed to protect their work so the achievements can't be unlocked easily by simply using a cheat code. However, some cool and fun challenges can be created taking advantage of some cheats. In these specific cases, using in-game cheats are allowed.</p> <p>NOTE: if you find achievements unlockable by using in-game cheats with no pertinent description, consider opening a ticket and reporting it.</p> <p>Examples:</p> <ul> <li>In Tetris (Game Boy) you should activate the speed cheat to earn the Challenge of the Gods achievement, where you have to clear 20 lines on speed 19.</li> <li>In Guerrilla War (NES) you're allowed to use the \"level and difficulty select screen\" cheat to earn the achievements where you have to beat the stages without killing any hostages.</li> </ul>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#3-making-use-of-in-game-glitches-in-game-exploits-and-cheesy-tactics-are-allowed","title":"3. Making use of in-game glitches, in-game exploits, and \"cheesy\" tactics are allowed.","text":"<p>In-game glitches/exploits/cheesy tactics are allowed, however developers can code their achievements to disallow them programatically. It's usually mentioned in the achievement's description.</p> <p>This does not include when there are flaws in the achievement developer's code. In such cases, please create a ticket report, and earn the achievement as intended by the developer. See also not allowed rule 2.</p> <p>Examples:</p> <ul> <li>Breaking out out of normal bounds to avoid enemies.</li> <li>Doing something strange inside of a game to \"bug a game out\" so you become invincible.</li> <li>Accessing powerful items earlier than intended.</li> <li>Standing somewhere enemies can\u2019t hit you.</li> </ul> <p>Examples where developers disallow it: Megaman (NES) - beat bosses damageless without using the pause glitch.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#4-using-online-guideswalkthroughs-is-allowed","title":"4. Using online guides/walkthroughs is allowed.","text":"<p>Examples: youtube video guides; GameFAQs; puzzle solutions; collectible lists; etc.</p> <p>A note on honesty: Using solvers for sudoku/picross is considered cheating. Unenforceable tolerated cheating but cheating nonetheless.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#5-playing-co-opcompetitive-games-with-another-player-or-players-is-allowed","title":"5. Playing co-op/competitive games with another player or players is allowed.","text":"<p>Playing co-op is allowed, however developers can code their achievements to disallow it programatically. It's usually mentioned in the achievement's description.</p> <p>See also not allowed rule 2.</p> <p>Examples: a skilled friend playing Streets of Rage or Goof Troop with you; etc.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#6-turbo-is-allowed","title":"6. Turbo is allowed.","text":"<p>Turbo is where you hold a single button down and the button is automatically re-pressed again and again quickly. Turbo is either built into controllers, or into emulation software. In either case it is allowed.</p> <p>In cases where there is any more complex scripting than repeating the same button in quick succession, this is not allowed. See Not allowed 6.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#special-thanks","title":"Special Thanks","text":"<p>This document is heavily based on the 100Pals Unified Achievement Hunting Rules. This version is trimmed down and tailored with topics that are relevant to the RetroAchievements context.</p> <p>The 100Pals is a community with experienced achievement hunters that exist since achievements were first released on Steam in 2007.</p>"},{"location":"Global-Leaderboard-and-Achievement-Hunting-Rules/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-11 21:04] The Mystical One:</code> Updated notes about save states in hardcore to clarify that creating save states is allowed.</li> <li><code>[2023-06-30 12:55] televandalist:</code> Updated Global Leaderboard and Achievement Hunting Rules (markdown)</li> <li><code>[2023-04-20 02:01] televandalist:</code> Removed \"high-ranking\" from \"If you notice a high-ranking player has become untracked:\" - doesn't matter what their rank is.</li> <li><code>[2023-04-20 01:39] televandalist:</code> Added \"Severe cases of this can also result in a ban.\" in the last paragraph of the Untracked section.</li> <li><code>[2023-04-20 01:37] televandalist:</code> Removed info about Hardcore being worth double. Replaced with a brief explanation of Hardcore vs Softcore. Expanded on info about Untracked users.</li> <li><code>[2022-05-14 23:42] Jendrej:</code> grammar</li> <li><code>[2022-03-09 15:34] StingX2:</code> \"Do not earn achievements in a way that is unintended by the achievement developer.\" into something along the lines of \"Do not earn achievements in a way that is opposite of what the description asks\" suggested by DanielARP</li> <li><code>[2021-05-15 23:11] meleu:</code> do not unlock achievements outside supported emulators</li> <li><code>[2021-04-26 13:29] meleu:</code> fix link</li> <li><code>[2020-02-07 00:49] televandalist:</code> Added an example to point 3 of \"Not Allowed\" to include loading saves in Hardcore that were created in Softcore.</li> </ul>"},{"location":"Glossary-of-Developer-Terms/","title":"Glossary of Developer Terms","text":"<p>This page is for terms used around RetroAchievements. Some of these are technical terms encountered when developing a set, and others are slang and jargon among users and players, like \"set\" and \"cheevo\".</p> <p>This page is still a work-in-progress. Please add definitions and fix errors as you see fit.</p>"},{"location":"Glossary-of-Developer-Terms/#16-bit","title":"16-bit","text":"<p>Processors that work on two byte word lengths. More bits usually mean more addressable memory for more complex games. Also used to describe the fourth generation of consoles, when 16-bit processors were common. A typical 16-bit processor includes the Motorola 68k series (Sega Genesis, Atari Jaguar (as one of its processors), early Macintosh).</p>"},{"location":"Glossary-of-Developer-Terms/#32-bit","title":"32-bit","text":"<p>Processors that work on four byte word lengths. More bits usually mean more addressable memory for more complex games. Also used to describe the fifth generation of consoles, where 32-bit processors were common. Processors this complex tend to be custom designed; 32-bit consoles include the PlayStation and the Sega Saturn.</p>"},{"location":"Glossary-of-Developer-Terms/#8-bit","title":"8-bit","text":"<p>Processors that work on one byte word lengths. Can also be used to describe the second or third generations of consoles, where 8-bit processors were common. Common 8-bit processors include the Z80 (many golden age arcade games, the Sega Master System and Game Gear, and the Game Boy) and the 6502 (Atari 2600, Apple II, NES).</p>"},{"location":"Glossary-of-Developer-Terms/#achievement","title":"achievement","text":"<p>A defined challenge in a game that rewards an RA user with points and an achievement badge when completed.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-id","title":"achievement ID","text":"<p>A unique number associated with an achievement. This can be seen in various places, most notably the end of the URL for the achievement page. The \"100% all goals, stats, and decks with Tony Hawk\" achievement for Tony Hawk's Pro Skater 3 on the PS2 has an achievement ID of 261676.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-editor","title":"achievement editor","text":""},{"location":"Glossary-of-Developer-Terms/#achievement-of-the-week-aotw","title":"Achievement of the Week (\"AOTW\")","text":"<p>A site event where a new achievement is selected weekly for an entire year, and users attempt to unlock ones for as many weeks as they can. Awards and a leaderboard for most unlocks are presented at the end of the year.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-of-the-month-aotm","title":"Achievement of the Month (\"AOTM\")","text":"<p>An addition to the Achievement of the Week event, featuring larger achievements that are presented once a month instead of once a week. AOTM points count towards the final AOTW leaderboard.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-page","title":"achievement page","text":"<p>A page on the site for a specific achievement, showing a list of people who have unlocked it, and a history of any tweaks in logic or status, and a wall for discussing the achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#achievement-processing-or-simply-processing","title":"achievement processing (or simply \"processing\")","text":""},{"location":"Glossary-of-Developer-Terms/#achievement-sets","title":"achievement sets","text":"<p>A collection of achievements that pertain to a specific game. </p>"},{"location":"Glossary-of-Developer-Terms/#addhits","title":"AddHits","text":""},{"location":"Glossary-of-Developer-Terms/#address","title":"address","text":""},{"location":"Glossary-of-Developer-Terms/#addsource","title":"AddSource","text":""},{"location":"Glossary-of-Developer-Terms/#admin","title":"admin","text":""},{"location":"Glossary-of-Developer-Terms/#alt-group","title":"alt group","text":""},{"location":"Glossary-of-Developer-Terms/#api","title":"API","text":""},{"location":"Glossary-of-Developer-Terms/#api-key","title":"API key","text":""},{"location":"Glossary-of-Developer-Terms/#author","title":"author","text":"<p>The original developer who published an achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#badge","title":"badge","text":"<p>The image associated with an achievement. It's square and is 64x64 at full size.</p>"},{"location":"Glossary-of-Developer-Terms/#binary","title":"binary","text":"<p>A way to notate numbers using entirely two states, on or off (colloquially 1's and 0's). While computers use binary, more commonly developers use hexadecimal to read the same information.</p>"},{"location":"Glossary-of-Developer-Terms/#big-endian-be","title":"big endian (\"BE\")","text":"<p>A type of endianness where the most significant digit in a word is stored in memory first. In other words, big endian stores the word forwards, as you'd read it on its own. Big endian consoles include the Sega Genesis and the Neo Geo.</p>"},{"location":"Glossary-of-Developer-Terms/#bit","title":"bit","text":"<p>The smallest discrete memory unit. Represented in binary. Rarely addressed directly on consoles.</p>"},{"location":"Glossary-of-Developer-Terms/#bonus-set","title":"\"bonus\" set","text":"<p>A subset for a game featuring additional, more difficult or more esoteric challenges. </p>"},{"location":"Glossary-of-Developer-Terms/#byte","title":"byte","text":"<p>A unit of memory with a length of eight bits. Often the smallest addressable unit of memory.</p>"},{"location":"Glossary-of-Developer-Terms/#cancel-leaderboard","title":"cancel (leaderboard)","text":""},{"location":"Glossary-of-Developer-Terms/#checksum","title":"checksum","text":""},{"location":"Glossary-of-Developer-Terms/#cheevo","title":"cheevo","text":"<p>Colloquial shorthand for \"achievement\".</p>"},{"location":"Glossary-of-Developer-Terms/#claim","title":"claim","text":"<p>When a developer declares their intent to work on a set for a game. Developers can only make a limited number of claims at a time. Unless it's a collaborative set, no other developer can work on that game while the claim is active.</p>"},{"location":"Glossary-of-Developer-Terms/#code-note","title":"code note","text":"<p>A chunk of memory annotated with its purpose for use in achievement developing, a memory location \"bookmark\" of sorts. Each game has a freely-accessible page of code notes associated with it.</p>"},{"location":"Glossary-of-Developer-Terms/#code-reviewer","title":"code reviewer","text":""},{"location":"Glossary-of-Developer-Terms/#commit-selected","title":"commit selected","text":""},{"location":"Glossary-of-Developer-Terms/#completion-trophy","title":"completion trophy","text":"<p>The award given to a user who has finished every achievement in a set in Softcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#core-achievement","title":"core achievement","text":"<p>An achievement that's part of the main set for a game and is able to be unlocked by most players.</p>"},{"location":"Glossary-of-Developer-Terms/#crc-32","title":"CRC-32","text":""},{"location":"Glossary-of-Developer-Terms/#the-cutting-room-floor-tcrf","title":"The Cutting Room Floor (\"TCRF\")","text":"<p>A website dedicated to unused content in games. This can be disabled features, hidden assets, localization changes, or materials in prototypes or prerelease media that changed by the time of the final release.</p>"},{"location":"Glossary-of-Developer-Terms/#demotion","title":"demotion","text":""},{"location":"Glossary-of-Developer-Terms/#decimal-dec","title":"decimal (\"dec\")","text":"<p>A way to notate numbers, using only 0-9 for ten possible values. Prevalent in everyday use, though less so in computing.</p>"},{"location":"Glossary-of-Developer-Terms/#developer-dev","title":"developer (\"dev\")","text":"<p>A user on RetroAchievements who digs into a game's behavior with the intent of creating achievements for it. Developers are also responsible for the upkeep of their sets, in case bugs are found.</p>"},{"location":"Glossary-of-Developer-Terms/#developing-achievements","title":"developing achievements","text":"<p>A process of setting various checks on memory locations that fire when a player completes a task in a game. Achievement logic can be very complex and achievements are reviewed and tested rigorously before sets are released.</p>"},{"location":"Glossary-of-Developer-Terms/#discord","title":"Discord","text":"<p>A chat platform commonly used by gaming communities, including RetroAchievements. Discord servers (or simply \"Discords\") often feature one or many text channels where users can post messages, images, and videos, and voice channels where users can stream video and audio.</p>"},{"location":"Glossary-of-Developer-Terms/#dynamic-link-library-dll","title":"dynamic link library (\"DLL\")","text":"<p>A file type common on Windows computers for sharing code and resources between programs. DLLs are used in the standalone RetroAchievements emulators for all the site-specific functionality, like logging in and listening for achievement logic.</p>"},{"location":"Glossary-of-Developer-Terms/#dynamic-memory","title":"dynamic memory","text":""},{"location":"Glossary-of-Developer-Terms/#endianness","title":"endianness","text":"<p>The order in which a series of bytes are stored in memory. Generally comes in two flavors, little endian and big endian. See those entries elsewhere in this document.</p>"},{"location":"Glossary-of-Developer-Terms/#event-set","title":"\"event\" set","text":""},{"location":"Glossary-of-Developer-Terms/#flag-achievement-field","title":"flag (achievement field)","text":""},{"location":"Glossary-of-Developer-Terms/#flag-memory","title":"flag (memory)","text":""},{"location":"Glossary-of-Developer-Terms/#forum","title":"forum","text":"<p>RetroAchievements has a forum that facilitates development of sets and communication between users and admins, as well as general banter.</p>"},{"location":"Glossary-of-Developer-Terms/#game-icon","title":"game icon","text":""},{"location":"Glossary-of-Developer-Terms/#game-entry-or-simply-entry","title":"game entry (or simply \"entry\")","text":""},{"location":"Glossary-of-Developer-Terms/#game-id","title":"game ID","text":"<p>A unique number associated with a game. This can be seen in various places, most notably the end of the URL for the game page. Vib-Ribbon for the PlayStation has a game ID of 8953.</p>"},{"location":"Glossary-of-Developer-Terms/#game-page","title":"game page","text":"<p>A page on the site for a specific game, listing the achievements for it, completion percentages, users who have mastered the game, leaderboards, and a wall for discussing the game and set, among other things.</p>"},{"location":"Glossary-of-Developer-Terms/#github","title":"GitHub","text":"<p>A website for publishing repositories of code for programs and websites. RetroAchievements uses GitHub to maintain its emulator projects, the website, and the site documentation.</p>"},{"location":"Glossary-of-Developer-Terms/#global-leaderboard","title":"global leaderboard","text":"<p>The ranking of all players on the site based on the number of Hardcore and Softcore points they have.</p>"},{"location":"Glossary-of-Developer-Terms/#hack-set","title":"\"hack\" set","text":"<p>A set developed for a ROM hack of a game.</p>"},{"location":"Glossary-of-Developer-Terms/#hardcore-mode","title":"Hardcore mode","text":"<p>A setting in RA-equipped emulators that disables save states and speed controls, effectively forcing the player to play like they would on the real console. When a player unlocks an achievement in Hardcore, they get double the points for it, and mastery trophies are awarded for unlocking all achievements in that set in Hardcore.</p>"},{"location":"Glossary-of-Developer-Terms/#hash","title":"hash","text":"<p>A string of data used to identify a specific version of a game. Hashes are used to ensure all players are using the same version, as differently-localized or earlier/later editions of a game can have differing memory locations that break achievement sets. For some consoles, the entire game image is hashed; for others, only a chunk of the image is hashed.</p>"},{"location":"Glossary-of-Developer-Terms/#hash-links-log","title":"#hash-links-log","text":""},{"location":"Glossary-of-Developer-Terms/#hexadecimal-hex","title":"hexadecimal (\"hex\")","text":"<p>A way to notate numbers using 0-9 and the letters A-F, providing 16 possible values. Universal in computing thanks to its compactness and 16 being a power of two (decimal notation only has 10 possible values, 10 not being a power of two).</p>"},{"location":"Glossary-of-Developer-Terms/#hits","title":"hits","text":""},{"location":"Glossary-of-Developer-Terms/#homebrew","title":"homebrew","text":"<p>Games and software developed for a console by hobbyists, as opposed to traditional game companies. Homebrew games tend to be adaptations of games for other platforms, though original homebrew certainly exists.</p>"},{"location":"Glossary-of-Developer-Terms/#homebrew-set","title":"\"homebrew\" set","text":""},{"location":"Glossary-of-Developer-Terms/#issue","title":"issue","text":""},{"location":"Glossary-of-Developer-Terms/#junior-developer","title":"junior developer","text":"<p>A new developer with certain extra restrictions on their account, like the number of games they can claim at once.</p>"},{"location":"Glossary-of-Developer-Terms/#json","title":"JSON","text":""},{"location":"Glossary-of-Developer-Terms/#leaderboard","title":"leaderboard","text":"<p>A ranking of players based on their scores, times, or another count (like the Tarzan leaderboard on Pitfall!, for the most vine swings without changing direction) on a game or on a particular stage of a game. Set developers have the option of creating as many leaderboards as they want for their game.</p>"},{"location":"Glossary-of-Developer-Terms/#little-endian-le","title":"little endian (\"LE\")","text":"<p>A type of endianness where the least significant digit in a word is stored in memory first. In other words, little endian stores the word backwards from how you'd read it on its own. Little endian consoles include the NES and the PlayStation.</p>"},{"location":"Glossary-of-Developer-Terms/#local-achievements","title":"local achievements","text":"<p>Achievements that only exist on the developer's computer and have not been pushed to unofficial or core achievement status.</p>"},{"location":"Glossary-of-Developer-Terms/#localization","title":"localization","text":"<p>The act of translating a game from one language to another. Localization is common as many games originate in Japan, and are played in Western countries where Japanese isn't often spoken.</p>"},{"location":"Glossary-of-Developer-Terms/#logic-comparison-or-simply-comparison","title":"logic comparison (or simply \"comparison\")","text":""},{"location":"Glossary-of-Developer-Terms/#lower4","title":"lower4","text":""},{"location":"Glossary-of-Developer-Terms/#md5","title":"MD5","text":"<p>A hashing algorithm. RetroAchievements uses this on its game hashes.</p>"},{"location":"Glossary-of-Developer-Terms/#mastery-trophy","title":"mastery trophy","text":"<p>The award given to a user who has finished every achievement in a set in Hardcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#memory","title":"memory","text":"<p>Usually refers to RAM, an address space that can be written to by the software at will and gets erased when the console is powered off. Most achievement development works by checking values in memory.</p>"},{"location":"Glossary-of-Developer-Terms/#memory-achievement-editor","title":"memory (achievement editor)","text":""},{"location":"Glossary-of-Developer-Terms/#memory-bookmarker","title":"memory bookmarker","text":""},{"location":"Glossary-of-Developer-Terms/#memory-inspector","title":"memory inspector","text":""},{"location":"Glossary-of-Developer-Terms/#memval","title":"mem/val","text":""},{"location":"Glossary-of-Developer-Terms/#multi-set","title":"\"multi\" set","text":""},{"location":"Glossary-of-Developer-Terms/#pauseif","title":"PauseIf","text":""},{"location":"Glossary-of-Developer-Terms/#pointers","title":"pointers","text":""},{"location":"Glossary-of-Developer-Terms/#points","title":"points","text":""},{"location":"Glossary-of-Developer-Terms/#prototype-set","title":"\"prototype\" set","text":"<p>A set for a game that was never finished or published, or theoretically, a set for a prototype of a game that's massively different from its final version, enough to make another set not redundant.</p>"},{"location":"Glossary-of-Developer-Terms/#promote-to-core","title":"promote to core","text":"<p>Making an achievement an official part of a set after development so players can attempt it.</p>"},{"location":"Glossary-of-Developer-Terms/#retroachievements-ra","title":"RetroAchievements (\"RA\")","text":"<p>A site for creating and unlocking achievements in older games, generally the mid-2000s and before. Players are ranked based on the number of points they accumulate for unlocking achievements.</p>"},{"location":"Glossary-of-Developer-Terms/#radocs","title":"RADocs","text":"<p>A set of documentation and instructions associated with the RetroAchievements platform.</p>"},{"location":"Glossary-of-Developer-Terms/#raemus","title":"RAEmus","text":"<p>Short for \"RetroAchievements emulators\", or standalone emulators equipped with RA functionality. This generally only applies to emulators that have been unofficially forked to add RA functionality, and not to all-in-one emulation frontends like RetroArch or BizHawk, or emulators where RA support is official like DuckStation and PCSX2.</p>"},{"location":"Glossary-of-Developer-Terms/#requirement","title":"requirement","text":""},{"location":"Glossary-of-Developer-Terms/#resetif","title":"ResetIf","text":"<p>flag</p>"},{"location":"Glossary-of-Developer-Terms/#reservation","title":"reservation","text":""},{"location":"Glossary-of-Developer-Terms/#retro-ratio","title":"retro ratio","text":"<p>A metric to gauge the relative difficulty of the achievements a player has unlocked. A higher retro ratio means the player has unlocked more uncommon (and presumably difficult) achievements. As of yet, the retro ratio is still not well-defined.</p>"},{"location":"Glossary-of-Developer-Terms/#retroarch","title":"RetroArch","text":"<p>An all-in-one emulator frontend for the Libretro project. RetroArch users install cores that each emulate a specific piece of hardware, allowing for the one program to run games from many systems. Has been ported to many, many consoles and operating systems. RetroArch is one of the main ways of playing RetroAchievements sets, due to many of the cores implementing RA functionality.</p>"},{"location":"Glossary-of-Developer-Terms/#revision","title":"revision","text":"<p>When a set is updated after its initial release to add, remove, or edit achievements, or to update point values.</p>"},{"location":"Glossary-of-Developer-Terms/#revision-voting","title":"revision voting","text":""},{"location":"Glossary-of-Developer-Terms/#rich-presence-script-rps","title":"rich presence script (\"RPS\")","text":"<p>A script that gives detailed information on-site about where a player is in a game, what items they've collected, who they're playing as, and other such data that updates while the player is playing.</p>"},{"location":"Glossary-of-Developer-Terms/#random-number-generator-rng","title":"random number generator (\"RNG\")","text":"<p>Code that generates a seemingly random number, used to make gameplay less predictable and more interesting (though occasionally more frustrating as well). RNG is very rarely truly random, usually taking a number like the game clock and using it as a \"seed\". Poorly implemented seeds can have their \"randomness\" manipulated by players who know how to.</p>"},{"location":"Glossary-of-Developer-Terms/#read-only-memory-rom","title":"read-only memory (\"ROM\")","text":"<p>Refers to an address space that can't be written to. This is usually where the game instructions and assets are stored. \"ROM\" also refers to a copy of the information on a game's ROM chips stored in a file, usually called an \"image\", for play on emulators or for use in hacking or datamining.</p>"},{"location":"Glossary-of-Developer-Terms/#rom-hack-or-simply-hack","title":"ROM hack (or simply \"hack\")","text":"<p>A fanmade modification of a game to add new content and features, often totally converting the game in the process. Usually applies to simpler games that were stored on ROM cartridges; more complex and newer games are simply \"modded\" instead.</p>"},{"location":"Glossary-of-Developer-Terms/#romhackingnet","title":"romhacking.net","text":"<p>A website that hosts guides and utilities for ROM hacking and game modding, as well as the ROM hacks themselves.</p>"},{"location":"Glossary-of-Developer-Terms/#set","title":"set","text":"<p>A group of achievements associated with a game. Sets are usually developed and maintained by one or two people each who inspect the game's memory, define achievements and what points they're worth, and respond to tickets on achievements not working as intended. Completing all achievements in a set awards a trophy, depending on if the achievements were unlocked in Hardcore or Softcore mode.</p>"},{"location":"Glossary-of-Developer-Terms/#set-cap","title":"set cap","text":"<p>The former limit on how many points are allowed in a set of achievements. This used to be 400, but there is currently no cap on points in sets.</p>"},{"location":"Glossary-of-Developer-Terms/#size-achievement-editor","title":"size (achievement editor)","text":""},{"location":"Glossary-of-Developer-Terms/#softcore-mode","title":"Softcore mode","text":"<p>Playing with Hardcore mode disabled, allowing for save states and speed controls. Softcore does not give the player double points for unlocking achievements like Hardcore does, and does not award mastery trophies (instead awarding completion trophies).</p>"},{"location":"Glossary-of-Developer-Terms/#stage-id","title":"stage ID","text":""},{"location":"Glossary-of-Developer-Terms/#start-leaderboard","title":"start (leaderboard)","text":"<p>To begin a run that's eligible for leaderboard ranking. A run will fail if it's not completed correctly (player death, restart, pause, or other developer-definable criteria).</p>"},{"location":"Glossary-of-Developer-Terms/#static-memory","title":"static memory","text":""},{"location":"Glossary-of-Developer-Terms/#submit-leaderboard","title":"submit (leaderboard)","text":"<p>To have a score or a time ranked on one of the leaderboards.</p>"},{"location":"Glossary-of-Developer-Terms/#subsource","title":"SubSource","text":""},{"location":"Glossary-of-Developer-Terms/#ticket","title":"ticket","text":""},{"location":"Glossary-of-Developer-Terms/#ticket-manager","title":"ticket manager","text":""},{"location":"Glossary-of-Developer-Terms/#trigger","title":"trigger","text":""},{"location":"Glossary-of-Developer-Terms/#trophy","title":"trophy","text":"<p>An award given to a player for completing a set or participating in a site event.</p>"},{"location":"Glossary-of-Developer-Terms/#type-memdeltavalue","title":"type (mem/delta/value)","text":""},{"location":"Glossary-of-Developer-Terms/#unofficial-achievement","title":"unofficial achievement","text":"<p>An achievement published on-site, but not part of the main set. This usually needs additional testing before it can become a core achievement.</p>"},{"location":"Glossary-of-Developer-Terms/#unlicensed-set","title":"\"unlicensed\" set","text":""},{"location":"Glossary-of-Developer-Terms/#unlock-in-reference-to-achievements-also-called-earning-achievements","title":"unlock (in reference to achievements, also called \"earning\" achievements)","text":"<p>Completing the steps needed to make an achievement fire. The achievement is then displayed on the user's page and elsewhere and they earn the points for having done so.</p>"},{"location":"Glossary-of-Developer-Terms/#upper4","title":"upper4","text":""},{"location":"Glossary-of-Developer-Terms/#user-motto","title":"user motto","text":"<p>A short, user-definable snippet of text on a user page. This is usually silly and in-jokey.</p>"},{"location":"Glossary-of-Developer-Terms/#user-page","title":"user page","text":"<p>The profile associated with a user on-site. This contains their account status (registered/junior developer/developer/moderator/etc), points accrued, completion percentage, trophies, the last five games the user was seen playing, and a wall for others to leave comments on, among other widgets.</p>"},{"location":"Glossary-of-Developer-Terms/#value","title":"value","text":""},{"location":"Glossary-of-Developer-Terms/#value-field-leaderboardrps","title":"value field (leaderboard/rps)","text":""},{"location":"Handling-Tickets/","title":"Handling Tickets","text":""},{"location":"Handling-Tickets/#handling-your-own-tickets","title":"Handling Your Own Tickets","text":"<p>After you've published your achievements, be prepared for bug reports. You're expected to keep your work bug free by appropriately resolving tickets. Respond to all tickets as soon as possible. The sooner you respond the better, because the problem is fresh in the player's mind and you can use them to help you to resolve the problem.</p>"},{"location":"Handling-Tickets/#can-i-claim-a-set-if-i-have-an-open-ticket","title":"Can I Claim a Set If I Have an Open Ticket?","text":"<p>To be allowed to make a primary or collaboration claim on a set, you must not have any unaddressed tickets.</p> <ul> <li>An open ticket is considered addressed when a developer, who may be unable to immediately resolve an issue, leaves a comment requesting a save file, state or additional information from the reporter.</li> <li>Tickets that have been properly closed or resolved are, of course, considered addressed.</li> </ul>"},{"location":"Handling-Tickets/#steps-to-resolve-tickets","title":"Steps to Resolve Tickets","text":"<ol> <li>Do your due diligence to investigate the cause of the issue.</li> <li>Ask detailed questions from the reporter to narrow down possible causes if the initial report is lacking in detail.</li> <li>If not provided, or if a provided save state is not at a point helpful to diagnose the issue, ask for one or more save states. Be clear about where in the game the saves should be made. Help the user know what to capture.</li> <li>Attempt to reproduce the issue on the same core used by the user.     * You may need to edit <code>cores.json</code> in RALibretro to remove the <code>\"platforms\": \"none\"</code> line from a core\u2019s definition in order to download  and use the core.</li> <li>If resolving a ticket for another developer\u2019s achievement, make a backup of the old logic and leave it in a comment on the ticket. That way if your fix has a further issue, you or another developer will be able to reference the previous logic.</li> <li>When you have found the issue, develop and test your changes.<ul> <li>Note: For achievements that triggered at the wrong time make sure you test that your changes work to resolve the false trigger and that they still work to trigger the achievement in the correct method.</li> </ul> </li> <li>Leave a summary of what you did to fix the ticket. If possible, explain why the issue occurred, what fixed it, and why the fix works.</li> </ol>"},{"location":"Handling-Tickets/#steps-to-close-tickets","title":"Steps to Close Tickets","text":"<ol> <li>Perform due diligence in attempting to reproduce the problem.</li> <li>Do not close tickets without leaving a comment about why closing the ticket is the correct action.</li> <li>Close with the most appropriate reason<ul> <li>Unable to Reproduce should be done only after gathering as much information about the context of the ticket as possible, attempting to reproduce it on the core by approaching the triggering conditions as many ways as you can, and still being unable to reproduce the results.</li> <li>Not Enough Information should be done only after attempting to reproduce the issue as much as possible, but without further information from the reporter are unable to come up with the same result.<ul> <li>Give several days for new information to be given before closing in this fashion.</li> </ul> </li> <li>Network Problems should be the close reason if it becomes clear that the issue was caused by the user not having a connection to the server.</li> <li>A Mistaken Report should be used only if it becomes clear that the user did not perform the correct actions to unlock the ticket or reported a ticket for non-ticketable reasons.</li> <li>Other Reason can be used if some other reason for closing a ticket exists. Be sure to properly justify the closure in a ticket comment.</li> </ul> </li> </ol>"},{"location":"Handling-Tickets/#handling-tickets-for-other-developers","title":"Handling Tickets for Other Developers","text":"<p>You may resolve tickets for another developer under the following guidelines:</p>"},{"location":"Handling-Tickets/#if-the-developer-is-active","title":"If the Developer is Active","text":"<p>You may assist them in the resolution. The developer should still implement any code changes needed, but you are allowed to suggest logic and help find the causes.</p>"},{"location":"Handling-Tickets/#if-the-developer-is-inactive","title":"If the Developer is Inactive","text":"<p>You can work on their tickets on your own.</p> <ul> <li>An inactive developer is someone who has 10 or more open tickets that are older than two months (you can see their open tickets from the Ticket Manager).<ul> <li>Contact a Developer Compliance team member to ensure this is the case before making the judgement on your own if they still have the Developer role.</li> </ul> </li> <li>If the developer is inactive, you can freely resolve their tickets through normal resolution processes as stated above.</li> <li>You may change the achievement description to clarify the objective or to match the logic that is present to clarify the intent of the achievement. Do not deviate from an achievement's concept or objective in any way without an approved revision vote.</li> <li>Follow the steps to resolve or close a ticket as if it were your own.</li> </ul>"},{"location":"Handling-Tickets/#claiming-a-ticket","title":"Claiming a Ticket","text":"<p>You may place a soft claim on ticket investigation and resolution by commenting your intent in a ticket comment.</p> <ul> <li>If someone else has stated their intent to resolve a ticket, you may provide additional insight in a ticket comment.</li> <li>The developer working on a ticket may choose to work with another developer or user for assistance in resolving the ticket.</li> <li>After seven days without action towards a resolution, the ticket will be considered unclaimed, to allow other developers to provide a solution.</li> </ul>"},{"location":"Handling-Tickets/#if-a-developer-becomes-active-again","title":"If a Developer Becomes Active Again","text":"<p>Who handles tickets for achievements edited while the developer is Inactive?</p> <p>If an inactive developer becomes active again, they are still responsible for their achievements that have been fixed by other developers.</p> <ul> <li>It is strongly recommended that the newly active dev review any tickets that were resolved during their inactivity period so they can understand the changes made to their achievements.</li> <li>If necessary, reach out to the developer who made the updates that resolved the tickets.</li> <li>If the newly active developer no longer wants to be the owner of the achievements, they can reach out to the Developer Compliance team to inquire about a reauthor of said achievements.<ul> <li>Note that an accepted reauthor will be handled on a case-by-case basis, depending on the developers in question as well as the changes made to the achievements. This rule will be reevaluated if the implementation of a set or achievement maintainer is introduced.</li> </ul> </li> </ul>"},{"location":"Handling-Tickets/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:11] Andrew Comer:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-03-11 14:08] Andrew Comer:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-03-11 14:03] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:57] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-01-14 10:07] The Mystical One:</code> Cleaned up the \"Handling Tickets for Other Developers\" section so it flows better.</li> <li><code>[2024-01-14 08:31] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-14 08:27] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 23:04] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 23:03] The Mystical One:</code> Updated Handling Tickets (markdown)</li> <li><code>[2024-01-13 22:57] The Mystical One:</code> Updated Handling Tickets (markdown)</li> </ul>"},{"location":"Hash-Labels/","title":"Hash Labels","text":"<p>Every ROM that is linked to an achievement set should be clearly identified and labeled. These labels help players know which versions of a game are compatible as well as if there are any translation patches, bug fixes, cosmetic hacks, quality of life hacks, etc. that they can use. </p>"},{"location":"Hash-Labels/#info-for-linked-hashes","title":"Info for Linked Hashes","text":"<ul> <li>RA Hash: Check Game Identification to learn more about these. These appear in <code>Manage Hashes</code> automatically.</li> <li>Filename - Filename should be entered as the description. These are typically automatic, but may need some adjustments.</li> <li>Labels - You can use the labels listed below by using the filename of the image (no extension).</li> </ul>"},{"location":"Hash-Labels/#images","title":"Images","text":"Image Label to Use Note <code>main</code> Sometimes used to show the primary ROM used by the set developer(s) <code>rapatches</code> Used when the hash requires a patch hosted on RAPatches <code>nointro</code> The most common for cartridge-based games <code>redump</code> The most common for disc-based games <code>wozaday</code> Apple II preservation group <code>tosec</code> <code>fbneo</code> Mostly used for Arcade <code>cleancpc</code> Amstrad preservation project <code>4amcrack</code> Used for Apple II <code>neokobe</code> Mostly for PC-8001 and PC-8801 <code>homebrew</code> Used for, you guessed it: Homebrews! <code>atariage</code> Popular site for Homebrews <code>itchio</code> Popular site for Homebrews <code>msu1</code> Used to mark SNES ROMs with MSU-1 patches <code>snesmini</code> <code>egg</code> ROMs purchased from Project Egg, typically Japanese PC games. <code>steam</code> ROMs purchased from Steam. <code>mamesl</code> MAME Software List <code>smwcentral</code> Popular repository for Super Mario World hacks. <code>rhdn</code> Popular repository for ROM hacks <code>goodtools</code> <code>nongood</code> <code>offlinelist</code>"},{"location":"Hash-Labels/#examples","title":"Examples","text":""},{"location":"Hash-Labels/#deja-vu-nes","title":"Deja Vu (NES)","text":"<ul> <li>The first hash is the USA version of the game with an Uncensored patch applied to it. The full text of the description is <code>Deja Vu (USA) (Uncensored) (v1.0) (usertheloset).nes</code>, which follows the RAPatches naming scheme. The labels used are <code>nointro</code> and <code>rapatches</code>.</li> <li>The second hash is the No Intro-verified USA version of the game.</li> <li>The third hash is the No Intro-verified Japanese version of the game.</li> </ul> <p>To see how this will look for the majority of users, go to the game entry page and click on \"Linked Hashes.\"</p> <p></p> <p>As you can see below, <code>nointro</code> became  and <code>rapatches</code> became .</p> <p></p>"},{"location":"Hash-Labels/#suikoden-playstation","title":"Suikoden (PlayStation)","text":"<p>We'll skip the manage hashes example for this one. Let's go straight to \"Linked Hashes\" on the game entry page:</p> <p></p> <p>The hashes labeled with <code>redump</code>, <code>rhdn</code>, and <code>rapatches</code> require patches that are available on both romhacking.net and in the RAPatches repository.</p> <p></p>"},{"location":"Hash-Labels/#linking-to-patches","title":"Linking to Patches","text":"<ul> <li>The first post of a game's forum topic is the best place to include links to patches required.</li> <li>These do not need to follow a specific format, but the information must be clear.</li> <li>Here is one example of how to format the text in the forum: </li> </ul> <p>Input Text:</p> <pre><code>[b]Suikoden (Europe) (De) (v1.01) (Twisted Phoenix Game Translation)[/b]\n[b]Suikoden (Europe) + [url=https://www.romhacking.net/translations/5736/]German Patch[/url][/b] [img=Images/labels/rhdn.png]\nor\n[b]Suikoden (Europe) + [url=https://github.com/RetroAchievements/RAPatches/raw/main/PS1/Translation/German/11255-Suikoden-GermanTranslation.7z]German Patch[/url][/b] [img=Images/labels/rapatches.png]\n[i]RA Checksum: [/i]f0c5ec0696aa2ec2d6e5b731fbe07491\n</code></pre> <p></p> <ul> <li>A second example: Input Text:</li> </ul> <pre><code>[img=Images/labels/rapatches.png] [img=Images/labels/rhdn.png]\nDownload the patch from RHDN [url=https://www.romhacking.net/translations/5736/]here[/url].\nRAPatches Mirror [url=https://github.com/RetroAchievements/RAPatches/raw/main/PS1/Translation/German/11255-Suikoden-GermanTranslation.7z]here[/url].\n</code></pre> <p></p>"},{"location":"Hash-Labels/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-01 22:23] televandalist:</code> Updated Hash Labels (markdown)</li> <li><code>[2023-12-14 12:59] televandalist:</code> Updated Hash Labels (markdown)</li> <li><code>[2023-07-05 23:08] televandalist:</code> rndn -&gt; rhdn</li> <li><code>[2023-06-03 02:30] televandalist:</code> Updated WIP Hash Labels (markdown)</li> </ul>"},{"location":"Hit-Counts-es/","title":"Contador de Golpes (Hit Counts)","text":"<p>En el Editor de Logros (Achievement Editor), el campo de hasta la derecha es el Contador de Golpes (Hit Count). </p> <p>Por default es Cero, que significa que la condicion tiene que ser verdadera para qeu el logro se dispare.</p> <p>Si agregas un contador de golpes (hit count), por ejemplo 5, significa que la condicion tiene va a ser verdadera hasta que se cumplan esos fotogramas (frames), y no se necesitan volver a cumplir de nuevo en cualquier otro momento.</p> <p>PORFAVOR, NOTA: si una condicion tiene cero hit count, y llega al numero requirido, esta condicion ya no esta siendo buscada. Sigue permaneciendo como verdadera, ALMENOS que tengas un <code>ResetIf</code>, que discutiremos mas abajo.</p> <p>Condiciones con <code>Reset If</code> y <code>PauseIf</code> tambien pueden tener hits. Sigue los links para mas informacion.</p> <p>En la seccion de Ejemplos de Verdad hay dos buenos ejemplos:</p> <ul> <li>Utilizando Hit Counts como un Contador</li> <li>Utilizando Valores Delta y Hit Counts para detectar un Incremento</li> <li>Simple ejemplo de como evadir el abuso en Estados de Guardado (Load States)</li> </ul>"},{"location":"Hit-Counts-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:39] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Hit Counts ES (markdown)</li> </ul>"},{"location":"Hit-Counts/","title":"Hit Counts","text":"<p>In the Achievement Editor, the field on the far right side is Hit Count.</p> <p></p> <p>The default is Zero, which means the condition must be true for the achievement to trigger.</p> <p>If you set a target hit count, like 5, it means the condition must be true for at least that many frames, and once that hit count target is met, it doesn't need to be met again at any other time.</p> <p>PLEASE NOTE: if a condition has a non-zero hit count, and reaches the number required, this condition is no longer tested. It  remains true, UNLESS you have a <code>ResetIf</code>, which we will discuss below.</p> <p>Conditions with <code>Reset If</code> and <code>PauseIf</code> flags can also have hits. Follow the links for details.</p> <p>In the Real Examples section there are two examples good examples:</p> <ul> <li>Using Hit Counts as a Timer</li> <li>Using Delta Values and Hit Counts to Detect an Increment</li> </ul>"},{"location":"Hit-Counts/#effect-of-resetting-the-emulator","title":"Effect of Resetting the Emulator","text":"<p>When the emulator is reset, all hits are immediately zeroed out and the achievement is set back to Waiting. However, an emulator reset does not clear out memory, so it's possible for the hits to reaccumulate before the game reinitializes the memory. As such, you should not rely on the hits being cleared out by the emulator reset.</p> <p>Similarly, when the emulator first \"powers on\", the state of memory is not guaranteed to be consistent as true hardware does not initialize its memory. Instead, the software sets some initial state when it claims portions of memory. Some games actually rely on the random nature of the uninitialized memory to seed their random number generators.</p> <p>For both cases, you should have an explicit reset for some piece of knowable logic, like the player being on the title screen.</p>"},{"location":"Hit-Counts/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-07-27 19:31] Searo:</code> Page doesn't exist and we don't care what softcore users do anymore</li> <li><code>[2021-07-17 07:27] Jamiras:</code> Updated Hit Counts (markdown)</li> <li><code>[2021-07-17 07:27] Jamiras:</code> add section detailing behavior at reset/power on</li> <li><code>[2019-02-18 17:01] meleu:</code> fix broken links</li> <li><code>[2019-02-12 13:10] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:23] meleu:</code> Updated Hit Counts (markdown)</li> <li><code>[2019-02-12 09:21] meleu:</code> Created Hit Counts (markdown)</li> </ul>"},{"location":"Home-es/","title":"Introducci\u00f3n","text":""},{"location":"Home-es/#_1","title":"Introducci\u00f3n","text":"<p>Bienvenido a la Documentaci\u00f3n de RetroAchievements!</p> <p>Primero que nada, tienes que conocer el Manifiesto RetroAchievements y seguir el C\u00f3digo de Conducta del Usuario.</p> <p>Si estas buscando documentos sobre creaci\u00f3n de logros, checa nuestra secci\u00f3n de documentos para Desarrolladores.</p> <p>Animamos a todos los miembros de la comunidad a unirse a nuestro servidor de Discord, lo usamos para la mayor\u00eda de las comunicaciones.</p> <p>La lista completa de p\u00e1ginas se encuentran en la barra lateral, pero aqu\u00ed una breve descripci\u00f3n de algunas de ellas:</p> <ul> <li>FAQ: Preguntas Frecuentes (como cual n\u00facleo (Core) RetroArch deber\u00eda usar?).</li> </ul> <ul> <li>Tablas de Clasificaci\u00f3n Globales y Reglas para Obtener Logros: explica las reglas para las tablas globales, que es el estado No Rastreado (Untracked), que puede ser considerado como hacer trampa, etc.</li> </ul> <ul> <li>Descargas: nuestra p\u00e1gina de descargas alternativa.</li> </ul> <ul> <li>Juegos Gratuitos: juegos que son completamente legales descargar y jugar en emuladores.</li> </ul> <ul> <li>Mi juego no esta cargando logros: que hacer cuando tu juego no esta cargando logros.</li> </ul> <ul> <li>Porque no deber\u00edas de utilizar la opci\u00f3n de salvar estados (load state): porque deber\u00edas de esperar tener problemas si salvas/cargas estados mientras juegas.</li> </ul> <ul> <li>Un mensaje para los Cazadores de Logros y Completistas sobre las revisiones: porque no deber\u00edas de frustrarte cuando una revisi\u00f3n en un set de logros es publicada.</li> </ul> <ul> <li>Como contribuir si no eres un desarrollador: si no sabes como crear logros, hay muchas otras maneras para contribuir en la comunidad.</li> </ul> <p>Puedes ayudar a mejorar los documentos editando/creando paginas en la Wiki de RetroAchievements.</p>"},{"location":"Home-es/#traducciones","title":"Traducciones","text":"<ul> <li>English (original)</li> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"Home-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-18 08:01] meleu:</code> enlace para el Manifiesto</li> <li><code>[2019-04-17 13:49] meleu:</code> using partial URI</li> <li><code>[2019-04-17 09:04] ShinyNinetalesTM:</code> fixed punctuation in several words, fixed some typos and rewrited some phrases to emphatize context</li> <li><code>[2019-04-17 08:48] ShinyNinetalesTM:</code> fixed link to Download-es</li> <li><code>[2019-04-16 12:07] eldexterr:</code> fixed typos</li> <li><code>[2019-04-16 12:05] eldexterr:</code> Updated Home es (markdown)</li> <li><code>[2019-04-16 15:48] meleu:</code> original version</li> </ul>"},{"location":"Home-fr/","title":"Home fr","text":""},{"location":"Home-fr/#_1","title":"Home fr","text":"<p>Bienvenue sur la documentation de RetroAchievements!</p> <p>Dans un premier temps, vous devez lire et adh\u00e9rer au Code de conduite des utilisateurs. (en cours de traduction)</p> <p>Si vous cherchez de la documentation sur la cr\u00e9ation d'achievements, jetez un oeil \u00e0 la documentation pour d\u00e9veloppeurs. (en cours de traduction)</p> <p>Nous vous encourageons \u00e0 rejoindre notre serveur Discord, nous l'utilisons pour communiquer la plupart des informations.</p> <p>La liste compl\u00e8te des pages est disponible dans la barre lat\u00e9rale mais voici une rapide description : - FAQ: les questions fr\u00e9quemment pos\u00e9es (comme quelle version de RetroArch je devrais utiliser?). (en cours de traduction)</p> <ul> <li>R\u00e8gles des leaderboard globaux et Chasse aux achievements: explique les r\u00e8gles pour les leaderboards globaux, les param\u00e8tres traqu\u00e9s, ce qui est consid\u00e9r\u00e9 comme de la triche, etc... (en cours de traduction)</li> </ul> <ul> <li>T\u00e9l\u00e9chargements: notre page de t\u00e9l\u00e9chargement alternative. (en cours de traduction)</li> </ul> <ul> <li>Jeux gratuits: liste des jeux t\u00e9l\u00e9chargeables gratuitement et l\u00e9galement sur notre plateforme. (en cours de traduction)</li> </ul> <ul> <li>Mon jeu ne charge pas les achievements correctement: Que faire lorsque votre jeu ne charge pas ses achievements. (en cours de traduction)</li> </ul> <ul> <li>Pourquoi je ne dois pas utiliser les save/load states: les probl\u00e8mes que vous pouvez rencontrer en utilisant des save states. (en cours de traduction)</li> </ul> <ul> <li>Un message pour les compl\u00e9tionniste et les chasseurs d'achievements: pourquoi vous ne devez pas vous sentir frustr\u00e9 quand une r\u00e9vision est faite sur un set d'achievement. (en cours de traduction)</li> </ul> <ul> <li>Comment contribuer si vous n'\u00eates pas un d\u00e9veloppeur: si vous ne savez pas comment d\u00e9velopper des achievements, il y a plein d'autres moyen d'aider la communaut\u00e9. (en cours de traduction)</li> </ul> <p>Vous pouvez \u00e9diter/ajouter de la documentation sur le wiki de RetroAchievements.</p>"},{"location":"Home-fr/#translations","title":"Translations","text":"<ul> <li>Portuguese</li> <li>Spanish</li> <li>English</li> </ul>"},{"location":"Home-pt_BR/","title":"In\u00edcio","text":"<p>Bem-vindo ao Projeto de documenta\u00e7\u00e3o do Retroachievements!</p> <p>Rec\u00e9m chegados, por favor iniciem pelo Manifesto RetroAchievements e com o FAQ.</p> <p>N\u00f3s encorajamos todos os membros da comunidade a se juntar ao nosso Servidor do Discord, n\u00f3s usamos isto para maior comunica\u00e7\u00e3o.</p> <p>Voc\u00ea pode aprender como criar suas pr\u00f3prias conquistas lendo nossos Documentos para Desenvolvedores.</p> <p>Voc\u00ea pode ajudar a melhorar esses documentos editando/criando as p\u00e1ginas no RetroAchievements wiki.</p>"},{"location":"Home-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-22 07:52] meleu:</code> https</li> <li><code>[2020-09-10 01:43] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2020-09-10 01:04] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2019-02-10 16:01] meleu:</code> remove broken link</li> <li><code>[2018-06-10 10:44] lilbud:</code> Updated Discord Link</li> <li><code>[2018-03-25 10:14] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-25 11:56] KingDice001:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-25 11:42] KingDice001:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-24 23:38] meleu:</code> Updated Home pt_BR (markdown)</li> <li><code>[2018-03-24 18:36] KingDice001:</code> Updated Home pt_BR (markdown)</li> </ul>"},{"location":"Home-tr_TR/","title":"Home tr TR","text":"<p>RetroAchievements belgelerine ho\u015f geldiniz!</p> <p>Her \u015feyden \u00f6nce, Kullan\u0131c\u0131 Davran\u0131\u015f Kurallar\u0131n\u0131 bilmeli ve bunlara uymal\u0131s\u0131n\u0131z.</p> <p>Ba\u015far\u0131 olu\u015fturma hakk\u0131nda dok\u00fcmanlar ar\u0131yorsan\u0131z, Geli\u015ftirici dok\u00fcmanlar\u0131 b\u00f6l\u00fcm\u00fcm\u00fcz\u00fc inceleyin.</p> <p>T\u00fcm topluluk \u00fcyelerini Discord Sunucumuza kat\u0131lmaya te\u015fvik ediyoruz, bunu \u00e7o\u011fu ileti\u015fim i\u00e7in kullan\u0131yoruz.</p> <p>Sayfalar\u0131n tam listesi kenar \u00e7ubu\u011fundad\u0131r, ancak bunlardan baz\u0131lar\u0131n\u0131n k\u0131sa bir a\u00e7\u0131klamas\u0131:</p> <ul> <li>SSS: S\u0131k\u00e7a Sorulan Sorular (hangi RetroArch Core'u kullanmal\u0131y\u0131m?).</li> </ul> <ul> <li>Global Liderlik ve Ba\u015far\u0131 Av Kurallar\u0131: Global Liderlik i\u00e7in kurallar, \u0130zlenmeyen durum nedir, aldatma say\u0131labilir, vb.</li> </ul> <ul> <li>\u0130ndirilenler: alternatif indirme sayfam\u0131z.</li> </ul> <ul> <li>\u00dccretsiz Oyunlar: tamamen ve yasal olarak \u00fccretsiz olan ve em\u00fclat\u00f6rlerine oynayaca\u011f\u0131n\u0131z oyunlar.</li> </ul> <ul> <li>Oyunum ba\u015far\u0131lar\u0131 y\u00fcklemiyor: oyununuz ba\u015far\u0131lar\u0131 y\u00fcklemiyorsa yapman\u0131z gerekenler.</li> </ul> <ul> <li>Y\u00fck durumu \u00f6zelli\u011fini neden kullanmamal\u0131s\u0131n\u0131z: oynat\u0131rken kaydetme / y\u00fckleme durumunu kullan\u0131yorsan\u0131z neden sorun ya\u015faman\u0131z\u0131 beklemelisiniz.</li> </ul> <ul> <li>Ba\u015far\u0131 Avc\u0131lar\u0131 ve Tamamlay\u0131c\u0131lara revizyonlarla ilgili bir mesaj: bir ba\u015far\u0131 setinde bir revizyon yap\u0131ld\u0131\u011f\u0131nda neden sinir bozmaman\u0131z gerekti\u011fini.</li> </ul> <ul> <li>Bir geli\u015ftirici de\u011filseniz, nas\u0131l katk\u0131da bulunabilirsiniz: Ba\u015far\u0131lar\u0131n nas\u0131l geli\u015ftirilece\u011fini bilmiyorsan\u0131z, toplulu\u011fa katk\u0131da bulunman\u0131n bir\u00e7ok yolu vard\u0131r.</li> </ul> <p>Bu dok\u00fcmanlar\u0131 RetroAchievements wiki'de sayfalar\u0131 d\u00fczenleyerek / olu\u015ftururken daha iyi hale getirebilirsiniz.</p>"},{"location":"Home-tr_TR/#ceviriler","title":"\u00c7EV\u0130R\u0130LER","text":"<ul> <li>PORTEKIZCE</li> <li>ISPANYOLCA</li> </ul>"},{"location":"Home/","title":"Home","text":"<p>Welcome to the RetroAchievements documentation!</p> <p>The docs are currently under heavy construction so be sure to check back often! Each section appears in the sidebar, but here is a brief explanation of the categories:</p> <ul> <li>Guidelines: Details community, user/player, developer, and content policies.</li> <li>General: FAQ, getting started, support/troubleshooting, and other info that can be useful to all members of the community.</li> <li>Achievement Development: Extensive information on both the conceptual and technical aspects of making achievements.</li> </ul> <p>We encourage all community members to join our Discord Server; we use this for most communication.</p> <p>Translations</p> <ul> <li>Portuguese</li> <li>Spanish</li> </ul>"},{"location":"Home/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 14:29] televandalist:</code> Removed the RA logo from the top since the link was broken</li> <li><code>[2023-06-30 12:36] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-30 12:14] televandalist:</code> Updated Home (markdown)</li> <li><code>[2023-06-06 10:35] televandalist:</code> Fix broken link</li> <li><code>[2023-04-13 15:08] televandalist:</code> Removed the links to pages that deal with specific support questions. They should/will be merged with a support section or the FAQ to declutter the home page.</li> <li><code>[2023-04-13 14:51] televandalist:</code> Removed link to \"Free Games\" section. While they are free homebrews, the downloads are typically on site if they actually have a set. If they aren't, they should be.</li> <li><code>[2022-08-23 20:22] Jazerus:</code> grammar fixes</li> <li><code>[2022-02-18 21:24] televandalist:</code> Add Event page link</li> <li><code>[2021-04-21 10:23] meleu:</code> french docs are yet incomplete</li> <li><code>[2020-09-07 09:06] meleu:</code> add Manifesto</li> </ul>"},{"location":"How-RA-Documentation-Works-es/","title":"Como funciona la Documentaci\u00f3n de RA","text":"<p>Este proyecto de documentaci\u00f3n de RetroAchievements junta las gu\u00edas, tutoriales, tips y trucos sobre el desarrollo de RetroAchievements y cualquier otra informaci\u00f3n interesante para la comunidad.</p> <p>Antes de que se empezara este proyecto la informaci\u00f3n sobre el desarrollo de logros estaba esparcida en varios posts del foro en RetroAchievements.org, haciendo la experiencia de aprendizaje mas complicada para el desarrollador novato. Este proyecto comenz\u00f3 trayendo el material de los posts del foro hacia aqu\u00ed, pero en un orden mas ordenado y coherente.</p> <p>La Documentaci\u00f3n de RetroAchievements se divide en dos partes:</p> <ol> <li>Wiki de RetroAchievements</li> <li>Documentos de RetroAchievements</li> </ol> <p>La wiki es donde los documentos son creados y editados. Cualquiera (con una cuenta de github) es capaz de editar el contenido de la wiki. As\u00ed que, si tienes algo que compartir, por favor edita la wiki!</p> <p>El sitio web de los documentos de RetroAchievements tiene (la mayor\u00eda) el mismo contenido que la wiki, pero con un look mas placentero. El contenido de este sitio web es generado por sus moderadores utilizando el contenido de la wiki como su m\u00e9todo de entrada.</p> <p>Cuando un cambio es hecho en la wiki este cambio NO es instant\u00e1neamente reflejado en los documentos. La conversi\u00f3n es realizada por un moderador cada cierto tiempo.</p>"},{"location":"How-RA-Documentation-Works-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 14:02] eldexterr:</code> Created How RA Documentation Works es (markdown)</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/","title":"Como convertirme en un Desarrollador de Logros","text":"<p>Este documento describe todos los pasos que cualquier aspirante a desarrollador de logros tiene que seguir antes de conseguir estatus de Desarrollador. Estos requisitos tambi\u00e9n son una lista para los Rese\u00f1adores de C\u00f3digo (desarrolladores que inspeccionan el c\u00f3digo de nuevos desarrolladores).</p> <p>Cualquiera puede convertirse en un desarrollador en RetroAchievements si pone el suficiente esfuerzo.</p> <p>Opcional pero fuertemente recomendado: \u00fanete a nuestro servidor de Discord y pregunta a un moderador darte el rol de <code>jr-dev</code>. Utiliza los canales #help-me y #devs cada vez que cuentes con alguna pregunta.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#conocimiento-requerido","title":"Conocimiento requerido","text":"<p>Cada desarrollador tiene que m\u00ednimo conocer los conceptos b\u00e1sicos y t\u00e9cnicas mostradas en estos dos documentos:</p> <ol> <li>Empezando como un desarrollador de logros</li> <li>Caracteristicas en la l\u00f3gica de un logro</li> </ol> <p>Cualquier aspirante a desarrollador tiene que demostrar seguir y entender los siguientes conceptos:</p> <ul> <li>B\u00fasqueda B\u00e1sica en la RAM (que se te familiarice el Inspector de Memoria)</li> <li>Notaciones Hexadecimales</li> <li>Valores Delta</li> <li>Hit counts</li> <li>Pause If</li> <li>Reset If</li> <li>Alt Groups</li> <li>Tama\u00f1o de la Memoria: 8-bit y single bit</li> <li>Comparadores en la logica de los Logros mas all\u00e1 de <code>=</code>, por ejemplo <code>&gt;</code>, <code>&lt;</code>, <code>!=</code></li> <li>A\u00f1adir badges/medallas a un logro</li> <li>Crear descripciones certeras en los logros</li> <li>A\u00f1adir las protecciones adecuadas</li> <li>Hacer un set de logros estable</li> </ul> <p>Nota: Tu no necesitas el dominio total de todos estos conceptos para tener un set publicado, pero si los necesitas para obtener un rol como desarrollador completo.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#conceptos-avanzados","title":"Conceptos Avanzados","text":"<p>Aqu\u00ed hay una lista de algunos conceptos/t\u00e9cnicas. No son requisito para convertirte en un Desarrollador, pero est\u00e1n en listadas aqu\u00ed para mostrar al desarrollador jr. (jr-dev) las posibilidades de la l\u00f3gica de los logros.</p> <ul> <li>Hit count como un temporizador (como en este ejemplo y este otro)</li> <li>ResetIf Checkpoints</li> <li>ResetIf con Hitcount</li> <li>PauseIf con Hitcount</li> <li>Las banderas AddSource y SubSource</li> <li>Bandera AddHits</li> <li>Incrementar contador (<code>Valor en Memoria &gt; Valor Delta</code> Contador)</li> <li>Contador de Hits Delta, t\u00e9cnica de pausado</li> <li>Little endianness</li> <li>Tama\u00f1o de Memoria: Lower4, Upper4, y 16-bit, 32-bit</li> <li>Rich Presence din\u00e1mico</li> <li>Tablas de Clasificaci\u00f3n</li> <li>Resets pausables</li> <li>Contador en el incremento de un SubSource</li> </ul> <p>Los Ejemplos Reales y las Plantillas de Logros son paginas \u00fatiles para ver como estas t\u00e9cnicas funcionan.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#practicando","title":"Practicando","text":"<p>En orden para que se te conviertan familiares todas estas t\u00e9cnicas b\u00e1sicamente tienes que practicar. Puedes utilizar cualquier juego para practicar, incluso esos que ya cuentan con logros. Simplemente ten estas reglas en mente:</p> <ul> <li>NO borres/sobre-escribas cualquier Nota de C\u00f3digo existente.</li> </ul> <ul> <li>En esta fase de practica, mant\u00e9n tu trabajo en local y NO subas ning\u00fan logro. Esto lo vas a hacer despu\u00e9s cuando realmente encuentres un juego en el ya vallas a trabajar.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/#buscando-un-juego-el-cual-trabajar","title":"Buscando un juego el cual trabajar","text":"<p>Sigue los Reglamentos en el C\u00f3digo de Conducta del Desarrollador para as\u00ed encontrar un juego en el cual trabajar. B\u00e1sicamente lo que primero necesitas es declarar tus planes de trabajo sobre el juego en el que quieras trabajar en el foro del mismo, y mientras vallas trabajando en el juegos a\u00f1adir tus planes mas detallados en el mismo foro.</p> <p>Tip: para tu primer set de logros es recomendable que escojas un juego que aun no tiene logros y que no es muy popular.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#planeando-tu-set-de-logros","title":"Planeando tu Set de Logros","text":"<p>Una vez que encuentras un juego el cual trabajar necesitas planificar tu Set de Logros.</p> <p>Ten en cuenta conocer lo suficientemente bien el juego para as\u00ed hacer un buen set. Checa su pagina de GameFAQs o algo parecido, intenta aprender mas sobre el videojuego, sus secretos y detalles. Aqu\u00ed hay una buena gu\u00eda que te podr\u00eda servir de ayuda con esto: Mapa de Desarrollo del Set.</p> <p>Postea tus planes en el foro oficial del juego, para que as\u00ed la comunidad pueda dejar sugerencias y retroalimentacion. Esta actitud es requerida para todo tipo de desarrolladores y desarrolladores jr. (jr-dev).</p> <p>IMPORTANTE!: estate abierto en recibir retroalimentacion y sugerencias.</p> <p>Tambi\u00e9n mira: Dise\u00f1o de Logros, es una gu\u00eda extensiva en como dise\u00f1ar buenos e interesantes logros. No sobre el lado t\u00e9cnico sino el conceptual.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#publica-tus-logros-en-unofficial-para-revision","title":"Publica tus logros en Unofficial para revisi\u00f3n","text":"<p>Despues de haber creado varios logros, promuebelos a Unofficial y despu\u00e9s contacta a un @mod o aun @code-reviewer en nuestro servidor de Discord (si no utilizas Discord, manda un mensaje a RAdmin) y pregunta por alguien que pueda rese\u00f1ar tu trabajo.</p> <p>Otra vez, es extremadamente importante que est\u00e9s abierto a recibir critica constructiva y ayuda de parte de la comunidad en cualquier momento.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#estoy-listo-para-conseguir-estatus-de-desarrollador","title":"Estoy listo para conseguir estatus de Desarrollador?","text":"<p>Una vez que los Rese\u00f1adores de C\u00f3digo han inspeccionado el c\u00f3digo de tus logros y conceptos, ellos y el administrador van a utilizar el \"Conocimiento Requerido\" en la lista de requisitos de arriba para determinar si estas listo. Si no estas completamente calificado para ser un desarrollador pero tu set esta completo y estable el set va a ser publicado. Puedes preguntar que conceptos aun necesitas para demostrar tu capacidad para obtener tu estatus como desarrollador.</p> <p>Los m\u00e9ritos para que un desarrollador jr. (jr-dev) reciba un estatus de desarrollador dependen en:</p> <ul> <li>su habilidad en publicar trabajo que contengan el est\u00e1ndar del C\u00f3digo de Conducta del Desarrollador;</li> <li>demostrar el conocimiento requerido y conceptos avanzados;</li> <li>la calidad y complejidad de su trabajo;</li> <li>el tiempo y pensamiento que puso en planificar y trabajar los logros;</li> <li>mostrando el deseo en utilizar el estatus como desarrollador con cuidado y responsabilidad;</li> <li>la medida en que los puntos anteriores reflejan sus capacidades como desarrollador.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer-es/#codigo-de-conducta-del-desarrollador","title":"C\u00f3digo de Conducta del Desarrollador","text":"<p>Una vez que hubieras conseguido tu estatus como desarrollador, tu TIENES que adherirte a el C\u00f3digo de Conducta del Desarrollador. Eso es extremadamente importante para crear un ambiente justo entre los Desarrolladores de Logros.</p>"},{"location":"How-to-Become-an-Achievement-Developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:30] meleu:</code> fix links</li> <li><code>[2019-04-17 17:26] eldexterr:</code> Find some typos</li> <li><code>[2019-04-16 14:50] meleu:</code> page title en espa\u00f1ol</li> <li><code>[2019-04-16 14:42] meleu:</code> fix broken links</li> <li><code>[2019-03-12 14:58] meleu:</code> Updated How to Become an Achievement Developer ES (markdown)</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/","title":"How to Become an Achievement Developer","text":"<p>This document describes all the steps that any aspiring achievement developer must follow before getting Developer status. These requirement are also a checklist for Code Reviewers (developers who inspect the code of new developers).</p> <p>Anyone can become a RetroAchievements developer if they put in the effort.</p> <p>Strongly recommended: join our Discord server so you can get in contact with other achievement developers who can show you the ropes and help you along. If you already know what game you want to work on, go ahead and ask for the <code>jr-dev</code> role in <code>#tech-support</code> forum by creating a post tagged as <code>Join Team</code> and pinging <code>@QA-Maintainer</code> (Make sure to first get your account verified by following instructions in <code>#welcome</code> if you haven't already). This gives you access to the <code>#jr-devs</code> channel, where you can talk to code reviewers and ask any development related questions.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#finding-a-game-to-work-on","title":"Finding a Game to Work on","text":"<p>Follow the guidelines on the Developer's Code of Conduct to find a game to work on achievements for it. The basics are that you must declare you plans to work on the game on in the forum, and then as you work on the game, add your plans for the game in the forum.</p> <p>Tip: for your first achievement set it's recommended to choose a game that doesn't yet have achievements and is not very popular.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#planning-your-achievement-set","title":"Planning your Achievement Set","text":"<p>Once you find a game to work on you need to plan your Achievement Set.</p> <p>Be sure you know enough about the game to make a good set. Check the GameFAQs or something, try to learn more about the game, its secrets and details. Here is a good guide to help you with this: Set Development Roadmap.</p> <p>Post your plans on the official game's forum topic, so the community can leave suggestions and provide feedback. This is required behavior for all devs and jr-dev.</p> <p>IMPORTANT!: be open to receive feedback and suggestions.</p> <p>See also: Achievement Design, it's an extensive guide on how to design good and interesting achievements. It's not about the technical side but the conceptual.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#required-knowledge","title":"Required Knowledge","text":"<p>Every developer must know at least the basic concepts and techniques shown in these two docs:</p> <ol> <li>Getting Started as an Achievement Developer</li> <li>Achievement Logic Features</li> </ol> <p>Any aspiring dev must demonstrate understanding of the following concepts:</p> <ul> <li>Basic RAM digging (be familiar with the Memory Inspector)</li> <li>Hexadecimal notation</li> <li>Delta values</li> <li>Hit counts</li> <li>Pause If</li> <li>Reset If</li> <li>Alt Groups</li> <li>Memory sizes: 8-bit and single bit</li> <li>Achievement logic comparisons besides <code>=</code>, such as <code>&gt;</code>, <code>&lt;</code>, <code>!=</code></li> <li>Adding badges to an achievment</li> <li>Creating accurate descriptions for achievements</li> <li>Add appropriate protections</li> <li>Make a stable achievement set</li> </ul> <p>Note: You do not need mastery of all these concepts to have a set published, but you do need them to have the full Developer role.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#advanced-concepts","title":"Advanced Concepts","text":"<p>Here is a list of some advanced concepts/techniques. They are not required to become a Developer, but are listed here to let the jr-dev know the possibilities of the Achievement's logic.</p> <ul> <li>Hit count as timer (like in this example and this one)</li> <li>ResetIf Checkpoints</li> <li>ResetIf with Hitcount</li> <li>PauseIf with Hitcount</li> <li>AddSource and SubSource Flags</li> <li>AddHits and SubHits Flag</li> <li>Increment counter (<code>Mem &gt; Delta</code> Counter)</li> <li>Delta Hit Counter, pause technique</li> <li>Little endianness</li> <li>Memory size: Lower4, Upper4, and 16-bit, 32-bit</li> <li>Dynamic Rich Presence</li> <li>Leaderboards</li> <li>Pausable Resets</li> <li>SubSource increment counter</li> </ul> <p>The Real Examples and Achievement Templates pages are useful resources to see how those techniques work.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#code-notes","title":"Code Notes","text":"<p>Junior developers can create and delete code notes that they have created, but they cannot delete or edit any notes created by others. Developers CAN edit and remove notes by other users, and these changes are site-wide.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#practicing","title":"Practicing","text":"<p>In order to become familiar to those techniques you must practice. You can use any game to practice, even those that already have achievements. Just be aware about these rules:</p> <ul> <li>Do NOT delete/overwrite any existing Code Note.</li> </ul> <ul> <li>On this practicing phase, keep your work in local and do NOT upload any achievement. You'll do it later when you find a game to actually work on.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/#get-your-work-reviewed","title":"Get your work reviewed","text":"<p>After creating some achievements, upload them to Unofficial and then create a post in <code>#jr-dev-forum</code> on our Discord server (if you don't use Discord, send a message to RAdmin) and ask them to find someone to review your work.</p> <p>Do NOT ask another developer to promote your achievements to the Core without a proper review.</p> <p>Again, it's extremely important that you are open to receive constructive criticism and helpful advice from the community at any time.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#am-i-ready-to-get-the-developer-status","title":"Am I ready to get the Developer status?","text":"<p>Once the Code Reviewers have inspected your achievement's code and concepts, they and the admin will use the \"Required Knowledge\" checklist above to determine if you're ready. If you're not fully qualified to be a developer yet, but your set is complete and stable, the set will get published. You can then ask which concepts you still need to demonstrate proficiency in to be given developer status.</p> <p>The merit of a jr-dev receiving developer status depends on:</p> <ul> <li>their ability to publish work that meets the standards of the Developer's Code of Conduct;</li> <li>demonstration of required knowledge and advanced concepts;</li> <li>the quality and complexity of their work;</li> <li>the time and thought they put into planning and working on achievements;</li> <li>showing the will to use the Developer status with care and responsibility;</li> <li>the extent to which the points above reflect their capabilities as a developer.</li> </ul>"},{"location":"How-to-Become-an-Achievement-Developer/#developers-code-of-conduct","title":"Developer's Code of Conduct","text":"<p>Once you get your Developer status, you MUST adhere to the Developer's Code of Conduct. That is extremely important to create a fair environment between the Achievement Developers.</p>"},{"location":"How-to-Become-an-Achievement-Developer/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 10:41] televandalist:</code> Fix broken link</li> <li><code>[2023-03-29 21:18] Searo:</code> Typo</li> <li><code>[2023-03-29 20:56] Searo:</code> Update jr request wording after #help-me channel changed to #tech-support</li> <li><code>[2023-02-15 13:25] Riley Nielsen:</code> Updated How to Become an Achievement Developer (markdown)</li> <li><code>[2022-05-14 21:53] Searo:</code> Update QA-Team to QA-Maintainer</li> <li><code>[2022-05-02 17:52] RALordAndrew:</code> Updated How to Become an Achievement Developer (markdown)</li> <li><code>[2021-11-28 14:47] Searo:</code> Clarification on channel and team to ask for jr-dev role on Discord</li> <li><code>[2021-05-01 07:27] meleu:</code> fix link to AddHits page</li> <li><code>[2021-04-26 13:33] meleu:</code> fix links</li> <li><code>[2021-04-26 13:31] meleu:</code> fix link</li> </ul>"},{"location":"How-to-configure-OBS-Studio-to-see-the-popups/","title":"How to configure OBS Studio to see the popups","text":"<p>In \"Window Capture\" mode, OBS Studio will not capture the popups. The popups are rendered using a \"Layered Window\", and OBS Studio removed support for capturing layered windows</p> <p>If you want to include the popups in your stream, you have two options: change to \"Display Capture\" mode, or add a second \"Window Capture\" for the \"TransparentOverlayWindow\". This page will attempt to walk you through doing the second.</p> <p>Add a second \"Window Capture\" source to the Scene. In the popup dialog, select the \"TransparentOverlayWindow\".</p> <p></p> <p>You'll probably notice the window is pink.</p> <p></p> <p>Add a filter to the second \"Window Capture\"</p> <p></p> <p>Add a \"Color Key\" filter, set the Key Color Type to \"Custom Color\", then use the Select Color dialog to enter <code>#FF01FE</code> as the color. Decrease the similarity to 1 and the opacity to 90.</p> <p></p> <p>Finally, if you still have a bit of a pink border showing up, enable a Scale Filter. They all seem to eliminate the remnant, so choose whichever you like best.</p> <p></p>"},{"location":"How-to-configure-OBS-Studio-to-see-the-popups/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-06-30 17:06] Jamiras:</code> Created How to configure OBS Studio to see the popups (markdown)</li> </ul>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/","title":"Como contribuir si no eres un desarrollador","text":"<p>Incluso si tu no sabes como crear logros aun hay varias maneras para contribuir con la comunidad de RetroAchievements. Aqu\u00ed se encuentran algunos ejemplos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportar-logros-rotos","title":"Reportar logros rotos","text":"<p>Si tu logro se disparo en el momento equivocado o no se disparo del todo, por favor reportalo. Sabemos que a muchos usuarios le gustan los puntos gratis, pero por favor, incluso si un logro se disparo en el momento equivocado, reportalo!</p> <p>Otra situaci\u00f3n que tambi\u00e9n merece ser reportada es cuando un logro se dispara por medio del uso de un cheat en el juego (ej. c\u00f3digo de selecci\u00f3n de stages), o cargando un archivo de guardado.</p> <p>Hay dos maneras para reportar un logro roto: directamente desde el emulador o por medio de la pagina web. En los dos casos, agrega detalles del estado de tu juego, cuando se disparo/no se disparo, cual modo de juego, donde estabas cuando paso/no paso, si reseteaste el juego recientemente, cualquier cosa que pienses que podr\u00eda resultar relevante para el logro. Esto es necesario para que los desarrolladores encuentren donde esta el problema.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportando-por-medio-del-emulador","title":"Reportando por medio del emulador","text":"<p>Ve a RetroAchievements -&gt; Report Broken Achievements, esta funci\u00f3n solamente esta disponible en emuladores oficiales (no en RetroArch).</p> <p>Mira este ejemplo:</p> <p>.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#reportar-por-medio-del-sitio-web","title":"Reportar por medio del sitio web","text":"<p>En la pagina de cada logro podr\u00e1s ver un link que dice <code>Report an issue for this achievement</code>, como en la imagen de abajo:</p> <p></p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#sugiere-buenos-logrosretos","title":"Sugiere buenos logros/retos","text":"<p>Si conoces un juego bastante bien, probablemente tal vez tengas algunas ideas muy cool sobre retos para el juego. Postea tus ideas en el foro del juego.</p> <p>Tenemos una gu\u00eda en como pensar y dise\u00f1ar buenos logros, no el lado t\u00e9cnico sino el conceptual. Que incluso los que no son desarrolladores pueden llegar a conseguir un poco de inspiraci\u00f3n de ese documento.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#la-retro-alimentacion-es-siempre-bienvenida","title":"La retro-alimentaci\u00f3n es siempre bienvenida","text":"<p>Deja retro-alimentaci\u00f3n en los foros sobre que te gusta o que te disgusta sobre un set de logros. Se especifico y deja cada detalle.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#haz-iconosemblemas-para-logros","title":"Haz iconos/emblemas para logros","text":"<p>Si te gusta jugar con gr\u00e1ficos puedes crear alg\u00fan arte para los emblemas o iconos de juegos. Utilizando la opci\u00f3n de captura de pantalla del emulador puede llegar a ser \u00fatil para esto, y entonces puedes editarlo para hacer llegar a hacer algo muy cool.</p> <p>Puedes encontrar mas informaci\u00f3n en la pagina de creaci\u00f3n de Badges e Iconos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#ayuda-con-la-documentacion","title":"Ayuda con la documentaci\u00f3n","text":"<p>Si cuentas con una cuenta de github y conoces lo b\u00e1sico del Markdown, puedes ayudar con la documentaci\u00f3n. Corregir errores ortogr\u00e1ficos, gramaticales o informaci\u00f3n err\u00f3nea.</p> <p>Hecha un vistazo a esta pagina para conocer los detalles: Contribuyendo con los documentos</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#participa-en-los-eventos-de-la-comunidad","title":"Participa en los eventos de la comunidad","text":"<p>Como Logro de la Semana, Tabla Clasificatoria de la Semana u otros eventos que suceden en nuestro servidor de discord.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-26 13:00] eldexterr:</code> Created How to contribute if you are not a developer es (markdown)</li> </ul>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/","title":"Como contribuir se Voc\u00ea n\u00e3o for um Desenvolvedor","text":"<p>Link para o texto em ingl\u00eas: How to contribute if you're not a developer</p> <p>Mesmo que voc\u00ea n\u00e3o saiba como criar conquistas existem muitas formas de contribuir com a comunidade RetroAchievements. Aqui est\u00e3o alguns exemplos.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#reportar-conquistas-quebradas","title":"Reportar conquistas quebradas","text":"<p>Se uma conquista ativar em um tempo errado ou n\u00e3o ativar, por favor reporte.</p> <p>Outra importante situa\u00e7\u00e3o que precisa ser reportada \u00e9 uma conquista ativando por usar algum tipo de trapa\u00e7a no jogo (ex. c\u00f3digo de sele\u00e7\u00e3o de fase), ou por carregar um jogo salvo (arquivos de save)</p> <p>Para reportar uma conquista quebrada, v\u00e1 em RetroAchievements -&gt; Report Broken Achievements, esse recurso s\u00f3 est\u00e1 dispon\u00edvel em emuladores oficiais (n\u00e3o no RetroArch).</p> <p>Veja este exemplo:</p> <p>.</p> <p>Detalhes adicionais do estado do seu jogo, quando ativa/n\u00e3o ativa, que modo de jogo, onde voc\u00ea est\u00e1 quando aconteceu/n\u00e3o aconteceu, se voc\u00ea teve que resetar o jogo recentemente, qualquer outra coisa que voc\u00ea acha que pode ser relevante para a conquista. Isso \u00e9 necess\u00e1rio para o nosso sistema, para que os desenvolvedores saibam onde est\u00e1 o problema.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#sugerir-conquistas-legaisdesafios","title":"Sugerir conquistas legais/desafios","text":"<p>Se voce conhece um jogo muito bem, voc\u00ea provavelmente pode ter algumas ideias interessantes de desafios para o jogo. Poste suas ideias no forum relacionado ao jogo.</p> <p>Nos temos um guia sobre como pensar e projetar boas conquistas, n\u00e3o o lado t\u00e9cnico, mas o conceitual. Entao at\u00e9 os n\u00e3o-desenvolvedores podem ter alguma inspira\u00e7\u00e3o a partir daquela informa\u00e7\u00e3o.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#feedback-e-sempre-bem-vindo","title":"Feedback \u00e9 sempre bem-vindo","text":"<p>Dar Feedback (coment\u00e1rios) nos foruns sobre qual voc\u00ea gosta ou n\u00e3o gosta sobre a lista de conquista. Seja espec\u00edfico e deixe detalhes</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#faca-icones-para-as-conquistas","title":"Fa\u00e7a \u00edcones para as conquistas","text":"<p>Se voc\u00ea gosta de brincar com gr\u00e1ficos, voc\u00ea pode criar algumas artes para os \u00edcones das conquistas ou os \u00edcones para os jogos. Usando o recurso de screenshot (captura de tela) do emulador em si pode ajudar com isso, e entao voc\u00ea pode editar para fazer algo legal.</p> <p>Voc\u00ea pode ver mais informa\u00e7\u00f5es sobre a P\u00e1gina de Cria\u00e7\u00e3o de Icones.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#participe-em-eventos-da-comunidade","title":"Participe em eventos da comunidade","text":"<p>Como a \"Conquista da Semana\" (Achievement of the Week), Ranking da semana (Leaderboard of the Week) ou outros eventos que acontecem no nosso servidor do Discord.</p>"},{"location":"How-to-contribute-if-you-are-not-a-developer-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-06-10 10:56] lilbud:</code> Uploaded new gif showing reporting broken achievements</li> <li><code>[2018-06-10 10:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-04-02 19:02] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-28 20:11] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-25 12:00] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-25 11:45] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 22:15] meleu:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 21:02] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 21:02] KingDice001:</code> Updated How to contribute if you are not a developer pt_BR (markdown)</li> <li><code>[2018-03-23 20:53] KingDice001:</code> Created How to contribute if you are not a developer-pt_BR (markdown)</li> </ul>"},{"location":"How-to-run-RALibretro-on-Linux/","title":"How to run RALibretro on Linux","text":"<p>To be done...</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/","title":"HowTo Scrape Achievement List to CSV for Rescore and Revision Updates","text":"<p>This is a fast and easy method to scrape all Achievements, Descriptions or other useful information from RetroAchievements into a CSV format which can be posted in Forums and Discord for sharing Rescore and Revision Update plans.</p> <ol> <li>Download the Chrome Extension from https://simplescraper.io</li> <li>Browse to the Game Page you want to Scrape the Achievement List from (example: https://retroachievements.org/game/11256)</li> <li>Click on 'Launch Simple Scraper' and choose 'Scrape this website'</li> <li>Choose 'Add a property'</li> <li>Now you can select what information you want to scrape, click on the Achievements</li> <li>The number of selected items must match the number of Achievements on the Site</li> </ol> <p>(!) you can change the scraping content manually in the appearing box below 'propertyName1'.</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#for-rescoring-updates-scrape-achievements-only","title":"For Rescoring Updates - scrape Achievements only","text":"<ul> <li><code>div.achievemententry div.achievementdata a</code></li> <li><code>.achievementdata a</code></li> </ul>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#for-revision-updates-scrape-achievements-and-descriptions","title":"For Revision Updates - scrape Achievements and Descriptions","text":"<ul> <li><code>div.achievemententry div.achievementdata</code></li> <li><code>.achievementdata</code></li> </ul> <ol> <li>Click on the checkmark to confirm the selection and choose 'View Results'</li> <li>A new tab should open, now click on CSV to download the Achievement List</li> <li>Upload the downloaded CSV file to Google Drive and open it with Google Sheets</li> </ol> <p>(!) Scraped Achievements with Descriptions can be seperated by splitting the columns with '\\n'.</p>"},{"location":"HowTo-Scrape-Achievement-List-to-CSV-for-Rescore-and-Revision-Updates/#upload-and-split-into-columns-in-google-sheets","title":"Upload and split into columns in Google Sheets","text":"<ol> <li>In Google Sheets, select <code>A</code> (must be marked) and choose 'Data' then 'Split text to columns', 'custom' and insert <code>\\n</code>.</li> </ol> <p>Please check Achievement-Set-Revisions for more information regards Recore and Revision Updates.</p>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/","title":"Leaderboard bug list and improvement ideas","text":""},{"location":"Leaderboard-bug-list-and-improvement-ideas/#bugs","title":"Bugs","text":"<ul> <li>Leaderboards only show the top 5 during the popup submit results, not your position (if you're not in the top 5). Show the player rank seems to be the right thing to do.</li> <li>Cancel only takes action on the first condition, everything else is ignored.</li> <li>Fix leaderboard order bug, the order specified by the dev is ignored instead displaying order of creation.</li> <li>Submission dates are not updating when an improved score is submitted. (The rank is updating)</li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#improvement-ideas","title":"Improvement Ideas","text":""},{"location":"Leaderboard-bug-list-and-improvement-ideas/#general","title":"General","text":"<ul> <li>Make all leaderboard submits hardcore only.</li> <li>Always cancel on reset.</li> <li>Add clone leaderboard button.</li> <li>Usurp leaderboard: Change it so when a player matches a score the most recent entry goes on top.</li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#math-and-syntax","title":"Math and Syntax","text":"<ul> <li>Add syntax for hits/add reset?</li> <li>Exponents syntax especially x^0.</li> <li>Order of operation calculation.</li> <li>Multiple start/submit conditions ie alts/ORs for start/cancel/submit</li> <li>Allow for the multiplication of two or more addresses </li> </ul>"},{"location":"Leaderboard-bug-list-and-improvement-ideas/#hidden-leaderboards-and-overlay","title":"Hidden Leaderboards and overlay","text":"<ul> <li>Add an option to have hidden leaderboards - choose if visible.</li> <li>Add an option to hide cancel popup.</li> <li>Make submit box smaller?</li> <li>Add an option to be able to choose location in overlay.</li> <li>Add an option to display popup text that's not for any leaderboard. Allow for control of how long the popup will stay?</li> <li>Able to change overlay color.</li> </ul> <p>Idea for on screen notification and an expansion on the idea: \"Add an option to display popup text that's not for any leaderboard. Allow for control of how long the popup will stay\"</p> <p>The point is to help the player track their progress on certain types of achievements.</p> <p>Using something similar to the leaderboard, when selected by the developer, allow hits to be displayed on screen. It could perhaps show hits, or the sum of hits from multiple conditions. </p> <p>Also, maybe with a similar text info as rich presence, where on screen it would display 4/9 Goomba's stomped. or 20/100 seconds survived or 9 items collected, etc.</p> <p>Beyond that, achievements with this type OSD info built in, they could either be turned on and off individually from the overlay. )Where they would always be off if the achievement was complete.) OR have a manual start and stop similar to leaderboards.</p> <p>This could be used to display failed attempts. For example a ResetIf could be marked as a failstate, when the reset happens OSD would show Escaping the cave without being seen: failed.</p>"},{"location":"Leaderboards-es/","title":"Tablas de Clasificaci\u00f3n","text":"<p>Actualmente las Tablas de Clasificaci\u00f3n pueden ser editadas por desarrolladores desde el sitio web. Es una interfaz bastante tosca y un trabajo algo complicado hacer que una tabla funcione de manera correcta. As\u00ed que en este documento vamos a intentar a entender como funciona.</p>"},{"location":"Leaderboards-es/#visiones-generales","title":"Visiones Generales","text":"<p>Asi es como se ve una lista de Tablas de Clasificaci\u00f3n de un juego en el sitio web:</p> <p></p> <p>En el centro puedes llegar a ver cada Tabla que a sido creada, y en la columna de la derecha puedes llegar a ver las Notas de C\u00f3digo del Juego. Las Notas est\u00e1n all\u00ed para ayudar en algunas de las condiciones que se encuentran aqu\u00ed abajo.</p> <p>Aqu\u00ed hay una breve explicaci\u00f3n de cada campo que se encuentra en una Tabla de Clasificacion:</p> <ul> <li>Titulo: El titulo de la tabla.</li> <li>Descripci\u00f3n: La descripci\u00f3n de la tabla.</li> <li>Formato: Puede llegar a ser <code>Puntuaci\u00f3n</code>, <code>Tiempo (Frames)</code>, <code>Tiempo (Milisegundos)</code> o <code>Valor</code>. Se utiliza para distinguir que tipo de tabla es (vamos a ver mas sobre esto mas abajo).</li> <li>\"LowerIsBetter\" checkbox: cuando se encuentra activada, significa que el valor mas bajo es mejor. Es usualmente el caso para logros basados en tiempo.</li> <li>Start: condiciones para empezar la tabla, aka STA.</li> <li>Cancel: condiciones para cancelar la tabla, aka CAN.</li> <li>Submit: condiciones para subir una entrada a la tabla, aka SUB.</li> <li>Value: valor que quieres que se suba a la tabla, aka VAL.</li> </ul> <p>Nota: Una tabla valida TIENE que tener todas estas cuatro condiciones.</p> <p>Esos \u00faltimos 4 campos son realmente importantes y se tiene que tomar MUCHO cuidado de acuerdo a los datos que vas a introducir en ellas. Es por eso que requieren una explicaci\u00f3n a continuaci\u00f3n:</p> <p>La condici\u00f3n STA o Start son una serie de valores, como un logro, que tienen que llegar a ser verdad en orden para que la tabla empieza a buscar una entrada para la tabla. Una vez que STA es verdadero, el juego va a activar las otras tres constantemente.</p> <p>Si la condici\u00f3n Cancel (CAN) es verdadera, entonces esta va a cancelar la tabla y no se va a subir la entrada a la misma. </p> <p>Si la condici\u00f3n Submit (SUB) es verdadera, entonces la puntuaci\u00f3n entrara en las tablas. NOTA: Cancel tiene mas prioridad que Submit. Si las dos se convierten verdaderas en el mismo frame, la puntuaci\u00f3n no sera ingresada.</p> <p>Finalmente, Value (VAL) es un caso especial, y va a ser tomado de la memoria utilizando la formula que se ingreso en la entrada de Value. Esta es la puntuaci\u00f3n que se muestra cuando la Tabla esta activa, y el valor que es ingresado en las tablas si SUB es verdadero.</p> <p>NOTA: Una vez que una tabla activa es cancelada o ingresada, esta no puede ser re-activada asta que la condici\u00f3n Start se convierta en falsa, y verdadera de nuevo. Esto previene a la tabla de ser re-activada inmediatamente que se ingreso un valor o se cancelo.</p>"},{"location":"Leaderboards-es/#formato-de-direcciones","title":"Formato de Direcciones","text":"<p>Las direcciones de memoria para STA/CAN/SUB/VAL tienen el siguiente formato:</p> localizaci\u00f3n/tama\u00f1o prefijo (las letras pueden ser en min\u00fasculas) ejemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Leaderboards-es/#ejemplo","title":"Ejemplo","text":"<p>La mejor manera de empezar es hecharle un vistazo a una de las tablas ya existentes https://retroachievements.org/leaderboardList.php y abrirla para ver como funciona. Vamos a utilizar la tabla de Green Hill Act 1 (Sonic the Hedgehog) para este ejemplo. Entonces veamos como funciona:</p> <p></p> <p>El Titulo/Descripci\u00f3n son algo obios.</p> <p>El Type es \"Time (Frames)\". En Sonic cada 60 frames es un 1 segundo, entonces vamos a monitoriar los segundo utilizando frames.</p> <p>La caja de Lower Is Better esta marcada, entonces aquel que consiga el tiempo mas corto sera el #1.</p> <p>Ahora vamos a desglosar las partes mas importantes.</p>"},{"location":"Leaderboards-es/#condiciones-de-start","title":"Condiciones de Start","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <ul> <li><code>0xfe10=h0000</code>: Si la direcci\u00f3n de 16-bit 0xfe10 en la RAM es equivalente a 0000 en hex,</li> <li><code>_</code>: Y,</li> <li><code>0xhf601=h0c</code>: Si la direcci\u00f3n de 8-bit 0xf601 en la RAM es equivalente a 0c en hex,</li> <li><code>_</code>: Y,</li> <li><code>d0xhf601!=h0c</code>: Si la misma direcci\u00f3n anterior (0xf601) NO es equivalente a 0c en hex,</li> <li><code>_</code>: Y,</li> <li><code>0xfff0=0</code> Si la direcci\u00f3n de 16-bit 0xfff0 en la RAM es equivalente a 0.</li> </ul> <p>Esto puede parecer desalentador, porque no sabes que significan esta direcciones. Es por eso que las Notas de C\u00f3digo en la columna de la derecha son bastante \u00fatiles! Tu puedes llegar a ver como estas direcciones son mostradas en memoria. En nuestro ejemplo tenemos:</p> <ul> <li><code>0xfe10</code> es el nivel, y se espera que sea <code>0</code> (el primer nivel).</li> <li><code>0xf601</code> es una direccion en memoria de 8-bit, y utilizamos el prefijo <code>0xh</code> en vez de <code>0x</code>. <code>0xf601</code> es el modo de la pantalla. La segunda y terceras partes de las condiciones para empezar estan diciendo \"el modo actual tiene que ser  ingame (<code>0c</code>), y el modo en el frame anterior NO tiene que ser ingame\". Nota: ese prefijo <code>d</code> en la direcci\u00f3n representa delta, o \"el valor en el frame anterior\". Sum\u00e1ndole a esto: ejecuta STA si ACABAMOS de llegar a un nivel, (para empezar a checar el tiempo).</li> <li>Finalmente tambi\u00e9n esperamos que <code>0xfff0</code> sea equivalente a <code>0</code>, ya que esta direcci\u00f3n se utiliza para demo mode, y no queremos que la tabla se active cuando esta el modo demo activado!</li> </ul> <p>Tip: el error mas com\u00fan cuando creamos tablas de clasificaci\u00f3n es olvidarnos de la <code>h</code> cuando tratamos de hacer referencia a un valor en memoria de 8-bit.</p> <p>Pro-tip: STA, CAN, y SUB soportan toda la logica que se encuentra disponible en el editor de logros. La manera mas facil es asegurarte que escribiste todo correctamente es crear logros locales que capturen estos eventos, y entonces extraer los valores ingresados en el archivo \"XXX-User.txt\" asociado al juego en el cual te encuentras trabajando.</p>"},{"location":"Leaderboards-es/#condiciones-para-cancelar","title":"Condiciones para Cancelar","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <ul> <li>0xfe13 es el numero de vidas.</li> </ul> <p>La condici\u00f3n de cancelaci\u00f3n checa si el contador de VIDAS alguna vez se decrementa. Literalmente dice \"Cancela si el valor ACTUAL en 0xfe13 es menor al valor ANTERIOR en 0xfe13\". Queremos hacer esto porque puedes llegar al ultimo checkpoint, morir y resetear tu tiempo a 0:00. Y no queremos que se pueda hacer esto, ya que no es la manera correcta de completar el nivel. As\u00ed que si el jugador muere, se va a resetear el progreso de la tabla. Finalmente, si conectas dos condiciones de cancelaci\u00f3n con una <code>s</code>, la tabla se va a cancelar si cualquiera de las condiciones es verdadera.</p>"},{"location":"Leaderboards-es/#condiciones-para-ingresar-entradas","title":"Condiciones para Ingresar Entradas","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <ul> <li>0xf7cc es la bandera para terminar el nivel, esta no es interactiva.</li> </ul> <p>La secci\u00f3n de submit checa si en el frame actual se encuentra la bandera de 'endlevel' como verdadera (o <code>!=0</code>, 'no es un cero'), y el frame anterior (delta) lo tiene como falso (o <code>=0</code>, 'cero'). Esto sugiere que el jugador a llegado al final del nivel.</p> <p>Tip: puede llegar a ser \u00fatil observar como trabajan estos valores en memoria, y conocer que tipo de valor se utilizan en diferente circunstancias.</p>"},{"location":"Leaderboards-es/#interpretador-de-valores","title":"Interpretador de Valores","text":"<p>Tambi\u00e9n mira: C\u00f3digo Binario Formateado en Decimal</p> <p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Finalmente, valor. Una vez que el jugador a llegado a la condici\u00f3n de inicio, se mostrara una notificaci\u00f3n en pantalla, mostrando el progreso del jugador en tiempo real. Si es una una tabla sobre tiempo, va a ver un reloj, y si es una puntuaci\u00f3n se mostrara simplemente el valor. Si ellos llegan a cumplir la condici\u00f3n de cancelaci\u00f3n, se mostrara un mensaje diciendo que fallaron, y la notificaci\u00f3n sera removida. Si ellos cumplen la condici\u00f3n de submit exitosamente, el valor actual se va a tomar y se va a subir una entrada, aparecer\u00e1 una notificaci\u00f3n informando al jugador sobre su posici\u00f3n en las tablas.</p> <p>La condiciones en value son especiales en cierto aspectos. Es evaluada constantemente y se muestra en pantalla en tiempo real cuando una tabla esta activada. No trabaja como otras condiciones, interpreta las direcciones de la siguiente manera:</p> <p><code>direcci\u00f3n*modificador</code> (direcci\u00f3n veces modificador)</p> <p>y usa al <code>_</code> operador guion bajo como 'mas'. El asterisco <code>*</code> significa 'multiplicar', entonces en el valor</p> <p><code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>representa:</p> <p>8-bit 0xfe24 1 vez, MAS 8-bit 0xfe25 60 veces, MAS 8-bit 0xfe22 3600 veces</p> <p>La raz\u00f3n de esto es que los valores de cada una de estas direcciones significan frames, segundos, y minutos respectivamente. Cuando agregamos estos valor juntos, obtenemos un total de frames que ingresamos a la base de datos.</p> <p>Recuerdas que el campo de 'Formato' pod\u00eda ya ser Puntuaci\u00f3n, Tiempo (Frames), Tiempo (Milisegundos) o Valor? Tiempo (Frames) es el mas com\u00fan de todos, y representa 'frames'. Time (Milisegundos) espera un valor que pueda convertir en milisegundos (Super Mario Kart utiliza esto). Sin embargo para convertir un valor en frames a un formato que sea humanamente entendible tenemos que dividir el valor por 60 para conseguir una interpretaci\u00f3n certera de los segundos, y un valor en milisegundos deber\u00eda estar dividido por 100 para conseguir el numero de milisegundos. Esto se utiliza ya sea en el sitio web y en los programas para mostrar el valor apropiadamente, y es importante que se distinga ya que podemos estar seguros que estamos consiguiendo el valor mas acertado del emulador, utilizando el formato que sea necesario para capturar el tiempo.</p> <p>Tambi\u00e9n hay un s\u00edmbolo que solamente funciona en este campo. Conecta dos valores condicionales con un <code>$</code> y esto va a provocar que solamente se utilice el valor con tenga el valor mas alto.</p> <p>NOTA: Tiempo (Milisegundos) son actualmente centenas de segundo, no mil\u00e9simas de segundo. por ejemplo: un valor de  6234 deber\u00eda de ser 62.34 segundos, no 6.234 segundos.</p> <p>Tip: el modificador usa valores decimales, entonces si por ejemplo quieres divir entre dos, puedes multiplicar por  0.5: <code>0xhfe24*0.5</code></p>"},{"location":"Leaderboards-es/#ayuda-futura","title":"Ayuda Futura","text":"<p>Desafortunadamente hay MUCHAS maneras de llegar a hacer este proceso de la manera equivocada, entonces si llegas a tener alg\u00fan problema si\u00e9ntete libre de pedir ayuda en nuestro Servidor de Discord.</p> <p>Si quieres practicar, es bastante recomendable que crees tu tabla e intentes algo en un juego nuevo, en vez de utilizar una tabla ya existente.</p> <p>Por favor ten en cuenta que estos archivos son arrastrados directamente a la partida de alguien cuando abra el juego, y un valor de memoria mal ingresado o un comando puede causar que el emulador se crashee, as\u00ed que por favor testea el c\u00f3digo de tu tabla!</p>"},{"location":"Leaderboards-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 13:35] meleu:</code> fix link</li> <li><code>[2019-05-17 10:24] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-16 11:31] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-16 10:56] eldexterr:</code> Updated Leaderboards es (markdown)</li> <li><code>[2019-05-15 10:21] eldexterr:</code> Updated Leaderboards (markdown)</li> </ul>"},{"location":"Leaderboards-pt_BR/","title":"Leaderboards","text":"<p>Link para o texto em ingl\u00eas: Leaderboards</p> <p>Atualmente Leaderboards podem ser editadas por desenvolvedores no site. \u00c9 uma interface bastante confusa e um trabalho dif\u00edcil para fazer com que uma leaderboard funcione corretamente. \u00c9 realmente necess\u00e1rio cuidado e aten\u00e7\u00e3o para obter uma boa leaderboard, ent\u00e3o, neste documento n\u00f3s vamos tentar entender como isto funciona.</p>"},{"location":"Leaderboards-pt_BR/#visao-geral","title":"Vis\u00e3o Geral","text":"<p>Isto \u00e9 como uma lista de Leaderboard de um jogo aparece no site</p> <p></p> <p>No centro voc\u00ea pode ver todas as Leaderboard feitas, e na coluna direita voc\u00ea pode ver as Code Notes (Notas de C\u00f3digo). As Code Notes est\u00e3o aqui para ajudar com algumas condi\u00e7\u00f5es que veremos abaixo.</p> <p>Aqui est\u00e1 uma breve explica\u00e7\u00e3o de cada campo de uma Leaderboard:</p> <ul> <li>Title (T\u00edtulo): O t\u00edtulo de uma Leaderboard</li> <li>Description (Descri\u00e7\u00e3o): A descri\u00e7\u00e3o de uma Leaderboard</li> <li>Format (Formato): Isto pode ser <code>Score</code>, <code>Time (Frames)</code>, <code>Time (Milliseconds)</code> ou <code>Value</code>. \u00c9 usado para distinguir que tipo de leaderboard \u00e9 (j\u00e1 vamos falar disso abaixo)</li> <li>\"LowerIsBetter\" checkbox (Menor\u00c9Melhor) : Quando marcado, isso quer dizer, um valor baixo \u00e9 a melhor coisa. \u00c9 geralmente usando em casos de leaderboards baseadas em tempo, enquanto uma pontua\u00e7\u00e3o maior geralmente \u00e9 melhor.</li> <li>Start (Iniciar): Condi\u00e7\u00f5es de in\u00edcio, aka STA</li> <li>Cancel (Cancelar): Condi\u00e7\u00f5es de cancelamento, aka CAN</li> <li>Submit (Submeter): Condi\u00e7\u00f5es para envio, aka SUB</li> <li>Value (Valor): Como interpretar os valores, aka VAL</li> </ul> <p>Nota: Uma leaderboard v\u00e1lida NECESSITA ter todas as quatro condi\u00e7\u00f5es.</p> <p>Esses 4 \u00faltimos campos s\u00e3o realmente importantes e MUITOS cuidados devem ser tomados na entrada de qualquer caracter dentro dessas linhas. \u00c9 por isso que eles merecem uma explica\u00e7\u00e3o mais na frente:</p> <p>A condi\u00e7\u00e3o STA ou Start \u00e9 uma s\u00e9rie de condi\u00e7\u00f5es, como uma conquista, que devem ser verdadeiras para come\u00e7ar a a Leaderboard. Uma vez que o STA for verdadeiro, o jogo ir\u00e1 come\u00e7ar a monitorar as condi\u00e7\u00f5es CAN, SUB e VAL.</p> <p>Se a condi\u00e7\u00e3o Cancel (CAN) for verdadeira, ela ir\u00e1 cancelar todo o progresso relativo ao envio da leaderboard. Se no entanto a condi\u00e7\u00e3o Submit (SUB) for verdadeira, ent\u00e3o, o placar gerado na leaderboard ser\u00e1 enviado</p> <p>Finalmente, o Valor (VAL) \u00e9 um caso especial, e ir\u00e1 ser obtido da mem\u00f3ria usando a f\u00f3rmula iniciada na caixa de mem\u00f3ria (memory box)</p>"},{"location":"Leaderboards-pt_BR/#formato-do-endereco","title":"Formato do Endere\u00e7o","text":"<p>O Endere\u00e7o de mem\u00f3ria para STA/CAN/SUB/VAL tem o segunte formato:</p> localiza\u00e7\u00e3o/tamanho prefixo (pode ser min\u00fasculo) exemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Leaderboards-pt_BR/#exemplo","title":"Exemplo","text":"<p>O melhor lugar para iniciar \u00e9 olhando uma das leaderboards existentes http://retroachievements.org/leaderboardList.php e desmontar para ver como funciona. N\u00f3s iremos usar o Green Hill Act 1 (Sonic the Hedgehog) Leaderboard para este prop\u00f3sito. Vamos ver como fica:</p> <p></p> <p>Os campos Title e Description s\u00e3o um pouco \u00f3bvios.</p> <p>O Type \u00e9 \"Time (Frame)\". Em Sonic cada 60 frames equivale a 1 segundo, ent\u00e3o vamos monitorar o tempo usando os frames.</p> <p>A checkbox Lower Is Better est\u00e1 marcada, entao aquele que fizer o tempo mais curto ser\u00e1 o #1.</p> <p>Agora nos vamos explicar as partes mais importantes.</p>"},{"location":"Leaderboards-pt_BR/#condicoes-de-inicio","title":"Condi\u00e7\u00f5es de In\u00edcio","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <ul> <li><code>0xfe10=h0000</code>: Se o endere\u00e7o da RAM 0xfe10 \u00e9 equivalente hex 0000,</li> <li><code>_</code>: E,</li> <li><code>0xhf601=h0c</code>: Se o endere\u00e7o da RAM 8-bits 0xf601 \u00e9 equivalente para hex 0c,</li> <li><code>_</code>: E,</li> <li><code>d0xhf601!=h0c</code>: Se o endere\u00e7o da RAM 8-bits anterior 0xf601 N\u00c3O \u00e9 equivalente ao 0c,</li> <li><code>_</code>: E,</li> <li><code>0xfff0=0</code> Se o endere\u00e7o da RAM 0xfff0 \u00e9 equivalente ao 0.</li> </ul> <p>Esto parece ser intimidador, porque nos n\u00e3o sabemos o que esse endere\u00e7o diz. \u00c9 por isso que o Code Note na coluna direita \u00e9 de bastante ajuda! Voc\u00ea pode ser como esses endere\u00e7os est\u00e3o classificados na mem\u00f3ria. Em nosso exemplo nos temos:</p> <ul> <li><code>0xfe10</code> \u00e9 o nivel, e espera-se que seja <code>0</code> (o primeiro nivel).</li> <li><code>0xf601</code> \u00e9 um endere\u00e7o de mem\u00f3ria de 8 bits, e nos usamos o prefixo <code>0xh</code> em vez de <code>0x</code> para significar isso. <code>0xf601</code> \u00e9 o modo de tela. A segunda e a terceira parte desta Condi\u00e7\u00e3o de In\u00edcio est\u00e1 dizendo \"o modo atual deve ser ingame (<code>0c</code>), e o modo no frame anterior N\u00c3O deve ser ingame\". Nota: O prefixo \"d\" no endere\u00e7o representa delta, ou \"o valor do frame anterior\". Resumindo: ative o leaderboard imediatamente ap\u00f3s iniciar uma fase (a partir da\u00ed vamos come\u00e7ar a medir o tempo).</li> <li>Finalmente n\u00f3s al\u00e9m de esperar que <code>0xfff0</code> seja aquivalente a <code>0</code>, porque <code>0xfff0</code> \u00e9 o modo de demonstra\u00e7\u00e3o e n\u00f3s n\u00e3o queremos enviar pontua\u00e7\u00f5es para a leaderboard quando a demo estiver ativa!</li> </ul>"},{"location":"Leaderboards-pt_BR/#condicoes-de-cancelamento","title":"Condi\u00e7\u00f5es de Cancelamento","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <ul> <li><code>0xfe13</code> \u00e9 o numero de vidas.</li> </ul> <p>A se\u00e7\u00e3o de cancelamento checa se o contador de VIDAS do jogador se tormar menor. Literalmente, isto diz \"Cancela se o ATUAL valor em 0xfe13 \u00e9 menor que o valor ANTERIOR em 0xfe13. N\u00f3s queremos que fa\u00e7a isso porque voce pode alcan\u00e7ar o checkpoint final e correr fora do tempo, resetando seu contador para 0:00. Nos n\u00e3o queremos permitir isso, porque isto n\u00e3o \u00e9 a forma correta de completar o nivel. Ent\u00e3o, se o jogardor morrer, n\u00f3s resetamos o progresso do leaderboard dele.</p>"},{"location":"Leaderboards-pt_BR/#condicoes-de-envio","title":"Condi\u00e7\u00f5es de envio","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <ul> <li><code>0xf7cc</code> isto \u00e9 a bandeira de final de fase, n\u00e3o-interativo.</li> </ul> <p>A se\u00e7\u00e3o de envio checa se o frame atual tem o marcador de 'endlevel' (fim de fase) for para verdadeiro (ou <code>!=0</code>, 'naozero'), e o frame anterior (delta) tem isto para ser falso (ou <code>=0</code>, 'zero'). Isto sugere que o jogador chegou ao fim do nivel, e provou ser um benchmark bastante robusto</p> <p>Dica: isto pode ser \u00fatil para observar estes valores na mem\u00f3ria para ver como eles executam, e que tipo de valores eles terminam em diferentes circunst\u00e2ncias.</p>"},{"location":"Leaderboards-pt_BR/#interpretador-de-valores","title":"Interpretador de Valores","text":"<p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Finalmente, valores. Uma vez que o jogador chegou ao inicio da condi\u00e7\u00e3o, eles ir\u00e3o ser mostrados em uma caixa quue permanece na tela, aparecendo o progresso deles at\u00e9 agora. Se \u00e9 uma leaderboard de tempo, ser\u00e1 um rel\u00f3gio, e se for uma pontua\u00e7\u00e3o, ser\u00e1 apenas o valor. Se eles cumprirem a condi\u00e7\u00e3o de cancelamento, eles ser\u00e3o informados de que eles falharam, e o pop-up ser\u00e1 removido. Se caso o jogador chegar com sucesso \u00e0 condi\u00e7\u00e3o de envio, o valor atual ser\u00e1 pego e submetido como pontua\u00e7\u00e3o. o pop-up ingame ir\u00e1 informar o jogador o t\u00e3o longe da leaderboard, e a posi\u00e7\u00e3o deles na leaderboard.</p> <p>A condi\u00e7\u00e3o de valor \u00e9 especial em poucas maneiras. Ele \u00e9 avaliado constantemente e exibido na tela o tempo todo quando a leaderboard est\u00e1 ativa. Isto n\u00e3o funciona como as outras condi\u00e7\u00f5es. Isto espera endere\u00e7os da seguinte maneira:</p> <p><code>endere\u00e7o*modificador</code> (endere\u00e7o tempo modificador)</p> <p>e usa o <code>_</code> sublinhado como um 'plus'. O <code>*</code> asterisco significa 'm\u00faltiplo', ent\u00e3o no valor</p> <p><code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>representa:</p> <p>8-bit <code>0xfe24</code> vezes 1, MAIS 8-bit <code>0xfe25</code> vezes 60, MAIS 8-bit <code>0xfe22</code> vezes 3600</p> <p>A raz\u00e3o para isso \u00e9 que os valores em cada um desses endere\u00e7os significam frames, segundos e minutos respectivamentes. Quando nos adicionamos esses valores juntos, n\u00f3s conseguimos um grande total em frames que vamos enviar para o \"Banco de dados\".</p> <p>Lembre que o campo 'Formato' pode ser Pontua\u00e7\u00e3o, Tempo (Frames), Tempo (Milisegundos) ou Valor. Tempo(Frames) \u00e9 o mais comum, e representa 'frames'. Tempo (Milisegundos) espera um valor que nos podemos converter diretamente para milisegundos. (Super Mario Kart usa isso). No entanto, para converter um valor em frame dentro de um formato \"para ser lidos por humanos\", nos devemos dividiu o valor por 60 para uma representa\u00e7\u00e3o de segundos correta, e um valor em milisegundos deve ser dividido por 100 para conseguir o numero de segundos. Isso \u00e9 usado no site e no aplicativo para exibir o valor apropriadamente, e \u00e9 importante para distinguir, para que possamos ter certeza de obter o valor mais preciso do emulador, usando qualquer formato que eles usem para registrar o tempo.</p>"},{"location":"Leaderboards-pt_BR/#ajuda-adicional","title":"Ajuda Adicional","text":"<p>Infelizmente h\u00e1 MUITAS maneiras de este processo dar errado, ent\u00e3o, se voce tiver algum problema, sinta-se livre pra pedir ajuda em nosso servidor do Discord.</p> <p>Se voc\u00ea quer praticar, \u00e9 altamente recomendado criar sua pr\u00f3pria leaderboard e tentar alguma coisa em um novo jogo, melhor que usar uma leaderboard existente</p> <p>Por favor, lembre-se que esses arquivos s\u00e3o puxados diretamente para o jogo de algu\u00e9m se eles decidirem jog\u00e1-lo, e uma m\u00e1 forma\u00e7\u00e3o de endere\u00e7o de mem\u00f3ria ou linha pode causar um crash no emulador, ent\u00e3o por favor, teste seu c\u00f3digo da leaderboard!</p>"},{"location":"Leaderboards-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-28 11:35] meleu:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 03:15] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:56] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:55] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:49] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:44] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:38] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:37] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:36] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> <li><code>[2018-03-28 02:35] KingDice001:</code> Updated Leaderboards pt_BR (markdown)</li> </ul>"},{"location":"Leaderboards/","title":"Leaderboards","text":"<ul> <li>Overview</li> <li>Example</li> <li>Start Conditions</li> <li>Cancel Conditions</li> <li>Submit Conditions</li> <li>Value</li> <li>Value Format</li> <li>Design Tips</li> <li>Score Wrapping</li> <li>Further Help</li> </ul>"},{"location":"Leaderboards/#overview","title":"Overview","text":"<p>This is how a game's Leaderboard List looks like on the website:</p> <p></p> <p>In the center you can see every already made Leaderboard, and in the right column you can see the Code Notes for the game. The Code Notes are here to help with some conditions we'll see below.</p> <p>And now you can also create and edit Leaderboards through the GUI just like achievements by selecting Leaderboards from the Assets List:</p> <p></p> <p>Here's a brief explanation of each field of a single Leaderboard:</p> <ul> <li>Title: the leaderboard's title.</li> <li>Description: the leaderboard's description.</li> <li>Format: specifies how the value should be displayed.</li> <li>\"LowerIsBetter\" checkbox: determines how the list should be sorted. When checked, lower value appear as higher ranks in the leaderboard. Time-based leaderboards usually honor faster times (lower), whereas score-based leaderboards favor higher values.</li> <li>Start: start conditions, aka STA.</li> <li>Cancel: cancel conditions, aka CAN.</li> <li>Submit: submit conditions, aka SUB.</li> <li>Value: a value interpreter, aka VAL.</li> <li>Display Order: The order leaderboards appear and also used for hiding them from view if set to -1. This can only be edited from the site editor.</li> </ul> <p>Note: A valid leaderboard MUST have all four of these conditions, even if they're set to always be true (<code>1=1</code>) or always be false (<code>0=1</code>).</p> <p>Those last 4 fields are really important and LOTS of care must be taken over the entry of any characters into these strings. That's why they deserve a further explanation:</p> <p>The Start (STA) condition is a series of values, like an achievement, that must be true in order to start looking for a leaderboard submission. </p> <p>If a Cancel (CAN) condition is true, then it will cancel the leaderboard and no score will be submitted. NOTE: Cancel is given priority over Start. If both become true in the same frame, the leaderboard will not start.</p> <p>If the Submit (SUB) condition is true, then the leaderboard score will be submitted. NOTE: Cancel is given priority over Submit. If both become true in the same frame, the score will not be submitted.</p> <p>Finally, the Value (VAL) is a special case, and will be taken from memory using the formula stated in the memory box. This is the score that gets displayed while the leaderboard is active, and the value that's submitted if SUB is true.</p> <p>Memory addresses for STA/CAN/SUB/VAL have the format defined here.</p> <p>NOTE: Once an active leaderboard is cancelled or submitted, it cannot be reactivated until the Start condition becomes false, then true again. This prevents the leaderboard from immediately reactivating after submission/cancel.</p>"},{"location":"Leaderboards/#example","title":"Example","text":"<p>The best place to start is to look at existing leaderboards and break it down to see how it works. We're going to use the Green Hill Act 1 (Sonic the Hedgehog) Leaderboard for this purpose. Then let's see how it looks:</p> <p></p> <p>The Title/Description fields are quite obvious.</p> <p>The Type is \"Time (Frames)\". The value we're tracking updates once a frame, and the Genesis runs at 60 frames per second. (see not below for systems that run at other speeds)</p> <p>The Lower Is Better flag is checked, then the one who makes the shortest time will be the #1.</p> <p>Now we're going to break down the most important parts.</p>"},{"location":"Leaderboards/#start-conditions","title":"Start Conditions","text":"<p>STA: <code>0xfe10=h0000_0xhf601=h0c_d0xhf601!=h0c_0xfff0=0</code></p> <p></p> <ul> <li><code>0xfe10=h0000</code>: If 16-bit RAM address 0xfe10 is equivalent to hex 0000,</li> <li><code>_</code>: AND,</li> <li><code>0xhf601=h0c</code>: If 8-bit RAM address 0xf601 is equivalent to hex 0c,</li> <li><code>_</code>: AND,</li> <li><code>d0xhf601!=h0c</code>: If the previous 8-bit RAM address 0xf601 is NOT equivalent to hex 0c,</li> <li><code>_</code>: AND,</li> <li><code>0xfff0=0</code> If 16-bit RAM address 0xfff0 is equivalent to 0.</li> </ul> <p>This might seem daunting, because we don't know what these addresses mean. That's why the Code Notes in the right column are pretty handy! You can see how these addresses are labeled in memory. In our example we have:</p> <ul> <li><code>0xfe10</code> is the level, and is expected to be <code>0</code> (the first level).</li> <li><code>0xf601</code> is an 8-bit memory address, and we use the prefix <code>0xh</code> instead of <code>0x</code> to signify this. The <code>0xf601</code> is the screen mode. The second and third parts of the start statement are saying \"the current mode should be ingame (<code>0c</code>), and the mode on the previous frame should NOT be ingame\". Note: that <code>d</code> prefix on the address represents delta, or \"the previous frame's value\". Summing up: trigger this if we've JUST arrived in a level (the start of the level, when we want to start testing their time).</li> <li>Finally we also expect <code>0xfff0</code> to be equivalent to <code>0</code>, because this address is used for demo mode, and we don't want to award a leaderboard entry when the demo is active!</li> </ul> <p>Tip: the most common mistake when creating leaderboards through the site editor is forgetting the <code>h</code> when trying to reference an 8-bit memory address.</p> <p>Note: You can use HitCounts in the Start/Submit/Cancel triggers, but you are responsible for resetting them. These triggers are evaluated every frame, and the state of the leaderboard is dependent on which ones are true. As such, the HitCount will increment even when the leaderboard is not active unless you have an explicit ResetIf condition.</p>"},{"location":"Leaderboards/#cancel-conditions","title":"Cancel Conditions","text":"<p>CAN: <code>0xhfe13&lt;d0xhfe13</code></p> <p></p> <ul> <li>0xfe13 is the number of lives.</li> </ul> <p>The cancel section checks if the player's LIVES counter ever becomes lower. Literally, it says \"Cancel if the CURRENT value at 0xfe13 is less than the PREVIOUS value at 0xfe13\". We want to do this because you could reach the final checkpoint and run out of time, resetting your timer to 0:00. We don't want to allow this, because it's not the correct way of completing the level. So if the player dies, we reset their leaderboard progress. Finally, if you connect two cancel conditions with <code>s</code>, the leaderboard will cancel when either one of them are true.</p>"},{"location":"Leaderboards/#submit-conditions","title":"Submit Conditions","text":"<p>SUB: <code>0xf7cc!=0_d0xf7cc=0</code></p> <p></p> <ul> <li>0xf7cc is the endlevel flag, non-interactive.</li> </ul> <p>The submit section checks if the current frame has the 'endlevel' flag set to true (or <code>!=0</code>, 'nonzero'), and the previous frame (delta) has it set to false (or <code>=0</code>, 'zero'). This suggests that the player has reached the end of the level, and has proven to be a fairly sturdy benchmark.</p> <p>Tip: it can be useful to watch these values in memory to see how they perform, and what sort of values they end up at in different circumstances.</p>"},{"location":"Leaderboards/#value","title":"Value","text":"<p>Finally, value. Once the player has reached the start condition, they will be shown a popup which remains on-screen, showing their progress so far. If it's a time leaderboard, it will be a clock, and if it's a score, it will just be the value. If they fulfill the cancel condition, they will be told that they have failed, and the popup will be removed. If they successfully reach the submit condition, the current value will be taken and submitted as their score, and on successful submission, an in game popup will inform the player of the leaderboard so far, and their position in the leaderboard.</p> <p>For more information on the value format, see Value Definition.</p> <p>NOTE: The value calculation is performed using 32-bit signed integers. As such, the maximum value is 2147483647 and the minimum value is -2147483648. Values above the maximum will wrap around and register as very negative numbers. </p>"},{"location":"Leaderboards/#value-format","title":"Value Format","text":"<p>'Format' can be any of the available formats, but the editor currently only provides Score, Time (Frames), Time (Milliseconds) and Value. Time (Frames) is the most common one, and represents a time derived from a value that increments every frame. It does this by multiplying by 100 (to convert to hundredths of a second) and dividing by 60 (the number of frames per second).</p> <p>NOTE: If you're using a system that doesn't run at 60Hz, you have to use \"Time (millisecs)\" and multiply by some value to do the conversion yourself (50Hz = <code>*2</code> [100/50], 60Hz = <code>*1.666666</code> [100/60], 75Hz =<code>*1.333333</code> [100/75]).</p> <p>NOTE: Time (Milliseconds) is actually hundredths of a second, not thousandths of a second. i.e. a Value of 6234 would be 62.34 seconds, not 6.234 seconds.</p>"},{"location":"Leaderboards/#design-tips","title":"Design Tips","text":"<p>Leaderboards can sometimes get pretty spammy and take up a lot of screen space when starting or depending on how many are active at once. It is generally good practice to try and eliminate this as much as possible when you can. You can do this by taking advantage of the fact that you can start and submit a leaderboard on the same frame by setting the start condition to what you would normally use as the submit and then setting the submit condition so something that is always true like 1=1.</p> <p>If a game tracks a score or time that you are using to directly call for your value then consider starting and submitting the leaderboard on the same frame so that only one popup is called (for the submission) and the screen won't have extra clutter. There are still cases where it can be useful for players to have the values up on display if they are hidden in menus so use your best judgement. </p> <p>In games where levels are short and retries are quick you really don't want to have it start/cancel/submit repeatedly after each start/retry when you can help it as the popups can start stacking together and clutter the screen well past the actual attempts are over. These are a prime candidate for starting and submitting on the same frame when possible.</p>"},{"location":"Leaderboards/#score-wrapping","title":"Score Wrapping","text":"<p>In games where the high score wraps around back to 0 it is actually possible to account for this and keep your leaderboard tracking the score! You can do this by using Alt Groups combined with MeasuredIf to track which loop you are on and will use one Alt per loop.</p> <p>As an example lets take a look at Balloon Fight on NES where the score wraps around after 999,990. Here is the original leaderboard:</p> <p></p> <p>And an updated version which will continue tracking after each loop: Core needs to have a Measured statement in it so just put something that is never true and also a ResetIf for resetting the MeasuredIf statements in the Alt Groups when needed (in this case on the title screen)</p> <p></p> <p>The first Alt will contain the normal logic for high score</p> <p></p> <p>The next Alt will contain a MeasuredIf that is true after the first loop which will allow this value to be used. You will also add an extra condition to AddSource in the total score from the first loop which will be 1,000,000 in this case. This value will now be used since MeasuredIf is true and the value is the highest of the Alt Groups</p> <p></p> <p>For the next Alt we increment the number of hits used in the loop detection as well as the value we multiply the total score added by for each loop</p> <p></p>"},{"location":"Leaderboards/#further-help","title":"Further Help","text":"<p>There are unfortunately MANY ways to get this process wrong, so if you are having any trouble feel free to ask for help in our Discord server.</p> <p>If you want to practice, it's highly recommended to create your own leaderboard and attempting something on a new game, rather than using an existing leaderboard. Just remember to clean up any test leaderboards that you push to the site afterwards.</p> <p>Please remember that these files are pulled directly into someone's game if they decide to play it, and a badly formed memory address or string could cause their emulator to crash, so please test your leaderboard code!</p>"},{"location":"Leaderboards/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:08] televandalist:</code> Added ToC</li> <li><code>[2022-05-30 18:49] Searo:</code> Cleanup</li> <li><code>[2022-05-30 18:45] Searo:</code> Typos</li> <li><code>[2022-05-30 18:35] Searo:</code> Misc updates</li> <li><code>[2022-02-04 17:36] Jamiras:</code> extract memory sizes</li> <li><code>[2022-02-04 16:47] Jamiras:</code> extract Value Definition to separate page</li> <li><code>[2021-10-23 12:28] Jamiras:</code> Updated Leaderboards (markdown)</li> <li><code>[2021-06-08 10:07] Jamiras:</code> Updated Leaderboards (markdown)</li> <li><code>[2021-04-26 13:35] meleu:</code> fix link</li> <li><code>[2020-11-13 16:36] Jamiras:</code> Updated Leaderboards (markdown)</li> </ul>"},{"location":"Measured-Flag/","title":"Measured Flag","text":"<p><code>Measured</code> marks a condition for tracking progress. It adds a progress bar to the achievement overlay to inform the user how close they are to completing an achievement. As the user expects an achievement to trigger when the progress bar is full, it is expected that any other conditions in the achievement should be true most of the time.</p> <p><code>Measured</code> should not be used to track things that are clearly visible to the user. If you have an achievement for getting 500,000 points, you don't need to Measure it if the score is displayed on the screen. Similarly, there's no need to use <code>Measured</code> in an achievement for having 100 of something in the inventory if the player can see a count of how many they have just by opening the inventory.</p> <p>If placed on a condition with a required HitCount, the target value is the required HitCount and the current value is the current HitCount. <code>AddHits</code> can be used.</p> <p>If placed on a condition without a HitCount, the target value is the constant on the right side of the condition and the current value is the evaluation of the left side of the condition. <code>AddSource</code> and <code>SubSource</code> can be used.</p> <p>If multiple conditions are marked as <code>Measured</code> and have the same target value, the current value will be the maximum of all the <code>Measured</code> conditions.</p> <p>If multiple conditions are marked as <code>Measured</code> and have different target values, a Parse Error -22 will occur.</p> <p>Note that progress for <code>Measured</code> values is reported at the time of examination and may actually go down depending on the current value (Hit Count could be reset, or comparison value decreases).</p> <p>To limit the scope of a <code>Measured</code> condition, you can add a <code>MeasuredIf</code> condition. A <code>MeasuredIf</code> condition must be true for the <code>Measured</code> value to be non-zero (and for the achievement to trigger). You can use <code>MeasuredIf</code> to create achievements that require playing as a certain character, or just to prevent bogus data from showing up if the player is in the wrong part of the game. If any <code>MeasuredIf</code> condition in a group is false, the <code>Measured</code> value for the group is automatically 0.</p> <p>Since <code>PauseIf</code> has precedence over <code>Measured</code>, the <code>Measured</code> value will be captured when a group becomes paused, and the captured value will be returned until the group is unpaused and <code>Measured</code> can be evaluated again. If another <code>Measured</code> exists in a non-paused group, its value will be returned even if it is lower than the captured value.</p>"},{"location":"Measured-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-10 11:56] Jamiras:</code> Updated Measured Flag (markdown)</li> <li><code>[2022-09-10 11:56] Jamiras:</code> Updated Measured Flag (markdown)</li> <li><code>[2022-03-19 07:21] Jamiras:</code> add note about behavior when Paused</li> <li><code>[2021-05-01 07:28] meleu:</code> fix link to AddHits page</li> <li><code>[2020-05-17 14:14] Jamiras:</code> add MeasuredIf</li> <li><code>[2019-11-14 19:42] Jamiras:</code> Created Measured Flag (markdown)</li> </ul>"},{"location":"Memory-Inspector-Overview-es/","title":"Un vistazo al Inspector de Memoria","text":"<p>Aqui un vistazo del Inspector de Memoria y sus caracteristicas. Esta herramienta se puede encontrar en la pesta\u00f1a de \"RetroAchievements\" en cualquier emulador integrado con RA.</p> <p>Tambien mira: Tips en la Busqueda de Memoria.</p>"},{"location":"Memory-Inspector-Overview-es/#ventana-del-inspector-de-memoria","title":"Ventana del Inspector de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#1-reset-to-resetear-en","title":"1. Reset to (Resetear en)","text":"<p>Haz click en uno de los botones para empezar una nueva pruba. Por lo general pruebas en 8-bit es lo mas apropiado. </p>"},{"location":"Memory-Inspector-Overview-es/#2-filter-values-filtrar-valores","title":"2. Filter Values (Filtrar Valores)","text":"<p>Usualmente vas a filtrar ya sea en <code>=</code> (igual a) el ultimo valor conseguido o <code>!=</code> (diferente que) el ultimo valor conseguido. Si conoces el valor exacto que deseas buscar, puedes utilizar <code>Given Value</code>(Valor entregado), o si estas convencido que el valor tuvo que haber incrementado, puedes intentar <code>&gt;</code> (mayor que) o <code>&lt;</code> (menor que).</p>"},{"location":"Memory-Inspector-Overview-es/#3-filter-filtrar","title":"3. Filter! (Filtrar)","text":"<p>Cada vez que presiones este boton, estas filtrando los valores que no concuerdan en memoria entre el ultimo testeo y el de ahora.</p>"},{"location":"Memory-Inspector-Overview-es/#4-ventana-de-resultados","title":"4. Ventana de Resultados","text":"<p>Despues de haber filtrado los resultados miraras en la ventana exactamente que es lo que paso, cuantos valores has conseguido y cuantos estan fuera. Algunos puntos a tener en cuenta:</p> <ul> <li>Los resultados muestran cambios en los valores en tiempo real, asi puedes identificar mas facilmente las variables utiles.</li> <li>Los resultados en la busqueda estan resaltados dependiendo el criterio. Para valores que no cumplen el filtro de busqueda, van a estar resaltados en rojo. Puedes desactivar esto en la casilla de <code>Highlights</code> , si asi lo prefieres.</li> <li>Tambien puedes manualmente excluir cualquier variable seleccionada de la busqueda. Utiliza la tecla Ctrl o Shift para seleccionar multiples a la vez.</li> <li>Historial de Resultados: Te puedes mover hacia atras (<code>&lt;&lt;</code>) o hacia adelante (<code>&gt;&gt;</code>) por medio de las busquedas anteriores. Ten en cuenta que si empiezas una nueva busqueda (una <code>New 8-bit Test</code>), tu historial va a ser borrado.</li> </ul>"},{"location":"Memory-Inspector-Overview-es/#5-watching-observando","title":"5. Watching (Observando)","text":"<p>Cualquier valor que se encuentre aqui va a ser observado en el Visor de Memoria y se mostraran sus notas de codigo a la derecha. La direccion tiene que ser <code>0x</code> (Un cero, y despues una letra x), seguido de digitos hexadecimales.</p>"},{"location":"Memory-Inspector-Overview-es/#6-visor-de-memoria","title":"6. Visor de Memoria","text":"<p>Cualquier variable que se este observando y las variables que tiene alrededor se muestran en esta ventana. Puedes ver mas informacion a continuacion, en la seccion de Leyendo informacion en el Visor de Memoria.</p>"},{"location":"Memory-Inspector-Overview-es/#7-notas-de-codigo","title":"7. Notas de Codigo","text":"<p>Una vez que hubieras encontrado un valor en memoria del que quieras hacer una nota, serciorate que el valor este introducido en la caja que dice 'Watching' (Observando). Ahora puedes escribir una peque\u00f1a descripcion en la caja de texto, y hacer click en <code>Save Note</code> (Salvar Nota). Esto va a mandar el valor en memoria y su descripcion a la base de datos, para que puede ser compartida con todos los desarrolladores que trabajen con este juego.</p> <p>Haz click en la fleca hacia abajo para ver cuales valores en memoria han sido encontrados hasta ahora, junto con su descripcion, la cual te dice para que sirve esa variable.</p> <p>Intenta mantener tus descripciones limpias y simples, para que sean facil de entender. Para re-escribir una nota, seleccionala en la lista desglozable, actualiza la descripcion, y haz click en <code>Save Note</code> (Salvar Nota). Una ventana va a salir confirmando sobre-escribir la nota existente - checa si esta bien el cambio, y haz click en OK.</p> <p>Si deseas remover una nota, seleccionala en el menu desglozable, y haz click en <code>Remove</code> (Remover).</p>"},{"location":"Memory-Inspector-Overview-es/#8-marcadores-de-memoria","title":"8. Marcadores de Memoria","text":"<p>Cuando haces click en el boton <code>Open Memory Bookmarker</code> (Abrir Marcadores de Memoria) vas a ver esta ventana:</p> <p></p> <p>Con esto, puedes ver multiples variables designadas al mismo tiempo en vez de estar moviendote por todo el Inspector.</p> <p>Los marcadores pueden ser renombrados haciendo doble-click en su descripcion. Si haces doble click en la variable, te puedes mover directamente a ella en el Inspector de Memoria.</p> <p>Valores agregados al marcador se van a mostrar en el inspector de memoria de color verde. Desde aqui tambien puedes Freezear (Congelar) cualquier marcador.</p> <p>Esto es util para cosas como vida o consumibles. Congelar variables puede ser manipulado directamente desde el inspector. Ten en mente que, el congelamiento ocurre 1 frame despues del gameplay. Esto significa que incluso cuando este congelada, el valor no va a cambiar al menos que pase un frame para que pueda congelarse la variable. Esto siempre se va a mostrar como amarillo.</p>"},{"location":"Memory-Inspector-Overview-es/#leyendo-informacion-en-el-visor-de-memoria","title":"Leyendo informacion en el Visor de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#notaciones-decimales-binarias-y-hexadecimales","title":"Notaciones Decimales, Binarias y Hexadecimales","text":"<p>Para trabajar bien con el Visor de Memoria, es importante entender minimo lo basico de los numeros binarios y hexadecimal. Aqui hay algunos recursos de informacion sobre este tema sin irnos a detalles muy extremos:</p> <ul> <li>https://es.wikipedia.org/wiki/Sistema_binario</li> <li>https://es.wikipedia.org/wiki/Sistema_hexadecimal</li> </ul> <p>Los digitos utilizados en el sistema binario son <code>0</code> y <code>1</code>. Un digito binario tambien es conocido como un bit. Ocho bits tambien se le conocen como un byte.</p> <p>Los digitos utilizados en el sistema hexadecimal son <code>0</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>7</code>, <code>8</code>, <code>9</code>, <code>A</code>, <code>B</code>, <code>C</code>, <code>D</code>, <code>E</code> y <code>F</code>. La notacion hexadecimal tambien se le conoce como hex.</p> <p>La razon principal para estas 2 notaciones, mas alla del sistema decimal tradicional, son:</p> <ul> <li>Notacion Decimal es lo que los humanos entienden.</li> <li>Notacion Binaria es lo que las computadoras \"entienden\".</li> <li>Notacion Hexadecimal se puede llegar a ver como un punto medio entre la binaria y la decimal. Porque un solo digito hexadecimal representa 4 bits, entonces es una notacion mas corta y entendible con la que pueden trabajar los humanos y las computadoras tambien pueden \"entender\".</li> </ul> <p>La siguiente table muestra las direntes notacion para sus valores equivalentes.</p> Decimal Hexadecimal Binario <code>0</code> <code>0x0</code> <code>0000</code> <code>1</code> <code>0x1</code> <code>0001</code> <code>2</code> <code>0x2</code> <code>0010</code> <code>3</code> <code>0x3</code> <code>0011</code> <code>4</code> <code>0x4</code> <code>0100</code> <code>5</code> <code>0x5</code> <code>0101</code> <code>6</code> <code>0x6</code> <code>0110</code> <code>7</code> <code>0x7</code> <code>0111</code> <code>8</code> <code>0x8</code> <code>1000</code> <code>9</code> <code>0x9</code> <code>1001</code> <code>10</code> <code>0xA</code> <code>1010</code> <code>11</code> <code>0xB</code> <code>1011</code> <code>12</code> <code>0xC</code> <code>1100</code> <code>13</code> <code>0xD</code> <code>1101</code> <code>14</code> <code>0xE</code> <code>1110</code> <code>15</code> <code>0xF</code> <code>1111</code> <p>Mas datos sobre las diferentes notaciones:</p> <ul> <li>Para indicar que un valor esta escrito en hexadecimal, se utiliza el prefijo <code>0x</code>: <code>0x10 = 16</code>, <code>10 = 10</code>.</li> <li>Dos digitos hex representan 8 bits y tienen un rango entre <code>0</code> y <code>255</code>. </li> <li>Cuatro digitos hex representan 16 bits y tienen un rango entre <code>0</code> y <code>65535</code>.</li> <li>Ocho digitos hex representan 32 bits y tienen un rango entre <code>0</code>y <code>4294967295</code>.</li> </ul>"},{"location":"Memory-Inspector-Overview-es/#modos-en-el-visor-de-memoria","title":"Modos en el visor de Memoria","text":"<p>La parte de hasta abajo del Inspector de Memoria es lo que llamamos visor de Memoria:</p> <p></p> <p>Puedes ver la informacion en el Visor de Memoria utilizando los modos 8, 16 y 32-bit.</p>"},{"location":"Memory-Inspector-Overview-es/#modo-8-bit","title":"Modo 8-bit","text":"<p>Por defecto, el Visor de Memoria muestra la informacion en modo de 8-bit. Esto muestra cada byte de memoria como un valor de dos-caracteres hexadecimales por separado. Cada byte tiene su propia direccion.</p> <p>Dieciseis bytes son mostrados por linea. La direccion de un byte se puede determinar a\u00f1adiendo la posicion de la fila (mostrada a la izquierda del vizor) a la posicion de la columna (mostrada arriba del visor). Usando la imagen de arriba como un ejemplo, el cursor esta en <code>0x002a7</code> (<code>0x002a0</code> + <code>7</code>).</p>"},{"location":"Memory-Inspector-Overview-es/#modo-1632-bit","title":"Modo 16/32-bit","text":"<p>Antes de que hables del modo de 16-bit mode y 32-bit, es importante saber sobre el endianness (extremidad):</p> <p>Valores que necesitan mas de 8-bits (en otras palabras: mas grandes que 255) necesitan estar almacenado en multiples bytes. Inclusive, los sistemas emulados que utilizamos almacenan valores de multiples-bytes en orden little-endian.</p> <p>En la imagen del Visor de Memoria de arriba puedes ver que en la direccion <code>0x0002c0</code> tenemos el valor hexadecimal <code>ce</code> y en <code>0x0002c1</code> el valor es <code>39</code>. Cuando cambias el visor a modo de 16-bit, los valores <code>ce</code> y <code>39</code> se agrupan en <code>0x0002c0</code> y son mostrados como <code>39ce</code>. Esto pasa porque automaticamente agrupa cada dos bytes y los muestra como valos hexadecimales de 16-bit.</p> <p>NOTA: Mientras que los valores de 16-bits se alinean generalmente a direcciones pares, este no siempre es el caso. De hecho hay un valor de 16-bit que no se muestra en <code>0x0002c1</code>. Ya que el valor en <code>0x0002c1</code> es <code>39</code> y el valor en <code>0x0002c2</code> es <code>29</code>, el valor de 16-bit value en la direccion <code>0x0002c1</code>es <code>0x2939</code>.</p> <p>Similarmente en, el modo de 32-bit, los cuatro bytes de <code>0x0002c0</code> a <code>0x0002c3</code> se muestran como un solo valor de 32-bit <code>0x252939ce</code> en la direccion <code>0x0002c0</code>, pero tambien hay valores de 32-bit en <code>0x0002c1</code>, <code>0x0002c2</code>, and <code>0x0002c3</code>.</p>"},{"location":"Memory-Inspector-Overview-es/#endianness","title":"Endianness","text":"<p>Se describe como Endianness el orden en el que una secuencia de bytes se encuentra almacenada en memoria de una computadora. Los dos tipos mas comunes son: Big-Endian (tambien conocido como BE) y Little-Endian (tambien conocido como LE).</p> <p>En el orden Big-Endian la \"big end\" (extremidad) de un numero (el valor mas significativo en secuencia) es almacenado primero (posicionado en la direccion mas peque\u00f1a). En la imagen de abajo puedes ver el numero <code>0x12345678</code> almacenado en la direccion <code>0x100</code> en el sistema big-endian. Ten en cuenta que el byte mas significativo <code>0x12</code> se encunetra en la direccion <code>0x100</code>:</p> <p></p> <p>En el orden Little-Endian el \"little end\" (extremidad) de un numero (el valor menos significativo en secuencia) es almacenado primero (posicionado en la direccion mas grande). En la imagen de abajo puedes ver el numero <code>0x12345678</code> almacenado en la direccion <code>0x100</code> en orden little-endian. Ten en cuenta que el byte menos significativo <code>0x78</code> se encuentra en la direccion <code>0x100</code>:</p> <p></p>"},{"location":"Memory-Inspector-Overview-es/#trabajando-con-tamanos-inferiores-a-8-bit","title":"Trabajando con tama\u00f1os inferiores a 8-bit","text":"<p>En addicion al 8-bit, 16-bit y 32-bit los tama\u00f1os descritos arriba, existen tama\u00f1os adicionales que pueden ser utilizados al momentos que estemos creando logros (en el editor de Logros (Achievement Editor)).</p>"},{"location":"Memory-Inspector-Overview-es/#single-bits","title":"Single bits","text":"<p>En el visor de memoria cuando un valor de 8-bit es seleccionado vas a ver algo como la imagen de abajo (en la imagen: un byte con valor <code>6f</code> es seleccionado; los bits estan resaltados con un circulo naranja):</p> <p></p> <p>Es muy comun almacenar informacion importante en un solo bit. Ya que un bit solo puede tener dos posibles valores (<code>1</code> o <code>0</code>), algunas veces se utiliza para significarn \"si\" o \"no\", \"encendido\" o \"apagado\", \"tiene un item\" o \"no item\", etc. Algunos juegos, especialmente aquellos que tienen espacio muy limitado en memoria, utilizan bit como botones bastante.</p> <p>Importante: Puedes referirte a cada uno de esos bits indidualmente en el Editor de Logros (Achievement Editor).</p> <p>Significados mas comunes de botones de bit en la memoria de un juego:</p> <ul> <li>tienes un item</li> <li>boton presionado (muy comun)</li> <li>area explorada</li> <li>secuencia del juego activated</li> <li>cheat activado</li> <li>modo demo activo</li> </ul> <p>En el visor de memoria solo puedes ingresar valores hex, entonces es importante conocer la importancia entre valores con notacion hexadecimal y binaria. Puedes ver en la tabla de \"Notaciones Decimales, Binarias y Hexadecimales\" , pero lo usual es usar una calculadora (la calculadora default de MS Windows en modo programador puede hacer el trabajo)</p>"},{"location":"Memory-Inspector-Overview-es/#upper4-y-lower4","title":"Upper4 y Lower4","text":"<p>Upper4 son los cuatro bits superiores de un byte (bit: 7, 6, 5, 4), mostrados como un solo caracter hexadecimal. Lower4 son los cuatro bits inferiores de un byte (bit: 3, 2, 1, 0), mostrados como un solo caracter hexadecimal.</p> <p>Observando el diagrama de tama\u00f1o de memoria de abajo, un byte en la direccion <code>0x00a274</code> es seleccionado (valor <code>0x23</code>). El primer caracter, <code>2</code> es el valor Upper4. El segundo characterr <code>3</code> es el valor Lower4.</p> <p>Ocasionalmente solo vas a estar interesado en trabajar con solo un digito hexadecimal. Utilizando el diagrama de tama\u00f1o de memoria como un ejemplo, como una condicion de un logro donde <code>Upper4 0x00a274 = 0x2</code> seria verdadera. Una condicion donde<code>Lower4 0x00a274 = 0x3</code> seria verdadera.</p>"},{"location":"Memory-Inspector-Overview-es/#diagrama-de-tamano-de-memoria","title":"Diagrama de Tama\u00f1o de Memoria","text":""},{"location":"Memory-Inspector-Overview-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 20:18] meleu:</code> add link to spanish doc</li> <li><code>[2019-03-12 14:59] meleu:</code> Updated Memory Inspector Overview ES (markdown)</li> </ul>"},{"location":"Memory-Inspector-Overview/","title":"Memory Inspector","text":"<p>Here is an overview of the Memory Inspector and its features. This tool can be found on \"RetroAchievements\" menu on any emulator integrated with RA.</p> <p>See also: Memory Digging Tips.</p> <ul> <li>Memory Inspector Dialog<ul> <li>1. New Search</li> <li>2. Filter</li> <li>3. Results</li> <li>4. Code Notes</li> <li>5. Memory View</li> <li>Memory Bookmarks</li> </ul> </li> <li>Reading Data in the Memory Viewer<ul> <li>Decimal, Binary, and Hexadecimal Notations</li> <li>Memory Viewer Modes<ul> <li>8-Bit Mode<ul> <li>16 and 32-Bit Mode</li> </ul> </li> </ul> </li> <li>Working with Sizes Smaller Than 8-Bit<ul> <li>Single Bits</li> <li>Upper4 and Lower4</li> </ul> </li> </ul> </li> <li>Memory Sizes Diagram</li> </ul>"},{"location":"Memory-Inspector-Overview/#memory-inspector-dialog","title":"Memory Inspector Dialog","text":""},{"location":"Memory-Inspector-Overview/#1-new-search","title":"1. New Search","text":"<p>This is the first thing you must do when you're looking for something in memory. </p> <p>The first drop down allows you to quick select All memory, System RAM, or Cartridge RAM. The field below the first drop down lets you type in a custom range (i.e. 0x10000-0x100FF).</p> <p>The second drop down specifies the size of the data you're interested in finding.</p> <p>The <code>Reset</code> button clears out any previously captured results (part 3 of the dialog) and captures the current memory state.</p>"},{"location":"Memory-Inspector-Overview/#2-filter","title":"2. Filter","text":"<p>Filters the memory state in an attempt to locate a specific memory address.</p> <p>The first drop down allows you to specify the comparison to use. The second drop down is what you're comparing against. Most of the time you're going to be filtering on <code>!= Last Value</code>, which eliminates any results where the memory has not changed.</p> <p>The available comparisons are:</p> <ul> <li><code>Constant</code> - comparison is made against the value entered in the field below the drop down.</li> <li><code>Last Value</code> - comparison is made against the value captured by the last applied filter, or the initial value if no filter has been applied</li> <li><code>Last Value Plus</code> - comparison is made against the Last Value plus the value entered in the field below the drop down. If the value were 3, the comparison would me made against a number which is three higher than the Last Value for each value captured by the last applied filter.</li> <li><code>Last Value Minus</code> - the same as Last Value Plus, except the value entered in the field below the drop down is subtracted from each value captured by the last applied filter.</li> <li><code>Initial Value</code> - comparison is made against the value captured when the New Search was begun.</li> </ul> <p>The <code>Filter Once</code> button immediately applies the selected filter and updates the Results.</p> <p>The <code>Continuous Filter</code> button applies the selected filter repeatedly until stopped. The fewer the results, the more frequently the filter is applied. The filter is only applied once every N ms, where N is the number of results / 1000. If there are less than 1000 results, it's applied every frame. If there are 50000 results, it's applied every 500ms (twice a second). If there are 1000000 results, it's only applied every 10 seconds.</p>"},{"location":"Memory-Inspector-Overview/#3-results","title":"3. Results","text":"<p>As filtering is applied, the list of potential matches will appear here.</p> <p>On the left side is information about the results, including the number of matches, the filter applied, and how many filters have been applied. If you believe you have applied a filter incorrectly, or the filter results in no matches, you can use the <code>&lt;&lt;</code> button to return to the previous set of results. You can do this all the way back to the initial results. Similarly, you can use the <code>&gt;&gt;</code> button to return to results you have backed out of. Once you apply a new filter, the forward filters are discarded and the <code>&gt;&gt;</code> button is disabled.</p> <p>Below the result information are two buttons. The first allows you to manually remove the selected items from the result set. You can use Ctrl and Shift to select multiple items. The second lets you create a bookmark for an item in the result set. It will appear in the Bookmarks dialog.</p> <p></p> <p>The items in the result set show the address of the match, the current value, and a brief description of the memory at the address. If a code note exists for the address, it will be shown. Otherwise, a general classification of the address will be shown.</p> <p>Additionally, items in the result set can be colored.</p> <ul> <li>Red - the item does not currently match the filter</li> <li>Grey - the item does currently match the filter, but at some point since the filter was applied it did not match.</li> <li>Green - the item is bookmarked</li> <li>Blue - the item has a code note</li> </ul> <p>Clicking on a row will set the selected address to the associated item.</p>"},{"location":"Memory-Inspector-Overview/#4-code-notes","title":"4. Code Notes","text":"<p>Provides detailed information about the selected address, and allows the user to annotate addresses found by the search process. Try to keep your descriptions simple and clear, so they can be easily understood. Clear notes are important for debugging if a problem with an achievement occurs.</p> <p>The text field shows the currently selected address from the memory view (part 5 of the dialog). You can manually type in any address, or use the up and down arrows to jump to the next or previous address that have a code note.</p> <p>Just to the right of the text field is a button that opens the Code Notes dialog, which allows you to browse and search through the code notes.</p> <p>Below the text field is a button that will create a bookmark from the selected address.</p> <p>The large text area is where you can modify the code note for the selected address. NOTE: the changes are not saved unless you press the Save Note button. If you change the selected address without saving, the changes will be lost.</p> <p><code>Save Note</code> and <code>Delete</code> immediately attempt to update the server - either with the modified note text, or by clearing out the note text.</p>"},{"location":"Memory-Inspector-Overview/#5-memory-view","title":"5. Memory View","text":"<p>Allows direct browsing of the memory. The memory updates once per frame as the emulator runs.</p> <p>The currently selected address appears in red. Addresses with code notes show up blue, and addresses associated to bookmarks show up green.</p> <p>You can click on any piece of data in the memory viewer to jump to the associated address. You can also use the keyboard to navigation around in memory (up/down/left/right/pgup/pgdn/home/end).</p> <p>When the memory viewer is focused, a cursor will be visible. You can type any hexadecimal character to change the character at the cursor to another value. This immediately changes the value for the emulator, and may cause unexpected behavior, so use at your own risk. Additionally, modifying memory (through any of the tools) prevents achievements from being unlocked on the server as an anti-cheat mechanism.</p>"},{"location":"Memory-Inspector-Overview/#memory-bookmarks","title":"Memory Bookmarks","text":"<p>You can open the Memory Bookmarks dialog from the RetroAchievements menu. It will also automatically open when adding a bookmark from either of the buttons on the Memory Inspector dialog. </p> <p></p> <p>With this, you can view multiple designated addresses at once instead of having to shuffle around in the Inspector. Bookmarked addresses will show in the Memory Inspector as green.</p> <p>If you double-click on an address, you can move straight to that address in the Memory Inspector.</p> <p>The bookmarks can be renamed by clicking their description. This does not update the code note for the associated address.</p> <p>You can change the size or format of a bookmark by clicking on the field and selecting a new value from the dropdown. Clicking on the value field will allow you to enter a new value for the bookmark. It will automatically be written to the memory.</p> <p>From here you can also Freeze any bookmarks. This is helpful for things like health or consumables. Keep in mind, freezing occurs 1 frame after gameplay. This means that even when frozen, the value will change for at least one frame before returning to the frozen value. Frozen bookmarks will be displayed as yellow.</p>"},{"location":"Memory-Inspector-Overview/#reading-data-in-the-memory-viewer","title":"Reading Data in the Memory Viewer","text":""},{"location":"Memory-Inspector-Overview/#decimal-binary-and-hexadecimal-notations","title":"Decimal, Binary, and Hexadecimal Notations","text":"<p>To work well with the Memory Viewer, it's important to understand at least the basics of binary and hexadecimal numeral notations. Here are good sources of information about this matter without going into extreme details:</p> <ul> <li>https://simple.wikipedia.org/wiki/Binary_number</li> <li>https://simple.wikipedia.org/wiki/Hexadecimal_numeral_system</li> </ul> <p>The digits used in binary system are <code>0</code> and <code>1</code>. A binary digit is also known as bit. Eight bits is also known as one byte.</p> <p>The digits used in hexadecimal system are <code>0</code>, <code>1</code>, <code>2</code>, <code>3</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>7</code>, <code>8</code>, <code>9</code>, <code>A</code>, <code>B</code>, <code>C</code>, <code>D</code>, <code>E</code> and <code>F</code>. The hexadecimal notation is also known as hex.</p> <p>The main reasons for the existence of these 2 notations, besides the traditional decimal notation, are:</p> <ul> <li>Decimal notation is what humans understand.</li> <li>Binary notation is what computers \"understand\".</li> <li>Hexadecimal notation can be seen as a middle ground between binary and decimal. Because a single hexadecimal digit represents 4 bits, then a shorter and more understandable notation for humans to work in a way that the computer \"understands\".</li> </ul> <p>The table below shows the different notations for equivalent values.</p> Decimal Hexadecimal Binary <code>0</code> <code>0x0</code> <code>0000</code> <code>1</code> <code>0x1</code> <code>0001</code> <code>2</code> <code>0x2</code> <code>0010</code> <code>3</code> <code>0x3</code> <code>0011</code> <code>4</code> <code>0x4</code> <code>0100</code> <code>5</code> <code>0x5</code> <code>0101</code> <code>6</code> <code>0x6</code> <code>0110</code> <code>7</code> <code>0x7</code> <code>0111</code> <code>8</code> <code>0x8</code> <code>1000</code> <code>9</code> <code>0x9</code> <code>1001</code> <code>10</code> <code>0xA</code> <code>1010</code> <code>11</code> <code>0xB</code> <code>1011</code> <code>12</code> <code>0xC</code> <code>1100</code> <code>13</code> <code>0xD</code> <code>1101</code> <code>14</code> <code>0xE</code> <code>1110</code> <code>15</code> <code>0xF</code> <code>1111</code> <p>More facts about the different number notations:</p> <ul> <li>To indicate a value is written in hexadecimal, the prefix <code>0x</code> is used: <code>0x10 = 16</code>, <code>10 = 10</code>.</li> <li>Two hex digits represent 8 bits and can range from <code>0</code> to <code>255</code>. </li> <li>Four hex digits represent 16 bits and can range <code>0</code> to <code>65535</code>.</li> <li>Eight hex digits represent 32 bits and can range from <code>0</code>to <code>4294967295</code>.</li> </ul>"},{"location":"Memory-Inspector-Overview/#memory-viewer-modes","title":"Memory Viewer Modes","text":"<p>The bottom part of the Memory Inspector is what we call the Memory Viewer:</p> <p></p> <p>You can see data in Memory Viewer using 8, 16 or 32-bit modes.</p>"},{"location":"Memory-Inspector-Overview/#8-bit-mode","title":"8-Bit Mode","text":"<p>By default, the Memory Viewer shows data in 8-bit mode. This displays each byte of memory as a separate two-character hexadecimal value. And each byte has its own address.</p> <p>Sixteen bytes are shown per line. The address of a byte can be determined by adding the row index (displayed to the left of the viewer) to the column index (displayed above the viewer). Using the image above as an example, the cursor is at <code>0x002a7</code> (<code>0x002a0</code> + <code>7</code>).</p>"},{"location":"Memory-Inspector-Overview/#16-and-32-bit-mode","title":"16 and 32-bit Mode","text":"<p>Before we talk about 16-bit mode and 32-bit mode, it's important to know about endianness:</p> <p>Values that need more then 8-bits (in other words: larger than 255) have to be stored in multiple bytes. However, the emulated systems we use store multi-byte values in little-endian order.</p> <p>In the image of the Memory Viewer above you can see that at address <code>0x0002c0</code> we have the hex value <code>ce</code> and in <code>0x0002c1</code> the value is <code>39</code>. When you switch the viewer to 16-bit mode, the <code>ce</code> and <code>39</code> values are grouped at <code>0x0002c0</code> and get displayed as <code>39ce</code>. This happens because it automatically groups every two bytes and displays them as 16-bit hex values.</p> <p>NOTE: While 16-bit values are usually aligned to even addresses, that's not always the case. There's actually a non-displayed 16-bit value at <code>0x0002c1</code>. Since the value at <code>0x0002c1</code> is <code>39</code> and the value at <code>0x0002c2</code> is <code>29</code>, the 16-bit value at <code>0x0002c1</code> address is <code>0x2939</code>.</p> <p>Similarly, in 32-bit mode, the four bytes from <code>0x0002c0</code> to <code>0x0002c3</code> are displayed as a single 32-bit value <code>0x252939ce</code> at address <code>0x0002c0</code>, but there are also 32-bit values at <code>0x0002c1</code>, <code>0x0002c2</code>, and <code>0x0002c3</code>.</p>"},{"location":"Memory-Inspector-Overview/#endianness","title":"Endianness","text":"<p>Endianness describes the order in which a sequence of bytes are stored in computer systems memory. The two most common types are: Big-Endian (also known as BE) and Little-Endian (also known as LE).</p> <p>In the Big-Endian order the \"big end\" of the number (most significant value in the sequence) is stored first (placed at the lowest address). In the image below you see the number <code>0x12345678</code> stored at the address <code>0x100</code> in the big-endian order. Notice that the most significant byte <code>0x12</code> is at the address <code>0x100</code>:</p> <p></p> <p>In the Little-Endian order the \"little end\" of the number (least significant value in the sequence) is stored first. In the image below you see the number <code>0x12345678</code> stored at the address <code>0x100</code> in the little-endian order. Notice that the least significant byte <code>0x78</code> is at the address <code>0x100</code>:</p> <p></p>"},{"location":"Memory-Inspector-Overview/#working-with-sizes-smaller-than-8-bit","title":"Working with Sizes Smaller Than 8-Bit","text":"<p>In addition to the 8-bit, 16-bit and 32-bit sizes described above, there are additional sizes that can be used when writing achievements (in the Achievement Editor).</p>"},{"location":"Memory-Inspector-Overview/#single-bits","title":"Single Bits","text":"<p>In the memory viewer when an 8-bit address is selected you will see something like the image below (in the image: a byte with the value <code>6f</code> is selected; the bits are highlighted with an orange circle):</p> <p></p> <p>It is very common in games to store important information as a single bit. As a bit can only have two possible values (<code>1</code> or <code>0</code>), sometimes it's used to mean \"yes\" or \"no\", \"on\" or \"off\", \"have item\" or \"no item\", etc. Some games, specially those with limited memory space, use bit switches a lot.</p> <p>Important: You can refer to each one of those bits individually in the Achievement Editor.</p> <p>Common meaning of bit switches in a game memory:</p> <ul> <li>have an item</li> <li>button pressed (very common)</li> <li>area explored</li> <li>in game trigger activated</li> <li>cheat activated</li> <li>in demo mode</li> </ul> <p>In the memory viewer you can only input hex values, then it's important to know equivalence of values between hex and binary notations. You can see the table in the \"Decimal, Binary and Hexadecimal notations\" section, but the usual is to use a calculator (the default calculator on MS Windows on the programmer view can do the job).</p>"},{"location":"Memory-Inspector-Overview/#upper4-and-lower4","title":"Upper4 and Lower4","text":"<p>Upper4 is the upper four bits of a byte (bit: 7, 6, 5, 4), displayed as a single hexadecimal character. Lower4 is the lower four bits of a byte (bit: 3, 2, 1, 0), displayed as a single hexadecimal character.</p> <p>Looking at the memory size diagram below, a byte at address <code>0x00a274</code> is selected (value <code>0x23</code>). The first character, <code>2</code> is the Upper4 value. The second character <code>3</code> is the Lower4 value.</p> <p>Occasionally you will only be interested working with a single hexadecimal digit. Using the memory size diagram as an example, an achievement condition where <code>Upper4 0x00a274 = 0x2</code> would be true. A condition where <code>Lower4 0x00a274 = 0x3</code> would be true.</p>"},{"location":"Memory-Inspector-Overview/#memory-sizes-diagram","title":"Memory Sizes Diagram","text":""},{"location":"Memory-Inspector-Overview/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:27] televandalist:</code> Added ToC</li> <li><code>[2022-07-11 16:49] timenoe:</code> Small typo corrected concerning <code>!= Last Value</code> filter</li> <li><code>[2021-08-25 19:10] meleu:</code> fix markdown format</li> <li><code>[2020-06-11 07:34] Jamiras:</code> add details about Continuous Filter backoff algorithm</li> <li><code>[2020-05-17 21:48] Jamiras:</code> update for new memory inspector dialog</li> <li><code>[2019-03-14 00:37] Keltron3030:</code> Updated Memory Inspector Overview (markdown)</li> <li><code>[2019-03-14 00:35] Keltron3030:</code> Added some additional info to memory viewer features as requested by Jr developer.</li> <li><code>[2019-02-14 21:56] meleu:</code> bitfields image</li> <li><code>[2019-02-14 21:45] meleu:</code> test2</li> <li><code>[2019-02-14 21:44] meleu:</code> test</li> </ul>"},{"location":"Memory-Searching-Techniques/","title":"Memory Searching Techniques","text":"<p>Know good techniques? Add to this page.</p>"},{"location":"Minimum-Required-Versions-for-Logic-Features-es/","title":"Versiones M\u00ednimas Requeridas para Funciones en la L\u00f3gica","text":"<p>A veces es \u00fatil saber cuando una funci\u00f3n fue agregada/modificada y las implicaciones de esos cambios, especialmente si estas trabajando en un ticket. Compara la etiqueta de tiempo del ticket con los lanzamientos del toolkit para determinar con que comportamiento el jugador se ve\u00eda afectado.</p> Funci\u00f3n RA_Integration RetroArch ResetIf/PauseIf HitCount 0.073(31-Ago-2018) 1.7.4(30-Ago-2018) Tablas de Clasificaci\u00f3n Cancelar Y (Leaderboard Cancel AND) 0.073(31-Ago-2018) 1.7.0(25-Dic-2017) Tablas de Clasificaci\u00f3n \u00d3 (Leaderboard OR) 0.073(31-Ago-2018) 1.7.4(30-Ago-2018) Soporte para valores Completos de 32-bit 0.073(31-Ago-2018) 1.7.0(25-Dic-2017) Retrasar procesamiento de logros por los primeros 100 frames de cargar el ROM 0.073(31-Ago-2018) (ver la linea de abajo) Remplazar el retraso de 100 frames con la l\u00f3gica de activaci\u00f3n de retraso (delayed activation logic) 0.075(04-Feb-2019) 1.6.3(28-Jul-2017)"},{"location":"Minimum-Required-Versions-for-Logic-Features-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Minimum-Required-Versions-for-Logic-Features/","title":"Minimum Required Versions for Logic Features","text":"<p>Sometimes it's useful to know when a feature was added/changed and the implications of these changes, specially if you are working on a ticket. Compare the ticket timestamp to the toolkit releases to determine which behavior the player would have been subject to.</p> Feature RA_Integration RetroArch rcheevos Leaderboard Cancel AND 0.073(31 Aug 2018) 1.7.0(25 Dec 2017) n/a Full 32-bit value support 0.073(31 Aug 2018) 1.7.0(25 Dec 2017) n/a ResetIf/PauseIf HitCount 0.073(31 Aug 2018) 1.7.4(30 Aug 2018) n/a Leaderboard OR 0.073(31 Aug 2018) 1.7.4(30 Aug 2018) n/a Delay achievement processing for 100 frames on load 0.073(31 Aug 2018) n/a n/a Replace 100 frame delay with delayed activation logic 0.075(04 Feb 2019) 1.6.3(28 Jul 2017) n/a AndNext 0.76(21 Jun 2019) 1.7.7(7 May 2019) 8.0(4 May 2019) Prior 0.76(21 Jun 2019) 1.7.7(7 May 2019) 8.0(4 May 2019) 24-bit read 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.0.1(18 Jun 2019) AddAddress 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Measured 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Measured syntax for leaderboard values 0.77(30 Nov 2019) 1.8.2(25 Dec 2019) 8.1(21 Nov 2019) Detect and report Unsupported achievements 0.79(22 May 2021) 1.8.2(25 Dec 2019) n/a OrNext 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) BitCount 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) MeasuredIf 0.78(18 May 2020) 1.8.7(17 May 2020) 9.0(9 May 2020) Trigger 0.79(22 May 2021) 1.8.7(17 May 2020) 9.0(9 May 2020) Include hits in save states 0.073(31 Aug 2018) 1.9.1(28-Mar 2021) 9.0(9 May 2020) SubHits 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) ResetNextIf 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Ranges in rich presence lookups 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Maxof($) for Measured leaderboard values 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) ResetIf/PauseIf support for Measured leaderboard values 0.79(22 May 2021) 1.9.4(29 May 2021) 10.0(15 May 2021) Big Endian memory reads 1.0(29 Jan 2022) 1.9.9(5 Sep 2021) 10.2(27 Aug 2021) Measured raw/percent flag 1.0(29 Jan 2022) 1.9.9(5 Sep 2021) 10.2(27 Aug 2021) Floating point memory reads 1.0(29 Jan 2022) 1.10.1(6 Mar 2022) 10.3(14 Jan 2022) Built-in macros for rich presence 1.0(29 Jan 2022) 1.10.1(6 Mar 2022) 10.3(14 Jan 2022) MBF32 LE memory read 1.1(15 Nov 2022) 1.13.0(19 Nov 2022) 10.5(12 Nov 2022) XOR modifier 1.1(15 Nov 2022) 1.13.0(19 Nov 2022) 10.5(12 Nov 2022) Float BE memory reads 1.3(TBD) 1.17.0(3 Feb 2024) 11.0(2 Nov 2023) FixedN leaderboard/RP sizes 1.3(TBD) 1.17.0(3 Feb 2024) 11.1(21 Jan 2024)"},{"location":"Minimum-Required-Versions-for-Logic-Features/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-02-27 14:12] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2023-11-29 18:27] Jamiras:</code> stub for Float BE</li> <li><code>[2023-07-19 09:37] Jamiras:</code> update RetroArch versions for rcheevos 10.5 features</li> <li><code>[2022-11-15 14:46] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-11-12 07:15] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-03-06 10:44] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-29 11:05] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-13 09:14] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> <li><code>[2022-01-08 09:59] Jamiras:</code> add 0.80 DLL features</li> <li><code>[2021-06-03 13:48] Jamiras:</code> Updated Minimum Required Versions for Logic Features (markdown)</li> </ul>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/","title":"Tutorial para Jogos Multi-Discos","text":""},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#arquivos-m3u","title":"Arquivos .m3u","text":"<p>Alterar os discos no Playstation exige que voc\u00ea crie um arquivo playlist (.m3u) para seus discos. Isso pode soar intimidador, mas na verdade \u00e9 bem simples.</p> <p>Passo 1: Coloque seus arquivos .bin e .cue na localiza\u00e7\u00e3o desejada.</p> <p>Passo 2: Abra o Bloco de notas.</p> <p>Passo 3: Digite no bloco de notas o nome dos arquivos .cue da mesma forma que eles est\u00e3o no arquivo original. Quando voc\u00ea terminar, seu documento de texto vai estar parecido com algo mais ou menos assim:</p> <p></p> <p>Quando terminar, salve o documento de texto, na mesma localiza\u00e7\u00e3o que o disco do jogo, com o nome que voc\u00ea quiser.</p> <p>Passo 4: Renomeie o documento, mudando sua extens\u00e3o de .txt para .m3u</p> <p></p> <p>ATEN\u00c7\u00c3O: Se voc\u00ea n\u00e3o consegue ver a extens\u00e3o .txt no final do t\u00edtulo do seu documento de texto voc\u00ea precisar\u00e1 alterar as configura\u00e7\u00f5es para que extens\u00f5es sejam vis\u00edveis. No Windows 10 isso \u00e9 muito simples, voc\u00ea consegue encontrar essa op\u00e7\u00e3o na sua pasta em \"View\" e marcar a caixa \"File name extensions\".</p> <p></p> <p>E... pronto! Simples, n\u00e3o? A partir de agora, quando voc\u00ea for iniciar o jogo, abra ele pelo arquivo .m3u que voc\u00ea acabou de criar.</p> <p>ATEN\u00c7\u00c3O: Se voc\u00ea j\u00e1 jogou o primeiro disco do jogo e seus saves n\u00e3o est\u00e3o mais l\u00e1, voc\u00ea pode resgatar eles indo at\u00e9 a pasta \"saves\" do seu emulador, encontrando os arquivos de save e renomeando eles para igualar com o arquivo .m3u que voc\u00ea criou. Por exemplo:</p> <p>'Metal Gear Solid (v1.1) (Disc 1).mcr'   &gt;   'Metal Gear Solid (v1.1).mcr'</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#alterando-discos-no-ralibretro","title":"Alterando discos no RAlibretro","text":"<p>Para alterar os discos no RAlibretro, quando o jogo solicitar a troca, v\u00e1 para o menu \"File\" e siga esses passos</p> <p></p> <p>Passo 1: File &gt; CD-ROM &gt; Open Tray</p> <p>Passo 2: File &gt; CD-ROM &gt; Desired Disc</p> <p>Passo 3: File &gt; CD-ROM &gt; Close Tray</p> <p>E \u00e9 isso!</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#alterando-discos-no-retroarch","title":"Alterando discos no Retroarch","text":"<p>Voc\u00ea ir\u00e1 encontrar a op\u00e7\u00e3o em \"Quick Menu &gt; Disk Control\"</p> <p></p> <p></p> <p>Passo 1: Selecione \"Disk Cycle Tray Status\" (ATEN\u00c7\u00c3O: Se voc\u00ea tem a op\u00e7\u00e3o \"Pause when menu activated\" ativada, voc\u00ea precisar\u00e1 sair e entrar no menu novamente para que o jogo saiba que a tampa do disco foi aberta)</p> <p>Passo 2: Selecione \"Disk Index\" (Esquerda e direita para alterar os discos)</p> <p>Passo 3: Selecione \"Disk Cycle Tray Status\" novamente</p> <p>E pronto!</p>"},{"location":"Multi-Disc-Games-Tutorial-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-01-10 11:36] Hyze01:</code> Updated Multi Disc Games Tutorial pt_BR (markdown)</li> <li><code>[2020-01-10 11:35] Hyze01:</code> Updated Multi Disc Games Tutorial pt_BR (markdown)</li> <li><code>[2020-01-10 11:23] Hyze01:</code> Ajudado com a tradu\u00e7\u00e3o.</li> <li><code>[2020-01-10 10:31] meleu:</code> Created Multi-Disc Games Tutorial-pt_BR (markdown)</li> </ul>"},{"location":"Multi-Disc-Games-Tutorial/","title":"Multi-Disc Games Tutorial","text":""},{"location":"Multi-Disc-Games-Tutorial/#m3u-files","title":"m3u files","text":"<p>Changing discs on Playstation requires creating a playlist file (.m3u) for your discs. This may sound intimidating but it's actually very simple.</p> <p>Step 1: Place your .bin and .cue files in the desired location.</p> <p>Step 2: Open Notepad</p> <p>Step 3: Type the names of your .cue files exactly as they're named on your files. When you're finished your text document should look something like this:</p> <p></p> <p>When you're finished save the text document in the same location as your game discs with whatever name you like.</p> <p>Step 4: Rename the document, changing the extension from .txt to .m3u</p> <p></p> <p>NOTE: If you can't see the .txt extension at the end of your text document title you need to change your settings to show known file extensions. In Windows 10 it's very simple, you can find that on your folder under 'View' and a checkbox reading 'File name extensions'</p> <p></p> <p>Now you're done! Simple, huh? From here on out, when you start the game, load it using the .m3u file you've just created.</p> <p>NOTE: If you have already played the first disc of a game and find your saves no longer there, you can retrieve them by navigating to your emulators 'saves' folder, finding the save for your first disc and renaming it to match the .m3u you've created. for example:</p> <p>'Metal Gear Solid (v1.1) (Disc 1).mcr'   &gt;   'Metal Gear Solid (v1.1).mcr'</p>"},{"location":"Multi-Disc-Games-Tutorial/#changing-discs-in-ralibretro","title":"Changing Discs in RAlibretro","text":"<p>To change discs on RAlibretro, when the game prompts you, go to the file menu and follow these steps</p> <p></p> <p>Step 1: File &gt; CD-ROM &gt; Open Tray</p> <p>Step 2: File &gt; CD-ROM &gt; Desired Disc</p> <p>Step 3: File &gt; CD-ROM &gt; Close Tray</p> <p>And that's it!</p>"},{"location":"Multi-Disc-Games-Tutorial/#changing-discs-in-retroarch","title":"Changing Discs in Retroarch","text":"<p>You'll find the option in Retroarch under 'Quick Menu &gt; Disk Control'</p> <p></p> <p></p> <p>Step 1: Select 'Disk Cycle Tray Status' (Note: If you have the 'Pause when menu activated' option on, you'll need to turn the menu off and on again so that the game knows the disc tray has been opened)</p> <p>Step 2: Select 'Disk Index' (Left and right to change discs)</p> <p>Step 3: Select 'Disk Cycle Tray Status' again</p> <p>And you're done!</p>"},{"location":"Multi-Disc-Games-Tutorial/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-31 09:42] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-31 11:01] meleu:</code> add proper headings and other cosmetics</li> <li><code>[2019-12-29 12:26] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 12:22] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:58] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:57] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:56] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:53] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:52] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> <li><code>[2019-12-29 11:51] wilhitewarrior:</code> Updated Multi Disc Games Tutorial (markdown)</li> </ul>"},{"location":"My-game-is-not-loading-achievements-es/","title":"Mi juego no esta cargando los logros","text":"<p>Quiz\u00e1s cargaste tu juego, pero ves una ventana emergente:  Luego miras la interfaz (usualmente con 'ESC') y ves: </p> <p>O tal vez obtuviste estos mensajes:</p> <p></p> <p>y</p> <p></p> <p>Cuando ocurre cualquiera de estas situaciones es por que, ya sea el juego a\u00fan no tiene logros, o es probable que tengas la ROM incorrecta.</p> <p>Solo para estar seguro, busca el nombre del juego y verifica los resultados que coincidan. </p> <p>Si el juego tiene logros pero tu ROM no est\u00e1 en nuestro sistema, necesitar\u00e1s encontrar la ROM correcta, u obtener soporte para tu ROM.</p> <p>Verifica el primer post del hilo oficial del juego en el foro. El enlace para ello se encuentra en la parte inferior de la lista de logros, en las respectivas p\u00e1ginas de los juegos. Ejemplo para Super Mario Bros.:</p> <p></p> <p>Probablemente el primer post del hilo oficial del juego en el foro tenga una lista de ROM v\u00e1lidas para el juego, y tambi\u00e9n el \"checksum\" de las ROM.</p> <p>Nota: el \"checksum\" es un n\u00famero usado para confirmar si dos copias de un archivo son id\u00e9nticas. En RA, lo usamos para asegurar que el jugador est\u00e9 usando la misma ROM que el desarrollador de los logros.</p> <p>Tambi\u00e9n verifica los \u00faltimos posts del hilo oficial del juego en el foro y los comentarios en la p\u00e1gina del juego en busca de pistas sobre qu\u00e9 ROM necesitas. Si el nombre correcto de la ROM y el \"checksum\" a\u00fan no se encuentran en la lista, deber\u00e1s solicitarlo (por favor, NO PIDAS ENLACES PARA DESCARGAR EL ROM, solo el nombre del archivo y el \"checksum\"). Puedes solicitarlo en la p\u00e1gina del juego en el foro, o pedir ayuda en Discord o en el chat del sitio en la p\u00e1gina principal.</p> <p>Tambi\u00e9n puedes contribuir a la comunidad obteniendo soporte para tu ROM, si es que es compatible. Publica el \"checksum\" de tu ROM existente en el foro de ese juego y tambi\u00e9n el nombre exacto que tienes para el ROM, y un desarrollador lo revisar\u00e1 contigo para ver si es compatible.</p> <p> Como encontrar el \"checksum\" de tu ROM.</p> <p>Para obtener m\u00e1s informaci\u00f3n sobre el \"checksum\" y los hashes, puedes leer este articulo (en Ingl\u00e9s): https://datacrystal.romhacking.net/wiki/Hashes</p>"},{"location":"My-game-is-not-loading-achievements-es/#listas-completas-de-la-mayoria-de-los-juegos-en-la-base-de-datos-de-retroachievements","title":"Listas completas de la mayor\u00eda de los juegos en la base de datos de RetroAchievements","text":"<p>El usuario caricatur hizo un gran trabajo al compilar algunas listas de ROM vinculadas a los juegos que tenemos en la base de datos en RetroAchievements. Aqu\u00ed est\u00e1n los enlaces a las publicaciones del foro respectivas:</p> <ul> <li>Mega Drive/Genesis</li> <li>Master System</li> <li>PC Engine</li> <li>Gameboy</li> <li>Gameboy Color</li> <li>Gameboy Advance</li> <li>NES</li> <li>SNES</li> <li>Nintendo 64</li> </ul>"},{"location":"My-game-is-not-loading-achievements-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:56] meleu:</code> fix markdown format</li> <li><code>[2018-10-11 00:26] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:47] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-30 12:27] ShinyNinetalesTM:</code> added link to \"comprehensive list\" for NES, as well as done for the english version</li> <li><code>[2018-05-09 13:13] ShinyNinetalesTM:</code> Created My game is not loading achievements-es (markdown)</li> </ul>"},{"location":"My-game-is-not-loading-achievements/","title":"My game is not loading achievements","text":"<p>Maybe you loaded up your game but you see a popup:  Then you check the overlay (typically ESC) and see: </p> <p>Or maybe you got these messages:</p> <p></p> <p>and</p> <p></p> <p>When any of these situations happens, either your game doesn't have achievements yet or more likely you have the incorrect ROM.</p> <p>Just to be sure, search for the game name and check matching results. </p> <p>If your game has achievements but your ROM isn't in our system either you'll need to find the correct ROM or get support for your ROM.</p>"},{"location":"My-game-is-not-loading-achievements/#how-do-i-know-if-my-rom-is-compatible","title":"How do I know if my ROM is compatible?","text":"<p>If your ROM has the same checksum/hash as those linked to the website, then it is compatible.</p> <p>Note: a \"checksum\" or \"hash\" is a number used to confirm if two copies of a file are identical. On RA we use it to assure the player is using the same ROM as the achievement developer.</p> <p>There are two ways of checking what checksums/hashes are linked to a game:</p>"},{"location":"My-game-is-not-loading-achievements/#check-the-linked-hashes-page-associated-with-the-game","title":"Check the Linked Hashes page associated with the game","text":"<p>Example for Super Mario Bros. NOTE: You must be logged in to view linked hashes.</p> <p>You can access this page by clicking the \"Hashes linked to this game\" button in the \"More Info\" section on the game page.</p> <p></p> <p>It takes you to a page like this:</p> <p></p>"},{"location":"My-game-is-not-loading-achievements/#check-the-top-post-of-the-official-games-forum-thread","title":"Check the top post of the official game's forum thread","text":"<p>The link for it can be found at the bottom of the achievement list on game pages OR in the More Info section. Example for Super Mario Bros.:</p> <p></p> <p></p> <p>The first post of the official game's forum thread usually has a list of valid ROMs for the respective game and also the checksum of the ROMs. </p> <p>If your ROMs name and checksum aren't listed yet, then you'll need to ask for it (please, do NOT ask for links to download the ROM, only the filename and the checksum). You can request it in the game's forum page or ask for help in Discord or on the site chat on the front page.</p> <p>Once you make a request, a developer will review it and make sure it works. Then they will add the hash to the 'compatible hashes page.' </p>"},{"location":"My-game-is-not-loading-achievements/#how-to-find-the-checksum-of-your-rom","title":"How to find the checksum of your ROM:","text":"<p>In the menu bar <code>RetroAchievements</code> &gt; <code>Get ROM Checksum</code></p> <p> </p> <p>For more details about checksum and hashes, read here: https://datacrystal.romhacking.net/wiki/Hashes</p>"},{"location":"Naming-Conventions/","title":"Naming Conventions","text":""},{"location":"Naming-Conventions/#naming-conventions","title":"Naming Conventions","text":"<ul> <li>No Symbols: Do not use accented/special characters like the <code>\u00e9</code> in Pokemon, as they currently break a few things (like feed). They are also not visible in search without the special character. Same for UTF-8 Universal Emoji codes. Allowed exception: Rich Presence Scripts.</li> </ul>"},{"location":"Naming-Conventions/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-28 15:27] televandalist:</code> Created Naming Conventions (markdown)</li> </ul>"},{"location":"New-Achievement-Set-Checklist/","title":"New Achievement Set Checklist","text":""},{"location":"New-Achievement-Set-Checklist/#before-you-begin","title":"Before you Begin","text":""},{"location":"New-Achievement-Set-Checklist/#1-are-you-free-of-tickets","title":"1. Are you free of tickets?","text":"<p>Before working on new games you must address all open tickets you have. Once you're free of tickets, then go ahead. Tickets are addressed when they are either resolved/closed for a valid reason with a comment on the ticket, or when transferred to reporter and awaiting further information (such as more details, reproduction steps, or save states).</p>"},{"location":"New-Achievement-Set-Checklist/#2-is-the-game-present-on-the-database","title":"2. Is the game present on the database?","text":""},{"location":"New-Achievement-Set-Checklist/#no","title":"No","text":"<p>Then ask for it to be added on Discord #help-me or on our forums and some dev will add it for you. It's essential you choose the right ROM(s) to work with. If you want to work on a ROM hack, check the achievements for ROM hacks doc first.</p>"},{"location":"New-Achievement-Set-Checklist/#yes","title":"Yes","text":"<p>Good! Go ahead.</p>"},{"location":"New-Achievement-Set-Checklist/#3-does-the-game-already-have-an-achievement-set","title":"3. Does the game already have an achievement set?","text":""},{"location":"New-Achievement-Set-Checklist/#yes_1","title":"Yes","text":"<p>If there is an existing set, don't give up. You can still improve it, by adding/removing/reworking achievements, or make changes to titles and images, etc. However you'll need to go through the set revision process.</p>"},{"location":"New-Achievement-Set-Checklist/#no_1","title":"No","text":"<p>Look deeper. Often there are multiple entries in the database for the same game under different titles. Once you're sure, you'll need to check if there's another dev working on the game.</p> <p>Note: Only one achievement set is allowed per game per console. For details see working with the right ROM.</p>"},{"location":"New-Achievement-Set-Checklist/#4-is-another-developer-working-on-the-game","title":"4. Is another developer working on the game?","text":"<p>To be sure if there's another dev working on a game, check the game's claims on the game page. This is needed to avoid conflicts between multiple developers working on the same game.</p>"},{"location":"New-Achievement-Set-Checklist/#yes_2","title":"Yes","text":"<p>If this is the case, you may not work on the game unless the developer(s) with the claim agree to a collaboration. Do not make a collaboration claim without approval the developer(s) working on the set.</p> <p>Developers are expected to renew their reservation every three months. Look at the time stamps on the claims history to see when the developer posted a reservation for development. If the developer has not stated or renewed their reservation on the game after three months the claim will expire and then you can make a claim and post your plans to work.</p>"},{"location":"New-Achievement-Set-Checklist/#no_2","title":"No","text":"<p>Great! You're free to go ahead! The next step is to announce your plans to develop achievements for the game.</p>"},{"location":"Overlay-Themes/","title":"Overlay Themes","text":"<p>Preview gallery</p> <p>Default theme file showing all available settings. Must be named <code>theme.json</code> when placed in <code>overlay</code> subdirectory.</p>"},{"location":"Overlay-Themes/#single","title":"Single","text":"<ul> <li>Default by Scott </li> <li>Crash Bandicoot by Dexterspet </li> <li>Mega Man Classic by Salsa </li> <li>Nintendo Mix (Slumber Party) by Salsa </li> <li>Roll-chan Evolution by Salsa </li> <li>The Legend of Zelda Classic by Salsa </li> <li>Ys Book I &amp; II by Salsa </li> <li>Sonic by matheus2653 </li> <li>Arnold Schwarzenegger by Salsa </li> <li>Reginaldo Rossi by Salsa </li> <li>Spyro by rabbids4eva</li> <li>Gex by rabbids4eva</li> <li>PlayStation 2 by rabbids4eva</li> <li>LittleBIGPlanet by rabbids4eva</li> <li>Kula World / Roll Away by rabbids4eva</li> <li>MediEvil by rabbids4eva</li> <li>wip3out by rabbids4eva</li> </ul>"},{"location":"Overlay-Themes/#multiple-customizable","title":"Multiple (customizable)","text":"<ul> <li>The Legend of Zelda franchise by kdecks</li> </ul>"},{"location":"Overlay-Themes/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-13 14:56] televandalist:</code> Renamed \"Downloads\" page to \"Overlay Themes\" since that's all that was left - :lel:</li> </ul>"},{"location":"PauseIf-Flag-es/","title":"Bandera PauseIf","text":"<p>Un <code>PauseIf</code> (PausarSi) puede ser seleccionado en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Mientras sea verdadero, el <code>PauseIf</code> pausa la actividad de todas las condiciones en el mismo grupo. No pausa condiciones en otros grupos (mas sobre Grupos Alternos (Alt Groups) abajo).</p> <p>Nota: ten en menta que todas las condiciones en la oracion anterior incluye condiciones <code>ResetIf</code>! En otras palabras Un <code>ResetIf</code> no va a funcionar si un <code>PauseIf</code> esta activo.</p> <p>Un <code>PauseIf</code> es usualmente para prevenir hit counts en una situacion especifica (como pausar el juego). Tambien se utiliza cuando quieres mantener los contadores de hits (hit counts) capturados anteriormente, pero no se quiere incrementar o reseatear mientras este sucediendo algo.</p>"},{"location":"PauseIf-Flag-es/#pauseif-con-hit-counts","title":"<code>PauseIf</code> con hit counts","text":"<p>Una condicion <code>PauseIf</code> con un contador de hits (hit count) especifico solo se va a disparar cuando el numero de hits se cumplan. Una vez que el contador de hits (Hit Counts) se cumpla, el grupo se mantiene pausado asta que un <code>ResetIf</code>en otro grupo sea verdadera o hasta que se reinicie el juego. Un <code>PauseIf</code> sin un contador de hits (Hit Count) se va a terminar de pausar cuando la condicion ya no sea verdadera.</p>"},{"location":"PauseIf-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-03-12 15:00] meleu:</code> Updated PauseIf Flag ES (markdown)</li> </ul>"},{"location":"PauseIf-Flag/","title":"PauseIf Flag","text":"<p>The <code>PauseIf</code> flag can be chosen in the Flag column of the Achievement Editor.</p> <p><code>PauseIf</code> is usually used to prevent hit counts from going up during a specific situation (like when the game is paused). It's used when you want to keep previously earned hit count, but don't want to increment it or reset it while something else is going on.</p> <p>When a group is processed, first all <code>PauseIf</code> are evaluated in order. As soon as any <code>PauseIf</code> is true, the group stops processing. This means that any <code>PauseIf</code>s after the true <code>PauseIf</code> will not be evaluated. This allows one <code>PauseIf</code> to prevent another <code>PauseIf</code> from collecting hits, but it's usually better to write the second <code>PauseIf</code> with an <code>AndNext</code> to limit when it collects hits.</p> <p>This also means that any <code>ResetIf</code>s in the group will not be processed while the group is paused. To reset the hit count on a <code>PauseIf</code>, you must place the <code>ResetIf</code> in an alt group or attach a <code>ResetNextIf</code> to the <code>PauseIf</code>.</p> <p>Delta values are not affected by paused groups. The value returned by a delta read will still be from the previous frame, not from the frame just before the group was paused.</p>"},{"location":"PauseIf-Flag/#pauseif-with-hit-counts","title":"<code>PauseIf</code> with hit counts","text":"<p>A <code>PauseIf</code> condition with a hit count target will only trigger when the hit count target is met. Once the hit count target is met, the group remains paused until the hit count is reset by a <code>ResetIf</code> in another group or a <code>ResetNextIf</code> attached to the <code>PauseIf</code>. You may hear this referred to as a PauseLock.</p> <p>A <code>PauseIf</code> without a hit count will automatically unpause when the condition is no longer true.</p>"},{"location":"PauseIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-05-24 18:58] Jamiras:</code> Updated PauseIf Flag (markdown)</li> <li><code>[2021-08-07 17:00] Dimedime:</code> updated interaction with ResetNextIf</li> <li><code>[2019-02-12 13:13] meleu:</code> typo</li> <li><code>[2019-02-12 13:13] meleu:</code> fix broken link</li> <li><code>[2019-02-12 09:36] meleu:</code> Updated PauseIf (markdown)</li> </ul>"},{"location":"Prior-Values/","title":"Prior Values","text":"<p>A <code>Prior</code> value is the previous value at an address. It is similar to Delta, except it's only updated when the current values changes, whereas Delta is updated every frame. Note: when you use <code>Prior</code> it is implicit that you are referring to an address and not a value.</p> <p>Examples of how it can be used:</p> <ul> <li>Ensures a player visited the previous level instead of using a password to get there: <code>prior level = 6</code> would only be true if the player isn't currently on level 6, but hasn't been anywhere except the current level since being on level 6. If they came straight from the menu <code>prior level</code> would likely be 0.</li> </ul>"},{"location":"Prior-Values/#comparison-of-memory-types-across-several-frames","title":"Comparison of memory types across several frames:","text":"Frame Mem Delta Prior 1 25 0 0 2 25 25 0 3 30 25 25 4 35 30 30 5 35 35 30 6 35 35 30 7 40 35 35 <p>Delta is always one frame behind Mem. Prior is only updated when Mem changes.</p>"},{"location":"Prior-Values/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-01-10 16:03] meleu:</code> fix markdown link</li> <li><code>[2021-01-05 10:53] tofof:</code> fix busted link</li> <li><code>[2019-06-21 19:03] Jamiras:</code> Updated Prior Values (markdown)</li> <li><code>[2019-06-21 19:03] Jamiras:</code> initial documentation</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/","title":"Progression and Win Condition Guidelines","text":"<p>Progression and Win Type conditions are assigned to achievements in a set and used to designate when a game has been beaten. A game is considered when all the following statements are true:</p> <ol> <li>All progression-typed achievements have been earned, if any are present.</li> <li>Any win-typed achievement has been earned, if any are present.</li> </ol> <p>Typing core sets is required for set release. Subsets should not be typed.</p>"},{"location":"Progression-and-Win-Condition-Guidelines/#how-to-add-types-to-achievements","title":"How To Add Types to Achievements","text":"<ul> <li>For individual achievements, you may change the type in the Developer panel on that achievement's page on the RA website.</li> <li>For multiple achievements at the same time, select Manage Core Achievements or Manage Unofficial Achievements in the Developer panel on the game's page on the RA website, then check the box for all achievements for a given typing and click either Set Selected to Progression or Set Selected to Win Condition.</li> <li>At the time of this update, typing is unavailable in RA_Integration, so it cannot be done through emulators.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#progression-type-conditions","title":"Progression Type Conditions","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#progression-conditions","title":"Progression Conditions:","text":"<ul> <li>Achievements that mark steady progress through a set. Post-game content is usually not progression.</li> <li>Cannot be missed assuming no glitches/exploits have been used.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#non-progression","title":"Non-progression","text":"<p>The following types of achievements are not considered for progression type marking:</p> <ul> <li>Optional content</li> <li>Higher Difficulties</li> <li>Side Quests</li> <li>Collectibles</li> <li>Challenges</li> <li>Easter Eggs</li> <li>Story that can be missed, including ending variations.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#win-conditions","title":"Win Conditions","text":"<ul> <li>Achievement(s) that mark the end of the game. Bad endings are usually not true endings.</li> <li>Some games may have multiple Win Conditions, in which case earning any of these achievements (plus all progression) marks the game as beaten.</li> <li>Others may only have one, which should still be marked as a Win Condition for user readability.</li> <li>In some cases, there is no single Win Condition, such as a puzzle game when progression can be done in any order. In these cases, earning all Progression achievements will mark the game as beaten.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#types-of-progression","title":"Types of Progression","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#standard","title":"Standard","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#linear-progression","title":"Linear progression","text":"<ul> <li>Things you encounter as you play through level-to-level.</li> <li>Example: Prince of Persia - Each level is played sequentially to complete the game.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#grouped","title":"Grouped","text":"<ul> <li>Levels are grouped together rather than having individual achievements.</li> <li>Example: Lemmings - Achievements are awarded every 5 levels.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#bosses","title":"Bosses","text":"<ul> <li>Boss fights as story milestones.</li> <li>Example: Spyro: Year of the Dragon - Buzz, Spike and Scorch are mandatory boss fights to be able to progress and defeat the Sorceress.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#key-itemsevents","title":"Key Items/Events","text":"<ul> <li>Collecting important items, reaching the next location or witness key story events.</li> <li>Example: Final Fantasy - Significant events such as Sleeping Prince and Flotation act as story milestones between the game's other boss progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#non-standard-progression","title":"Non-Standard Progression","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#compilation","title":"Compilation","text":"<ul> <li>All games within these have equal importance, so all need to be completed to mark the compilation as beaten.</li> <li>Mark Progression for all individual games as usual.</li> <li>Win Conditions must instead be marked as Progression.</li> <li>Example: Final Fantasy Origins - Both Scions and Sinners and True Emperor of Hell are marked as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#intended-skips","title":"Intended Skips","text":"<ul> <li>Some games include features that allow levels to be skipped without the use of bugs or exploits. In these cases, skippable levels must not be marked as progression as the game can be beaten without them.</li> <li>Example: Super Mario Bros. - Because it is possible to warp to different levels, it is not possible to mark any as Progression. Saved The Girl is marked as the Win condition.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#limited-scopelittle-substance","title":"Limited Scope/Little Substance","text":"<ul> <li>Some games are so simplistic, or have so little content, that the difference between Progression and Mastery is minor. If Progression is clear, mark as usual. Otherwise, mark every achievement as a Progression Condition.</li> <li>Example: Dice of Fate - This is a dice simulator.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-game-modes","title":"Multiple Game Modes","text":"<ul> <li>All non-endless and non-restrictive modes that are available when first launching the game have Progression Conditions marked.</li> <li>These game modes have equal importance, much like the individual games in a compilation. Any Win Conditions should instead be marked as Progression.</li> <li>Endless modes, by definition, continue until failure, so lack Progression and are not included.</li> <li>Restrictive modes limit the player in some way, most often with time or turn limits. They may appear to contain Progression, but the limitations act as an additional challenge, making these achievements Non-Progression that should not be marked.</li> <li>Example: Kirby Super Star - Bye Bye Birdy, What A Meta-Knightmare, Like A Gentle Breeze, Back On Solid Ground and Balance Restored...? are marked as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#subsets","title":"Subsets","text":"<ul> <li>These are inherently focused on a challenge, restriction or other non-standard ways of playing a game.</li> <li>Do not mark any Progression or Win conditions; this is already covered within the core set.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-possible-win-conditions","title":"Multiple Possible Win Conditions","text":""},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-endings","title":"Multiple Endings","text":"<ul> <li>Endings that occur at the end of the game through normal play should be marked as Win Conditions.</li> <li>Alternative endings that require optional content such as collectibles are Non-Progression and should not be marked.</li> <li>Alternative endings that end the storyline early are also Non-Progression and should not be marked.</li> <li>Examples:<ul> <li>Knuckles Chaotix - Both Bad Ending and Good Ending are marked as Win conditions. The ending is determined by optional collectibles.</li> <li>Oddworld: Abe's Oddysee - Both Bad Ending and Good Ending are marked as Win conditions. The ending is determined by saving NPCs.</li> <li>Sigma Star Saga - One is the Loneliest Number and Show Me This Planet are marked as Win conditions. The ending is determined by a gameplay action that only changes the final cutscene.</li> <li>Cave Story MD - Coward is not marked as either Progression or Win because it ends the game early and does not resolve the story. Shtuff Happens and Curse Broken are both marked as Win conditions.</li> <li>Castlevania: Dawn of Sorrow - The Dark Lord Returns is not marked as either Progression or Win because it ends the game early and does not resolve the story. No Dark Lord Here is marked as the Win condition.</li> <li>Shadowgate - Uh... What? is not marked as either Progression or Win because it causes the player's death. Talimar the Black is marked as the Win condition.</li> <li>Sonic Adventure 2 - Final Story</li> <li>Zero Escape: Nine Hours, Nine Persons, Nine Doors - Plaudite! Acta Est Fabula!</li> <li>Live-A-Live - Live A Live requires optional character recruitment. Only Demon King No More is marked as a Win condition.</li> <li>Powerslave | Exhumed - King of the World requires optional collectibles. Only Time to Rest is marked as a Win condition.</li> <li>Sonic 3 &amp; Knuckles - Hyper Sonic Victory, Hyper Knuckles Victory and Super Tails Victory all require optional collectibles. Sonic Victory, Knuckles Victory and Tails Victory are all marked as Win conditions.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-difficulties","title":"Multiple difficulties","text":"<ul> <li>Progression and Win Conditions should be marked for the lowest difficulty supported by the set.</li> <li>If difficulty achievements do not stack (e.g. normal or higher), for each difficulty available from a fresh save, mark each game completion achievement as a Win Condition.</li> <li>Endings that are only available on lower difficulties are not considered Progression.</li> <li>Examples:<ul> <li>Devil May Cry 3 - Leave Me And Go and Normal Mode are marked as Win conditions as Easy and Normal are available on a 1st playthrough.</li> <li>Resident Evil 3: Nemesis - Carlos, My Love! and Is That You?! are Win conditions, Easy is not covered by the set.</li> <li>Streets of Rage 3 - The End? is not marked as Progression or Win because Easy difficulty ends the game early. Unfinished Business, Time's Up and The End! are all Win conditions.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#multiple-storylinescharacters","title":"Multiple Storylines/Characters","text":"<ul> <li>Some linear games have an epilogue or expanded story that are still part of a standard playthrough. These resolve the storyline and should be marked as a Win Condition.</li> <li>Some games may have endless post-game content after the story has resolved. This optional content should not be marked as either Progression or Win Conditions.</li> <li>Additional story content that is exclusive to a particular version or release are part of Progression. These differentiate that game from other releases and should be marked as Win Conditions. Endings reached before this point should be marked as Progression.</li> <li>Credits do not always mean the end of a story.</li> <li>Some games have progression differences based on initial character choice. In these cases, all starting characters' endings are needed to beat the game, so these should all be marked as Progression Conditions.</li> <li>If the character choice only affects playstyle or abilities, each character's ending should be marked as Win Conditions.</li> <li>Characters may each have multiple endings. In these cases, make sure to only mark their normal ending, not ones that require extra steps.</li> <li>Examples:<ul> <li>EarthBound - Smiles and Tears is marked as the Win condition, On a Mission from God is marked as a Progression condition.</li> <li>Resident Evil 2 - No Time to Waste and I Have to Find You are marked as Win conditions. Progression cannot be marked due to the order of characters chosen not being significant to the overall story.</li> <li>Shin Megami Tensei: Persona 3 FES - The Fate of the Sealed is marked as the Win condition, Thank You for Everything is marked as a Progression condition.</li> <li>Final Fantasy I &amp; II: Dawn of Souls - Break The Time Loop, To Heck With You! and To Arubboth With You! are marked as Progression. This version of the game expands the storyline to resolve the plot.</li> <li>Final Fantasy V: Advance - The True Power of the Void is not marked as Progression or Win due to being post-game content in an endless game. The Win condition is Warriors of Light.</li> <li>Pokemon Gold Version - Battle On the Mountain is not marked as Progression or Win due to being post-game content in an endless game. The Win condition is Elite Five.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#notable-genres","title":"Notable Genres","text":"<p>These genres often lack standard progression, so have additional guidelines here. They may also feature multiple game modes; see the guidelines above for how to mark Progression for these.</p>"},{"location":"Progression-and-Win-Condition-Guidelines/#arcade","title":"Arcade","text":"<p>Use the first of the following that is applicable:</p> <ul> <li>Mark achievements for clearing each stage as Progression and the last as a Win Condition.<ul> <li>Example: Galaga - Bulletstorm is marked as the Win condition.</li> </ul> </li> <li>Use the last stage that adds new elements (enemies/obstacles/mechanics) or increases the difficulty as the final stage of Progression.<ul> <li>Example: Donkey Kong - Mark 150m Finish as the Win condition.</li> </ul> </li> <li>Use the set developer's score achievements as Progression, with reaching the highest as the Win Condition.<ul> <li>Example: Pokemon Pinball: Ruby &amp; Sapphire - 1st Place Ruby, 1st Place Sapphire and High Roller are marked as Progression.</li> </ul> </li> <li>Use the in-game leaderboards' high scores as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#fighting","title":"Fighting","text":"<ul> <li>The game should be cleared with all starting characters for a Beat</li> <li>The progression and/or win achievements for each character available on a fresh launch should be marked as Progression, with no Win Conditions.<ul> <li>Example: Soulcalibur II - Weapon Master (Story) and each default character's Arcade (Normal or Higher) are marked as Progression. Time Attack (Restrictive), Survival (Endless) and the unlockable modes are not marked.</li> </ul> </li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#puzzle","title":"Puzzle","text":"<ul> <li>Some Puzzle games allow levels to be played in any order. In these cases, do not mark any Win Conditions, only Progression.</li> <li>Puzzle games may segment levels by difficulty. These function as categories rather than the same levels again but more challenging, so higher difficulties are still part of Progression in these cases.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#rhythm","title":"Rhythm","text":"<ul> <li>All songs unlocked through standard gameplay are considered Progression.</li> <li>Do not include songs unlocked with additional steps such as high score or chain requirements.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#shoot-em-ups-aka-shumps","title":"Shoot 'em Ups (aka Shumps)","text":"<ul> <li>If character/ship choice does not affect the storyline, only one needs to be cleared to Beat the game.</li> <li>Mark each character's win achievement as a Win Condition.</li> <li>Do not mark character-specific achievements as Progression.</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#sports","title":"Sports","text":"<ul> <li>Win a game is only considered Progression if there are no other game modes.</li> <li>Progression should be marked for all non-endless modes available from a fresh launch.</li> <li>All tournaments/events unlocked through standard gameplay are considered Progression.</li> <li>Do not include tournaments/events unlocked through additional steps such as perfect games</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-17 08:43] Andrew Comer:</code> Updated Progression and Win Condition Guidelines (markdown)</li> <li><code>[2023-11-17 08:19] The Mystical One:</code> Added details on how to apply types to the achievements.</li> <li><code>[2023-11-06 17:25] Andrew Comer:</code> More formatting fixes</li> <li><code>[2023-11-06 17:20] Andrew Comer:</code> Formatting fixes</li> <li><code>[2023-11-05 16:36] Andrew Comer:</code> Remove duplicate bullet points</li> <li><code>[2023-11-03 14:34] Etron:</code> Added game links to each example</li> <li><code>[2023-11-03 08:05] The Mystical One:</code> Initial Creation based on Progression Typing Draft</li> </ul>"},{"location":"Progression-and-Win-Condition-Guidelines/#changelog_1","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-11-17 08:43] Andrew Comer:</code> Updated Progression and Win Condition Guidelines (markdown)</li> <li><code>[2023-11-17 08:19] The Mystical One:</code> Added details on how to apply types to the achievements.</li> <li><code>[2023-11-06 17:25] Andrew Comer:</code> More formatting fixes</li> <li><code>[2023-11-06 17:20] Andrew Comer:</code> Formatting fixes</li> <li><code>[2023-11-05 16:36] Andrew Comer:</code> Remove duplicate bullet points</li> <li><code>[2023-11-03 14:34] Etron:</code> Added game links to each example</li> <li><code>[2023-11-03 08:05] The Mystical One:</code> Initial Creation based on Progression Typing Draft</li> </ul>"},{"location":"RA-In-Review/","title":"RA In Review","text":"<p>Logging things to be mentioned in the next \"year in review\" article.</p>"},{"location":"RA-In-Review/#2021","title":"2021","text":""},{"location":"RA-In-Review/#january","title":"January","text":"<ul> <li>Added Intellivision support (credits? Jamiras?).</li> <li>RAPatches repository - televandalist</li> </ul>"},{"location":"RA-In-Review/#april","title":"April","text":"<ul> <li>Watara Supervision support</li> <li>QA Team created</li> <li>Any admin can deploy documentation website</li> </ul>"},{"location":"RA-In-Review/#may","title":"May","text":"<ul> <li>Updated Code of Conduct</li> <li>Server comments logging changes in the Leaderboards - Searo</li> </ul>"},{"location":"RA-In-Review/#previous-years","title":"Previous Years","text":"<ul> <li>2020: https://retroachievements.org/viewtopic.php?t=12239</li> <li>2019: https://retroachievements.org/viewtopic.php?t=9929</li> <li>2018: https://retroachievements.org/viewtopic.php?t=8060 and https://retroachievements.org/viewtopic.php?t=8099</li> <li>2017: https://retroachievements.org/viewtopic.php?t=6081</li> </ul>"},{"location":"RA-Trackers/","title":"RA Trackers","text":""},{"location":"RA-Trackers/#achievement-trackers","title":"Achievement Trackers","text":""},{"location":"RA-Trackers/#retro-achievement-tracker","title":"Retro Achievement Tracker","text":"<p>Developer: RetroS3xual \ud83d\udce5 Download \ud83c\udfa5 Tutorial</p> <p>Custom Layout: YES Game Information: YES User Information: YES Maintained: YES </p>"},{"location":"RA-Trackers/#retreon","title":"Retreon","text":"<p>Developer: glacia \ud83d\udce5 Download</p> <p>Custom Layout: YES Game Information: YES User Information: NO Maintained: NO </p>"},{"location":"RA-Trackers/#missing-tracker","title":"Missing Tracker","text":"<p>If you have made or use a tracker which is not listed here you can contact the moderation team on the RetroAchievements Discord Server or send a private message to RAdmin including the name of the tracker and the creator of it.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/","title":"RABot, the RA Discord Robot","text":"<p>RABot is the the official RetroAchievements Discord robot. Therefore, to interact with him, you need to be a member of the RA Discord server.</p> <p>RABot has many cool and useful commands and in this page you'll see some examples of how some of them can be used.</p> <p>RABot is powered by JavaScript, Node.js, discord.js and Commando.</p> <p>Special thanks: the DragonFire's Xiao bot is a great source of inspiration for many of the cool commands we have in RABot, like <code>!bulbapedia</code>, <code>!manga</code>, <code>!translate</code>, <code>!define</code> and others.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-help","title":"Getting help","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#help","title":"<code>!help</code>","text":"<p>This command makes the RABot send a DM with the list of commands available.</p> <p>If you need help about a specific command use <code>!help command_name</code>.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#docs","title":"<code>!docs</code>","text":"<p>Provide links to RetroAchievements documentation.</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#rarch","title":"<code>!rarch</code>","text":"<p>Provide basic info about RetroArch.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#rules","title":"<code>!rules</code>","text":"<p>Show the rules, or a specific one.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#about","title":"<code>!about</code>","text":"<p>Show info about the RABot.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#panic","title":"<code>!panic</code>","text":"<p>What to do when the site is down.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#creating-polls","title":"Creating polls","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#poll","title":"<code>!poll</code>","text":"<p>Creates a simple poll. People can vote adding reactions, but they can also vote with unlisted reactions. See <code>!tpoll</code> if you are interested in a more advanced and serious poll.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#tpoll","title":"<code>!tpoll</code>","text":"<p>Creates a timed poll. In this kind of poll only the first reaction is considered a vote, and if people react with an unlisted reaction then the vote is voided.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#dealing-with-numbers","title":"Dealing with numbers","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#hex","title":"<code>!hex</code>","text":"<p>Converts a non-negative integer from decimal (or binary) to hexadecimal (or vice-versa).</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#bin","title":"<code>!bin</code>","text":"<p>Converts a non-negative integer from decimal (or hexadecimal) to binary (or vice-versa).</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#calculator","title":"<code>!calculator</code>","text":"<p>Alias: <code>!calc</code></p> <p>Evaluates the given math expression and responds with the result.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-retroachievementsorg-infolinks","title":"Getting RetroAchievements.org info/links","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#ragame","title":"<code>!ragame</code>","text":"<p>Alias: <code>!game</code></p> <p>Google for a game at RetroAchievements.org and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#tickets","title":"<code>!tickets</code>","text":"<p>Return the URL for the open tickets page of the given game name.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#whatgame","title":"<code>!whatgame</code>","text":"<p>Alias: <code>!wg</code></p> <p>Responds with a random game that has achievements.</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#whatcheevo","title":"<code>!whatcheevo</code>","text":"<p>Responds with a random achievement.</p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#random-facts","title":"Random facts","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#funfact","title":"<code>!funfact</code>","text":"<p>Responds with a retrogaming fun fact.</p> <p>Note: you can suggest more fun fact entries here.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#memefact","title":"<code>!memefact</code>","text":"<p>Alias: <code>!meme</code></p> <p>Responds with a RetroAchievements meme fact.</p> <p>Note: you can suggest more meme fact entries here, but keep these 2 simple rules in mind 1) you can't suggest your own quote; and 2) when suggesting a quote, be sure to get an approval from the author and/or the person being mentioned.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#getting-gaming-related-info","title":"Getting gaming related info","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#gamefaqs","title":"<code>!gamefaqs</code>","text":"<p>Aliases: <code>!gamefaq</code>, <code>!gfaq</code></p> <p>Google for a game at GameFAQs and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#longplay","title":"<code>!longplay</code>","text":"<p>Aliases: <code>!lplay</code>, <code>!lp</code></p> <p>Search for a longplay video on youtube and post the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#vgmaps","title":"<code>!vgmaps</code>","text":"<p>Alias: <code>!vgmap</code></p> <p>Searches vgmaps.com for a video game's map.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#howlongtobeat","title":"<code>!howlongtobeat</code>","text":"<p>Alias: <code>!hltb</code></p> <p>Google for a game at howlongtobeat.com and show the link.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#miscellaneous","title":"Miscellaneous","text":""},{"location":"RABot%2C-the-RA-Discord-Robot/#define","title":"<code>!define</code>","text":"<p>Aliases: <code>!dictionary</code>, <code>!dict</code></p> <p>Defines a word.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#translate","title":"<code>!translate</code>","text":"<p>Alias: <code>!tr</code></p> <p>Translates text to a specific language. Powered by https://translate.yandex.com/</p> <p></p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#urban","title":"<code>!urban</code>","text":"<p>Defines a word, but with Urban Dictionary.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#wikipedia","title":"<code>!wikipedia</code>","text":"<p>Alias: <code>!wp</code></p> <p>Searches Wikipedia for your query.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#youtube","title":"<code>!youtube</code>","text":"<p>Alias: <code>!yt</code></p> <p>Search for a video on youtube and post the first one found.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#bulbapedia","title":"<code>!bulbapedia</code>","text":"<p>Searches Bulbapedia for your query.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#movie","title":"<code>!movie</code>","text":"<p>Searches TMDB for your query, getting movie results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#manga","title":"<code>!manga</code>","text":"<p>Searches AniList for your query, getting manga results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#anime","title":"<code>!anime</code>","text":"<p>Searches AniList for your query, getting anime results.</p> <p></p>"},{"location":"RABot%2C-the-RA-Discord-Robot/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-01-16 03:48] meleu:</code> Akinator is :ded:</li> <li><code>[2019-11-17 22:11] meleu:</code> akinator command is ded</li> <li><code>[2019-02-16 13:12] meleu:</code> remove faq</li> <li><code>[2019-02-14 11:15] meleu:</code> typo</li> <li><code>[2019-01-17 22:36] meleu:</code> added some aliases</li> <li><code>[2019-01-17 11:11] meleu:</code> fixed caps in the page's title</li> </ul>"},{"location":"RALibretro/","title":"RALibretro","text":"<p>!! This page is wildly out-of-date</p> <p>RALibretro is a multi-emulator that can be used to develop RetroAchievements.</p> <p>The \"multi-emulation\" feature is only possible because it uses libretro cores to do the actual emulation. What RALibretro does is to connect the emulation to the tools used to create RetroAchievements.</p>"},{"location":"RALibretro/#warning","title":"WARNING","text":"<p>RALibretro is a Work-in-Progress!!!</p> <p>Currently the development is going on this repo: https://github.com/RetroAchievements/RALibretro</p> <p>Here's a list of known issues (feel free to report new issues if you find one): https://github.com/RetroAchievements/RALibretro/issues</p>"},{"location":"RALibretro/#installation-instructions","title":"Installation Instructions","text":"<p>Just download RALibretro from the Downloads page and unzip it.</p>"},{"location":"RALibretro/#basic-usage","title":"Basic Usage","text":"<ol> <li>Launch RALibretro.exe</li> <li>Click on <code>File</code> &gt; <code>Load System</code>, and click on the system you want to emulate</li> <li>Now go to <code>File</code> &gt; <code>Load Game</code> and choose your ROM. Note: RALibretro currently doesn't accept zipped files!</li> <li>Now you can create your cheevos or just earn some!</li> </ol>"},{"location":"RALibretro/#supported-systems","title":"Supported Systems","text":"<p>NOTE: some systems may require system (BIOS) files in the <code>System</code> directory in order to load games correctly.</p> <p>Here is a list of the systems supported currently:</p> <ul> <li>SNES</li> <li>NES</li> <li>Nintendo 64</li> <li>Mega Drive</li> <li>Master System</li> <li>Gameboy</li> <li>Gameboy Color</li> <li>Gameboy Advance</li> <li>PC Engine (TurboGrafx-16/TurboGrafx-CD)</li> <li>Atari Lynx</li> <li>Game Gear</li> <li>Neo Geo Pocket</li> <li>Atari 2600</li> <li>Atari 7800</li> <li>Virtual Boy</li> <li>Neo Geo (Arcade) - new. NOTE: you need to put the <code>neogeo.zip</code> BIOS file on the same directory as the ROMs.</li> <li>Capcom Play System 1, 2 and 3 (Arcade) - new</li> </ul>"},{"location":"RALibretro/#keyboard-input","title":"Keyboard Input","text":"Keyboard a s z x d c f v Enter Tab g h RetroPad Y X B A L R L2 R2 Start Select L3 R3 SNES Y X B A L R Start Select NES B A Swap disk side (FDS) Insert/Eject disk (FDS) Start Select Mega Drive A Y B C X Z Start Master System B A Start GameGear B A Start Gameboy [Color] B A Start Select Gameboy Advance B A L R Start Select PC Engine II I Run Select Atari Lynx B A Option 1 Option 2 Start Neo Geo Pocket B A Start Atari 2600 o L difficulty b R difficulty b L difficulty a R difficulty a Start Select Neo Geo C D A B Start Coin CPS1/2/3* * * * * * * Start Coin <p>Note: the buttons for CPS1/2/3 games vary for each game.</p>"},{"location":"RALibretro/#keyboard-shortcuts","title":"Keyboard Shortcuts","text":"<ul> <li>see overlay: <code>Esc</code></li> <li>pause emulation: <code>p</code></li> <li>advance one frame at a time: <code>;</code> (automatically pauses emulation)</li> <li>fast forward: <code>=</code></li> <li>fast forward toggle: <code>-</code> (minus signal)</li> <li>Screenshot: <code>PrintScreen</code></li> </ul>"},{"location":"RALibretro/#saveload-state-keys","title":"Save/Load state keys","text":"<ul> <li>Save state current slot: <code>Backspace</code></li> <li>Load state current slot: <code>F11</code></li> <li>Load state from slot 1, 2, .., 9, 0: <code>F1</code>, <code>F2</code>, ..., <code>F9</code>, <code>F10</code></li> <li>Save state to slot  1, 2, .., 9, 10: <code>shift</code>+<code>F1</code>, <code>shift</code>+<code>F2</code>, ..., <code>shift</code>+<code>F9</code>, <code>shift</code>+<code>F10</code></li> <li>Previous slot: <code>shift</code>+<code>-</code></li> <li>Next slot: <code>shift</code>+<code>+</code></li> <li>Switch slot: <code>0</code>, <code>1</code>, <code>2</code>,..., <code>9</code></li> </ul>"},{"location":"RALibretro/#missing-features","title":"Missing Features","text":"<ul> <li>feedback to the user when save/load state, pausing, etc.</li> <li>N64 support</li> <li>load zipped ROMs</li> <li>input configuration</li> <li>more issues listed here: https://github.com/RetroAchievements/RALibretro/issues</li> </ul>"},{"location":"RALibretro/#how-to-make-aes-bios-work-in-ralibretro-or-retroarch","title":"How to make AES BIOS work in RALibretro or RetroArch","text":"<p>To make AES BIOS emulation mode work in your emulator:</p> <ol> <li> <p>Make sure your emulator works correctly.</p> </li> <li> <p>Put <code>neogeo.zip</code> to <code>System</code> directory (RALibretro), or a folder you keep your NeoGeo ROMs (RetroArch).</p> </li> <li> <p>Make sure the <code>neogeo.zip</code> consist of at least files you can see here:</p> </li> </ol> <p></p> <p>If you keep only those files, AES mode will be automatically forced for any NeoGeo game (recommended).</p> <p>Important! The files which are highlighted on this picture (<code>neo-epo.bin</code> and <code>neo-po.bin</code>) are the only one actually related to AES mode, and you probably will need to include them in your archive to make AES mode work for you. <code>neo-po.bin</code> is necessary for japanese-only titles or to make the japanese versions to work, but due to emulation issue it also forces japanese language as default, that's why you will need to remove it to display english in some games.</p> <ol> <li>Load any FBA compatible neo geo ROM. More complete archive (including files needed to run MVS and UniBIOS modes) might need additional configuration to force AES mode:</li> </ol> <p>In RaLibretro: Settings-&gt;Emulation-&gt;Force Neo Geo Mode-&gt;AES</p> <p>In RetroArch: Command-&gt;Menu Toggle-&gt;Options-&gt;Force Neo Geo Mode-&gt;AES</p>"},{"location":"RATools/","title":"RATools","text":""},{"location":"RATools/#about-ratools","title":"About RATools","text":"<p>RATools is a standalone executable designed to assist developers of the retroachievements.org community. It's primary purpose is to provide a scripting language for achievement development.</p> <ul> <li>Releases</li> <li>Wiki</li> </ul>"},{"location":"RATools/#rascript","title":"RAScript","text":"<ul> <li>RAScript is a domain-specific language (DSL) that allows achievement developers for retroachievements.org the ability to design achievements using many of the modern conveniences provided by programming languages - such as variables, loops, and comments.</li> </ul>"},{"location":"RATools/#tutorials","title":"Tutorials","text":"<p>The user Etron writes an ongoing series of RATools tutorials, which appear in RANews each month.</p> <ul> <li>Getting Started: Introduction to using RATools</li> <li>Memory: Examples of variables and functions - Example Game: Sonic the Hedgehog</li> <li>Add Hits: Examples of counting with tally - Example Game: Streets of Rage 2 </li> <li>Bitflags: Examples of counting bit flags with For Loops - Example Game: Pok\u00e9mon Red | Blue</li> <li>Arithmetic Operations: Examples of using arithmetic functions to convert values from Binary-Coded Decimal (BCD) - Example Game: Pitfall!</li> <li>Pointers: Examples of pointer use and data structures - Example Game: Spider-Man</li> <li>If/else: Examples of using logic conditions to build an achievement - Example Game: Tetris DX</li> <li>Challenges Part 1: Examples of damageless, deathless, and weapon limited challenges - Example Game: Mega man</li> <li>Challenges Part 2: Examples of speedruns and other time challenges - Example Game: Super Mario World</li> <li>Triggers and Measure: Examples of using these flags together - Example Game: Street Fighter II: The World Warrior</li> <li>Strings: Examples of utilizing specific arrays - Example Game: Rez</li> <li>Rich Presence: Examples of writing dynamic Rich Presence scripts</li> <li>Leaderboards: Examples of various types of in-game leaderboards - Example Game: Doom</li> </ul>"},{"location":"RATools/#rascript-repositories","title":"RAScript Repositories","text":"<p>Many achievement developers' RAScripts are publicly available and are a great resource in becoming more familiar with it: - AlmightyXor - AuburnRDM - Bartis1989 - BenGhazi - Bilalscape12 - Bryan1150 - Etron - FRAN269 - gde - Guinea - Jamiras - lordpsycho - meleu - pinguupinguu - Searo - Sines - SlashTangent - Snow - soopercool101 - suXin - televandalist - theanxietybuster - tomojin - WCopeland - wolfman2000 - zxmega</p>"},{"location":"RATools/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-09 07:03] televandalist:</code> Updated RATools (markdown)</li> <li><code>[2023-06-05 22:55] televandalist:</code> Created RATools (markdown)</li> </ul>"},{"location":"Real-Examples-es/","title":"Intro","text":"<p>Uno de los mejores m\u00e9todos para aprender es ver ejemplos reales. En esta secci\u00f3n vamos a ver profundamente varios logros y vamos a desglosar la l\u00f3gica detr\u00e1s de cada uno de ellos.</p> <p>- Utilizar Hit Counts como un Temporizador   - Utilizando Valores Delta y Hit Counts para detectar un Incremento   - Simple Ejemplo de Como Evadir el Abuso de Estados de Guardado (Load State)   - Evitar el Problema de que un Contador Incremente Dos Veces en el mismo Frame   - Creando un Temporizador con Hits de un ResetIf en base a la velocidad de un Juego</p>"},{"location":"Real-Examples-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:37] meleu:</code> fix broken links</li> <li><code>[2019-04-16 11:13] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Real-Examples-pt_BR/","title":"Exemplos Reais","text":"<p>Link para o texto em ingl\u00eas: Real Examples</p> <p>Um dos melhores recursos de aprendizagem est\u00e1 em analisar alguns exemplos reais. Nesta se\u00e7\u00e3o, analisaremos profundamente alguns achievements e quebraremos a l\u00f3gica por tr\u00e1s deles.</p> <p>- Usando Hit Counts e ResetIf   - Usando Delta Values e ResetIf   - Exemplo Simples de Como Evitar o abuso de Load State</p>"},{"location":"Real-Examples-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:04] KingDice001:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-25 11:47] KingDice001:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-23 22:16] meleu:</code> Updated Real Examples pt_BR (markdown)</li> <li><code>[2018-03-23 01:20] meleu:</code> Updated Real Examples.pt_BR (markdown)</li> </ul>"},{"location":"Real-Examples/","title":"Real Examples","text":"<p>One of the best learning resource is looking at some real examples. In this section we will look deep into some achievements and break down the logic behind them. - Using Hit Counts as a Timer - Using Delta Values and Hit Counts to Detect an Increment - Circumvent the Problem of a Counter Incrementing Twice in the Same Frame - Creating a Timer with Reset If Hits based on the Speed of the Game - Using Add Source and Deltas for Collectibles and Similar Achievements</p>"},{"location":"Real-Examples/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-09-27 15:42] televandalist:</code> Updated Real Examples (markdown)</li> <li><code>[2022-02-07 09:42] televandalist:</code> Corrected typo (wil -&gt; will) - Removed link to the save state abuse example since it doesn't exist</li> <li><code>[2021-04-27 01:34] televandalist:</code> ToC fix</li> <li><code>[2021-01-10 08:33] televandalist:</code> Added link to Add Source/Delta example</li> <li><code>[2019-02-18 16:51] meleu:</code> fix broken links</li> <li><code>[2018-08-31 21:36] meleu:</code> Updated Real Examples (markdown)</li> <li><code>[2018-09-01 01:26] magusLOGS:</code> Updated Real Examples (markdown)</li> <li><code>[2018-01-29 10:20] meleu:</code> added links to the examples</li> <li><code>[2018-01-29 10:17] meleu:</code> this page is just a disclaimer, the real examples now have each one its own page</li> <li><code>[2017-12-11 10:23] meleu:</code> Updated Real Examples (markdown)</li> </ul>"},{"location":"Regional-Compatibility/","title":"Regional Compatibility","text":""},{"location":"Regional-Compatibility/#adding-regional-compatibility","title":"Adding Regional Compatibility","text":"<p>If you would like to add support for another region (e.g. adding support for a European ROM when the set was made with the USA ROM) to a set, please note the following: * For the majority of consoles, PAL-region games run at 50hz whereas NTSC runs at 60hz. Without a 60Hz patch, some achievements could be easier to obtain due to the decreased frame-rate. This is especially important for achievements that use frames-as-time in their logic and for leaderboards in general. * Some regions have different cheats. There are many cases where cheat codes were altered or removed upon localization. These should be accounted for.  * If there are enough differences between versions, an entirely separate set might be the best option. For more information on this, please see localization differences.</p>"},{"location":"Reporting-a-Broken-Achievement/","title":"Reporting Broken Achievements","text":"<p>To report a broken achievement, go to the achievement's page. Directly under the players won statistic, you'll see a link reading  \"Report an issue for this achievement.\" Click that link to take you to the \"Report Broken Achievement\" form</p>"},{"location":"Reporting-a-Broken-Achievement/#report-broken-achievement-form","title":"Report Broken Achievement Form","text":"<p>When reporting a broken achievement, please fill out all the fields to the best of your ability. The more information we have on the issue, the better our chances of figuring out what went wrong.</p>"},{"location":"Reporting-a-Broken-Achievement/#issue","title":"Issue","text":"<p>Select either \"Triggered at wrong time\" or \"Doesn't trigger.\" These are the only two valid reasons for submitting a ticket. If you have criticisms about an achievement, you can post those in the comments. Please Note: If you're submitting a manual unlock request for a network error, there's no need to file a ticket at all. Message RAdmin or post your request in the #Manual-Unlocks channel of our discord, specify that it was a network error and no actual problem with the achievement and we will take care of it for you.</p> <p>Triggered at wrong time: Select this option if an achievement popped at a time when it shouldn't have.</p> <p>Doesn't trigger: Select this option if you completed the requirements listed in the description but the achievement didn't trigger.</p>"},{"location":"Reporting-a-Broken-Achievement/#emulator","title":"Emulator","text":"<p>Select the emulator used in this drop-down menu. If using RetroArch or RALibRetro please also include information about the core used while playing. Checksum: Select your game's checksum here. \"But I don know dis.\" It's very simple. The checksum is like your game's signature. It's how the emulator determines what game and what version of the game you're using. When you have it, you should find it on this drop-down menu. This can be extremely important when looking into a problem so please always try to include this information.</p> <p>To find your Checksum in RetroArch: Go to the Quick Menu, and scroll down to \"Information.\" Under Information, you should see a line reading \"RetroAchievements Hash.\" That long list of numbers and letters you see is your Checksum. </p> <p>To find your Checksum in RALibRetro or other RA standalone emulators: Under the \"RetroAchievements\" menu, the very last item on the list is \"Get ROM Checksum.\" Simply click that and it will spit it out at you clear as day.</p>"},{"location":"Reporting-a-Broken-Achievement/#description","title":"Description","text":"<p>This is the most important field of all. Tell us what happened in as much detail as you possibly can. The less information provided here, the more difficult it is for us to figure out what went wrong. Even details that might seem insignificant to you could be very significant to us. The more you can tell us, the better our chances of being able to figure out why it happened. In other words, \"Dis no werk!\" isn't much help to us in figuring out what the problem was.</p>"},{"location":"ResetIf-Flag-es/","title":"Bandera ResetIf","text":"<p>Un <code>ResetIf</code> (ResetearSi) puede ser elegido en la columna de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Si la condicion asociada es verdad, todos los hit counts en el logro se van a resetear a 0. Esto incluye hit counts en otros grupos (mas sobre eso en Alt Groups (Grupos Alternos) mas abajo).</p> <p>El logro no se va a disparar si uno o mas condiciones <code>ResetIf</code> son verdaderas, incluse si no hay condiciones que necesitan hit counts (contadores de golpes).</p> <p>Puedes encontrar muchos ejemplos de <code>ResetIf</code> en la pagina de Ejemplos Reales.</p>"},{"location":"ResetIf-Flag-es/#resetif-con-hit-counts","title":"<code>ResetIf</code> con hit counts","text":"<p>Una condicion <code>Reset If</code> con un contador de golpes (hit count) solo se va a cumplir cuando el numero de hits necesarios se cumpla.</p> <p>Nota: Si otra condicion <code>ResetIf</code> se cumple, todas las condiciones, incluido el <code>ResetIf</code> con su hit count se van a reinisiar sus contadores de golpes (hit count) a 0.</p> <p>Es muy comun utilizar una condicion con un hit count de 1 como proceso para empezar a hacer un logro, y utilizar un <code>ResetIf</code> para cancel el logro antes de la condicion se cumpla. Un ejemplo comun es un logro sin recivir da\u00f1o: \"Desde el principio de el (nivel/combate), resetear si sea recivido da\u00f1o, que salte el logro al final de el (nivel/combate)\". Cuando la condicion para empezar el nivel es verdadera, un hit count es capturado. Si aun sigue capturado cuando la condicion del final es verdadera, el logro va a saltar. Si la condicion del <code>ResetIf</code> se dispara, el hit count en la condicion de empezar se va a regresar a zero, lo cual hace la condicion falsa cuando quiera evaluar si ya se cumplio la condicion final, y el logro no va a saltar.</p>"},{"location":"ResetIf-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:29] meleu:</code> fix broken links</li> <li><code>[2019-03-12 15:00] meleu:</code> Updated ResetIf Flag ES (markdown)</li> </ul>"},{"location":"ResetIf-Flag/","title":"ResetIf Flag","text":"<p>The <code>ResetIf</code> can be chosen in the Flag column of the Achievement Editor</p> <p>If the associated condition is true, all hit counts in the achievement will be reset to 0. This includes hit counts in other groups (more about it in Alt Groups below).</p> <p>The achievement will not trigger if one or more <code>ResetIf</code> conditions is true, even if there are no conditions with hit count targets.</p> <p>You can see many examples of <code>ResetIf</code> in the Real Examples page.</p>"},{"location":"ResetIf-Flag/#resetif-with-hit-counts","title":"<code>ResetIf</code> with hit counts","text":"<p>A <code>Reset If</code> condition with a hit count will only trigger when the hit count target is met.</p> <p>Note: If another <code>ResetIf</code> condition is met, all conditions, including the <code>ResetIf</code> with the hit count will have their hit counts reset to 0.</p> <p>It is very common to use a condition with a hit count of 1 as a start marker for an achievement, and use a <code>ResetIf</code> to cancel the achievement before the end condition is met. A common example is a damageless achievement: \"From start of (level/battle), reset if damage taken, trigger at end of (level/battle)\". When the start condition is true, a hit count is captured. If it's still set when the end condition is true, the achievement triggers. If the <code>ResetIf</code> condition triggers, the hit count on the start condition is set back to zero, which makes the condition false when evaluating the state when the end condition is true, and the achievement will not trigger.</p>"},{"location":"ResetIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-12 13:11] meleu:</code> fix broken links</li> <li><code>[2019-02-12 09:36] meleu:</code> Updated ResetIf (markdown)</li> </ul>"},{"location":"ResetNextIf-Flag/","title":"ResetNextIf Flag","text":"<p>The <code>ResetNextIf</code> Flag is a special version of the [[ResetIf Flag]] that only resets the hit count of the following condition.</p> <p><code>ResetNextIf</code> has the same priority as the condition that it's attached to. If followed by a <code>PauseIf</code>, it can be used to reset that specific <code>PauseIf</code> without needing an alt. If attached to a standard condition, it will not be processed if the achievement is paused.</p> <p><code>AddAddress</code>, <code>AddSource</code>, and <code>SubSource</code> are combining modifier conditions and are not considered as the following condition. The <code>ResetNextIf</code> will apply to the next non-modified condition.</p> <p><code>AndNext</code> and <code>OrNext</code> are combining logical conditions and will have their hit counts reset, as well as whatever condition follows them.</p> <p>All other condition flags, including <code>AddHits</code> and <code>SubHits</code>, will cause processing of the <code>ResetNextIf</code> behavior to stop.</p>"},{"location":"ResetNextIf-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-08-12 10:28] Jamiras:</code> Updated ResetNextIf Flag (markdown)</li> <li><code>[2021-04-30 12:21] Jamiras:</code> Created ResetNextIf Flag (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto-es/","title":"Manifiesto de RetroAchievements","text":"<p>Este es el Manifiesto de RetroAchievements del cual todo miembro de la comunidad deber\u00eda ser consciente</p> <p>Desde los primeros d\u00edas de RetroAchievements, esto es lo que tenemos en nuestro FAQ como la respuesta de \u00bfQue es RetroAchievements.org?</p> <p>RetroAchievements.org es una comunidad sin animo de lucros que colabora y compite para ganar logros personalizados en juegos cl\u00e1sicos a trav\u00e9s de la emulaci\u00f3n. Los logros son hechos por y para la comunidad. (...)</p> <p>En este manifiesto exploraremos esa respuesta de manera mas profunda.</p>"},{"location":"RetroAchievements-Manifesto-es/#retroachievements-es-una-comunidad-sin-animo-de-lucro","title":"RetroAchievements es una comunidad sin animo de lucro.","text":"<p>Tenemos un enlace de donaciones en la pagina principal pero aun seguimos siendo una una comunidad sin animo de lucro.</p> <p>Nuestros patrocinadores contribuyen con literalmente un dolar al mes, y afortunadamente tenemos suficiente para pagar el servidor sin necesitar anuncios molestos</p> <p>Sin embargo, queremos dejar bien claro que obtener donaciones no es nuestro modelo de negocios, exactamente debido a que \u00a1RetroAchievements no es un negocio!</p> <p>Organizaciones de negocios esperan ansiosamente la llegada de nuevos clientes. Siempre hacen todo lo posible por complacer a la clientela para seguir obteniendo mas y mas. Pero ac\u00e1, en RetroAchievements, no somos un negocio, Somos una comunidad.</p> <p>No tenemos clientes, tenemos miembros de la comunidad.</p> <p>Somos un grupo de personas apasionadas a los juegos retro. Y si compartes nuestra misma pasi\u00f3n, eres bienvenido a un\u00edrtenos.</p> <p>E incluso aunque recibamos a todos, no estamos rogando desesperadamente por la llegada de mas y mas usuarios. La decisi\u00f3n es tuya: Si te gusta lo que ofrecemos \u00a1Toma tu control y juguemos algunos cl\u00e1sicos!</p>"},{"location":"RetroAchievements-Manifesto-es/#los-logros-son-hechos-por-y-para-la-comunidad","title":"Los logros son hechos por y para la comunidad.","text":"<p>Esta relacionado con lo que dijimos mas arriba. No ofrecemos servicios a forasteros. Las cosas que creamos en esta comunidad son hechas para la misma. Eres bienvenido a permanecer con nosotros, pero va de tu parte decidir si quieres ser parte de ella.</p> <p>Mientras seas parte de esta comunidad, siempre ten en mente las siguientes declaraciones:</p> <p>1. Lo mas importante que tenemos son los logros.</p> <p>2. Las personas mas importantes que tenemos son los creadores de logros.</p> <p>\u00bfQue significa esto?</p>"},{"location":"RetroAchievements-Manifesto-es/#lo-mas-importante-que-tenemos-son-los-logros","title":"Lo mas importante que tenemos son los logros.","text":"<p>A todos nos encantan las medallas en nuestro perfil, \u00bfno? Tanto as\u00ed que causa frustraci\u00f3n cuando el set de respectiva medalla obtiene una revisi\u00f3n. Pero es importante tener en mente que este proyecto siempre esta evolucionando.</p> <p>Hacemos revisiones de sets de logros con la calidad en mente, y para demostrar que respetamos el juego. Tambi\u00e9n respetamos los premios que has obtenido, pero mejorar la calidad general del proyecto toma precedencia sobre perfiles individuales y/o la cantidad de puntos.</p> <p>Otra cosa, sino eres capaz de hacerle \"mastered\" a un set de logros, eso no autom\u00e1ticamente significa que el set necesita ser hecho mas f\u00e1cil/degradado/convertirse en bonus. Si otros jugadores lo han obtenido, es muy probable que tu tambi\u00e9n puedas. Pero incluso si no puedes, no pasa nada. No necesitas desbloquear todos los logros para divertirte con juegos antiguos</p> <p>Si aun as\u00ed piensas que alg\u00fan logro en el set tiene conceptos no bienvenidos, puedes hacer un post de tus argumentos en el foro del juego en cuesti\u00f3n. Simplemente aseg\u00farate de ser respetuoso. Lo que nos lleva al siguiente punto...</p>"},{"location":"RetroAchievements-Manifesto-es/#las-personas-mas-importantes-que-tenemos-son-los-creadores-de-logros","title":"Las personas mas importantes que tenemos son los creadores de logros.","text":"<p>\u00a1No se malentienda! En el ecosistema de RetroAchievements hay muchas personas cumpliendo una buena cantidad de roles diferentes a crear logros, y todos son importantes. Pero los creadores de logros son el pilar de este proyecto. Sin ellos, este seria solamente un sitio web jugando a ser anticuado con un manojo de \"bugs\".</p> <p>Crear logros es un proceso que toma mucho tiempo. Las personas que lo hacen dedican una muy buena parte de su tiempo libre para producir contenido beneficioso para toda la comunidad</p> <p>A todas estas, incluso si no eres capaz/estas interesado en crear logros y solamente quieres jugar, tambi\u00e9n eres importante para nosotros. De hecho tenemos una cantidad incontable de jugadores que son miembros invaluables</p> <p>Mientras mas involucrado est\u00e9s, mas valioso eres para la comunidad.</p> <p>Por ultimo pero no menos importante, si tienes criticas hacia el trabajo de un creador de logros, se respetuoso. Demostrar amargura hacia ellos esta muy mal visto. Ser irrespetuoso hacia ellos har\u00e1 que definitivamente no seas bienvenido aqu\u00ed.</p>"},{"location":"RetroAchievements-Manifesto-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-20 18:35] meleu:</code> estan -&gt; son</li> <li><code>[2020-09-16 12:36] meleu:</code> cambiando un poquito</li> <li><code>[2020-09-11 02:49] Pelouch:</code> Updated RetroAchievements Manifesto es (markdown)</li> <li><code>[2020-09-11 02:43] Pelouch:</code> Updated RetroAchievements Manifesto es (markdown)</li> <li><code>[2020-09-10 04:24] meleu:</code> Created RetroAchievements Manifesto es (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto-fr/","title":"RetroAchievements Manifesto fr","text":"<p>Ceci est le manifeste de Retroachievements. Chaque membre de cette communaut\u00e9 devrait en prendre connaissance.</p> <p>Depuis les premiers jours de RetroAchievements, la r\u00e9ponse \u00e0 la question de ce qu\u2019est Retroachievements.org se trouve dans notre FAQ.</p> <p>RetroAchievements.org est une communaut\u00e9 \u00e0 but non lucratif qui promeut le travail collaboratif et l\u2019esprit de comp\u00e9tition dans le but d\u2019obtenir des succ\u00e8s faits soi-m\u00eame via la sc\u00e8ne de l\u2019\u00e9mulation. Les succ\u00e8s sont cr\u00e9\u00e9s pour et par la communaut\u00e9. (\u2026)</p> <p>\u00c0 travers ce manifeste, nous allons r\u00e9pondre de mani\u00e8re plus pr\u00e9cise \u00e0 cette question.</p>"},{"location":"RetroAchievements-Manifesto-fr/#retroachievementsorg-est-une-communaute-a-but-non-lucratif","title":"RetroAchievements.org est une communaut\u00e9 \u00e0 but non lucratif.","text":"<p>Nous disposons d'un syst\u00e8me de donations sur la page principal du site, mais nous restons avant tout une communaut\u00e9 \u00e0 but non lucratif.</p> <p>Les m\u00e9c\u00e8nes participent \u00e0 hauteur d\u2019un seul et unique dollar par mois et heureusement, nous en avons suffisamment pour payer les serveurs sans avoir besoin de mettre en place un syst\u00e8me p\u00e9nible de publicit\u00e9s.</p> <p>Cependant, nous voulons \u00eatre clair sur un point. Recevoir des donations n\u2019est pas notre business model, justement car RetroAchievements n\u2019est pas un business !</p> <p>Une entreprise commerciale est toujours d\u00e9sireuse de capter toujours plus de clients. Elle fait le maximum pour les satisfaire pour en ramener toujours plus. Mais ici, chez RetroAchievements, nous ne sommes pas une entreprise, nous sommes une communaut\u00e9.</p> <p>Nous n\u2019avons pas de clients, nous sommes les membres d\u2019une communaut\u00e9.</p> <p>Nous sommes tout un tas de passionn\u00e9s de jeux vid\u00e9o r\u00e9tro. Et si vous partagez cette m\u00eame passion, alors vous \u00eates plus que le bienvenu pour nous rejoindre.</p> <p>Bien que nous accueillions quiconque le souhaite, nous ne courrons pas d\u00e9sesp\u00e9r\u00e9ment apr\u00e8s de nouveaux membres. C\u2019est \u00e0 votre demande : si vous aimez ce que nous avons \u00e0 offrir, attrapez votre manette et jouez \u00e0 des classiques !</p>"},{"location":"RetroAchievements-Manifesto-fr/#les-succes-sont-faits-par-et-pour-la-communaute","title":"Les succ\u00e8s sont faits par et pour la communaut\u00e9.","text":"<p>Tout ceci pour dire que nous ne sommes pas l\u00e0 pour offrir un service \u00e0 des tiers. Les choses que nous cr\u00e9ons au sein de cette communaut\u00e9 ne concernent que cette communaut\u00e9. Vous \u00eates le bienvenu, mais c\u2019est \u00e0 vous de d\u00e9cider d\u2019en faire partie.</p> <p>Et tant que nous parlons de communaut\u00e9, gardez \u00e0 l\u2019esprit ces quelques points :</p> <ol> <li> <p>La chose la plus importante ici sont les succ\u00e8s.</p> </li> <li> <p>Les personnes les plus importantes sont les cr\u00e9ateurs de succ\u00e8s.</p> </li> </ol> <p>Qu\u2019est-ce que cela signifie ?</p>"},{"location":"RetroAchievements-Manifesto-fr/#la-chose-la-plus-importante-ici-sont-les-succes","title":"La chose la plus importante ici sont les succ\u00e8s.","text":"<p>Nous adorons tous ces badges sur notre profil, non ? Un tel attachement peut engendrer parfois de la frustration lorsqu\u2019une modification est apport\u00e9e \u00e0 une s\u00e9rie de succ\u00e8s. Mais il est important de garder \u00e0 l\u2019esprit que ce projet est en constante \u00e9volution.</p> <p>Nous apportons des modifications aux s\u00e9ries de succ\u00e8s avec un objectif de qualit\u00e9 et pour faire preuve de respect envers le jeu. Nous respectons \u00e9galement les r\u00e9compenses que vous avez obtenues, mais am\u00e9liorer la qualit\u00e9 globale du projet prend le pas sur les profils individuels et ou le total de points de chacun.</p> <p>\u00c9galement, si vous ne ma\u00eetrisez pas une s\u00e9rie de succ\u00e8s, cela ne veut pas forc\u00e9ment dire que le niveau de difficult\u00e9 doit \u00eatre abaiss\u00e9 ou les succ\u00e8s retir\u00e9s ou bascul\u00e9s dans une s\u00e9rie bonus. Si d\u2019autres joueurs sont capables de les avoir, il est probable que vous le puissiez aussi. Mais si ce n\u2019est pas le cas, ce n\u2019est pas grave non plus. Il n\u2019est pas n\u00e9cessaire de d\u00e9bloquer tous les succ\u00e8s existants pour prendre du plaisir avec les jeux r\u00e9tro.</p> <p>Si vous pensez tout de m\u00eame qu\u2019un succ\u00e8s rel\u00e8ve d\u2019un concept qui n\u2019est pas le bienvenu, vous pouvez poster vos arguments sur le forum d\u00e9di\u00e9 \u00e0 ce jeu. Faites simplement preuve de respect dans votre formulation. Ce qui nous am\u00e8ne au prochain point\u2026</p>"},{"location":"RetroAchievements-Manifesto-fr/#les-personnes-les-plus-importantes-sont-les-createurs-de-succes","title":"Les personnes les plus importantes sont les cr\u00e9ateurs de succ\u00e8s.","text":"<p>Ne vous trompez pas ! L\u2019\u00e9cosyst\u00e8me Retroachievements dispose de beaucoup de gens, jouant chacun des r\u00f4les diff\u00e9rents du cr\u00e9ateur de succ\u00e8s, et ils sont tous aussi importants. Mais le cr\u00e9ateur de succ\u00e8s est l\u2019\u00e9pine dorsale du projet. Sans lui, il s\u2019agit juste d\u2019un site Internet archa\u00efque et plein de bugs.</p> <p>Cr\u00e9er des succ\u00e8s est une activit\u00e9 extr\u00eamement chronophage. Les personnes qui s\u2019en occupent, consacrent une part non n\u00e9gligeable de leur temps libre \u00e0 produire du contenu au b\u00e9n\u00e9fice de la communaut\u00e9 tout enti\u00e8re.</p> <p>Quoi qu\u2019il en soit, m\u00eame si vous n\u2019\u00eates pas capable/int\u00e9ress\u00e9 par la cr\u00e9ation de succ\u00e8s et souhaitez juste jouer, vous \u00eates tout aussi important \u00e0 nos yeux. En fait, de nombreux simples joueurs sont de pr\u00e9cieux membres de notre communaut\u00e9. Le point important ici \u00e9tant d\u2019\u00eatre impliqu\u00e9 et agr\u00e9able.</p> <p>Plus vous vous impliquerez, plus vous serez pr\u00e9cieux aux yeux de la communaut\u00e9.</p> <p>Enfin et surtout, si vous deviez \u00e9mettre des critiques \u00e0 l\u2019\u00e9gard du travail d\u2019un cr\u00e9ateur, faites-le dans le respect. \u00catre acerbe avec eux est tr\u00e8s mal vu. Manquez-leur de respect et vous ne serez d\u00e9finitivement plus le bienvenu.</p>"},{"location":"RetroAchievements-Manifesto-pl/","title":"RetroAchievements Manifesto pl","text":"<p>To jest Or\u0119dzie RetroAchievements, kt\u00f3re ka\u017cdy cz\u0142onek spo\u0142eczno\u015bci powinien zna\u0107</p> <p>Od pocz\u0105tku istnienia RetroAchievements to jest nasza odpowied\u017a z FAQ na temat Czym jest RetroAchievements.org?</p> <p>RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit, kt\u00f3ra wsp\u00f3\u0142pracuje i rywalizuje \u017ceby zyska\u0107 w\u0142asne osi\u0105gni\u0119cia do klasycznych gier poprzez emulacje, osi\u0105gni\u0119cia s\u0105 tworzone przez i dla spo\u0142eczno\u015bci. (...)</p> <p>W tym Or\u0119dziu zobaczymy w g\u0142\u0105b tej odpowiedzi</p>"},{"location":"RetroAchievements-Manifesto-pl/#retroachievementsorg-jest-spoecznoscia-non-profit","title":"RetroAchievements.org jest spo\u0142eczno\u015bci\u0105 non-profit","text":"<p>Mamy link do dotacji na stronie g\u0142\u00f3wnej, lecz ci\u0105gle jeste\u015bmy spo\u0142eczno\u015bci\u0105 non-profit</p> <p>Patroni daj\u0105 dos\u0142ownie jednego dolara miesi\u0119cznie, a na szcz\u0119\u015bcie mamy wystarczaj\u0105co patron\u00f3w aby op\u0142aci\u0107 serwer bez polegania na irytuj\u0105cych reklamach</p> <p>Lecz, chcemy aby to by\u0142o oczywiste, \u017ce zdobywanie dotacji to nie nasz model biznesowy, poniewa\u017c RetroAchievements.org to nie jest biznes!</p> <p>Organizacje s\u0105 zawsze ch\u0119tne zyska\u0107 nowych klient\u00f3w. Robi\u0105 co chc\u0105 aby zadowoli\u0107 klienta, aby zyskiwa\u0107 ich wi\u0119cej i wi\u0119cej, lecz tu na RetroAchievements nie jeste\u015bmy organizacj\u0105, My jeste\u015bmy spo\u0142eczno\u015bci\u0105.</p> <p>My nie mamy klient\u00f3w, my mamy cz\u0142onk\u00f3w spo\u0142eczno\u015bci.</p> <p>Jeste\u015bmy grupk\u0105 ludzi z pasj\u0105 to gier retro. Je\u015bli masz tak\u0105 sam\u0105 pasj\u0119, ciep\u0142o cie przywitamy.</p> <p>Mimo i\u017c przyjmujemy wszystkich, nie b\u0142agamy desperacko o nowych u\u017cytkownik\u00f3w. To tw\u00f3j wyb\u00f3r, je\u017celi podoba ci si\u0119 oferta kt\u00f3r\u0105 mamy, chwy\u0107 za pada i zagrajmy w klasyki!</p>"},{"location":"RetroAchievements-Manifesto-pl/#osiagniecia-stworzone-sa-przez-i-dla-spoecznosci","title":"Osi\u0105gni\u0119cia stworzone s\u0105 przez i dla spo\u0142eczno\u015bci.","text":"<p>To jest powi\u0105zane z tym to by\u0142o podane powy\u017cej. Nie oferujemy us\u0142ugi dla os\u00f3b z zewn\u0105trz. Rzeczy kt\u00f3re tworzymy w tej spo\u0142eczno\u015bci nale\u017c\u0105 do tej samej spo\u0142eczno\u015bci. Mo\u017cesz z nami zosta\u0107, ale to tw\u00f3j wyb\u00f3r, czy chcesz by\u0107 jej cz\u0119\u015bci\u0105.</p> <p>Podczas bycia cz\u0119\u015bci\u0105 tej spo\u0142eczno\u015bci, pami\u0119taj poni\u017csze o\u015bwiadczenia:</p> <p>1. Najwa\u017cniejsz\u0105 rzecz\u0105 jak\u0105 tu mamy s\u0105 osi\u0105gni\u0119cia.</p> <p>2. Najwa\u017cniejszymi osobami s\u0105 tw\u00f3rcy osi\u0105gni\u0119\u0107.</p> <p>Co to znaczy?</p>"},{"location":"RetroAchievements-Manifesto-pl/#najwazniejsza-rzecza-jaka-tu-mamy-sa-osiagniecia","title":"Najwa\u017cniejsz\u0105 rzecz\u0105 jak\u0105 tu mamy s\u0105 osi\u0105gni\u0119cia.","text":"<p>Wszyscy kochamy te odznaki na naszej stronie profilowej, racja? Te przywi\u0105zanie do odznaki czasem powoduje irytacje kiedy szczeg\u00f3lny zestaw osi\u0105gni\u0119\u0107 przejdzie przez rewizje. Wa\u017cne jest pami\u0119ta\u0107 \u017ce ten projekt ci\u0105gle ewoluuje.</p> <p>Robimy Rewizje do zestaw\u00f3w osi\u0105gni\u0119\u0107 z my\u015bl\u0105 o jako\u015bci, i \u017ceby odda\u0107 szacunek grze. Szanujemy r\u00f3wnie\u017c nagrody kt\u00f3re posiadasz, lecz polepszanie jako\u015bci projektu jest wa\u017cniejsze od naszych stron profilowych lub liczby punkt\u00f3w.</p> <p>R\u00f3wnie\u017c, je\u015bli nie jeste\u015b zdolny opanowa\u0107 zestaw osi\u0105gni\u0119\u0107, to nie znaczy \u017ce automatycznie powinien by\u0107 u\u0142atwiony/zdj\u0119ty/przeniesiony do bonusowego zestawu. Je\u017celi innym graczom si\u0119 uda\u0142o, jest prawdopodobne \u017ce ci si\u0119 te\u017c mo\u017ce uda\u0107. Lecz je\u015bli nie mo\u017cesz, jest okej. Nie musisz odblokowa\u0107 ka\u017cdego osi\u0105gni\u0119cia aby mie\u0107 frajd\u0119 z starych gier.</p> <p>Je\u017celi ci\u0105gle my\u015blisz \u017ce zestaw osi\u0105gni\u0119\u0107 ma niechciany koncept, mo\u017cesz napisa\u0107 swoje argumenty w temacie gry na forum. Tylko pisz z szacunkiem, co prowadzi nas do kolejnego punktu...</p>"},{"location":"RetroAchievements-Manifesto-pl/#najwazniejszymi-osobami-sa-tworcy-osiagniec","title":"Najwa\u017cniejszymi osobami s\u0105 tw\u00f3rcy osi\u0105gni\u0119\u0107.","text":"<p>Nie przyjmij tego \u017ale! Ekosystem RetroAchievements ma wiele os\u00f3b, kt\u00f3rzy maj\u0105 inne role ni\u017c tw\u00f3rca osi\u0105gni\u0119\u0107 i s\u0105 oni wszyscy wa\u017cni. lecz tw\u00f3rcy osi\u0105gni\u0119\u0107 s\u0105 podstaw\u0105 tego projektu. Bez nich, to jest tylko stara i zbugowana strona.</p> <p>Tworzenie osi\u0105gni\u0119\u0107 to proces zajmuj\u0105cy mas\u0119 czasu. Osoby dedykuj\u0105 spor\u0105 cz\u0119\u015b\u0107 swojego wolnego czasu produkuj\u0105c zawarto\u015b\u0107 na korzy\u015b\u0107 ca\u0142ej spo\u0142eczno\u015bci</p> <p>Nawet je\u015bli nie jeste\u015b zdolny lub nie chcesz tworzy\u0107 osi\u0105gni\u0119\u0107, a chcesz tylko sobie pogra\u0107, jeste\u015b r\u00f3wnie\u017c wa\u017cny dla nas. Mamy wielu graczy kt\u00f3rzy s\u0105 warto\u015bciowymi cz\u0142onkami. Punktem kluczowym jest bycie mi\u0142ym i staranie si\u0119</p> <p>Tym bardziej si\u0119 przyk\u0142adasz, tym bardziej jeste\u015b warto\u015bciowy dla naszej spo\u0142eczno\u015bci.</p> <p>Na koniec, je\u015bli masz krytyk\u0119 na temat pracy tw\u00f3rcy osi\u0105gni\u0119\u0107, uszanuj ich. okazywanie rozgoryczenia jest nie mile widziane. Gdy b\u0119dziesz niemi\u0142y wobec nich, za d\u0142ugo tu nie zostaniesz</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/","title":"O Manifesto RetroAchievements","text":"<p>Este \u00e9 o Manifesto RetroAchievements e todo membro desta comunidade DEVE estar ciente disso.</p> <p>Desde os prim\u00f3rdios do RetroAchievements, isto \u00e9 o que temos no nosso FAQ como resposta para O que \u00e9 o RetroAchievements.org?</p> <p>RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos que colabora e compete para ganhar conquistas personalizadas em jogos cl\u00e1ssicos atrav\u00e9s de emula\u00e7\u00e3o. As conquistas s\u00e3o criadas pela e para a comunidade. (...)</p> <p>Neste manifesto n\u00f3s vamos nos aprofundar nessa resposta.</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#retroachievementsorg-e-uma-comunidade-sem-fins-lucrativos","title":"RetroAchievements.org \u00e9 uma comunidade sem fins lucrativos","text":"<p>N\u00f3s temos um link de doa\u00e7\u00f5es na nossa p\u00e1gina principal, mas ainda assim n\u00f3s somos uma comunidade sem fins lucrativos.</p> <p>Os patronos contribuem com, literalmente, um d\u00f3lar (1 USD) por m\u00eas e, felizmente, n\u00f3s temos patronos suficiente para pagar o servidor sem que precisemos recorrer aos an\u00fancios irritantes.</p> <p>No entanto, queremos deixar bem claro que obter doa\u00e7\u00f5es n\u00e3o \u00e9 o nosso modelo de neg\u00f3cio pelo exato motivo de que RetroAchievements n\u00e3o \u00e9 um neg\u00f3cio!</p> <p>Organiza\u00e7\u00f5es de neg\u00f3cios est\u00e3o sempre ansiosas para obter mais e mais clientes. Elas fazem o que elas podem para agradar os clientes e continuar obtendo cada vez mais. Mas aqui, no RetroAchievements, n\u00f3s n\u00e3o somos um neg\u00f3cio, n\u00f3s somos uma comunidade.</p> <p>N\u00e3o temos clientes, n\u00f3s temos membros da comunidade.</p> <p>N\u00f3s somos um grupo de pessoas apaixonadas por retrogames. E se voc\u00ea compartilhar da mesma paix\u00e3o, voc\u00ea \u00e9 muito bem vindo a se juntar a n\u00f3s!</p> <p>Embora estejamos de portas abertas para receber bem qualquer um, n\u00f3s n\u00e3o estamos desesperadamente implorando por mais usu\u00e1rios. Cabe a voc\u00ea decidir: se voc\u00ea gosta do que n\u00f3s temos a oferecer, pegue o seu joystick e vamos jogar alguns cl\u00e1ssicos!</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#conquistas-sao-feitas-pela-e-para-a-comunidade","title":"Conquistas s\u00e3o feitas pela e para a comunidade","text":"<p>Isto est\u00e1 relacionada com o que foi dito acima. N\u00f3s n\u00e3o estamos oferecendo um servi\u00e7o para pessoas de fora. As coisas que criamos nesta comunidade s\u00e3o para esta mesma comunidade. Voc\u00ea \u00e9 bem-vindo a ficar com a gente, mas cabe a voc\u00ea decidir se quer ser parte disso.</p> <p>E enquanto fizer parte desta comunidade, tenha sempre em mente as seguintes afirma\u00e7\u00f5es:</p> <p>1. A coisa mais importante que n\u00f3s temos aqui s\u00e3o as conquistas.</p> <p>2. As pessoas mais importantes que n\u00f3s temos aqui s\u00e3o os criadores de conquistas.</p> <p>E o que isso significa? Abaixo, abordaremos de forma mais detalhada cada conceito e os motivos de serem t\u00e3o fundamentais:</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#a-coisa-mais-importante-que-nos-temos-aqui-sao-as-conquistas","title":"A coisa mais importante que n\u00f3s temos aqui s\u00e3o as conquistas","text":"<p>N\u00f3s todos amamos aquelas ins\u00edgnias na nossa p\u00e1gina do perfil, certo? Tal apego aquela ins\u00edgnia, \u00e0s vezes, causa frustra\u00e7\u00e3o quando a respectiva cole\u00e7\u00e3o de conquistas recebe uma revis\u00e3o, mas \u00e9 importante ter em mente que este projeto est\u00e1 constantemente evoluindo.</p> <p>N\u00f3s fazemos revis\u00f5es nas conquistas tendo em mente a qualidade e para mostrar verdadeiro respeito pelo jogo. Tamb\u00e9m respeitamos os trof\u00e9us que voc\u00ea obteve, mas melhorar a qualidade geral do projeto tem preced\u00eancia sobre nossas p\u00e1ginas de perfil e/ou quantidade de pontos.</p> <p>Al\u00e9m disso, se voc\u00ea n\u00e3o for capaz de obter todas as conquistas de um jogo, isso n\u00e3o significa automaticamente que elas precis\u00e3o ser suavizadas/removidas/se tornarem conquistas b\u00f4nus. Se outros jogadores obtiveram aquelas conquistas, \u00e9 prov\u00e1vel que voc\u00ea tamb\u00e9m consiga. Contudo, se voc\u00ea n\u00e3o consegue, est\u00e1 tudo bem tamb\u00e9m. Voc\u00ea n\u00e3o precisa desbloquear todas as conquistas para continuar se divertindo com jogos antigos.</p> <p>Se ainda assim voc\u00ea acha que a cole\u00e7\u00e3o de conquistas possui conceitos indesej\u00e1veis, voc\u00ea pode postar seus argumentos no f\u00f3rum no t\u00f3pico do jogo. Apenas certifique-se de ser respeitoso em suas palavras. O que nos leva ao pr\u00f3ximo ponto...</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#as-pessoas-mais-importantes-que-nos-temos-aqui-sao-os-criadores-de-conquistas","title":"As pessoas mais importantes que n\u00f3s temos aqui s\u00e3o os criadores de conquistas","text":"<p>N\u00e3o nos entenda mal! O ecossistema do RetroAchievements tem muitas pessoas executando muitos papeis diferentes de criar conquistas \u2014 e elas s\u00e3o todas importantes. Os criadores de conquistas s\u00e3o a espinha dorsal desse projeto. Sem eles, isso aqui \u00e9 apenas um site bugado e antiquado.</p> <p>Cria\u00e7\u00e3o de conquistas \u00e9 uma atividade que consome muito tempo. As pessoas que fazem isso dedicam uma grande parte do seu tempo livre produzindo conte\u00fado em prol de toda a comunidade.</p> <p>De qualquer forma, mesmo que voc\u00ea n\u00e3o consiga ou n\u00e3o esteja interessado em criar conquistas e queira apenas jogar, voc\u00ea tamb\u00e9m \u00e9 importante para n\u00f3s! Na verdade n\u00f3s temos in\u00fameros jogadores que s\u00e3o membros muito valiosos. O ponto-chave aqui \u00e9: envolva-se e seja legal.</p> <p>Quanto mais voc\u00ea se envolve, mais valioso voc\u00ea \u00e9 para a comunidade.</p> <p>Por \u00faltimo, mas n\u00e3o menos importante, se voc\u00ea tiver cr\u00edticas sobre o trabalho dos criadores de conquistas, seja respeitoso. Demonstrar hostilidade em rela\u00e7\u00e3o a eles \u00e9 fortemente desaprovado. Seja desrespeitoso com eles e voc\u00ea definitivamente n\u00e3o ser\u00e1 bem-vindo aqui.</p>"},{"location":"RetroAchievements-Manifesto-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-04-26 08:14] meleu:</code> fix links</li> <li><code>[2020-09-16 12:32] meleu:</code> reverting small changes</li> <li><code>[2020-09-16 12:29] meleu:</code> Revert 4f2de8f85aecad218d3d7bb533c9b7eb343de796...c175774b3077e1d3bc3d0e794e126a8febb143ff on RetroAchievements Manifesto pt_BR</li> <li><code>[2020-09-10 04:12] Alexandre Gadelha:</code> Movido a se\u00e7\u00e3o 3 como item 4 da se\u00e7\u00e3o 2.</li> <li><code>[2020-09-10 04:05] Alexandre Gadelha:</code> Pequena edi\u00e7\u00e3o final</li> <li><code>[2020-09-10 04:04] Alexandre Gadelha:</code> Adi\u00e7\u00e3o do item 3 na se\u00e7\u00e3o 2 (Conquistas s\u00e3o feitas pela e para a comunidade). Adi\u00e7\u00e3o da se\u00e7\u00e3o 3. Melhorias quanto a ortografia.</li> <li><code>[2020-09-10 02:55] Alexandre Gadelha:</code> Pequenas edi\u00e7\u00f5es</li> <li><code>[2020-09-10 02:43] Alexandre Gadelha:</code> Arrumado os erros de ortografia e erros de digita\u00e7\u00e3o</li> <li><code>[2020-09-10 01:47] meleu:</code> Updated The RetroAchievements Manifesto pt_BR (markdown)</li> <li><code>[2020-09-10 01:47] meleu:</code> Destroyed RetroAchievements Manifesto pt_BR (markdown)</li> </ul>"},{"location":"RetroAchievements-Manifesto/","title":"RetroAchievements Manifesto","text":"<p>This is the RetroAchievements Manifesto and every member of this community should be aware of this.</p> <p>Since the early days of RetroAchievements, this is what we have in our FAQ as the answer for What is RetroAchievements.org?</p> <p>RetroAchievements.org is a zero profit community who collaborate and compete to earn custom-made achievements in classic games through emulation. Achievements are made by and for the community. (...)</p> <p>In this manifesto we're going to go deeper into that answer.</p>"},{"location":"RetroAchievements-Manifesto/#retroachievementsorg-is-a-zero-profit-community","title":"RetroAchievements.org is a zero profit community","text":"<p>We do have a donation link on our frontpage, but we're still a zero profit community.</p> <p>The patrons contribute with literally one dollar per month, and fortunately we have enough patrons to pay for server expenses without needing to rely on annoying adverts.</p> <p>However, we want to make very clear that getting donations is not our business model, exactly because RetroAchievements is not a business!</p> <p>Business organizations are always eager to get more customers. They do what they can to please the customers and keep getting more and more of them. But here, at RetroAchievements, we are not a business, we are a community.</p> <p>We don't have customers, we have community members.</p> <p>We are a bunch of people passionate about retrogames. And if you share the same passion, you're very welcome to join us.</p> <p>Although we're welcoming anyone, we're not desperately begging for more and more users. It's your call: if you like what we have to offer, pick your gamepad and let's play some classics!</p>"},{"location":"RetroAchievements-Manifesto/#achievements-are-made-by-and-for-the-community","title":"Achievements are made by and for the community.","text":"<p>It's related to what was said above. We are not offering a service for outsiders. The things we create in this community are for this very same community. You're welcome to stay with us, but it's up to you to decide if you want to be part of it.</p> <p>And while being part of this community, always keep in mind the following statements:</p> <p>1. The most important thing we have here are the achievements.</p> <p>2. The most important people we have here are the achievement creators.</p> <p>What does that mean?</p>"},{"location":"RetroAchievements-Manifesto/#the-most-important-thing-we-have-here-are-the-achievements","title":"The most important thing we have here are the achievements.","text":"<p>We all love those badges on our profile page, right? Such attachment to that badge sometimes causes frustration when the respective achievement set get a revision. But it's important to keep in mind that this project is constantly evolving.</p> <p>We make achievement set revisions with quality in mind, and to show actual respect for the game. We also have respect for the awards you got, but improving the overall quality of the project has precedence over our individual profile pages and/or our amount of points.</p> <p>Also, if you're not able to master an achievement set it doesn't automatically mean that it needs to be nerfed/demoted/turned into a bonus set. If other players got that, it's probable you can get that too. But if you can't, it's OK too. You don't need to unlock every achievement to keep having fun with old games.</p> <p>If you still think the achievement set has unwelcome concepts, you can post your arguments in the game's forum topic. Just be sure to be respectful in your words. Which brings us to the next point...</p>"},{"location":"RetroAchievements-Manifesto/#the-most-important-people-we-have-here-are-the-achievement-creators","title":"The most important people we have here are the achievement creators.","text":"<p>Don't get it wrong! The RetroAchievements ecosystem has a lot of people, playing many different roles than creating achievements, and they are all important. But the achievement creators are the backbone of this project. Without them, this is just a buggy and old fashioned website.</p> <p>Achievement creation is a very time consuming activity. The people doing it dedicate a big portion of their free time producing content for the benefit of the whole community.</p> <p>Anyways, even if you're not able to/interested in creating achievements and just want to play, you're also important to us. In fact we have countless players that are very valuable members. The key point here is: get involved and be nice.</p> <p>The more you get involved, the more valuable you are to the community.</p> <p>Last but not least, if you have criticism about achievement creators' work, be respectful. Showing bitterness towards them is strongly frowned upon. Be disrespectful with them and you're definitely not welcome here.</p>"},{"location":"RetroAchievements-Manifesto/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-19 23:45] televandalist:</code> Slight grammar fix about server expenses.</li> <li><code>[2020-09-17 14:44] meleu:</code> the you are valuable -&gt; the more valuable you are</li> <li><code>[2020-09-08 07:45] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 19:39] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 09:10] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 08:48] meleu:</code> Updated RetroAchievements Manifesto (markdown)</li> <li><code>[2020-09-07 08:45] meleu:</code> Created RetroAchievements Manifesto (markdown)</li> </ul>"},{"location":"Rich-Presence-es/","title":"Rich Presence","text":""},{"location":"Rich-Presence-es/#introduccion","title":"Introducci\u00f3n","text":"<p>Rich Presence (RP) es un breve resumen de lo que est\u00e1n haciendo los jugadores activos en su partida. Para tener RP en un juego necesitas un Script de Rich Presence (RPS) que este es creador por desarrolladores. El Script checa la memoria del juego y ya sea como esta fue programada reporta los valores de ciertas direcciones con definiciones asignadas por el desarrollador as\u00ed como en que stage se encuentra el jugador, cuantas vidas tienes, si el juego esta en pausa, que modo de juego se encuentra jugando, lo que a logrado el jugador, etc. Esta informacion es reportada de vuelta al sitio. Cada juego publicado deber\u00eda de tener m\u00ednimo un RPS b\u00e1sico.</p> <p>Ejemplo de RP en acci\u00f3n:</p> <p> </p> <p>Para ver la RP en tiempo real haz clic en el menu de RetroAchievements en tu emulador y despu\u00e9s en Rich Presence Monitor. Una peque\u00f1a ventana deber\u00eda de mostrar tu RP actual. (Bueno para realizar pruebas)</p> <p></p> <p>La mejor manera de entender Rich Presence es observar varios ejemplos de juegos, mira las direcciones que fueron utilizadas a mira como el texto es mostrado en el monitor y en el sitio.</p>"},{"location":"Rich-Presence-es/#como-funciona","title":"Como funciona?","text":"<p>Cada vez que un juego es lanzado, guarda los logros del juego en un archivo de 'ruta' donde el ROM detalla todos los logros y valores en memoria (y tablas clasificatorias) que puede llegar a rastrear. Tambi\u00e9n va a solicitar un Script de  Rich Presence para el ROM que se encuentre actualmente cargado. El emulador va a reportar al sitio web cada 120 segundos. Similarmente, cada 120 segundos o parecido, la caja de 'active players' en la pagina de inicio se va a refrescar, detallando la ultima actividad conocida por todos los jugadores activos. Si no hay un Script de rich presence entregado, el texto sera 'earning achievements' Si se esta jugando un juego con logros, 'playing [game]' si se juega un juego sin logros, o 'developing achievements' si la ventaba de memoria esta abierta y es visible. </p> <p>El RPS de cada juego puede ser encontrado en la secci\u00f3n de desarrollo en cada pagina de juego: </p> <p></p> <p></p>"},{"location":"Rich-Presence-es/#ejemplo-super-mario-bros","title":"Ejemplo (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>El RSP se compone de objetos de Lookup, objectos de Formato y un objeto de Display. </p>"},{"location":"Rich-Presence-es/#lookups","title":"Lookups","text":"<p>Los Lookups se definen de la siguiente manera: </p> <pre><code>Lookup:NombreDelLockup\nValor1=Texto cuando este valor este activo\nValor2=Texto cuando este otro valor\n...\n</code></pre> <p>Le damos un valor al Lookup, consistiendo de una serie de direcciones de memoria y modificador. Encontraras mas sobre esto mas adelante. </p>"},{"location":"Rich-Presence-es/#formato","title":"Formato","text":"<p>Las Tablas de Formato se definen de la siguiente manera:</p> <pre><code>Format:Score\nFormatType=VALOR\n</code></pre> <p>Empezamos con <code>Formato:</code>, y despu\u00e9s con el nombre del tipo de formato. En la siguiente linea, escribe <code>FormatType=</code>, y entonces uno de los siguientes valores: <code>VALUE</code>, <code>SCORE</code> (o <code>POINTS</code>), <code>TIME</code> (o <code>FRAMES</code>), <code>SECS</code>, <code>MILLISECS</code>, o <code>OTHER</code>. </p> <ul> <li><code>VALUE</code>: valor gen\u00e9rico, no se agregan ceros. </li> <li><code>SCORE</code>/<code>POINTS</code>: \"000130 puntos\" </li> <li><code>TIME</code>/<code>FRAMES</code>: este valor describe el numero de frames consecuentes, y se va a mostrar como 00:00.00 </li> <li><code>SECS</code>: este valor describe el numero de segundos que han pasado, y se va a mostrar como 00:00 </li> <li><code>MILLISECS</code>: este valor describe el numero de centenas de segundo que han pasado, y se va a mostrar como 00:00.00 </li> </ul>"},{"location":"Rich-Presence-es/#display","title":"Display","text":"<p>Display es la string que se muestra en la caja de 'Active Players' en la pagina de inicio del sitio web. Para referirte a un Lookup o aun Format previamente definidos se utiliza simplemente un '@'. Y entonces se agrega el nombre que le diste al lookup o al format (distingue may\u00fasculas y min\u00fasculas!), e inmediatamente despu\u00e9s de eso, en brackets, sigue la serie de valores en memoria que especifican que sera enviado a ese lookup y format.</p> <p><code>@Powerup(0xh756)</code> </p> <p>Eso significa que vas a utilizar el Lookup o Format que se llama <code>Powerup</code>, y entrega cualquier valor que se encuentre actualmente en 0xh756. </p>"},{"location":"Rich-Presence-es/#analizando-el-lookup-de-ejemplo","title":"Analizando el Lookup de Ejemplo","text":"<ul> <li><code>@Mode(0xh770)</code> - Un Lookup para la direcci\u00f3n que muestra si el juego se encuentra en modo demo o si un mundo a sido completado.  </li> <li><code>@Paused(0xh776)</code> - Un Lookup para la direcci\u00f3n que muestra si el juego se encuentra en pausa (Se utilizan 3 valores, dos de ellos son para pausar y despausar).  </li> <li><code>@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Un Lookup para la direcci\u00f3n que muestra si Mario tiene la Estrella. Mas sobre esto mas adelante.  </li> <li><code>@Powerup(0xh756)</code> - Un Lookup para la direcci\u00f3n que muestra si Mario es Peque\u00f1o, grande o cuenta con la habilidad de fuego.  </li> <li><code>Mario in</code> - Texto est\u00e1tico para unir los objetos format y lookup.  </li> <li><code>@Digit(0xh75f_v1)</code> - <code>Digit</code> es un objeto format definido como un valor. La direcci\u00f3n 0xh75f es Mundo menos 1 (porque cuenta con base 0, y este empieza a contar desde cero). <code>_v1</code> Significa + valor 1. <code>_v+1</code> tambi\u00e9n es correcto.  </li> <li><code>-</code> - Mas texto est\u00e1tico para separar el mundo y el nivel. como en el juego Mundo 1-1.  </li> <li><code>@Digit(0xh75c_v1)</code> - Otro uso del objeto <code>Digit</code> format . Esta vez se encuentra rastreando el Stage. Mundo 1-X.  </li> <li><code>@Swimming(0xh704)</code> - Un Lookup para la direcci\u00f3n que muestra si el jugador se encuentra nadando.  </li> <li><code>@Status(0xhe)</code> - Un Lookup para la direcci\u00f3n que muestra el estatus de Mario, como por ejemplo descendiendo de un tubo.  </li> <li><code>, \ud83d\udeb6:</code> - Mas texto est\u00e1tico. \ud83d\udeb6 es el s\u00edmbolo para vidas.  </li> <li><code>@Digit(0xh75a_v1)</code> - Tercer uso del objeto <code>Digit</code> format. Esta vez checa la direcci\u00f3n de vidas del jugador.  </li> <li><code>,</code> - Texto est\u00e1tico.  </li> <li><code>@Quest(0xh7fc)</code> Un lookup para ver si el jugador se encuentra en modo normal o en la 2da vuelta (modo dificil).  </li> <li><code>Quest</code> - Texto est\u00e1tico.  </li> </ul>"},{"location":"Rich-Presence-es/#tamano-de-direcciones","title":"Tama\u00f1o de Direcciones","text":"<p>Para especificar el tama\u00f1o de la direcci\u00f3n que te encuentras utilizando, hay varios caracteres que se utilizan para esto. (se ignora si es may\u00fascula o min\u00fascula)</p> <ul> <li>Una direcci\u00f3n de 16bit es el default y esta no cuenta con un car\u00e1cter designado. En 0x10 la direcci\u00f3n es de dos bytes - 16 bits.</li> <li>El car\u00e1cter para una direcci\u00f3n de 8bit es <code>h</code> (o <code>H</code>). En 0xh10 la direcci\u00f3n es un byte - 8 bits. <code>xxxx xxxx</code> </li> <li>El car\u00e1cter para una direcci\u00f3n upper4 es <code>u</code> (o <code>U</code>). En 0xu10 la direcci\u00f3n es un nibble - 4 bits. <code>xxxx 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n lower4 es <code>l</code> (o <code>L</code>). En 0xl10 la direcci\u00f3n es un nibble - 4 bits. <code>0000 xxxx</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit0 es <code>m</code> (o <code>M</code>). En 0xm10 la direcci\u00f3n es un bit, el bit mas bajo: <code>0000 000x</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit1 es <code>n</code> (o <code>N</code>). En 0xn10 la direcci\u00f3n es un bit, el segundo bit: <code>0000 00x0</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit2 es <code>o</code> (o <code>O</code>). En 0xo10 la direcci\u00f3n es un bit, el tercer bit: <code>0000 0x00</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit3 es <code>p</code> (o <code>P</code>). En 0xp10 la direcci\u00f3n es un bit, el cuarto bit: <code>0000 x000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit4 es <code>q</code> (o <code>Q</code>). En 0xq10 la direcci\u00f3n es un bit, el quinto bit: <code>000x 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit5 es <code>r</code> (o <code>R</code>). En 0xr10 la direcci\u00f3n es un bit, el sexto bit: <code>00x0 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit6 es <code>s</code> (o <code>S</code>). En 0xs10 la direcci\u00f3n es un bit, el s\u00e9ptimo bit: <code>0x00 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n bit7 es <code>t</code> (o <code>T</code>). En 0xt10 la direcci\u00f3n es un bit, el bit mas alto: <code>x000 0000</code> </li> <li>El car\u00e1cter para una direcci\u00f3n de 32bit es <code>x</code> (o <code>X</code>). En 0xx10 la direcci\u00f3n es de cuatro bytes y 32 bits.</li> </ul> <p>Resumiendolo en una tabla:</p> localizaci\u00f3n/tama\u00f1o prefijo (las letras pueden ser en min\u00fasculas) ejemplo bit0 <code>0xM</code> <code>0xM01234</code> bit1 <code>0xN</code> <code>0xN01234</code> bit2 <code>0xO</code> <code>0xO01234</code> bit3 <code>0xP</code> <code>0xP01234</code> bit4 <code>0xQ</code> <code>0xQ01234</code> bit5 <code>0xR</code> <code>0xR01234</code> bit6 <code>0xS</code> <code>0xS01234</code> bit7 <code>0xT</code> <code>0xT01234</code> Lower4 <code>0xL</code> <code>0xL01234</code> Upper4 <code>0xU</code> <code>0xU01234</code> 8bit <code>0xH</code> <code>0xH01234</code> 16bit <code>0x</code> <code>0x01234</code> 32bit <code>0xX</code> <code>0xX01234</code>"},{"location":"Rich-Presence-es/#display-con-strings-condicionales","title":"Display con Strings Condicionales","text":"<pre><code>Display:\n?0x 000085=0?Pantalla de Titulo\n?0xT00007c=1?Mapa Personalizado en @Zona(0xH00016c)\nJugando Batalla @Batalla(0x 00007c*0.2) en @Zona(0xH00016c)\n</code></pre> <p>El marcador <code>Display:</code> se sigue utilizando para indicar el principio del bloque de Display. Si la siguiente linea empieza con un signo de interrogaci\u00f3n, se considera como un display con una string condicional. La parte de la linea que se encuentra entre los dos signos de interrogaci\u00f3n es la clausula de la condici\u00f3n. Si la clausula de la condici\u00f3n se eval\u00faa y esta es verdadera, entonces la siguiente parte de la linea se utiliza como el string del display. Si esta no se eval\u00faa como verdadera, entonces se procede a la siguiente linea. Si esta empieza con un signo de interrogaci\u00f3n, entonces el mismo proceso se repite. Si este no empieza con un signo de interrogaci\u00f3n, la linea entera se utiliza como el string default para el display.</p> <p>NOTA: Se requiere una string default en caso de que ninguna de tus strings condicionales sean verdaderas. Si solamente cuentas con strings condicionales, el script no va a hacer nada.</p> <p>Observando este ejemplo, si el valor de 16-bit en $0085 es igual a 0, el string del display sera <code>Title Screen</code>. Si no, la siguiente linea es examinada. Si el 7mo bit de $007C es igual a 1, el string del display sera <code>Mapa Personalizado en @Zona(0xH00016c)</code>. Si no entonces, como linea final no cuenta con una clausula condicional esta es utilizada.</p> <p>Strings de Display asociados con una clausula condicional soportan todo la misma sintaxis que el string de display predeterminado. En este ejemplo, puedes ver que el lookup <code>@Zona</code> se utiliza en los dos strings condicionales y en el string predeterminado. </p> <p>La frase condicional soporta todos los asesores de direcciones previamente mencionados as\u00ed como la l\u00f3gica de los AND (_) y OR (S). Nota: las clausulas OR aun requieren un grupo 'core', as\u00ed como en los logros.</p> <ul> <li><code>?0xH1234=32_0xH2345=0?ejemplo y</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $2345 is 0, muestra <code>ejemplo y</code></p> </li> </ul> <ul> <li><code>?0xH1234=32S0xH2345=1S0xH2345=2?ejemplo o</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $2345 es 1 o 2, muestra <code>ejemplo o</code></p> </li> </ul> <ul> <li><code>?0xH1234=32_0xH5678=33S0xH2345=1S0xH2345=2?ejemplo y/o</code><p>si el valor de 8-bit en $1234 es 32 y el valor de 8-bit en $5678 es 33 y el valor de 8-bit en $2345 es 1 o 2, muestra <code>ejemplo y/o</code></p> </li> </ul>"},{"location":"Rich-Presence-es/#codigo-binario-programado-en-decimal-bcd","title":"C\u00f3digo Binario programado en Decimal (BCD)","text":"<p>BCD es cuando cuando los valores son almacenados en una direcci\u00f3n del 0-9 (un d\u00edgito) o 0-99 (dos d\u00edgitos). ten en mente que la mayor\u00eda de las veces los valores son almacenados en hexadecimal, pero algunas veces los juegos los almacenan de esta manera y aqu\u00ed esta el mejor m\u00e9todo para trabajar con este tipo de valores en tu display.</p> <p>BCD decodifica cada car\u00e1cter hexadecimal como un d\u00edgito decimal. Si el inspector de memoria muestra un 86 (en hex), el resulta de BCD decodificando el valor seria un 86 (en decimal).</p> <p>Para objectos con estos valores puedes utilizar le prefijo BCD, como aqu\u00ed <code>b0xh1234</code>. Esto tambi\u00e9n funciona con valores en tablas de clasificaci\u00f3n. Ten en cuenta que tambi\u00e9n vas a necesitar especificar el tama\u00f1o de la direcci\u00f3n BCD en memoria. <code>b0x1234</code> lee un valor de  16-bit. <code>b0xh1234</code> lee un valor de 8-bit y <code>b0xX1234</code> lee un valor de 32-bit. NOTA: Soporte para decodificacion BCD de 16-bit y 32-bit es una funci\u00f3n para el kit de desarrollo 0.075.</p> <p>Esto es usualmente usado para puntuaciones y tiempo, pero algunas veces tambi\u00e9n para otros tipos de valores.</p>"},{"location":"Rich-Presence-es/#limites","title":"Limites","text":"<ul> <li>Limite de 16,000 caracteres por script  </li> <li>Limite de 100 caracteres para lo que se esta mostrando</li> <li>Caracteres Unicode son permitidos</li> </ul>"},{"location":"Rich-Presence-es/#detalles-de-la-sintaxis","title":"Detalles de la Sintaxis","text":"<ul> <li>Las llaves para Lookups son en decimal por default y hex si agregas el prefijo <code>0x</code>. Esto significa <code>1</code> == <code>0x1</code>, <code>2</code> == <code>0x2</code>, <code>9</code> == <code>0x9</code>, <code>10</code> == <code>0xa</code>, <code>100</code> == <code>0x64</code>, etc.  </li> <li>Los nombres para Lookup/Format son sensibles entre may\u00fasculas y min\u00fasculas por lo que necesitas escribir exactamente igual el nombre para que se muestre correctamente en el string del display: <code>@test(0x1234)</code> el cual no va a encontrar \"Format:Test\"</li> <li>Un Lookup/Format no pueden contener espacios antes o despu\u00e9s del nombre. <code>@test(0x1234)</code> no va a encontrar \"Format:test   \" o \"Format:   test\"</li> <li>Si tu Lookup/Format no puede ser encontrado, no se va a mostrar nada. <code>Esta es una prueba @test(0x1234).</code> va a salir como <code>Esto es una .</code> si <code>test</code> no puede ser encontrado.</li> <li>Se pueden agregar comentarios en cualquier parte del script. Una doble diagonal (<code>//</code>) indica que la parte restante de la linea va a ser ignorada cuando se procese el script. Nota: los comentarios tambi\u00e9n aplican para el tama\u00f1o m\u00e1ximo de caracteres del script.</li> </ul>"},{"location":"Rich-Presence-es/#tips-y-trucos","title":"Tips y Trucos","text":"<ul> <li>Los nombres de los Lookup pueden ser tan cortos como un solo car\u00e1cter si necesitas ahorrarte algunos caracteres extras.</li> <li>Zeros subsecuentes pueden ser eliminados de las direcciones (<code>0xh0001</code> puede ser acortado a <code>0xh1</code>).</li> <li>Convertir todos tus valores de hex a decimal va tomar muchos menos caracteres.</li> <li>Caracteres Unicode no siempre \"toman menos espacio\" ellos usualmente toman hasta cuatro caracteres del sistema.</li> <li>Si un lookup no contiene ning\u00fan valor mapeados, va a resultar en un valor (sin espacio) en blanco. Puedes cambiar este comportamiento agregando una sola linea a los valores del lookup, '*' a el valor que deseas.</li> <li>Cada <code>Lookup</code> o <code>Format</code> puede ser cargado m\u00faltiples veces con las mismas o diferentes direcciones. Puedes definir un solo <code>Format:Number FormatType=VALUE</code> en vez de definir valores individuales para las vidas, Puntuaci\u00f3n, Nivel, etc.</li> <li>Poner espacios a tus lookups algunas veces antes o despues puede ayudarte a esconder ciertos lookups cuando estos no son requeridos, como lo hacen <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code>, y @Mode . </li> </ul>"},{"location":"Rich-Presence-es/#propiedades-de-los-valores","title":"Propiedades de los Valores","text":"<p>Cuando utilizamos objetos lookup y format <code>@object()</code> es posible combinar y hacer c\u00e1lculos. Esto puede ser utilizado para mostrar una puntuaci\u00f3n correctamente, tiempo del juego, etc. o hacen lookups avanzados.</p> <p>Ejemplo <code>@Puntuaci\u00f3n(0x28*10_0x29*1000_0x26*100000) puntos</code> </p> <p>Esto significa utiliza el lookup o Format <code>Puntuaci\u00f3n</code>, y entrega la suma de: - 0x28 10 veces, AGREGA - 0x29 1000 veces, AGREGA - 0x26 100000 veces</p> <ul> <li><code>_</code> agregas las direcciones mutuamente.  </li> <li>O tambi\u00e9n puedes agregar un valor est\u00e1tico <code>0x28_v10</code>. Esto agrega un 10 a tu total, as\u00ed como el valor de <code>0x28</code> + 10 puede ser mostrado. Tambi\u00e9n se puede hacer lo mismo pero restando <code>0x28_v-10.</code> </li> <li>Si lo que quieres es restar una direcci\u00f3n necesitas multiplicar el valor por -1. <code>0x29*-1</code>. <code>0x29</code> es ahora negativo.  </li> <li>Si lo que quieres es hacer una divisi\u00f3n lo que necesitas es multiplicar por un numero quebrado. <code>0x26*.5</code>. <code>0x26</code> va a mostrar el valor 1/2 de <code>0x26</code>.  </li> <li>Y as\u00ed puedes crear un string con todo junto: <code>0x28*10_0x29*-1_0x26*.625_v-10</code>.</li> <li>Tambi\u00e9n puedes agregar direcciones entre si para agregar a tus lookups de acuerdo a la suma de varias direcciones. Esto es utilizado en el ejemplo de @Star. Esta buscando la suma de los 6 bits mas bajos de la direcci\u00f3n 0xh79f. La manera en la que esta direcci\u00f3n trabaja es que mientras se encuentre un valor hay significa que Mario es invisible porque agarro una estrella y cuenta el valor hex en 0x23 (35 en decimal) a 0. 23 en binario es 0010 0011 significando que la suma m\u00e1xima de estos bits seria 5 durante 0001 1111 cuando el contador llega al valor hex de 0x1f (31 en decimal).</li> </ul>"},{"location":"Rich-Presence-es/#simbolos-estandar-unicode","title":"S\u00edmbolos Est\u00e1ndar Unicode","text":"<p>Sin ninguna duda puedes utilizar estos s\u00edmbolos en rich presence.</p> <p>\u258c\u258c=Pausa \ud83d\udd01=Continues \u23f0=Tiempo de la Partida/Reloj del Juego \ud83d\udd11=Llaves \ud83d\udca3=Bombas \u2764\ufe0f o \u2764=En un juego con corazones (ej. Zelda)  \ud83d\udcb0=Dinero \ud83d\udea9=Nivel/Stage   </p> <p>Cuando te encuentres desarrollando Rich Presence tienes que hacegurarte que te estas comunicando de una manera completamente clara. Si no estas utilizando s\u00edmbolos estandarizados tal vez tengan sentido para ti pero tal vez sea completamente confusos para otros. Cuando utilices s\u00edmbolos no estandarizados, checalo con otro usuario o con alguna otra gente para ver si los s\u00edmbolos que estas utilizando tienen sentido. Si no lo tienen, utiliza mejores s\u00edmbolos, o  utiliza texto o s\u00edmbolos junto con texto.</p> <p>Para unicode/emojis personalizados ShapeCatcher es un excelente recurso, puedes ponerte a dibujarlos y la AI va a buscar resultados similares. Simplemente ten cuidado de no utilizar unicode que sea demasiado oscuro, ya que no se va a mostrar correctamente en todos los sistemas.</p> <p>Toma nota en la preferencia de la comunidad en cuanto a displays: </p>"},{"location":"Rich-Presence-es/#desarrollando-rich-presence","title":"Desarrollando Rich Presence","text":"<p>La herramienta de desarrollo actualmente no cuenta con editor de Rich Presence integrado, pero puedes hacer pruebas locales antes de guardar algo en el servidor. Una vez que hubieras empezado un juego y el Rich Presence actual a sido descargado del servidor, puedes llegar a encontrar en <code>RACache\\Data\\XXX-Rich.txt</code> donde XXX es el ID del juego. </p> <p>El Monitor de Rich Presence (ejecutable desde el menu de RetroAchievments) lee este archivo y muestra el valor actual cada segundo mientras la ventana se encuentre abierta.</p> <p>Si haces cambios al archivo <code>XXX-Rich.txt</code>, y vuelves a reseleccionar la opci\u00f3n de monitor del menu, este va a leer los nuevos cambios para aqu\u00ed as\u00ed puedas hacer pruebas inmediatamente sin tener que aplicar cambios al servidor. Continua haciendo cambios y vuelve a seleccionar la opci\u00f3n en el menu asta que el script trabaje como esperas que lo haga, una vez que hubieras terminado copia el contenido del archivo a la pagina del servidor para que est\u00e9n los cambios disponibles para todos los dem\u00e1s jugadores.</p> <p>NOTA: El archivo <code>XXX-Rich.txt</code> es sobre-escrito con la informaci\u00f3n actual del servidor cada vez que el juego es abierto. Mientras aun tengas el archivo abierto en un editor, siempre vas a poder guardar tus cambios a pesar de re-abrir el juego.</p>"},{"location":"Rich-Presence-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-24 20:02] meleu:</code> fix broken link</li> <li><code>[2019-05-19 15:48] eldexterr:</code> Updated Rich Presence es (markdown)</li> <li><code>[2019-05-19 15:42] eldexterr:</code> Updated Rich Presence es (markdown)</li> <li><code>[2019-05-17 11:03] eldexterr:</code> Created Rich Presence es (markdown)</li> </ul>"},{"location":"Rich-Presence-pt_BR/","title":"Estado de Presen\u00e7a","text":"<p>link para texto em ingl\u00eas: Rich Presence</p>"},{"location":"Rich-Presence-pt_BR/#introducao","title":"Introdu\u00e7\u00e3o","text":"<p>O Estado de Presen\u00e7a (RP - Rich Presence, pela sigla em ingl\u00eas), \u00e9 uma breve vis\u00e3o geral do que os jogadores est\u00e3o fazendo atualmente em seu jogo. Para ter RP em um jogo, voc\u00ea precisa de um Script do Estado de Presen\u00e7a (ou Rich Presence Script - RPS - pela sigla em ingl\u00eas). O Script verifica a mem\u00f3ria do jogo do jogador e como programado relata os valores de certos endere\u00e7os com defini\u00e7\u00f5es atribu\u00eddas pelo Desenvolvedor, como em qual est\u00e1gio o jogador est\u00e1, quantas vidas eles t\u00eam, se o jogo est\u00e1 em pausa, que modo de jogo eles est\u00e3o jogando, o que o jogador realizou, etc. Esta informa\u00e7\u00e3o \u00e9 reportada de volta ao site.</p> <p>Exemplo de RP em a\u00e7\u00e3o:</p> <p></p> <p>Para ver o RP ao vivo em um jogo, clique no menu RetroAchievements no seu emulador e clique em Rich Presence Monitor. Uma pequena janela mostrar\u00e1 seu RP ativo. (Bom para depura\u00e7\u00e3o)</p> <p></p> <p>A melhor maneira de entender o Estado de Presen\u00e7a \u00e9 olhar para v\u00e1rios exemplos no jogo, olhar para os endere\u00e7os usados e ver como o texto \u00e9 exibido no Rich Presence Monitor e no site.</p>"},{"location":"Rich-Presence-pt_BR/#como-funciona","title":"Como funciona?","text":"<p>Toda vez que um jogo \u00e9 iniciado, ele busca os achievements em um arquivo 'patch' para a ROM, que detalha todos os achievements e endere\u00e7os de mem\u00f3ria (e leaderboards) que podem ser observados. Ele tamb\u00e9m solicitar\u00e1 um Rich Presence Script para a ROM atualmente carregada. O emulador informar\u00e1 o site a cada 120 segundos. Da mesma forma, a cada 120 segundos mais ou menos, a caixa de 'jogadores ativos' na frontpage ser\u00e1 atualizada, detalhando a \u00faltima atividade conhecida de todos os jogadores ativos. Se n\u00e3o houver um script do estado de presen\u00e7a, o texto estar\u00e1 \"ganhando achievements\" se estiver jogando um jogo com achievements, \"jogando [jogo]\" se estiver jogando sem achievements ou \"desenvolvendo achievements\" se a caixa de di\u00e1logo de mem\u00f3ria estiver aberta e vis\u00edvel.</p> <p>O RPS para cada jogo pode ser encontrado na se\u00e7\u00e3o de desenvolvimento na p\u00e1gina de cada jogo:</p> <p></p> <p></p>"},{"location":"Rich-Presence-pt_BR/#exemplo-super-mario-bros","title":"Exemplo (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>Ele se divide em uma s\u00e9rie de objetos de pesquisa, objetos de formato e um objeto de exibi\u00e7\u00e3o.</p>"},{"location":"Rich-Presence-pt_BR/#pesquisas","title":"Pesquisas","text":"<p>Pesquisas s\u00e3o definidas assim:</p> <pre><code>Lookup:NameOfLookup\nValue1=Text When This Value\nValue2=Text When Another Value\n...\n</code></pre> <p>N\u00f3s damos ao Lookup (pesquisa) um valor, consistindo de uma s\u00e9rie de endere\u00e7os de mem\u00f3ria e modificadores. Falaremos mais sobre isso depois.</p>"},{"location":"Rich-Presence-pt_BR/#formato","title":"Formato","text":"<p>Tabelas de formato s\u00e3o definidas assim:</p> <pre><code>Format:Score\nFormatType=VALUE\n</code></pre> <p>Comece com <code>Format</code>: e depois o nome do tipo de formato. Na pr\u00f3xima linha, forne\u00e7a <code>FormatType =</code> e, em seguida, um dos seguintes: <code>VALUE</code>, <code>SCORE</code> (ou <code>POINTS</code>), <code>TIME</code> (ou <code>FRAMES</code>), <code>SECS</code>, <code>MILLISECS</code> ou <code>OTHER</code>.</p> <ul> <li><code>VALUE</code>: valor gen\u00e9rico, sem zeros \u00e0 esquerda.</li> <li><code>SCORE</code> / <code>POINTS</code>: \"000130 pontos\"</li> <li><code>TIME / FRAMES</code>: o valor descreve o n\u00famero de quadros transcorridos e ser\u00e1 transformado em 00: 00.00</li> <li><code>SECS</code>: valor descreve o n\u00famero de segundos decorridos e ser\u00e1 transformado em 00:00</li> <li><code>MILLISECS</code>: value descreve o n\u00famero de milissegundos decorridos e ser\u00e1 transformado em 00: 00.00</li> </ul>"},{"location":"Rich-Presence-pt_BR/#exibicao","title":"Exibi\u00e7\u00e3o","text":"<p>A exibi\u00e7\u00e3o ser\u00e1 uma string exibida na caixa \"Players ativos\" na primeira p\u00e1gina. Refere-se aos objetos Lookup e Format definidos anteriormente usando um \u00fanico '@'. Em seguida, ele especifica um nome para a pesquisa ou formato (diferencia mai\u00fasculas de min\u00fasculas) e, imediatamente depois, entre colchetes, uma s\u00e9rie de valores de mem\u00f3ria que especificam o que enviar para esse objeto de pesquisa ou formato.</p> <p><code>@Powerup (0xh756)</code></p> <p>Isso significa usar o Lookup ou o Formato chamado <code>Powerup</code>, e dar a ele qualquer valor que esteja em 0xh756.</p>"},{"location":"Rich-Presence-pt_BR/#exemplo-de-analise-de-pesquisa","title":"Exemplo de an\u00e1lise de pesquisa","text":"<ul> <li><code>@Mode (0xh770)</code> - pesquisa o endere\u00e7o que mostra se o jogo est\u00e1 no modo de demonstra\u00e7\u00e3o ou se um mundo foi conclu\u00eddo.</li> <li><code>@Paused (0xh776)</code> - pesquisa o endere\u00e7o que mostra se o jogo est\u00e1 em pausa (s\u00e3o utilizados 3 valores, dois deles s\u00e3o para pausa e pausa).</li> <li><code>@Star (0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Procura o endere\u00e7o de se Mario tem a estrela de invencibilidade. Mais sobre isso depois.</li> <li><code>@Powerup (0xh756)</code> - Procura pelo endere\u00e7o que mostra se o Mairo \u00e9 Pequeno, grande ou tem poder de fogo.</li> <li><code>Mario in</code> - Texto est\u00e1tico para pesquisar string e formatar objetos juntos.</li> <li><code>@Digit (0xh75f_v1)</code> - D\u00edgito \u00e9 um objeto de formato definido como um valor. O endere\u00e7o 0xh75f \u00e9 o mundo menos 1 (porque \u00e9 baseado em 0, j\u00e1 que come\u00e7a a contar em 0). _v1 significa + valor 1. _v + 1 tamb\u00e9m est\u00e1 correto.</li> <li><code>-</code> - Mais texto est\u00e1tico para dividir o mundo e o n\u00edvel. como no hypen no mundo 1-1.</li> <li><code>@Digit (0xh75c_v1)</code> - Outro uso do objeto de formato de d\u00edgito. Desta vez est\u00e1 olhando para o est\u00e1gio. Mundo 1-X.</li> <li><code>@Swimming (0xh704)</code> - pesquisa o endere\u00e7o que mostra se o jogador est\u00e1 nadando.</li> <li><code>@Status (0xhe)</code> - pesquisa o endere\u00e7o que mostra o status de Mario, como passar por canos.</li> <li><code>, \ud83d\udeb6:</code> - Mais texto est\u00e1tico. \ud83d\udeb6 \u00e9 um s\u00edmbolo para vidas.</li> <li><code>@Digit (0xh75a_v1)</code> - Terceiro uso do objeto de formato de d\u00edgito. Desta vez, est\u00e1 verificando o endere\u00e7o do jogador.</li> <li><code>,</code>- texto est\u00e1tico.</li> <li><code>@Quest (0xh7fc)</code> Uma pesquisa para ver se o jogador est\u00e1 em normal ou na segunda miss\u00e3o, hardmode.</li> <li><code>Quest</code> - Texto Est\u00e1tico.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#tamanho-do-endereco","title":"Tamanho do endere\u00e7o","text":"<p>Para especificar o tamanho do endere\u00e7o que voc\u00ea est\u00e1 verificando, existem v\u00e1rios caracteres usados. (capitaliza\u00e7\u00e3o \u00e9 ignorada)</p> <ul> <li>Um endere\u00e7o de 16 bits \u00e9 padr\u00e3o e n\u00e3o possui designa\u00e7\u00e3o de caractere. Em 0x10, o endere\u00e7o \u00e9 dois bytes - 16 bits.</li> <li>Um caractere de endere\u00e7o de 8 bits \u00e9 <code>h</code> (ou <code>H</code>). Em 0xh10, o endere\u00e7o \u00e9 um byte - 8 bits. <code>xxxx xxxx</code></li> <li>Um caractere de endere\u00e7o do upper4 \u00e9 <code>u</code> (ou U). Em 0xu10, o endere\u00e7o \u00e9 um nibble - 4 bits. <code>xxxx 0000</code></li> <li>Um caractere de endere\u00e7o do lower4 \u00e9 <code>l</code> (ou L). Em 0xl10 o endere\u00e7o \u00e9 um nibble - 4 bits. <code>0000 xxxx</code></li> <li>Um caractere de endere\u00e7o bit0 \u00e9 <code>m</code> (ou <code>M</code>). Em 0xm10 o endere\u00e7o \u00e9 um bit, o bit mais baixo: <code>0000 000x</code></li> <li>Um caractere de endere\u00e7o bit1 \u00e9 <code>n</code> (ou <code>N</code>). Em 0xn10 o endere\u00e7o \u00e9 um bit, o segundo bit: <code>0000 00x0</code></li> <li>O caractere de um endere\u00e7o de bit2 \u00e9 <code>o</code> (ou <code>O</code>). Em 0xn10 o endere\u00e7o \u00e9 um bit, o terceiro bit: <code>0000 0x00</code></li> <li>Um caractere de endere\u00e7o de bit3 \u00e9 <code>p</code> (ou <code>P</code>). Em 0xp10 o endere\u00e7o \u00e9 um bit, o quarto bit: <code>0000 x000</code></li> <li>Um caractere de endere\u00e7o bit4 \u00e9 <code>q</code> (ou <code>Q</code>). Em 0xq10 o endere\u00e7o \u00e9 um bit, o quinto bit: <code>000x 0000</code></li> <li>Um caractere de endere\u00e7o bit5 \u00e9 <code>r</code> (ou <code>R</code>). Em 0xr10 o endere\u00e7o \u00e9 um bit, o sexto bit: <code>00x0 0000</code></li> <li>Um caractere de endere\u00e7o bit6 \u00e9 <code>s</code> (ou <code>S</code>). Em 0xs10 o endere\u00e7o \u00e9 um bit, o s\u00e9timo bit: <code>0x00 0000</code></li> <li>Um caractere de endere\u00e7o bit7 \u00e9 <code>t</code> (ou <code>T</code>). Em 0xt10 o endere\u00e7o \u00e9 um bit, o bit superior: <code>x000 0000</code></li> <li>Um caractere de endere\u00e7o de 32 bits \u00e9 <code>x</code> (ou <code>X</code>). Em 0xx10 o endere\u00e7o \u00e9 de quatro bytes e 32 bits.</li> </ul> <p>Resumindo em uma tabela:</p> <p></p>"},{"location":"Rich-Presence-pt_BR/#strings-de-exibicao-condicional","title":"Strings de exibi\u00e7\u00e3o condicional","text":"<pre><code>Display:\n?0x 000085=0?Title Screen\n?0xT00007c=1?Custom Map in @Landscape(0xH00016c)\nPlaying Battle @Battle(0x 00007c*0.2) in @Landscape(0xH00016c)\n</code></pre> <p>O <code>Display</code>: marker existente ainda \u00e9 usado para indicar o in\u00edcio do bloco de exibi\u00e7\u00e3o. Se a pr\u00f3xima linha come\u00e7ar com um ponto de interroga\u00e7\u00e3o, ela ser\u00e1 considerada uma sequ\u00eancia de exibi\u00e7\u00e3o condicional. A parte da linha entre os dois pontos de interroga\u00e7\u00e3o \u00e9 a cl\u00e1usula condicional. Se a cl\u00e1usula condicional avaliar que \u00e9 verdadeiro (true), a parte restante da linha ser\u00e1 usada como a sequ\u00eancia de exibi\u00e7\u00e3o. Se n\u00e3o avaliar true, o processamento prosseguir\u00e1 para a pr\u00f3xima linha. Se come\u00e7ar com um ponto de interroga\u00e7\u00e3o, o mesmo processo ser\u00e1 repetido. Se n\u00e3o come\u00e7ar com um ponto de interroga\u00e7\u00e3o, a linha inteira ser\u00e1 usada como a sequ\u00eancia de exibi\u00e7\u00e3o padr\u00e3o.</p> <p>Olhando para este exemplo, se o valor de 16 bits em $ 0085 for 0, a seq\u00fc\u00eancia de exibi\u00e7\u00e3o \u00e9 <code>Title Screen</code>. Se n\u00e3o, a pr\u00f3xima linha \u00e9 examinada. Se o s\u00e9timo bit de $ 007C for 1, a cadeia de exibi\u00e7\u00e3o ser\u00e1 Custom <code>Map em @Landscape (0xH00016c)</code>. Se n\u00e3o, a linha final n\u00e3o tem uma cl\u00e1usula condicional e \u00e9 usada.</p> <p>As cadeias de exibi\u00e7\u00e3o associadas a uma cl\u00e1usula condicional suportam a mesma sintaxe que a cadeia de exibi\u00e7\u00e3o padr\u00e3o. Neste exemplo, voc\u00ea pode ver que a pesquisa <code>@Landscape</code> \u00e9 usada na seq\u00fc\u00eancia de exibi\u00e7\u00e3o condicional e na sequ\u00eancia de exibi\u00e7\u00e3o padr\u00e3o. A pesquisa em si s\u00f3 precisa ser definida uma vez.</p> <p>A frase condicional suporta todos os assessores de endere\u00e7o mencionados anteriormente, bem como a l\u00f3gica AND (_) e OR (S). Note que cl\u00e1usulas OR ainda requerem um grupo 'core', da mesma forma que as conquistas.</p> <ul> <li><code>? 0xH1234 = 32_0xH2345 = 0? and example</code></li> </ul> <p>se o valor de 8 bits em $ 1234 for 32 e o valor de 8 bits em $ 2345 for 0, display <code>and example</code></p> <ul> <li><code>? 0xH1234 = 32_0xH2345 = 1S0xH2345 = 2? or example</code></li> </ul> <p>se o valor de 8 bits em $ 1234 for 32 e o valor de 8 bits em $ 2345 for 1 ou 2, exibir <code>or example</code></p>"},{"location":"Rich-Presence-pt_BR/#decimal-binario-codificado-dbc","title":"Decimal Bin\u00e1rio Codificado (DBC)","text":"<p>DBC \u00e9 quando os valores s\u00e3o armazenados em um endere\u00e7o de 0 a 9 (um d\u00edgito) ou 0 a 99 (dois d\u00edgitos). Na maioria das vezes os valores s\u00e3o armazenados em hexadecimal, mas em algum momento os jogos ir\u00e3o armazen\u00e1-los desta maneira e aqui est\u00e1 a melhor maneira de lidar com esses endere\u00e7os no seu monitor.</p> <p>Para objetos de valor, voc\u00ea pode usar o prefixo DBC, como em <code>b0x1</code>. Um endere\u00e7o DBC \u00e9 considerado 8bit, h \u00e9 desnecess\u00e1rio, mas tamb\u00e9m n\u00e3o causar\u00e1 problemas. Outros prefixos de caracteres funcionam? (n\u00e3o testado). Quando voc\u00ea usa o prefixo b e o endere\u00e7o \u00e9 armazenado como um DBC, sua sa\u00edda para um endere\u00e7o de 10 ser\u00e1 10 em vez de 16 (que \u00e9 10 em hexadecimal).</p> <p>Isso \u00e9 mais comumente usado para pontua\u00e7\u00e3o e tempo, mas geralmente outros tipos de valores de exibi\u00e7\u00e3o.</p>"},{"location":"Rich-Presence-pt_BR/#limites","title":"Limites","text":"<ul> <li>Limite de 2500 caracteres para script</li> <li>Limite de 100 caracteres para o que \u00e9 exibido</li> <li>Caracteres Unicode s\u00e3o permitidos</li> <li>Usar <code>&amp;</code> no texto cortar\u00e1 o script ap\u00f3s o <code>&amp;</code></li> <li>Usando o personagem <code>+</code> n\u00e3o ser\u00e1 exibido</li> </ul>"},{"location":"Rich-Presence-pt_BR/#detalhes-da-sintaxe","title":"Detalhes da Sintaxe","text":"<ul> <li>O RPS ignora 0s finais em pesquisas de endere\u00e7o hexadecimais e os valores <code>0x00001</code> == <code>0x1</code>, <code>0xh0000245</code> == <code>0xh245, 0x0a</code> == <code>0xa</code>.</li> <li>Os valores de pesquisa s\u00e3o Decimal por padr\u00e3o e hex se voc\u00ea colocar o prefixo de <code>0x</code>. Isso significa <code>1</code> == <code>0x1</code>, <code>2</code> == <code>0x2</code>, <code>9</code> == <code>0x9</code>, <code>10</code> == <code>0xa</code>, <code>100</code> == <code>0x64</code>, etc.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#dicas-e-truques","title":"Dicas e truques","text":"<ul> <li>As pesquisas devem ser espec\u00edficas de caso com seus @ correspondentes na exibi\u00e7\u00e3o e n\u00e3o conter espa\u00e7os ap\u00f3s a pesquisa ser definida.</li> <li>Os nomes de pesquisa podem ser t\u00e3o curtos quanto um \u00fanico caractere se voc\u00ea precisar incluir alguns caracteres extras.</li> <li>Transformar todos os seus valores de hexadecimal em decimal ocupar\u00e1 menos caracteres.</li> <li>Caracteres Unicode nem sempre \"ocupam menos espa\u00e7o\", eles geralmente ocupam at\u00e9 quatro caracteres do sistema.</li> <li>Se voc\u00ea n\u00e3o definir suas pesquisas, elas ser\u00e3o deixadas em branco (sem espa\u00e7o). Apenas para NES, SNES, Gen, RAVBA. N64, Meka e Lynx deixar\u00e3o a palavra \"Desconhecido\" toda vez que voc\u00ea n\u00e3o definir uma pesquisa.</li> <li>Voc\u00ea s\u00f3 precisa de um objeto de formato de valor. Voc\u00ea pode referenci\u00e1-lo com v\u00e1rios endere\u00e7os. (isso \u00e9 sempre verdade?)</li> <li>Colocar espa\u00e7os em suas pesquisas algumas vezes antes ou depois pode permitir que voc\u00ea oculte determinadas pesquisas quando elas n\u00e3o forem necess\u00e1rias, como fazer <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code> e <code>@Mode</code>.</li> </ul>"},{"location":"Rich-Presence-pt_BR/#propriedades-de-valor","title":"Propriedades de valor","text":"<p>Ao usar objetos de pesquisa e formata\u00e7\u00e3o <code>@object ()</code>, \u00e9 poss\u00edvel combinar e executar c\u00e1lculos. Isso pode ser usado para exibir corretamente uma pontua\u00e7\u00e3o, em tempo de jogo, etc. ou fazer pesquisas mais avan\u00e7adas.</p> <p>Exemplo `@Score (0x28 * 10_0x29 * 1000_0x26 * 100000) points``</p> <p>Isso significa usar a pesquisa ou pontua\u00e7\u00e3o de formato e dar a soma de:</p> <ul> <li>0x28 vezes 10, ADD</li> </ul> <ul> <li>0x29 vezes 1000, ADD</li> </ul> <ul> <li>0x26 vezes 100000</li> </ul> <ul> <li><code>_</code> adiciona os endere\u00e7os juntos.</li> </ul> <ul> <li>Ou voc\u00ea pode adicionar um valor est\u00e1tico <code>0x28_v10</code>. Isso adiciona 10 ao seu total, como em qualquer que seja o valor de <code>0x28</code> + 10 ser\u00e1 exibido. Voc\u00ea tamb\u00e9m pode subtrair <code>0x28_v-10</code>.</li> </ul> <ul> <li>Se voc\u00ea quiser subtrair um endere\u00e7o, multiplique o endere\u00e7o por -1. <code>0x29 * -1</code>. <code>0x29</code> agora \u00e9 negativo.</li> </ul> <ul> <li>Se voc\u00ea gostaria de realizar a divis\u00e3o, voc\u00ea precisar\u00e1 multiplicar por um decimal. <code>0x26 * .5</code>. <code>0x26</code> ir\u00e1 gerar 1/2 do valor em <code>0x26</code>.</li> </ul> <ul> <li>E voc\u00ea pode amarrar tudo junto: <code>0x28 * 10_0x29 * -1_0x26 * .625_v-10</code>.</li> </ul> <ul> <li>Voc\u00ea tamb\u00e9m pode adicionar endere\u00e7os juntos para fornecer pesquisas com base nas somas de v\u00e1rios endere\u00e7os. Isso \u00e9 usado no exemplo em @Star. Est\u00e1 procurando a soma dos 6 bits mais baixos do endere\u00e7o 0xh79f. A maneira como esse endere\u00e7o funciona \u00e9 que, desde que haja um valor l\u00e1, Mario \u00e9 star Mario invenc\u00edvel e a contagem regressiva do valor hexadecimal 0x23 (35 decimal) para 0. 23 em bin\u00e1rio \u00e9 0010 0011, significando que a soma m\u00e1xima desses bits pode ser 5 durante 0001 1111 quando a contagem regressiva alcan\u00e7a o valor hexadecimal 0x1f (31 decimal).</li> </ul>"},{"location":"Rich-Presence-pt_BR/#simbolos-padrao-unicode","title":"S\u00edmbolos Padr\u00e3o Unicode","text":"<p>\u258c\u258c=em pausa</p> <p>\ud83d\udd01= n\u00famero de loop</p> <p>\ud83d\udeb6=vidas. Outros s\u00edmbolos que representam o jogo claramente tamb\u00e9m s\u00e3o adequados. \ud83d\udc30=in a Bugs bunny Game, \ud83d\udc35=in a Donkey Kong Country game, \u2708=In a jet plane game,</p> <p>\ud83d\udc9e=Continue</p> <p>\ud83d\udcaf=Pontos</p> <p>\u23f0=Tempo de jogo/Rel\u00f3gio do game</p> <p>\ud83d\udd11=Chaves</p> <p>\ud83d\udca3=Bombas \u2630=Menu</p> <p>\u2764\ufe0f ou \u2764= Em um jogo com cora\u00e7\u00f5es (ex. Zelda)</p> <p>\ud83d\udcb0=Dinheiro</p> <p>\u2696=Dificuldade</p>"},{"location":"Rich-Presence-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2020-09-16 12:25] meleu:</code> smallfix</li> <li><code>[2020-09-16 12:24] meleu:</code> use RP acronym</li> <li><code>[2020-09-16 12:20] meleu:</code> use relative links</li> <li><code>[2020-09-15 17:49] Ben-Ghazi:</code> Changed the links to go to the docs equivalent instead of the wiki.</li> <li><code>[2018-03-28 03:11] KingDice001:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-28 03:06] KingDice001:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:25] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:24] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 23:06] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> <li><code>[2018-03-27 21:17] 7Mogami7:</code> Updated Rich Presence pt_BR (markdown)</li> </ul>"},{"location":"Rich-Presence/","title":"Rich Presence","text":"<ul> <li>Introduction</li> <li>How Does it work?</li> <li>Example</li> <li>Macros</li> <li>Lookups</li> <li>Format</li> <li>Built-in macros</li> <li>Display</li> <li>Example Lookup Breakdown</li> <li>Conditional Display Strings</li> <li>Limits</li> <li>Rich Presence Restrictions</li> <li>Tips and Tricks</li> <li>Value Properties</li> <li>Unicode Standard Symbols</li> <li>Developing Rich Presence</li> <li>Parse Errors</li> </ul>"},{"location":"Rich-Presence/#introduction","title":"Introduction","text":"<p>Rich Presence (RP) is brief overview of what active players are currently doing in their game. To have RP in a game you need a Rich Presence script, which is created by Developers. The script checks the player's game memory and reports the values of certain addresses with definitions assigned by the Developer such as which stage the player is on, how many lives they have, if the game is paused, what game mode they are playing, what the player has accomplished, etc. This information is reported back to the website once every two minutes.</p> <p>A good rich presence should inform other users how far into the game you are (level/ town/dungeon), and give an overall sense of how the player is doing (score/remaining lives/character level). Additional details may be useful, depending on their context within the game. Try not to go overboard with the detail though. Other players don't care what you named your dog, or need to know how many bullets you have left, especially since it only updates every two minutes. Additionally, the more fluff you add to a rich presence display, the more diluted the important information becomes.</p> <p>Example of RP in action:</p> <p> </p> <p>To see the RP live in a game click on the RetroAchievements menu in your emulator and then click on Rich Presence Monitor. A small window will show you your active RP. (Good for debugging)</p> <p></p> <p>The best way to understand Rich Presence is to look at various examples in game, look at the addresses used and look at how the text is displayed in the Rich Presence Monitor and on site.</p>"},{"location":"Rich-Presence/#how-does-it-work","title":"How Does it work?","text":"<p>The game's Rich Presence script is downloaded with the achievement and leaderboard data for a game. As soon as the emulator validates this data, it starts a session for the user. This sets the user's 'Last Seen In' to 'Playing [game]'. 30 seconds later, the Rich Presence script will be evaluated and the result sent to the server. This will update the 'Last Seen In' for the player, which is also used in the 'Active Players' list on the front page. Every two minutes after that, the Rich Presence script will be evaluated again, and the 'Last Seen In' will be updated again. This continues until the user closes the emulator.</p> <p>If there isn't a Rich Presence script for the game, the user has disabled rich presence, or the user has modified the Rich Presence script, the text will remain 'Playing [game]'.</p> <p>The user's 'Last Seen In' may also say 'Fixing Achievements' or 'Developing Achievements' if they have any of the tool windows open. The first will display if achievements have been published for the set. The second if achievements have not been published for the set.</p> <p>The Rich Presence script for a game can be found under the development section on each game's page: </p> <p></p> <p></p>"},{"location":"Rich-Presence/#example-super-mario-bros","title":"Example (Super Mario Bros.)","text":"<pre><code>Format:Digit\nFormatType=VALUE\n\nLookup:Mode\n0=[Demo] \n2=[World Complete] \n\nLookup:Paused\n0x81=\u258c\u258c \n0x80=\u258c\u258c \n1=\u258c\u258c \n\nLookup:Star\n5=\ud83c\udf1f \n4=\ud83c\udf1f \n3=\ud83c\udf1f \n2=\ud83c\udf1f \n1=\ud83c\udf1f \n\nLookup:Powerup\n0=Small\n1=Super\n2=Fire\n\nLookup:Swimming\n1= swimming\n\nLookup:Status\n0= [Loading]\n1= taking a vine warp\n2= entering a warp pipe\n3= entering a warp pipe\n4= \ud83d\udea9\n5= [Stage Complete]\n6= [Game Over]\n7= [Entering Area]\n9= growing\n0xA= shrinking\n0xB= \ud83d\udc80\n0xC= powering up\n\nLookup:Quest\n0x0=1st\n0x1=2nd\n\nDisplay:\n@Mode(0xh770)@Paused(0xh776)@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)@Powerup(0xh0756) Mario in @Digit(0xh75f_v1)-@Digit(0xh75c_v1)@Swimming(0xh704)@Status(0xhe), \ud83d\udeb6:@Digit(0xh75a_v1), @Quest(0xh7fc) Quest\n</code></pre> <p>It breaks down into a series of Lookup objects, Format objects and one Display object. </p>"},{"location":"Rich-Presence/#macros","title":"Macros","text":"<p>A macro converts a value into a user-friendly string. Macros are placed within a display string and will be replaced when the display string is evaluated. A macro starts with an <code>@</code>, then the name of the macro, an opening parenthesis, the value to evaluate, and a closing parenthesis.</p> <p><code>@Macro(0xh1234)</code> says read the byte at $1234, transform it using the <code>Macro</code> macro, and place the result in the display string where the macro had been.</p> <p>Parameters for each macro are constructed using a value definition.</p>"},{"location":"Rich-Presence/#lookups","title":"Lookups","text":"<p>Lookups are defined like this: </p> <pre><code>Lookup:NameOfLookup\n1=Text When 1\n2=Text When 2\n...\n</code></pre> <p>When a display string references a Lookup, it's value will be located in the table and the associated text will be displayed.</p> <p>NOTE: Values in the Lookup should be in decimal. If you want to use hex values, include a <code>0x</code> prefix. (i.e. <code>0x12=Eighteen</code>)</p> <p>You can also specify multiple values for a single text string:</p> <pre><code>1-5,10=Text When These Values\n*=Text For All Other Values\n</code></pre> <p>In this example, the values 1, 2, 3, 4, 5, and 10 all map to the first text string.</p> <p>Anything that doesn't match an item defined in the lookup table will return the text associated with <code>*</code>. If <code>*</code> does not appear in the lookup table, no text will be returned if a value doesn't have an entry.</p>"},{"location":"Rich-Presence/#format","title":"Format","text":"<p>Format tables are defined like this:</p> <pre><code>Format:Score\nFormatType=VALUE\n</code></pre> <p>Begin with <code>Format:</code>, then the name of the Format converter. On the next line, give <code>FormatType=</code>, then one of the following:</p> <ul> <li><code>VALUE</code>: generic value, no leading zeroes. </li> <li><code>SCORE</code>/<code>POINTS</code>: generic value, padded with leading 0s to 6 digits.</li> <li><code>TIME</code>/<code>FRAMES</code>: value describes the number of frames elapsed, and will be turned into 00:00.00 by multiplying by 100 (hundredths of a second) and dividing by 60 (frames per second). If your system runs at something other than 60 fps, you'll have to do the conversion yourself and use <code>MILLISECS</code>.</li> <li><code>MILLISECS</code>: value describes the number of hundredths of a second elapsed, and will be turned into 00:00.00 </li> <li><code>SECS</code>: value describes the number of seconds elapsed, and will be turned into 00:00 </li> <li><code>MINUTES</code>: value describes the number of minutes elapsed, and will be turned into 0h00</li> <li><code>SECS_AS_MINS</code>: value describes the number of seconds elapsed, and will be turned into 0h00</li> <li><code>FLOAT1</code>-<code>FLOAT6</code>: formats a floating point number with the specified number of digits after the decimal</li> </ul>"},{"location":"Rich-Presence/#built-in-macros","title":"Built-in macros","text":"<p>As of the 1.0 version of the DLL, you can use predefined macros for the most common formats. The following macros are now implicit:</p> Macro Format Description <code>@Number()</code> <code>VALUE</code> A generic value with no leading zeroes <code>@Score()</code> <code>SCORE</code> A generic value, padded with leading zeroes to six digits <code>@Centiseconds()</code> <code>MILLISECS</code> The number of hundreths of a second elapsed, and will be formatted as <code>00:00.00</code> <code>@Seconds()</code> <code>SECS</code> The number of seconds elapsed, and will be formatted as <code>00:00</code> <code>@Minutes()</code> <code>MINUTES</code> The number of minutes elapsed, and will be formatted as <code>0h00</code> <code>@Float1()</code> <code>FLOAT1</code> A floating point number, formatted with one digit after the decimal <code>@Float2()</code> <code>FLOAT2</code> A floating point number, formatted with two digits after the decimal <code>@Float3()</code> <code>FLOAT3</code> A floating point number, formatted with three digits after the decimal <code>@Float4()</code> <code>FLOAT4</code> A floating point number, formatted with four digits after the decimal <code>@Float5()</code> <code>FLOAT5</code> A floating point number, formatted with five digits after the decimal <code>@Float6()</code> <code>FLOAT6</code> A floating point number, formatted with six digits after the decimal <code>@ASCIIChar()</code> n/a Converts a value from 0x20-0x7F into a character using the ASCII character map. Other values will be converted to <code>?</code> <code>@UnicodeChar()</code> n/a Converts a value into a character using the 16-bit Unicode character map. Unknown values will be converted to <code>\ufffd</code>"},{"location":"Rich-Presence/#display","title":"Display","text":"<p>Display is a string that gets shown in the 'Active Players' box on the front page and the 'Last Seen In' section of the player's profile.</p> <p>It is built by replacing any macros in the display string with text from a Lookup or formatted values from a Format converter. Each macro is identified by a single '@', which is followed by the name for the Lookup or Format (case sensitive!), and immediately after, in parenthesis, a value specifying what to send to that Lookup or Format object.</p> <p><code>Using @Powerup(0xh756)!</code> </p> <p>This means use the Lookup or Format that's called <code>Powerup</code>, and give it whatever 8-bit value is in the address 0x756. After converting, put the result in between \"Using \" and \"!\".</p> <p>NOTE: Lookup/Format names are case sensitive and must exactly match the usage in the Display string: <code>@test(0x1234)</code> will not find <code>Format:Test</code></p> <p>NOTE: Lookup/Format definitions cannot contain spaces before or after the name. <code>@test(0x1234)</code> will not find <code>Format:test</code> or <code>Format:   test</code></p>"},{"location":"Rich-Presence/#example-lookup-breakdown","title":"Example Lookup Breakdown","text":"<ul> <li><code>@Mode(0xh770)</code> - Lookup for the address that shows if the game is in demo mode or a world has been completed.  </li> <li><code>@Paused(0xh776)</code> - Lookup for the address that shows if the game is paused (3 values are used, two of them are for pausing and unpausing).  </li> <li><code>@Star(0xM79f_0xN79f_0xo79f_0xP79f_0xQ79f_0xR79f)</code> - Lookup for the address of if Mario has Star invincibility. More on this later.  </li> <li><code>@Powerup(0xh756)</code> - Lookup for the address that show if Mario is Small, big or has fire power.  </li> <li><code>Mario in</code> - Static text to string lookup and format objects together.  </li> <li><code>@Digit(0xh75f_v1)</code> - <code>Digit</code> is a format object defined as a value. The address 0xh75f is the World minus 1 (because it is 0 based, as in it starts counting at 0). <code>_v1</code> Means + value 1. <code>_v+1</code> is also correct.  </li> <li><code>-</code> - More static text to split World and Level. as in the hyphen in World 1-1.  </li> <li><code>@Digit(0xh75c_v1)</code> - Another use of the <code>Digit</code> format object. This time It's looking up the stage. World 1-X.  </li> <li><code>@Swimming(0xh704)</code> - Lookup for the address that shows if the player is swimming.  </li> <li><code>@Status(0xhe)</code> - Lookup for the address that shows Mario's status, such as going through pipes.  </li> <li><code>, \ud83d\udeb6:</code> - More static text. \ud83d\udeb6 is a symbol for lives.  </li> <li><code>@Digit(0xh75a_v1)</code> - Third use of the <code>Digit</code> format object. This time it's checking the player lives address.  </li> <li><code>,</code> - Static text.  </li> <li><code>@Quest(0xh7fc)</code> A lookup to see if the player is in normal or on the 2nd quest, hardmode.  </li> <li><code>Quest</code> - Static Text.  </li> </ul>"},{"location":"Rich-Presence/#conditional-display-strings","title":"Conditional Display Strings","text":"<pre><code>Display:\n?0x 000085=0?Title Screen\n?0xT00007c=1?Custom Map in @Landscape(0xH00016c)\nPlaying Battle @Battle(0x 00007c*0.2) in @Landscape(0xH00016c)\n</code></pre> <p>The existing <code>Display:</code> marker is still used to indicate the start of the display block. If the next line starts with a question mark, it is considered to be a conditional display string. The portion of the line between the two question marks is the conditional clause. If the conditional clause evaluates true, then the remaining portion of the line is used as the display string. If it does not evaluate true, then processing proceeds to the next line. If it starts with a question mark, the same process repeats. If it does not start with a question mark, the entire line is used as the default display string.</p> <p>NOTE: A default display string is required in case none of the conditional display strings match. If you only have conditional display strings, the script will appear to do nothing.</p> <p>Looking at this example, if the 16-bit value at $0085 is 0, the display string is <code>Title Screen</code>. If not, the next line is examined. If the 7th bit of $007C is 1, the display string is <code>Custom Map in @Landscape(0xH00016c)</code>. If not, the final line does not have a conditional clause and is used.</p> <p>Display strings associated with a conditional clause support all of the same syntax as the default display string. In this example, you can see the <code>@Landscape</code> lookup is used in both the conditional display string and the default display string. The lookup itself only has to be defined once.</p> <p>The conditional phrase supports all of the previously mentioned address accessors as well as AND (_) and OR (S) logic. Note that OR clauses still require a 'core' group, just like achievements.</p> <ul> <li><code>?0xH1234=32_0xH2345=0?and example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $2345 is 0, display <code>and example</code></p> </li> </ul> <ul> <li><code>?0xH1234=32S0xH2345=1S0xH2345=2?or example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $2345 is 1 or 2, display <code>or example</code></p> </li> </ul> <ul> <li><code>?0xH1234=32_0xH5678=33S0xH2345=1S0xH2345=2?and/or example</code><p>if the 8-bit value at $1234 is 32 and the 8-bit value at $5678 is 33 and the 8-bit value at $2345 is 1 or 2, display <code>and/or example</code></p> </li> </ul> <p>Pro-tip: Conditions can be created using the achievement editor. Once you have your condition defined, use the <code>Copy Def</code> button to copy the achievement definition to the clipboard so you can paste it into the rich presence script.</p>"},{"location":"Rich-Presence/#limits","title":"Limits","text":"<ul> <li>65,535 character limit for script  </li> <li>255 character limit for what is displayed  </li> <li>Unicode characters are allowed, but use count as more than 1 character towards the specified limits.</li> </ul>"},{"location":"Rich-Presence/#rich-presence-custom-name-restriction","title":"Rich Presence Custom Name Restriction","text":"<p>Rich Presence that directly displays custom player input text is prohibited.  The most common example being displaying what a player inputs as their character or file name directly into Rich Presence.</p> <p>This restriction helps in preventing inappropriate or offensive content from showing on various site pages as well as makes the moderation of Rich Presence more manageable, in addition to protection player privacy as players may not realize their text is being displayed publicly.</p>"},{"location":"Rich-Presence/#tips-and-tricks","title":"Tips and Tricks","text":"<ul> <li>Comments can be added anywhere in the script. A double slash (<code>//</code>) indicates the remaining portion of the line should be ignored when processing the script. Note: comments still apply toward the script size limit.</li> <li>Lookup names can be as short as a single character if you need to squeeze in a few extra characters.</li> <li>Leading zeros can be removed from addresses (<code>0xh0001</code> can be shortened to <code>0xh1</code>).</li> <li>Turning all your values from hex into decimal will take up less characters.</li> <li>Unicode characters don't always \"take up less space\" they often take up to four system characters.</li> <li>Each <code>Lookup</code> or <code>Format</code> named mapping can be referenced multiple times with the same or different addresses. You can define a single <code>Format:Number FormatType=VALUE</code> instead of defining individual ones for Lives, Score, Level, etc.</li> <li>Putting spaces in your Lookups sometimes before or after can allow you to hide certain lookups when they are not needed, like how <code>@Pause</code>, <code>@Star</code>, <code>@Swimming</code>, and @Mode do. </li> </ul>"},{"location":"Rich-Presence/#value-properties","title":"Value Properties","text":"<p>When using lookup and format objects <code>@object()</code> it's possible to combine and perform calculations. Macro parameters are value definitions, so you can use multiplication, addition, and even some logic to generate values that aren't directly available in memory.</p> <p>Example <code>@Score(0xh28*10_0xh29*1000_0xh26*100000) points</code> </p> <p>This means use the Lookup or Format <code>Score</code>, and give it the sum of: - the 8-bit value at 0x28 times 10, ADD - the 8-bit value at 0x29 times 1000, ADD - the 8-bit value at 0x26 times 100000  </p>"},{"location":"Rich-Presence/#unicode-standard-symbols","title":"Unicode Standard Symbols","text":"<p>You can without doubt use these symbols in rich presence.</p> <p>\u258c\u258c=Paused \ud83d\udd01=Continues \u23f0=In Game Time/Game Clock \ud83d\udd11=Keys \ud83d\udca3=Bombs \u2764\ufe0f or \u2764=In a game with hearts (e.g. Zelda)  \ud83d\udcb0=Money \ud83d\udea9=Level/Stage   </p> <p>While making Rich Presence, devs need to be careful that they are communicating clearly. If you are using non-standard symbols they will make sense to you but could be entirely confusing to others. When using non-standard symbols, check them with someone else or a few people to see if the symbols you use make sense. If they don't, use better symbols, use text or use symbols alongside of text.</p> <p>For custom unicode/emoji ShapeCatcher is an excellent resource, you can draw what you're looking for and an AI will find similar matches. Just be careful to not use unicode that too obscure, as they don't all display on all systems.</p> <p>Take note of community display preference:</p> <p></p>"},{"location":"Rich-Presence/#developing-rich-presence","title":"Developing Rich Presence","text":"<p>The toolkit does not currently have an integrated Rich Presence editor, but you can test local changes before putting them on the server. Once you've started a game and the current Rich Presence has been downloaded from the server, you can find it in <code>RACache\\Data\\XXX-Rich.txt</code> where XXX is the game ID. </p> <p>The Rich Presence Monitor (openable from the RetroAchievments menu) reads this file and shows the current value every second while the window is open.</p> <p>If you make changes to the <code>XXX-Rich.txt</code> file, and reselect the menu option, it will read the new changes and allow you to immediate test them without applying the changes to the server. Continue to make changes and reselect the menu option until the script is behaving as you expect, then copy the contents to the server page to make it available to everyone else.</p> <p>NOTE: The <code>XXX-Rich.txt</code> file is overwritten with the current server data each time the game is opened. As long as you still have the file open in an editor, you can always save your changes over the updated file after reopening the game.</p> <p>Rich Presence files utilize Condition Syntax for Memory Sizes, Prefixes and Logical Flags. These are also represented if you copy and paste achievement logic from the Achievement Editor.</p>"},{"location":"Rich-Presence/#parse-errors","title":"Parse Errors","text":"Code Enum Description -2 <code>INVALID_MEMORY_OPERAND</code> A memory operand was expected and not found. Memory operands start with <code>0x</code>, then a size indicator. The most common causes of this are forgetting the <code>0x</code> or having an <code>_S</code> or <code>__</code> in the script. -3 <code>INVALID_CONST_OPERAND</code> A lookup key could not be evaluated. The most common cause of this is using hex without the <code>0x</code> prefix. This may also occur on older versions of RetroArch when using CSV or range keys for lookups. -6 <code>INVALID_OPERATOR</code> An unknown operator was encountered. The most common cause of this is using <code>!</code> instead of <code>!=</code> -16 <code>MISSING_VALUE</code> A macro was encountered without providing a value (i.e. <code>@Points</code> instead of <code>@Points(0xh1234)</code>) -18 <code>MISSING_DISPLAY_STRING</code> The rich presence script did not contain a <code>Display:</code> element, or contained only conditional display strings -20 <code>RC_INVALID_VALUE_FLAG</code> A non-combining flag is used in a non-trigger context. Combining flags are AddSource, SubSource, AddHits, AddAddress and AndNext. <p>Additionally, if you see <code>[Unknown macro]</code>, that means the macro name could not be resolved. For example <code>@Points(0xh1234)</code> without defining <code>Format:Points</code> would generate <code>[Unknown macro]Points(0xh1234)</code>.</p> <p>This issue happens sometimes when a Rich Presence is created in the <code>&lt;GameID&gt;-Rich.txt</code> file in the <code>RACache&gt;Data</code> folder. In this case the issue can be fixed by adding an empty line at the start of the file.</p>"},{"location":"Rich-Presence/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-26 08:48] The Mystical One:</code> Updated Rich Presence (markdown)</li> <li><code>[2024-01-26 08:46] The Mystical One:</code> Adds Player-Input Text Restriction section.</li> <li><code>[2024-01-13 09:50] OvenOverlord:</code> Updated Rich Presence (markdown)</li> <li><code>[2023-06-06 11:04] televandalist:</code> Added ToC</li> <li><code>[2022-04-30 16:18] Jamiras:</code> Updated Rich Presence (markdown)</li> <li><code>[2022-02-04 17:38] Jamiras:</code> extract memory sizes</li> <li><code>[2022-02-04 17:12] Jamiras:</code> extract Value Definition to separate page</li> <li><code>[2022-01-31 10:51] Jamiras:</code> add built-in macros</li> <li><code>[2022-01-26 09:39] Shane Shirey:</code> Updated Rich Presence (markdown)</li> <li><code>[2022-01-26 09:38] Shane Shirey:</code> Updated Rich Presence (markdown)</li> </ul>"},{"location":"Rollouts/","title":"Rollouts","text":""},{"location":"Rollouts/#intro","title":"Intro","text":"<p>Rollouts are events that are meant to mimic a console launch. Developers participating in rollouts devote their time to working on achievement sets with the intent of having several sets ready once the console is supported for all players. </p>"},{"location":"Rollouts/#general-guidelines","title":"General Guidelines","text":"<p>It's worth noting that these are general guidelines that apply to all rollouts. Individual rollouts may require addtional guidelines. </p> <ul> <li>Each rollout needs a coordinator/manager to handle a variety of tasks to ensure the rollout goes smoothly. <ul> <li>Task of Coordinator(s)/Manager(s)<ul> <li>Gauging interest from achievement developers.</li> <li>Keeping track of claims to ensure there's no overlap and to keep the claims manager(s) up-to-date. </li> <li>Having close communication with participants to answer questions and to resolve any conflicts that may arise. </li> <li>Reporting emulator/core bugs and other issues to tech-team.</li> <li>Provide necessary information to the RANews team, if applicable.</li> <li>Maintaining a schedule so developers know when they are to officially claim their picks in the forum, when playtesters can start testing sets, and when the console's support will officially launch.</li> <li>Ensuring the console ID is validated on the website when support launches, or at least be in contact with the web team to do so. </li> </ul> </li> </ul> </li> </ul> <ul> <li>Developers are limited to leading one set at a time, but may collaborate on as many sets as they wish. Upon completion of a set, they are to notify QA to look over their set and sign them off, which allows them to move on to their next pick, if applicable. </li> </ul> <ul> <li>As per the Developer Code of Conduct, Developers must be free of unaddressed tickets in order to have their claims locked in. They must also have an open claim slot. </li> </ul> <ul> <li>Since the overall goal of a rollout is to provide sets to launch with a console's support, developers who go inactive or otherwise end up not working on the chosen sets will have their claim lapsed. In other words, claiming a set just to sit on it will not fly and will result in a lapse. </li> </ul>"},{"location":"Rollouts/#rollout-process","title":"Rollout Process","text":"<ul> <li>When a previously unsupported console becomes viable to work on achievements, developers are to be asked individually if they would like to participate in a console's rollout. If they are interested, they are to pick one game as their priority pick, but may provide a list of additional games as backup. </li> <li>The overall list is then sorted to see if there are any overlapping picks. If a priority pick is exclusive to one developer, they can be locked in for that pick. If multiple developers share the same priority pick, they will be encouraged to collaborate. </li> </ul>"},{"location":"Rollouts/#previous-rollouts","title":"Previous Rollouts","text":"Launch Date Console Number of Sets on Launch Day Relevant Links 2019-09-07 PlayStation 28 Forum Topic 2021-10-01 PlayStation Portable 38 Forum Topic 2022-02-12 Dreamcast 34 Forum Topic 2022-03-28 Amstrad CPC 30 Forum Topic 2022-05-08 ArduboyWASM-4 3825 Forum Topic 2022-07-28 Fairchild Channel FMega Duck ???? Forum Topic 2022-10-01 PlayStation 2 92 Forum Topic 2023-04-16 Nintendo DSi 45 Forum Topic 2023-06-04 Atari Jaguar CD 12 Forum Topic 2023-07-01 Interton VC 4000 31 Forum Topic 2023-07-01 Elektor TV Games Computer 23 Forum Topic 2023-07-01 Arcadia 2001 22 Forum Topic Pending Uzebox ?? Pending Pending TI-83 ?? Pending Pending Neo Geo CD ?? Pending Pending Commodore 64 ?? Pending Pending ZX Spectrum ?? Pending"},{"location":"Set-Development-Roadmap-es/","title":"Mapa de Desarrollo de Set","text":"<p>Lo siguiente es un plano detallado de la mayor\u00eda de las cosas que necesitas considerar cuando te encuentres haciendo un set de logros. No es requisito seguir esto al pie de la letra, esto es mas como una gu\u00eda.</p>"},{"location":"Set-Development-Roadmap-es/#investigacion-inicial","title":"Investigaci\u00f3n Inicial","text":"<ul> <li>Manual del Juego: Estudiarlo</li> <li>Game Faqs: Leer/checarlo</li> <li>Game Cheats: Encontrar, anotar</li> <li>Longplay: Estudiarlo/observarlo</li> <li>Sets similares: Comparar, anotar tus ideas favoritas</li> <li>Partimes: checar si existen</li> <li>Speedruns: checar si existen</li> </ul>"},{"location":"Set-Development-Roadmap-es/#diseno-conceptual","title":"Dise\u00f1o Conceptual","text":"<ul> <li>Logros 1: Tormenta de Ideas, incluye ideas de sets similares, manual, etc.     - Anota secretos, progreso, elementos clave, coleccionables, puntuaciones     benchmarks, Easter eggs, jefes, key items, par times, recompensas internas.</li> <li>Investigaci\u00f3n 2: Checa/testea que los dise\u00f1os sean posibles.</li> <li>Memoria 1: Estima las direcciones necesarias para los logros.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#cazeria-de-memoria","title":"Cazeria de Memoria","text":"<ul> <li>Memoria 2: Busca valores necesarios en memoria.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#diseno-de-logros","title":"Dise\u00f1o de Logros","text":"<ul> <li>Balance 1: Balancea el set de acuerdo a la distribuci\u00f3n de dificultad, remueva o re dise\u00f1a eso que no encaja.</li> <li>Logros 2: Construye la lista, pasa los logros completos a unofficial (no es necesario).</li> <li>Memoria 3: Busca las soluciones necesarias, dependiendo la memoria del juego.</li> <li>Logros 3: A\u00f1ade nuevas ideas as\u00ed como vengan.</li> <li>Logros 4: Re-trabaja o remueve ideas que son imposibles.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#pre-lanzamiento-pasos-finales","title":"Pre-lanzamiento Pasos Finales","text":"<ul> <li>T\u00edtulos &amp; Descripciones: Finalizalos</li> <li>Bugs 1: Testea logros para encontrar bugs, puedes usar/grabar v\u00eddeos tambi\u00e9n.</li> <li>Pagina del Juego: Actualizar. Icono del Juego, im\u00e1genes, informaci\u00f3n, recursos, paginas similares.</li> <li>Tablas de Clasificaci\u00f3n (opcional): Codificalas</li> <li>Rich presence: Codificala</li> <li>Badges: Crealos</li> </ul>"},{"location":"Set-Development-Roadmap-es/#lanzamiento","title":"Lanzamiento","text":"<ul> <li>Logros 7: P\u00e1salos a core</li> <li>Puntos: Balancealos de acuerdo al m\u00e1ximo de tu set</li> <li>Ordenar Logros: Hazlo</li> <li>Post del Foro: Haz el anuncio</li> </ul>"},{"location":"Set-Development-Roadmap-es/#post-lanzamiento","title":"Post-Lanzamiento","text":"<ul> <li>Bugs 2: Arregla esos que vengan.</li> <li>Balance 2: Re-balancea la dificultad del set de acuerdo a la retroalimentaci\u00f3n.</li> </ul>"},{"location":"Set-Development-Roadmap-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-12 13:48] eldexterr:</code> Created Set Development Roadmap es (markdown)</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/","title":"Roteiro de Desenvolvimento de um Set de Conquistas","text":"<p>Link para o texto em ingl\u00eas: Set Development Roadmap</p> <p>O texto seguinte \u00e9 um roteiro detalhado da maioria das coisas que voc\u00ea deveria considerar ao fazer um conjunto de conquistas. N\u00e3o \u00e9 necess\u00e1rio seguir exatamente isso, mas serve como um guia.</p>"},{"location":"Set-Development-Roadmap-pt_BR/#pesquisa-inicial","title":"Pesquisa Inicial","text":"<ul> <li>Manual do Jogo: Analise</li> <li>Game Faqs: Leia / Cheque</li> <li>Trapa\u00e7as: Procure, anote</li> <li>Longplay: Analise / Assista</li> <li>Sets Semelhantes: Compare, anote as id\u00e9as favoritas</li> <li>Partimes: Cheque se eles existem</li> <li>Speedruns: Cheque se eles existem</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#design-conceitual","title":"Design Conceitual","text":"<ul> <li>Conquista 1: Uma chuva de id\u00e9ias, incluindo id\u00e9as de sets similares, manuais, etc.<ul> <li>Notas de segredos, progressos, eventos-chaves, colecion\u00e1veis, placares,   benchmarks, Easter Eggs (segredos), chaves, itens, recompensas internas</li> </ul> </li> <li>Pesquisa 2: Checar / Testar se os projetos s\u00e3o possiveis.</li> <li>Mem\u00f3ria 1: Estimar endere\u00e7os necess\u00e1rios para as conquistas.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#cacar-memorias","title":"Ca\u00e7ar Mem\u00f3rias","text":"<ul> <li>Mem\u00f3ria 2:. Procure por endere\u00e7os de mem\u00f3ria necess\u00e1rios</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#design-de-conquistas","title":"Design de Conquistas","text":"<ul> <li>Balan\u00e7a 1: Balancear a dificuldade do set, remover ou redesenhar    aqueles que n\u00e3o se encaixam.</li> <li>Conquistas 2: Construa a Lista, empurre-a inteira para o unofficial (n\u00e3o-oficial) (n\u00e3o \u00e9 obrigat\u00f3rio).</li> <li>Mem\u00f3ria 3: Procure por solu\u00e7\u00f5es perdidas, dependendo da mem\u00f3ria do jogo.</li> <li>Conqusitas 3: Adicionar id\u00e9ias conforme elas veem.</li> <li>Conquistas 4: Retrabalhe ou remova id\u00e9as que s\u00e3o impossiveis.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#pre-lancamento-passos-finais","title":"Pr\u00e9-lan\u00e7amento - Passos Finais","text":"<ul> <li>Titulos &amp; Descri\u00e7\u00f5es: Finalize</li> <li>Bugs 1: Teste conquistas por bugs, Fa\u00e7a / Use poss\u00edveis Movies</li> <li>P\u00e1gina do Jogo: Atualize o \u00edcone do jogo, images, informa\u00e7\u00e3o, recursos, jogos similares.</li> <li>Leaderboards (opcional): C\u00f3digo</li> <li>Rich presence: C\u00f3digo</li> <li>Badges (\u00cdcones): Crie</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#lancamentos","title":"Lan\u00e7amentos","text":"<ul> <li>Conquistas 7: Mova para o Core</li> <li>Pontos: Distribua os pontos de acordo com a dificuldade</li> <li>Ordem do set: Fa\u00e7a</li> <li>Post no Forum: Fa\u00e7a o anunciamento</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#apos-lancamento","title":"Ap\u00f3s Lancamento","text":"<ul> <li>Bugs 2: Corrigir aqueles que vierem.</li> <li>Balan\u00e7a 2: Reequilibre a dificuldade do set baseado no feedback.</li> </ul>"},{"location":"Set-Development-Roadmap-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 16:23] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:22] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:17] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:15] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 16:04] KingDice001:</code> Updated Set Development Roadmap pt_BR (markdown)</li> <li><code>[2018-03-25 13:18] KingDice001:</code> Created Set Development Roadmap pt_BR (markdown)</li> </ul>"},{"location":"Set-Development-Roadmap/","title":"Set Development Roadmap","text":"<p>The following is a detailed road-map of most things you would want to consider while making an achievement set. It's not required to follow this exactly but is meant as a guide.</p>"},{"location":"Set-Development-Roadmap/#initial-research","title":"Initial Research","text":"<ul> <li>Game manual: Review</li> <li>Game Faqs: Read/check</li> <li>Game Cheats: Find, note</li> <li>Longplay: Review/watch</li> <li>Similar sets: Compare, note favorite ideas</li> <li>Partimes: check if they exist</li> <li>Speedruns: check if they exist</li> </ul>"},{"location":"Set-Development-Roadmap/#conceptual-design","title":"Conceptual Design","text":"<ul> <li>Achievements 1: Brainstorm, include ideas from similar sets, manual, etc.     - Note secrets, progress, key events, collectibles, scores      benchmarks, Easter eggs, bosses, key items, par times, internal rewards.</li> <li>Research 2: Check/test that designs are possible.</li> <li>Memory 1: Estimate needed addresses for achievements.</li> </ul>"},{"location":"Set-Development-Roadmap/#memory-hunt","title":"Memory hunt","text":"<ul> <li>Memory 2: Search for needed memory addresses.</li> </ul>"},{"location":"Set-Development-Roadmap/#achievement-design","title":"Achievement Design","text":"<ul> <li>Balance 1: Balance set for difficulty distribution, remove or redesign    those that don't fit.</li> <li>Achievements 2: Build the list, push complete to unofficial (not required).</li> <li>Memory 3: Search for solutions missing, depending on the game's memory.</li> <li>Achievements 3: Add new ideas as they come.</li> <li>Achievements 4: Rework or remove ideas that are impossible.</li> </ul>"},{"location":"Set-Development-Roadmap/#pre-release-final-steps","title":"Pre-release Final steps","text":"<ul> <li>Titles &amp; Descriptions: Finalize</li> <li>Bugs 1: Test achievements for bugs, possibly make/use movies.</li> <li>Game page: Update. Game icon, images, info, resources, similar games.</li> <li>Leaderboards (optional): Code</li> <li>Rich presence: Code</li> <li>Badges: Create</li> </ul>"},{"location":"Set-Development-Roadmap/#release","title":"Release","text":"<ul> <li>Achievements 7: Push to core</li> <li>Points: Balance to your cap</li> <li>Ordering: Do it</li> <li>Forum post: Make announcement</li> </ul>"},{"location":"Set-Development-Roadmap/#post-release","title":"Post Release","text":"<ul> <li>Bugs 2: Fix those that come.</li> <li>Balance 2: Re-balance set difficulty based on feedback.</li> </ul>"},{"location":"Set-Development-Roadmap/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-08 10:57] meleu:</code> fix markdown</li> <li><code>[2018-02-17 18:08] Kvon:</code> Updated Set Development Roadmap (markdown)</li> <li><code>[2018-01-29 13:35] meleu:</code> tagged Rich Presence as optional</li> <li><code>[2017-11-27 05:42] meleu:</code> format fix</li> <li><code>[2017-11-26 06:43] meleu:</code> cosmetic</li> <li><code>[2017-11-26 06:31] meleu:</code> improved markdown formatting</li> <li><code>[2017-11-26 00:32] Kvon:</code> added preface, changed title from \"Sample Set Development Roadmap\"</li> </ul>"},{"location":"Set-Plagiarism/","title":"Set Plagiarism","text":"<p>As developers, our goal is to give every set we develop its own unique achievement set when possible. Sometimes we end up reusing an idea or two that another developer already used for their own set. Being an open community, sharing and building on others ideas is encouraged, however, intentionally taking someone else\u2019s work and applying it to your own set is prohibited and disrespectful to the work of the original Developer. If a set has been copied or copy/pasted, it will be grounds for demotion until the issue is remedied.  This applies to RetroAchievement sets and third-party platform achievement sets like Xbox Live, PSN, Steam, and other similar services.  If you are concerned about your set breaking these guidelines, just submit an inbox message to DevCompliance on the site and we will take a look at it.</p>"},{"location":"Set-Plagiarism/#unacceptable-plagiarism","title":"Unacceptable Plagiarism","text":""},{"location":"Set-Plagiarism/#iconsbadges","title":"Icons/Badges","text":"<p>Achievement and mastery badges need to be unique from other sets.  Slightly modifying a badge or putting a watermark over an existing badge is not acceptable unless it\u2019s a bonus/subset mastery badge.  The difference must be obvious from a zoomed out side by side comparison of the badges.  Using any copyrighted badges from official sets is prohibited.</p>"},{"location":"Set-Plagiarism/#titles","title":"Titles","text":"<p>Achievement titles should be unique from other sets. This may not always be possible when working on games that have ports for multiple systems. Generic titles and titles based on the in-game contents are both allowed. For example, Green Hills Zone is the first level of Sonic the Hedgehog on the Mega Drive, Master System, and Game Gear ports. Additionally, the level shows up in later entries of the Sonic series. As such, the achievement title \u201cGreen Hills Zone\u201d would be acceptable in all these sets.</p>"},{"location":"Set-Plagiarism/#design","title":"Design","text":"<p>The design of an achievement is open to the community.  You can use an idea from other sets so long as the achievement badge and title differ.  However, an exact copy of the achievement list from another set is prohibited.</p>"},{"location":"Set-Plagiarism/#acceptable-copying","title":"Acceptable Copying","text":""},{"location":"Set-Plagiarism/#descriptions","title":"Descriptions","text":"<p>Achievement descriptions do not have to be unique.  Descriptions need to be clear instructions of how to earn an achievement so variations on a description may make the achievement confusing.  There are only so many ways to say \u201cBeat the game without dying.\u201d</p>"},{"location":"Set-Plagiarism/#rich-presenceleaderboards","title":"Rich Presence/Leaderboards","text":"<p>Copying Rich Presence and Leaderboards are allowed.  When copying a Rich Presence you should note the original author at the top by adding a line: <code>// RP By Original Dev</code></p>"},{"location":"Set-Plagiarism/#logic","title":"Logic","text":"<p>Copying the logic of another achievement is acceptable. Developers are encouraged to look at how other sets are coded and incorporate it into their own sets.</p>"},{"location":"Set-Plagiarism/#self-plagiarism","title":"Self-Plagiarism","text":"<p>You are allowed to copy anything you created from one set to another set.  However, it is preferable to let another developer work on a port for set you have already created.</p>"},{"location":"Set-Plagiarism/#in-game-achievements","title":"In Game Achievements","text":"<p>Some games incorporate a set of in game achievements that were released with the game.  Any of these achievements can be used as long as they are not Unwelcome Concepts.</p>"},{"location":"Set-Plagiarism/#code-notes","title":"Code Notes","text":"<p>Code notes can be copied from another set.  Noting who did the original memory digging is good practice but not required.</p>"},{"location":"Set-Plagiarism/#giving-credit-or-copying-with-permission","title":"Giving Credit or Copying with Permission","text":"<p>Credit should be given when using one of the Acceptable Copying items listed above.  However, giving credit for one of the Unacceptable Plagiarism items is still plagiarism.  Even if the original developer has given permission to use their assets it is unacceptable to do so.  Each set should include a developers\u2019 own creative spin on existing achievements and sets.  You are not expected to reinvent the wheel, just make it your own.</p>"},{"location":"Set-Plagiarism/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-11-16 21:55] pingus:</code> remove title</li> <li><code>[2022-11-16 21:53] pingus:</code> Created Set Plagiarism (markdown)</li> </ul>"},{"location":"Setup-Guide/","title":"Setup Guide","text":"<p>WIP Page</p> <ul> <li>Emulators<ul> <li>Bizhawk</li> <li>DuckStation</li> <li>PCSX2</li> <li>RALibretro</li> <li>RAMeka</li> <li>RANes</li> <li>RAP64</li> <li>RAppleWin</li> <li>RAQUASI88</li> <li>RASnes9x</li> <li>RAVBA</li> <li>RetroArch</li> <li>WinArcadia</li> </ul> </li> <li>Cores<ul> <li>Final Burn Neo</li> <li>Flycast</li> <li>PPSSPP</li> </ul> </li> </ul>"},{"location":"Setup-Guide/#emulators","title":"Emulators","text":""},{"location":"Setup-Guide/#bizhawk","title":"Bizhawk","text":"<p>Pending</p>"},{"location":"Setup-Guide/#duckstation","title":"DuckStation","text":"<p>Pending</p>"},{"location":"Setup-Guide/#pcsx2","title":"PCSX2","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ralibretro","title":"RALibretro","text":"<p>Pending - for now, see RALibretro</p>"},{"location":"Setup-Guide/#rameka","title":"RAMeka","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ranes","title":"RANes","text":"<p>Pending</p>"},{"location":"Setup-Guide/#rap64","title":"RAP64","text":"<p>Pending</p>"},{"location":"Setup-Guide/#rapplewin","title":"RAppleWin","text":"<p>Pending</p>"},{"location":"Setup-Guide/#raquasi88","title":"RAQUASI88","text":"<p>RAQUASI88 is based on QUASI88kai, which is a fork of QUASI88 with various improvements.</p> <p>Documentation is available in the release archives, or in the repository for the project. Files that do not end with <code>.EN.TXT</code> are in Japanese only.</p> File Description QUICK-START.EN.TXT PC-8801 and QUASI88(kai) general information targeted at first-time users RAQUASI88[.EN].TXT RetroAchievements and RAQUASI88-specific information QUASI88.TXT QUASI88(kai)-specific information, presented in a digestible format MANUAL.TXT Exhaustive rundown of options and systems for QUASI88(kai), for advanced users COMPATIBILITY.TXT Game-specific options required to run or function correctly <p>The PC-8000/8800 support forum thread, as well as individual game pages and forum threads, also contain some information.</p>"},{"location":"Setup-Guide/#rasnes9x","title":"RASnes9x","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ravba","title":"RAVBA","text":"<p>Pending</p>"},{"location":"Setup-Guide/#retroarch","title":"RetroArch","text":"<p>Pending</p>"},{"location":"Setup-Guide/#winarcadia","title":"WinArcadia","text":"<p>Pending</p>"},{"location":"Setup-Guide/#cores","title":"Cores","text":""},{"location":"Setup-Guide/#final-burn-neo","title":"Final Burn Neo","text":"<p>Pending</p>"},{"location":"Setup-Guide/#flycast","title":"Flycast","text":"<p>Pending</p>"},{"location":"Setup-Guide/#ppsspp","title":"PPSSPP","text":"<p>Pending</p>"},{"location":"Setup-Guide/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:21] televandalist:</code> Updated Setup Guide (markdown)</li> <li><code>[2023-06-05 22:19] televandalist:</code> Created Setup Guide (markdown)</li> </ul>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-es/","title":"Un Ejemplo Simple en como evitar el Abuso de Estados de Guardado","text":"<p>(Editado ya que en el dll version 0.73 esto es usualmente incorrecto)</p> <p>En este ejemplo el juego es Zooming Secretary (NES), y el logro es Great Job! - Now you can take a rest, por pasar el juego.</p> <p>En este queremos que el jugador hubiera pasado por todos los niveles y haber pasado el juego en orden para que salte el logro. Si el jugador utiliza un save state para ir directamente al ultimo mundo y terminarlo, el logro no va a salir.</p> <p>Variables (Addresses)</p> <ul> <li><code>0x06e9</code>: ID de Nivel. De 0 a 8 y 8 significa \"juego terminado\".</li> </ul> <p></p> <p>Condiciones</p> <ol> <li>Estar en el \"nivel de juego terminado\".</li> <li>El nivel fue incrementado 8 veces.</li> <li>Resetear el contador si el nivel decrementa.</li> </ol> <p>Como este juego tiene 8 niveles, el valor en la variable del ID de Nivel tiene que ser incrementado 8 veces para pasar el juego. De esta manera el jugador no puede simplemente empezar el juego, cargar un estado de guardado e ir directamente al nivel final y pasar el juego. El/ella necesita pasar por todos los niveles.</p> <p>El <code>ResetIf</code> se encuentra solo para evitar casos en el que el jugador este cargando estados de guardado y yendo hacia adelante y atr\u00e1s por todos los niveles intentando que el contador llegue a 8. Si el/ella a cargar un estado yendo a un nivel mas bajo, el contador de hits pasara a cero.</p>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-pt_BR/","title":"Exemplo Simples de Como Evitar o Abuso de Load State","text":"<p>Link para o texto em ingl\u00eas: Simple Example of How to Avoid Load State Abusing</p> <p>Neste exemplo, o jogo \u00e9 Zooming Secretary (NES), e o Achievement \u00e9 Great Job! - Now you can take a rest, por terminar o jogo.</p> <p>Neste, queremos garantir que o jogador tenha passado por todos os n\u00edveis para vencer o jogo para ganhar o achievement. Se o jogador usar um save state para ir diretamente ao \u00faltimo est\u00e1gio e finaliz\u00e1-lo, o achievement n\u00e3o aparecer\u00e1.</p> <p>Endere\u00e7os</p> <ul> <li><code>0x06e9</code>: level ID. Do 0 ao 8. O 8 significa \"fim de jogo\".</li> </ul> <p></p> <p>Condi\u00e7\u00f5es</p> <ol> <li>No \"game finished level\".</li> <li>O level aumentou 8 vezes.</li> <li>Reset o contador se o level diminuir.</li> </ol> <p>Como este jogo tem 8 leveis, o valor no endere\u00e7o de identifica\u00e7\u00e3o (ID address) de n\u00edvel deve ser aumentado 8 vezes para vencer o jogo. Desta forma, um jogador n\u00e3o pode simplesmente iniciar o jogo, carregar (load game) para ir diretamente ao \u00faltimo n\u00edvel e depois vencer o jogo. Ele / ela precisa percorrer todos os n\u00edveis.</p> <p>O <code>ResetIf</code> est\u00e1 aqui apenas para evitar o caso em que o jogador continua carregando states (load state) indo para frente e para tr\u00e1s entre os n\u00edveis fazendo o contador de hits ser 8. Se ele / ela carrega um estado (load) indo para um n\u00edvel mais baixo, o contador de visitas vai para zero.</p>"},{"location":"Simple-Example-of-How-to-Avoid-Load-State-Abusing-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-25 12:07] KingDice001:</code> Updated Simple Example of How to Avoid Load State Abusing pt_BR (markdown)</li> <li><code>[2018-03-25 11:51] KingDice001:</code> Updated Simple Example of How to Avoid Load State Abusing pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Simple Example of How to Avoid Load State Abusing.pt_BR (markdown)</li> </ul>"},{"location":"Site-Change-Log/","title":"Site Change Log","text":""},{"location":"Site-Change-Log/#22-december-2017","title":"22-December-2017","text":""},{"location":"Site-Change-Log/#site-update","title":"Site update","text":"<ol> <li>Untracked status has been added as a possible user status. Untracked players do not show up in the global ranking. Instead of banning players who are found to be cheating they can be given the status of untracked. Also players who don't want to show up in the global rankings can also request this status, given by admin.</li> </ol>"},{"location":"Site-Change-Log/#16-december-2017","title":"16-December-2017","text":""},{"location":"Site-Change-Log/#emulators-update-v0068","title":"Emulators Update [v0.068]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x </p>"},{"location":"Site-Change-Log/#general-changes","title":"General Changes","text":"<ol> <li>Game Titles with special characters such as <code>~</code> or <code>[</code> no long appear at the start of the entry database but at the end.</li> </ol> <p>Rich Presence:</p> <ol> <li>Parse Rich Presence has been changed into Rich Presence monitor. This will actively display rich presence </li> <li>The Rich Presence Monitor also supports much more unicode </li> <li>Rich presence is displayed every 2 minutes instead of every 10. </li> </ol> <p>Linking: </p> <ol> <li>Only Developers and Admin are allowed to link ROMs to game entries. This is to prevent unsupported ROM versions which will cause achievement errors and to prevent some forms of cheating. </li> </ol>"},{"location":"Site-Change-Log/#developer-changes","title":"Developer Changes","text":""},{"location":"Site-Change-Log/#achievement-sets-window","title":"Achievement Sets Window:","text":"<ol> <li>Button layout reworked and compressed </li> <li>Activate All has been added to Local Achievements </li> <li>Buttons removed: Vote Up, Vote Down, Goto Web page, Close </li> </ol>"},{"location":"Site-Change-Log/#renames","title":"Renames:","text":"<ol> <li>Fetch Latest \u21d2 Refresh from Server </li> <li>Reset Achieved Status, Activate \u21d2 Activate Selected </li> <li>Save Local \u21d2 Save All Local </li> <li>Achievement Processing Active? \u21d2 Processing Active </li> <li>Achievements found \u21d2 Num Achievements Found </li> <li>In local Commit Selected \u21d2 Promote to Unofficial </li> </ol>"},{"location":"Site-Change-Log/#bugs-fixes","title":"Bugs Fixes:","text":"<ol> <li>Changing the points value of an achievement even after it's been updated the points value in the Achievements window does not update. </li> <li>Activating an achievement and then making changes to it changes it's active status display from Yes to No even though it is still active. </li> <li>After committing a change and then fetching latest or reloading the rom the changes made are no longer visible. </li> <li>Other \"under the hood\" bug fixes.</li> </ol>"},{"location":"Site-Change-Log/#1-december-2017","title":"1-December-2017","text":""},{"location":"Site-Change-Log/#emulators-update-v0067","title":"Emulators Update [v0.067]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x</p>"},{"location":"Site-Change-Log/#developer-changes_1","title":"Developer Changes","text":"<p>Memory Inspector:</p> <ol> <li>You can now scroll with your mouse-wheel in the memory viewport. </li> <li>The memory viewer cursor no longer defaults to line 5, instead you are allowed to move it within a current viewport freely.  When you move past the top or bottom the view will scroll up or down and keep the cursor position on the top most or bottom most line. </li> <li>In the memory viewport hitting page down will go down 1 page depending on how many addresses you have in view. Previously it would only go down 5 lines. </li> <li>In the memory viewport while selecting an address from the \"Watching\" it will put the selected address in focus on the center of the viewport relative to the length of the viewport. </li> <li>While putting values into the Mem Viewport you can wrap around the right side instead of getting stopped at 0xf of that line. This allows for quicker corrupting, which can sometimes be useful for finding addresses. </li> <li>When deleting a note in the Mem Viewport the selected stays at current address instead of going to 0x0. </li> <li>Notes window has been extended to 5 from 3 lines. </li> <li>Notes window now has word wrap and accept line returns greater than 3. </li> <li>View Notes Button has been added below Delete. </li> <li>Memory Search Range has been added allowing for Custom Range System RAM and Game RAM. </li> <li>Searching for hex values in Given Value is allowed with the prefix 0x. </li> </ol> <p>Achievement Editor:</p> <ol> <li>\"Clone selected\" achievement has been replaced with \"Copy\" and \"Paste\" buttons.  You are now able to copy and paste multiple selected requirements within an achievement, to an alt group or to another achievement! </li> <li>\"Delete Selected\" will now delete ALL selected achievements instead of just one at a time.(edited) </li> </ol> <p>Rich Presence:</p> <ol> <li>No longer displays \"Unknown\". It just leaves a blank non-space. Devs this means you don't need to sweat as much about about those knowing every value state of an address in RPS. </li> <li>If someone is playing a set without achievement or a Rich Presence script it the Rich Presence will say \"Playing [game name]\".</li> </ol>"},{"location":"Site-Change-Log/#7-november-2017","title":"7-November-2017","text":""},{"location":"Site-Change-Log/#site-update_1","title":"Site Update","text":"<p>Time stamps on user, game pages and in many places now show the year. </p>"},{"location":"Site-Change-Log/#emulators-update-v0066","title":"Emulators Update [v0.066]","text":"<p>For RANes, RAGens, RAVBA, and RASnes9x </p>"},{"location":"Site-Change-Log/#general-changes_1","title":"General Changes","text":"<ul> <li>More anti-cheat measures were included. </li> <li>Soft IPS patching is removed in the listed emulators. Caused some incompatibilities. </li> <li>Issue with leaderboards popping twice is resolved. </li> </ul>"},{"location":"Site-Change-Log/#developer-changes_2","title":"Developer Changes","text":"<ul> <li>Achievement Editor window is slightly extended. </li> <li>Scroll bar retains position when editing longer achievements. </li> <li>Issue with uploading broken badges is fixed. </li> </ul>"},{"location":"Site-Change-Log/#30-october-2017","title":"30-October-2017","text":""},{"location":"Site-Change-Log/#site-update_2","title":"Site Update","text":"<ol> <li>Password Reset is fixed and working. Now if you forget your password you can have a password reset link emailed to you: http://retroachievements.org/resetPassword.php</li> </ol>"},{"location":"Site-Change-Log/#6-october-2017","title":"6-October-2017","text":""},{"location":"Site-Change-Log/#site-update_3","title":"Site Update","text":"<p>Started the log</p> <ol> <li>Rich Presence has been fixed:  Now online shows all online players. Developers are able to create, edit and save rich presence. Number of currently online is no long visible by online players. Active players shows a time stamp of last updated.</li> </ol>"},{"location":"SubSource-Flag-es/","title":"Bandera SubSource","text":"<p>Nota: es mas comun que esta tecnica no sea requerida para juegos mas simples. A si que, no es obligatoria para desarrolladores jr. (jr-devs).</p> <p>El <code>SubSource</code> puede ser seleccionado en la columba de Bandera (Flag) en el Editor de Logros (Achievement Editor)</p> <p>Funciona similarmente a <code>Add Source</code>, pero una bandera <code>Sub Source</code> convierte el valor en memoria en un valor negativo.</p> <p>Nota 1: <code>Sub Source</code> NO es una bandera de subtraccion. Solo convierte el valor en negativo.</p> <p>Nota 2: La ultima linea (sin el <code>Add Source</code> o <code>Sub Source</code>) aun se agrega a la comparativa final (Es una condicion que se tiene que cumplir). </p> <p>Utlizando este ejemplo de uso de un <code>AddSource</code>, si lo remplazamos con un <code>Sub Source</code> y con los mismos valores (<code>valor(0x8010) = 1</code> and <code>valor(0x8020) = 2</code>), la comparacion seria <code>-1 + 2 &gt; 0</code>, o <code>1 &gt; 0</code>.</p>"},{"location":"SubSource-Flag-es/#utilizando-subsource-para-contar-incrementos-especificos","title":"Utilizando SubSource para Contar Incrementos Especificos","text":"<p><code>SubSource</code> tambien puede ser utilizado para rastrear incrementos especificos en una variable. La condicion que se muestra abajo dice que el actual valor en la variable <code>0x0080dc</code> menos el valor en el antiguo fotograma (Delta Frame) en la misma direccion deberia de ser igual a <code>2</code>. Efectivamente, esto significa que la condicion es verdadera cualquier vez que el valor en <code>0x0080dc</code> se incremente exactamente sobre dos.</p> <p></p>"},{"location":"SubSource-Flag-es/#buscando-un-resultado-negativo","title":"Buscando un resultado negativo","text":"<p>Si el resultado en tu operacion con Sub Source es un numero negativo, es posible buscarlo. A si es como se representan los numeros negativos:</p> <ul> <li><code>-1</code> es <code>0xFFFFFFFF</code></li> <li><code>-2</code> es <code>0xFFFFFFFE</code></li> <li><code>-3</code> es <code>0xFFFFFFFD</code></li> <li><code>-4</code> es <code>0xFFFFFFFC</code></li> <li><code>-5</code> es <code>0xFFFFFFFB</code></li> <li><code>-6</code> es <code>0xFFFFFFFA</code></li> <li><code>-7</code> es <code>0xFFFFFFF9</code></li> <li>y asi sucesivamente...</li> </ul> <p>A si que, vamos a decir que quieres buscar si el <code>valor(0x8010) = 1</code> menos el <code>valor(0x8020) = 2</code> es igual a <code>-1</code>. Asi es como le harias:</p> <p></p> <p>Esto significa <code>-2 + 1 = -1</code>, que es verdad.</p> <p>Avanzado: tambien es posible utilizar directamente numeros negativos en la columna de la izquierda con tus operaciones Sub/Add Source. Para hacerlo, recuerda cambiar el Tipo (Type) de <code>Mem</code> a <code>Value</code>, y utilizar los valores explicados arriba, como <code>0xFFFFFFE5</code> para <code>-27</code>, y <code>0xFFFFFFE3</code> para <code>-29</code>, por ejemplo:</p> <p></p> <p>Esto significa <code>-2 + (-27) = -29</code>, que es <code>-2 - 27 = -29</code>, el cual es cierto.</p> <p>De todos modos ten cuidado, si utilizas numeros negativos en una bandera con Sub Source, va a resultar en un doble negativo, convirtiendo los numeros de nuevo a positivos. Hecha un vistazo:</p> <p></p> <p>Esto significa <code>- (-2) + (-27) = -29</code>, que es <code>2 - 27 = -29</code>, que es <code>-25 = -29</code>, el cual es falso.</p>"},{"location":"SubSource-Flag-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 15:32] meleu:</code> fix broken link</li> <li><code>[2019-03-12 15:01] meleu:</code> Updated SubSource Flag ES (markdown)</li> </ul>"},{"location":"SubSource-Flag/","title":"SubSource Flag","text":"<p>Note: most likely this technique is not needed for simple games. So, it's not mandatory for jr-devs.</p> <p>The <code>SubSource</code> can be chosen in the Flag column of the Achievement Editor</p> <p>Works similarly to <code>Add Source</code>, but the <code>Sub Source</code> flag subtracts the calculated value from the accumulator.</p> <p>Because it subtracts from the accumulator, <code>SubSource A, B</code> is actually <code>B - A</code>.</p>"},{"location":"SubSource-Flag/#simple-example","title":"Simple example","text":"ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 &gt; Value 0x04 0 (0) <p>In this example the value in <code>0x8010</code> will be subtracted from the value in <code>0x8020</code> and the comparison will check is if this sum is greater than four.</p> <p>If the value in <code>0x8010</code> is <code>1</code> and the value in <code>0x8020</code> is <code>2</code>, the comparison will be <code>-1 + 2 &gt; 4</code>, or <code>1 &gt; 4</code>.</p>"},{"location":"SubSource-Flag/#using-subsource-to-count-specific-increments","title":"Using SubSource to Count Specific Increments","text":"<p><code>SubSource</code> can also be used to track specific increases in addresses. The conditions below states that the current value in address <code>0x80dc</code> minus the value in the previous frame in the same address must be equal <code>2</code>. Effectively, this means that the condition is true whenever the value in address <code>0x80dc</code> increases by exactly two.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Delta 8-bit 0x80dc 2 Mem 8-bit 0x80dc = Value 0x02 0 (0)"},{"location":"SubSource-Flag/#checking-for-a-negative-result","title":"Checking for a negative result","text":"<p>The accumulator and all logic performed is limited to an unsigned 32-bit number. If the total drops below 0, it underflows, resulting in a very large positive number. Here's the representation for the first few negative numbers:</p> <ul> <li><code>-1</code> is <code>0xFFFFFFFF</code></li> <li><code>-2</code> is <code>0xFFFFFFFE</code></li> <li><code>-3</code> is <code>0xFFFFFFFD</code></li> <li><code>-4</code> is <code>0xFFFFFFFC</code></li> <li><code>-5</code> is <code>0xFFFFFFFB</code></li> <li><code>-6</code> is <code>0xFFFFFFFA</code></li> <li><code>-7</code> is <code>0xFFFFFFF9</code></li> <li>and so on...</li> </ul> <p>So, if you wanted to see if a value was 1 less than another value, you could write:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8020 2 Mem 8-bit 0x8010 = Value 0xffffffff 0 (0) <p>This would be true if the value at $8010 (1) was 1 less than the value at $8020 (2): <code>1 - 2</code> = <code>-1</code> = <code>0xFFFFFFFF</code>.</p> <p>However, you should swap the conditions to make it easier to read (<code>B - A = -1</code>) is the same as (<code>A - B = 1</code>):</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 8-bit 0x8010 2 Mem 8-bit 0x8020 = Value 1 0 (0) <p>This evaluates <code>-1 + 2 = 1</code>, which is true.</p>"},{"location":"SubSource-Flag/#subtracting-negative-constants","title":"Subtracting negative constants","text":"<p>It is also possible to use straight negative numbers in the left section of your Sub/Add Source operations. To do so, remember to change the Type from <code>Mem</code> to <code>Value</code>, and use the values as explained above, such as <code>0xFFFFFFE5</code> for <code>-27</code>, and <code>0xFFFFFFE3</code> for <code>-29</code>, for example:</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Mem 32-bit 0x8020 2 Value 0xffffffe5 = Value 0xffffffe3 0 (0) <p>If $8020 contains 2, this would be true. <code>-2 + (-27) = -29</code>, which is <code>-2 - 27 = -29</code>, which is true.</p> <p>If you use a negative number in a <code>SubSource</code> flag, it will result in a double negative, turning the number back to positive.</p> ID Flag Type Size Memory Cmp Type Size Mem/Val Hits 1 SubSource Value 0xfffffffe 2 Value 0xffffffe5 = Value 0xffffffe3 0 (0) <p>This means <code>-(-2) + (-27) = -29</code>, which is <code>2 - 27 = -29</code>, which is <code>-25 = -29</code>, which is false.</p>"},{"location":"SubSource-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-12-13 10:49] Jamiras:</code> \"less\" -&gt; \"minus\"</li> <li><code>[2021-11-27 08:38] Jamiras:</code> Updated SubSource Flag (markdown)</li> <li><code>[2020-01-15 08:23] meleu:</code> better example of a negative number</li> <li><code>[2019-12-31 12:14] meleu:</code> cosmetic</li> <li><code>[2019-02-17 23:42] meleu:</code> better example for \"Using SubSource to Count Specific Increments\"</li> <li><code>[2019-02-17 21:05] meleu:</code> cosmetic</li> <li><code>[2019-02-14 10:10] meleu:</code> fix broken link</li> <li><code>[2019-02-12 13:25] meleu:</code> add heading to \"Using SubSource to Count Increments\"</li> <li><code>[2019-02-12 13:18] meleu:</code> fix broken link</li> <li><code>[2019-02-12 09:37] meleu:</code> Updated SubSource (markdown)</li> </ul>"},{"location":"Subsets/","title":"Subsets","text":"<p>Advanced Developer Topic</p> <ul> <li>What are Subsets?</li> <li>Types of Subsets<ul> <li>Bonus Sets</li> <li>Multi Sets</li> <li>Challenge Runs</li> <li>DLC and Expansions</li> <li>Regional Differences</li> <li>User-Generated Content</li> </ul> </li> <li>Naming Scheme</li> <li>Approval and Claims</li> </ul>"},{"location":"Subsets/#what-are-subsets","title":"What are Subsets?","text":"<p>When browsing the list of games, you will see that some games have a <code>[Subset]</code> tag in the title. Each of these contain achievements that for some reason or another, are not available in a game's base set.  Subsets are typically home to specific types of challenge runs. They have also inherited what have been known simply as <code>[Bonus]</code> and <code>[Multi]</code> sets. </p> <p>The methods to create a subset and means to play them will change once they become a more integrated feature. As of now, they require a patch to generate a unique hash and are separate entries from the base set, so achievements must be obtained separately as well. Information on creating these patches can be obtained here.</p>"},{"location":"Subsets/#types-of-subsets","title":"Types of Subsets","text":""},{"location":"Subsets/#bonus-sets","title":"Bonus Sets","text":"<p>While Bonus sets are subject to debate amongst both players and achievement creators, the overall purpose of a bonus set is for achievements that were not fit for the base set to have a home and still be obtainable by a devoted player. Think of them as \"deluxe\" challenges. The following types of achievements are the most suitable for Bonus Sets: - Extreme Challenges: If it's generally voiced a challenge is too difficult, it's a prime candidate for a Bonus set.  However, just because the achievement(s) are possible to code does not mean they are possible to obtain; therefore, the achievement must still be obtainable. A good example of this is the infamous Mr. Perfect from Mega Man (NES), which requires the player to complete the entire game without taking damage. - Grind Sessions: If achievements involve overly long and frustrating grinds that have no meaningful purpose, they're better suited for Bonus sets. These include leveling characters to the maximum level, maxing out stats, performing a task an absurd amount of times, etc. when none of those things award the player. A good example of something grindy that awards the player, thus making it suitable for a base set, is One of a Kind from Final Fantasy IV (SNES), which requires a highly RNG-reliant grind for an item to trade for said armor. - Variety Packs - Want to do a mixture of subset ideas all within one set because you don't want to do several different subsets? Then do it and throw it in a Bonus set. An example of this is the Suikoden Bonus Set, which contains various challenge runs, rare drops, and extreme challenges within a single subset. - Showcasing of or Abuse of Glitches: Glitching can have unpredictable effects in a game's memory, which can result in unwanted behavior for some achievements, thus making them not suitable for a base set. Some examples of this are Replica from Final Fantasy VII (PlayStation) and Rare Candy Addiction from Pokemon - Red and Blue Versions (Game Boy.</p>"},{"location":"Subsets/#multi-sets","title":"Multi Sets","text":"<p>This one is simple. If an achievement requires input from more than one player in order to unlock it, then it cannot be in the base set. </p>"},{"location":"Subsets/#challenge-runs","title":"Challenge Runs","text":"<p>While many base sets include plenty of challenges, developers have the option to add challenges that last the duration of a game's playthrough to a Subset. These are typically self-imposed challenges that go against how a game is normally played. Examples: - Chrono Trigger - No Level Up - requires players to complete the game without ever leveling up their characters.  - EarthBound - Rare Drops - requires players to obtain all the rare drops from enemies. - Final Fantasy - Solo Class - requires players to complete the game using only one character class, but they need to do it with every class to master the set. - Pokemon - Professor Oak Challenge - There are several of these so far! This challenge requires players to catch and/or evolve every Pokemon possible between major story points in the game. - Trails in the Sky FC - NG Nightmare - requires players to obtain 100% completion in a single, NG (New Game) playthrough on the Nightmare difficulty setting, as opposed to doing it on NG+ with carryovers. </p>"},{"location":"Subsets/#dlc-and-expansions","title":"DLC and Expansions","text":"<p>Not very common, but will become more common as our console support expands. Achievements in these sets are exclusive to a game's downloadable content or expansion pack(s). Examples: - Arc the Lad 2 - Arc Arena: Monster Tournament - released as a bonus disc in the Arc the Lad Collection, this requires save data from Arc the Lad 2 in order to play. - F-Zero X - Expansion Kit - achievements are for content exclusive to the 64DD expansion of the game. - Return Fire - Maps o' Death - a separate release that provides additional maps to the game. It requires save data from the original game in order to play.</p>"},{"location":"Subsets/#regional-differences","title":"Regional Differences","text":"<p>If a regional variant of a game does not have enough differences to warrant a \"full\" set, but you don't want to include it with the base set due to interference with base challenges, you can make a Subset to showcase the differences. </p>"},{"location":"Subsets/#user-generated-content","title":"User-Generated Content","text":"<p>If a game has a feature that allows players to make their own content such as custom levels, then a subset would be an acceptable place to include said content. Examples: - Irritating Stick - IrRAtating Custom Courses - features custom stages made by various RA community members. - Tony Hawk's Underground - RAdical Custom Goals/Gaps - Custom goals and gaps made by various RA community members.</p>"},{"location":"Subsets/#naming-scheme","title":"Naming Scheme","text":"<p>To prevent players from getting confused, there is a specific naming scheme required for all Subsets: - Bonus Sets: Must have <code>[Subset - Bonus]</code> following the base game title. For example: <code>Castlevania [Subset - Bonus]</code> and <code>Darkwing Duck [Subset - Bonus]</code>. - Multi Sets: Must have <code>[Subset - Multi]</code> following the base game title. For example: <code>Contra [Subset - Multi]</code> and <code>Kirby 64: THe Crystal Shards [Subset - Multi]</code>. - Challenge Runs: Must have <code>[Subset - Challenge Name/Type]</code> following the base game title. For example: <code>Chrono Trigger [Subset - No Level Up]</code> and <code>Pocket Monsters Midori [Subset - Monotype Challenge]</code>. - DLC and Expansions: Must have <code>[Subset - DLC/Expansion Name</code> following the base game title. For example: <code>Return Fire - [Subset - Maps o' Death]</code> and <code>F-Zero X [Subset - Expansion Kit]</code> - User-Generated Content: While not actually required, including <code>RA</code> in the subset title has been a fun way to name the content.</p>"},{"location":"Subsets/#approval-and-claims","title":"Approval and Claims","text":"<p>The approval process and claiming of a subset will vary depending on if the subset type is pre-approved, your involvement with the base set, and whether or not you're a full developer or a junior developer:</p> Authorship\u00b9 Approval and Claiming Process Sole Author of Core Set \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 Does not require a plan and revision vote \u2022 Considered a free claim \u2074 Collaborative Author of Core Set \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 Requires a plan and revision vote? \u00a0\u00a0\u00a0\u25e6 No, if all active authors of the set approve \u00a0\u00a0\u00a0\u25e6 Yes, otherwise  \u2022 Considered a free claim \u2074 No Core Set Authorship \u2022 Subset must be approved by Developer Compliance \u00b2\u00b3 \u2022 If approved, a set plan must be posted in the base set's forum topic and must go through revision voting \u2022 Is not considered a free claim \u2022 In the event that both a revision and subset plan are made for a set, both claims will count as one Junior Developer \u2022 In addition to the above cases, must first be approved by Code Reviewers <p>\u00b9 In the case of multiple revision authors, use the most restrictive ruleset in the table. Example: If there is a subset collaboration and any subset author is not a core set author, use the <code>No Core Set Authorship</code> rules.</p> <p>\u00b2 To Contact Developer Compliance, send them a site message here and replace the <code>[Game Name]</code> and <code>[Subset Name]</code> in the subject line with the game name and desired subset name.</p> <p>\u00b3 The following are pre-approved subset types and therefore do not require contacting Developer Compliance: - Bonus - Multi - DLC/Expansions - Glitch Showcases - Regional Differences - User-Generated Content - Challenge Run: Low Level Game/No Leveling Runs - Challenge Run: Solo Class/Monotype Runs - Challenge Run: Checkpoint Challenges, such as Professor Oak Challenges - Challenge Run: Perma-Death Challenges, such as Nuzlocke Challenges</p> <p>\u2074 For now, an admin must be contacted via Discord or by messaging RAdmin to mark a claim as free. As a courtesy, please only request this if you actually need the claim slot or if you expect a long development period.</p>"},{"location":"Subsets/#notes","title":"Notes","text":"<ul> <li>In the case of multiple revision authors, use the most restrictive ruleset in the table. Example: If there is a subset collaboration and any subset author is not a core set author, use the 'no core set authorship' rules.</li> </ul>"},{"location":"Subsets/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-10-30 13:00] The Mystical One:</code> Fixes formatting in the pre-approved list.</li> <li><code>[2023-07-11 10:55] The Mystical One:</code> Add in footnote for when there are multiple subset authors, which table entry should be used.</li> <li><code>[2023-06-30 13:45] The Mystical One:</code> Cleaned up the table for collaborative core set author of a subset, which implied that other authors had to approve, and so thus could stealthily veto. Current wording should be clear that collaborative author disapproval now merely means you have to go through the plan/revision vote route.</li> <li><code>[2023-06-23 11:21] The Mystical One:</code> Fixed spacing in pre-generated subject line on DevCompliance contact link.</li> <li><code>[2023-06-23 11:16] The Mystical One:</code> Added links to contact Developer Compliance with pre-generated subject to be edited.</li> <li><code>[2023-05-09 04:03] televandalist:</code> Added info about User-Generated Content to multiple sections. Also added it to the list of pre-approved subset types</li> <li><code>[2023-04-19 23:49] televandalist:</code> Moved the \"how to create a subset patch\" info to RAPatches' wiki</li> <li><code>[2023-03-13 07:48] televandalist:</code> Typo fix</li> <li><code>[2023-03-13 07:42] televandalist:</code> Fix formatting, hopefully...</li> <li><code>[2023-03-13 07:33] televandalist:</code> Rewrote the Approval and Claiming section again. Turned the info into a table so relevant points are easier to find.</li> </ul>"},{"location":"System-X-wen/","title":"System X wen","text":"<p>This article was originally published in the RANews - November/2020</p>"},{"location":"System-X-wen/#intro","title":"Intro","text":"<p>There seems to be a lot of speculation on what the next available systems to support achievements will be. With the recent announcement of a PS2 core, there have been a lot of questions regarding if/when it will be supported. If you're only interested in the answer to that question, skip to the end of this article. But if you want to understand what exactly is needed to add support for a new system, keep reading.</p>"},{"location":"System-X-wen/#requirements","title":"Requirements","text":"<p>These are the things that are required in order to add RetroAchievements support for a new system:</p> <ol> <li>Emulation (preferably a libretro core).<ul> <li>The core must expose memory.</li> <li>The core must function in RALibretro.</li> </ul> </li> <li>Unique identification of games.</li> <li>Server support.</li> </ol>"},{"location":"System-X-wen/#step-1-emulation","title":"Step 1: Emulation","text":"<p>The first step is, obviously, to have an emulator for the system to be supported.</p> <p>In the early days of RetroAchievements we used standalone emulators - one for each system. Keeping all those emulators bug-free and up-to-date requires a lot of effort and we don't have enough programmers involved on this front.</p> <p>It's currently preferred to use a libretro core for emulation. This way the core developers can push new features and we can focus only on the achievement functionality. Cores can be updated and released without any additional effort for us.</p> <p>Another big advantage is that libretro cores also function in RetroArch, which allows RetroAchievements to be earned on many platforms (the standalone emulators were all Windows-only applications).</p> <p>Managed by: libretro core developers.</p>"},{"location":"System-X-wen/#step-1a-exposed-memory","title":"Step 1a: Exposed Memory","text":"<p>As achievement triggers are a series of conditions that watch for things that happen in the emulated RAM,  another requirement is access to the system's RAM.</p> <p>Without exposed memory, the Memory Inspector appears blank and achievement creators are unable to create achievements.</p> <p>Additionally, as RetroAchievements only reads the memory once per frame, some systems which heavily leverage paged memory have to provide some way to access the entire memory, not just the current page of memory.</p> <p>Managed by: libretro core developers with some interaction with RetroAchievements developers.</p>"},{"location":"System-X-wen/#step-1b-ralibretro","title":"Step 1b: RALibretro","text":"<p>The core must function in RALibretro, as that is where the achievement developers will identify the important pieces of memory and create the achievements.</p> <p>This is usually only an issue if the core relies on some functionality not yet implemented in RALibretro (like the recently added keyboard and OpenGL 3D support), but some issues are caused by the RALibretro implementation being sufficiently different from the RetroArch implementation. Unless the core can be modified to not require the missing functionality, it cannot be supported until RALibretro is updated.</p> <p>This page lists the status of each core the last time they were tested.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#step-2-game-identification","title":"Step 2: Game Identification","text":"<p>We must be able to uniquely identify the games for the system.</p> <p>We use a method called MD5, which scans the game's file and generates a number that we usually call as \"hash\". With this number it's possible to confirm if two copies of a file are identical, which makes it possible to ensure the player is using a ROM that the achievements were designed or tested against.</p> <p>For most systems, we are able to just hash the entire ROM file, minus any header information. For larger games (particularly those on CD or DVD) we only hash what we consider to be the most important data to minimize load times. More information on how we identify games can be found here.</p> <p>For systems with writable media (mostly home computers), we have to make sure that we don't hash any files that may be modified by the game itself. Systems that write to the game file must treat the original disk file as readonly and only write changes to a copy of the disk. If the core/emulator modifies the disk file, it can no longer be identified and cannot be considered viable for achievements.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#step-3-configure-the-web-server","title":"Step 3: Configure the Web Server","text":"<p>In order to support a new system, the RetroAchievements web server must be properly configured to accept new game and achievement entries for that system.</p> <p>Managed by: RetroAchievements</p>"},{"location":"System-X-wen/#when-will-ra-support-system-x","title":"When will RA support System X?","text":"<p>This page lists the status of each core the last time they were tested.</p>"},{"location":"Systems-Memory-Mapping/","title":"Work in Progress","text":"<p>This page details how the memory of each supported system is mapped.</p> <p>Memory banks as registered in the RA emulators are defined here.</p>"},{"location":"Systems-Memory-Mapping/#nes","title":"NES","text":"<p>Reference: https://wiki.nesdev.com/w/index.php/CPU_memory_map</p> Bank Offset Length Description 0 0x0000 0x0800 2KB internal RAM 1 0x0800 0x0800 Mirror of $0000-$07FF 2 0x1000 0x0800 Mirror of $0000-$07FF 3 0x1800 0x0800 Mirror of $0000-$07FF 4 0x2000 0x0008 PPU registers 5 0x2008 0x1FF8 Mirrors of $2000-$2008 6 0x4000 0x0018 APU and I/O registers 7 0x4018 0x0008 APU and I/O test registers 8 0x4020 0x1FE0 Cartridge data 9 0x6000 0x2000 Cartridge RAM 10 0x8000 0x8000 Cartridge ROM"},{"location":"Systems-Memory-Mapping/#snes","title":"SNES","text":"<p>https://en.wikibooks.org/wiki/Super_NES_Programming/SNES_memory_map</p>"},{"location":"Systems-Memory-Mapping/#n64","title":"N64","text":"<p>https://raw.githubusercontent.com/mikeryan/n64dev/master/docs/n64ops/n64ops%23h.txt</p>"},{"location":"Systems-Memory-Mapping/#gb","title":"GB","text":"<p>Reference: http://gameboy.mongenel.com/dmg</p> <p>The memory map reflects the CPU memory space.</p>"},{"location":"Systems-Memory-Mapping/#gbc","title":"GBC","text":"<p>The memory map is identical to the Game Boy's, with the exception of banked work RAM. The first bank is mapped to its usual location in CPU space, while banks 2-7 are appended to the end of the memory map, in the 0x10000-0x15FFF region.</p>"},{"location":"Systems-Memory-Mapping/#gba","title":"GBA","text":"<p>https://www.coranac.com/tonc/text/hardware.htm#sec-memory</p>"},{"location":"Systems-Memory-Mapping/#virtualboy","title":"VirtualBoy","text":""},{"location":"Systems-Memory-Mapping/#master-system","title":"Master System","text":"<p>Reference: http://www.codeslinger.co.uk/pages/projects/mastersystem/memory.html</p> <p>TODO: find a more reliable source.</p> Offset Length Description 0x0C000 0x02000 RAM"},{"location":"Systems-Memory-Mapping/#megadrive-genesis","title":"MegaDrive (Genesis)","text":"<p>https://en.wikibooks.org/wiki/Genesis_Programming https://wiki.megadrive.org/index.php?title=Main_68k_memory_map see also Jamiras comment here: https://github.com/RetroAchievements/RALibretro/issues/47#issuecomment-455374796</p>"},{"location":"Systems-Memory-Mapping/#gamegear","title":"GameGear","text":""},{"location":"Systems-Memory-Mapping/#atari-2600","title":"Atari 2600","text":"<p>Reference: http://www.randomterrain.com/atari-2600-memories-tutorial-andrew-davie-05.html#summary</p> Offset Length Description 0x080 0x080 RAM"},{"location":"Systems-Memory-Mapping/#atari-7800","title":"Atari 7800","text":""},{"location":"Systems-Memory-Mapping/#atari-lynx","title":"Atari Lynx","text":""},{"location":"Systems-Memory-Mapping/#colecovision","title":"ColecoVision","text":""},{"location":"Systems-Memory-Mapping/#neogeo-pocket","title":"NeoGeo Pocket","text":""},{"location":"Systems-Memory-Mapping/#pcengine-turbografx16","title":"PCEngine (TurboGrafx16)","text":""},{"location":"Systems-Memory-Mapping/#pcengine-cd","title":"PCEngine CD","text":""},{"location":"Systems-Memory-Mapping/#arcade","title":"Arcade","text":""},{"location":"Systems-Memory-Mapping/#pc-8001-pc-8801","title":"PC-8001 / PC-8801","text":"<p>Reference: http://www.maroon.dti.ne.jp/youkan/pc88/memmap.html</p> <p>The memory map is based on the PC-8801 layout, but excludes graphics VRAM and extended RAM.</p>"},{"location":"Systems-Memory-Mapping/#pc-8801","title":"PC-8801","text":"Bank Offset Length Description 0 0x00000 0x10000 Main RAM 1 0x10000 0x1000 Text VRAM <p>Text VRAM is also known as high-speed RAM, and is used as a main RAM area in some titles.</p>"},{"location":"Systems-Memory-Mapping/#pc-8001","title":"PC-8001","text":"<p>Reference: http://www.cyross.com/pc8801wiki</p> <p>The entire memory space is mapped in the PC-8801 main RAM bank, but only RAM is exposed, so most of the mapped space will remain uninitialized.</p> Offset Length Description 0x08000 0x08000 RAM"},{"location":"Systems-Memory-Mapping/#apple-ii","title":"Apple II","text":"<p>Reference: http://apple2.guidero.us/doku.php/mg_notes/general/mem_map</p> <p>The memory map consists of both main and auxiliary RAM banks. Rather than mapping the CPU-accessible memory space, which can flicker at high frequencies, the RAM banks are mapped consecutively.</p> <p>Auxiliary RAM is only available on systems with 128KB of RAM (Apple IIe and up), so it will remain uninitialized on 64KB systems or when running titles that are not designed to make use of auxiliary RAM.</p> Bank Offset Length Description 0 0x00000 0x10000 Main RAM 1 0x10000 0x10000 Auxiliary RAM"},{"location":"Testing-for-Demo-Mode/","title":"Testing for Demo Mode","text":"<p>Link to original post on RetroAchievements</p> <p>One of the more annoying things that can happen is if you leave your game running, and the game awards you achievements for reaching levels you haven't reached yet. This is fairly common, as many games of the 16-bit era still had 'attract modes', and is usually a pretty easy thing to fix with the achievements. </p> <p>We are looking in the game to find something that is set when the game is in a demo mode. Either a small piece of memory set to <code>0</code>, or <code>1</code>, or <code>0xff</code>. It could be anything really.</p> <p>To start it will help to play through the game a little, and set a few save states throughout different levels of the game. And then to begin finding this 'is demo mode active' memory, we should first reset the game and wait for the demo to play.</p> <p>During when the game plays the first demo, use the Memory Inspector to start a new 8-bit test, (click <code>New 8-bit test</code>), and set the filter value to be equal to the last known value (under <code>Filter values:</code>, set to <code>==</code>), and press <code>Filter!</code> a few times. With each press, you should see the number of matches slowly become fewer, but not by much. </p> <p>Next wait til the game starts playing another demo but on a different level. When the next demo is playing, press Filter a few more times, and you'll see the candidates get smaller again. Continue to do this until you've eliminated as many candidates as you can.</p> <p>IMPORTANT: Don't forget, you only want to press filter when the game is DEFINITELY in the demo. If you press when it's on the title screen, or playing a movie, or even when fading in or out, the value might not be set. There's no real way to know; we are assuming that it will be set (or unset) when the demo itself is playing, which itself is only a fairly likely assumption. </p> <p>After viewing some or all of the demos, you will probably still have TONS of potential memory values. Here's the juicy part, that should eliminate a ton of candidates at once. Load up one of your save states where you are definitely in-game, playing and NOT in a demo.</p> <p>Now we will be filtering for \"I am NOT in a demo\". Set your filter value to not-equal <code>!=</code>, and hit <code>Filter</code> ONLY ONCE.</p> <p>At this point, the set of candidates now represent memory values that are \"values different to when a demo was playing\". Switch back to equal (=), and hit <code>Filter</code> a few more times (because we are saying 'whatever values we have, they are the same as the ones just now. The 'is demo mode' value will still be equivalent to whatever it was just now). It might help to move the character around the screen, or perform a few actions, between hitting the <code>Filter</code> button. </p> <p>Next, load up your next save state, and perform the same routine. Your number of candidates should reduce further, until you have less than 100 remaining.</p> <p>By now if you should have only a few candidates remaining. Likely values for the candidate will be 0, 1 or 0xff. If it is something else I'd recommend ignoring it, as it's not likely to be what we're looking for (but still, not impossible). For example, in Sonic the Hedgehog (Mega Drive), the address is 0xfff0, and the value is 01 when a demo is active.</p> <p>Our next step will be to verify our find. Pick one of these values and restart the game, keeping an eye on this value as the game plays the demos. Then load through each of your save states and see if it changes as you expect it to. Perhaps start a brand new game and see if it matches up correctly to the value it is when the other save states are active. Make a note of the value it is when the game is active. </p> <p>Let's say we are pretty confident we've found the memory used to say 'game is in demo mode'. We'll save this to CodeNotes by adding a description in the Memory Inspector, then clicking <code>Add Note</code>. </p> <p>Next we will use the <code>Achievements</code> dialog to find all the achievements that could unlock during the demos (probably all the level-based achievements), and add a new requirement to these achievements. Add it alongside the existing requirements. For this new requirement, set the address to the 'demo mode active' memory we found, set the mem size to 8-bit, and set the value we require to be equal to the value when the game is active.</p> <p>That's it! Now the achievement will only trigger if the player is on a certain level, AND that the game is not in a demo mode! </p> <p>Before we commit this back to the server, it's a good idea to test out this to see if it worked. Press ESC on the game to bring up the overlay and pause the game. Then click 'Reset Achieved Status' on this achievement in the 'Achievements' dialog, and confirm the prompt. Finally, click back in the game and press TAB to reset the game, and ESC to dismiss the overlay. Press F4 a few times to increase the speed of the game, and watch to ensure the achievement doesn't trigger. If it still triggers, it sounds like something went wrong. Try and check the requirements are entered correctly ('is demo mode' comparison probably needs to be '8-bit'), check that you reset the right achievement, and finally watch the value of the 'is demo mode' flag in the memory inspector. </p> <p>If it worked correctly, select the achievement in the Achievements dialog, hit 'Commit Selected', confirm the dialog and you're done!</p> <p>There are many alternative methods for getting the 'is demo mode' flag, but unfortunately none of them are guarantees. All I can do is suggest methods I've found in existing games. To start with, I'll suggest Castlevania: Bloodlines (Mega Drive), and the achievement Watery Grave (5). There is a mild cheat-protection in these requirements, but I'll just focus on the 'demo mode' part. Castlevania treats every screen as a type of 'screen mode'. To test for this, I started the game, and at the sega logo, I started an 8-bit test. I then assumed that the 'screen mode' would have changed by the time it was playing the 'intro movie', so I did a 'not equal', then an 'equal' filter to suggest that I only want candidates that have changed. I did this again at the 'press start' screen, then at the options screen, then the password screen, character select screen, and finally ingame. </p> <p>By this point I had 10 matches. I mentally eliminated anything where the surrounding values were very random - this data is likely to be graphic or sound data, and won't be much use for us. After having repeated the test and watching each of these 10 values, I also eliminated a few more, as some of these appeared to change while I was still on the same screen. This left me with three values, <code>0x9002</code>, <code>0x9004</code> and <code>0x905e</code>. After going into game and playing for a few seconds, I could tell that <code>0x905e</code> was changing while I was still ingame. I opted to use <code>0x9002</code>, as it was located fairly close to clean boundary (<code>0x9000</code>). Also values like this are likely to be in the second half of RAM (between <code>0x8000</code> and <code>0xffff</code>) as they are easier for developers to address. </p>"},{"location":"Tips-and-Tricks-es/","title":"Tips y Trucos","text":""},{"location":"Tips-and-Tricks-es/#tips-en-la-busqueda-de-memoria","title":"Tips en la B\u00fasqueda de Memoria","text":"<p>Tambi\u00e9n mira: Un vistazo al Inspector de Memoria.</p> <ul> <li>Empieza con la vista de 8-bit en el Visor de Memoria. Buscar pedazos grandes de memoria solo complica las cosas, pero har\u00eda un trabajo mas f\u00e1cil para un desarrollador experimentado. Si tu estas empezando y no estas consciente de t\u00e9rminos como endianess y bit ordering (o cuando los ojos est\u00e1n cansados), es mejor hacer observaciones usando la vista de 8-bit. Es simplemente mas f\u00e1cil!</li> </ul> <ul> <li>Desmarca la casilla \"Show Decimal Values\" en el Editor de Logros (Achievement Editor) para as\u00ed poder introducir los valores hex que encuentres en el Visor de Memoria (Memory Viewer). Es mejor que estar utilizando una calculadora de programador!</li> </ul> <ul> <li>Si encuentras una variable, tambi\u00e9n busca en los alrededores de la misma podr\u00edas encontrar muchas variables utiles.</li> </ul> <ul> <li>Puedes introducir valores en el Visor de Memoria para ver si afectan al juego.</li> </ul> <ul> <li>Incluso si algo esta visiblemente decrementando en el juego, como la vida, la memoria podr\u00eda tener diferencias. Podr\u00eda ser posible que este incluso incrementando, as\u00ed que como es algo de lo que no estas del todo seguro, es preferible que utilices los filtros <code>!=</code> y <code>=</code>.</li> </ul> <ul> <li>Si tu absolutamente no puedes reducir los resultados de un filtro, puedes intentar adivinar algunos valores o m\u00ednimo como esta actuando ese valor (<code>&gt;</code> o <code>&lt;</code>). Por ejemplo, cero vida es usualmente <code>0</code>, Stage 1 es usualmente el valor <code>0</code>, Stage 2 es usualmente el valor <code>1</code> dependiendo el tipo de juego.</li> </ul> <ul> <li>Vista de 16/32 bit: Recuerda que cuando trabajas con variables de 16 o 32 bit las variables de la derecha son primero. Por Ejemplo: si en 8bit se mira de esta manera <code>AB CD WX YZ</code>, en 16 bit se convierte en <code>CDAB YZWX</code>. A esto se le llama \"ordenado de bits big endian\". Sin preocupaciones puedes ignorar esta platica geek, solamente recordando que las cosas se almacenan al rev\u00e9s en la vista de 16 bit y superiores.</li> </ul> <ul> <li>Bit fields: Utiliza single bits para cosas que solamente cambian en un bit. En el Inspector de Memoria (Memory Inspector), cuando una variable es seleccionada, vas a encontrar <code>Bits: 7 6 5 4 3 2 1 0</code> arriba de las variables. Y abajo de esos n\u00fameros va a ver ya sea un <code>0</code> o un <code>1</code>, as\u00ed como <code>0 0 1 0 0 0 1 1</code> en la imagen de abajo. Si <code>bit5</code> tiene un <code>1</code> arriba de el, entonces <code>bit3=1</code> para esa variable. El uso de Single bit es muy com\u00fan en un juego para items/eventos/desbloqueos/etc. Tal vez suene un poco confuso , pero es muy importante que lo entiendas. Algunos juegos con espacio en memoria muy limite usan los campos de bits (Bit fields) much\u00edsimo! Es una t\u00e9cnica importante de aprender.</li> </ul> <p></p>"},{"location":"Tips-and-Tricks-es/#tips-en-la-creacion-de-logros","title":"Tips en la Creaci\u00f3n de Logros","text":"<p>Tambi\u00e9n mira: Conceptos No-Bievenidos y Dise\u00f1o de Logros.</p> <ul> <li>Nunca Evita utilizar solo una condici\u00f3n lo mas que puedas. Cuando utilizas solo una condici\u00f3n el logro es muy probable que salga en el momento equivocado.  Este es el error mas com\u00fan de un desarrollador.</li> </ul> <ul> <li>Si el juego tiene un modo demo (El CPU juega despu\u00e9s que hubieras esperado un tiempo en la pantalla de titulo), percatate de buscar la variable para ello y agrega la condicion para que tus logros no salgan en modo demo. Tal vez necesites saber como se utiliza un PauseIf y ResetIf.</li> </ul> <ul> <li><code>PauseIf</code> cheat codes: Si el juego tiene un cheat code para incrementar vidas, seleccionar stages, etc. Percatate de encontrar las variables para ello y agregar alguna especie de protecci\u00f3n a tus logros.</li> </ul> <ul> <li>Si quieres crear un logro para colecciona un \u00edtem \u00fanico y especifico en el juego, agrega algunas condiciones para asegurarte que el jugador consigui\u00f3 el \u00edtem donde se supone que se tiene que conseguir, como en este ejemplo de aqu\u00ed. De otra manera podr\u00eda saltar utilizando un password, cargando un archivo de guardado, etc.</li> </ul> <ul> <li>Condiciones \u00d3: si necesitas condiciones \u00d3, vas a necesitar Alt groups.</li> </ul> <ul> <li>Evita el exceso de Logros. Si un juego tiene 100 levels, no hagas un logro por cada nivel. Haz cada 25 o parecido. Considera el tiempo en el que un jugador casual podr\u00eda desbloquear esos logros. Si generalmente puedes desbloquear todos los logros de un set de progreso en medio hora y siendo un jugador casual, eso es dise\u00f1o de puro relleno, y no es recomendable.</li> </ul> <ul> <li>Se Creativo y Divertido: Se lo mas creativo posible con tus logros. \"Vence a X sin utilizar/hacer Y\", \"Vence a X en 5 segundos\", \"p\u00e1sate el juego con solo 3 corazones\". Ten en mente que incluso el jugador casual puede sacarse todos los logros si pone su mejor esfuerzo. No es divertido para un jugador casual si es demasiado dif\u00edcil!  (Mira:  Tips para Sets Bonus mas abajo para retos de verdad!). Hay una pagina completa sobre Dise\u00f1o de Logros hay puedes conseguir buenas ideas para pensar en como hacer buenos logros.</li> </ul> <ul> <li>Glitchless, por favor!: No hagas logros donde requieras el uso de glitches. Glitches, en la mayor\u00eda de los casos, corrompen y destabilizan la RAM y memoria del juego. Para agregar b\u00e1sicamente rompen todo el set de logros. Por eso es, sabio agregar protecci\u00f3n a esto para as\u00ed detener a los jugadores de utilizarlos y conseguir los logros f\u00e1cilmente.</li> </ul> <ul> <li>Evita utilizar solamente texto y gr\u00e1ficas: La mayor\u00eda de las veces, un logro que requiere que pase cierto evento especial puede estar atado a una event flag (usualmente un single bit or byte), o a un objeto recibido por el jugador. Es mucho mejor utilizar estos valores que utilizar el ID de texto que se muestra en la caja de texto, o, mucho peor, RAM de v\u00eddeo (memoria atada a los gr\u00e1ficos que se muestran en pantalla) ya que muchas veces son menos estables. Especialmente en versiones diferentes del juego, y son mas dif\u00edciles de trabajar.</li> </ul> <ul> <li>Amamos el Arte:  Badges bonitos son badges que dan gusto conseguir! Tiene que representar visualmente el logro en si, o una pista de acuerdo a la ubicaci\u00f3n en el juego para evadir secretos.  Que est\u00e9n a la par con el estilo de arte del juego funciona muy bien.  Buscar en Google Im\u00e1genes \"Sprite Sheets\" es un tip muy \u00fatil para incluir arte del juego. Si eres un buen artista gr\u00e1fico, sera tu tiempo de brillar actualizando badges! Puedes encontrar mas informaci\u00f3n en la Pagina de Creaci\u00f3n de Badges e Iconos.</li> </ul>"},{"location":"Tips-and-Tricks-es/#tips-en-tu-estructura-gramatical","title":"Tips en tu estructura gramatical","text":"<ul> <li>No S\u00edmbolos: No utilizas caracteres de acentos/especiales como la <code>\u00e9</code> en Pokemon, ya que actualmente rompen algunas cosas (como el feed). Cambien no son visibles en la b\u00fasqueda si no se introduce el car\u00e1cter especial. Lo mismo para c\u00f3digos universales de Emoji UTF-8. Excepci\u00f3n Permitida: Scripts de Rich Presence.</li> </ul> <ul> <li>Cuida tu Ingles: evita errores ortogr\u00e1ficos. Como RetroAchievements es una comunidad internacional, utilizar el Ingles para las Notas de C\u00f3digo es una buena practica, ya que otro desarrollador puede utilizar tus notas en un futuro.</li> </ul>"},{"location":"Tips-and-Tricks-es/#trucos","title":"Trucos","text":""},{"location":"Tips-and-Tricks-es/#encontrando-la-variable-para-el-modo-demo","title":"Encontrando la variable para el Modo Demo","text":"<p>Un truco usual para empezar a filtrar valores para encontrar el Modo Demo es dejar que empieze y asi empezar a filtrar con <code>=</code> \"Last Known Value\" y presionar \"Filter\" suficiente veces, deteni\u00e9ndote una vez que el demo hubiera terminado (ten cuidado de no filtrar despu\u00e9s que se hubiera terminado el demo).</p> <p>Ahora empieza el juego de manera normal y cuando tengas control del personaje cambie el filtro a <code>!=</code> y filtra solo una vez. Los valores que se filtraron son los que cambiaron desde el modo demo.</p> <p>Ahora cambien el filtro de regreso a <code>=</code> y entonces inicia una secuencia de jugar-y-filtrar. Que significa juega un poco, mu\u00e9vete por el escenario, derrota algunos enemigos, y entonces filtra.</p> <p>Pro tip: Es muy muy muy \u00fatil tener estados de guardado (savestates) en diferentes niveles del juego, ya que puedes hacer lo de jugar-y-filtrar en diferentes escenarios y hacer el filtrado mas efectivo.</p> <p>Despu\u00e9s de conseguir algunas variables como resultado, por lo general el valor de demo es igual a <code>1</code> (algunas veces tambi\u00e9n es <code>ff</code>). Si encuentras una direcci\u00f3n potencial editala a <code>0</code> y checa si eres capaz de mover al personaje. Si s\u00ed, BINGO!, esa es la variable que estabas buscando.</p>"},{"location":"Tips-and-Tricks-es/#observador-de-variables-address-watcher","title":"Observador de Variables (Address Watcher)","text":"<p>Aqu\u00ed un truco f\u00e1cil utilizando un logro de prueba para observar si una variable tiene cambios, que es algo que tu vas a querer saber com\u00fanmente.</p> <p></p> <p>Condiciones Explicadas </p> <ol> <li><code>Valor 1 = Valor 0</code>; Esto es para prevenir que el logros jamas sea verdadero, ya que el valor 0 nunca va a ser igual a 1.</li> <li><code>Valor 1 = Valor 1</code>; Para que funcione este truco el logro necesita hits para que se resetee. Cuando 1 = 1 hits ser\u00e1n agregados a la condici\u00f3n.</li> <li><code>ResetIf Mem 0x10 != Delta 0x10</code>; Esta es la variable que quieres observar. Cada vez que hay un cambio el logro se va a reiniciar.</li> </ol> <ul> <li>Por ultimo checa que las casillas de <code>Pause on Reset</code> y <code>Active</code> est\u00e9n marcadas. Ahora vas a conseguir un pop-up y la emulaci\u00f3n se va a pausar cada vez que la variable cambie.</li> </ul>"},{"location":"Tips-and-Tricks-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-14 13:53] eldexterr:</code> Document Finished :)</li> <li><code>[2019-04-12 11:50] eldexterr:</code> Document isn\u00b4t finish</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/","title":"Dicas e Truques","text":"<p>Link para o texto em ingl\u00eas: Tips and Tricks</p>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-para-convencao-de-nomes","title":"Dicas para Conven\u00e7\u00e3o de Nomes","text":"<ul> <li>Sem s\u00edmbolos: N\u00e3o use caracteres acentuados / especiais como o \"\u00e9\" no Pok\u00e9mon, pois eles v\u00e3o bagun\u00e7ar algumas coisas (como o feed). Eles tamb\u00e9m n\u00e3o ser\u00e3o vis\u00edveis na pesquisa sem o caracter especial.</li> </ul> <ul> <li>Sem Emojis: N\u00e3o utilize os Universal Emoji codes da UTF-8 no nome das suas conquistas, pois a exibi\u00e7\u00e3o desses c\u00f3digos \u00e9 totalmente dependente da plataforma (i. E .: Mac OSX, Windows, Linux, iOS, Android e navegador).</li> </ul> <ul> <li>Preocupe-se com a gram\u00e1tica: evite erros de gram\u00e1tica. Como o RetroAchievements \u00e9 uma comunidade internacional, usar o ingl\u00eas para Code Notes \u00e9 uma boa pr\u00e1tica, pois outro desenvolvedor pode usar suas anota\u00e7\u00f5es no futuro. Se o ingl\u00eas n\u00e3o for o seu primeiro idioma, passar seus t\u00edtulos, nomes e notas de c\u00f3digo atrav\u00e9s de um corretor ortogr\u00e1fico ajudar\u00e1. \u00c9 um passo extra para aqueles que t\u00eam dificuldade com a l\u00edngua inglesa, mas o cuidado e a aten\u00e7\u00e3o refletem nas suas qualidades positivas como desenvolvedor.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-selecao-de-rom","title":"Dicas de sele\u00e7\u00e3o de ROM","text":"<ul> <li>Sele\u00e7\u00e3o de regi\u00e3o: Escolha as ROM lan\u00e7adas como <code>NTSC USA</code> se dispon\u00edveis, pois 60 FPS (Frames Per Second) \u00e9 uma experi\u00eancia de jogo mais suave. As ROMs lan\u00e7adas como <code>PAL European</code> s\u00e3o executados em 50 FPS, e devem ser evitados na maioria dos casos. As ROMs lan\u00e7adas como <code>NTSC Japan</code> tamb\u00e9m s\u00e3o executados em 60 FPS, mas s\u00f3 \u00e9 a melhor op\u00e7\u00e3o se o jogo for uma vers\u00e3o exclusiva do Jap\u00e3o. Recorrer a um jogo lan\u00e7ado como <code>PAL European</code> deve ser apenas em \u00faltimo caso (exclusivo para a Europa) e normalmente \u00e9 um n\u00famero muito seleto de jogos \u00fanicos da biblioteca inteira do console.</li> </ul> <ul> <li>Sem Mods: N\u00e3o use uma ROM com uma tela de inicializa\u00e7\u00e3o modificada / personalizada, como Mode7 e RisingSun, porque ela bagun\u00e7a a RAM.</li> </ul> <ul> <li>Sem trainers: N\u00e3o use uma ROM que inclua um recurso cheat integrado. Elas s\u00e3o frequentemente referidas com \"ROM trainers\". Elas n\u00e3o s\u00e3o oficiais e, de forma alguma s\u00e3o suportados pelo RetroAchievements.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-escavacao-de-memoria","title":"Dicas de escava\u00e7\u00e3o de mem\u00f3ria","text":"<ul> <li>Voc\u00ea pode inserir valores no Memory Inspector para ver se ele afeta algo no jogo.</li> </ul> <ul> <li>Se voc\u00ea encontrar um endere\u00e7o, procure tamb\u00e9m a mesma regi\u00e3o que o rodeia e voc\u00ea pode encontrar muitos outros endere\u00e7os \u00fateis.</li> </ul> <ul> <li>Mesmo que algo esteja visivelmente decrescente no jogo, como a sa\u00fade, o valor n\u00e3o est\u00e1 necessariamente diminuindo. \u00c9 poss\u00edvel que ele esteja aumentando, ent\u00e3o, como \u00e9 incomum para voc\u00ea saber com certeza, voc\u00ea deve apenas filtrar <code>!=</code> E <code>==</code>.</li> </ul> <ul> <li>Se voc\u00ea absolutamente n\u00e3o consegue reduzir os resultados de um filtro, voc\u00ea pode tentar adivinhar alguns valores ou pelo menos como o valor est\u00e1 atuando (<code>&gt;</code> ou <code>&lt;</code>). Por exemplo, geralmente nenhuma barra de energia \u00e9 <code>0</code>, o est\u00e1gio 1 geralmente \u00e9 o valor <code>0</code>, o est\u00e1gio 2 geralmente \u00e9 o valor <code>1</code>, dependendo do tipo de jogo. Outro exemplo, talvez cada segmento da sua energia tenha 4 barrinhas - Voc\u00ea deve procurar quando \"4\" vai para \"3\" quando voc\u00ea perde uma barrinha?</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-por-nivel-de-habilidade","title":"Dicas por n\u00edvel de habilidade","text":""},{"location":"Tips-and-Tricks-pt_BR/#nivel-1-facil","title":"N\u00edvel 1 - F\u00e1cil","text":"<p>Comece com a visualiza\u00e7\u00e3o de 8 bits no Memory Inspector. Olhar para grandes partes de mem\u00f3ria ir\u00e1 complicar as coisas, mas isso facilitar\u00e1 o trabalho de um desenvolvedor experiente. Se voc\u00ea est\u00e1 apenas come\u00e7ando e desconhece termos como endianess e bit ordering (ou quando o cansa\u00e7o bate), \u00e9 melhor fazer suas observa\u00e7\u00f5es na vis\u00e3o de 8 bits. \u00c9 mais f\u00e1cil!</p>"},{"location":"Tips-and-Tricks-pt_BR/#nivel-2-medio","title":"N\u00edvel 2 - M\u00e9dio","text":"<p>Big data (vista de 16 ou 32 bits): lembre-se de que ao adicionar um endere\u00e7o de 16 bits o endere\u00e7o \u00e0 direita vem primeiro.</p> <p>Exemplo: <code>AB CD WX YZ</code> em 8 bits torna-se<code>CDAB YZWX</code> em 16 bits.</p> <p>Isso \u00e9 chamado de \"ordena\u00e7\u00e3o de bytes big endian\". Voc\u00ea pode tranquilamente ignorar esse papo geek apenas lembrando que as coisas est\u00e3o armazenadas \"de tr\u00e1s pra frente\" na vista de 16 bits e acima.</p> <p>Lembre-se de que se voc\u00ea estiver vendo mem\u00f3ria em peda\u00e7os maiores, quando voc\u00ea destaca um valor, esse valor agora representa um \"peda\u00e7o\" de mem\u00f3ria de 16 ou 32 bits e n\u00e3o o endere\u00e7o de mem\u00f3ria de 8 bits que voc\u00ea pode estar procurando. Voc\u00ea precisar\u00e1 voltar para a vis\u00e3o de 8 bits e destacar a endere\u00e7o que te interessa, se voc\u00ea encontrar algo de 8 bits que pare\u00e7a interessante.</p>"},{"location":"Tips-and-Tricks-pt_BR/#nivel-3-avancado","title":"N\u00edvel 3 - Avan\u00e7ado","text":"<p>Adicionando suporte para os cores libretro Little Endian: N64-specific, na maioria das vezes, ao adicionar suporte para um core libretro LE ao seu set, os conceitos explicados anteriormente (N\u00edvel Intermedi\u00e1rio) se aplicam, com ordena\u00e7\u00e3o de bytes ligeiramente alteradas. O que \u00e9 visto como leg\u00edvel em 16 bits muda drasticamente no interior de um core LE.</p> <p>Exemplo: AB CD WX YZ primeiro pega os bits de A, vira-os como se estivessem olhando em um espelho; bits de B bits e vira-os; bits de C... etc, at\u00e9 Z, e ent\u00e3o se torna WXYZ ABCD com os bytes do seu \u00faltimo passo.</p> <p>Para adicionar o suporte LE, voc\u00ea estar\u00e1 escrevendo uma condi\u00e7\u00e3o do n\u00facleo falso (Mem 0x000001 = Mem 0x000001), copiando suas condi\u00e7\u00f5es originais n\u00e3o-LE com um 'PauseIf<code>na parte superior em uma Alt, copie as mesmas condi\u00e7\u00f5es para a outra. Ambos os 'PauseIf</code>s conter\u00e3o um cheque olhando para um endere\u00e7o de mem\u00f3ria que nunca muda para ver se o seu valor de 16 bits teve o seu pedido de bytes alterado (Pense nisso como \" <code>PauseIf</code> n\u00e3o estou no n\u00facleo LE\" e \"<code>PauseIf</code> eu sou\" nas condi\u00e7\u00f5es alt).</p> <p>Um funcionar\u00e1 se o jogador estiver executando em um n\u00facleo LE, o outro n\u00e3o. Em seguida, voc\u00ea executar\u00e1 a matem\u00e1tica que descrevi acima nos valores que voc\u00ea est\u00e1 procurando no \"<code>PauseIf</code>, n\u00e3o estou no LE core\" Alt, e atualizando-o.</p> <p>Confuso? Sim. \u00c9 por isso que a maioria dos iniciantes e desenvolvedores intermedi\u00e1rios n\u00e3o deve se preocupar.</p>"},{"location":"Tips-and-Tricks-pt_BR/#dicas-de-criacao-de-achievements","title":"Dicas de cria\u00e7\u00e3o de achievements","text":"<ul> <li>Nunca use / Evite usar apenas uma condi\u00e7\u00e3o, tanto quanto voc\u00ea puder. Ao usar apenas uma condi\u00e7\u00e3o, o achievement provavelmente ir\u00e1 aparecer na hora errada. Este \u00e9 o erro mais comum cometido por um desenvolvedor, resultando na justificativa \"Popped at the Wrong Time\" anexada nos Bug Tickets recebidos em RetroAchievements.org. Programe suas conquistas com robustez.</li> </ul> <ul> <li>PauseIf Demo Mode:  Se o jogo tiver um modo de demonstra\u00e7\u00e3o (AI joga o jogo depois de esperar um pouco na tela de t\u00edtulo), assegure-se de encontrar o endere\u00e7o para isso e adicione <code>mode != Demo</code> ou algo semelhante em suas conquistas.</li> </ul> <ul> <li>Reiniciar Acontece: Alguns emuladores enviam um valor espec\u00edfico para a RAM quando reiniciados / recarregados. \u00c9 apenas para o primeiro quadro, mas pode fazer com que os achievements disparem, ent\u00e3o voc\u00ea precisa se preparar para isso. Geralmente, \u00e9 um valor como o FF. Voc\u00ea pode ver o valor se voc\u00ea usar Frame Advance / Next Frame ao reiniciar o jogo.</li> </ul> <ul> <li>Limita\u00e7\u00f5es:  H\u00e1 um limite de 100 achievements, um teto de 400 pontos e um limite de caracteres para uma \u00fanica conquista (tente n\u00e3o colocar mais de 50 condi\u00e7\u00f5es em uma conquista, isso \u00e9 mais amor do que o RetroAchievements consegue lidar!).</li> </ul> <ul> <li>Alt groups (lado esquerdo do editor) s\u00e3o usados para \"ou\" condi\u00e7\u00f5es. O grupo Core est\u00e1 sempre l\u00e1 e deve sempre ser verdadeiro com pelo menos um grupo Alt sendo completamente verdadeiro para obter um achievement. O grupo inteiro \u00e9 a sua condi\u00e7\u00e3o \"ou\". Mais informa\u00e7\u00f5es sobre a p\u00e1gina  Achievement Logic Features page.</li> </ul> <ul> <li>Evite o spam de achievement. Se um jogo tiver 100 n\u00edveis, n\u00e3o fa\u00e7a um achievement para cada n\u00edvel. Fa\u00e7a a cada 25 ou mais. Geralmente, \u00e9 avaliado pela equipe de desenvolvimento da RA para codificar esses achievements do tipo \"Filler\". Se voc\u00ea pretende criar alguns desbloqueios progressivos desta maneira - as palavras: (\"F\u00e1cil\", \"M\u00e9dio\", \"Dif\u00edcil\") ajudar\u00e3o a coloc\u00e1-lo em contexto. Considere o segmento de tempo que um jogador casual desbloquearia esses achievements progressivos. Se, em geral, voc\u00ea poderia desbloquear tudo em um conjunto progressivo de achievements desta natureza em menos de meia hora como jogador casual, design de preenchimento e n\u00e3o recomendado.</li> </ul> <ul> <li>Seja criativo e divertido: Seja t\u00e3o criativo quanto poss\u00edvel com achievements. \"Beat X sem usar / fazer Y\", \"Beat X em 5 segundos\", \"3 heart run\". Certifique-se de que os jogadores ocasionais ainda podem obter estes com seu melhor esfor\u00e7o. N\u00e3o \u00e9 divertido se for muito dif\u00edcil para um jogador casual! (Veja: Dicas de b\u00f4nus abaixo para os desafios reais!). H\u00e1 uma p\u00e1gina inteira sobre Achievement Design que pode dar bons conselhos sobre como pensar sobre bons achievements.</li> </ul> <ul> <li>Glitchless, please!: N\u00e3o fa\u00e7a achievements que exijam falhas. As falhas, na maioria dos casos, corrompem e desestabilizam a mem\u00f3ria do jogo e a RAM. Eles quebram o resto do conjunto para incluir. No entanto, \u00e9 aconselh\u00e1vel codificar as paredes do bloco impedindo os jogadores de us\u00e1-los para obter um dom\u00ednio f\u00e1cil. Este \u00e9 um tema de muito debate no RA, uma vez que o achievement d\u00e1 uma falha de quebra do jogo \u00e0s vezes requer muita habilidade de jogador. Algumas falhas s\u00e3o poss\u00edveis apenas no console, algumas apenas em emulador. Por sua inconsist\u00eancia e instabilidade em rela\u00e7\u00e3o \u00e0 mem\u00f3ria, \u00e9 recomend\u00e1vel bloque\u00e1-los para proteger a integridade do seu conjunto e sua reputa\u00e7\u00e3o. (Este \u00e9 um problema excepcional em alguns jogos do GameBoy, onde o playground falou em seu caminho para a vit\u00f3ria foi prominente!)</li> </ul> <ul> <li>N\u00f3s amamos arte: Emblemas bonitos s\u00e3o emblemas gratificantes! Ele deve representar visualmente a realiza\u00e7\u00e3o em si, ou sugerir o local no jogo para os segredos. Corresponder ao estilo de arte do jogo funciona bem. O Google Image busca \"Sprite Sheets\" \u00e9 uma dica \u00fatil para incluir alguma arte do jogo. Se voc\u00ea \u00e9 um bom artista gr\u00e1fico, atualizar emblemas \u00e9 o seu tempo para brilhar! Mais informa\u00e7\u00f5es podem ser encontradas na Badge and Icon Creation page.</li> </ul> <ul> <li>Desmarque \"Show Decimal Values\" no Achievement Editor para que voc\u00ea possa inserir os valores hexadecimais que voc\u00ea v\u00ea no Visualizador de mem\u00f3ria. \u00c9 melhor do que usar a calculadora de um programador!</li> </ul> <ul> <li>16-bit segredos: Os requisitos de 16 bits n\u00e3o precisam ser usados em um n\u00famero par de RAM, eles podem ser usados adequadamente, mesmo que a visualiza\u00e7\u00e3o de 16 bits n\u00e3o o mostre corretamente. Ex: 0 1 2 3 4 5, em 16 bits geralmente \u00e9 visto como 10 32 54, mas se voc\u00ea come\u00e7ar o endere\u00e7o no 1 aqui em sua exig\u00eancia, \"21\" ser\u00e1 lido pela conquista, mesmo que seja de 16 bits A visualiza\u00e7\u00e3o no visor de mem\u00f3ria n\u00e3o est\u00e1 mostrando isso. Tamb\u00e9m funciona se \u00e9 o \u00faltimo endere\u00e7o na linha (come\u00e7ando em F, indo para 0). Esteja ciente de que, se voc\u00ea estiver codificando por n\u00facleos LE, voc\u00ea tamb\u00e9m precisar\u00e1 atualizar isso! Sempre deixe notas de c\u00f3digo descritivo para si ou para outra pessoa.</li> </ul> <ul> <li>Bit field segredos: Use bits simples (0-7) para coisas que apenas alteram um \u00fanico bit. No Memory Viewer, quando um endere\u00e7o \u00e9 selecionado, haver\u00e1 \"bits 0 1 2 3 4 5 6 7\" acima dos endere\u00e7os, e abaixo desses n\u00fameros ser\u00e3o \"0\" ou \"1\" como \"0 0 0 0 0 0 0 0 \"se bit3 tiver um 1 abaixo dele, bit3 = 1 para esse endere\u00e7o. O uso de um \u00fanico bit \u00e9 muito comum para eventos / desbloqueios de jogos / etc. Voc\u00ea vai querer usar estes em jogos onde voc\u00ea pode fazer coisas em diferentes ordens, di\u00e1logos, eventos, desbloqueios .. Se voc\u00ea verificar \"8 bits x = 7 \"e algu\u00e9m fez algo diferente, como saltar algo ou obter algo extra, seu valor de 8 bits provavelmente ser\u00e1 diferente porque os \u00fanicos bits dentro s\u00e3o diferentes e a conquista n\u00e3o ser\u00e1 desbloqueada, ent\u00e3o neste caso voc\u00ea verifique se h\u00e1 bits espec\u00edficos dentro o endere\u00e7o de 8 bits. Agora, se, por exemplo, os desbloqueios de itens usam todos os 8 bits do endere\u00e7o de 8 bits e voc\u00ea quer fazer \"desbloquear todos os itens\", voc\u00ea pode apenas fazer \"8 bits x = 0xff\" Isso pode ser confuso, mas \u00e9 muito importante para entender. Alguns jogos com espa\u00e7o de mem\u00f3ria limitado usam muito os campos de bits! \u00c9 uma t\u00e9cnica importante para aprender.</li> </ul>"},{"location":"Tips-and-Tricks-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2018-03-28 20:15] meleu:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 12:03] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 12:03] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-25 11:47] KingDice001:</code> Updated Tips and Tricks pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Tips and Tricks.pt_BR (markdown)</li> </ul>"},{"location":"Tips-and-Tricks/","title":"Tips and Tricks","text":"<ul> <li>Memory Digging Tips</li> <li>Achievement Creation Tips</li> <li>Naming Convention Tips</li> <li>Tricks<ul> <li>Finding the Address for Demo Mode</li> <li>Address Watcher</li> </ul> </li> </ul>"},{"location":"Tips-and-Tricks/#memory-digging-tips","title":"Memory Digging Tips","text":"<p>See also: Memory Inspector Overview.</p> <ul> <li>Start with 8-bit view in the Memory Viewer. Looking at larger chunks of memory will complicate things, but it will make a seasoned developer's job easier. If you're just starting out and unaware of terms like endianess and bit ordering (or when the eyes are tired), its best to make your observations in 8-bit view. Its just easier!</li> </ul> <ul> <li>Uncheck \"Show Decimal Values\" in the Achievement Editor so you can enter the hex values you see in the Memory Viewer. Its better than using a programmers calculator!</li> </ul> <ul> <li>If you find an address, also search the same region surrounding it and you could find many more useful addresses.</li> </ul> <ul> <li>You can input values in the memory viewer to see if it affects the game.</li> </ul> <ul> <li>Even if something is visibly decreasing in-game, like health, memory can behave differently. It's possible for it to be increasing, so since it's uncommon for you to know for sure, prefer the <code>!=</code> and <code>=</code> filters.</li> </ul> <ul> <li>If you absolutely cannot reduce the results of a filter, you can try guessing some values or at least how the value is acting (<code>&gt;</code> or <code>&lt;</code>). For example, no health is usually <code>0</code>, Stage 1 is usually value <code>0</code>, Stage 2 is usually value <code>1</code> depending on the type of game.</li> </ul> <ul> <li>16/32 bit view: remember that when working with 16 or 32 bit address the address to the right comes first. Example: if in 8bit it looks like <code>AB CD WX YZ</code>, in 16 bit it becomes <code>CDAB YZWX</code>. This is called \"big endian byte ordering\". You can safely ignore the geek-speak by just remembering things are stored backwards in 16 bit view and above.</li> </ul> <ul> <li>Bit fields: Use single bits for things that only change a single bit. In the Memory Inspector, when an address is selected, there will be <code>Bits: 7 6 5 4 3 2 1 0</code> above the addresses. And below those numbers will be either <code>0</code> or <code>1</code>, like <code>0 0 1 0 0 0 1 1</code> in the image below. If <code>bit5</code> has <code>1</code> under it, then <code>bit5=1</code> for that address. Single bit usage is very common for game items/events/unlocks/etc. This may be confusing, but it's very important to understand. Some games with limited memory space use bit fields a lot! Its an important technique to learn.</li> </ul> <p></p>"},{"location":"Tips-and-Tricks/#achievement-creation-tips","title":"Achievement Creation Tips","text":"<p>See also: Unwelcome Concepts and Achievement Design.</p> <ul> <li>Never Avoid using only one condition as much as you can. When using only one condition the achievement will most likely pop at the wrong time.  This is the most common error by a developer.</li> </ul> <ul> <li>If the game has a demo mode (AI plays the game after you wait a while on the title screen), make sure to find the address for it and add a condition so your achievements don't trigger in demo mode. You'll probably need to know how to use PauseIf and ResetIf.</li> </ul> <ul> <li><code>PauseIf</code> cheat codes: If the game has a cheat code to increase lives, select stages, etc. Make sure to find the addresses for it and add some kind of protection in your achievements.</li> </ul> <ul> <li>If you wanna create an achievement for collecting a specific and unique item in the game, add some conditions to make sure the player got the item where it is supposed to be obtained, like in this template here. Otherwise the achievement may trigger by using password, loading a save game, etc.</li> </ul> <ul> <li>OR conditions: if you need OR conditions, you'll need Alt groups.</li> </ul> <ul> <li>Avoid Achievement Spam. If a game has 100 levels, do not make an achievement for each level. Do every 25 or so. Consider the time segment a casual player would unlock these progressive Achievements in. If generally you could unlock all in a progressive set of Achievements of this nature in under half an hour as a casual player, that's filler design, and not recommended.</li> </ul> <ul> <li>Be Creative and Fun: Get as creative as possible with achievements. \"Beat X without using/doing Y\", \"Beat X in 5 seconds\", \"3 heart run\". Be sure casual players can still get these with their best effort. It isn't fun if its way too difficult for a casual player!  (See:  Bonus Set Tips below for the real challenges!). There is a whole page about Achievement Design that can give good advices on how to think about good achievements.</li> </ul> <ul> <li>Glitchless, please!: Do not make achievements requiring glitches. Glitches, in most cases, corrupt and destabilize game memory and RAM. They break the rest of the set to include. It is however, wise to code block walls stopping players from using them to get easy mastery.</li> </ul> <ul> <li>Avoid relying on text and graphics: Most of the time, an achievement that requires triggering a special event can be tied to an event flag (usually a single bit or byte), or to an item received by the player. It is better practice to use these values than to check the ID of text being displayed in a text box, or, even worse, video RAM (memory tied to the actual graphics displaying on the screen) as they are often less stable. Especially between different versions of a single game, and they are more difficult to debug.</li> </ul> <ul> <li>We love Art:  Pretty badges are rewarding badges! It should visually represent the achievement itself, or hint at the location in the game for secrets.  Matching to the game's art style works well.  Google Image searches for \"Sprite Sheets\" is an useful tip to include some game art. If you're a good graphics artist, updating badges is your time to shine! More info can be found at the Badge and Icon Creation page.</li> </ul> <ul> <li>Regional Consideration: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions making multi-region support difficult.</li> </ul>"},{"location":"Tips-and-Tricks/#naming-convention-tips","title":"Naming Convention Tips","text":"<ul> <li>No Symbols: Do not use accented/special characters like the <code>\u00e9</code> in Pokemon, as they currently break a few things (like feed). They are also not visible in search without the special character. Same for UTF-8 Universal Emoji codes. Allowed exception: Rich Presence Scripts.</li> </ul> <ul> <li>Mind your English: avoid grammar mistakes. As RetroAchievements is an international community, using English for Code Notes is a good practice, as another developer can use your notes in the future.</li> </ul>"},{"location":"Tips-and-Tricks/#tricks","title":"Tricks","text":""},{"location":"Tips-and-Tricks/#finding-the-address-for-demo-mode","title":"Finding the Address for Demo Mode","text":"<p>An usual trick to start filtering addresses to find the Demo Mode is to let the demo begin and then start to filter <code>=</code> \"Last Known Value\" and press \"Filter\" many times, stopping right before the demo ends (be careful to not filter after the demo ends).</p> <p>Now start the game normally and when you're able to control the character change the filter to <code>!=</code> and then filter one single time. The filtered addresses are the ones that has changed since the demo mode.</p> <p>Now change the filtering back to <code>=</code> and then start a sequence of play-and-filter. Which means play a bit, move around then scenario, defeat some enemies, and then filter.</p> <p>Pro tip: It is very very very useful to have savestates in different levels of the game, so you can do the play-and-filter in different scenarios and make the filtering more effective.</p> <p>After getting a few addresses as result, quite often the demo value will be <code>1</code> (sometimes it's also <code>ff</code>). If you find a potential address edit it to <code>0</code> and check if you become able to control the character. If yes, BINGO!, that's the address you're looking for.</p>"},{"location":"Tips-and-Tricks/#address-watcher","title":"Address Watcher","text":"<p>Here's an easy trick using a dummy achievement to watch an address for any changes, which is something you'll quite often want to know.</p> <p></p> <p>Conditions Explained </p> <ol> <li><code>Value 1 = Value 0</code>; This is to prevent the achievement from ever being true, as the value 0 never equals 1.</li> <li><code>Value 1 = Value 1</code>; For this trick to work the achievement needs hits to reset. When 1 = 1 hits will be added to this condition.</li> <li><code>ResetIf Mem 0x10 != Delta 0x10</code>; This is the address you want to watch. Any time there is a change the achievement will reset.</li> </ol> <ul> <li>Last of all make sure that <code>Pause on Reset</code> and <code>Active</code> are both checked. Now you will get a pop-up and emulation will pause each time this address changes.</li> </ul>"},{"location":"Tips-and-Tricks/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:26] televandalist:</code> Updated Tips and Tricks (markdown)</li> <li><code>[2023-06-03 02:06] televandalist:</code> Updated Tips and Tricks (markdown)</li> <li><code>[2021-11-30 18:30] SporyTike:</code> Typo that caused a jr-dev confusion. Bit5 = Bit5 and not Bit3</li> <li><code>[2019-08-13 19:42] Kvon:</code> Tips and Tricks: Text hooks tip added</li> <li><code>[2019-02-07 14:57] meleu:</code> decrease verbosity; add trick fo find demo mode; group tips and tricks more reasonably</li> <li><code>[2019-01-17 11:19] meleu:</code> removed the \"Limitations\" topic</li> <li><code>[2019-01-17 11:17] meleu:</code> subnests on bullet points need 4 spaces</li> <li><code>[2019-01-15 19:15] Jamiras:</code> Update reset behavior for 0.75 toolkit</li> <li><code>[2019-01-13 16:20] Rapha\u00ebl Zumer:</code> Add \"Avoid relying on text and graphics\" tip</li> <li><code>[2019-01-13 15:41] Rapha\u00ebl Zumer:</code> Fix typos and reword a memory digging tip</li> </ul>"},{"location":"Trigger-Flag/","title":"Trigger Flag","text":"<p><code>Trigger</code> marks one or more conditions in an achievement as the logic that is expected to be the final logic to become true which causes the achievement to trigger. This allows the runtime to know when an achievement is about to trigger, so a challenge indicator can be shown on the screen.</p> <p>When all conditions that must be true for the achievement to trigger are true except those marked with the <code>Trigger</code> flag, the achievement will become Primed. It will remain Primed as long as all of the previous conditions remain true, or until the achievement triggers or is deactivated.</p> <p>This functionality allows putting indicators on the screen to help players know when a challenge is active, or more importantly, when they fail the challenge. </p> <p>A prime example would be for a damageless boss fight. The <code>Trigger</code> flag would be put on the \"boss is dead\" condition. When all other conditions are true (ex: in boss fight, boss at full hp (HitCount 1), not demo), the challenge indicator would be displayed. If the player takes damage, the HitCount on the \"boss at full hp\" condition would get reset, and the challenge indicator would go away.</p> <p>Trigger should not be used if the player is not attempting a challenge. Achievements that would be earned without any additional effort from the player don't need to tell the player they're about to be earned.</p> <p>Up to eight challenge indicators can be shown at one time (though rarely more than one or two should be). If indicators and leaderboard trackers are both visible, the tracker will appear above the indicators.</p>"},{"location":"Trigger-Flag/#interaction-with-pauseif","title":"Interaction with PauseIf","text":"<p>If the achievement is Paused while Primed, the indicator will become hidden.</p> <p>If it is Paused before it is Primed, the indicator will not be shown at all until the achievement is unpaused.</p> <p>When the achievement becomes unpaused, the indicator may be displayed or hidden depending on the state of the non-Trigger conditions.</p>"},{"location":"Trigger-Flag/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-09-10 11:52] Jamiras:</code> Updated Trigger Flag (markdown)</li> <li><code>[2021-06-29 08:18] Chris:</code> update interaction w/ pauseif to latest (0.79.2) integration</li> <li><code>[2021-04-30 12:07] Jamiras:</code> Created Trigger Flag (markdown)</li> </ul>"},{"location":"Unwelcome-Concepts/","title":"Unwelcome Concepts","text":"<ul> <li>Unwelcome Concepts</li> <li>Unwelcome Game Types</li> <li>Rich Presence Restrictions</li> <li>Banned Titles</li> </ul>"},{"location":"Unwelcome-Concepts/#unwelcome-concepts","title":"Unwelcome Concepts","text":"<p>You can and should always be as creative as you can be, but there are some concepts that are NOT welcome for achievements. Below is a list of what have been deemed unwelcome concepts. Please note that there is some wiggle room so some exceptions to the rules have been provided. When in doubt, consult with Developer Compliance.</p> <ul> <li>Achievement Spam</li> <li>Playing Poorly Without Purpose</li> <li>Zero Effort Without Purpose</li> <li>Requires Glitches</li> <li>Requires Two Players</li> <li>Requires Complete Perfection</li> <li>Pointless Excessive Grinding</li> <li>Overly RNG Reliant</li> <li>\"Secret\" Achievements</li> </ul>"},{"location":"Unwelcome-Concepts/#achievement-spam","title":"Achievement Spam","text":"<p>It is bad design to have achievements popping too frequently. An example of this is unlocking achievements for both defeating a boss as well as obtaining a specific item after the fight. </p> <p>When these are acceptable:</p> <ul> <li>Using the above example: If the achievement for defeating the boss is challenge-based, such as damageless. It is not a guaranteed unlock simply by playing.</li> <li>If the achievements are stackable.<ul> <li>Defeating a boss on normal or higher difficulty + defeating the same boss on hard difficulty.</li> <li>Opening the last chest in an area + opening all chests in the game</li> </ul> </li> </ul>"},{"location":"Unwelcome-Concepts/#playing-poorly-without-purpose","title":"Playing Poorly Without Purpose","text":"<p>Achievements for dying, getting a game over, or repeatedly failing a task just for the sake of it are unnecessary. </p> <p>When these are acceptable: - Many point-and-click adventure games and visual novels often tie a player's death into the story, which can result in unique scenes a player would not witness otherwise. - If playing poorly results in a humorous or otherwise interesting in-game acknowledgement such as being awarded a helmet for taking too many head shots.</p>"},{"location":"Unwelcome-Concepts/#zero-effort-without-purpose","title":"Zero Effort Without Purpose","text":"<p>Examples of this are achievements for simply starting a game, collecting a single coin, watching a video, etc.</p> <p>When these are acceptable:</p> <ul> <li>\"Disclaimer\" achievements that are meant to address the player about restrictions in the achievement sets. These should only exist when the player can lock themselves out of multiple achievements without even realizing it.</li> <li>Not skipping an opening cinematic if it had been considered a big deal at the time.</li> <li>Addressing something fun, historical, or interesting.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-glitches","title":"Requires Glitches","text":"<p>Achievements for performing tasks that are only possible by using glitches, exploiting bugs, etc. are not allowed in a base set. Glitches/Bugs are errors within a game's code which often cause unintended behavior. Examples are memory overflow, incorrectly loaded levels, and clipping into objects.</p> <p>When these are acceptable:</p> <ul> <li>Historically significant glitches and well-known, easy-to-execute glitches of importance to the game's community are allowed with the approval of Developer Compliance. It should be clear that the glitch is needed for the achievement(s) and serve to highlight the glitch's importance or significance.<ul> <li>Achievements including approved glitches must require the player to perform some feat using the glitch. Simply causing the glitch to occur without purpose is insufficient unless activating the glitch itself is a meaningful task.</li> </ul> </li> <li>A <code>[Subset - Glitch Showcase]</code> or <code>[Subset - Bonus]</code>.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-two-players","title":"Requires Two Players","text":"<p>Achievements that require input from at least one other player are not allowed in a base set.</p> <p>When these are acceptable:</p> <ul> <li><code>[Subset - Multi]</code> sets.</li> </ul>"},{"location":"Unwelcome-Concepts/#requires-complete-perfection","title":"Requires Complete Perfection","text":"<p>Section Pending</p>"},{"location":"Unwelcome-Concepts/#pointless-excessive-grinding","title":"Pointless Excessive Grinding","text":"<p>Achievements that require long, repetitive tasks solely for the sake of saying you did it. If an achievement calls for spending countless hours making a character reach level 99 or farming for 99 of a certain item, but there is no actual purpose to it, then it does not have a place in a base set. </p> <p>When these are acceptable:</p> <ul> <li>Subsets, whether devoted to max levels (if approved) or a typical Bonus set.</li> <li>The player is awarded in-game for the grind.</li> </ul>"},{"location":"Unwelcome-Concepts/#overly-rng-reliant","title":"Overly RNG Reliant","text":"<p>Rely entirely on randomness, especially when there are extremely low odds. </p> <p>When these are acceptable: Games or mini-games where the randomness is a major aspect.</p>"},{"location":"Unwelcome-Concepts/#secret-achievements","title":"\"Secret Achievements\"","text":"<p>When the player has no indication of what they're going after.</p> <p>When these are acceptable:</p> <ul> <li>Secretive or intentionally vague achievement descriptions can be used to prevent major spoilers, so long as the achievements are unmissable progression. </li> </ul>"},{"location":"Unwelcome-Concepts/#unwelcome-game-types","title":"Unwelcome Game Types","text":"<p>Let's face it. There are some games, or 'games,' rather, that are not fit for achievements. Below is a list of said types of games that are usually not.</p> <ul> <li>Games That Lack Gameplay</li> <li>Compilations and Multi-Carts</li> <li>Betas, Demos, and Prototypes</li> </ul>"},{"location":"Unwelcome-Concepts/#games-that-lack-gameplay","title":"Games That Lack Gameplay","text":"<ul> <li>Videos, music visualizers, jukeboxes, etc.<ul> <li>These will not be accepted without explicit approval. Approval will be handled via voting by Developer Compliance and requires implementation of sufficiently creative concepts. For example: Game Boy Advance Video Series was presented with the idea to include a leaderboard quiz at the end of each episode. This unique plan involved gameplay beyond just pressing start and was approved.</li> </ul> </li> <li>Book sets are still allowed, but must be worth 0 points.</li> </ul>"},{"location":"Unwelcome-Concepts/#compilations-and-multi-carts","title":"Compilations and Multi-Carts","text":"<p>If a compilation or multi-cart features games that share the same console, then they are not allowed. An example of this is 6-Pak for Genesis/Mega Drive, which contains six Genesis/Mega Drive games.</p>"},{"location":"Unwelcome-Concepts/#betas-demos-and-prototypes","title":"Betas, Demos, and Prototypes","text":"<p>If the game ended up having an official release, then these are generally not allowed unless there is unique content. Games that only existed as betas, demos, or prototypes are typically fine, so long as they're actually playable (some prototypes barely qualify).</p>"},{"location":"Unwelcome-Concepts/#rich-presence-custom-name-restriction","title":"Rich Presence Custom Name Restriction","text":"<p>Rich Presence that directly displays custom player input text is prohibited.  The most common example being displaying what a player inputs as their character or file name directly into Rich Presence.</p> <p>This restriction helps in preventing inappropriate or offensive content from showing on various site pages as well as makes the moderation of Rich Presence more manageable, in addition to protection player privacy as players may not realize their text is being displayed publicly.</p>"},{"location":"Unwelcome-Concepts/#banned-titles","title":"Banned Titles","text":"<p>We generally avoid banning titles, leaving content filtering up to individual users to decide. Even still, some titles are egregious enough to warrant removal from the site, both for the protection of the users and of the site itself. Below is an incomplete list of such titles, to be updated as necessary.</p> Title Year Platform \u2022 Lolita Syndrome\u2022 \u30ed\u30ea\u30fc\u30bf\u30fb\u30b7\u30f3\u30c9\u30ed\u30fc\u30e0 1983 FM-7, PC-88 \u2022 My Lolita\u2022 \u30de\u30a4\u30fb\u30ed\u30ea\u30fc\u30bf 1984 FM-7, PC-88 \u2022 The Guy Game 2004 PS2, Xbox, Windows"},{"location":"Unwelcome-Concepts/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-26 08:49] The Mystical One:</code> Updated Unwelcome Concepts (markdown)</li> <li><code>[2024-01-26 08:46] The Mystical One:</code> Added Rich Presence Custom Name Restriction section.</li> <li><code>[2023-06-30 11:03] The Mystical One:</code> Added Developer Compliance contact links.</li> <li><code>[2023-06-28 15:10] The Mystical One:</code> Added in the clarification that an approved glitch should be for accomplishing something with the glitch.</li> <li><code>[2023-06-12 18:27] meleu:</code> fix list formats so mkdocs can render them properly</li> <li><code>[2023-06-05 21:10] televandalist:</code> Added Demos to \"Betas, Demos, and Prototypes\" - Added a link to GBA Video Series - Added quick links to the sections under unwelcome game types -</li> <li><code>[2023-06-02 20:33] televandalist:</code> Updated WIP Unwelcome Concepts (markdown)</li> </ul>"},{"location":"Useful-Links/","title":"Useful Links","text":""},{"location":"Useful-Links/#httpsgamefaqsgamespotcom","title":"https://gamefaqs.gamespot.com/","text":"<p>Great place to find game guides, finding almost all you could want to know about game content, find cheat codes, for development utility and also for making proper protections against the codes.</p>"},{"location":"Useful-Links/#httpswwwvgmapscom","title":"https://www.vgmaps.com/","text":"<p>Thousands of maps/screenshots of your favourite video games.</p>"},{"location":"Useful-Links/#httpstcrfnet","title":"https://tcrf.net/","text":"<p>It is a site dedicated to unearthing and researching unused and cut content from video games. From debug menus, to unused music, graphics, enemies, or levels, many games have content never meant to be seen by anybody but the developers \u2014 or even meant for everybody, but cut due to time/budget constraints.</p>"},{"location":"Useful-Links/#cumulative-probability-calculator","title":"Cumulative Probability Calculator","text":"<p>When working with achievements with an RNG factor you will often want to know the probability of success for players given a number of attempts. (see unwelcome concepts, achievements with low odds). Use it to calculate P(X&gt;=1), assuming the player needs to succeed only once across several attempts, to estimate how many attempts an might require for less lucky players.</p>"},{"location":"Useful-Links/#httpswwwzapstudionetframecalc","title":"https://www.zapstudio.net/framecalc/","text":"<p>Simple utility to calculate frames out of time given and the other way around.</p>"},{"location":"Useful-Links/#httpswwwromhackingnet","title":"https://www.romhacking.net","text":"<p>The biggest repository of patches to hack ROMs. </p>"},{"location":"Useful-Links/#httpdatacrystalromhackingnetwikihashes","title":"http://datacrystal.romhacking.net/wiki/Hashes","text":"<p>Explains what hashes are. If you don't know what they are you should probably read this.</p>"},{"location":"Useful-Links/#httpsemn178githubioonline-toolscrc32_checksumhtml","title":"https://emn178.github.io/online-tools/crc32_checksum.html","text":"<p>Drag and drop checksum checker utility. You can also get the checksum from the rom you have loaded from the retroachievements menu in the emulators.</p>"},{"location":"Useful-Links/#httpwwwmarcrobledocomrompatcherjs","title":"http://www.marcrobledo.com/RomPatcher.js","text":"<p>An online ROM patcher utility.</p>"},{"location":"Useful-Links/#httpjsonviewerstackhu","title":"http://jsonviewer.stack.hu","text":"<p>Excellent for viewing raw achievements</p>"},{"location":"Useful-Links/#httpgamehackingorg","title":"http://gamehacking.org","text":"<p>Provides many Pro Action, Game Genie, and Game Shark codes which can be converted to RAW addresses on the site. </p>"},{"location":"Useful-Links/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-12-29 12:34] meleu:</code> add https://www.zapstudio.net/framecalc/</li> <li><code>[2019-01-29 14:15] Kvon:</code> added the Cumulative Probability Calculator link</li> <li><code>[2019-01-07 12:14] meleu:</code> added vgmaps.com</li> <li><code>[2018-12-06 20:20] televandalist:</code> Added gamehacking.org - I use the site a lot and always recommend it to people looking for addresses. - tele</li> <li><code>[2018-10-11 00:21] CoolCanuck:</code> gamefaqs.com -&gt; gamefaqs.gamespot.com</li> <li><code>[2018-05-03 11:53] meleu:</code> better format, making the URLs appear on the ToC after mkdocs conversion</li> <li><code>[2018-04-28 22:31] meleu:</code> Updated Useful Links (markdown)</li> <li><code>[2018-04-28 19:03] magusLOGS:</code> added tcrf.net</li> <li><code>[2018-04-28 13:48] meleu:</code> Created Useful Links (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct-es/","title":"C\u00f3digo de Conducta de los Usuarios","text":""},{"location":"Users-Code-of-Conduct-es/#nuestros-estandares","title":"Nuestros Est\u00e1ndares","text":"<p>Nosotros queremos un entorno abierto, positivo y acogedor. </p> <p>Ejemplos de comportamientos que contribuyen a crear un entorno positivo incluyen: </p> <ul> <li>Usar lenguaje acogedor e inclusivo. </li> <li>Ser respetuoso sobre diferentes puntos de vista y experiencias. </li> <li>Aceptar critica constructiva con gracia. </li> <li>Enfocarse en lo que es mejor para la comunidad. </li> <li>Mostrar empat\u00eda hacia otros miembros de la comunidad. </li> </ul> <p>Ejemplos de comportamientos inaceptables de parte de los participantes incluyen: </p> <ul> <li>Postear enlaces de descarga a sitios donde otros pueden descargar ROMs ilegales. </li> <li>Hacer trampas: No est\u00e1 permitido usar trucos a menos que sea especificado en la descripci\u00f3n del Logro, o en el comentario de la pagina del Logro. Incluyendo trucos en el juego, que existen en su consola originaria, est\u00e1n considerados como trampa si no han sido especificados. Las cuentas a las que se les evidencie hayan usado trampas, se les dar\u00e1 el estatus de \"Untracked\". </li> <li>Intentar irrumpir intencionalmente la estabilidad de la comunidad: Incitando cacer\u00edas-de-bruja, influenciar conductas, o generar drama, donde ese tipo de argumentos y desacuerdos deber\u00edan ser llevados a cabo en privado. </li> <li>Troleo excesivo, insultos/comentarios despectivo, y ataques personales o pol\u00edticos. </li> <li>El uso de im\u00e1genes con contenido sexual, y atenciones o insinuaciones sexuales molestas. </li> <li>Acoso publico o privado. </li> <li>Publicar informaci\u00f3n privada de otro, tales como direcci\u00f3n f\u00edsica o electr\u00f3nica, sin su explicito permiso. </li> </ul>"},{"location":"Users-Code-of-Conduct-es/#responsabilidades-de-los-administradores","title":"Responsabilidades de los Administradores","text":"<p>Los administradores tienen el derecho y la responsabilidad de remover, editar, o denegar comentarios, Logros, Medallas, posteos en el foro, y otras contribuciones que no est\u00e1n alineadas a este C\u00f3digo de Conducta, o el banear temporal o permanentemente a cualquier participante por otros comportamientos que ellos consideren inapropiados, amenazantes, ofensivos, o da\u00f1inos. Cu\u00e1ndo el comportamiento inapropiado no es muy claro, los administradores discutir\u00e1n entre ellos que acci\u00f3n deber\u00e1 ser tomada. </p> <p>Los administradores que no sigan o impongan el C\u00f3digo de Conducta en buena fe pueden enfrentar repercusiones temporales o permanentes como lo sera determinado por otros miembros lideres del proyecto. </p>"},{"location":"Users-Code-of-Conduct-es/#reportando","title":"Reportando","text":"<p>Instancias de abuso, acoso, trampa o de otro modo comportamientos inaceptables deber\u00e1n ser reportados contactando al equipo de moderadores de RetroAchievements en el Servidor de Discord (usuarios con nombres en azul). Tambi\u00e9n puedes contactar a todos los administradores/moderadores activos enviando un Mensaje Privado al usuario RAdmin en el sitio oficial. </p> <p>Las quejas ser\u00e1n evaluadas, investigadas y respondidas cuando la circunstancia lo amerite.</p>"},{"location":"Users-Code-of-Conduct-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-17 09:12] ShinyNinetalesTM:</code> fixed some inaccuracies</li> <li><code>[2019-02-14 10:09] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:14] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-04 10:34] meleu:</code> Updated Users Code of Conduct es (markdown)</li> <li><code>[2018-05-04 10:03] meleu:</code> added a title to make it look better after mkdocs conversion</li> <li><code>[2018-04-20 18:31] ShinyNinetalesTM:</code> Changed \"cazerias\" to the correct word \"cacer\u00edas\", and changed \"derrogantes\" to \"despectivos\" (derrogantes doesn't exist at all in spanish language). Also, removed an extra n in \"deber\u00edan\" and changed \"der\" to \"ser\"</li> <li><code>[2018-03-24 11:30] meleu:</code> Updated Codigo de Conducta de los usuarios (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/","title":"Users Code of Conduct fr","text":"<ul> <li>Mission</li> <li>R\u00e8gles     - Version courte     - Version longue     - Libert\u00e9 d'expression</li> <li>Comment fonctionne la mod\u00e9ration     - Que faire si vous pensez que la mod\u00e9ration a commis une erreur ?</li> <li>Tricherie</li> <li>FAQ</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#mission","title":"Mission","text":"<p>Le projet RetroAchievements a pour objectif de fournir les outils n\u00e9cessaires \u00e0 la cr\u00e9ation de succ\u00e8s pour les jeux r\u00e9tro et \u00e0 leur mise en valeur. Nous aspirons \u00e0 promouvoir une communaut\u00e9 saine ax\u00e9e sur la collaboration autour de cette passion. Toute cr\u00e9ation est pens\u00e9e pour \u00eatre gratuite et ne fera jamais l'objet de profits de notre part.</p>"},{"location":"Users-Code-of-Conduct-fr/#regles","title":"R\u00e8gles","text":"<p>Il y a beaucoup de joueurs r\u00e9tro \u00e0 travers le globe appartenant \u00e0 de nombreuses cultures diff\u00e9rentes, aux points de vue et opinions vari\u00e9s. C'est pourquoi, afin de garantir un environnement sain \u00e0 la communaut\u00e9 pour partager cette passion commune des jeux r\u00e9tro, il nous faut nous doter de certaines r\u00e8gles.</p>"},{"location":"Users-Code-of-Conduct-fr/#version-courte","title":"Version courte","text":"<p>Cette version courte devrait suffir \u00e0 la plupart des gens :</p> <ol> <li>Ne soyez pas imb\u00e9cile ou odieux - personne n'aime les trolls.</li> <li>N'utilisez pas notre site Internet ou notre serveur Discord pour partager du mat\u00e9riel faisant l'objet de droits d'auteur ou des informations permettant de le t\u00e9l\u00e9charger.</li> <li>Respectez les th\u00e9matiques de chaque canal Discord et chaque forum du site Internet (nous mettons \u00e0 disposition des sections hors sujet). </li> <li>Quand un mod\u00e9rateur ou un administrateur vous demande de vous arr\u00eater, vous devez vous arr\u00eater.</li> <li>Quand vous avez un doute, posez la question \u00e0 un @mod de Discord ou envoyez un message \u00e0 RAdmin sur le site Internet..</li> </ol>"},{"location":"Users-Code-of-Conduct-fr/#version-longue","title":"Version longue","text":"<p>Si la Version courte n'est pas assez d\u00e9taill\u00e9e pour vous, en voici une plus d\u00e9taill\u00e9e :</p>"},{"location":"Users-Code-of-Conduct-fr/#exemple-de-comportement-attendu","title":"Exemple de comportement attendu","text":"<ul> <li>Se concentrer sur le bien de la communaut\u00e9.</li> <li>Faire preuve d'empathie envers les autres membres de la communaut\u00e9.</li> <li>Faire preuve de respect lorsqu'on exprime son point de vue.</li> <li>Accepter gracieusement les critiques constructives et respectueuses.</li> <li>D\u00e9noncer aux mod\u00e9rateurs et ou administrateurs les situations o\u00f9 les r\u00e8gles ont \u00e9t\u00e9 viol\u00e9es.</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#comportement-socialement-inacceptables","title":"Comportement socialement inacceptables","text":"<ul> <li>Demander ou fournir des liens pour t\u00e9l\u00e9charger du mat\u00e9riel faisant l'objet de droits d'auteur.</li> <li>Spammer ou tenter de vandaliser le serveur Discord ou le site Internet par quelque mani\u00e8re que ce soit. </li> <li>Proposer des produits publicitaires, services ou d'autres serveurs Discord sans approbation.</li> <li>Sectarisme : ce qui inclut le racisme, le sexisme, l'\u00e9litisme, l'intol\u00e9rance, les attaques au sujet de la nationalit\u00e9 de quelqu'un, sa religion, ses orientations sexuelles ou ses ob\u00e9diences politiques, etc.</li> <li>Harc\u00e8lement public ou priv\u00e9.</li> <li>Diffamation au sens de fausses d\u00e9clarations concernant une personne et qui pourraient salir sa r\u00e9putation.</li> <li>Menaces de violences.</li> <li>Avances sexuelles importunes.</li> <li>Poster de la pornographie au sens de toute image ou description d'un comportement \u00e9rotique sens\u00e9 stimuler quelqu'un sexuellement.</li> <li>Poster des images horribles ou gores dans le but de d\u00e9go\u00fbter.</li> <li>Publier les informations personnelles de quelqu'un comme une photo ou l'adresse \u00e9lectronique, sans son accord explicite.</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#comportement-tres-mal-vu","title":"Comportement tr\u00e8s mal vu","text":"<ul> <li>Argumentation publique agressive.</li> <li>Trop de posts de merde.</li> <li>Attaques personnelles au sens de faire des remarques abusives concernant une personne plut\u00f4t que des remarques factuelles.</li> </ul> <p>Les mod\u00e9rateurs interviendront pour calmer le jeu s'il leur semble que la situation commence \u00e0 d\u00e9raper. Consulter ci-dessous Comment fonctionne la mod\u00e9ration.</p>"},{"location":"Users-Code-of-Conduct-fr/#liberte-dexpression","title":"Libert\u00e9 d'expression","text":"<p>Si vous souhaitez juste vous d\u00e9fouler en d\u00e9versant des commentaires p\u00e9joratifs sur notre mani\u00e8re de mener le projet, vous \u00eates libre de le faire. Mais dans la mesure o\u00f9 cela g\u00e9n\u00e8re une d\u00e9motivation et une perte de temps de nos volontaires, nous n'en voulons ni sur nos forums et ni sur notre serveur Discord. Il existe beaucoup d'autres options sur Internet pour le faire.</p> <p>Gardez \u00e0 l'esprit que RetroAchievements.org n'est pas un bastion de la libert\u00e9 d'expression.</p> <p>Si vous avez des critiques \u00e0 formuler, nous serons heureux de les \u00e9couter pour autant qu'elles soient faites de mani\u00e8re respectueuse.</p>"},{"location":"Users-Code-of-Conduct-fr/#comment-fonctionne-la-moderation","title":"Comment fonctionne la mod\u00e9ration","text":"<p>Si vous avez le sentiment qu'une mod\u00e9ration est n\u00e9cessaire, contactez un @mod sur notre serveur Discord ou adressez votre probl\u00e8me \u00e0 RAdmin, une adresse partag\u00e9e par tous les mod\u00e9rateurs.</p> <p>La mission des mod\u00e9rateurs est de s'assurer que tous les utilisateurs respectent le code de conduite des utilisateurs.</p> <p>Que fait un mod\u00e9rateur s'il constate une violation du code de conduite :</p> <ol> <li> <p>Un rappel \u00e0 l'ordre formel et diplomatique (ni sarcasme ni ton mena\u00e7ant).</p> </li> <li> <p>Si le rappel \u00e0 l'ordre est ignor\u00e9, le contrevenant sera renvoy\u00e9 du notre serveur Discord.</p> </li> <li> <p>Si le contrevenant continue d'ignorer la mod\u00e9ration, il sera alors banni de notre serveur Discord. S'il avait le r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet, ses privil\u00e8ges seront r\u00e9voqu\u00e9s.</p> </li> </ol> <p>Note: sur le site Internet, il n'y a pas de \"renvoi\". Si le contrevenant ignore le rappel \u00e0 l'ordre, c'est directement le bannissement.</p> <p>Si vous avez fait l'objet d'un bannissement et souhaitez faire appel de cette d\u00e9cision pour r\u00e9cup\u00e9rer votre acc\u00e8s, envoyez un courriel \u00e0 ramodmail@gmail.com ou directement un message \u00e0 RAdmin.</p>"},{"location":"Users-Code-of-Conduct-fr/#que-faire-si-vous-pensez-que-la-moderation-a-commis-une-erreur","title":"Que faire si vous pensez que la mod\u00e9ration a commis une erreur ?","text":"<p>Si vous pensez que les mod\u00e9rateurs n'ont pas respect\u00e9 les r\u00e8gles \u00e9dict\u00e9es ci-dessus, envoyez un message direct \u00e0 RAdmin ou un courriel \u00e0 ramodmail@gmail.com. Il s'agit d'une adresse partag\u00e9e par tous les mod\u00e9rateurs et les administrateurs. La question sera discut\u00e9e coll\u00e9gialement et \u00e9quitablement.</p> <p>Les administrateurs ou mod\u00e9rateurs qui ne respecteraient pas ou violeraient d\u00e9lib\u00e9r\u00e9ment ce code de conduite devraient faire face \u00e0 des r\u00e9percussions temporaires voire d\u00e9finitives d\u00e9cid\u00e9es par les autres membres de l'administration du projet.</p>"},{"location":"Users-Code-of-Conduct-fr/#tricherie","title":"Tricherie","text":"<p>Consulter les R\u00e8gles concernant le classement global et la chasse aux succ\u00e8s.</p>"},{"location":"Users-Code-of-Conduct-fr/#faq","title":"FAQ","text":"<ul> <li>Quand un membre est banni du serveur Discord, est-il automatiquement banni du site Internet ?</li> <li>J'ai cr\u00e9\u00e9 un serveur Discord car je veux plus de libert\u00e9 que je n'en ai sur le serveur officiel RetroAchievements. Puis-je en faire la promotion ici ?</li> <li>Est-il obligatoire pour un d\u00e9veloppeur de succ\u00e8s de rejoindre le serveur Discord ?</li> <li>Si un cr\u00e9ateur de succ\u00e8s est banni de Discord, perdra-t-il son r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet ?</li> <li>Si je suis banni du serveur Discord mais que je souhaite encore cr\u00e9er des succ\u00e8s, que dois-je faire ?</li> </ul>"},{"location":"Users-Code-of-Conduct-fr/#quand-un-membre-est-banni-du-serveur-discord-est-il-automatiquement-banni-du-site-internet","title":"Quand un membre est banni du serveur Discord, est-il automatiquement banni du site Internet ?","text":"<p>Non.</p> <p>Le membre pourra toujours utiliser nos services et jouer \u00e0 des jeux r\u00e9tro afin de d\u00e9bloquer des succ\u00e8s. Toutefois, si le comportement perturbateur devait se prolonger sur le site Internet, il en serait alors \u00e9galement banni.</p>"},{"location":"Users-Code-of-Conduct-fr/#jai-cree-un-serveur-discord-car-je-veux-plus-de-liberte-que-je-nen-ai-sur-le-serveur-officiel-retroachievements-puis-je-en-faire-la-promotion-ici","title":"J'ai cr\u00e9\u00e9 un serveur Discord car je veux plus de libert\u00e9 que je n'en ai sur le serveur officiel RetroAchievements. Puis-je en faire la promotion ici ?","text":"<p>Non.</p>"},{"location":"Users-Code-of-Conduct-fr/#est-il-obligatoire-pour-un-developpeur-de-succes-de-rejoindre-le-serveur-discord","title":"Est-il obligatoire pour un d\u00e9veloppeur de succ\u00e8s de rejoindre le serveur Discord ?","text":"<p>Non.</p> <p>Rejoindre notre serveur Discord est facultatif. Toutefois, si vous vous trouvez sur la liste des membres bannis de Discord, vous ne pouvez pr\u00e9tendre au r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet.</p>"},{"location":"Users-Code-of-Conduct-fr/#si-un-createur-de-succes-est-banni-de-discord-perdra-t-il-son-role-de-developpeur-sur-le-site-internet","title":"Si un cr\u00e9ateur de succ\u00e8s est banni de Discord, perdra-t-il son r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet ?","text":"<p>Oui.</p>"},{"location":"Users-Code-of-Conduct-fr/#si-je-suis-banni-du-serveur-discord-mais-que-je-souhaite-encore-creer-des-succes-que-dois-je-faire","title":"Si je suis banni du serveur Discord mais que je souhaite encore cr\u00e9er des succ\u00e8s, que dois-je faire ?","text":"<p>Envoyez votre appel \u00e0 RAdmin ou ramodmail@gmail.com afin de demander \u00e0 ce que votre bannissement soit lev\u00e9.</p> <p>Il n'est pas important que vous souhaitiez ou non rejoindre le serveur Discord mais si vous \u00eates dans la liste des utilisateurs bannis, vous ne pouvez pas pr\u00e9tendre au r\u00f4le de \"D\u00e9veloppeur\" sur le site Internet. </p>"},{"location":"Users-Code-of-Conduct-pl/","title":"Kodeks Post\u0119powania U\u017cytkownika","text":""},{"location":"Users-Code-of-Conduct-pl/#nasze-standardy","title":"Nasze Standardy","text":"<p>Chcemy wolne, otwarte, pozytywne \u015brodowisko. Pami\u0119taj cz\u0142eku; wszyscy tu jeste\u015bmy aby po\u0142\u0105czy\u0107 si\u0119 wsp\u00f3ln\u0105 pasj\u0105 grania w stare gry!</p>"},{"location":"Users-Code-of-Conduct-pl/#przykady-zachowania-ktore-suzy-do-tworzenia-przyjaznego-srodowiska","title":"Przyk\u0142ady zachowania kt\u00f3re s\u0142u\u017cy do tworzenia przyjaznego \u015brodowiska.","text":"<ul> <li>U\u017cywanie go\u015bcinnego i jasnego j\u0119zyka.</li> <li>Szanowanie innych z r\u00f3\u017cnym punktem widzenia i do\u015bwiadczeniem .</li> <li>\u0141agodne przyjmowanie konstrukcyjnego krytycyzmu .</li> <li>Skupianie si\u0119 na tym, co jest najlepsze dla spo\u0142eczno\u015bci.</li> <li>Pokazywanie empatii innym cz\u0142onkom spo\u0142eczno\u015bci.</li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#nieakceptowalne-zachowanie","title":"Nieakceptowalne zachowanie","text":"<ul> <li>Pytanie czy wysy\u0142anie link\u00f3w do stron gdzie mo\u017cna \u015bci\u0105ga\u0107 nielegalnie ROM-y.</li> <li>Spamienie wiadomo\u015bciami czy pr\u00f3bowanie wandalizowania Discorda czy strony w jaki kolwiek spos\u00f3b.</li> <li>Reklamowanie produkt\u00f3w, us\u0142ug, lub innych serwer\u00f3w discord bez zezwolenia.</li> <li>Dyskryminacja: w to wchodzi rasizm, seksizm, elityzm, nietolerancja innych kraj\u00f3w, religii, orientacji seksualnej, pogl\u0105d\u00f3w politycznych.</li> <li>Publiczne czy prywatne n\u0119kanie, N\u0119kanie na RetroAchievements jest definiowane jako systematyczne lub ci\u0105g\u0142e dr\u0119czenie i poni\u017canie, do takiego stopnia \u017ceby sensowna osoba ba\u0142a si\u0119 wyra\u017ca\u0107 swoje pogl\u0105dy (oczywi\u015bcie, te pogl\u0105dy nie mog\u0105 \u0142ama\u0107 Kodeks Post\u0119powania), ba\u0142a si\u0119 uczestniczy\u0107 w konwersacji, lub o swoje bezpiecze\u0144stwo</li> <li>Oszczerstwo, w sensie rozpowiadania k\u0142amstw na temat osoby aby poni\u017cy\u0107 jej reputacje</li> <li>Gro\u017aby przemoc\u0105</li> <li>Niechciana uwaga seksualna lub podej\u015bcie wobec innych</li> <li>Postowanie pornografii, w sensie zdj\u0119\u0107 lub opis\u00f3w zachowa\u0144 erotycznych w celu wzbudzenia ekscytacji seksualnej</li> <li>Postowanie ohydnych lub krwawych obraz\u00f3w w celu obrzydzenia kogo\u015b</li> <li>Publikowanie czyi\u015b prywatnych informacji, takich jak ich zdj\u0119cia lub fizyczny czy elektroniczny adres, bez jasnego zezwolenia</li> </ul> <p>Takie zachowanie mo\u017ce sko\u0144czy\u0107 si\u0119 dla sprawcy wyciszeniem, wykopaniem, lub banem z serwer Discord lub/i z RetroAchievements.org</p>"},{"location":"Users-Code-of-Conduct-pl/#zle-widziane-zachowanie","title":"\u0179le widziane zachowanie","text":"<ul> <li>Zaci\u0119te publiczne k\u0142\u00f3tnie </li> <li>Nadmierny Shitposting</li> <li>Ataki na osob\u0119, w sensie robienie obra\u017aliwych uwag na lub powi\u0105zane z osob\u0105, zamiast podawanie dowod\u00f3w podczas sprawdzania zarzut\u00f3w lub komentarzy</li> </ul> <p>Moderator wst\u0105pi aby uspokoi\u0107 je\u015bli konwersacja wyjdzie spod kontroli, w takim wypadku moderator mo\u017ce usun\u0105\u0107 komentarze, tymczasowo wyciszy\u0107 u\u017cytkownik\u00f3w , poprosi\u0107 aby porozmawiali prywatnie, lub podj\u0119cie innych akcji kt\u00f3re s\u0105 konieczne aby uciszy\u0107 sytuacje. Zachowaj spok\u00f3j, a wszyscy b\u0119dziemy mieli lepszy czas</p>"},{"location":"Users-Code-of-Conduct-pl/#wyraznie-zezwolone","title":"Wyra\u017anie zezwolone","text":"<ul> <li>Sensowny krytycyzm i kwestionowanie decyzji administracyjnych </li> <li>Sensowna krytyka kreacji tw\u00f3rc\u00f3w osi\u0105gni\u0119\u0107</li> </ul> <p>Podczas robienia publicznej krytyki zachowuj si\u0119 cywilizowanie i nie atakuj os\u00f3b, nie stosowanie si\u0119 do tego b\u0119dzie skutkowa\u0107 moderacj\u0105</p> <p>Dla zdrowia psychicznego i mora\u0142\u00f3w spo\u0142eczno\u015bci spr\u00f3buj aby krytyka by\u0142a zach\u0119caj\u0105ca, konstrukcyjna i optymistyczna.</p>"},{"location":"Users-Code-of-Conduct-pl/#zasady-dla-serwera-discord","title":"Zasady dla serwera Discord","text":"<p>Pozosta\u0144 w temacie kana\u0142u w kt\u00f3rym jeste\u015b, niekt\u00f3re kana\u0142y s\u0105 szczeg\u00f3\u0142owe, a niekt\u00f3re s\u0105 elastyczne. Sprawd\u017a opis kana\u0142u na g\u00f3rze i jak inny u\u017cywaj\u0105 kana\u0142.</p>"},{"location":"Users-Code-of-Conduct-pl/#etyka-forum","title":"Etyka forum","text":""},{"location":"Users-Code-of-Conduct-pl/#opublikuj-to","title":"Opublikuj to!","text":"<ul> <li>Tw\u00f3j post jest na temat i jest bezpo\u015brednio z nim powi\u0105zany</li> <li>Tw\u00f3j post daje nowe pomys\u0142y lub perspektyw\u0119 na temat dyskusji</li> <li>Tw\u00f3j post ma twoje pomys\u0142y i pogl\u0105dy na temat</li> <li>Tw\u00f3j post odpowiada bezpo\u015brednio na czyje\u015b pytania</li> <li>Tw\u00f3j post odkopuje stare uwagi, w kt\u00f3re wierzysz \u017ce potrzebuj\u0105 \u015bwiat\u0142a</li> <li>Tw\u00f3j post ma sensowny krytycyzm czyjego\u015b punktu widzenia lub pomys\u0142\u00f3w</li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#zostaw","title":"Zostaw!","text":"<ul> <li>Trollowanie, lub nabijanie si\u0119 z pozycji czyjej\u015b lub kogo\u015b</li> <li>Niejasne narzekanie</li> <li>Memy, dokuczanie</li> <li>Rozmowy nie na temat lub dyskusji na temat dyskusji</li> <li>Zgadzanie si\u0119 lub zaprzeczanie, bez podawania argument\u00f3w </li> <li>Zaprzeczanie lub krytykowanie czyjej\u015b pozycji bez podawania sensownych kontrargument\u00f3w</li> <li>Spam i posty bez kontekstu</li> <li>Agresywne lub pasywno-agresywne atakowanie pozycji innego rozm\u00f3wcy</li> <li>K\u0142\u00f3cenie si\u0119 lub sprzeciwianie si\u0119 kierunku moderacji</li> </ul> <p>Je\u015bli inni zachowuj\u0105 si\u0119 nieprzyzwoicie nie graj moderatora!</p> <ul> <li>Zamiast pr\u00f3bowa\u0107 si\u0119 przekrzykiwa\u0107, zachowaj dobr\u0105 form\u0119 i stosuj si\u0119 do dobrej etykiety</li> <li>Zamiast m\u00f3wi\u0107 \u017ce spami\u0105/trolluj\u0105/obra\u017caj\u0105/s\u0105 toksyczni zignoruj cz\u0119\u015b\u0107 lub ca\u0142\u0105 wiadomo\u015b\u0107 i skontaktuj si\u0119 z moderatorem (je\u015bli jest taka konieczno\u015b\u0107). Odpowiadanie lub granie moderatora karmi trolla</li> </ul> <p>Je\u015bli czujesz \u017ce moderacja jest konieczna, napisz do [Radmina]((http://retroachievements.org/createmessage.php?t=RAdmin.md), kt\u00f3ry jest kontem moderator\u00f3w</p> <p>Je\u015bli masz problem z jak\u0105kolwiek czynno\u015bci\u0105 moderacji wy\u015blij wiadomo\u015b\u0107 do [Radmina]((http://retroachievements.org/createmessage.php?t=RAdmin.md) lub wy\u015blij maila do ramodmail@gmail.com. To jest wsp\u00f3lne konto kt\u00f3re widz\u0105 admini i moderatorzy, problemy b\u0119d\u0105 przedyskutowane i za\u0142atwione sprawiedliwie </p>"},{"location":"Users-Code-of-Conduct-pl/#konflikty","title":"Konflikty","text":"<p>Jest ok i cz\u0119sto dobrze jak si\u0119 pojawi konflikt, lecz jest wa\u017cne aby by\u0142 on pozytywny, zobacz Hierarchie Niezgody Grahama (I will make the image later), by zobaczy\u0107 co wypada, wszystko pod Zaprzeczeniem nie jest wystarczaj\u0105co dobre na forum, gdy\u017c krytyczny ton, atakowanie innych i wyzwiska nie s\u0105 akceptowane</p>"},{"location":"Users-Code-of-Conduct-pl/#oszukiwanie","title":"Oszukiwanie","text":"<p>Zobacz list\u0119 Globaln\u0105 Tablic\u0119 Wynik\u00f3w i Zasady Zdobywania Osi\u0105gni\u0119\u0107.</p> <p>Konta kt\u00f3rym udowodniono oszukiwanie b\u0119d\u0105 ustawione na \"nie \u015bledzone\", a w niekt\u00f3rych wypadkach banowane.</p> <p>Je\u017ali podejrzewasz kogo\u015b o oszukiwanie, nie r\u00f3b publicznych zarzut\u00f3w. Podziel si\u0119 dowodami z administacj\u0105/moderacj\u0105, lub poczekaj na szczeg\u00f3\u0142ow\u0105 ocen\u0119. Zarzuty oszukiwania mog\u0105 by\u0107 bardzo niszcz\u0105ce dla spo\u0142eczno\u015bci i s\u0105 cz\u0119sto bezzasadne lub nie maj\u0105 wystarczaj\u0105co dowod\u00f3w aby zosta\u0107 ukaranym. Twoje zarzuty pozostan\u0105 anonimowe </p> <p>Naprzyk\u0142ad:_ u\u017cytkownik by\u0142 oskar\u017cony o oszukiwanie, bo ocenie dowod\u00f3w, __, _, _. uznali\u015bmy \u017ce jest wystarczaj\u0105co/niewystarczaj\u0105co dowod\u00f3w  aby by\u0142 nie \u015bledziony.</p>"},{"location":"Users-Code-of-Conduct-pl/#zgaszanie","title":"Zg\u0142aszanie","text":"<p>Przypadki Nieakceptowalnego zachowania lub oszukiwania mog\u0105 by\u0107 zg\u0142aszane do ekipy moderator\u00f3w na serwerze discord RetroAchievements (osoby z niebieskimi  pseudonimami). Mo\u017cesz r\u00f3wnie\u017c skontaktowa\u0107 si\u0119 ze wszystkimi moderatorami/adminami poprzez wysy\u0142anie prywatnej wiadomo\u015bci do U\u017cytkownika Radmin na oficjalnej stronie.</p> <p>Skargi b\u0119d\u0105 sprawdzone, zbadane i zaadresowane zale\u017cnie od okoliczno\u015bci. </p>"},{"location":"Users-Code-of-Conduct-pl/#obowiazki-adminowmoderacji","title":"Obowi\u0105zki admin\u00f3w/moderacji","text":"<p>Admini/moderacja s\u0105 odpowiedzialni za utrzymywanie naszej spo\u0142eczno\u015bci dobrze funkcjonuj\u0105cej. Oni musz\u0105 podtrzymywa\u0107 ten kodeks post\u0119powanie jak i ten Deweloper\u00f3w osi\u0105gni\u0119\u0107 na stronie i na discordzie. Ich obowi\u0105zki na tych dw\u00f3ch frontach s\u0105 opisane poni\u017cej.</p>"},{"location":"Users-Code-of-Conduct-pl/#na-stronie","title":"Na stronie","text":"<ul> <li>poprzez zasady kodeksu post\u0119powania, odrzucanie lub usuwanie<ul> <li>komentarzy</li> <li>osi\u0105gni\u0119\u0107</li> <li>odznak</li> <li>post\u00f3w na forum</li> <li>inne kontrybucje kt\u00f3re nie s\u0105 w tym kodeksie post\u0119powania </li> </ul> </li> <li>\"Nie \u015bledzi\u0107\" u\u017cytkownika kt\u00f3ry zosta\u0142 potwierdzonym oszustem </li> <li>Ostrzega\u0107, banowa\u0107 tymczasowo lub permanentnie cz\u0142onk\u00f3w co \u0142ami\u0105 ten kodeks post\u0119powania nadmiernie, ostrze\u017cenie jest pierwsze w wi\u0119kszo\u015bci przypadk\u00f3w <ul> <li>Kiedy niepoprawne zachowanie jest niejasne, sztab b\u0119dzie dyskutowa\u0142 o tym jakie akcje powinny by\u0107 podj\u0119te</li> </ul> </li> </ul>"},{"location":"Users-Code-of-Conduct-pl/#na-discordzie","title":"Na Discordzie","text":"<ul> <li>Pomaganie gdy kto\u015b o to prosi, najlepiej poprzez pokazywanie strony dokumentacji z odpowiedzi\u0105 (by ludzie u\u017cywali dokumentacji aby znajdywa\u0107 odpowiedzi kt\u00f3rych potrzebuj\u0105).</li> <li>Utrzymywanie kana\u0142\u00f3w w temacie, ale w odpowiednim stopniu rozlu\u017anienia w kana\u0142ach generalnych. \u017beby pozwoli\u0107 na naturalny przep\u0142yw konwersacji </li> <li>Weryfikowanie u\u017cytkownik\u00f3w na Discordzie</li> <li>Zapewnienie aby nazwa u\u017cytkownika by\u0142a taka sama jak na stronie. Akceptowany wyj\u0105tek: <code>DiscordNick (RA_Username)</code>.</li> <li>Zarz\u0105dzanie rolami, jak:<ul> <li>Dawanie roli 'jr-dev' osob\u0105 kt\u00f3re s\u0105 zainteresowane tworzeniem osi\u0105gni\u0119\u0107</li> <li>Dawanie 'developer' osob\u0105 kt\u00f3re maj\u0105 status Dewelopera na stronie.</li> <li>Zarz\u0105dzanie rol\u0105 zwyci\u0119zc\u00f3w 'AOTW'.</li> <li>Zarz\u0105dzanie rolami '*-wiadomo\u015bci'</li> </ul> </li> <li>W wypadku jak kto\u015b \u0142amie kodeks post\u0119powania nagminnie, administrator/moderator u\u017cyje swojego os\u0105du aby wykopa\u0107 tego u\u017cytkownika, pierw dostanie on ostrze\u017cenie w wi\u0119kszo\u015bci przypadk\u00f3w. Je\u015bli wr\u00f3ci i b\u0119dzie si\u0119 dalej \u017ale zachowywa\u0107, zostanie zbanowany<ul> <li>Kiedy nieodpowiednie zachowanie nie jest jasne, sztab wewn\u0105trz przedyskutuje jaka czynno\u015b\u0107 powinna zosta\u0107 podj\u0119ta </li> </ul> </li> </ul> <p>Administatorzy/Moderatorzy kt\u00f3rzy nie przestrzega lub nie egzekwuje kodeksu post\u0119powania mo\u017ce zosta\u0107 tymczasowo lub permanentnie ukarany z za\u0142o\u017cenia innych lider\u00f3w projektu.</p>"},{"location":"Users-Code-of-Conduct-pt_BR/","title":"C\u00f3digo de Conduta dos Usu\u00e1rios","text":""},{"location":"Users-Code-of-Conduct-pt_BR/#nossas-normas","title":"Nossas Normas","text":"<p>N\u00f3s queremos um ambiente aberto, agrad\u00e1vel e acolhedor. </p> <p>Exemplos de comportamentos que contribuem para criar um ambiente adequado incluem:</p> <ul> <li>Usar vocabul\u00e1rio acolhedor e inclusivo;</li> <li>Respeitar diferentes ideias, opini\u00f5es e pontos de vista;</li> <li>Estar aberto a cr\u00edticas construtivas;</li> <li>Focar-se no melhor para a comunidade;</li> <li>Mostrar empatia por outros membros da comunidade.</li> </ul> <p>Exemplos de comportamentos inaceit\u00e1veis incluem:</p> <ul> <li>Compartilhar sites que promovam a pirataria e o download ilegal de ROMs;</li> <li>Trapacear (cheating): qualquer tipo de trapa\u00e7a, salvo quando devidamente especificado na descri\u00e7\u00e3o da conquista ou em coment\u00e1rios na p\u00e1gina da mesma, \u00e9 proibido. Mesmo cheats presentes nos jogos (como menus secretos e c\u00f3digos de invencibilidade), quando n\u00e3o especificados na descri\u00e7\u00e3o ou p\u00e1gina de uma conquista, s\u00e3o considerados trapa\u00e7as. Contas que fizeram, comprovadamente, o uso de trapa\u00e7as ser\u00e3o marcadas como \"Untracked\";     </li> <li>Tentar, intencionalmente, causar instabilidade na comunidade: Incitar \"ca\u00e7a \u00e0s bruxas\", participar de \"tretas\" publicamente onde os argumentos e discordancias deveriam ser resolvidos de maneira particular entre os envolvidos;</li> <li>\"Trollagem\" excessiva, fazer coment\u00e1rios insultantes ou depreciativos, al\u00e9m de ofender moralmente ou politicamente outros usu\u00e1rios;</li> <li>Usar ou compartilhar imagens com conota\u00e7\u00e3o sexual e insinuar-se sexualmente de forma inadequada e abusiva; </li> <li>Assediar de forma p\u00fablica ou privativa;</li> <li>Divulgar, sem explicita permiss\u00e3o, dados pessoais de outros.</li> </ul>"},{"location":"Users-Code-of-Conduct-pt_BR/#responsabilidades-dos-administradores","title":"Responsabilidades dos Administradores","text":"<p>Os administradores t\u00eam o direito e responsabilidade de remover, editar ou rejeitar coment\u00e1rios, conquistas, emblemas, \u00edcones, t\u00f3picos do f\u00f3rum e outras contribui\u00e7\u00f5es que n\u00e3o est\u00e3o de acordo com os termos presentes neste C\u00f3digo de Conduta. Ainda, administradores podem banir, permanentemente ou temporariamente, usu\u00e1rios por outros comportamentos considerados inadequados, amea\u00e7adores, ofensivos ou prejudiciais. Quando um comportamento n\u00e3o for claramente inapropriado, os administradores debater\u00e3o, entre si, para decidir quais medidas ser\u00e3o tomadas.</p> <p>Administradores que n\u00e3o cumprirem ou impuserem, de boa-f\u00e9, o C\u00f3digo de Conduta poder\u00e3o estar sujeitos a san\u00e7\u00f5es, permanentes ou tempor\u00e1rias, determinadas por outros membros da lideran\u00e7a do projeto. </p>"},{"location":"Users-Code-of-Conduct-pt_BR/#comunicacao","title":"Comunica\u00e7\u00e3o","text":"<p>Casos de abuso, ass\u00e9dio, trapa\u00e7as, ou outros comportamentos inadequados podem ser informados aos administradores do RetroAchievements, no servidor Discord por meio de uma Mensagem Direta \u00e0 um dos administradores (usu\u00e1rios com nomes em vermelho). Voc\u00ea tamb\u00e9m pode contatar um administrador enviando uma Mensagem Privada para o usu\u00e1rio RAdmin no site oficial.</p> <p>As reclama\u00e7\u00f5es ser\u00e3o lidas, investigadas e respondidas caso a caso.</p>"},{"location":"Users-Code-of-Conduct-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-10 16:00] meleu:</code> fix broken link</li> <li><code>[2018-10-11 00:12] CoolCanuck:</code> https</li> <li><code>[2018-06-10 09:43] lilbud:</code> Updated Discord Link</li> <li><code>[2018-05-04 10:02] meleu:</code> Updated Users Code of Conduct pt_BR (markdown)</li> <li><code>[2018-03-24 11:31] meleu:</code> Updated Codigo de Conduta do Usuario (markdown)</li> </ul>"},{"location":"Users-Code-of-Conduct/","title":"Users Code of Conduct","text":"<ul> <li>Mission Statement</li> <li>Rules     - Short Version     - Long Version     - Freedom of Speech</li> <li>How Moderation Works     - What to do if you think moderation is wrong</li> <li>FAQ</li> </ul>"},{"location":"Users-Code-of-Conduct/#mission-statement","title":"Mission Statement","text":"<p>The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. We strive to promote a healthy and collaborative community around this hobby. Everything we produce is made available for free and we will never profit from it.</p>"},{"location":"Users-Code-of-Conduct/#rules","title":"Rules","text":"<p>There's a lot of retrogamers around the globe, spanning various different cultures, points of view, and opinions. Therefore, in order to provide a healthy environment for the community to share their passion for retrogames, we need some rules.</p>"},{"location":"Users-Code-of-Conduct/#short-version","title":"Short Version","text":"<p>This short version should be enough for most people:</p> <ol> <li>Don't be a jerk or generally obnoxious - nobody likes trolls.</li> <li>Don't use our website or Discord server to share copyrighted material or information about where they can be downloaded.</li> <li>Keep the Discord channels and forum threads on-topic (we do have a section for off-topic chatting, though).</li> <li>When a moderator/admin asks you to stop, you should stop.</li> <li>When in doubt, ask a @mod in Discord or send a message to RAdmin on the website.</li> </ol>"},{"location":"Users-Code-of-Conduct/#long-version","title":"Long Version","text":"<p>If the short version is not clear enough for you, here's a detailed one:</p>"},{"location":"Users-Code-of-Conduct/#examples-of-expected-behavior","title":"Examples of expected behavior","text":"<ul> <li>Focusing on what is best for the community.</li> <li>Showing empathy towards other community members.</li> <li>Being respectful when expressing your viewpoint.</li> <li>Gracefully accepting constructive and respectful criticism.</li> <li>Reporting to moderators/admins cases where these rules are being violated.</li> </ul>"},{"location":"Users-Code-of-Conduct/#unacceptable-social-behavior","title":"Unacceptable social behavior","text":"<ul> <li>Asking for or posting links to sites where others could download copyrighted material.</li> <li>Spamming messages or attempting to vandalize Discord or the website by any means.</li> <li>Advertising products, services, or other Discord servers without approval.</li> <li>Bigotry: This includes racism, sexism, elitism; intolerance regarding others' nationality, religion, sexual orientation, political beliefs, etc.</li> <li>Public or private harassment.</li> <li>Defamation, as in making false statements about a person that may injure their reputation.</li> <li>Threats of violence.</li> <li>Unwelcome sexual attention or advances towards others.</li> <li>Posting pornography, as in images or descriptions of erotic behavior intended to cause sexual excitement. </li> <li>Posting gruesome or gory images intended to cause disgust.</li> <li>Publishing others' private information, such as a photos of them or their physical or electronic address, without explicit permission.</li> </ul>"},{"location":"Users-Code-of-Conduct/#behavior-strongly-frowned-upon","title":"Behavior strongly frowned upon","text":"<ul> <li>Heated public arguments.</li> <li>Excessive shitposting.</li> <li>Personal attacks, as in making abusive remarks on or relating to one's person, instead of providing evidence when examining another person's claims or comments.</li> </ul> <p>The moderators will step in to cool things down if arguments start getting out of hand. Check below how moderation works.</p>"},{"location":"Users-Code-of-Conduct/#freedom-of-speech","title":"Freedom of Speech","text":"<p>If you just want to rant or dump derogatory comments about how we run things here, you're free to do that. But, as it's demotivating and wastes a lot of volunteers' time, we don't want it on our forums or Discord Server. There are plenty of options where you can do it around the Internet.</p> <p>Keep in mind that RetroAchievements.org is NOT a bastion of freedom of speech.</p> <p>If you have criticism, you're very welcome to say it, just be sure to be civil.</p>"},{"location":"Users-Code-of-Conduct/#how-moderation-works","title":"How Moderation Works","text":"<p>If you feel moderation is needed, ping the @mod role on our Discord server, or direct your issues to RAdmin, a shared mod-mail account.</p> <p>The moderation goal is to assure users adhere to the User's Code of Conduct.</p> <p>What a moderator should do after seeing a breach to the Code of Conduct:</p> <ol> <li> <p>Formal and diplomatic warning (no sarcasm, no threatening tone).</p> </li> <li> <p>If the warning is ignored, the offender will be kicked from our Discord server.</p> </li> <li> <p>If the offender continues to ignore the moderation, they'll be banned from our Discord server. If the offender has the \"Developer\" role on the website, their privileges will be removed.</p> </li> </ol> <p>Note: on the website there's no \"kick\". If the offender ignores the warning, the next step is a ban.</p> <p>If you've been banned and somehow want to appeal to have your access back, send an email to ramodmail@gmail.com or a Direct Message to RAdmin.</p>"},{"location":"Users-Code-of-Conduct/#what-to-do-if-you-think-moderation-is-wrong","title":"What to do if you think moderation is wrong","text":"<p>If you think moderators are not acting like described above, send a Direct Message to RAdmin or email ramodmail@gmail.com. This is a shared moderation account that all mods and admins see. The issue will be discussed and dealt with fairly.</p> <p>Admins/mods who do not follow or enforce this Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's administration.</p>"},{"location":"Users-Code-of-Conduct/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"Users-Code-of-Conduct/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"Users-Code-of-Conduct/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"Users-Code-of-Conduct/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"Users-Code-of-Conduct/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"Users-Code-of-Conduct/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"Users-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 20:45] televandalist:</code> Removed section on cheating since it was just a redirect to the \"Global Leaderboard and Achievement Hunting Rules\" section, which is in the same category.</li> <li><code>[2021-05-01 20:24] meleu:</code> criticism doesn't need to be DMs to RAdmin</li> <li><code>[2021-05-01 12:05] meleu:</code> rewording stuff</li> <li><code>[2021-05-01 07:30] meleu:</code> reorder short rules</li> <li><code>[2021-05-01 07:22] meleu:</code> list's indentation</li> <li><code>[2021-05-01 07:17] meleu:</code> simpler, clearer and more focused version</li> <li><code>[2020-11-03 19:07] HolyShinx:</code> forgot one word, geez I'm so clumsy ;-;</li> <li><code>[2020-11-03 19:03] HolyShinx:</code> added rule 1, 2 and 4 to Discord Chat Specific Rules from RA discord server</li> <li><code>[2020-09-18 23:03] meleu:</code> no \"public lynching\"</li> <li><code>[2020-05-10 19:34] meleu:</code> Revert 65363acd5c8e6ab50b72985f30a64405b8c96526...72e3510e81ea66c6a90885af39e670f8d9f38b3e on Users Code of Conduct</li> </ul>"},{"location":"Using-Add-Source-and-Deltas-for-Collectibles-or-Similar-Achievements/","title":"Using Add Source and Deltas for Collectibles or Similar Achievements","text":"<p>In this example is a simple way one can utilize the Add Source flag in their achievement logic.</p> <p>We'll look at an achievement from Suikoden (PlayStation) entitled Treasure Hunter - Dragon Knights' Domain:</p> <p>Addresses Used</p> <ul> <li><code>0x1b8244</code>: bit0-bit4 are treasures in Soniere, bit5 is a treasure at the Northern Checkpoint, and bit6-bit7 are treasures at the Dragon Den.</li> <li><code>0x1b8245</code>: bit0 is a treasure at the Dragon Den, bit1-bit5 are treasures at Seek Valley, and bit6-7 are treasures in Kalekka.</li> <li><code>0x1b824b</code>: bit0-bit1 are treasures at the Village of the Hidden Rune, bit2 is unused, bit3-4 are treasures at the Dragon Knights' Fortress, bit5-6 are treasures in Teien, and bit7 is a treasure at Luiken's House. </li> </ul> <p></p> <p>This particular achievement only requires treasures from Dragon Knights' Fortress, Dragon Den, and Seek Valley; therefore, we only need bit6-7 from <code>0x1b8244</code>, bit0-bit5 from <code>0x1b8245</code>, and bit3-bit4 from <code>0x1b824b</code>. </p> <p>Logic Breakdown</p> <ul> <li>There are two groups of ten conditions with the main differences being the Delta type and the total. This is to ensure that the player goes from nine of these treasures obtained to having all ten of these treasures obtained. Note: Remember to use hexadecimal for Add Source totals! </li> <li>Since we're using bitflags here, the totals for individual conditions will only ever be 0x00 or 0x01. Obviously, we want them all to be 0x01 for the trigger, but we don't want someone to get the achievement simply by loading a save with all ten treasures already found.</li> <li>The trigger is the first frame that the player goes from nine to ten treasures obtained. This is to help prevent the achievement from triggering when it's not supposed to.</li> <li>The Measured flag is on the last condition so the player can check how far they are from their goal. If they have eight out of ten treasures, the achievement will show that it is 80% complete in the overlay (RAEmus) or achievement menu (RetroArch). </li> </ul> <p>This method is mostly handy for when the totals between the Delta-type and Mem-type only have a difference of 0x01, but it can be used in various types of achievements: collectibles that are only obtainable one-at-a-time, map completion (such as dungeon-crawlers with viewable maps that get revealed as you enter new areas), learnable skills, bestiaries, completing a certain number of side missions, and many others.</p> <p>If you run into a situation where more than one bitflag in an Add Source chain toggles at the same time, you can still utilize this template. However, you'll want to clone the Delta conditions and make it so both totals create a range. Still using the above achievement as an example, the existing total could be changed to <code>&lt;= 0x09</code> and the total for the second group could be <code>&gt;= 0x05</code>. This would make it so the achievement would trigger if the total goes from 5-9 treasures to 10 treasures.</p> <p>To Do: - Provide a separate example for the Delta range. - Go over using BitCount in a similar achievement. - Go over using <code>/</code> when you need at least one of multiple things.</p>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment-es/","title":"Utilizando Valores Delta y Hit Counts para Detectar un Incremento","text":"<p>Tomemos a Streets of Rage 2 (Mega Drive) como ejemplo, y al logro Steel Grip - Derrota a 10 enemigos sin tirar tu arma. Este se basa en cuatro condiciones:</p> <p>Variables (Addresses)</p> <ul> <li><code>0xef33</code>: sujetando un arma </li> <li><code>0xef37</code>: tipo de arma</li> <li><code>0xef4e</code>: numero de KOs (jugador 1)</li> </ul> <p></p> <p>Condiciones</p> <ol> <li> <p>el jugador esta sujetando un arma. Requerimos que esto sea verdad, una vez. Esto no es realmente necesario, pero es util para mostrar progresi\u00f3n. Necesitamos que el jugador sujete un arma, m\u00ednimo una vez.</p> </li> <li> <p>numero de KOs que el jugador a hecho. Es de 16-bit (esto significa que el valor puede ser mayor a 255), y utilizando un delta y los s\u00edmbolos 'mayor que (greater than)', estamos diciendo que necesitamos que el numero de KOs sea mayor que el valor anterior, y necesitamos que esto pase 10 \u00fanicas veces. Cada vez que el valor actual sea mas grande que el valor anterior, el hit count va a subir por uno. El siguiente frame, el valor 'delta' tiene que incrementarse para ser el mismo que el valor actual, esto asegura que despu\u00e9s de cada baja, el contador de KO se va a subir a uno, y el hit count va a subir a uno. LIMITACI\u00d3N: si el numero de KOs sube sobre dos en el mismo frame, el hit count solo va a subir por uno. Es una peque\u00f1a desventaja que pasa mas com\u00fan de lo que aparenta...</p> </li> <li> <p>Se resetea todo el progreso, si el tipo de arma es diferente al ultimo tipo de arma conocido.</p> </li> <li> <p>Se resetea todo el progreso, si el jugador no se encuentra cargando un arma.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Using-Delta-Values-and-Hit-Counts-to-Detect-an-Increment/","title":"Using Delta Values and Hit Counts to Detect an Increment","text":"<p>Let's take Streets of Rage 2 (Mega Drive) as a case study, and Steel Grip - Defeat 10 enemies without dropping your weapon achievement. This relies on four conditions:</p> <p>Addresses</p> <ul> <li><code>0xef33</code>: holding weapon </li> <li><code>0xef37</code>: weapon type</li> <li><code>0xef4e</code>: number of KOs (player 1)</li> </ul> <p></p> <p>Conditions</p> <ol> <li> <p>the player is holding a weapon. We require this to be true, once. This is actually not necessary, but it's useful to show the progression. We are requiring the player to hold a weapon, at least once.</p> </li> <li> <p>number of KOs that the player has made. It's 16-bit (meaning the value can be more than 255), and by using the delta and 'greater than' symbols, we are saying that we require the number of KOs to be bigger than the previous value, and we need this to happen 10 unique times. Every time the current value is bigger than the previous value, the hit count will go up by one. The next frame, the 'delta' value will have increased to be the same as the current value, this ensures that after every kill, the KO counter will go up by one, and the hit count will go up by one. LIMITATION: if the number of KOs goes up by two in the same frame, the hit count will only go up by one. It's a slight flaw that does happen a little more often than expected... it's not so accurate but it's a fairly close estimate to your number of kills.</p> </li> <li> <p>reset all our progress, if the weapon type is different than the last known weapon type.</p> </li> <li> <p>reset all our progress, if the player is no longer carrying a weapon.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-ResetIf-pt_BR/","title":"Usando Valores Deltas e ResetIf","text":"<p>Link para o texto em ingl\u00eas: Using Delta Values and Hit Counts to Detect an Increment</p> <p>Vamos pegar Streets of Rage 2 (Mega Drive) como um caso de estudo, e o achievement Steel Grip - Defeat 10 enemies without dropping your weapon. Isso depende de quatro condi\u00e7\u00f5es:</p> <p>Endere\u00e7os</p> <ul> <li><code>0xef33</code>: arma em m\u00e3o</li> <li><code>0xef37</code>: tipo de arma </li> <li><code>0xef4e</code>: n\u00famero de KOs (player 1)</li> </ul> <p></p> <p>Condi\u00e7\u00f5es</p> <ol> <li> <p>o jogador est\u00e1 segurando uma arma. Isso deve ser verdadeiro, ao menos uma vez. Isso na verdade n\u00e3o \u00e9 necess\u00e1rio, mas \u00e9 \u00fatil mostrar a progress\u00e3o. Estamos dizendo que exigem que o jogador mantenha uma arma, pelo menos uma vez.</p> </li> <li> <p>n\u00famero de KOs que o jogador fez. \u00c9 16 bits (o que significa que o valor pode ser superior a 255), e usando os s\u00edmbolos delta e 'maior que', estamos dizendo que exigimos que o n\u00famero de KOs seja maior do que o valor anterior, e precisamos disso para aconte\u00e7a 10 unicas vezes. Toda vez que o valor atual \u00e9 maior do que o valor anterior, a contagem de hits aumentar\u00e1 em um. No pr\u00f3ximo quadro, o valor 'delta' aumentar\u00e1 para ser o mesmo que o valor atual, isso garante que depois de cada morte, o contador KO ir\u00e1 subir de um, e a contagem de batidas aumentar\u00e1 em um.  LIMITA\u00c7\u00c3O: se o n\u00famero de KOs aumentar em dois no mesmo quadro, a contagem de batidas aumentar\u00e1 apenas em um.. \u00c9 uma pequena falha que acontece um pouco mais frequentemente do que o esperado ... n\u00e3o \u00e9 t\u00e3o preciso, mas \u00e9 uma estimativa bastante pr\u00f3xima do seu n\u00famero de mortes</p> </li> <li> <p>resete todo o seu progresso, se o tipo de arma for diferente do \u00faltimo tipo de arma conhecida.</p> </li> <li> <p>resete todo seu progresso, se o jogador j\u00e1 n\u00e3o estiver carregando uma arma.</p> </li> </ol>"},{"location":"Using-Delta-Values-and-ResetIf-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-18 17:01] meleu:</code> fix broken link</li> <li><code>[2018-03-25 12:06] KingDice001:</code> Updated Using Delta Values and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:49] KingDice001:</code> Updated Using Delta Values and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-23 01:21] meleu:</code> Updated Using Delta Values and ResetIf.pt_BR (markdown)</li> </ul>"},{"location":"Using-Hit-Counts-and-ResetIf-pt_BR/","title":"Usando o Contador de Hits e o ResetIf","text":"<p>Link para o texto em ingl\u00eas: Using Hit Counts as a Timer</p> <p>Vamos ver como o achievement Super Hang-On (Mega Drive) Speed Freak - Maintain at least 300kph for 10 seconds aparece no Achievement Editor dialog:</p> <p>Addresses (endere\u00e7os)</p> <ul> <li><code>0x0055a</code>: \u00e9 a velocidade.</li> <li><code>0x0c757</code>: \u00e9 0x00 quando o jogo \u00e9 sem compensa\u00e7\u00e3o (sem pausar).</li> </ul> <p></p> <p>Nesse achievement, desejamos que haja um fato ou condi\u00e7\u00e3o que seja verdadeira 600 vezes consecutivamente. A raz\u00e3o para isso \u00e9 que o Genesis/Mega Drive est\u00e1 travado no processamento de 60 frames de l\u00f3gica por segundo (NTSC pelo menos?). E o fato que estamos procurando \u00e9 que \"a velocidade \u00e9 mais de 300\". Al\u00e9m disso, queremos que o jogador mantenha a velocidade acima de 300 sem pausar o jogo.</p> <p>Condi\u00e7\u00f5es</p> <ol> <li> <p>A velocidade do jogador est\u00e1 acima de 300 para 600 frames (ou 10 segundos se passaram).</p> </li> <li> <p>reset o contador de hit (hit counter) se a velocidade for menor que 300.</p> </li> <li> <p>reset o contador de hit se o jogador pausa o jogo.</p> </li> </ol>"},{"location":"Using-Hit-Counts-and-ResetIf-pt_BR/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-02-18 16:55] meleu:</code> fix broken link</li> <li><code>[2018-03-25 12:05] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:48] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-25 11:48] KingDice001:</code> Updated Using Hit Counts and ResetIf pt_BR (markdown)</li> <li><code>[2018-03-23 01:22] meleu:</code> Updated Using Hit Counts and ResetIf.pt_BR (markdown)</li> </ul>"},{"location":"Using-Hit-Counts-as-a-Timer-es/","title":"Utilizando Hit Counts como un Temporizador","text":"<p>En este ejemplo vas a ver como los hit counts pueden ser utilizados como temporizador y recompensar un logro si la condici\u00f3n es verdadera por 10 segundos.</p> <p>Veamos como en Super Hang-On (Mega Drive) el logro Speed Freak - Manten un minimo de 300kph por 10 segundos se ve en la ventana del Editor de Logros (Achievement Editor):</p> <p>Variables (Addresses)</p> <ul> <li><code>0x0055a</code>: es la velocidad.</li> <li><code>0x0c757</code>: es 0x00 cuando el juego no se encuentra pausado.</li> </ul> <p></p> <p>En este logro, queremos que una condici\u00f3n sea verdadera 600 veces consecutivamente. La raz\u00f3n de esto es que el Sega Genesis procesa fijamente 60 frames de l\u00f3gica por segundo (m\u00ednimo NTSC?). Y tambi\u00e9n estamos buscando que la \"velocidad sea sobre 300\". Y aparte que el jugador mantenga la velocidad sin pausar el juego.</p> <p>Condiciones</p> <ol> <li> <p>velocidad del jugador sea sobre 300 por 600 frames (o que hubieran pasado 10 segundos).</p> </li> <li> <p>resetear el hit counter si la velocidad es inferior a 300.</p> </li> <li> <p>resetear el hit counter si el jugador pausa el juego.</p> </li> </ol>"},{"location":"Using-Hit-Counts-as-a-Timer-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-04-16 11:15] eldexterr:</code> ES title changed to es</li> </ul>"},{"location":"Using-Hit-Counts-as-a-Timer/","title":"Using Hit Counts as a Timer","text":"<p>In this example, you'll see how hit counts can be used as a timer and award an achievement if a condition is true for 10 seconds.</p> <p>Let's see what Super Hang-On (Mega Drive)'s achievement Speed Freak - Maintain at least 300kph for 10 seconds looks like in the Achievement Editor dialog:</p> <p>Addresses</p> <ul> <li><code>0x0055a</code>: is the speed.</li> <li><code>0x0c757</code>: is 0x00 when the game is unpaused.</li> </ul> <p></p> <p>For this achievement, we are looking for a condition that is met 600 times consecutively. The reason why is that the genesis is locked into processing 60 frames of logic per second (NTSC at least?). And the condition we're checking is \"speed is over 300\". Also, we want the player to keep the speed above 300 without pausing the game.</p> <p>Conditions</p> <ol> <li> <p>player's speed is above 300 for 600 frames (or 10 seconds have passed).</p> </li> <li> <p>reset the hit counter if the speed goes under 300.</p> </li> <li> <p>reset the hit counter if the player pauses the game.</p> </li> </ol>"},{"location":"Using-a-Conditional-ResetIf/","title":"Using a Conditional ResetIf","text":"<p>Real Example document structure:</p> <p>Brief explanation...</p> <p>Addresses</p> <ul> <li><code>0x123</code>: Note about the address</li> <li><code>0x456</code>: another note</li> </ul> <p></p> <p>Conditions</p> <ol> <li> <p>Explaining each requirement in the achievement's logic.</p> </li> <li> <p>Explanation of requirement 2.</p> </li> <li> <p>Explanation of requirement 3...</p> </li> </ol>"},{"location":"Value-Definition/","title":"Value Definition","text":"<p>Value definitions are used for leaderboards and rich presence.</p> <p>A value is calculated by evaluating one or more memory reads. Read values can be scaled (multiplication) or summed (addition) to arrive at the final value.</p> <p>NOTE: Value calculations are performed using 32-bit signed integers. As such, the maximum value is 2147483647 and the minimum value is -2147483648. Values above the maximum will wrap around and register as very negative numbers. </p>"},{"location":"Value-Definition/#value-from-measured","title":"Value from Measured","text":"<p>Starting with the 0.77 DLL (and RetroArch 1.8.2), you can use the Measured flag to generate a Value. This supports all logic supported by the achievement editor, but every condition must have a flag that somehow influences the Measured value (i.e. AddSource, AddAddress). Note that the Measured condition cannot have a multiplier directly on it. If the final clause needs to be multiplied, use an additional AddSource and Measure 0.</p> <p>VAL: <code>A:0xhfe24_A:0xhfe25*60_A:0xhfe22*3600_M:0</code></p> <p>The example provided above reads:</p> <pre><code>AddSource 8-bit 0xfe24\nAddSource 8-bit 0xfe25 * Value 60\nAddSource 8-bit 0xfe22 * Value 3600\nMeasured  Value 0\n</code></pre> <p>The addresses represent frames, seconds, and minutes respectively, and are individually multiplied and then added together to create a total number of frames that can be submitted to the database.</p>"},{"location":"Value-Definition/#value-from-hitcount","title":"Value from HitCount","text":"<p>Sometimes you want to count the number of times something happens and submit that as the value. You can also do this using Measured syntax. Just add a comparison to your final condition. Do not include an explicit Hit target, or that will be the maximum value that can be submitted.</p> <p>The HitCount on the condition will automatically be set to 0 when the leaderboard starts, and the HitCount will be submitted as the Value when the leaderboard submit trigger activates. You can use PauseIf and ResetIf within the Value conditions to further control the behavior.</p> <p>For example:</p> <pre><code>M:0xH1234!=d0xH1234\n</code></pre> <p>Would submit the number of times the byte at $1234 changed while the leaderboard was active.</p> <pre><code>N:0xH1234!=20_M:0xH1234!=d0xH1234\n</code></pre> <p>Would submit the number of times the byte at $1234 changed to something other than 20 while the leaderboard was active.</p>"},{"location":"Value-Definition/#legacy-syntax","title":"Legacy Syntax:","text":"<p>VAL: <code>0xhfe24*1_0xhfe25*60_0xhfe22*3600</code></p> <p>Before the introduction of the Measured flag, Values were written using their own syntax. Some people still prefer this syntax as it's generally easier to do by hand. A legacy value is the sum of a collection of memory values multiplied by modifiers.</p> <p><code>address*modifier</code> (address times modifier)</p> <p>The <code>_</code> underscore operator separates the individual values and acts as 'plus'. So the example above represents:</p> <pre><code>8-bit 0xfe24 times 1, PLUS\n8-bit 0xfe25 times 60, PLUS\n8-bit 0xfe22 times 3600\n</code></pre> <p>The addresses represent frames, seconds, and minutes respectively, and are individually multiplied and then added together to create a total number of frames that can be submitted to the database.</p> <p>To add a constant, use <code>_vN</code> where N is the constant in decimal (i.e. <code>_v10</code>) will add 10 to the result. You can also use negative values for N (i.e. <code>_v-10</code> will subtract 10 from the result.</p> <p>Tip: modifier can be a non-integer value, so if you need to divide by two, you can multiply by 0.5: <code>0xhfe24*0.5</code></p>"},{"location":"Value-Definition/#modifiers","title":"Modifiers","text":""},{"location":"Value-Definition/#max-of","title":"Max of","text":"<p>Multiple value calculations may be joined with a <code>$</code>. This is similar to alt groups in a trigger, but instead of any one alt group needing to be true, whichever \"alt value\" is largest will be used as the overall value for the expression.</p> <p><code>M:0xH1234$M:0xH1235</code> would return the larger of the values at $1234 or $1235.</p>"},{"location":"Value-Definition/#binary-inversion","title":"Binary Inversion","text":"<p>A single memory reference can be prefixed with a <code>~</code> to perform a binary inversion on it. After reading the value from memory, every bit is switches (0s become 1s, 1s become 0s).</p> <p>Typically, this is used to conditionally add or subtract a value:</p> <p><code>A:0xH1234*~0xM1233_M:0xH1235</code> will add the byte at $1234 to the byte at $1235 if bit0 of $1233 is not set.</p>"},{"location":"Value-Definition/#binary-coded-decimal","title":"Binary Coded Decimal","text":"<p>Binary Coded Decimal (BCD) is when a values in memory is stored as decimal digits in each hex digit location. For example, if the memory inspector shows 86 at a byte in memory, it would normally represent the decimal value 134 (0x86 hex = 134 decimal). BCD decoding the value keeps the individual decimal numbers and the result is 86 (0x86 hex = 86 BCD).</p> <p>You can have the runtime decode BCD values by putting a <code>b</code> prefix in front of the memory reference (i.e. <code>b0xW1234</code>). You still need to specify the size of the BCD memory address. b0x1234 reads a 16-bit value. b0xh1234 reads an 8-bit value and b0xX1234 reads a 32-bit value. NOTE: Support for 16-bit and 32-bit BCD decoding is a feature of the 0.075 toolkit.</p>"},{"location":"Value-Definition/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2022-02-04 17:41] Jamiras:</code> add link to Condition Syntax</li> <li><code>[2022-02-04 17:34] Jamiras:</code> Updated Value Definition (markdown)</li> <li><code>[2022-02-04 16:52] Jamiras:</code> Updated Value Definition (markdown)</li> <li><code>[2022-02-04 16:41] Jamiras:</code> Updated Value definition (markdown)</li> </ul>"},{"location":"WIP---Dev-Tips---Code-Notes-En-Masse/","title":"WIP---Dev-Tips---Code-Notes-En-Masse","text":"<p>When RAM digging, you may find yourself wishing for a way to do code notes en masse. Unfortunately, there's not a convenient or simple way to do this, but it is possible and can save a ton of time if you are patient enough to learn how.</p> <p>First, we'll look at how local code notes work: - Open the Memory Inspector and the Code Notes windows. - Go to a random address and type something in as a note, but do not publish it. - Check that address in the Code Notes window. You'll notice that your note is red. - Go to the emulator's RACache directory and open the <code>GameID-User.txt</code> file of the game you have running. - Lines that start with <code>N0:</code> are local code notes. Once you publish a note, it will disappear from the <code>GameID-User.txt</code> file.</p> <p><code>N0:address of the note:\"text of the code note\"</code></p> <ul> <li><code>N0:</code> is how the server knows this is a code note.</li> <li><code>address of the note</code> the memory address, obviously. This will be in hex, not decimal.</li> <li><code>:</code> it's just a separator</li> <li><code>\"text of the code note\"</code> - the contents of the code note, and yes, the quotes are required. Line breaks can be used with <code>\\r\\n</code> and quotes within the note can be used with <code>\\\"</code></li> </ul> <p>Now, the next part requires some general know-how with spreadsheets. It will vary per game, so you'll need to figure out the formula for a lot of things yourself. We will use an example, though.</p> <p>Let's say we want to have notes for all character stats. You will need the following: - Character 1's stat addresses. - An offset for Character 1 and Character 2's first stats.</p> <p>We will use Trails in the Sky SC as an example.</p> <p>Character 1 is Estelle, and her stat addresses are as followed:</p> Address \"Character and Stat\" 0xc5bbcc \"[16-bit] Estelle - Current Level\" 0xc5bbd0 \"[16-bit] Estelle - Max HP\" 0xc5bbd4 \"[16-bit] Estelle - Current HP\" 0xc5bbd8 \"[16-bit] Estelle - Max EP\" 0xc5bbda \"[16-bit] Estelle - Current EP\" 0xc5bbdc \"[16-bit] Estelle - Current CP\" 0xc5bbe0 \"[32-bit] Estelle - Current EXP\" 0xc5bbe4 \"[16-bit] Estelle - STR Stat\" 0xc5bbe6 \"[16-bit] Estelle - DEF Stat\" 0xc5bbe8 \"[16-bit] Estelle - ATS Stat\" 0xc5bbea \"[16-bit] Estelle - ADF Stat\" 0xc5bbec \"[16-bit] Estelle - DEX Stat\" 0xc5bbee \"[16-bit] Estelle - AGL Stat\" 0xc5bbf0 \"[16-bit] Estelle - MOV Stat\" 0xc5bbf2 \"[16-bit] Estelle - SPD Stat\" 0xc5bbfa \"[16-bit] Estelle - RNG Stat\" <p>Character 2 is Joshua. His first stat (Current Level) is at the address 0xc5bc08.</p> <p>0xc5bc08 minus 0xc5bbcc is 0x3c, or 60 in decimal. We can confirm this by checking his last stat (RNG), which is 0xc5bc36, also 0x3c/60 from Estelle's last stat.</p> <p>We'll start by putting Estelle's stats into a spreadsheet and adding a column between the addresses and stats. It will look like this (column numbers in parenthesis):</p> Address (A) Blank Column (B) \"Character and Stat\" (C) 0xc5bbcc \"[16-bit] Estelle - Current Level\" 0xc5bbd0 \"[16-bit] Estelle - Max HP\" 0xc5bbd4 \"[16-bit] Estelle - Current HP\" 0xc5bbd8 \"[16-bit] Estelle - Max EP\" 0xc5bbda \"[16-bit] Estelle - Current EP\" 0xc5bbdc \"[16-bit] Estelle - Current CP\" 0xc5bbe0 \"[32-bit] Estelle - Current EXP\" 0xc5bbe4 \"[16-bit] Estelle - STR Stat\" 0xc5bbe6 \"[16-bit] Estelle - DEF Stat\" 0xc5bbe8 \"[16-bit] Estelle - ATS Stat\" 0xc5bbea \"[16-bit] Estelle - ADF Stat\" 0xc5bbec \"[16-bit] Estelle - DEX Stat\" 0xc5bbee \"[16-bit] Estelle - AGL Stat\" 0xc5bbf0 \"[16-bit] Estelle - MOV Stat\" 0xc5bbf2 \"[16-bit] Estelle - SPD Stat\" 0xc5bbfa \"[16-bit] Estelle - RNG Stat\" <p>In cell B1, we'll use the following formula: <code>=hex2dec(A1)</code> to turn the address to decimal. Then we'll drag it down to populate the other cells. It should now look like this (also, added the row column since we'll need it):</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" <p>Now, we'll populate the cells with Joshua's stats using the offset. In cell B17, we will use the formula <code>=B1+60</code>, which will give us <code>12958728</code>. Drag cell B17 to B32. In cell A17, use the formula <code>=dec2hex</code> and drag that down to A32. It should now look like this:</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" 17 0xc5bc08 12958728 18 0xc5bc0c 12958732 19 0xc5bc10 12958736 20 0xc5bc14 12958740 21 0xc5bc16 12958742 22 0xc5bc18 12958744 23 0xc5bc1c 12958748 24 0xc5bc20 12958752 25 0xc5bc22 12958754 26 0xc5bc24 12958756 27 0xc5bc26 12958758 28 0xc5bc28 12958760 29 0xc5bc2a 12958762 30 0xc5bc2c 12958764 31 0xc5bc2e 12958766 32 0xc5bc36 12958774 <p>Now, we'll copy cells C1:C16 and paste them to cells C17:C32. We'll highlight C17:C32 and use the Find &amp; Replace tool (CTRL+H for Google Sheets) to change instances of <code>Estelle</code> to <code>Joshua</code>, but only for that cell range. It will look like this:</p> Row Address (A) Address in Decimal (B) \"Character and Stat\" (C) 01 0xc5bbcc 12958668 \"[16-bit] Estelle - Current Level\" 02 0xc5bbd0 12958672 \"[16-bit] Estelle - Max HP\" 03 0xc5bbd4 12958676 \"[16-bit] Estelle - Current HP\" 04 0xc5bbd8 12958680 \"[16-bit] Estelle - Max EP\" 05 0xc5bbda 12958682 \"[16-bit] Estelle - Current EP\" 06 0xc5bbdc 12958684 \"[16-bit] Estelle - Current CP\" 07 0xc5bbe0 12958688 \"[32-bit] Estelle - Current EXP\" 08 0xc5bbe4 12958692 \"[16-bit] Estelle - STR Stat\" 09 0xc5bbe6 12958694 \"[16-bit] Estelle - DEF Stat\" 10 0xc5bbe8 12958696 \"[16-bit] Estelle - ATS Stat\" 11 0xc5bbea 12958698 \"[16-bit] Estelle - ADF Stat\" 12 0xc5bbec 12958700 \"[16-bit] Estelle - DEX Stat\" 13 0xc5bbee 12958702 \"[16-bit] Estelle - AGL Stat\" 14 0xc5bbf0 12958704 \"[16-bit] Estelle - MOV Stat\" 15 0xc5bbf2 12958706 \"[16-bit] Estelle - SPD Stat\" 16 0xc5bbfa 12958714 \"[16-bit] Estelle - RNG Stat\" 17 0xc5bc08 12958728 \"[16-bit] Joshua - Current Level\" 18 0xc5bc0c 12958732 \"[16-bit] Joshua - Max HP\" 19 0xc5bc10 12958736 \"[16-bit] Joshua - Current HP\" 20 0xc5bc14 12958740 \"[16-bit] Joshua - Max EP\" 21 0xc5bc16 12958742 \"[16-bit] Joshua - Current EP\" 22 0xc5bc18 12958744 \"[16-bit] Joshua - Current CP\" 23 0xc5bc1c 12958748 \"[32-bit] Joshua - Current EXP\" 24 0xc5bc20 12958752 \"[16-bit] Joshua - STR Stat\" 25 0xc5bc22 12958754 \"[16-bit] Joshua - DEF Stat\" 26 0xc5bc24 12958756 \"[16-bit] Joshua - ATS Stat\" 27 0xc5bc26 12958758 \"[16-bit] Joshua - ADF Stat\" 28 0xc5bc28 12958760 \"[16-bit] Joshua - DEX Stat\" 29 0xc5bc2a 12958762 \"[16-bit] Joshua - AGL Stat\" 30 0xc5bc2c 12958764 \"[16-bit] Joshua - MOV Stat\" 31 0xc5bc2e 12958766 \"[16-bit] Joshua - SPD Stat\" 32 0xc5bc36 12958774 \"[16-bit] Joshua - RNG Stat\" <p>We can repeat this for the remaining characters, but we'll leave it as is to keep it simple.</p> <p>Remember the syntax: <code>N0:address of the note:\"text of the code note\"</code>. This is how we'll set up the spreadsheet: - Add a column to the left of column A and fill that column with <code>N0:</code>. - Copy cells B1:B32 (which are now the hex addresses). - Right-click on B1 and go to Paste Special -&gt; Values only, or simply press CTRL+SHIFT+V. If you don't do this, the next step will mess everything up. - Clear Column C (which were the decimal addresses) and fill C1:C32 with <code>:</code>. - The sheet should now look like this:</p> Row N0: (A) Address (B) : (C) \"Character and Stat\" (D) 01 N0: 0xc5bbcc : \"[16-bit] Estelle - Current Level\" 02 N0: 0xc5bbd0 : \"[16-bit] Estelle - Max HP\" 03 N0: 0xc5bbd4 : \"[16-bit] Estelle - Current HP\" 04 N0: 0xc5bbd8 : \"[16-bit] Estelle - Max EP\" 05 N0: 0xc5bbda : \"[16-bit] Estelle - Current EP\" 06 N0: 0xc5bbdc : \"[16-bit] Estelle - Current CP\" 07 N0: 0xc5bbe0 : \"[32-bit] Estelle - Current EXP\" 08 N0: 0xc5bbe4 : \"[16-bit] Estelle - STR Stat\" 09 N0: 0xc5bbe6 : \"[16-bit] Estelle - DEF Stat\" 10 N0: 0xc5bbe8 : \"[16-bit] Estelle - ATS Stat\" 11 N0: 0xc5bbea : \"[16-bit] Estelle - ADF Stat\" 12 N0: 0xc5bbec : \"[16-bit] Estelle - DEX Stat\" 13 N0: 0xc5bbee : \"[16-bit] Estelle - AGL Stat\" 14 N0: 0xc5bbf0 : \"[16-bit] Estelle - MOV Stat\" 15 N0: 0xc5bbf2 : \"[16-bit] Estelle - SPD Stat\" 16 N0: 0xc5bbfa : \"[16-bit] Estelle - RNG Stat\" 17 N0: 0xc5bc08 : \"[16-bit] Joshua - Current Level\" 18 N0: 0xc5bc0c : \"[16-bit] Joshua - Max HP\" 19 N0: 0xc5bc10 : \"[16-bit] Joshua - Current HP\" 20 N0: 0xc5bc14 : \"[16-bit] Joshua - Max EP\" 21 N0: 0xc5bc16 : \"[16-bit] Joshua - Current EP\" 22 N0: 0xc5bc18 : \"[16-bit] Joshua - Current CP\" 23 N0: 0xc5bc1c : \"[32-bit] Joshua - Current EXP\" 24 N0: 0xc5bc20 : \"[16-bit] Joshua - STR Stat\" 25 N0: 0xc5bc22 : \"[16-bit] Joshua - DEF Stat\" 26 N0: 0xc5bc24 : \"[16-bit] Joshua - ATS Stat\" 27 N0: 0xc5bc26 : \"[16-bit] Joshua - ADF Stat\" 28 N0: 0xc5bc28 : \"[16-bit] Joshua - DEX Stat\" 29 N0: 0xc5bc2a : \"[16-bit] Joshua - AGL Stat\" 30 N0: 0xc5bc2c : \"[16-bit] Joshua - MOV Stat\" 31 N0: 0xc5bc2e : \"[16-bit] Joshua - SPD Stat\" 32 N0: 0xc5bc36 : \"[16-bit] Joshua - RNG Stat\" <ul> <li>Copy cells A1:D32 and paste them into the <code>GameID-User.txt</code> file.</li> <li>Use Find and Replace to change tabs to an empty space/nothing/blank.</li> </ul> <p>The <code>GameID-User.txt</code> contents now look like this:</p> <pre><code>#.#.#.#\nTrails in the Sky SC\nN0:0xc5bbcc:\"[16-bit] Estelle - Current Level\"\nN0:0xc5bbd0:\"[16-bit] Estelle - Max HP\"\nN0:0xc5bbd4:\"[16-bit] Estelle - Current HP\"\nN0:0xc5bbd8:\"[16-bit] Estelle - Max EP\"\nN0:0xc5bbda:\"[16-bit] Estelle - Current EP\"\nN0:0xc5bbdc:\"[16-bit] Estelle - Current CP\"\nN0:0xc5bbe0:\"[32-bit] Estelle - Current EXP\"\nN0:0xc5bbe4:\"[16-bit] Estelle - STR Stat\"\nN0:0xc5bbe6:\"[16-bit] Estelle - DEF Stat\"\nN0:0xc5bbe8:\"[16-bit] Estelle - ATS Stat\"\nN0:0xc5bbea:\"[16-bit] Estelle - ADF Stat\"\nN0:0xc5bbec:\"[16-bit] Estelle - DEX Stat\"\nN0:0xc5bbee:\"[16-bit] Estelle - AGL Stat\"\nN0:0xc5bbf0:\"[16-bit] Estelle - MOV Stat\"\nN0:0xc5bbf2:\"[16-bit] Estelle - SPD Stat\"\nN0:0xc5bbfa:\"[16-bit] Estelle - RNG Stat\"\nN0:0xc5bc08:\"[16-bit] Joshua - Current Level\"\nN0:0xc5bc0c:\"[16-bit] Joshua - Max HP\"\nN0:0xc5bc10:\"[16-bit] Joshua - Current HP\"\nN0:0xc5bc14:\"[16-bit] Joshua - Max EP\"\nN0:0xc5bc16:\"[16-bit] Joshua - Current EP\"\nN0:0xc5bc18:\"[16-bit] Joshua - Current CP\"\nN0:0xc5bc1c:\"[32-bit] Joshua - Current EXP\"\nN0:0xc5bc20:\"[16-bit] Joshua - STR Stat\"\nN0:0xc5bc22:\"[16-bit] Joshua - DEF Stat\"\nN0:0xc5bc24:\"[16-bit] Joshua - ATS Stat\"\nN0:0xc5bc26:\"[16-bit] Joshua - ADF Stat\"\nN0:0xc5bc28:\"[16-bit] Joshua - DEX Stat\"\nN0:0xc5bc2a:\"[16-bit] Joshua - AGL Stat\"\nN0:0xc5bc2c:\"[16-bit] Joshua - MOV Stat\"\nN0:0xc5bc2e:\"[16-bit] Joshua - SPD Stat\"\nN0:0xc5bc36:\"[16-bit] Joshua - RNG Stat\"\n</code></pre> <ul> <li>Save it.</li> <li>Next time the game is loaded and the Code Notes window is opened, all of those notes will appear in red.</li> <li>If we click Publish at the bottom of the Code Notes window, all of the notes will publish at once.</li> </ul> <p>That's all, folks. Learn some spreadsheet formulas and Regular Expressions and you will become a Code Note guru. Please use responsibly and don't actually save over my Trails in the Sky SC notes. Always spot-check addresses here and there to make sure your formulas stay consistent. I added over 500 code notes to the wrong game using an older method, which was much easier to make mistakes. &lt;3 - tele. </p>"},{"location":"WIP---Dev-Tips---Code-Notes-En-Masse/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-01-06 20:59] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2024-01-06 20:58] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-25 18:11] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-10 18:49] televandalist:</code> Updated WIP   Dev Tips   Code Notes En Masse (markdown)</li> <li><code>[2023-04-10 18:30] televandalist:</code> Typos</li> <li><code>[2023-04-10 18:25] televandalist:</code> First draft</li> </ul>"},{"location":"WIP-CoC-FAQ/","title":"WIP CoC FAQ","text":""},{"location":"WIP-CoC-FAQ/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"WIP-CoC-FAQ/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"WIP-CoC-FAQ/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"WIP-CoC-FAQ/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"WIP-CoC-FAQ/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"WIP-CoC-FAQ/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"WIP-CoC-FAQ/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-04-20 00:41] televandalist:</code> Created WIP-CoC-FAQ (markdown)</li> </ul>"},{"location":"WIP-Content-Guidelines/","title":"WIP Content Guidelines","text":"<p>WIP Page. Probably going to separate these into the following: - Game Entries - Achievement Set Requirements (done) - Unwelcome Concepts (done) - Tickets (done) - Hacks - Subsets (done) - Leaderboards &amp; Rich Presence - Hubs</p>"},{"location":"WIP-Content-Guidelines/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-03 03:57] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-06-03 02:00] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-23 22:38] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:59] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:11] televandalist:</code> Updated WIP Content Guidelines (markdown)</li> <li><code>[2023-04-20 04:03] televandalist:</code> Created WIP-Content-Guidelines (markdown)</li> </ul>"},{"location":"WIP-Jr/","title":"WIP-Jr","text":"<p>WIP Page - Combining \"Getting started as an achievement developer,\" \"How to Become an Achievement Developer,\" and \"Set Development Roadmap\" into a sort-of Junior Dev doc.</p> <p>This document covers the basics of how achievements work and the steps one must take to get started with achievement development.</p> <p>Anyone can become a RetroAchievements developer if they put in the effort!</p> <ul> <li>Basic-Concepts</li> <li>Becoming a Junior Developer</li> <li>Choosing a Game to Work On</li> <li>Set Development Roadmap<ul> <li>Initial Research</li> <li>Conceptual Design</li> <li>RAM Digging</li> <li>Achievement Design</li> <li>Pre-Release Steps</li> <li>Release</li> <li>Post-Release</li> </ul> </li> </ul>"},{"location":"WIP-Jr/#basic-concepts","title":"Basic Concepts","text":"<p>So how do RetroAchievements work? Technically, an achievement consists of a series of conditions that make up what we refer to as the <code>achievement logic</code>. When a game with an achievement set is launched in an emulator that supports RetroAchievements, the emulator constantly checks if the conditions of each achievement are met in the current frame of gameplay. When all conditions for a particular achievement are met, the emulator will stop checking the conditions of that achievement and award it to the player.</p> <p>The barebones process of creating achievement logic involves 3 steps: 1. Finding a place in the game's RAM where the information needed for an achievement is stored. Some examples: current level or stage, health, timer, coins, points, ammo, holding a weapon, etc. 2. Creating conditions that must be met in order to award an achievement. 3. Test if the achievement is working as expected.</p> <p>However, this is often much easier said than done. There is a good chance that those steps will need to be repeated many times in order to refine the achievement logic to make it stable enough for players. </p>"},{"location":"WIP-Jr/#becoming-a-junior-developer","title":"Becoming a Junior Developer","text":"<p>If you would like to start developing achievements, the first thing you will need to do is read up on our Developer and Content Guidelines. It is also important to read the various pages in the Achievement Development category, but that can be done as you go. </p> <p>It is strongly recommended to join our Discord server so you can quickly and easily contact other achievement developers who can show you the ropes and help you along. Once you have joined the server, make sure you get verified by following the instructions in the <code>#welcome</code> channel. If you already know what game you'd like to make achievements for, you can go ahead and ask for the <code>jr-dev</code> role in the <code>#tech-support</code> forum channel by creating a post tagged as <code>Join Team</code> and pinging <code>QA-Maintainer</code>. Once you have the <code>jr-dev</code> role, you will have access to the <code>#jr-devs</code> channel, where you can talk to code reviewers and ask any development-related questions.</p>"},{"location":"WIP-Jr/#choosing-a-game-to-work-on","title":"Choosing a Game to Work On","text":"<p>After you have become a Junior Developer, you can decide on a game to work on. If you need an entry made for it, you can ask code reviewers to do so. They will need to open a forum topic for you anyway, assuming it doesn't already have one. You can now claim it for achievement development. </p>"},{"location":"WIP-Jr/#set-development-roadmap","title":"Set Development Roadmap","text":"<p>Once you have chosen your game and have claimed it for development, you need to plan your achievement set. You should know enough about the game to give it justice. The following are some tips on coming up with a plan:</p>"},{"location":"WIP-Jr/#initial-research","title":"Initial Research","text":"<ul> <li>Read through the game manual: Remember those? Game manuals often give insight into the game's story and mechanics.</li> <li>GameFAQs: Check the guides, FAQs, cheats, boards, etc. Soak up the info.</li> <li>Longplays and Speedruns: Seeing others play the game may give you ideas or show you something new.</li> <li>Similar Sets: Does a different port of the game have a set? What's it like? What would you change?</li> </ul>"},{"location":"WIP-Jr/#conceptual-design","title":"Conceptual Design","text":"<ul> <li>Start brainstorming your achievement list. How will you split up the progression achievements? What are the notable events in the game? Are there collectibles? Are there score benchmarks? What secrets/easter eggs are notable enough? Does the game have an internal reward system?</li> <li>Check our guide about Achievement Design</li> <li>Check and test if your designs are possible.</li> <li>Figure out what data you will need to make the achievements. For example: achievements for collectibles will require the RAM addresses where their data is stored.</li> </ul>"},{"location":"WIP-Jr/#ram-digging","title":"RAM Digging","text":"<p>Once you have a plan, it is recommended that you post it in the game's forum topic. This will allow the community to give feedback and will give code reviewers an idea of where you're at from a design standpoint. It is important to be open to receive feedback and suggestions!</p>"},{"location":"WIP-Jr/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 01:59] televandalist:</code> Created WIP-Jr (markdown)</li> </ul>"},{"location":"WIP-Overview/","title":"WIP Overview","text":""},{"location":"WIP-Overview/#overview","title":"Overview","text":"<p>The docs are currently under heavy construction. For starters, the following pages are going to be moved to the site:</p> <ul> <li>RetroAchievements Manifesto</li> <li>Users Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> <li>Developer's Code of Conduct</li> <li>Set Plagiarism</li> <li>Achievement Scoring</li> <li>Achievement Set Revisions</li> <li>Achievements for ROM hacks</li> <li>Subsets</li> <li>Working with the Right ROM</li> <li>FAQ</li> </ul> <p>The plan is to have any documentation involving guidelines/policy as well as a general FAQ be in plain sight on retroachievements.org. Some of the pages will be merged and will result in the following categories:</p> <ul> <li>User Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> <li>Developer Code of Conduct</li> <li>Content Guidelines</li> <li>General FAQ</li> </ul> <p>This will eventually allow for the wiki to be more open and dedicated to support docs, tutorials, resources, etc.</p> <p>From sidebar:</p> <ul> <li>WIP User Code of Conduct</li> <li>WIP CoC FAQ</li> <li>WIP Content Guidelines</li> <li>WIP---Dev-Tips---Code-Notes-En-Masse</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/","title":"User Code of Conduct","text":"<ul> <li>Mission Statement</li> <li>Rules     - Unacceptable Social Behavior     - Freedom of Speech</li> <li>Moderation     - Order of Action     - Reporting Wrongful Action     - Ban Appeal</li> <li>Cheating</li> <li>FAQ</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/#mission-statement","title":"Mission Statement","text":"<p>The RetroAchievements project aims to provide tools for creating achievements for retrogames and ways to enjoy such creations. We strive to promote a healthy and collaborative community around this hobby. Everything we produce is made available for free and we will never profit from it.</p>"},{"location":"WIP-User-Code-of-Conduct/#rules","title":"Rules","text":"<p>In order to support the growth of our community as described in our mission statement, we need some rules.  1. Don't be a jerk or generally obnoxious - nobody likes trolls. 2. Do not use the RetroAchievements website or Discord server to share or request copyrighted material. This includes direct downloads, links to ROM sites, etc. 3. Keep the Discord channels and forum threads on-topic. 4. When a moderator/admin asks you to stop, you should stop. 5. When in doubt, ask a <code>@mod</code> in Discord or send a message to RAdmin on the website. 6. Do not advertise products, services, or other Discord servers without approval.</p>"},{"location":"WIP-User-Code-of-Conduct/#_1","title":"WIP User Code of Conduct","text":"<p>Moderation typically follows a \"three strikes\" warning system, but there are certain behaviors that will not be tolerated and will likely expedite removing someone from the community. These behaviors include, but are not limited to: - Bigotry. This includes racism, sexism, elitism; intolerance regarding others' nationality, religion, sexual orientation, political beliefs, etc. - Public or private harassment. - Unwelcome sexual attention or advances towards others. - Doxing. This is publishing others' private information, such as photos, contact information, etc. without their explicit permission. - Spamming, excessive shitposting, etc. - Personal attacks, as in making abusive remarks on or relating to one's person, instead of providing evidence when examining another person's claims or comments. - Posting pornography, as in images or descriptions of erotic behavior intended to cause sexual excitement.  - Posting gruesome or gory images intended to cause disgust. - Heated public arguments.</p> <p>Please report to moderators/admins cases where these rules and behaviors are being violated. The moderators will step in to cool things down if arguments start getting out of hand.</p>"},{"location":"WIP-User-Code-of-Conduct/#freedom-of-speech","title":"Freedom of Speech","text":"<p>Some people show up just to complain and all admins/mods are evil. We get it. If you want to constantly rant or dump derogatory comments about how we run things here, you're free to do that. However, this can be demotivating and wastes a lot of volunteers' time; therefore, we don't want it on our forums or Discord Server. There are plenty of options where you can do it around the internet.</p> <p>Keep in mind that RetroAchievements.org is NOT a bastion of freedom of speech.</p> <p>Criticism is welcome, but just be sure to be civil.</p>"},{"location":"WIP-User-Code-of-Conduct/#moderation","title":"Moderation","text":"<p>If you feel moderation is needed, ping the <code>@mod</code> role on our Discord server, or direct your issues to RAdmin, a shared mod-mail account.</p>"},{"location":"WIP-User-Code-of-Conduct/#order-of-action","title":"Order of Action","text":"<p>The moderation teams' goal is to assure users adhere to the User's Code of Conduct. If a member from moderation spots an action that is a breach of this Code of Conduct, the following steps will be taken for proper action:</p> <ol> <li> <p>Formal and diplomatic warning via carl-bot. (no sarcasm, no threatening tone).</p> </li> <li> <p>If the warning is ignored, the offender will be kicked from our Discord server.</p> </li> </ol> <p>Note: For website offenses, Step 2 is ignored. If the offender ignores the warning in Step 1, the next action results in a ban as detailed below:</p> <ol> <li>If the offender continues to ignore the moderation, they'll be banned from our Discord server. If the offender has the \"Developer\" role on the website, their privileges will be removed.</li> </ol>"},{"location":"WIP-User-Code-of-Conduct/#reporting-wrongful-moderation","title":"Reporting Wrongful Moderation","text":"<p>If you think moderators are not acting like described above, send a Direct Message to RAdmin or email ramodmail@gmail.com. This is a shared moderation account that all mods and admins see. The issue will be discussed and dealt with fairly.</p> <p>Admins/mods who do not follow or enforce this Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's administration.</p>"},{"location":"WIP-User-Code-of-Conduct/#ban-appeal","title":"Ban Appeal","text":"<p>If you've been banned and want to appeal to have your account access back, please send a site Direct Message to RAdmin. In the event that your site account has been banned, please send an email to ramodmail@gmail.com.</p>"},{"location":"WIP-User-Code-of-Conduct/#cheating","title":"Cheating","text":"<p>Check the Global Leaderboard and Achievement Hunting Rules.</p>"},{"location":"WIP-User-Code-of-Conduct/#faq","title":"FAQ","text":"<ul> <li>When a member gets banned from the Discord server, are they automatically banned from the website?</li> <li>I created a Discord server because I want more freedom than what I have on the RetroAchievements community. Can I promote my server here?</li> <li>Is it mandatory for achievement creators to join the Discord server?</li> <li>If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?</li> <li>If I'm banned from the Discord server but I still want to create achievements, what should I do?</li> </ul>"},{"location":"WIP-User-Code-of-Conduct/#when-a-member-gets-banned-from-the-discord-server-are-they-automatically-banned-from-the-website","title":"When a member gets banned from the Discord server, are they automatically banned from the website?","text":"<p>No.</p> <p>The member will still be able to use our services to play retrogames with achievements. But if the disruptive behavior continues on the website, they'll be banned from there too.</p>"},{"location":"WIP-User-Code-of-Conduct/#i-created-a-discord-server-because-i-want-more-freedom-than-what-i-have-on-the-official-retroachievements-server-can-i-promote-my-server-here","title":"I created a Discord server because I want more freedom than what I have on the official RetroAchievements server. Can I promote my server here?","text":"<p>No.</p>"},{"location":"WIP-User-Code-of-Conduct/#is-it-mandatory-for-achievement-creators-to-join-the-discord-server","title":"Is it mandatory for achievement creators to join the Discord server?","text":"<p>No.</p> <p>Joining our Discord server is optional. But if you're in the list of banned users there, you cannot have the \"Developer\" role on the website.</p>"},{"location":"WIP-User-Code-of-Conduct/#if-an-achievement-creator-is-banned-from-discord-will-they-lose-the-developer-role-on-the-website","title":"If an achievement creator is banned from Discord will they lose the \"Developer\" role on the website?","text":"<p>Yes.</p>"},{"location":"WIP-User-Code-of-Conduct/#if-im-banned-from-the-discord-server-but-i-still-want-to-create-achievements-what-should-i-do","title":"If I'm banned from the Discord server but I still want to create achievements, what should I do?","text":"<p>Send your appeal to RAdmin or ramodmail@gmail.com to try and have your ban lifted.</p> <p>It doesn't really matter if you want to join the server or not, if you're in the list of banned users in our Discord server, you cannot have the \"Developer\" role on the website. </p>"},{"location":"WIP-User-Code-of-Conduct/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-30 14:39] televandalist:</code> Updated WIP User Code of Conduct (markdown)</li> <li><code>[2023-06-06 10:44] televandalist:</code> Fix broken link</li> <li><code>[2023-04-20 00:39] televandalist:</code> Created WIP-User-Code-of-Conduct (markdown)</li> </ul>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/","title":"WIP \u2010 How Does RetroAchievements Work","text":"<p>RetroAchievements (RA) provides users the ability to earn achievements in retro games from an RA achievement set.  It awards achievements by comparing a game\u2019s memory, henceforth referred to as RAM, to achievement code written by an RA developer.  Achievement code, also known as logic, is a list of memory conditions chosen by the developer, that when all are simultaneously true on a single frame, will award an achievement.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#what-is-an-achievement-set","title":"What Is An Achievement Set?","text":"<p>An achievement set is the compilation of individual achievements, rich presence and leaderboards for a particular game.  Achievements are comprised of achievement logic, a title, a description, a point value and a badge.  Additionally, a set must contain a Rich Presence script which provides site users information on where active players are in a game.  Sets may have leaderboards that track how well players perform in certain things in a game such as how quickly they can beat stages, how many points they can score and many other things.  RA users interface with all these components and subcomponents.  Each one is a vital part of the player experience.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#what-is-achievement-code-and-how-is-it-written","title":"What Is Achievement Code And How Is It Written?","text":"<p>RA code is a custom text based language that is interpreted by RA supporting emulators.  Developers write code using either the Achievement Editor in the RAIntegration toolkit or by using RATools, a standalone executable that provides a scripting language for achievement development.  Both the achievement editor and RATools produce code that is used for all achievements, leaderboards and Rich Presence.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#how-is-achievement-code-processed","title":"How Is Achievement Code Processed?","text":"<p>A game\u2019s RAM is its most basic form.  RAM is simply the game's memory addresses and their respective values at any given time.  When processed by a console or emulator, the RAM can be used to recognize what is happening within the game.  Games are processed in a series of frames, generally 60, 50, 30 or 25 per second depending on console and format.  RA processes all unearned achievement logic in a set every frame.  Because of this, developers can create logic such that when all of its conditions are simultaneously true, identify something uniquely precise happening in a game and award an achievement, activate a leaderboard and provide accurate Rich Presence.  It is an achievement developer\u2019s job to understand enough of a game's RAM to be able to construct this logic.</p> <p>Understanding how the RAM works that a developer intends to use in their logic is essential to creating a stable set that awards achievements, submits leaderboard scores and accurately displays Rich Presence only as intended.  RA developers use developer emulator tools to inspect a game's RAM and determine which addresses are responsible for things they intend to use for logic.  Developers have many ways to precisely define exactly which memory conditions must be true in order to construct logic, including retaining knowledge that something occurred previously in memory, but may no longer be true.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#achievement-logic-and-processing-example","title":"Achievement Logic and Processing Example","text":"<p>As a simple example, to award an achievement for obtaining the hammer in Zelda II: The Adventure of Link, a developer would need to figure out which memory addresses within the game were associated with a few unique things about obtaining the hammer.  There are often many ways to do this.  One way a developer might approach this achievement is to find the addresses for the room ID to ensure the player is in the room with the hammer, also perhaps an area ID to ensure the player is in the right section of the game and lastly an address that indicates whether the player actually gets the hammer.  The reason a room and area ID are important is because when a player loads a save file that has collected the hammer, the memory would indicate that possessed of the hammer goes from untrue to true, but this isn't where the achievement should award.  The room and area ID conditions would ensure that a player was actually obtaining the hammer in game and not just loading a save file that already possessed it.  A solid achievement could be constructed to award when the following is true simultaneously:</p> <p>Room ID = room the hammer is in Area ID = area of game the hammer is in Possesion of hammer changes from not possessed to possessed</p> <p>Here is what this achievement would look like in the Achievement Editor  In this example, address 0x0561 is the room ID and its value is 0x15 when the player is in the room with the hammer, address 0x076e is the area ID and its value is 0x02 when in Death Mountain where the hammer is located and Bit0 of address 0x078b indicates if the player has the hammer.  This bit changes from 0 to 1 when the player acquires the hammer, so the achievement checks for a frame where this bit is greater than it was the previous frame which is precisely when the hammer is obtained since bits can only be either 1 or 0.  If all three conditions are true on the same frame, the achievement is awarded.  This can only happen when the player obtains the hammer while in the hammer room in Death Mountain, not at some other time such as loading a save file.</p> <p>Every frame the player is playing the game, the RAM is being compared to the achievement logic to check if all conditions are true on that frame.  For this example achievement, all conditions can only be true on the same frame when a player is in the room and area where the hammer is obtained and the player obtains the hammer.  When that happens, all of the conditions defined in the logic will be true and the achievement will be immediately awarded.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#leaderboard-and-rich-presence-code","title":"Leaderboard and Rich Presence Code","text":"<p>Leaderboards function quite similarly to achievements in terms of logic, but need a list of conditions to tell the leaderboard when to activate, when to cancel itself, and when and what value to submit to the leaderboard.  Creating a leaderboard is essentially like creating a few small achievements that will be processed sequentially.</p> <p>Rich Presence code is very similar to achievement and leaderboard code, but is written slightly differently due to the way it is handled by the site.  Rich Presence is written and submitted to RA as a script, as opposed to a string of code like achievements and leaderboards.  It still uses the same fundamental code as achievements and leaderboards, but has some additional features such as custom macros that may be used.</p>"},{"location":"WIP-%E2%80%90-How-Does-RetroAchievements-Work/#take-aways","title":"Take Aways","text":"<p>The key to writing solid code is to first understand what in RAM can be used to recognize a particular game event for which a developer intends to award an achievement, use for a leaderboard or Rich Presence.  The next steps are finding the necessary memory addresses and their values to recognize when the event occurs and constructing logic to create a list of conditions that will only be simultaneously true on the intended frame.</p>"},{"location":"Ways-to-Contribute/","title":"Ways to Contribute","text":"<p>If you do not wish to become an achievement developer, but would still like to contribute to RetroAchievements, there are many ways to do so:</p> <ul> <li>Report Broken Achievements<ul> <li>Reporting Via Emulator</li> <li>Reporting Via Website</li> </ul> </li> <li>Suggest Achievement Ideas</li> <li>Give Feedback</li> <li>Create Badges and Game Icons</li> <li>Help with the Documentation</li> <li>Participate in Events</li> <li>Report Title and Description Errors</li> <li>Playtesting</li> <li>Compatibility Testing</li> <li>Write for RANews</li> <li>Create RAGuides</li> <li>Help with RAPatches</li> </ul>"},{"location":"Ways-to-Contribute/#report-broken-achievements","title":"Report Broken Achievements","text":"<p>If an achievement triggered at a wrong time or didn't trigger at all, please report it. We know that many users love free points, but please, even if an achievement triggered at a wrong time, report it!</p> <p>Another important situation that needs to be reported is a cheevo triggering by using some kind of cheat in the game (e.g. stage select code), or by loading a saved game.</p> <p>There are two ways to report a broken cheevo: directly in the emulator or via website. On both cases, add details of the state of your game, when it triggered/didn't trigger, what game mode, where you were when it happened/didn't happen, if you had reset the game recently, anything else you think may be relevant to the achievement. This is necessary for our system so the devs know where there is a problem.</p>"},{"location":"Ways-to-Contribute/#reporting-via-emulator","title":"Reporting Via emulator","text":"<p>Go to RetroAchievements -&gt; Report Broken Achievements, this feature is only available on official emulators (not on RetroArch).</p> <p>See this example:</p> <p>.</p>"},{"location":"Ways-to-Contribute/#report-via-website","title":"Report Via Website","text":"<p>On every achievement's page you see a link saying <code>Report an issue for this achievement</code>, like in the image below:</p> <p></p>"},{"location":"Ways-to-Contribute/#suggest-achievement-ideas","title":"Suggest Achievement Ideas","text":"<p>If you know a game very well, you probably can have some cool ideas of challenges for the game. Post your ideas on the forum topic related to the game.</p> <p>We have a guide on how to think about and design good achievements, not the technical side but the conceptual. Then even non-developers can get some inspiration from that info.</p>"},{"location":"Ways-to-Contribute/#give-feedback","title":"Give Feedback","text":"<p>Give feedback in the forums about what you like or dislike about the achievements sets. Be specific and leave details.</p>"},{"location":"Ways-to-Contribute/#create-badges-and-game-icons","title":"Create Badges and Game Icons","text":"<p>If you like to play with graphics you can create some art for the achievements badges or icons for the games. Using the screenshot feature from the emulator itself can help with this, and then you can edit to make something cool.</p> <p>You can see more info about it on the Badge and Icon Creation page.</p>"},{"location":"Ways-to-Contribute/#help-with-the-documentation","title":"Help with the Documentation","text":"<p>If you have a github account and know the basics of Markdown, you can help with the documentation. Fixing typos, grammar or inaccurate information.</p> <p>Take a look at this page to know the details: Contributing with the docs</p>"},{"location":"Ways-to-Contribute/#participate-in-events","title":"Participate in Events","text":"<p>Such as Achievement of the Week, Leaderboard of the Week or other events that happens on our discord server.</p>"},{"location":"Ways-to-Contribute/#report-title-and-description-errors","title":"Report Title and Description Errors","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#playtesting","title":"Playtesting","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#compatibility-testing","title":"Compatibility Testing","text":"<p>Section Pending</p>"},{"location":"Ways-to-Contribute/#write-for-ranews","title":"Write for RANews","text":"<p>Section Pending - for now, see the RANews Repository.</p>"},{"location":"Ways-to-Contribute/#create-raguides","title":"Create RAGuides","text":"<p>Section Pending - for now, see the RAGuides Repository.</p>"},{"location":"Ways-to-Contribute/#help-with-rapatches","title":"Help with RAPatches","text":"<p>Section Pending - for now, see the RAPatches Repository.</p>"},{"location":"Ways-to-Contribute/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-05 22:32] televandalist:</code> Updated Ways to Contribute (markdown)</li> <li><code>[2023-06-05 22:29] televandalist:</code> Updated Ways to Contribute (markdown)</li> <li><code>[2023-06-05 21:59] televandalist:</code> Updated Non Developer Contributions (markdown)</li> <li><code>[2023-06-05 21:58] televandalist:</code> Added quick links/ToC - Added WIP sections for Playtesting, Compatibility Testing, RANews, and RAGuides</li> <li><code>[2023-06-05 20:42] televandalist:</code> Renamed from \"How to contribute if you're not an achievement developer\" to \"Ways to Contribute\"</li> </ul>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/","title":"Por que no deber\u00edas utilizar la funci\u00f3n de cargar estado","text":"<p>Nota: actualmente el problema descrito solamente sucede en RetroArch.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#hardcoresoftcore","title":"Hardcore/Softcore","text":"<p>Algunos usuarios les gusta utilizar la funci\u00f3n de guardar/cargar estado para salvar su progreso en un juego. Puede que ya lo sepas pero, esta funci\u00f3n no esta permitida cuando se juega en modo hardcore. Pero algunos usuarios no son jugadores hardcore y prefiero mantener el modo hardcore desactivado (vamos a llamar a este modo como softcore).</p> <p>Algunas veces algunos usuarios reportan que un logro no se desbloqueo, y cuando se les pregunta dicen que estaban jugando en softcore.</p> <p>Una cosa que tienes que tener en cuenta es:</p> <p>Si utilizas la funci\u00f3n de cargar estado espera tener problemas con los logros cuando no se disparan cuando se suponia que se ten\u00edan que disparar.</p> <p>Ahora vamos a intentar explicar para aquellos que no est\u00e1n muy familiarizados con los detalles sobre el desarrollo de logro y por que este tipo de problema ocurre.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#concepto-basico-detras-de-un-logro","title":"Concepto B\u00e1sico detr\u00e1s de un logro","text":"<p>T\u00e9cnicamente un logro es un grupo de condiciones que tienen que ser cumplidas en un frame en particular dentro del v\u00eddeo juego.</p> <p>Cuando abres un juego en un emulador con la funci\u00f3n de RetroAchievements integrada, el emulador esta siempre revisando si las condiciones son cumplidas en el frame actual. Cuando todas las condiciones en el ese logro en particular son cumplidas, el logro es otorgado y el emulador deja de revisar si las condiciones para ese logro.</p> <p>Ejemplos de condiciones:</p> <ul> <li>la barra de vida esta llena</li> <li>la barra de vida se bajo</li> <li>se tienen 9 vidas</li> <li>actualmente estas en el stage 3</li> <li>en la pantalla de titulo del juego</li> <li>se esta empezando una boss fight</li> <li>el juego esta pausado</li> </ul> <p>El problema con softcore es que cuando cargas un estado de guardado puedes arruinar la l\u00f3gica detr\u00e1s del logro.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplos","title":"Ejemplos","text":""},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplo-1-completa-el-juego-sin-utilizar-passwords","title":"Ejemplo 1: Completa el juego sin utilizar passwords","text":"<p>Imag\u00ednate un juego con 5 stages y con la funci\u00f3n de password.</p> <p>Tal vez las condiciones para que el logro \"Completa el juego sin utilizar passwords\" salte son (en un logro de verdad por lo general hay mas condiciones, pero para esta explicaci\u00f3n vamos a considerar solamente estas):</p> <ul> <li>estar en stage 1 (y memoriza este evento como algo que paso)</li> <li>estar en stage 2 (memorizatelo)</li> <li>estar en stage 3 (memorizatelo)</li> <li>estar en stage 4 (memorizatelo)</li> <li>estar en stage 5 (memorizatelo)</li> <li>completa el stage 5</li> </ul> <p>Entonces para conseguir este logro lo que necesitas es estar en todos los niveles al menos alguna vez y completar el juego.</p> <p>Cuando estas en el stage 1, el emulador lo recuerda, y lo mismo para todos los dem\u00e1s stages. Y cuando terminas el stage 5 (completa el juego) obtienes el logro.</p> <p>Ahora imag\u00ednate este escenario:</p> <ul> <li>un jugador softcore empez\u00f3 el juego y jugo los stages 1, 2 y 3</li> <li>el necesitaba dejar de jugar cuando se encontraba en el stage 4 y entonces guardo un estado para continuar despu\u00e9s</li> <li>cerro el emulador</li> <li>despu\u00e9s el pod\u00eda jugar de nuevo, empez\u00f3 el juego y cargo el estado que hab\u00eda guardado</li> <li>jugo los stages 4, 5 y completo el juego</li> </ul> <p>En este escenario el logro no saldr\u00eda.</p> <p>Despu\u00e9s de cerrar el emulador el \"olvida\" lo que paso en los stages 1, 2 y 3. Cuando corres el emulador/juego de nuevo y cargas el estado en el stage 4, el emulador no va a detectar que pasaste por lo stages anteriores. Entonces el logro no se va a desbloquear.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ejemplo-2-derrota-al-jefe-x-sin-recibir-dano","title":"Ejemplo 2: Derrota al jefe X sin recibir da\u00f1o","text":"<p>Lo mas probable es que la condiciones que tienen que ser cumplidas para que este logro salte son:</p> <ol> <li>entra al cuarto del jefe (y memoriza este evento como algo que paso).</li> <li>si se toma da\u00f1o, olvida que se entro al cuarto del jefe.</li> <li>derrota al jefe.</li> </ol> <p>En otras palabras: para obtener este logro el emulador tiene que \"saber\" que entraste al cuarto del jefe, que no obtuviste ning\u00fan da\u00f1o, y que venciste al jefe.</p> <p>El detalle importante en el que tenemos que prestar atenci\u00f3n es: cuando recibes alg\u00fan da\u00f1o, el emulador \"olvida\" que entraste al cuarto del jefe. Entonces incluso si cargaste un estado en alg\u00fan punto en el que aun no recib\u00edas da\u00f1o pero ya estabas dentro del cuarto del jefe, el emulador no va a detectar cuando entras por primera vez al cuarto. Y el logro no va a saltar.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#ultimas-palabras","title":"Ultimas Palabras","text":"<p>Cuando reportes logros rotos da la mayor cantidad de detalles que sean posibles, y no olvides si estabas o no jugando en hardcore.</p> <p>Si quieres solicitar que un administrador te otorgue un logro manualmente cuando este no se disparo, ten en cuenta proveer pruebas. Especialmente para logros como en los ejemplos de arriba (no recibir da\u00f1o, no passwords, no muertes, etc).</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-31 10:50] eldexterr:</code> Created Why you shouldn't use the load state feature es (markdown)</li> </ul>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/","title":"Why you shouldn't use the load state feature","text":"<p>Note: currently the issue described here happens only on DuckStation standalone and RetroArch versions older than 1.9.1.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#hardcoresoftcore","title":"Hardcore/Softcore","text":"<p>Some users like to use the save/load state feature to save their progress in a game. As you may know, this feature isn't allowed when playing with hardcore mode. But some users aren't hardcore gamers and prefer to keep hardcore mode disabled (let's call this mode softcore).</p> <p>From time to time some users report that an achievement isn't triggering, and when asked they say they were playing in softcore.</p> <p>One thing you all have to keep in mind is:</p> <p>If you use the load state feature expect to have issues of cheevos not triggering when they are expected to trigger.</p> <p>Here we'll try to explain to those who don't know the details of achievements development why this kind of issue happens.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#basic-concept-behind-an-achievement","title":"Basic concept behind an achievement","text":"<p>Technically an achievement is a group of conditions that must be met in a particular frame of the video game.</p> <p>When you launch a game using an emulator with the RetroAchievements feature, the emulator is always checking if those conditions are met in the current frame. When all conditions for a particular achievement are met, it is awarded and the emulator stops checking the conditions for that achievement.</p> <p>Examples of conditions:</p> <ul> <li>health bar is full</li> <li>health bar decreased</li> <li>have 9 lives</li> <li>currently on stage 3</li> <li>at the title screen of the game</li> <li>starting the boss fight</li> <li>the game is paused</li> </ul> <p>The problem with softcore is that when you load a saved state you can ruin the logic behind an achievement.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#examples","title":"Examples","text":""},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#example-1-beat-the-game-without-passwords","title":"Example 1: Beat the game without passwords","text":"<p>Imagine a game with 5 stages and with the password feature.</p> <p>Some probable conditions to trigger the \"Beat the game without passwords\" achievement are (in a real cheevo there will be more conditions, but for this explanation let's consider only these ones):</p> <ul> <li>be at stage 1 (and memorize this event as something that happened)</li> <li>be at stage 2 (memorize it)</li> <li>be at stage 3 (memorize it)</li> <li>be at stage 4 (memorize it)</li> <li>be at stage 5 (memorize it)</li> <li>finish stage 5</li> </ul> <p>So to get this achievement you have to pass through all stages and then beat the game.</p> <p>When you are at stage 1, the emulator memorizes it, the same thing for all other stages. And when you finish stage 5 (beat the game) you get the achievement.</p> <p>Now imagine this scenario:</p> <ul> <li>a softcore player started the game and played stages 1, 2 and 3</li> <li>they needed to stop playing when at stage 4 and then they saved a state to continue later</li> <li>they closed the emulator</li> <li>later they could play again, started the game, and loaded the state they saved</li> <li>played stages 4, 5 and beat the game</li> </ul> <p>In this scenario, the achievement won't trigger.</p> <p>After closing the emulator it \"forgets\" that you passed through stages 1, 2, and 3. When you run the emulator/game again and load the state being on stage 4, the emulator won't detect that you passed through the previous stages. Then the achievement won't trigger.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#example-2-defeat-boss-x-without-taking-damage","title":"Example 2: Defeat boss X without taking damage","text":"<p>Most likely the conditions to be met in a frame to make this achievement trigger are:</p> <ol> <li>entered the boss room (and memorize this event as something that happened).</li> <li>if the player takes any damage, forget they entered the boss room.</li> <li>beat the boss.</li> </ol> <p>In other words: to get this achievement the emulator must \"know\" that you entered the boss room, didn't take any damage, and beat the boss.</p> <p>The important detail to pay attention to here: when you take any damage, the emulator \"forgets\" that you entered the boss room. Then even if you load a state to a point where you didn't take any damage but already entered the room, the emulator won't detect that you entered the room. And then the achievement won't trigger.</p>"},{"location":"Why-you-shouldn%27t-use-the-load-state-feature/#final-words","title":"Final Words","text":"<p>When reporting a broken achievement give as many details as possible, and don't forget to mention if you are playing on hardcore mode or not.</p> <p>If you want to request an admin to manually award you an achievement that didn't trigger, be sure to provide qualified proof. Especially for achievements like those in the examples above (no damage, no passwords, no death, etc).</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/","title":"Working with DLC for the PlayStation Portable","text":"<p>Various games for the PlayStation Portable support DLC content. Depending on the game, this may come in different formats with different processes for installation.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#standard","title":"Standard","text":"<p>Traditional (generally paid) DLC was installed by the Playstation Store into game directories. Most of the time this will consist of one or more edat files and a param.pbp. Sometimes more files or directories are needed as well. If you already have decrypted DLC in this format, place it in saves/PSP/GAME/&lt;game_id&gt;/ in the exact format it came in. The game ID -must- match the region of the game you're playing. For example, Dissidia 012 will use ULUS10566 for the US version and ULES01505 for the EU version. For users dumping data from real hardware, you'll need to use custom firmware and the npdecrypter plugin to decrypt your DLC to a format usable by PPSSPP. Further information can be found in the plugin's readme.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#save-file","title":"Save File","text":"<p>A number of games distributed (generally free) DLC as extra save files for the games. These will have their own specifically-named directories which are placed alongside your game savedata in saves/PSP/SAVEDATA/. In a few rare cases, there may be multiple sets of DLC that cannot be installed simultaneously for games using this method. For users dumping data from real hardware, just copy it to the same location from the memory stick. Nice and simple. Despite the free nature of this DLC, we don't believe we have the legal rights to distribute it ourselves, so please don't ask.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#updates","title":"Updates","text":"<p>These can be a bit complicated. Currently the only way to apply updates tends to be by patching the update into the iso itself, after decrypting it on real hardware. This is messy and suboptimal, but there isn't a way around it right now. You'll need to open the iso in a tool like UMDGen and insert/replace the updated files in usrdir. Exact per-game instructions on doing so are outside the scope of this guide. Of note, this will be required to be able to use the DLC for Little Big Planet and Bleach: Heat the Soul 7, and may be necessary for other games as well. In the future, this step hopefully can be skipped.</p> <p>Further information: https://github.com/hrydgard/ppsspp/issues/12344</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#killzone-liberation","title":"Killzone Liberation","text":"<p>This game's final chapter is only available as DLC. This specific game had a very strange DLC configuration, requiring downloading a free \"game\" through the PSP's browser, running it to unpack the DLC file, then leaving the second \"game\" present while playing the real one. Unfortunately, it uses a wide variety of kernel calls unique to this game that aren't emulated yet. Even with the DLC in its post-extraction state, it just causes the game to freeze when present. There's no way to emulate the game's final chapter at this time.</p> <p>Further information: https://github.com/hrydgard/ppsspp/issues/12343</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#note","title":"Note","text":"<p>While links to github issues are provided here, please refrain from commenting on them unless you have constructive information to provide about the issues at hand. A simple supportive thumbs up to indicate interest in an issue is sufficient.</p>"},{"location":"Working-with-DLC-for-the-PlayStation-Portable/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2021-10-01 06:12] Sanaki:</code> Updated Working with DLC for the PlayStation Portable (markdown)</li> <li><code>[2021-10-01 06:08] Sanaki:</code> Hopefully fix a tag issue on the deployed docs</li> <li><code>[2021-09-30 23:26] Sanaki:</code> Created Working with DLC for the PlayStation Portable (markdown)</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/","title":"Trabajando con el ROM apropiado","text":"<p>Relacionado: Logros para hacks de ROM, Sets Bonus</p> <p>Solamente un set es permitido por juego y por consola. Esto es aplica en casos de existente revisiones oficiales (ex. Rev A), parches oficiales, no-oficiales, y otras regiones.</p> <p>Sets Bonus son una excepci\u00f3n de esta esta regla, pero son considerado como una extensi\u00f3n del set est\u00e1ndar y estos siguen reglas diferentes sobre el tipo de logros que son permitidos.</p>"},{"location":"Working-with-the-Right-ROM-es/#seleccion-de-rom","title":"Selecci\u00f3n de ROM","text":"<p>Casi cualquier juego cuenta con m\u00faltiples versiones del ROM , algunas veces asta docenas. Y algunas veces hay diferencias bastante mayores hasta el punto en el que, un ROM ni siquiera es compatible con los logros de otro ROM del mismo juego. Entonces, encontrar el mejor ROM para desarrollar logros es importante y tiene que hacerse cuidadosamente.</p> <ul> <li>Seleccionando la Regi\u00f3n: Cuando sea posible escoge ROMs de <code>NTSC USA</code> no-intro, porque 60 FPS es una experiencia mucho mas fluida. Lanzamientos  <code>PAL Europeos</code> corren a 50 FPS, y la mayor\u00eda de los casos tienen que ser evadidos. Lanzamientos <code>NTSC Japan</code> tambi\u00e9n corren a 60 FPS , pero solamente son la mejor opci\u00f3n si el juego fue exclusivamente   lanzado en Jap\u00f3n.  Utilizar como recurso la versi\u00f3n <code>PAL Europea</code> de un juego deber\u00eda de ser el ultimo recurso (Juego exclusivamente de Europa solamente), y son tipicamente muy pocos juegos y bastante \u00fanicos tambi\u00e9n, de toda la librer\u00eda de la consola. El problema de PAL/NTSC no aplica a la emulaci\u00f3n del GBA, que corre todas las versiones regionales a la misma cantidad de FPS.</li> </ul> <ul> <li>No Mods: No utilizes ROM con una pantalla de inicio modificada/personalizada como Mode7 o RisingSun porque arruinan completamente la RAM.</li> </ul> <ul> <li>No Trainers: No utilices un ROM que incluya soporte para cheats integrado.  Estos son com\u00fanmente referidos como  <code>ROM trainers</code>, no son oficiales, y no son compatibles por Retro Achievements de ninguna manera.</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#no-intro","title":"No-Intro","text":"<p>ROMs de No-Intro son el tipo de ROMs preferidos a ser linkeados a la base de datos de RA, y son los que deber\u00edas de utilizar para hacer tu set cuando sea esto posible. Ellos filtran malos dumps, hacks, fakes, overdumps, underdumps, etc. y solo muestra los ROMs que son mas fieles al cartucho original. ROMs de No-Intro ROMs pueden ser identificados de la siguiente manera:</p> <p>Nombre del Juego (Regi\u00f3n) (Lenguajes Disponibles si es que aplica) (Revisi\u00f3n Actual si es que aplica) Ejemplo:  Diddy Kong Racing (USA) (En,Fr) (Rev A)</p> <p>GoodTools Nombre del Juego (Regi\u00f3n) [!], aunque tambi\u00e9n algunos de los ROMs Nombre del Juego (Regi\u00f3n) (Grupo de Rom Dumpers) son de una era mas temprana y tal vez sean iguales a la base de datos de No-Intro pero no es algo garantizado.</p> <p>Puedes verificar aqu\u00ed que el checksum de tu ROM concuerda con el que se encuentra en la base de datos de No-Intro. Desafortunadamente algunos emuladores de RA no calculan correctamente el checksum (como el de  NES) as\u00ed que tal vez necesites encontrar tu checksum desde otra fuente.</p>"},{"location":"Working-with-the-Right-ROM-es/#parches-de-traduccion","title":"Parches de Traducci\u00f3n","text":"<p>(tambi\u00e9n mira: P\u00f3liza de Localizaci\u00f3n de ROM mas abajo)</p> <p>Ingles es el lenguaje primario de RetroAchievements. Los parches de traducci\u00f3n son algunas veces aplicados por los desarrolladores a t\u00edtulos que no se encuentran en ingles. En estos casos instrucciones de como parchear el ROM se van a encontrar en el foro del juego. Proveer un parche de traducci\u00f3n a un titulo existente permite que el juego sea mas accesible a otros usuarios. Tu tienes que inspeccionar profundamente la memoria para ver si el parche es completamente compatible con el set de logros y as\u00ed mandarlo como aprobaci\u00f3n para que lo cheque un desarrollador y as\u00ed lo pueda postear en el foro del juego.</p> <p>Algunas veces los parches de traducci\u00f3n pueden llegar a diferir cr\u00edticamente del MD5 del desarrollador encontrando as\u00ed diferencias en la memoria original. Antes de linkear estos parches checa con el desarrollador original del juego o haz pruebas profundas en memoria para asegurarte que es completamente compatible. Puedes agregar parches de traducci\u00f3n que te hubieras encontrado en linea mientras todos los logros funcionen de manera correcta y no hagan al juego mas o menos dificil.</p>"},{"location":"Working-with-the-Right-ROM-es/#poliza-de-localizacion-de-rom","title":"P\u00f3liza de Localizaci\u00f3n de ROM","text":"<p>Como Ingles es el lenguaje principal de la comunidad, ROMs en Ingles son preferidos. Cuando escojas que ROM deseas para construir logros entre todas las versiones regionales disponibles tu tienes que darle prioridad a los ROMs No-Intro Americanos para consolas que no son port\u00e1tiles y ROMs Europeos para consolas port\u00e1tiles. </p> <p>Damos la bienvenida y nos gustar\u00eda seguir mejorando nuestro soporte para todas las versiones regionales, especialmente Japones (ya que la mayor\u00eda de nuestra librer\u00eda de juegos fueron creados en Jap\u00f3n). Aparte, algunos usuarios simplemente prefieren versi\u00f3n regional en especifico de un juego y es al final de cuentas es mucho mejor incluir un soporte amplio para que cada buen ROM este linkeado a una buena entrada y as\u00ed se le den los logros apropiados.</p> <p>Cuando miramos en como juegos con diferentes versiones regionales son manejados nuestro est\u00e1ndar es una entrada por juego y por consola. Lo ideal seria que si alguien carga la versi\u00f3n Americana o Japonesa de Donkey Kong, Pac-Man o Contra, la gente consiga los mismos logros para la misma entrada. Pero hay algunas situaciones donde es mejor para nuestra librer\u00eda y jugadores separar las versiones regionales en sus propia entradas \u00fanicas. Si la comunidad tiene la raz\u00f3n en creer que es mejor que una entrada se parta en dos, esto puede ser revisado y aprobado por el equipo de desarrolladores despu\u00e9s de un votaci\u00f3n y discusi\u00f3n.</p>"},{"location":"Working-with-the-Right-ROM-es/#diferencias-de-localizacion","title":"Diferencias de Localizaci\u00f3n","text":"<p>El tipo de cambios hechos durante una localizaci\u00f3n (mas com\u00fanmente de Japones a Ingles) pueden varear bruscamente. Cualquiera de los siguientes cambios pueden ser resultados de una localizaci\u00f3n:</p> <ul> <li>Poquito o realmente ning\u00fan gran cambio;</li> <li>Passwords remplazan el sistema de guardado;</li> <li>Correcci\u00f3n de Bugs;</li> <li>Ligeras o traducciones extensas;</li> <li>Ligeros o cambios cosm\u00e9ticos extensivos incluyendo estos, elementos considerados como ofensivos censurados, cambios en sfx, o assets licenciados cambiados a gen\u00e9ricos, o personajes desconocidos convertidos en personajes de Nintendo (ej. Tetris Attack, Super Mario Bros. 2);</li> <li>Stages agregados, modificados o removidos;</li> <li>F\u00edsicas y mec\u00e1nicas del juego modificadas;</li> <li>Modos de Juego, niveles de dificultad y opciones del juego modificadas o removidas;</li> <li>Cheats o modo debug agregado o removido;</li> <li>El juego fue rebalanceado haci\u00e9ndolo mas f\u00e1cil o mas dificil, algunas veces significativamente;</li> <li>Dos juegos fueron combinados en uno;</li> <li>y mucho mas.</li> </ul> <p>Debido a estas variantes y para evitar llenar la base de datos de entradas duplicadas innecesarias nuestra meta es minimizar el numero de sets separados. Para que un set sea separado necesita razones suficientes; nos tomamos bastante cuidado cuando tenemos que aprobar este tipo de casos.</p>"},{"location":"Working-with-the-Right-ROM-es/#separando-una-entrada-regional","title":"Separando una entrada regional","text":""},{"location":"Working-with-the-Right-ROM-es/#1-obtener-aprobacion-por-medio-del-canal-de-discord-revision-voting-es-requerido","title":"1. Obtener aprobaci\u00f3n por medio del canal de Discord #revision-voting es requerido.","text":"<p>La aprobaci\u00f3n sigue el mismo m\u00e9todo de votaciones como cuando se va a trabajar una revisi\u00f3n, como postear tu plan en el foro del juego y en el canal de Discord de #revision-voting; permitiendo tiempo para discutirlo y esperar las 72 horas para que la mayor\u00eda pueda votar en las votaciones.</p> <p>Recuerda que la meta de reducir la duplicaci\u00f3n de entradas; solo se permite que un set se separe cuando es realmente comprensible.</p> <p>El desarrollador que intente separar un set tiene que tener un fuerte motivo por el que el set merezca una nueva entrada y porque no es posible crear la experiencia que se desea con solamente una entrada.</p> <p>Los Desarrolladores que busquen partir un set tienen que venir con el acto de buena fe. Los Sets tienen que ser partidos por el bien de nuestra librer\u00eda de juegos y la comunidad y no por una manera ego\u00edsta de re-hacer un set o buscar puntos de desarrollador gratis.</p>"},{"location":"Working-with-the-Right-ROM-es/#2-tal-vez-podria-ser-aceptable-separar-un-set-si","title":"2. Tal vez podr\u00eda ser aceptable separar un set si","text":"<ol> <li>Cuenta con grandes cambios est\u00e9ticos a el punto donde puede ser confundido como un juego completamente nuevo.  </li> <li>Cuenta con grandes cambios de balance como cambios significativos en la dificultad.  </li> <li>Cuenta con grandes cambios de contenido como nuevos modos de juego, stages bastante modificados, nuevas abilidades, etc.  </li> <li>Cuenta con grandes cambios en las mec\u00e1nicas.  </li> </ol> <p>Ejemplos de juegos que califican:</p> <ul> <li>Esperando ejemplos de precedentes </li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#3-es-probablemente-no-aceptable-partir-un-set-cuando","title":"3. Es probablemente no aceptable partir un set cuando","text":"<ol> <li>El gameplay, balance, contenido del juego o mec\u00e1nicas est\u00e1n mayormente intactas.  </li> <li>Varias de las versiones examinadas (como Rev A) son de la misma region.  </li> <li>Una versi\u00f3n es ligeramente mas f\u00e1cil/dificil que la otra.  </li> <li>El \u00fanico cambio es una traducci\u00f3n o cambio un nombre.  </li> <li>Cambios cosm\u00e9ticos menores o moderados.  </li> <li>Cheats o modo debug fueron agregados o removidos.  </li> </ol> <p>Considerando todo esto, aun depende de la consideraci\u00f3n de los desarrolladores.</p> <p>Ejemplos de juegos que (probablemente) no califican:</p> <ul> <li>Super Mario Bros. (NES); el lanzamiento J y US es el mismo archivo.</li> <li>Earthbound, Chrono Trigger, Bionic Commando (NES); las (principales) diferencias son ligeramente cosm\u00e9ticas, traducciones y censura.</li> <li>Rockman/Mega Man (NES); la diferencia principal siendo algunos cambios en los sfx y un nuevo titulo y pantalla de titulo.</li> <li>The Legend of Zelda (NES), A Link to the Past (SNES); mas alla de la traduccion, la diferencia principal en la versi\u00f3n Americana es de que varios bugs fueron corregidos.</li> <li>Contra (NES); la version de Famicom tiene fondos animados, mas im\u00e1genes, modo de selecci\u00f3n de stages, etc. La versi\u00f3n E (Europea) tiene un nuevo nombre Probotector y los sprites de personajes y enemigos fueron cambiados por robots.</li> </ul>"},{"location":"Working-with-the-Right-ROM-es/#4-despues-de-que-un-set-fue-aprobado-para-ser-partido","title":"4. Despu\u00e9s de que un set fue aprobado para ser partido","text":"<p>No es aceptable simplemente duplicar los sets en dos entradas diferentes. Sets separados tienen que tratarse como una nueva entrada y no un un sub-set (donde los sets Bonus son sub-sets). Estos tienen que tener un sentimiento diferente, retos que hablen de las funciones \u00fanicas del juego que causaron que este se separara en su propia entrada en primer lugar.</p>"},{"location":"Working-with-the-Right-ROM-es/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2019-05-22 10:21] eldexterr:</code> Updated Working with the Right ROM es (markdown)</li> <li><code>[2019-05-20 10:23] eldexterr:</code> Created Working with the Right ROM es (markdown)</li> </ul>"},{"location":"Working-with-the-Right-ROM/","title":"Working with the Right ROM","text":"<p>Related: Achievements for ROM hacks, Subsets</p> <p>Only one achievement set is allowed per game per console. This is true in cases of existing official revisions (ex. Rev 1), official and unofficial fix patches, and alternate regions.</p> <p>Subsets are an exception to this rule, but are considered an extension to a standard set and follow different rules for what types of achievements are allowed.</p> <p>Regional exceptions may exist -rarely- when regional variations massively change the game.</p>"},{"location":"Working-with-the-Right-ROM/#rom-selection","title":"ROM Selection","text":"<p>Almost every game has multiple ROM versions available, sometimes dozens. Often there are major differences under the hood that prevent achievement compatibility between version. Because of this, finding the best ROM for achievements is critical and should be done carefully.</p> <ul> <li>Region Selection: For TV-connected consoles, when possible choose No-Intro (cartridge) or Redump (disc) <code>NTSC USA</code> release ROMs, because 60Hz is a smoother gaming experience and generally matches the intended play speed. <code>PAL European</code> releases run at 50Hz, and are to be avoided in most cases. <code>NTSC Japan</code> releases also run at 60Hz, but are only the best choice if the game was a Japan-exclusive release. <code>PAL European</code> releases should be used as a last resort only (Europe-only exclusive), and are typically limited to a very select few unique games from the entire console's library. Handheld consoles don't have regional timing differences, so language options should be prioritized there whenever possible.</li> </ul> <ul> <li>Revision Selection: Since revisions primarily contain bug and typo fixes, unless you have a -specific- reason not to, always choose the final revision. This will often save both players and developers headaches in the long run. Before working on a game, do a quick search for known revisional changes and take a look at TCRF to see if there's a reason to prefer an earlier revision.</li> </ul> <ul> <li>Ring Codes: Some systems, such as Sega Saturn, have multiple version of the game with different \"ring codes\". These are alphanumeric identifiers stamped on the inner ring of the physical discs. In most cases these will have no functional effect on the game or perhaps even the hash, but as mentioned with Revisions, check to see if there are known differences first.</li> </ul> <ul> <li>Format: For most systems this won't be an issue if you've used verified good dumps. For N64 in particular, games can exist in three formats based on the order of the bytes in the file: n64 (little endian), v64 (byteswapped), and z64 (big endian). Despite producing unique hashes, these three formats are identical for the same dump. Because big endian is the most accurate representation of the N64's cartridges, the big endian (z64) hash -must- be linked for any N64 game, in addition to whatever format you may wish to use personally as a developer. This ensures a single set of roms can consistently be used to play. If required, Tool64 can be used to change byte order.</li> </ul> <ul> <li>Arcade: Arcade ROMs are a bit of a special case because FBNeo mandates the exact contents of the game's archive. When different versions exist, the base version of the name should be preferred in general (for instance, mslug2 should be preferred over mslug2dg or mslug2t). This is merely a guideline, as there may be various reasons to prefer a different version.</li> </ul> <ul> <li>No Mods: Use a clean ROM. Do not use a ROM with a modded/custom launch screen such as Mode7 and RisingSun have because it changes RAM values and complicates users' ability to use their own legally dumped ROMs.</li> </ul> <ul> <li>No Trainers: Do not use a ROM that includes an integrated cheat feature. These are most often refereed to as after-market <code>ROM trainers</code>, are not official, and are not in any way supported by RetroAchievements. These ROMs cannot be linked even as secondary options.</li> </ul>"},{"location":"Working-with-the-Right-ROM/#preservation-groups","title":"Preservation Groups","text":"<p>No-Intro and Redump are the primary groups responsible for verifying clean dumps of console games, excluding all modifications and untrustworthy sources in the process. They offer dat files that can be used to verify your own dumps via a ROM manager. ROMs verified by these groups are preferred whenever possible, and can generally be identified by the following naming scheme:</p> <p>Game Name (Region) (Available Languages if Applicable) (Current Revision if Applicable) Example:  Diddy Kong Racing (USA) (En,Fr) (Rev 1)</p> <p>TOSEC is another less restrictive preservation group. Their hashes often will match Redump for discs, but will frequently contain less thoroughly verified dumps. For floppy discs, cassettes, and less well-known systems where No-Intro and/or Redump verification aren't avaliable, TOSEC is a good fallback choice.</p> <p>You can verify that your ROM checksum matches the databases of No-Intro, Redump, or TOSEC either by using a rom manager with a dat provided by the preferred group or by verifying checksum manually and searching the dat for it in a text editor. Bear in mind that unlike a manual check, the rom manager may be able to skip over external headers to accurately verify integrity. Standard choices are clrmamepro and Romulus.</p>"},{"location":"Working-with-the-Right-ROM/#preferred-groups-per-console","title":"Preferred Groups Per Console","text":"Console ID Console Name Preferred Group 01 GenesisMega Drive No Intro 02 Nintendo 64 No Intro 03 Super NintendoSuper Famicom No Intro 03 Sufami Turbo No Intro 03 Satellaview No Intro 04 Game Boy No Intro 05 Game Boy Advance No Intro 06 Game Boy Color No Intro 07 NESFamicom No Intro 07 Famicom Disk System No Intro 08 TurboGrafx-16PC Engine No Intro 08 SuperGrafx No Intro 08 TurboGrafx-CDPC Engine CD Redump 09 Sega CDMega CD Redump 10 Sega 32X No Intro 11 Master SystemMark III No Intro 12 PlayStation Redump 13 Atari Lynx No Intro 14 Neo Geo Pocket No Intro 14 Neo Geo Pocket Color No Intro 15 Game Gear No Intro 17 Atari Jaguar No Intro 18 Nintendo DS No Intro 21 PlayStation 2 Redump 23 Magnavox Odyssey 2 No Intro 24 Pokemon Mini No Intro 25 Atari 2600 No Intro 27 Arcade Final Burn Neo 28 Virtual Boy No Intro 29 MSX (Cartridges) No Intro 29 MSX (Disks) TOSEC 29 MSX2 (Cartridges) No Intro 29 MSX2 (Disks) TOSEC 33 SG-1000 No Intro 38 Apple II TOSEC 39 Sega Saturn Redump 40 Sega Dreamcast Redump 41 PlayStation Portable Redump 41 PlayStation Portable No Intro 43 3DO Redump 44 ColecoVision No Intro 45 Intellivision No Intro 46 Vectrex No Intro 47 NEC PC-8001 Neo Kobe 47 NEC PC-8001 TOSEC 47 NEC PC-8801 Neo Kobe 47 NEC PC-8801 TOSEC 49 NEC PC-FX Redump 51 Atari 7800 No Intro 53 WonderSwan No Intro 53 WonderSwan Color No Intro 63 Watara Supervision No Intro"},{"location":"Working-with-the-Right-ROM/#translation-patches","title":"Translation patches","text":"<p>(see also: ROM Localization Policy below)</p> <p>English is the Primary language of RetroAchievements. Translation Patches are sometimes applied by developers to non-English titles as the main hash for an achievement set where no licenced English version exists. In these cases patching instructions will be provided in the forum thread of that title. Whenever reasonable, the original unpatched version should still be supported as well.</p> <p>Sometimes translation patches may produce critically different memory from the linked hashes. All linked hashes are expected to be fully supported by the -entire- achievement set. If you can't personally guarantee this, don't link the hash.</p> <p>If you aren't the original developer of the set in question and the developer is active, verify memory personally using testing mode and contact the developer before attempting to add a new translation.</p>"},{"location":"Working-with-the-Right-ROM/#rom-localization-policy","title":"ROM Localization Policy","text":"<p>As English is the primary language of the community, English ROMs are preferred. When choosing which ROM to build achievements for, we give priority to No-Intro or Redump US ROMs for non-handheld consoles and European ROMs for handheld consoles. </p> <p>We would like to continue improving our support for all regional versions, especially Japanese (as the majority of our game library was created in Japan). Some users may also prefer a specific regional version of a game and it is better to include broad support so that any good ROM can link to a good entry and give appropriate achievements. That said, regional variants must still be fully supported, and 50Hz slowdown needs to be mitigated (via additional patches) or proven to be a non-issue when present.</p> <p>When looking at how games with regional versions are handled, our standard is one entry per game per console. It is ideal that if a player loads up the US or Japanese version of Donkey Kong, Pac-Man, or Contra, they will earn the same achievements from the same entry. As mentioned above, there are some extremely rare situations where it is better for our library and players to split off regional versions into their own unique entry. If the community has reason to believe that it's better for an entry to be split, it can be reviewed and approved by the RetroAchievements staff.</p> <p>Tip: For games with text-triggered achievements (especially RPGs) it's recommend to find an event flag instead of hooking onto text or text ID. Text presentation varies between regional versions, making multi-region support difficult.</p>"},{"location":"Working-with-the-Right-ROM/#localization-differences","title":"Localization Differences","text":"<p>The types of changes made during localization (most commonly from Japanese to English) can vary wildly. Any of the following changes may result from a localization:</p> <ul> <li>Little or no change at all;</li> <li>Passwords replace battery saves;</li> <li>Bugs fixed;</li> <li>Light or extensive translations;</li> <li>Light or extensive cosmetic changes including \"offensive\" elements being censored, sfx changes, licenced assets being replaced with generic ones, and/or unknown characters becoming Nintendoed (e.g. Tetris Attack, Super Mario Bros. 2);</li> <li>Stages added, modified or removed;</li> <li>Game physics and game mechanics modified;</li> <li>Game modes, difficulty levels and game options added or removed;</li> <li>Cheat codes or debug modes added or removed;</li> <li>Game rebalancing resulting in a harder or easier experience, sometimes significantly so;</li> <li>Two games combined into one;</li> <li>And more.</li> </ul> <p>Because of this variation and to avoid filling the database with unnecessary duplicates, our goal is to minimize the number of split sets. For a set to be split it needs compelling reasons; we take great care to determine when to approve these splits.</p>"},{"location":"Working-with-the-Right-ROM/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-12-12 18:39] shigutso:</code> Added PS2 on preferred group list</li> <li><code>[2022-02-25 20:41] televandalist:</code> Changed bonus set link to subset link - added a preferred group table for each console</li> <li><code>[2020-06-02 06:00] Sanaki:</code> Added revision and N64 format guidelines, removed entire section on region splitting procedure, made numerous grammar and detail updates</li> <li><code>[2019-08-13 19:49] Kvon:</code> Working with the right rom: text hooking tip added</li> <li><code>[2019-05-03 11:30] meleu:</code> typo</li> <li><code>[2019-05-03 10:55] meleu:</code> merge \"ROM Localization Policy\" into here</li> <li><code>[2018-11-17 08:07] Kvon:</code> changed one word, for clarifcation</li> <li><code>[2018-09-17 17:56] meleu:</code> capital 'R' in the title (Right)</li> </ul>"},{"location":"Writing-Policy/","title":"Writing Policy for Achievements and Leaderboards","text":""},{"location":"Writing-Policy/#achievement-titles","title":"Achievement Titles","text":"<p>Language It is required for all of your achievement titles to be in English. There are some exceptions to this rule however:</p> <ul> <li>QA approval needed: Using another language besides English could be more appropriate in specific cases to give more personality to your achievement set. For example, when the achievement references an existing country or fits a theme where the usage of Latin or \u201cOld English\u201d would make sense. However, it is required to reach out to QA with your reasoning for approval.</li> <li>No QA approval needed: There are both English and non-English games that have in-game foreign language, be it made-up by the developers or directly referencing another existing language. For the ease of comparison, such as songs in Rhythm games and items in other games, it may be more beneficial for the player to have the in-game usage and achievement title match each other.</li> </ul> <p>Capitalization For capitalization in titles, we recommend using https://capitalizemytitle.com/style/chicago/. This will capitalize every word that should be capitalized. While this may not always give perfect results on longer achievement titles, for consistency it is recommended to choose this option when unsure about which words to capitalize, with the recommended style being either Chicago or MLA for the most aesthetically pleasing results.</p> <p>Punctuation Since achievement titles are not full sentences, they should not end with punctuation. Exceptions to this include an exclamation or question mark, as well as the usage of ellipses (three periods) to emphasize there is more to the story or idea.</p> <p>Emojis Adding emojis to achievement titles is not allowed. Not only will they reduce readability, but as unicode they are also more prone to breaking in emulators, as well as on the site depending on what language the user currently has enabled on their desktop, or what browser they are using. Keep in mind that emoticons (e.g. :-], &lt;3) are also not allowed.</p> <p>Creative Titles Creative titles for achievements are more enjoyable for players than exact descriptions of what the players must do to obtain the achievement. If you\u2019re not sure how to add some style to your achievements, you can review the list below for some ideas.</p> <ul> <li>Themes - A good theme can help you name a lot of similar achievements in a way that communicates their similarity while also being interesting. Themes can also be combined with the other writing techniques in this list.<ul> <li>Example 1: Pokemon Pinball\u2019s achievements for catching specific groups of Pokemon (catch Bulbasaur, Squirtle, and Charmander, etc.) have a theme of \u201cgroup words\u201d that unites them. \u201cRoute 2 Gang\u201d, \u201cAngry Crew\u201d, \u201cBrock\u2019s Brotherhood\u201d, all of these titles convey that the achievements are similar, while also communicating the specific flavor of each achievement.</li> <li>Example 2: Dragon Quest 2 (NES)\u2019s achievements all use the same silly \u201cOld English\u201d that the game itself does. If your game has a distinctive writing style of its own, consider theming your achievement titles to match.</li> </ul> </li> </ul> <ul> <li>Rhyme and Alliteration - Rhyme and alliteration are easy ways to construct achievement titles that are nice to read. Take a word relevant to what the player is doing, and attach it to another word or phrase that starts with the same letter or rhymes with the first word. This additional word or phrase should usually be related to what is going on in the game during the section related to the achievement, but doesn\u2019t have to be.<ul> <li>Example 1: A boss is named Sanson and you have made an achievement for defeating him. Since his name starts with an S, you can use alliteration to name the achievement \u201cSanson Slayer\u201d or \u201cSo Long, Sanson\u201d.</li> <li>Example 2: A boss is named Lance and you have made an achievement for defeating him. A lot of words rhyme with his name, so you can come up with a variety of creative titles, such as \u2018\u2019The Last Dance of Lance\u2019\u2019 or \u2018\u2019No Romance For Lance\u2019\u2019.</li> </ul> </li> </ul> <ul> <li>Progression and Grouping - Do you have multiple achievements for the same objective but with higher numbers, such as increasing the score with increments? Consider using a consistent naming scheme, such as good - great - excellent. Something similar can also be used for achievements following the exact same structure, such as achievements that ask you to get every treasure chest in a dungeon. Depending on how many there are, using a similar naming scheme for each such as \u201cTreasure Hunter: Fire Cave\u201d keeps them neatly together.</li> </ul> <ul> <li>References - References are always a fun idea for achievements, especially when you are designing achievements for a game of a bigger franchise. If the same level appears in an earlier/later game for example, using a title that emphasizes that familiarity will always be pleasing to fans of the game. Please keep in mind that references to current events in the world as well as memes are generally discouraged due to them eventually losing relevance.<ul> <li>Example 1: There is a zone called Default Zone in game 1, and game 2 has another variation of it. \u201cThis Looks\u2026 Familiar\u201d could therefore be a good title.</li> <li>Example 2: In the animated TV series of the game you are developing for, when defeating the villain he screams \u2018\u2019This Isn\u2019t the End!!!\u2019\u2019. Making that the title or a variation such as \u2018\u2019Actually, This Is the End!\u2019\u2019always works.</li> </ul> </li> </ul> <ul> <li>Puns - Puns can give a lot of life to an otherwise boring achievement title. To construct a pun, take a word that is related to what the player is doing to earn the achievement and combine it with another common word or phrase in a humorous way.<ul> <li>Example 1: There is an elephant boss that has no relevance to the story. The achievement title could use something with the word \u2018\u2019irrelephant\u2019\u2019, like \u2018\u2019That Was Irrelephant!\u2019\u2019</li> <li>Example 2: There is an achievement for killing 50 enemies that are skeletal. Skeleton bones usually have marrow, so an example of an achievement title could be \u201cMarrow-Minded\u201d.</li> </ul> </li> </ul> <ul> <li>In-game achievement system names - Some games have an in-game achievement system. Using the names these in-game achievements come with is a solid option to use.</li> </ul> <ul> <li>Just describing what happens in a fancy way - The last and perhaps most boring creative option is to just describe what happens in a fancy way. Sometimes doing just that results in a solid title as well, and it can very well be combined with puns, references, and rhyming.<ul> <li>Example 1: Something in the story happens that results in a permanent night. Titles that could work here are \u2018\u2019The Cold Embrace of Darkness\u2019\u2019, \u2018\u2019The Disappearance of Warmth\u2019\u2019 etc.</li> </ul> </li> </ul>"},{"location":"Writing-Policy/#achievement-descriptions","title":"Achievement Descriptions","text":"<p>Language Achievement descriptions, just like titles, are expected to be in English completely. Unlike titles however, it is not allowed under any circumstances to use another language even when it fits the achievement, with the only exception being in-game items and songs for comparing purposes. Everyone should be able to understand a description without the necessity to look up any other language than English.</p> <p>Capitalization In general, only the first letter of a new sentence is capitalized. In English, words are not capitalized due to their type (noun, verb, etc.) or for emphasis, unlike in some languages. Of course, there are exceptions to this:</p> <ul> <li>Names - A person\u2019s names should almost always be capitalized.<ul> <li>Examples: John Smith, Samus Aran, Bowser</li> </ul> </li> </ul> <ul> <li>Titles  - When you are naming a person who has an honorary title or degree, the first letter of the title should be capitalized and ended with a period if it is an abbreviation.<ul> <li>Examples: Dr. Tree, Mrs. Stone, General Shrub</li> </ul> </li> </ul> <ul> <li>In-universe names - Named levels or locations, objects specific to a game or franchise, and character names including bosses should usually be capitalized. However, they should only be capitalized when the game itself does so, and when it is a specific object in that game.<ul> <li>Do NOT capitalize if:     - A level is called \"1-1\". Therefore, it should be \u2018\u2019level 1-1\u2019\u2019.     - There is a generic arrow to be found. Therefore, it should be \u2018\u2019arrow\u2019\u2019.</li> <li>DO capitalize if:     - The level is called \u2018\u2019Level 1-1\u2019\u2019. Due to the game marking that as its full name, it must be capitalized as \u2018\u2019Level 1-1\u2019\u2019.     - The game gives you a variation of a regular arrow called the Ice Arrow. Given its specific name, it must be capitalized as \u2018\u2019Ice Arrow\u2019\u2019.     - The game contains a specific item named \u201cArrow\u2019\u2019. The game usually capitalizes this item when this is the case, and so should you.</li> </ul> </li> </ul> <p>Punctuation Whether or not your achievement descriptions end in periods is up to you, but generally, it is preferred for achievement descriptions to not end with periods. However, consistency across a set is key, so please avoid having some achievement descriptions end in periods while others don\u2019t.</p> <p>Abbreviations</p> <p>Abbreviations should generally only be used for honorary titles or degrees such as Dr. and Mrs. The exception to this rule is when the achievement description you are creating involves an abbreviation being used in-game. Examples include 1P mode (One player mode), ATK stat (Attack stat), and named objects such as the BFG. Do not abbreviate single words such as difficulty to dif, seconds to secs, levels to lvls etc. unless the game itself does.</p> <p>Brackets/Parentheses Brackets have often been used by developers to note conditions that have to be met, such as being on a specific difficulty or playing a specific game mode. While there are situations where this is appropriate, for example when there are too many conditions to make a coherent description that doesn\u2019t result in a long list of \u2018\u2019ands\u2019\u2019, achievement descriptions are easier to read and more stylish when presented as a single phrase or sentence rather than divided into multiple parts through the use of brackets and parentheses.</p> <p>When there are only a few conditions, we ask you to write your descriptive sentence to include this condition naturally.</p> <p>Example of how you should write the description: \u2018\u2019Beat the game on hard difficulty without losing a life\u2019\u2019. Example of how you should NOT write the description: \u2018\u2019Beat the game without losing a life [hard difficulty]\u2019\u2019.</p> <p>Symbols and Emojis Just like with brackets, symbols have been used to describe conditions but are also discouraged. The most common ones are to describe a condition being lower (&lt; / &lt;=) or higher (&gt; / =&gt;). For this, we also ask you to rewrite the text of the description with this condition in mind. </p> <p>Example of how you should write the description: \u2018\u2019Beat the game on hard mode without losing more than five lives\u2019\u2019. Example of how you should NOT write the description: \u2018\u2019Beat the game on hard mode [lives lost &lt;= 5]\u2019\u2019.</p> <p>Just like achievement titles, the usage of emojis is not allowed in descriptions.</p> <p>Quotation Marks Quotation marks are used on RetroAchievements mostly to wrap works such as movies, books, and songs, seen commonly in Rhythm games for example. Other uses may include to set apart a specific word for irony or sarcasm, differentiate a nickname from a given name, or directly taking a quote from somewhere.</p> <ul> <li>Wrapping works example: Finish the track \u201cOver the Mountain\u201d with an A rank or higher.</li> <li>Irony/sarcasm example: Finish off the \u201ctough\u201d demon.</li> <li>Differentiate a nickname: Help out T.K. \u201cDance King\u201d Johnson with his new movie.</li> </ul> <p>You should ONLY use double quotation marks. Single quotation marks are only used for quotes within quotes, and should not be used elsewhere.</p> <p>Consistency As an international community, we don\u2019t expect every developer to write with perfect grammar, or to agree exactly on what perfect grammar is. Simple and relatively universal guidelines of English grammar, like leaving a space after a comma, should be followed closely. However, more obscure or controversial guidelines, such as the Oxford Comma (the final comma in a list of things, often placed before the final entry starting with \u201cand\u201d), are not a necessity. However, please be consistent within a set in your usage of grammar. Do not use the Oxford Comma in one achievement while not using it in another where it would also be appropriate.</p> <p>Consistency is also preferred in the use of common words to describe an achievement. For finishing a level or boss for example, the most common words used are \u201cbeat\u201d, \u201cfinish\u201d, \u201cclear\u201d, \u201cdefeat\u201d as well as a few others. Please only use one of them when working with multiple achievements that have the same theme - if the achievement description for finishing level 1 says \u201cDefeat the boss of level 1\u201d, the achievement description for level 2 shouldn\u2019t say \u201cBeat the boss of level 2\u201d unless there is a good reason to use the different word. Stick to using the same words to describe the same things within a group of similar achievements.</p> <p>If a challenge condition, such as \u201con normal difficulty or higher\u201d or \u201cno cheats\u201d, applies to almost every achievement in the set, it is recommended to note this condition through a zero-point achievement (usually awarded at the start of the game), a forum post, or comments rather than repeating \u201con normal difficulty or higher\u201d in the description of every achievement.</p> <p>The Description Itself The most important role of an achievement description is to describe exactly what is needed to obtain the achievement in as few words as possible while not excluding important information. It needs to be clear and concise, and both native and non-native English speakers must be able to understand what they need to do by reading the description in combination with the badge and title.</p> <p>There is a generous character limit of 255 characters to work with to describe what needs to be done for an achievement. Absolutely avoid redirecting people to the achievement comments for a full explanation, as emulator-only users do not have access to this information. If your achievement uses a lot of complex conditions and is difficult to explain within the character limit, consider simplifying the logic of the achievement so that it is easier to explain to users, rather than trying to fit all of the complexity within the character limit in a sub-optimal way.</p> <p>In some cases, achievement descriptions are intentionally written to avoid explaining what needs to be done word-for-word. For example, perhaps you want to avoid spoiling a story segment or you want to encourage the player to find out how to obtain the achievement without directly telling them what to do, like discovering a secret. This is a great idea, but one that needs to be approached with care. Remember, the description needs to be clear and concise for everyone to understand. It is important that the title, badge, and/or the description gives a solid hint on what the player needs to do. Consider reaching out to fellow community members with your planned achievement and see if they understand what needs to be done.</p>"},{"location":"Writing-Policy/#leaderboards","title":"Leaderboards","text":"<p>Leaderboard Titles Like achievement titles, the language, capitalization, punctuation, and emoji guidelines do apply to leaderboard titles. However, we will not ask you to give the leaderboards creative titles.</p> <p>Unlike achievement titles, we ask you to get directly to the point with leaderboard titles in as few words as possible while still remaining clear and concise. The reasoning behind this is that when a user is playing a game and a leaderboard becomes available, the pop-up will only show the title. It is important that players\u2013especially emulator-only players\u2013immediately know why this leaderboard is currently active and what it is about so they can decide on the fly whether to partake in this leaderboard or not.</p> <p>Typically leaderboards fall under a specific category, such as speedruns, score attacks, or something not too dissimilar. In these categories, specific parts of the games are what the leaderboard focuses on, such as a specific boss, stage, or the entire game. This is why we recommend you to structure the leaderboard title starting with the category, followed by the part of the game, and finally followed by a potential extra condition such as a specific character or vehicle.</p> <p>Examples include:</p> <ul> <li>Speedrun - Default Zone 1 (Pete)</li> <li>Score Attack - L.A. Streets (Hyundai I-20)</li> <li>Challenge - Creatures defeated consecutively</li> </ul> <p>Important to keep in mind is that when the leaderboard is based on an in-game named mode (such as Time Trial) that this is the name used as the challenge.</p> <p>Leaderboard Descriptions The leaderboard descriptions essentially follow the exact same guidelines as the achievement descriptions. The two most important rules remain consistency, and a clear and concise description of what the leaderboard is about. Implement correct usage of all the other guidelines of the achievement descriptions.</p> <p>However, there are two things to keep in mind specifically for leaderboards:</p> <ol> <li>Sometimes you may want to specify at what exact point a leaderboard starts- and ends. A leaderboard may end on the final hit of a boss, or after the death animation happens. Given how competitive leaderboards can be, it is important to state such information when it\u2019s not as obvious as the player may think.</li> <li>Descriptions are technically optional. While we always encourage a description still, sometimes you may end up in a situation where you have so many leaderboards all following a similar structure easily explained by the leaderboard title that it would be unnecessary to add a description. </li> </ol>"},{"location":"Writing-Policy/#common-grammatical-errors","title":"Common Grammatical Errors","text":"<p>It is not uncommon for grammatical errors to find their way into achievements, be it in the titles or the descriptions. As mentioned before, we do not expect everyone to have a perfect handle on the English language and the grammar that comes with it. With our years of experience, we have identified some mistakes that are more common than others, and these are listed down below to prevent them for future use, as well as show some examples to give you a better understanding of them.</p> <p>If reading the explanations below still raises questions, consider checking out a grammar tool such as LanguageTool or Grammarly. It is not recommended to use said tools for complete sentences, to avoid correcting grammar that doesn\u2019t need correction, but they can be used for simpler fixes such as the below-mentioned aspects.</p> <p>Articles Articles are by far the most common grammatical error identified on the site. Articles are words that identify a noun as being specific/definite (\u201cthe\u201d) or unspecific/indefinite (\u201ca\u201d/\u201dan\u201d). To give you a few examples of how they can be used in achievements:</p> <ul> <li>Specific/definitive<ul> <li>Example 1: You need to slay an enemy with a weapon called the Master Sword, of which only one exists. You want to define that the enemy can only be slain with this weapon, therefore you are tasked to slay it with the Master Sword.</li> <li>Example 2: A single rock is blocking your path that you need to destroy. While this rock is unnamed, you should still specify that you need to destroy the rock blocking your path.</li> <li>Example 3: There are multiple mountains to climb, but you are tasked with climbing the highest. As indicated, you should climb the highest mountain.</li> </ul> </li> </ul> <ul> <li>Unspecific/indefinite<ul> <li>Example 1: You need to slay an enemy with any sword in a game with multiple weapon types. Therefore, you are tasked to slay it with a sword.</li> <li>Example 2: Multiple rocks are blocking your path that you need to destroy. For the achievement you need to only destroy one of the rocks, so you don\u2019t need to specify which one to destroy and can just say a rock.</li> <li>Example 3: There are multiple mountains to climb, and you are free to choose any of them. Therefore, you should climb a mountain.</li> </ul> </li> </ul> <p>Most of these are pretty straightforward. Note that for unspecific/indefinite articles, you may also want to use different words to designate an amount. Using the above examples, you can slay an enemy with a sword, but also with any sword.</p> <p>Another possibility is that it is not necessary to use an article. This mostly applies to named words, such as locations. While \u201cArrive at the Baron Castle\u201d is technically correct, preferred would be to use \u201cArrive at Baron Castle\u201d. If you are unsure which one to go for in this situation, speaking the sentence out loud may just give you the hint you need!</p> <p>However, more people have an issue with the usage of the unspecific articles, \u201ca\u201d and \u201can\u201d. While they both have the same function, they cannot be used before some words. This is dependent on if the word that follows it starts with a consonant- or vowel sound when spoken in correct English. This also applies to abbreviations that are spoken one letter at a time.</p> <ul> <li>\u201ca\u201d is used as an article before words starting with consonant sounds (every letter except a, e, i, o, u).<ul> <li>a level - pronounced leh-vl.</li> <li>a unique item - pronounced yoo-neek.</li> <li>a BFG - pronounced bee-eff-gee.</li> <li>a URL - pronounced yoo-are-ell.</li> </ul> </li> </ul> <ul> <li>\u201can\u201d is used as an article before words starting with vowel sounds (a, e, i, o, u).<ul> <li>an item - pronounced ai-tm.</li> <li>an honest deed - pronounced o-nuhst.</li> <li>an ETA - pronounced ee-tee-a.</li> <li>an LCD - pronounced el-see-dee.</li> </ul> </li> </ul> <p>Possessive/Contraction Another common mistake is with words that use an apostrophe, such as \"you\u2019re\" and \"it\u2019s\". These are very commonly used in the English language, but removing the apostrophe  changes the entire meaning of the word. Therefore, it is good to check beforehand if you are using it as a possessive form, or as a contraction of multiple words.</p> <ul> <li>When you are not using the apostrophe, you are using the word in a possessive form. The word you are describing afterwards belongs to something- or someone.<ul> <li>Example 1: Use your sword to defeat the enemy. The sword is in your possession.</li> <li>Example 2: The magic book has its pages torn out. The pages belong to the book.</li> </ul> </li> </ul> <ul> <li>When you are using the apostrophe, you are combining two words into one as a contraction. The rule of thumb is always that when you are using an apostrophe, it is not a singular word. Note that it is always allowed (and sometimes even preferred!) to separate the words in writing rather than using them as a contraction.<ul> <li>Example 1: You\u2019re the hero of this story. It combines the words \u201cyou\u201d and \u201care\u201d.</li> <li>Example 2: It\u2019s super effective. It combines the words \u201cit\u201d and \u201cis\u201d. </li> </ul> </li> </ul> <p>Separated words and the usage of hyphens Another common grammatical mistake we find involves words such as \u201catleast\u201d and \u201calot\u201d, where two words are forced together into one word. This is not allowed in English - these examples should be \u201cat least\u201d and \u201ca lot\u201d.</p> <p>You should also watch out for correct usage of hyphens (the \u201c-\u201d symbol). This symbol is generally used to combine words, but only if they are followed by a noun. When they come after the noun, they are not combined with a hyphen and are instead written as two separate words.</p> <ul> <li>Example of when the hyphen is used:<ul> <li>Defeat the well-known artist. As the two words come before the noun that they are describing, they are combined with a hyphen.</li> </ul> </li> <li>Example of when the hyphen is not used:<ul> <li>Defeat the artist that is well known. As the two words come after the noun they are describing, they are not combined with a hyphen.</li> </ul> </li> </ul> <p>Written numbers, such as twenty-five, are always written with hyphens.</p> <p>Number Formatting All numbers should be formatted according to the conventions accepted in most English-speaking locations to avoid confusion about whether a number is very large or very small.</p> <ul> <li>Decimal point - A point should be used to convey the separation between the integer and fractional part of a number, not a comma.<ul> <li>Example: The number 3 + \u215b     - Correct: 3.125     - Incorrect: 3,125</li> </ul> </li> </ul> <ul> <li>Thousands separator - A comma should be used to separate a number into thousands, not a point.<ul> <li>Example: The number fifty thousand, five hundred and twenty-five     - Correct: 50,525     - Incorrect: 50.525</li> </ul> </li> </ul> <p>Deceptive Similarity Between Languages Many languages are related to each other, distantly or closely, and have words that are spelled similarly with similar meanings - but which are not identical. This may include your native language and English. Please check your spelling carefully to ensure you are using the English spelling for the word.</p> <ul> <li>Examples<ul> <li>An object in a player\u2019s inventory     - Correct: \u201citem\u201d     - Incorrect: \u201citen\u201d</li> </ul> </li> </ul>"},{"location":"Writing-Policy/#username-references","title":"Username References","text":"<p>Username references are a good way to acknowledge the work of a fellow user in the community. However, the references should be limited as most references are only understood by a small subset of the community. Username references must not carry a negative connotation. Username references must be explicitly requested by the developer and approved by the user being referenced unless otherwise specified below. Username references are appropriate in the following situations:</p> <ul> <li>Specialty Sets: In specialty set such as events or community-submitted sets, usernames may be referenced. Username references in these cases implies recognition of the individual's contribution and does not need to be approved by the user whose name is being referenced. Examples of these sets are:<ul> <li>Irritating Stick [Subset - IrRAtating Custom Courses]</li> <li>Pokemon Mystery Dungeon: Explorers of Sky [Subset - Zero Isle South Runs]</li> <li>~Hack~ UzeMaze RA</li> <li>Achievement of the Week 2022 Champions</li> </ul> </li> </ul> <ul> <li>Subtle References: Subtle username references may be included. However, these references must be clearly distinguishable from the main text and be relevant to the achievement theme.<ul> <li>BlazeKickn Hot</li> <li>Blended Sea Water</li> </ul> </li> </ul> <ul> <li>Good Reasons: In cases where there is a compelling reason to reference username, such as a significant achievement or notable contribution to the community, usernames may be included.</li> </ul> <p>Users retain full control over the use of their name. They have the right to request that their username be removed from any achievement at any time, developers must abide by this. For users who share the their name with an everyday term (Bedtime, Fridge, Gloves, Griffin, etc.), this only applies if their likeliness is directly referenced.</p> <p>The use of banned users is strictly prohibited. Any achievement that includes a banned username should be updated promptly upon becoming aware of the ban.</p>"},{"location":"Writing-Policy/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2024-03-11 14:09] Andrew Comer:</code> Bullet formatting fixes.</li> <li><code>[2024-03-11 13:14] Andrew Comer:</code> Updated Writing Policy (markdown)</li> <li><code>[2024-01-12 20:47] Andrew Comer:</code> Added initial \"Username References\" section</li> <li><code>[2023-12-18 18:45] Andrew Comer:</code> Updated Writing Policy (markdown)</li> <li><code>[2023-12-18 10:08] suspect15:</code> Updated Writing policy (markdown)</li> </ul>"},{"location":"_Footer/","title":"Footer","text":"<p>RetroAchievements Documentation</p> Official Website RADocs Discord Server"},{"location":"_Sidebar/","title":"Wiki Home Page","text":""},{"location":"_Sidebar/#guidelines","title":"Guidelines","text":"<ul> <li>User Guidelines<ul> <li>RetroAchievements Manifesto</li> <li>Users Code of Conduct</li> <li>Global Leaderboard and Achievement Hunting Rules</li> </ul> </li> <li>Developer Guidelines<ul> <li>Developer's Code of Conduct</li> <li>Creating Entries</li> <li>Claims System</li> <li>Handling Tickets</li> </ul> </li> <li>Content Guidelines<ul> <li>Achievement Set Requirements</li> <li>Unwelcome Concepts</li> <li>Progression and Win Condition Typing</li> <li>Set Plagiarism</li> <li>Naming Conventions</li> <li>Writing Policy</li> <li>Badge and Icons</li> <li>Code Notes</li> <li>Editing Leaderboards</li> <li>Achievement Set Revisions</li> <li>Achievements for ROM hacks</li> <li>Subsets</li> <li>Working with the Right ROM</li> <li>Hash Labels</li> </ul> </li> </ul>"},{"location":"_Sidebar/#general","title":"General","text":"<ul> <li>FAQ</li> <li>Setup Guide</li> <li>Emulator Support and Issues</li> <li>Ways to Contribute</li> <li>RABot, the RA Discord Robot</li> <li>Events</li> <li>Overlay Themes</li> <li>Useful Links</li> <li>Contributing with the docs</li> <li>About Us</li> <li>Tutorials<ul> <li>How to configure OBS Studio to see the popups</li> <li>Multi-Disc Games Tutorial</li> <li>Working with DLC for the PlayStation Portable</li> </ul> </li> </ul>"},{"location":"_Sidebar/#achievement-development","title":"Achievement Development","text":"<ul> <li>Developer Docs</li> <li>How to Become an Achievement Developer</li> <li>Getting Started as an Achievement Developer</li> <li>Game Identification</li> <li>Achievement Design</li> <li>Achievement Scoring</li> <li>Difficulty Scale and Balance</li> <li>Progression and Win Condition Typing</li> <li>Badge and Icon Creation</li> <li>Achievement Development Overview</li> <li>Flags<ul> <li>ResetIf Flag</li> <li>ResetNextIf Flag</li> <li>PauseIf Flag</li> <li>AndNext and OrNext Flags</li> <li>AddSource Flag</li> <li>SubSource Flag</li> <li>AddHits and SubHits Flag</li> <li>AddAddress Flag</li> <li>Measured Flag</li> <li>Trigger Flag</li> </ul> </li> <li>BitCount Size</li> <li>Alt Groups</li> <li>Hit Counts</li> <li>Delta Values</li> <li>Prior Values</li> <li>Value Definition</li> <li>Condition Syntax</li> <li>Minimum Required Versions for Logic Features</li> <li>Memory Inspector</li> <li>Real Examples</li> <li>Set Development Roadmap</li> <li>Achievement Templates</li> <li>Tips and Tricks</li> <li>Leaderboards</li> <li>Rich Presence</li> <li>RATools</li> <li>Console Specific Tips</li> <li>Emulator Hotkeys for Developers</li> <li>libretro core support</li> </ul>"},{"location":"_Sidebar/#wip","title":"WIP","text":"<ul> <li>Docs To Do List</li> <li>WIP User Code of Conduct</li> <li>WIP CoC FAQ</li> <li>WIP Content Guidelines</li> <li>WIP-Jr</li> <li>WIP---Dev-Tips---Code-Notes-En-Masse</li> </ul>"},{"location":"_Sidebar/#portugues","title":"Portugues","text":"<ul> <li>Introdu\u00e7\u00e3o</li> </ul>"},{"location":"_Sidebar/#geral","title":"Geral","text":"<p>- Manifesto RetroAchievements   - C\u00f3digo de Conduta do Usu\u00e1rio   - FAQ - Perguntas Frequentes   - Como contribuir se voc\u00ea n\u00e3o \u00e9 um desenvolvedor   - Tutorial para Jogos Multi-Discos</p>"},{"location":"_Sidebar/#desenvolvedores","title":"Desenvolvedores","text":"<p>- Introdu\u00e7\u00e3o   - Primeiros Passos como um Desenvolvedor de Conquistas   - Recursos de L\u00f3gica para Achievements   - Exemplos Reais     - Introdu\u00e7\u00e3o     - Usando Hit Counts e ResetIf     - Usando Delta Values e ResetIf     - Simples Exemplo de como Evitar Abuso de Load State   - Dicas e Truques   - Dicas Espec\u00edficas de Console   - Modelos de Achievement   - Escala de Dificuldade e Equil\u00edbrio   - Roteiro de Desenvolvimento de um Set de Conquistas   - Cria\u00e7\u00e3o de \u00cdcones e Emblemas   - Leaderboards   - Rich Presence   - Design de Conquistas</p>"},{"location":"_Sidebar/#espanol","title":"Espa\u00f1ol","text":"<ul> <li>Introducci\u00f3n</li> </ul>"},{"location":"_Sidebar/#general_1","title":"General","text":"<p>- Manifesto RetroAchievements   - C\u00f3digo de Conducta del Usuario   - FAQ - Preguntas Frecuentes   - Tablas Globales y Reglas para la Caser\u00eda de Logros   - Mi juego no esta cargando los logros   - Como contribuir si no eres un desarrollador   - Por que no deber\u00edas utilizar la funci\u00f3n de cargar estado   - Contribuyendo con los documentos   - Como funciona la Documentaci\u00f3n de RA   - Descargas</p>"},{"location":"_Sidebar/#desarrolladores","title":"Desarrolladores","text":"<p>- Intro   - C\u00f3digo de Conducta del Desarrollador   - Como convertirme en un Desarrollador de Logros   - Primeros pasos como un Desarrollador de Logros   - Un vistazo al Inspector de Memoria   - Caracter\u00edsticas en la Logica de un Logro     - Intro     - Contador de Golpes (Hit Counts)     - Valores Delta     - Bandera ResetIf     - Bandera PauseIf     - Bandera AddSource     - Bandera SubSource     - Bandera AddHits     - Combinando Banderas     - Alt Groups     - Versiones M\u00ednimas Requeridas para Funciones en la L\u00f3gica   - Ejemplos Reales     - Intro     - Utilizando Hit Counts como un Temporizador     - Utilizando Valores Delta y Hit Counts para Detectar un Incremento     - Un Ejemplo Simple en como evitar el Abuso de Estados de Guardado     - Evitar el Problema de que un Contador se Incremente Dos Veces en el Mismo Frame     - Creando un Temporizador con un ResetIf Hits bas\u00e1ndote en la Velocidad de un Juego   - Plantillas para Logros   - Tips y Trucos   - Escala de Dificultad y Balance   - Dise\u00f1o de Logros   - Mapa de Desarrollo de Set   - Revisiones en Set de Logros   - Creaci\u00f3n de Iconos y Badges   - Tablas de Clasificaci\u00f3n   - Rich Presence   - Trabajando con el ROM apropiado   - Identificaci\u00f3n del Juego   - Gu\u00eda para Sets Bonus   - Logros para ROM hacks   - Tips Espec\u00edficos por Consola</p>"},{"location":"home-pl/","title":"Home pl","text":""},{"location":"home-pl/#_1","title":"Home pl","text":"<p>Witaj w dokumentacji RetroAchievements!</p> <p>Na pocz\u0105tek, musisz zna\u0107 Or\u0119dzie RetroAchievements wraz z Kodeksem post\u0119powania U\u017cytkownika.</p> <p>Je\u017celi szukasz dokumentacji o tworzeniu osi\u0105gni\u0119\u0107, sprawd\u017a nasz\u0105 sekcje Dokumentacje Developerskie.</p> <p>Zach\u0119camy wszystkich cz\u0142onk\u00f3w spo\u0142eczno\u015bci aby do\u0142\u0105czyli do naszego Serwera Discord, u\u017cywamy go do wi\u0119kszo\u015bci komunikacji</p> <p>Pe\u0142na lista stron jest na bocznym pasku, lecz tu jest kr\u00f3tki opis paru z nich:</p> <ul> <li>FAQ: Cz\u0119sto zadawane pytania (na przyk\u0142ad Kt\u00f3rego rdzenia Retroarch powinienem u\u017cywa\u0107).</li> </ul> <ul> <li>Globalna Tablica Wynik\u00f3w i Zasady Zdobywania Osi\u0105gni\u0119\u0107: Wyja\u015bnia zasady globalnej tablicy wynik\u00f3w, czym jest status \"Untracked\", co mo\u017ce by\u0107 uznawane za oszukiwanie itd.</li> </ul> <ul> <li>Pliki do \u015aci\u0105gni\u0119cia: alternatywna strona do \u015bci\u0105gania plik\u00f3w.</li> </ul> <ul> <li>Darmowe Gry: Gry, kt\u00f3re s\u0105 darmowe i legalne do \u015bci\u0105gni\u0119cia i grania na emulatorze.</li> </ul> <ul> <li>Moja gra nie \u0142aduje osi\u0105gni\u0119\u0107: Co musisz zrobi\u0107, gdy gra nie \u0142aduje osi\u0105gni\u0119\u0107.</li> </ul> <ul> <li>Czemu nie powiniene\u015b u\u017cywa\u0107 funkcji Wczytaj Stan: Czemu powiniene\u015b oczekiwa\u0107 problem\u00f3w u\u017cywaj\u0105\u0107 funkcji Utw\u00f3rz/Wczytaj Stan podczas gry.</li> </ul> <ul> <li>Wiadomo\u015b\u0107 do \u0141owc\u00f3w osi\u0105gni\u0119\u0107 i Komplecjonist\u00f3w o rewizjach: Czemu nie powiniene\u015b si\u0119 denerwowa\u0107 jak osi\u0105gni\u0119cia zosta\u0142y poddane rewizji.</li> </ul> <ul> <li>Jak mo\u017cesz wspom\u00f3c nie b\u0119d\u0105c developerem: Je\u015bli nie wiesz, jak tworzy\u0107 osi\u0105gni\u0119cia, jest wiele sposob\u00f3w aby pom\u00f3c naszej spo\u0142eczno\u015bci.</li> </ul> <p>Mo\u017cesz wspom\u00f3c t\u0119 dokumentacje poprzez tworzenie/edytowanie stron na Wikipedii RetroAchievements.</p>"},{"location":"home-pl/#tumaczenia","title":"T\u0142umaczenia","text":"<ul> <li>Portugalski</li> <li>Hiszpa\u0144ski</li> <li>Francuski</li> </ul>"},{"location":"libretro-core-support/","title":"libretro core support","text":"<p>For a libretro core to support RetroAchievements, it must expose memory and it must not modify the game files. Everything else should be handled by the libretro frontend (i.e. RetroArch or RALibretro).</p> <ul> <li>Exposing Memory</li> <li>Immutable Game Data</li> <li>Core Settings</li> <li>Save States</li> <li>Disabling Support</li> </ul>"},{"location":"libretro-core-support/#exposing-memory","title":"Exposing Memory","text":"<p>First, find the memory regions expected by RetroAchievements by looking for the mapping associated to the console in consoleinfo.c. It will look something like this:</p> <pre><code>static const rc_memory_region_t _rc_memory_regions_pc_engine[] = {\n    { 0x000000U, 0x001FFFU, 0x1F0000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM\" },\n    { 0x002000U, 0x011FFFU, 0x100000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"CD RAM\" },\n    { 0x012000U, 0x041FFFU, 0x0D0000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"Super System Card RAM\" },\n    { 0x042000U, 0x0427FFU, 0x1EE000U, RC_MEMORY_TYPE_SAVE_RAM,   \"CD Battery-backed RAM\" }\n};\n</code></pre> <p>This example defines four regions of memory for the PC-Engine console. The first two fields are the starting and ending RetroAchievements address for the region. The third field is the starting real address for the region. The fourth field identifies the type of memory stored in the region, and the last field is a label for the region.</p> <p>Achievements rely almost entirely on system RAM and save RAM. There may be additional blocks in the memory map flagged as other types of memory. Those blocks are leftover from the way the memory way initially exposed by a standalone emulator. They can only be exposed by <code>RETRO_ENVIRONMENT_SET_MEMORY_MAPS</code>, and are almost never needed for achievement logic, so it's usually acceptable to not worry about them initially.</p> <p>If no memory map is provided, RetroAchievements doesn't support the system yet. Please contact us if you believe your core/system is ready to be supported.</p>"},{"location":"libretro-core-support/#exposing-via-retro_get_memory_data","title":"Exposing via retro_get_memory_data","text":"<p>Memory can be exposed in two ways. The simplest is using the <code>retro_get_memory_data</code>/<code>retro_get_memory_size</code> functions. These functions will be called with <code>RETRO_MEMORY_SYSTEM_RAM</code> and <code>RETRO_MEMORY_SAVE_RAM</code> (when applicable). The functions return a single pointer and a size for a block of memory. This block of memory is then distributed to the memory regions until no more is available.</p> <p>Using the above example, the expectation would be that <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code> would return 0x42000 and <code>retro_get_memory_size(RETRO_MEMORY_SAVE_RAM)</code> would return 0x800, and <code>retro_get_memory_data</code> would return pointers to blocks of memory of the specified sizes. The 0x42000 bytes of system RAM would be distributed to the three blocks of <code>RC_MEMORY_TYPE_SYSTEM_RAM</code>, and the 0x800 bytes of save RAM would be associated to the one block of <code>RC_MEMORY_TYPE_SAVE_RAM</code>.</p> <p>If less than 0x42000 bytes is returned by <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code>, it will be associated to the three blocks of <code>RC_MEMORY_TYPE_SYSTEM_RAM</code> in a first-come, first-serve basis. The first 0x2000 bytes will be allocated to the first block. The next 0x10000 to the second block, and whatever is left to the third block. Whatever addresses could not be filled will be unavailable to the achievement code and achievements dependent on those addresses will be disabled.</p> <p>If more than 0x42000 bytes is returned by <code>retro_get_memory_size(RETRO_MEMORY_SYSTEM_RAM)</code>, only the first 0x42000 bytes will be allocated and the rest will be ignored.</p>"},{"location":"libretro-core-support/#exposing-via-retro_environment_set_memory_maps","title":"Exposing via RETRO_ENVIRONMENT_SET_MEMORY_MAPS","text":"<p>The other way to expose memory is the <code>RETRO_ENVIRONMENT_SET_MEMORY_MAPS</code> environment callback. This callback allows the core to specify disparate chunks of memory without having to join them into a single byte array for access by <code>retro_get_memory_data</code>. Using the example above, unique pointers could be returned for each of the three blocks of system RAM, or even for subsections of each of the three blocks of system RAM.</p> <p>The RetroAchievements code will using the provided map to translate it's addresses to the appropriate core memory through the start/select/disconnect properties of the exposed memory. Addresses that cannot be mapped will be unavailable to the achievement code and achievements dependent on those addresses will be disabled.</p>"},{"location":"libretro-core-support/#special-considerations","title":"Special considerations","text":"<p>Some maps contain comments indicating special considerations should be applied for the console. These usually have to do with paged memory. As the achievement code needs access to all memory, not just the currently paged memory, we often request that the entire unpaged memory be accessible.</p> <pre><code>    { 0x00C000U, 0x00CFFFU, 0x00C000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (fixed)\" },\n    { 0x00D000U, 0x00DFFFU, 0x00D000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (bank 1)\" },\n\n    /* GameBoy Color provides six extra banks of memory that can be paged out through the $DXXX \n     * memory space, but the timing of that does not correspond with blanks, which is when achievements \n     * are processed. As such, it is desirable to always have access to these extra banks. We do this\n     * by expecting the extra banks to be addressable at addresses not supported by the native system. */\n    { 0x010000U, 0x015FFFU, 0x010000U, RC_MEMORY_TYPE_SYSTEM_RAM, \"System RAM (banks 2-7, GBC only)\" }\n</code></pre> <p>The GameBoy Color has 32KB of RAM broken into eight 4KB banks. Normally, the first bank is exposed at $C000, and the other seven banks are paged into the $D000 memory space. As RetroAchievements only process data once per frame, we can't rely on the correct data being in the $D000 page when we evaluate our logic, so we ask that $D000 always only contains bank 1, and banks 2-7 are exposed at $10000-$15FFF (addresses which are not normally used by the GameBoy Color).</p>"},{"location":"libretro-core-support/#immutable-game-data","title":"Immutable Game Data","text":"<p>The other important thing for a core to consider is that the game files should not be modified.</p> <p>RetroAchievements hashes a portion of the game data (usually most or all of it) to ensure the player is using a compatible version of the game. If the hash doesn't match exactly, we don't enable achievements. This ensures that regional variants are only allowed if their memory lines up correctly. It also ensures players aren't playing on a hacked version where they have infinite health or some other cheat applied.</p> <p>If the game files are modified by the core, the hash may change and the game will no longer be identified.</p> <p>Any modifications to the game files should be handled through the <code>retro_serialize</code> interface.</p>"},{"location":"libretro-core-support/#core-settings","title":"Core Settings","text":"<p>If a user can manually change settings in the core that could make playing a game easier, please inform us so we can add them to a blacklist that disables hardcore when they're set. Common examples are:  * running NTSC games in PAL mode slows them down by 16%  * disabling layers allows players to see through fog-of-war  * core provided cheats give infinite health/ammo/etc</p>"},{"location":"libretro-core-support/#save-states","title":"Save States","text":"<p>While not required, save state support makes it much easier to develop and debug/fix achievements using the core.</p> <p>No special logic is required to support achievements in the save states - the frontend will handle that.</p>"},{"location":"libretro-core-support/#disabling-support","title":"Disabling Support","text":"<p>If a core wishes to opt-out of achievement support, it can explicitly call the <code>RETRO_ENVIRONMENT_SET_SUPPORT_ACHIEVEMENTS</code> with <code>false</code>/<code>0</code>. This will disable the achievement subsystem while the core is loaded, which will avoid any attempts to identify if the loaded content has achievements, and disable all functionality limited by having achievement hardcore mode enabled (rewind, loading save states, slow-motion, cheats).</p>"},{"location":"libretro-core-support/#changelog","title":"Changelog","text":"<p>Last 10 changes on this page:</p> <ul> <li><code>[2023-06-06 11:05] televandalist:</code> Added ToC</li> <li><code>[2022-01-06 07:40] Jamiras:</code> Created libretro core support (markdown)</li> </ul>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index bbd9ebdd..c9b4b1a9 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ