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



YumeWiki
3,033Articles

Template:Locationbox/doc: Difference between revisions

(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|is_removed=true}}"
"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, visible if a value is provided.",
"description": "Authors who have added to the location.",
"type": "string"
"type": "string"
},
},
Line 270: Line 270:
  |Contributing = qxy
  |Contributing = qxy
}}
}}
<noinclude>[[Category:Template documentation|{{PAGENAME}}]]</noinclude>
<noinclude>[[Category:Template Documentation]]</noinclude>

Revision as of 05:36, 10 August 2023

Displays a location box, which contains a world's details.

Template parameters

This template has custom formatting.

ParameterDescriptionTypeStatus
(Header color)headercolor

The color of the header of the location box.

Default
#3366cc
Stringsuggested
(Header font color)headerfontcolor

The color of the text for the header of the location box.

Default
#ffffff
Stringsuggested
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.

Example
扉部屋, ''Tobirabeya'', Door Room
Stringsuggested
(Location image)image

The file name for the image to be displayed by the location box.

Example
Azure_garden.png
Filerequired
(Location image caption)caption

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

Stringoptional
Japanese NameJapaneseName

The area's original name in Japanese, if applicable.

Example
扉部屋
Stringoptional
Version AddedVersionAdded

The version in which the area was first added.

Default
x.x
Example
0.114
Stringsuggested
Version RemovedVersionRemoved

The version in which the area was removed, if applicable.

Example
0.115a
Stringoptional
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
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
EffectsEffects

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

Example
Chainsaw
Stringrequired
WallpapersWallpapers Menu

Collectibles that you can find in this location.

Example
WP #87, Kura Puzzle #45
Stringsuggested
EventsEvents

Events that you can encounter in this location.

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
Notable NPCsNPCS

Noteworthy NPCs that show up in this location.

Stringsuggested
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 area connections (using the Connection template) to this location that have since been removed.

Example
{{Connection|Digital Forest}}
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. If you wish to include commas in these annotations, use &comma; - it will break otherwise.

Example
0002, 0003
Stringrequired
AuthorPrimary

The location's main author.

Stringsuggested
ContributingContributing

Authors who have added to the location.

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 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
Volcanic subterrain.png
Basic Info
Effects EffectNone
Events None
Notable NPCs None
Other
Connecting Areas Chemical Research Facility NoEntry
BGM 🔊 bgm-e – after lighting the foundry
Map ID 1023
Primary Author Ruri
Contributing Author(s) qxy