×
Create a new article
Write your page title here:
We currently have 3,036 articles on YumeWiki. Type your article name above or click on one of the titles below and start writing!



YumeWiki
3,036Articles

Template:Locationbox/doc: Difference between revisions

(changed various required parameters to suggested)
m (Add small note about matching names with JP wiki)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{CategorySetting}}
{{PropertySetting}}
<templatedata>
<templatedata>
{
{ "description": "Displays an infobox containing a world's details.",
"params": {
"params": {
"headercolor": {
"headercolor": {
"label": "(Header color)",
"label": "Header color",
"description": "The color of the header of the location box.",
"description": "The header's background color.",
"type": "string",
"type": "string",
"default": "#3366cc",
"suggested": true,
"suggested": true
"default": "#3366CC"
},
},
"headerfontcolor": {
"headerfontcolor": {
"label": "(Header font color)",
"label": "Header font color",
"description": "The color of the text for the header of the location box.",
"description": "The header's text color.",
"type": "string",
"type": "string",
"default": "#ffffff",
"suggested": true,
"suggested": true
"default": "#ffffff"
},
},
"image": {
"image": {
"label": "(Location image)",
"label": "Location image",
"description": "The file name for the image to be displayed by the location box.",
"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
},
},
"caption": {
"Name": {
"label": "(Location image caption)",
"label": "Original Name(s)",
"description": "The corresponding caption for the image, visible if a value is provided.",
"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.",
"type": "string"
"example": "''Tobirabeya'', Door Room",
"type": "string",
"suggested": true
},
},
"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. For Yume 2kki, this should match the name used by the JP wiki, i.e. https://wikiwiki.jp/yume2kki-t/<NAME> should exist as an actual page.",
"example": "扉部屋",
"example": "扉部屋",
"type": "string"
},
"VersionAdded": {
"label": "Version Added",
"description": "The version in which area was first added.",
"example": "0.114",
"type": "string",
"default": "x.x",
"suggested": true
},
"VersionRemoved": {
"label": "Version Removed",
"description": "The version in which the area was removed, if applicable.",
"example": "0.115a",
"type": "string"
},
"VersionGaps": {
"label": "Version Gaps",
"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",
"type": "string"
},
"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"
"type": "string"
},
},
Line 67: Line 45:
"required": true
"required": true
},
},
"Wallpapers": {
"Collectibles": {
"label": "Wallpapers",
"label": "Collectibles",
"description": "Collectibles that you can find in this location.",
"description": "Collectibles that you can find in this location.",
"example": "WP #87, Kura Puzzle #45",
"example": "WP #87, Kura Puzzle #45",
"type": "string",
"type": "string",
"aliases": [
"aliases": [
"Wallpapers",
"Menu"
"Menu"
],
],
"suggested": true
"required": true
},
},
"Events": {
"Events": {
Line 87: Line 66:
"description": "Noteworthy NPCs that show up in this location.",
"description": "Noteworthy NPCs that show up in this location.",
"type": "string",
"type": "string",
"suggested": true
"required": true
},
},
"Connections": {
"Connections": {
Line 95: Line 74:
"example": "{{Connection|Dream Pool|one_way_type=NoEntry}}",
"example": "{{Connection|Dream Pool|one_way_type=NoEntry}}",
"required": true
"required": true
},
"RemovedConnections": {
"label": "Removed Connections",
"description": "List of area connections (using the Connection template) to this location that have since been removed.",
"type": "string",
"example": "{{Connection|Digital Forest|is_removed=true}}"
},
},
"BGM": {
"BGM": {
Line 111: Line 84:
"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.",
"example": "0002, 0003",
"example": "0002, 0003 (Sub-area)",
"type": "string",
"required": true
},
"VersionAdded": {
"label": "Version Added",
"description": "The version in which the area was first added.",
"example": "0.114",
"type": "string",
"type": "string",
"required": true
"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": {
"Primary": {
"label": "Author",
"label": "Primary Author",
"description": "The location's main author.",
"description": "The location's main author(s). Applicable to collaborative games.",
"type": "string",
"type": "string",
"suggested": true
"suggested": true
},
},
"Contributing": {
"Contributing": {
"label": "Contributing",
"label": "Contributing Authors",
"description": "Authors who have added to the location, visible if a value is provided.",
"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"
"type": "string"
},
},
"Name": {
"RemovedConnections": {
"label": "Original Name(s)",
"label": "Removed Connections",
"description": "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.",
"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.",
"example": "扉部屋, ''Tobirabeya'', Door Room",
"type": "string",
"type": "string",
"suggested": true
"example": "{{Connection|Digital Forest|is_removed=true}}"
},
},
"Map Type": {
"Map Type": {
Line 138: Line 152:
"description": "Descriptors for a given location, such as the overall map size and whether it loops or otherwise.",
"description": "Descriptors for a given location, such as the overall map size and whether it loops or otherwise.",
"example": "Small, Non-looping",
"example": "Small, Non-looping",
"type": "string"
},
"VersionRemoved": {
"label": "Version Removed",
"description": "The version in which the area was removed, if applicable, i.e. the first version in which the area is no longer accessible.",
"example": "0.115a",
"type": "string"
},
"VersionGaps": {
"label": "Version Gaps",
"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",
"type": "string"
"type": "string"
}
}
},
},
"description": "Displays a location box, which contains a world's details.",
"format": "{{_\n|_ = _\n}}",
"paramOrder": [
"paramOrder": [
"name",
"headercolor",
"headercolor",
"headerfontcolor",
"headerfontcolor",
"Name",
"headerfontsize",
"image",
"image",
"imagewidth",
"caption",
"caption",
"JapaneseName",
"JapaneseName",
"VersionAdded",
"Name",
"VersionRemoved",
"VersionsUpdated",
"VersionGaps",
"Effects",
"Effects",
"Wallpapers",
"Collectibles",
"Masks",
"Events",
"Events",
"Map Type",
"NPCS",
"NPCS",
"Connections",
"Connections",
Line 162: Line 187:
"BGM",
"BGM",
"Map ID",
"Map ID",
"Map Type",
"VersionAdded",
"VersionsUpdated",
"VersionRemoved",
"VersionGaps",
"Primary",
"Primary",
"Contributing"
"Contributing"
],
]
"format": "{{_\n|_ = _\n}}"
}
}
</templatedata>
</templatedata>
Line 228: Line 257:
|-
|-
|Has primary author
|Has primary author
|The person who has created the location; this is applicable to collaborative fangame projects.
|The person(s) who created the location; this is applicable to collaborative fangame projects.
|String
|String
|Single
|Multiple
|-
|-
|Has contributing author
|Has contributing author
Line 240: Line 269:
==General usage==
==General usage==
<pre style="line-height:1.6;">
<pre style="line-height:1.6;">
{{Locationbox
{{Locationbox
|headercolor = #4a0400
|name = Volcanic Subterrain
|headerfontcolor = #ffa500
|headercolor = #4a0400
|image = volcanic_subterrain.png
|headerfontcolor = #ffa500
|Effects = None
|image = volcanic_subterrain.png
|Wallpapers = None
|JapaneseName = 鍛冶場
|Events = None
|Name = ''Kajiba'', Foundry
|NPCS = None
|Effects = None
|Connections = {{Connection|Chemical Research Facility|one_way_type=NoEntry}}
|Wallpapers = None
|BGM = {{BGM|title=bgm-e|filename=Bgm-e.ogg|label=after lighting the foundry}}
|Events = None
|Map ID = 1023
|NPCS = None
|Primary = Ruri
|Connections = {{Connection|Chemical Research Facility|one_way_type=NoEntry}}
|Contributing = qxy
|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
|headercolor = #4a0400
|name = Volcanic Subterrain
|headerfontcolor = #ffa500
|headercolor = #4a0400
|image = volcanic_subterrain.png
|headerfontcolor = #ffa500
|Effects = None
|image = volcanic_subterrain.png
|Wallpapers = None
|JapaneseName = 鍛冶場
|Events = None
|Name = ''Kajiba'', Foundry
|NPCS = None
|Effects = None
|Connections = {{Connection|Chemical Research Facility|one_way_type=NoEntry}}
|Wallpapers = None
|BGM = {{BGM|title=bgm-e|filename=Bgm-e.ogg|label=after lighting the foundry}}
|Events = None
|Map ID = 1023
|NPCS = None
|Primary = Ruri
|Connections = [[Yume 2kki:Chemical Research Facility|Chemical Research Facility]] <span title="Cannot be entered from this area" tabindex="0" style="font-size:125%; line-height:1em;">⛔</span>
|Contributing = qxy
|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 documentation|{{PAGENAME}}]]</noinclude>
 
<noinclude>__NOTOC__ [[Category:Template documentation]]</noinclude>
<includeonly>__NOEDITSECTION__
[[Category:Wiki-dependent]]
[[Category:Location templates]]
[[Category:Infobox templates]]
</includeonly>

Latest revision as of 22:36, 9 November 2024

Displays an infobox containing a world's details.

Template parameters

This template has custom formatting.

ParameterDescriptionTypeStatus
Display Namename

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.

Auto value
{{PAGENAME}}
Stringoptional
Header colorheadercolor

The header's background color.

Default
#3366CC
Stringsuggested
Header font colorheaderfontcolor

The header's text color.

Default
#ffffff
Stringsuggested
Header font sizeheaderfontsize

The header's font size as a percentage.

Default
200%
Stringoptional
Location imageimage

The file name for the image to be displayed. It should properly represent the location.

Example
Azure_garden.png
Filerequired
Image widthimagewidth

The image width in px.

Default
250
Numberoptional
Image captioncaption

A corresponding caption for the image, visible if a value is provided.

Stringoptional
Japanese NameJapaneseName

The area's original name in Japanese, if applicable. Only one value is accepted. For Yume 2kki, this should match the name used by the JP wiki, i.e. https://wikiwiki.jp/yume2kki-t/<NAME> should exist as an actual page.

Example
扉部屋
Stringoptional
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.

Example
''Tobirabeya'', Door Room
Stringsuggested
EffectsEffects

Effects (or the game's equivalent) obtainable in this location.

Example
Chainsaw
Stringrequired
CollectiblesCollectibles Wallpapers Menu

Collectibles that you can find in this location.

Example
WP #87, Kura Puzzle #45
Stringrequired
MasksMasks

Yume 2kki Masks available to equip in the location.

Stringoptional
EventsEvents

Events that you can encounter in this location.

Stringrequired
Notable NPCsNPCS

Noteworthy NPCs that show up in this location.

Stringrequired
Connecting AreasConnections

List of areas connected to this location (using the Connection template) as of the game's current version.

Example
{{Connection|Dream Pool|one_way_type=NoEntry}}
Stringrequired
Removed ConnectionsRemovedConnections

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.

Example
{{Connection|Digital Forest|is_removed=true}}
Stringoptional
BGMBGM

List of tracks (using the BGM template) that play in this location and/or specific rooms/maps within it.

Example
{{BGM|title=soto_C5|filename=Soto-C5.ogg|label=Glasses Path}}
Stringrequired
Map IDMap 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.

Example
0002, 0003 (Sub-area)
Stringrequired
Map TypeMap Type

Descriptors for a given location, such as the overall map size and whether it loops or otherwise.

Example
Small, Non-looping
Stringoptional
Version AddedVersionAdded

The version in which the area was first added.

Example
0.114
Stringrequired
Versions UpdatedVersionsUpdated

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
Stringsuggested
Version RemovedVersionRemoved

The version in which the area was removed, if applicable, i.e. the first version in which the area is no longer accessible.

Example
0.115a
Stringoptional
Version GapsVersionGaps

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
Stringoptional
Primary AuthorPrimary

The location's main author(s). Applicable to collaborative games.

Stringsuggested
Contributing AuthorsContributing

Authors who have contributed to the location. Applicable to collaborative games.

Stringoptional

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
Volcanic subterrain.png
Basic Info
Japanese Name(s)

鍛冶場
Kajiba
Foundry

Effects EffectNone
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