citra-games-wiki/CONTRIBUTING.md

Contributing

Contributions to the Citra Games Wiki are welcomed, as keeping all of the data up to date and accurate is a community effort. There are 2 parts to the Wiki:

• Code
• Wiki

Info About This Wiki

Angle Brackets

Throughout this guide, code blocks like <Value> are used. This means that "Value" should be replaced by something, and the "<>" should be deleted.

Dates

All dates follow the format <4-Digit Year>-<2-Digit Month>-<2-Digit Day>. For example, June 3rd 2017 would be "2017-06-03".

Title IDs

Title IDs can be found near the top of a log when running a game. For example, this is what it looks like for The Legend of Zelda: Ocarina of Time, 0004000000033500: [ 0.019882] Loader <Info> core/loader/ncch.cpp:Load:340: Program ID: 0004000000033500.

TOML

In this repo, DAT files follow the TOML syntax, where each line consists of the creation of a peice of data. The simplest form of this is assigning a value to a key (<Key> = <Value>). The data types used for these Values in this wiki are:

• Booleans, true or false (Example: true.)
• Integers, numbers (Example: 5.)
• Strings, characters with surrounding quotes (Example: "Hi!".)
• Arrays, collection of booleans, integers, or strings (Example for an array of integers: [33, 2398, 234].)

These key/value pairs can be grouped together using an array of tables (Example: [[ Stuff ]], with the pairs on the next lines.). These can be used more than once in a TOML file.

GitHub Issues

Game issues can be found here. The ID of the issue can be found at the end of the URL. For example, SNES Virtual Console Games - Crash on Boot's ID is 2782.

Code

The code consists of the actual files in the Github repisitory. To modify them, you have to fork this repo, make your changes, and send a pull request.

At the root, there's a folder for each game. The names of these folders should follow these specifications:

• Only use letters, numbers, and hyphens (No spaces!), because they will be linked to on the site.
• Use proper capitalization, for consistency.
• Have a wiki page with the same name.

Metadata

The metadata for the game is located at /<Game Name>/game.dat. This is required info about the game. The DAT values (See: TOML) are:

• title (String): English title of the game. This doesn't have to match the wiki or folder name, so there can be spaces.

• description (String): Get these from Wikipedia. Short, 1-2 line description of the game.

• github_issues (Array of integers): The GitHub issue IDs for the game. See: GitHub Issues.

• needs_system_files (Boolean): Whether the game requests the system files or not, regardless of whether it could be played without them.

• needs_shared_font (Boolean): Whether the game requests the shared font or not, regardless of whether it could be played without them.

• releases (Array of tables): Info about each release of the game.

  • title (String): Title ID of this release of the game. See: Title IDs.
  • region (String): Region of the game. Possible values are:
    • AUS
    • CHN
    • EUR
    • JPN
    • KOR
    • TWN
    • USA
    • ALL
      • Don't tag a game released in multiple regions as ALL. This is reserved for specific games released as such.
  • release_date (String): When the game was released in this region. See: Dates.

• testcases (Array of tables): Info about each submitted test case.

  • title (String): Title ID of this release of the game which was used during testing. See: Title IDs.
  • compatibility (String): How well the game works in Citra. A reference can be found here, with Won't Boot being "5", and Perfect being "0".
  • date (String): Last date the game was tested on. See: Dates.
  • version (String): Last version of Citra the game was tested on.
  • author (String): Your forum account name, if you have one. If you don't, don't include this line.
  • cpu (String): List your CPU following the example provided.
  • gpu (String: List your GPU as recognized by Citra in the terminal.
  • os (String): List your OS and version number following the example provided.

An example of a game metadata file is the one for The Legend of Zelda: Majora's Mask:

title = "The Legend of Zelda: Majora's Mask 3D"
description = "The Legend of Zelda: Majora's Mask 3D is an action-adventure video game co-developed by Grezzo and Nintendo for the Nintendo 3DS handheld game console. The game is an enhanced remake of The Legend of Zelda: Majora's Mask, which was originally released for the Nintendo 64 home console in 2000. The game was released worldwide in February 2015"
github_issues = [2517]
needs_system_files = false
needs_shared_font = false

[[ releases ]]
title = "0004000000125500"
region = "USA"
release_date = "2015-02-13"

[[ releases ]]
title = "0004000000125600"
region = "EUR"
release_date = "2015-02-13"

[[ testcases ]]
title = "0004000000125500"
compatibility = "1"
date = "2017-06-03"
version = "HEAD-a7ddec8"
author = "Flamboyant_Ham"
cpu = "Intel Core i7-4720HQ"
gpu = "GeForce GTX 960M"
os = "Windows 10 14393"

Icon

The icon for a game is located at /<Game Name>/icon.png. The suggested process for getting one is:

• Make sure the ROM for the game is in your Citra game directory.
• Take a screenshot of Citra's library listing.
• Crop out the game icon.
• The icon should be 48x48.

Game icons should not be compressed.

Boxart

The boxart for the game is located at /<Game Name>/boxart.png. The suggested process for getting retail boxart is:

• Download a scan from GameTDB, preferably with the Nintendo 3DS logo on the right.
• The boxart should be from the USA.
• Downsize it to approximately 328x300 using PicResize.
• Compress it using TinyPNG.

The required process for getting eShop only boxart is:

• Run the game in Citra.
• Use 1x internal resolution.
• Increase the window size of Citra to fill most of your monitor.
• Screenshot the title screen, which should only be the top screen.
• Downsize it to approximately 500x300 using PicResize.
• Compress it using TinyPNG.
• Examples are Legend of Zelda and Tetris

The required process for getting virtual console boxart is:

• Run the game in Citra.
• Use 1x internal resolution.
• Increase the window size of Citra to fill most of your monitor.
• Screenshot the title screen, which should only be the top screen.
• Downsize it to approximately 328x300 using PicResize.
• Compress it using TinyPNG.
• Examples are Legend of Zelda and Tetris

Screenshots

The screenshots for the game are located in /<Game Name>/screenshots/. Screenshots must follow these specifications:

• Native resolution.
• Smallest window size.
• Black background (For the blank space left and right of the bottom screen.). To achieve this, go to the User Directory, and from there navigate to the config directory. Open qt-config.ini with a text editor, and set bg_blue, bg_green, and bg_red to 0.
• Not compressed.

The name of the screenshot doesn't matter.

Savefiles

Metadata

The metadata for a save is located at /<Game Name>/savefiles/<Save Name>.dat. This is info about the save. The DAT values (See: TOML) are:

• title (String): The location of the save ingame.
• description (String): A brief explanation about the save.
• author (String): Your forum account name, if you have one. If you don't, don't include this line.
• title_id (String): Title ID of the game.

Save Data

The save data is located at /<Game Name>/savefiles/<Save Name>.zip. To make a ZIP file, the process is:

• Make sure the ROM for the game is in your Citra game directory.
• Right click on the game and click Open Save Data Location. This should open a folder named data.
• Note the folder that the data folder is in. This is the low Title ID. As an example, the low Title ID for The Legend of Zelda: Ocarina of Time is 00033500.
• The folder that the low Title ID folder is in should be named 00040000, the high Title ID.
• Copy the high title ID folder elsewhere.
• Delete everything from the high title ID folder except for the low Title ID folder.
• Compress the high title ID folder into a ZIP.

Wiki

The wiki contains info about specific game problems, and can be modified by anyone. They use Markdown formatting.

Each page's title should match the game's respective folder in the code section, except with hyphens in the code changed to spaces on the wiki.

The format of each page is as follows:

• H2 header with text saying Summary.
• Brief summary of how the game performs: graphically, auditorily, and frame rate (with general hardware comparison - see MK7 example).
• H3 subheader saying Problems.
• Slow frame rate issues are subjective and should not be included.
• For each problem, a bullet describing an issue the game has.
• For each of those bullets, make a sub-bullet linking to the relevant Github issue on citra-emu.
• If there's any relevant media, make another sub-bullet linking to it.

An example of a game wiki page is the one for Mario Kart 7:

## Summary
Mario Kart 7 has some problems in Citra. Graphically, the game suffers from minor issues, but requires decent hardware to obtain near full speed. It suffers from minor audio issues at times, but this does not hinder gameplay in any way. You may experience random crashes, slow down, and may need to transfer save files from Citra to your 3DS to complete certain tracks.

### Problems
- Random crashes may occur.
  - Github Issue: [#2443](https://github.com/citra-emu/citra/issues/2443).
- All particle effects (Such as smoke, tire tracks, or drift sparks.) are rendered incorrectly. They may copy HUD elements, or just be black.
  - Github Issue: [#1887](https://github.com/citra-emu/citra/issues/1887).
- Looping audio buffers aren't supported.
  - Github Issue: [#2093](https://github.com/citra-emu/citra/issues/2093).
- When using the software renderer, Mii characters are not rendered.
  - Github Issue: [#1749](https://github.com/citra-emu/citra/issues/1749)