(Change order of params in templatedata to match presented order when using the template) |
(update example) |
||
Line 240: | Line 240: | ||
==General usage== | ==General usage== | ||
<pre style="line-height:1.6;"> | <pre style="line-height:1.6;"> | ||
{{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 | |||
}} | |||
</pre> | </pre> | ||
will return: | will return: | ||
{{Locationbox | {{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 | |||
}} | }} | ||
<noinclude>[[Category:Template | <noinclude>[[Category:Template documentation]]</noinclude> |
Revision as of 18:15, 2 June 2024
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 |
(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 |
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 |
Japanese Name | JapaneseName | The area's original name in Japanese, if applicable.
| 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 | suggested |
Events | Events | Events that you can encounter in this location. | String | required |
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.
| 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 |
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 |
Author | Primary | The location's main author(s). | String | suggested |
Contributing | Contributing | Authors who have contributed 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(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 |