Oh0kaYthen86 (talk | contribs) (changed various required parameters to suggested) |
m (update param table) |
||
Line 36: | Line 36: | ||
"VersionAdded": { | "VersionAdded": { | ||
"label": "Version Added", | "label": "Version Added", | ||
"description": "The version in which area was first added.", | "description": "The version in which the area was first added.", | ||
"example": "0.114", | "example": "0.114", | ||
"type": "string", | "type": "string", | ||
Line 100: | Line 100: | ||
"description": "List of area connections (using the Connection template) to this location that have since been removed.", | "description": "List of area connections (using the Connection template) to this location that have since been removed.", | ||
"type": "string", | "type": "string", | ||
"example": "{{Connection|Digital Forest | "example": "{{Connection|Digital Forest}}" | ||
}, | }, | ||
"BGM": { | "BGM": { | ||
Line 111: | Line 111: | ||
"Map ID": { | "Map ID": { | ||
"label": "Map ID", | "label": "Map ID", | ||
"description": "List of IDs corresponding to the location's map and its sub-areas. Zero-padded, with four digits.", | "description": "List of IDs corresponding to the location's map and its sub-areas. Zero-padded, with four digits. Annotations may be added to each map ID using parentheses. If you wish to include commas in these annotations, use , - it will break otherwise.", | ||
"example": "0002, 0003", | "example": "0002, 0003", | ||
"type": "string", | "type": "string", | ||
Line 124: | Line 124: | ||
"Contributing": { | "Contributing": { | ||
"label": "Contributing", | "label": "Contributing", | ||
"description": "Authors who have added to the location | "description": "Authors who have added to the location.", | ||
"type": "string" | "type": "string" | ||
}, | }, | ||
Line 270: | Line 270: | ||
|Contributing = qxy | |Contributing = qxy | ||
}} | }} | ||
<noinclude>[[Category:Template | <noinclude>[[Category:Template Documentation]]</noinclude> |
Revision as of 05:36, 10 August 2023
Displays a location box, which contains a world's details.
Parameter | Description | Type | Status | |
---|---|---|---|---|
(Header color) | headercolor | The color of the header of the location box.
| String | suggested |
(Header font color) | headerfontcolor | The color of the text for the header of the location box.
| String | suggested |
Original Name(s) | Name | The area's original Japanese (or generally, native, assuming a fangame's language is not English) names, along with any translations thereof, separated by commas.
| String | suggested |
(Location image) | image | The file name for the image to be displayed by the location box.
| File | required |
(Location image caption) | caption | The corresponding caption for the image, visible if a value is provided. | String | optional |
Japanese Name | JapaneseName | The area's original name in Japanese, if applicable.
| String | optional |
Version Added | VersionAdded | The version in which the area was first added.
| String | suggested |
Version Removed | VersionRemoved | The version in which the area was removed, if applicable.
| String | optional |
Versions Updated | VersionsUpdated | The version(s) in which the area has been updated. This should not include VersionAdded, VersionRemoved, or any removed versions in VersionGaps. Use commas to separate multiple instances. Versions may also be followed by a dash and a 1 or 2 character code; this is an update type identifier used by Yume 2kki Explorer, and these are automatically handled by the version manager in the app.
| String | optional |
Version Gaps | VersionGaps | Any gaps where the area was removed only to later be re-added, starting with the version it was removed, followed by a dash, followed by the version it was re-added in. Use commas to separate multiple instances.
| String | optional |
Effects | Effects | Effects (or the game's equivalent) obtainable in this location.
| String | required |
Wallpapers | Wallpapers Menu | Collectibles that you can find in this location.
| String | suggested |
Events | Events | Events that you can encounter in this location. | String | required |
Map Type | Map Type | Descriptors for a given location, such as the overall map size and whether it loops or otherwise.
| String | optional |
Notable NPCs | NPCS | Noteworthy NPCs that show up in this location. | String | suggested |
Connecting Areas | Connections | List of areas connected to this location (using the Connection template) as of the game's current version.
| String | required |
Removed Connections | RemovedConnections | List of area connections (using the Connection template) to this location that have since been removed.
| String | optional |
BGM | BGM | List of tracks (using the BGM template) that play in this location and/or specific rooms/maps within it.
| String | required |
Map ID | Map ID | List of IDs corresponding to the location's map and its sub-areas. Zero-padded, with four digits. Annotations may be added to each map ID using parentheses. If you wish to include commas in these annotations, use , - it will break otherwise.
| String | required |
Author | Primary | The location's main author. | String | suggested |
Contributing | Contributing | Authors who have added to the location. | String | optional |
Semantic properties
This template exposes the following semantic properties.
Property name | Description | Data type | Cardinality |
---|---|---|---|
Has location image filename | The location image's filename. | Page | Single |
Header font color | The color of the locationbox's header text. Used for location-based styling. | String | Single |
Header background color | The color of the locationbox's header background. Used for location-based styling. | String | Single |
Has location image | The path pointing to the location image. Used for external applications to refer to the image. | String | Single |
Japanese name | The area's Japanese (or generally, native-language) name. Used for localization purposes. | String | Single |
Version added | The version where the location was added. Primarily used with the Yume 2kki Explorer. | String | Single |
Versions updated | The version(s) where the location was updated. Primarily used with the Yume 2kki Explorer. | String | Multiple |
Version removed | The version where the location was removed. Primarily used with the Yume 2kki Explorer. | String | Single |
Version gaps | The versions where the location was absent prior to its return. Primarily used with the Yume 2kki Explorer. | String | Multiple |
Has map type | The properties describing a map's nature. | String | Multiple |
Has primary author | The person who has created the location; this is applicable to collaborative fangame projects. | String | Single |
Has contributing author | The person(s) contributing to the the development of the location; this is applicable to collaborative fangame projects. | String | Multiple |
General usage
{{Locationbox |headercolor = #4a0400 |headerfontcolor = #ffa500 |image = volcanic_subterrain.png |Effects = None |Wallpapers = None |Events = None |NPCS = None |Connections = {{Connection|Chemical Research Facility|one_way_type=NoEntry}} |BGM = {{BGM|title=bgm-e|filename=Bgm-e.ogg|label=after lighting the foundry}} |Map ID = 1023 |Primary = Ruri |Contributing = qxy }}
will return:
Locationbox/doc | |
---|---|
Basic Info | |
Effects | None |
Events | None |
Notable NPCs | None |
Other | |
Connecting Areas | Chemical Research Facility ⛔ |
BGM | 🔊 bgm-e – after lighting the foundry |
Map ID | 1023 |
Primary Author | Ruri |
Contributing Author(s) | qxy |