(update example) |
(add missing optional parameters and change order) |
||
Line 3: | Line 3: | ||
"params": { | "params": { | ||
"headercolor": { | "headercolor": { | ||
"label": " | "label": "Header color", | ||
"description": "The color | "description": "The header's background color.", | ||
"type": "string", | "type": "string", | ||
" | "suggested": true, | ||
" | "default": "#3366CC" | ||
}, | }, | ||
"headerfontcolor": { | "headerfontcolor": { | ||
"label": " | "label": "Header font color", | ||
"description": "The color | "description": "The header's text color.", | ||
"type": "string", | "type": "string", | ||
" | "suggested": true, | ||
" | "default": "#ffffff" | ||
}, | }, | ||
"image": { | "image": { | ||
"label": " | "label": "Location image", | ||
"description": "The file name for the image to be displayed | "description": "The file name for the image to be displayed. It should properly represent the location.", | ||
"type": "wiki-file-name", | "type": "wiki-file-name", | ||
"example": "Azure_garden.png", | "example": "Azure_garden.png", | ||
"required": true | "required": true | ||
}, | }, | ||
"Name": { | "Name": { | ||
"label": "Original Name(s)", | "label": "Original Name(s)", | ||
"description": "The area's original | "description": "The area's original native-language names, along with any translations thereof, separated by commas. If the original name is Japanese and you specified it for \"JapaneseName\", do not repeat it here.", | ||
"example": " | "example": "''Tobirabeya'', Door Room", | ||
"type": "string", | "type": "string", | ||
"suggested": true | "suggested": true | ||
Line 37: | Line 32: | ||
"JapaneseName": { | "JapaneseName": { | ||
"label": "Japanese Name", | "label": "Japanese Name", | ||
"description": "The area's original name in Japanese, if applicable.", | "description": "The area's original name in Japanese, if applicable. Only one value is accepted.", | ||
"example": "扉部屋", | "example": "扉部屋", | ||
"type": "string" | "type": "string" | ||
Line 57: | Line 52: | ||
"Menu" | "Menu" | ||
], | ], | ||
" | "required": true | ||
}, | }, | ||
"Events": { | "Events": { | ||
Line 69: | Line 64: | ||
"description": "Noteworthy NPCs that show up in this location.", | "description": "Noteworthy NPCs that show up in this location.", | ||
"type": "string", | "type": "string", | ||
" | "required": true | ||
}, | }, | ||
"Connections": { | "Connections": { | ||
Line 77: | Line 72: | ||
"example": "{{Connection|Dream Pool|one_way_type=NoEntry}}", | "example": "{{Connection|Dream Pool|one_way_type=NoEntry}}", | ||
"required": true | "required": true | ||
}, | }, | ||
"BGM": { | "BGM": { | ||
Line 94: | Line 83: | ||
"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. Annotations may be added to each map ID using parentheses.", | "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.", | ||
"example": "0002, 0003", | "example": "0002, 0003 (Sub-area)", | ||
"type": "string", | "type": "string", | ||
"required": true | "required": true | ||
}, | }, | ||
"VersionAdded": { | "VersionAdded": { | ||
Line 108: | Line 91: | ||
"description": "The version in which the area was first added.", | "description": "The version in which the area was first added.", | ||
"example": "0.114", | "example": "0.114", | ||
"type": "string", | |||
"required": true | |||
}, | |||
"VersionsUpdated": { | |||
"label": "Versions Updated", | |||
"description": "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.", | |||
"example": "0.112, 0.112 patch 1, 0.112d", | |||
"type": "string", | |||
"suggested": true | |||
}, | |||
"Primary": { | |||
"label": "Primary Author", | |||
"description": "The location's main author(s). Applicable to collaborative games.", | |||
"type": "string", | "type": "string", | ||
"suggested": true | "suggested": true | ||
}, | |||
"Contributing": { | |||
"label": "Contributing Authors", | |||
"description": "Authors who have contributed to the location. Applicable to collaborative games.", | |||
"type": "string" | |||
}, | |||
"name": { | |||
"label": "Display Name", | |||
"description": "Overrides using the page name as the header text. If the name of the location should be changed on the wiki, move the page instead of using this parameter.", | |||
"type": "string", | |||
"autovalue": "{{PAGENAME}}" | |||
}, | |||
"headerfontsize": { | |||
"label": "Header font size", | |||
"description": "The header's font size as a percentage.", | |||
"type": "string", | |||
"default": "200%" | |||
}, | |||
"imagewidth": { | |||
"label": "Image width", | |||
"description": "The image width in px.", | |||
"type": "number", | |||
"default": "250" | |||
}, | |||
"caption": { | |||
"label": "Image caption", | |||
"description": "A corresponding caption for the image, visible if a value is provided.", | |||
"type": "string" | |||
}, | |||
"Masks": { | |||
"label": "Masks", | |||
"description": "Yume 2kki Masks available to equip in the location.", | |||
"type": "string" | |||
}, | |||
"RemovedConnections": { | |||
"label": "Removed Connections", | |||
"description": "List of areas connected to this location (using the Connection template) that have since been removed. Be sure to include \"is_removed=true\" in each connection.", | |||
"type": "string", | |||
"example": "{{Connection|Digital Forest|is_removed=true}}" | |||
}, | |||
"Map Type": { | |||
"label": "Map Type", | |||
"description": "Descriptors for a given location, such as the overall map size and whether it loops or otherwise.", | |||
"example": "Small, Non-looping", | |||
"type": "string" | |||
}, | }, | ||
"VersionRemoved": { | "VersionRemoved": { | ||
Line 121: | Line 162: | ||
"description": "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.", | "description": "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.", | ||
"example": "0.110b-0.110b patch 1,0.111-0.113a", | "example": "0.110b-0.110b patch 1,0.111-0.113a", | ||
"type": "string" | "type": "string" | ||
} | } | ||
Line 146: | Line 170: | ||
"headerfontcolor", | "headerfontcolor", | ||
"image", | "image", | ||
"Name", | "Name", | ||
"JapaneseName", | "JapaneseName", | ||
Line 154: | Line 177: | ||
"NPCS", | "NPCS", | ||
"Connections", | "Connections", | ||
"BGM", | "BGM", | ||
"Map ID", | "Map ID", | ||
"VersionAdded", | "VersionAdded", | ||
"VersionsUpdated", | "VersionsUpdated", | ||
"Primary", | "Primary", | ||
"Contributing" | "Contributing", | ||
"name", | |||
"headerfontsize", | |||
"imagewidth", | |||
"caption", | |||
"Masks", | |||
"RemovedConnections", | |||
"Map Type", | |||
"VersionRemoved", | |||
"VersionGaps" | |||
], | ], | ||
"format": "{{_\n|_ = _\n}}" | "format": "{{_\n|_ = _\n}}" |
Revision as of 23:09, 21 June 2024
Displays a location box, which contains a world's details.
Parameter | Description | Type | Status | |
---|---|---|---|---|
Header color | headercolor | The header's background color.
| String | suggested |
Header font color | headerfontcolor | The header's text color.
| String | suggested |
Location image | image | The file name for the image to be displayed. It should properly represent the location.
| File | required |
Original Name(s) | Name | The area's original native-language names, along with any translations thereof, separated by commas. If the original name is Japanese and you specified it for "JapaneseName", do not repeat it here.
| String | suggested |
Japanese Name | JapaneseName | The area's original name in Japanese, if applicable. Only one value is accepted.
| String | optional |
Effects | Effects | Effects (or the game's equivalent) obtainable in this location.
| String | required |
Collectibles | Collectibles Wallpapers Menu | Collectibles that you can find in this location.
| String | required |
Events | Events | Events that you can encounter in this location. | String | required |
Notable NPCs | NPCS | Noteworthy NPCs that show up in this location. | String | required |
Connecting Areas | Connections | List of areas connected to this location (using the Connection template) as of the game's current version.
| String | required |
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.
| String | required |
Version Added | VersionAdded | The version in which the area was first added.
| String | required |
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 | suggested |
Primary Author | Primary | The location's main author(s). Applicable to collaborative games. | String | suggested |
Contributing Authors | Contributing | Authors who have contributed to the location. Applicable to collaborative games. | String | optional |
Display Name | name | Overrides using the page name as the header text. If the name of the location should be changed on the wiki, move the page instead of using this parameter.
| String | optional |
Header font size | headerfontsize | The header's font size as a percentage.
| String | optional |
Image width | imagewidth | The image width in px.
| Number | optional |
Image caption | caption | A corresponding caption for the image, visible if a value is provided. | String | optional |
Masks | Masks | Yume 2kki Masks available to equip in the location. | String | optional |
Removed Connections | RemovedConnections | List of areas connected to this location (using the Connection template) that have since been removed. Be sure to include "is_removed=true" in each connection.
| String | optional |
Map Type | Map Type | Descriptors for a given location, such as the overall map size and whether it loops or otherwise.
| String | optional |
Version Removed | VersionRemoved | The version in which the area was removed, if applicable.
| 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 |
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(s) who created the location; this is applicable to collaborative fangame projects. | String | Multiple |
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 |name = Volcanic Subterrain |headercolor = #4a0400 |headerfontcolor = #ffa500 |image = volcanic_subterrain.png |JapaneseName = 鍛冶場 |Name = 鍛冶場, ''Kajiba'', Foundry |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 |VersionAdded = 0.109h patch 4 |VersionRemoved = 0.112i }}
will return:
Volcanic Subterrain | |
---|---|
Basic Info | |
Japanese Name(s) |
鍛冶場 |
Effects | None |
Events | None |
Notable NPCs | None |
Other | |
Connecting Areas | Chemical Research Facility ⛔ |
BGM | 🔊 bgm-e – after lighting the foundry |
Map ID | 1023 |
Version Added | 0.109h patch 4 |
Version Removed | 0.112i |
Primary Author | Ruri |
Contributing Author(s) | qxy |