Writing a Map Page

From MINR.ORG WIKI

Intro[edit]

Deciding to create a map page can be a tall order, especially if the writer has not written for a wiki before. This page is meant to serve as a guide for a writer creating their first map page.

To become a wiki writer, the writer must first create a wiki username that they log into. This is to prevent the user's IP address from appearing next to edits, as well as ensuring that the writer isn't a malicious actor. If logged in, the writer should see "You are logged in as _" when hovering over the person icon in the top right corner.

What a Page Looks Like[edit]

The easiest way to understand what is needed for a map page is to look at pages that have already been created. Clickable gold text references pages, while red text links to a page that has not been written/created yet. A full list of maps can be found in both the Minr Maps and Creators pages, but, for convenience, the page for The Bad Ending is shown below.

MapPageExample.png

There are several sections to the page.

  • A summary of the map.
  • An infobox containing basic map information and a picture.
  • A general section containing Gameplay and Aesthetics sub-headers.
  • A challenges section.
  • A trivia section.
  • A "See all maps from X" link.
  • A list of categories.

When editing a page (which can be done by clicking the pencil icon), the information will not look the same. The same information for that The Bad Ending page is shown below.

MapEditExample.png

A deep dive on each of the sections will now follow.

The Infobox[edit]

{{Infobox_Map
| image = The_Bad_Ending.png
| caption = The second parkour area.
| points = 7
| location = [[FFA]]
| mapcode = tbe
| creators = [[Creators#Kampfsocke2000|Kampfsocke2000]]
| publication = November 1, 2012
| description = The Bad Ending is a pure parkour map on zero.minr.org, worth 7 points. Use /join tbe to join the map.
}}

The information between double curly braces at the top of the editing section is for the infobox that appears in the top right of map pages. Filling in the different fields between the curly braces will update the different parts of the infobox when the page is completed or previewed.

  • The image field will use an image uploaded to this wiki.
  • The caption field is for a brief description of the image beneath it.
  • The points field is for how many FFA Points the map is worth. This will automatically also update the difficulty section in the final infobox to the right map difficulty.
  • The location field is for where the map is located. This can be several locations: FFA, FFA+, Hardcore, Mimic, Mount Minr locations like the Workshop, and so on. If you are unsure where a map is located, running the /map info <map> command on the server will list the map's location.
    • The location name is surrounded by double square brackets. This tells the wiki to make the text clickable, which will send the reader to the page of the same name.
  • The mapcode field is for the map's code. This is also provided by the /map info command.
  • The creators field is for listing the map's creators. While only one creator is listed here, many maps will contain multiple creators that need to be listed. An example with this will be shown after this one.
    • The creator's name is used twice, and more info is contained between the double square brackets than what appears in the final page. This is because it is a more complicated version of a page link system used for wikis. The part before the vertical line links to the Creators page and automatically scrolls to the Kampfsocke2000 header on it. The part after the vertical line is the clickable text that is displayed.
  • The map's publication date, a.k.a. when the map first entered FFA. This information is also visible using the /map info command. Most pages use the format shown here.
  • The description field is a field that is picked up by bots, which is close to matching the summary part of the page.

Map Summary[edit]

The Bad Ending is a pure parkour [[map]] by Kampfsocke2000 that rewards 7 [[Points|FFA Points]] when completed.
Use "/map join tbe" to join the map directly.

The summary section is usually written the same way, with the map name, types, creators, point reward, and join code mentioned.

General Section[edit]

== General ==
=== Gameplay ===
The Bad Ending tasks the player with parkouring through two different nether-ified areas: the [[FFA Airship]] and [[Desert Spawn]].
The only middle checkpoint in the map comes after the FFA Airship teleporter.

=== Aesthetics ===
The map uses copies of the FFA Airship and Desert Spawn builds, but most blocks are replaced with nether bricks, netherrack, obsidian, lava, fire, and soul sand.

This section is for describing the gameplay and aesthetics a map has. The wiki serves as an extension of the server, so describing map solutions or tips for non-parkour gameplay that isn't immediately provided by maps is disallowed. Especially when writing about non-parkour gameplay, the writer should be wary to not accidentally include information about the map that can help to solve it. To create different paragraphs, make sure there are two lines between them.

The equal sign formatting are what make section headers, with the topmost headers using two equal signs, sub-headers using three equal signs, headers under that use four, and so on. As a word of caution, map pages should never use headers with only one equals sign. These headers automatically generate the Table of Contents near the top of a page when four or more headers are used.1

Another aspect of this section you might have noticed is that some words have been turned into clickable page links. Especially when the map revolves around server mechanics, concepts, locations, or other maps, adding links to those pages as they come up is a great way to improve readability.

Challenges[edit]

== Challenges ==
This map is featured in 9 [[challenges]]: 2012 Assortment, Fleeting Marriage, Looming Demise, Pure Pain Marathon - Deluxe,
Satan's Pit, The Path of Heroes, They Can't Get Worse, Hexa Chapter I: Legacy, and Hexa.

The challenges section is mainly for listing any challenges a map is in. The easiest way to find this is to run the command /challenge list map included <map-code>. Challenges are listed alphabetically except for Hexa-related challenges.

Trivia[edit]

== Trivia ==
*The skulls at the end of the map function as the map credits, including the Ken head.

This section is for listing all trivia related to a map. The asterisks at the start of the line turns the text into one bullet on a bullet point list. Any miscellaneous information about a map that does not fit into other sections can go here.

The Creator Link(s)[edit]

----
'''''[[Creators#Kampfsocke2000|See all maps from Kampfsocke2000]]'''''

The four dashes create a horizontal line separating the trivia and creator link from each other. A link for each creator to their section in the Creators page is then listed. The five apostrophes around the link makes the text both bold and italicized. Putting three apostrophes around text bolds it, and putting two apostrophes around text italicizes it, which can be combined as shown here.

Categories[edit]

[[Category: FFA]] [[Category: Map]] [[Category: Parkour]] [[Category: Pure Parkour]] [[Category: Moderate]]

Categories link pages with similar attributes to each other. For example, if the player wants to see all map pages that are Moderate difficulty, they can click Category: Moderate at the bottom of the page. The order typically goes location, then map, then individual map types, then overall map type, then map difficulty.

Completing a Page[edit]

Once the writer has finished adding text to a page, they can click "Show preview" to see what the page will look like. If everything looks good, the writer can then click the "Save page" button to save text to a wiki page. The writer can click the preview button any time to see how a page looks before it is completely written as well. Once a page has been completed, it will be checked over by a staff member before it is created.

Uploading a File[edit]

While some maps already have files uploaded to the wiki without pages, that is the exception more than the norm. To upload a new file to the wiki, click the "Upload file" link at the bottom of a page and follow the instructions. The uploader should make a note of what the file name is, or they will need to visit the "Recent changes" section of the wiki (clickable in the top left) and search the Upload log to find the name again.

Page Example #2[edit]

The above example with The Bad Ending is a very simple page. Unfortunately, not all pages are as simple as this. For a more complicated page example, here is the one for Zeitpfalz.

MapPageExampleTwo.png

Not only does this page feature multiple creators, but it is a parent map, has been involved in events, and is not a pure map type. Below is a plaintext version of the page when editing.

{{Infobox_Map
| image = ZeitpfalzStreet.png
| caption = The starting street area.
| points = 12
| location = [[FFA+]]
| mapcode = zeit
| creators = [[Creators#AK1089|AK1089]] and [[Creators#gemuse|gemuse]]
| publication = December 5, 2022
| description = Zeitpfalz is a mixed search map with parkour elements on zero.minr.org, worth 12 points. Use /join zeit to join the map.
| saver = Each clock
}}
Zeitpfalz is a mixed search [[map]] with parkour elements by AK1089 and gemuse that rewards 12 [[Points|FFA Points]] when completed. Use "/join zeit" to join the map directly.

Zeitpfalz was voted by the community as the [https://wiki.minr.org/Events#Map_.26_Map_Maker_of_the_Year, 2022 Map of the Year].
== General ==
=== Gameplay ===
Zeitpfalz tasks the player with finding 30/60 clocks and 8 colored bolts in a large multi-level city. Parkour is required to beat the map.

=== Aesthetics ===
The map takes place in a large, multi-level city. Most of the cliff floor and walls are made of deepslate and other black and gray blocks. Buildings come in a variety of colors and sizes, ranging from a large pub in the city street to small houses tucked into high alcoves.

== Sub-Maps ==
Zeitpfalz has a sub-map for getting 100% completion: [[Zeitpfalz: The Chronicler]].

== Events ==
Zeitpfalz was nominated for and won 2022's [[Events#Map_.26_Map_Maker_of_the_Year|Map of the Year]].

== Challenges ==
This map is featured in 3 [[challenges]]: 2022 Assortment, Hexa Chapter III: New Heights, and Hexa.

== Trivia ==
* Zeitpfalz was the first map to be moved to [[FFA+]] due to winning Map of the Year instead of a normal FFA+ Ballot.
----
'''''[[Creators#AK1089|See all maps from AK1089]]'''''

'''''[[Creators#gemuse|See all maps from gemuse]]'''''

[[Category: FFA+]] [[Category: Map]] [[Category: Search]] [[Category: Parkour]] [[Category: Mixed Search]] [[Category: Hard]]

Here are a few of the notable changes:

  1. The creators section of the infobox now has both creators listed. If there were three or more of these, commas would need to be added.
  2. Both the infobox and map summary descriptions include the secondary map types after the word map.
  3. There is a saver field included in the infobox, as the map uses a progress saver.
  4. Sub-Map and Event sections have been created for this page because they are relevant.
  5. The creator links at the bottom of the page separate the links into different paragraphs.
  6. The category section lists the primary type, then secondary types, and then the overall map type.

Becoming an Automoderated User[edit]

Once a writer has written a page or two, they can message a staff member with their wiki username to turn them into an automoderated user. These users automatically have their edits apply to pages without needing to wait for a second review. This can be especially helpful if a writer frequently updates the wiki or is working on more complex pages.

Complicated Map Pages[edit]

While the map formatting rules are there to make information simpler to find and pages easier to write, they can be broken when the need arises. A good way to get the general idea for when to break the formatting rules is to visit the more complicated to categorize pages. Here are a few examples of complicated map pages.

  • The Bless Your Heart page, which is notable for being a sub-map and for rewarding a cosmetic.
  • The Troll Kingdom page, which is notable for having an original article in it and being a denominated map.
  • The Kino Horror page, which is notable for having eight listed creators and longer than average descriptions in each section.
  • The Another Castle page, which is notable for being a hub map with a lot of maps within it.
  • The Desert Bus page, which is notable for featuring an unusual map and a page with an external link.
  • The Mushroom Valley page, which is notable for being incredibly detailed and having expandable sections.
  • The Skullerful - Caterpillar page, which is notable for having a table in it and a history section.

Extra Resources[edit]

These resources exist to help give more basic information about this wiki's formatting rules and showcase what wiki formatting exists.

Sources[edit]

  1. The formatting help page on MediaWiki, https://www.mediawiki.org/wiki/Help:Formatting