1
0
Fork 0

Update Contributing Guide (#323)

* Remove extra title field documentation, leftover from the removal of testcases.

* Add screenshot name note.

* Add screenshot variety note.

* Modify title ID section to link to the 3DS Release Database, to cover all regions.

* Modify title ID section to cover getting the user's own release TID, surround the OoT TID with code tags, and link to TID section in save metadata section.

* Made line less redundant.

* Added POV note to wiki section.
This commit is contained in:
Koopa 2018-05-16 18:33:03 -04:00 committed by GitHub
parent 5348d77dcb
commit 6ab0e58955
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 6 deletions

View File

@ -38,7 +38,9 @@ Game issues can be found [here](https://github.com/citra-emu/citra/issues). The
The recommended application for capturing the icon, boxart, and screenshots is [ShareX](https://github.com/ShareX/ShareX). Screenshots can not be compressed, and must be in the PNG format. The recommended application for capturing the icon, boxart, and screenshots is [ShareX](https://github.com/ShareX/ShareX). Screenshots can not be compressed, and must be in the PNG format.
### Title IDs ### 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`. The title ID for a game is a unique ID representing that release of the game. Often, games released in multiple regions will have a different title ID for each, with the exception of some games like the main series Pokémon games. A database of such releases and their title IDs can be found [here](http://3dsdb.com/).
To find the title ID of your release, it 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 ### TOML
In this repo, DAT files follow the [TOML](https://github.com/toml-lang/toml) syntax, where each line consists of the creation of a piece of data. The simplest form of this is assigning a value to a key (`<Key> = <Value>`). The data types used for these `Value`s in this wiki are: In this repo, DAT files follow the [TOML](https://github.com/toml-lang/toml) syntax, where each line consists of the creation of a piece of data. The simplest form of this is assigning a value to a key (`<Key> = <Value>`). The data types used for these `Value`s in this wiki are:
@ -77,7 +79,6 @@ The metadata for the game is located at `/<Game Name>/game.dat`. This is require
- `usa` - `usa`
- `all` (Don't tag a game released in multiple regions as `all`. This is reserved for specific games released as such.) - `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](#dates). - `release_date` (String): When the game was released in this region. See: [Dates](#dates).
- `title` (String): Title ID of this release of the game which was used during testing. See: [Title IDs](#title-ids).
An example of a game metadata file is the one for [The Legend of Zelda: Majora's Mask](https://github.com/citra-emu/citra-games-wiki/blob/master/games/legend-of-zelda-majoras-mask/game.dat): An example of a game metadata file is the one for [The Legend of Zelda: Majora's Mask](https://github.com/citra-emu/citra-games-wiki/blob/master/games/legend-of-zelda-majoras-mask/game.dat):
```toml ```toml
@ -134,9 +135,11 @@ The required process for getting virtual console boxart is:
The screenshots for the game are located in `/<Game Name>/screenshots/` (See: [Screenshots](#screenshots)). Screenshots **must** follow these specifications: The screenshots for the game are located in `/<Game Name>/screenshots/` (See: [Screenshots](#screenshots)). Screenshots **must** follow these specifications:
- Native resolution. - Native resolution.
- Smallest window size. - Smallest window size.
- Black background (For the blank space left and right of the bottom screen.). To achieve this, go to the [User Directory](https://citra-emu.org/wiki/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. - Have variety. In addition to, say, the title screen, you should also have screenshots of different areas of gameplay, unless the game crashes before then.
- Accurate file name. The file name should provide a general idea of what's being shown (e.g. `title-screen.png`, `lost-woods.png`, `level-3-4.png`).
- Black background (For the blank space left and right of the bottom screen.). This is the default setting, but if you've changed it, go to the [User Directory](https://citra-emu.org/wiki/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.
Additionally, if a game has a rating of 3 or higher, **you must include at least 3 screenshots**, otherwise 1 screenshot is acceptable. The names of the screenshots don't matter. Additionally, if a game has a rating of 3 or higher, **you must include at least 3 screenshots**, otherwise 1 screenshot is acceptable.
### Savefiles ### Savefiles
#### Save Metadata #### Save Metadata
@ -144,7 +147,7 @@ The metadata for a save is located at `/<Game Name>/savefiles/<Save Name>.dat`.
- `title` (String): The location of the save ingame. - `title` (String): The location of the save ingame.
- `description` (String): A brief explanation about the save. - `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. - `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. - `title_id` (String): Title ID of the game. See: [Title IDs](#title-ids).
#### Save Data #### Save Data
The save data is located at `/<Game Name>/savefiles/<Save Name>.zip` (See: [Citra Version](#citra-version)). To make a ZIP file, the process is: The save data is located at `/<Game Name>/savefiles/<Save Name>.zip` (See: [Citra Version](#citra-version)). To make a ZIP file, the process is:
@ -163,7 +166,7 @@ Each page's title should match the game's respective folder in the code section,
The format of each page is as follows: The format of each page is as follows:
- H2 header with text saying `Summary`. - 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). See: [Citra Version](#citra-version). - Brief summary of how the game performs: graphically, auditorily, and frame rate (with general hardware comparison - see MK7 example). This should be written objectively, without the use of words like "I". See: [Citra Version](#citra-version).
An example of a game wiki page is the one for [Mario Kart 7](https://github.com/citra-emu/citra-games-wiki/wiki/Mario-Kart-7): An example of a game wiki page is the one for [Mario Kart 7](https://github.com/citra-emu/citra-games-wiki/wiki/Mario-Kart-7):
```markdown ```markdown