Difference between revisions of "Help:Style guide/Maps"

From Team Fortress Wiki
Jump to: navigation, search
m (another categorization rule update)
m (some mc to the policy, mostly rewording)
 
(13 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
== Article titles ==
 
== Article titles ==
Article titles should be the map's name, without a prefix. For maps with conflicting versions of the name, the name displayed in the game on the loading screen should be used.
+
Article titles should be the map's name, without the prefix that appears on the filename. For maps with conflict between the filename and the displayed name, the name displayed in the game on the loading screen should be used.
  
*'''Example:''' [[Double Cross]], not Doublecross, is used despite appearing in both forms as Double Cross is what appears in-game.
+
*'''Example:''' [[Double Cross]], not Doublecross, is used despite appearing in both forms, because Double Cross is what appears in-game.
  
For maps with multiple versions, the original version – or official version – takes the normal article title, while additional versions have their full game mode appended in parentheses.
+
For maps with multiple versions added to the game over time, the original version – the first version officially [[Patches|patched]] to the game – takes the normal article title as described above, while Custom version or additional Patched versions have their full game mode appended in parentheses. The intention is to avoid changing the names of existing map articles as newer map versions are added to the game.
  
 
*'''Example:''' arena_nucleus uses the title [[Nucleus]], while koth_nucleus uses the title [[Nucleus (King of the Hill)]].
 
*'''Example:''' arena_nucleus uses the title [[Nucleus]], while koth_nucleus uses the title [[Nucleus (King of the Hill)]].
*'''Example:''' koth_harvest uses the title [[Harvest]], despite arena_harvest being the original version, because koth_harvest is the official version.
+
*'''Example:''' koth_harvest uses the title [[Harvest]], despite arena_harvest being the first developed, because koth_harvest is the first version officially Patched into the game.
  
Maps with multiple variations should list the other variations via hatnote on each article, reading as follows:
+
== Hatnotes ==
{{hatnote|'''Map''' has multiple variations, including game mode}}
+
Those [[Template:hatnote|hatnotes]] and tags that are intended to appear at the top of the page, e.g., [[Template:Custom map|custom map]] or [[Template:Stub|stub]] are generally to be the first lines in the markup source. Others generally are placed as needed at the starts of sections, e.g., [[Template:Community strategy stub link|Community strategy stub link]] or [[Template:main|main]], or as makes best use.
  
*'''Example:''' {{hatnote|'''Nucleus''' has multiple variations, including [[Nucleus (Arena)|Arena]].}}
+
Maps with multiple variations should list the other variations via the {{tl|Map Variant}} template.
** Notice that Arena links to [[Nucleus (Arena)]].
 
  
 
== Introduction ==
 
== Introduction ==
Line 30: Line 29:
 
== Content ==
 
== Content ==
 
These are body sections strongly recommended to be used. If content for the article fits one of the following sections, that section should be created and content should be placed there. Sections should be ordered as they appear here. Sections not mentioned should appear after the introduction video and before screenshots, but not be placed in between the Locations and Strategy sections.
 
These are body sections strongly recommended to be used. If content for the article fits one of the following sections, that section should be created and content should be placed there. Sections should be ordered as they appear here. Sections not mentioned should appear after the introduction video and before screenshots, but not be placed in between the Locations and Strategy sections.
 +
 +
=== Developer credits ===
 +
This is a list of all developers and contributors listed by Valve on the map's start screen credits.
 +
* For each Valve map, only Valve may appear here in this entry (do not list individual Valve employees).
 +
** For maps with both Valve and community developers, the Community map policy should be used.
 +
* For each added Community map, Community credits are listed on the map's start screen. Developer credits must appear here in the same order as on the start screen.
 +
 +
The order of Community credits is provided by the developers to Valve. Most commonly, those who worked directly on the map (layout, artpass, etc.) are listed first, then those who contributed any content created specifically for the map (props, textures, etc.) are listed, and finally any contributor of previously created content (props, textures, etc.) may be listed. In this manner, ''those who worked most on the map are at the top of the list.''
 +
* Usually, this order of listing is found in some form on the map's Workshop page, if not, look up the order in {{code|Team Fortress 2/tf/resource/tf_english.txt}} or create a server by typing {{code|map <map name>}} in the [[console]] and following the list displayed there.
  
 
=== Introduction video ===
 
=== Introduction video ===
Line 37: Line 45:
  
 
=== Locations ===
 
=== Locations ===
This section should contain notable locations and basic information about the locations.
+
{{hatnote|The main purpose of locations is to provide points of reference on the map to help players navigate the levels and share strategies; in that sense, Locations takes the role of Callouts on Competitive maps.}}
 +
This section should be more than a simple description or promotion of features of the map. This section should identify and name notable tactical locations and navigation features of the map as well as functional information about those locations, including related gameplay aspects. Particularly, the Locations section supports writing map-specific Community map strategies; as map-strategies are usually specific to particular places on the map. In this sense, Locations should also be the basis for describing unique mechanics of the map (commonly, gate openings on Payload and Attack/Defend maps or event triggers in [[Halloween map]]s).
  
*For [[Control Point (game mode)|Control Point maps]], locations should be divided by '''control point'''.
+
* At a minimum [[Control Point (game mode)|Control Point maps]] and [[Payload]] should be divided by '''control points''' and '''capture points''', respectively.  Often, further map sections can be identified, since, especially on Payloads and Attack/Defend, major tactical combat areas, flanks, and chokes appear separate from the points (an example being [[Mossrock]]).
*For maps with multiple stages, locations should be divided by '''stage'''.
+
* Locations for multi-stage maps should overall be divided by the '''stages'''.
*For single-stage [[Payload]] maps, locations should be divided by '''capture point'''.
+
* For [[Arena]], [[King of the Hill]], and [[Capture the Flag]] maps, locations should be divided ''as appropriate''.
*For [[Arena]], [[King of the Hill]], and [[Capture the Flag]] maps, locations should be divided ''as appropriate''.
 
  
Locations should be properly titled, as by their name. Control points are named in maps, and the names as they appear in-game should be used.
+
Locations should be properly titled, as by their Callout name (typically '''Bolded'''). Control points are named in maps, and the names as they appear as the points are captured in-game should be used in Locations. Location names used by developers can sometimes be found in change logs and Community maps developer workshop pages. Each Location subsection optimally would contain some screenshots of the locations being discussed.
  
 
'''Example''' (from [[Coldfront]]):
 
'''Example''' (from [[Coldfront]]):
 
  == Locations ==
 
  == Locations ==
 
  === Control point 3 (Decrepit Cabin) ===
 
  === Control point 3 (Decrepit Cabin) ===
  The central control point rests comfortably within the wreckage of the cabin.
+
  * '''Control Point''': The central control point rests comfortably within the wreckage of the cabin.
  *Entrances: Each team has 3 paths to the house area. Two paths enter from the ground, going uphill as you get closer to the house, and an upper path among the one of the high cliffs.
+
  * '''Entrances''': Each team has three paths to the House area. Two paths enter from the ground, going uphill as you get closer to the house, and an upper path among the one of the high cliffs.
  *High Cliff: One of the passageways into the area from yard. Normally a one-way drop-down, but Scouts and Soldiers can climb up, too. Common Sniper perch.
+
  * '''High Cliff''': One of the passageways into the area from yard. Normally a one-way drop-down, but Scouts and Soldiers can climb up, too. It is a common Sniper perch.
  *House: The worn down cabin which holds the control point. Soldiers and Demomen can rocket jump onto the top for a better view of the area.
+
  * '''House''': The worn down cabin which holds the control point. Soldiers and Demomen can rocket jump on top for a better view of the area.
  *Behind the Rocks: A small safe haven for Medics and Engineers, especially due to the close proximity to medium Health and Ammo packs.
+
  * '''Behind the Rocks''': A small safe haven for Medics and Engineers, especially due to the close proximity to medium Health and Ammo packs.
  *Yard: Each side has a large, open intermediate area in between control point 2 and the control point 3 cabin. Separated into two halves by a pipe-bridge.
+
  * '''Yard''': Each side has a large, open intermediate area in between CP2 and the CP3 cabin. Separated into two halves by a '''Pipe-Bridge'''.
 
 
Each section optimally would contain a screenshot of the location being discussed.
 
  
 
=== Strategy ===
 
=== Strategy ===
To keep the map pages clean, strategies for playing on various maps should be placed on their own community strategy pages, such as [[Community 2Fort strategy]] for [[2Fort]]. Be sure to place class-specific strategies under their respective sections, and cooperative or counter-class strategies where appropriate.
+
: ''See also [[Help:Style guide/Community Strategy|Community Strategy Style Guide]] and [[Team Fortress Wiki:Community Strategy|Community Strategy Project]].''
 +
To keep the map pages clean, strategies for playing on various maps should be placed on separate Community strategy pages, such as the [[Community 2Fort strategy]] page for [[2Fort]]. In most cases, this section contains only a link to the [[:Template:Main|''Main article'']] template linking to the map's Community strategy page. This section may also contain a [[:Template:Community strategy stub link|Community strategy stub]] tag when the map's Community strategy page has too little content.
  
Users are encouraged to add relevant strategies where needed, but also remember to follow the [[Help:Style guide|style guidelines]] as well.
+
A [[:Template:Start map strategy|start map strategy]] substitution template is provided for creating Community strategy stubs. Users are encouraged to contribute relevant strategies as they are able, while remembering to follow the [[Help:Style guide|general style guidelines]] as well. Be sure to place class-specific strategies under their respective sections, and cooperative or counter-class strategies where appropriate.  
  
 
=== Control Point Timing ===
 
=== Control Point Timing ===
 
For maps with a control point or capture point, use of [[:Template:Control Point Timing]] is encouraged and should be placed in this section.
 
For maps with a control point or capture point, use of [[:Template:Control Point Timing]] is encouraged and should be placed in this section.
  
=== Screenshots ===
+
=== Update history ===
Screenshots related to the map should be placed in a gallery, in this section, using the <nowiki><gallery></nowiki> tags.
+
For official maps, patch logs relevant to the map must be placed in this section using the [[:Template:Patch name|Patch name]] and [[:Template:Update history|Update history]] templates.
 +
 
 +
=== Changelog ===
 +
For custom Community maps, a changelog is usually included with the map. This changelog can be added to the article using [[:Template:Changelog]] within this section.
 +
 
 +
=== Bugs ===
 +
A bulleted list of the map's observed Bugs, if any, is included here.
 +
 
 +
=== Trivia ===
 +
This section should contain any small facts about the map that may be interesting to a reader that are not covered by other sections. As with other Trivia sections, please be sure to follow the [[Help:Style_guide/Trivia|Trivia guidelines]].
 +
{{anchor|Screenshots}}
 +
=== Gallery ===
 +
Screenshots and other images related to the map are usually placed in this section in a gallery, using the {{code|<nowiki><gallery></nowiki>}} tags.  Screenshots galleries are also commonly used in Locations sections.
  
 
'''Example''' (from [[Coldfront]]):
 
'''Example''' (from [[Coldfront]]):
Line 78: Line 97:
 
Screenshots should be captioned if possible.
 
Screenshots should be captioned if possible.
  
=== Changelog ===
+
=== References ===
For custom maps, a changelog is usually included with the map. This changelog can be added to the article using [[:Template:Changelog]] and contained within this section.
+
Include this section with the {{code|<nowiki><references/></nowiki>}} tag if {{code|<nowiki><ref></ref></nowiki>}} tags are used.
  
For official maps, a patch log can be contained here.
+
{{anchor|Additional links}}
 
+
=== External links ===
=== Trivia ===
+
Links to external information should be contained within this section in a bulleted list. Any screenshots should be uploaded to the Team Fortress Wiki and included in the Gallery section, so '''do not''' link to external image galleries.
This section should contain any small facts about the map that may be interesting to a reader. As with other trivia sections, please be sure to follow the [[Help:Style_guide/Trivia|trivia guidelines]].
 
  
=== Additional links ===
+
=== See also ===
Links to external information should be contained within this section. Any screenshots should be uploaded to the TF Wiki and included in the Screenshots section, so '''do not''' link to external image galleries.
+
A bulleted ''See also'' section may be added to link to other notably relevant Team Fortress Wiki pages.
  
 
== Categorization ==
 
== Categorization ==

Latest revision as of 23:32, 4 September 2023

This Map Style guide will hopefully help people adhere to a consistent standard of style and formatting throughout the Team Fortress Wiki map articles. Covering all situations would take a long time, and the following is only meant to be a reference for the Team Fortress Wiki's specific guidelines.

Article titles

Article titles should be the map's name, without the prefix that appears on the filename. For maps with conflict between the filename and the displayed name, the name displayed in the game on the loading screen should be used.

  • Example: Double Cross, not Doublecross, is used despite appearing in both forms, because Double Cross is what appears in-game.

For maps with multiple versions added to the game over time, the original version – the first version officially patched to the game – takes the normal article title as described above, while Custom version or additional Patched versions have their full game mode appended in parentheses. The intention is to avoid changing the names of existing map articles as newer map versions are added to the game.

  • Example: arena_nucleus uses the title Nucleus, while koth_nucleus uses the title Nucleus (King of the Hill).
  • Example: koth_harvest uses the title Harvest, despite arena_harvest being the first developed, because koth_harvest is the first version officially Patched into the game.

Hatnotes

Those hatnotes and tags that are intended to appear at the top of the page, e.g., custom map or stub are generally to be the first lines in the markup source. Others generally are placed as needed at the starts of sections, e.g., Community strategy stub link or main, or as makes best use.

Maps with multiple variations should list the other variations via the {{Map Variant}} template.

Introduction

All map articles must contain an introduction. This introduction should include basic information about the map, such as the game mode, style of play, and goal, as well as any immediately pertinent information for a reader.

All map articles must use Template:Map infobox to include an infobox with the basic map details and a screenshot. For custom maps, an author, version, and download link must be provided.

A quotation from an update or promotional page may be added at the top of the page, but below any hatnotes related to variations.

Introduction videos should be the first body section immediately following the introduction section.

Content

These are body sections strongly recommended to be used. If content for the article fits one of the following sections, that section should be created and content should be placed there. Sections should be ordered as they appear here. Sections not mentioned should appear after the introduction video and before screenshots, but not be placed in between the Locations and Strategy sections.

Developer credits

This is a list of all developers and contributors listed by Valve on the map's start screen credits.

  • For each Valve map, only Valve may appear here in this entry (do not list individual Valve employees).
    • For maps with both Valve and community developers, the Community map policy should be used.
  • For each added Community map, Community credits are listed on the map's start screen. Developer credits must appear here in the same order as on the start screen.

The order of Community credits is provided by the developers to Valve. Most commonly, those who worked directly on the map (layout, artpass, etc.) are listed first, then those who contributed any content created specifically for the map (props, textures, etc.) are listed, and finally any contributor of previously created content (props, textures, etc.) may be listed. In this manner, those who worked most on the map are at the top of the list.

  • Usually, this order of listing is found in some form on the map's Workshop page, if not, look up the order in Team Fortress 2/tf/resource/tf_english.txt or create a server by typing map <map name> in the console and following the list displayed there.

Introduction video

If an introduction video exists for the map, it should be embedded in this section. This section should immediately follow the article introduction and be the first titled section.

To embed a video, use Template:Youtube.

Locations

The main purpose of locations is to provide points of reference on the map to help players navigate the levels and share strategies; in that sense, Locations takes the role of Callouts on Competitive maps.

This section should be more than a simple description or promotion of features of the map. This section should identify and name notable tactical locations and navigation features of the map as well as functional information about those locations, including related gameplay aspects. Particularly, the Locations section supports writing map-specific Community map strategies; as map-strategies are usually specific to particular places on the map. In this sense, Locations should also be the basis for describing unique mechanics of the map (commonly, gate openings on Payload and Attack/Defend maps or event triggers in Halloween maps).

  • At a minimum Control Point maps and Payload should be divided by control points and capture points, respectively. Often, further map sections can be identified, since, especially on Payloads and Attack/Defend, major tactical combat areas, flanks, and chokes appear separate from the points (an example being Mossrock).
  • Locations for multi-stage maps should overall be divided by the stages.
  • For Arena, King of the Hill, and Capture the Flag maps, locations should be divided as appropriate.

Locations should be properly titled, as by their Callout name (typically Bolded). Control points are named in maps, and the names as they appear as the points are captured in-game should be used in Locations. Location names used by developers can sometimes be found in change logs and Community maps developer workshop pages. Each Location subsection optimally would contain some screenshots of the locations being discussed.

Example (from Coldfront):

== Locations ==
=== Control point 3 (Decrepit Cabin) ===
* Control Point: The central control point rests comfortably within the wreckage of the cabin.
* Entrances: Each team has three paths to the House area. Two paths enter from the ground, going uphill as you get closer to the house, and an upper path among the one of the high cliffs.
* High Cliff: One of the passageways into the area from yard. Normally a one-way drop-down, but Scouts and Soldiers can climb up, too. It is a common Sniper perch.
* House: The worn down cabin which holds the control point. Soldiers and Demomen can rocket jump on top for a better view of the area.
* Behind the Rocks: A small safe haven for Medics and Engineers, especially due to the close proximity to medium Health and Ammo packs.
* Yard: Each side has a large, open intermediate area in between CP2 and the CP3 cabin. Separated into two halves by a Pipe-Bridge.

Strategy

See also Community Strategy Style Guide and Community Strategy Project.

To keep the map pages clean, strategies for playing on various maps should be placed on separate Community strategy pages, such as the Community 2Fort strategy page for 2Fort. In most cases, this section contains only a link to the Main article template linking to the map's Community strategy page. This section may also contain a Community strategy stub tag when the map's Community strategy page has too little content.

A start map strategy substitution template is provided for creating Community strategy stubs. Users are encouraged to contribute relevant strategies as they are able, while remembering to follow the general style guidelines as well. Be sure to place class-specific strategies under their respective sections, and cooperative or counter-class strategies where appropriate.

Control Point Timing

For maps with a control point or capture point, use of Template:Control Point Timing is encouraged and should be placed in this section.

Update history

For official maps, patch logs relevant to the map must be placed in this section using the Patch name and Update history templates.

Changelog

For custom Community maps, a changelog is usually included with the map. This changelog can be added to the article using Template:Changelog within this section.

Bugs

A bulleted list of the map's observed Bugs, if any, is included here.

Trivia

This section should contain any small facts about the map that may be interesting to a reader that are not covered by other sections. As with other Trivia sections, please be sure to follow the Trivia guidelines.

Gallery

Screenshots and other images related to the map are usually placed in this section in a gallery, using the <gallery> tags. Screenshots galleries are also commonly used in Locations sections.

Example (from Coldfront):

<gallery perrow="5">
File:Cp coldfront0007.jpg
File:Cp coldfront rc20001.jpg
File:Cp coldfront0010.jpg
</gallery>

Screenshots should be captioned if possible.

References

Include this section with the <references/> tag if <ref></ref> tags are used.

External links

Links to external information should be contained within this section in a bulleted list. Any screenshots should be uploaded to the Team Fortress Wiki and included in the Gallery section, so do not link to external image galleries.

See also

A bulleted See also section may be added to link to other notably relevant Team Fortress Wiki pages.

Categorization

Through use of Template:Map infobox, map articles are automatically included in Category:Maps. Custom maps must be manually included in Category:Custom maps using Template:Custom map.

Maps are automatically subcategorized by game mode when using the infobox.

Spelling & Phrasing

Spelling and phrasing should be consistent across articles. The following applies only to map articles unless contained in the Style guide for the entire wiki.

  • Control point is not capitalized. Control Point, the game mode, is.
  • The payload is to be referred to as the cart. The bomb and the payload are not acceptable.
  • Capture point can be used in place of control point in Attack/Defend maps. Capture point cannot be used if both teams can control them.
    • Exception: in Arena, it is a capture point, as only one team can capture the point in each round.

When referring to a specific variation of a map, use the map's name appended with the game mode in parentheses. This holds true even if the variation in question is the original, and the article is not appended.

  • Example: Sawmill (King of the Hill) not KOTH Sawmill or koth_sawmill
  • Example: Nucleus (Arena) not Nucleus

See also

Team Fortress Wiki style guide A-Z - The TF Wiki A-Z of style guidelines