Editing Guidelines

Overview
This page lists preferences and guides in editing pages for the Miner's Haven Wikia. All editors are asked to read this for the betterment and consistency of the wiki.

Before beginning to edit, it is suggested that you know the basics of Wikitext (the main markup language for Fandom). Important things to know include the editor's basic layout, links, and templates.

If you do not fully understand what is written here, check out different items' pages for reference. There are plenty of templates and stuff that are not written here; you can discover those by yourself.

To stay up-to-date with the latest of the Wiki's Editing Guidelines, join the Miner's Haven Wiki Discord. Any changes to the Guidelines will be announced by a staff member.

Happy editing!

General Guidelines

 * Do not post incorrect or misleading information. If a statement is yet to be confirmed, place a (?) next to it.
 * All editors are expected to practice good grammar. This includes proper word usage. Slang is not recommended as it is informal and not everybody understands certain types of slang. It's and its are different.
 * All rules as seen in Help:Rules are to be followed when editing pages.
 * All users can undo edits. In the case of vandalism, your job as an editor is to undo the specific edit that vandalized the page, and contact an administrator by posting the vandal's name in their message wall and state exactly what they did (view this to find admins). Alternatively, you can contact them via Discord. Steps to undo edits can be found here.
 * If the vandal has caused great damage and vandalized multiple pages, you may contact a content moderator to easily rollback the vandal's actions. However, you will still have to contact an Administrator because Content Moderators do not have the powers to block a user from editing pages.

Creating Pages

 * Most pages on the Wiki are based on a sole item, but one can be made to cover a main gameplay mechanic or NPC.
 * Do NOT create pages for unconfirmed items. Items are confirmed when OutOfOrderFoxy and/or TalonMidnight confirm it on Discord or announce it on Twitter.
 * When creating a page, make sure the title has proper capitalization and can be typed out on a standard English-language keyboard.

Page Layout & Content

 * Pages will have an infobox named the NewInfobox, which is automatically placed on the right portion of the page.
 * On the top of the page is the description of the item. This is always to be placed in the  template, where the second argument is the description of the item. Example:
 * Any typographical or grammatical errors in the description should be indicated immediately after the error with an unitalicized [sic] as used here.
 * Any relation to other items must also link to the item, such as in the description of the Firecrystallized System. Metonyms or metaphors should also be linked to the items they pertain to, such as the items in the description of the Eternal Limbo.
 * The Quote template will change color based on what tier the item is. This is automatic as long as the "tier" field of the infobox is filled in correctly.
 * Quote2 is used if multiple items are on the same page, or there are multiple contexts to give attention to. Old descriptions belong in the Trivia section.
 * The next part is the Overview. The word "Overview" is written with the heading format.
 * It should be in paragraph form. Sentences are grouped according to main idea. A few paragraphs (3-4) or less should be detailed enough.
 * It states the tier, effect/s, item type and common bug/s, and when the item was released.
 * As an example, if an item is Common-tier, it would be formatted as Common-tier (hover over the links to see where they link to).
 * Do not post any game-breaking bugs.
 * For most cases, appearance is not worth noting. However, for items with very unique designs such as curved conveyors or mines with multiple spouts, it could be written down.
 * Anything else to be added to this part (e.g., appearance, strategy, tips, etc.) should be given its own sub-heading under Overview.
 * The Trivia part is below the Overview. The word "Trivia" is written with the heading format.
 * It should be in bullet form. Sub-points are for trivia relevant to the main point.
 * The previous description of the item belongs here. Format it similar to how it is on this page.
 * Item descriptions which have been updated solely due to typographical errors or just to match their effects are not considered old descriptions.
 * Trivia holds little to no game-related value but is interesting to know about.
 * It usually contains references/allusions surrounding the item, lesser-known information, previous source/s in more detail, etc.
 * Trivia defining a series of items (usually with the use of ordinal numbers such as first, second, third, etc.) are generally not accepted as these series can get absurdly long. The first item in such a series may be indicated in Trivia, but after that, it is unimportant to note.
 * Furthermore, trivia defining a group of items with a common characteristic are likewise not accepted (categories exist). However, if these characteristics are game-changing and not at all common, it might be accepted as trivia.
 * Do not state obvious facts in this section.
 * Anything that states that an item is a superstitious/an enchanted requirement should not be written in the trivia section.

The Infobox
The NewInfobox is the main infobox used for almost every page, with the exception of some such as categories. Its main page can be found here. The infobox can be used for items, merchants, etc. This portion of the guidelines will tackle the basics to collecting information about an item. Another thing to note about filling in the infobox is to avoid redundant information, especially in the Effects and Drawbacks fields. This list will tackle the desired formats for different Infobox fields.

Dates
All dates are in the format.

Example:

This format is used for all dates written in the infobox (Date Added, Date Published, Date Retired, Date Removed)

Item Retirement or Removal
Retired items are items that are now unobtainable mostly because they are in a previous event. The Date Retired field is the date when the item was removed from boxes (or wherever), the Event(s) field shows the event/s where it appears in, and Retirement Reason for why it was removed. For event exotics/collectibles, retirement reason should say "End of event" (do not repeat the event name as it was already stated in the Event(s) field).

Removed items are items that virtually nobody has now since it was either replaced by another item to the same ItemID (such as Regeneration Infuser) or removed completely from all sources and virtually has no use, usually because of changed mechanisms (such as Wide Conveyor). Fill in the Date Removed and Removal Reason fields (if reason is known).

For items that made a return but is not at all planned for any next events, the Event(s) field should be filled out with both events the item was in, and Date Retired for both dates when it was retired from the events. Seasonal collectibles/exotics which seem to make a return every year will get a generalized Event(s) field, such as simply writing down "Easter" instead of writing down every Easter event the item was in. Date Retired in this case will simply say the last event it was retired in and Retirement Reason stays the same.

Tiers
See this page for more information.

Life Requirement
Life requirements for Evolved Reborn/Advanced Evolution-tier items are the same as their pre-evolutions, as they technically do not have life requirements. For Reborn Fusion/Advanced Fusion-tier items, the life requirement will follow whichever of the fused items has the higher life requirement.

Do not fill out the life requirement section for Enchanted, Superstitious, or Catalyst items.

Item Size
The item size field uses the template. L represents the length of the item, W represents the width, and H represents the height. The length refers to the length of the conveyor (how far the ore has to travel to go along the entire conveyor). If the item does not have a conveyor (i.e. a furnace), the length is the longest side.

Conveyor Speed
The default walkspeed in ROBLOX and Miner's Haven is 16 studs/second. Conveyor speeds are denoted by percentage to a scale of 10. A conveyor speed of 100% translates to 10 studs/second, 60% translates to 6 studs/second, 820% translates to 82 studs/second... you get the point.

The best way to test the conveyor speed is by letting your character move over the conveyor of an upgrader. This spreadsheet (warning: may be outdated) lists all walkspeed increases (in studs/second) for most (if not all) items in Miner's Haven. First, start with a speculated conveyor speed. Aim for that speed then walk over the conveyor. If your character stays on the same exact spot, that means your speculated conveyor speed was correct. However, if you were too fast, you have to reduce your walkspeed bonus, and vice versa.

If it is impossible to do exact confirmatory tests, the second best way would be to time yourself walking through the upgrader in relation to walking through other upgraders/conveyors with confirmed speeds.

Upgrade Limit
The upgrade limit denotes how many times a specific ore can be upgraded without a resetting device. The  and   templates say whether or not the item is resettable. Example: the Vulcan's Grasp's upgrade limit is.

In the case that the upgrade limit has no limit (e.g., blasters), simply write down Unlimited under this field. For a money-related upgrade limit (like Red Giant), simply write down the maximum money cap in the Money template. For maximum multipliers, use the Drawbacks field.

Upgrader Counter
The upgrader counter is a theoretical value that is based off of the reflectance value. It is technically the reflectance multiplied by 20 (this was done in order to eradicate decimals because most reflectance increases are multiples of 0.05).

The most practical method to fetch the upgrade counter of an item is through the use of the Purity Tracker. The number shown is the exact upgrade counter of the ore. However, be warned as it can exhibit cases of rounding error. An alternate way of finding an items Upgrade Counter is to use the Sage Redeemer, which has a multiplier that increases by +0.5 for each upgrade counter increment of +1 to a maximum of 100 upgrade counter (x50). The Sage King has a similar mechanic, increasing +1.75 every upgrade counter increment of +1, to a cap of around 314 upgrade counter (x550). Keep in mind that rounding error will occur, so round the value if this happens (use 1 instead of 0.99 or 1.01).

Reborn-Proof and Sacrifice-Proof
"Yes" or "No" only. Both fields should be filled. If item is Soulbound, do not fill in the Sacrifice-Proof field and instead fill in the Soulbound field with "Yes".

Money
"Can't Buy" and "Can't Sell" are used for the Cost and Sell Yield fields respectively, if the item cannot be bought or sold/salvaged.

The  template is used for Shards of Life, the   template is used to denote money, and the   template is used to denote Unobtainium Crystals. For example, an item costing $1.2k will be written as. Do not include the dollar sign. The other two templates have their respective icon as in the game so only inputting the values is required.

Related Items
The Related Items field is for items related to the item you are editing. It should include evolutions, related fusions, etc. It should not contain items that strictly belong to the same category as the item (e.g., blaster items should not have other blasters in its Related Items field because there is a specific category for it).

Item Creators, Submissions, and Submission Info
Most model creators block off their inventory to users, which makes it hard to find the exact creator of an item. Models that are not for sale (which is mostly the case) will not show up in the ROBLOX Library, which makes it even harder.

Some submitters may exhibit their works on Twitter and other social media, but this makes up only a tiny minority of it.

Some MH Official Submitters edit the wiki, albeit not so often, but they will fill in or correct any misleading or missing information in the "Item Creators" field if they know who created the item. It is best to leave it to the more knowledgeable editors to figure this out.

The following are the fields to be filled up regarding submissions:
 * Item Creator(s): List down all collaborators if possible.
 * The  template can be used to quickly display this with the creator's profile link embedded. Example usage:  . If an item has multiple creators, use   or  . Use the exact ROBLOX username.
 * Submission Name: Exact name as published; link it to the actual model in the library.
 * Date Published: ROBLOX shows only when the model was last updated. Leave this blank if you do not know the exact date published (there are Chrome extensions that let you see when models are created).
 * Submission Tier: If not specified, it can sometimes be inferred from the description; only fill this up if it introduces a new item (i.e., not based off of existing items, as fusions and evolutions are obvious).
 * Submission Description: If applicable only. Do not fill up if it says "No description available."
 * Submission Effects: Effects the creator wanted; NOT the effects in the actual game. If applicable only.

Images
If an unreleased item has a page, no one has uploaded a thumbnail, and you manage to find one, try as much as possible to take a proper screenshot of it.

All file names for official thumbnails must be titled in the proper formatting as the item's name itself-- capitalization, spacing, and punctuation included. Must be in ".png" format. This is to make sure all items on the Wiki are compatible with multiple Templates designed for ease-of-access to our editors. For teleporters, the Receiver piece should only bear the set's collective name (excluding Ore Nebula, where the focus is on the pulsar piece).

Existing items with new thumbnails and/or new items' thumbnails are given to the Wiki staff by OutOfOrderFoxy. Do not use your own screenshots for the thumbnails.

If you are ever uploading an official thumbnail of an item, please name the thumbnail with the exact name of the item. This will make the image easier to find for future use.

If you need to add an image to, for example, a table and you would like to quickly post the image and its name below it with a clickable link (in the image as well), use the  template. Example usage:. In many cases, the FileName is the same as the ItemName. However, if it's not, you must get the correct name from the item's page, or upload it yourself.

Templates
Templates can be used by advanced editors to greatly increase the efficiency of their editing. You can start making a template in visual editor by using a double set of braces and then searching the name. In source editor, you must manually type out the entire template format. A full list of templates can be found here. Please refrain from editing other templates unless you get the creator's permission. A full guide to using a template can be found on some of their pages.

Categories
This is a basic outline of which categories are in the wiki. If you want to learn more categories, you can browse items and see the categories they are in. Note: ''Do not create categories without the permission of a Content Moderator or Administrator. If you have any ideas for categories, you can go to the MH Wikia Discord (found in the main page). Other suggestions may also be made in the Discord.''
 * Every item gets categorized based on their tier.
 * Every item gets categorized based on their type. They get categorized into their main type (e.g. Dropper) and, if applicable, to all their sub-types (e.g. Industrial Dropper). The following are categories where most items belong to:
 * Dropper
 * Sub-categories include (but are not limited to): Remote Dropper, Excavator Dropper, Industrial Dropper
 * Do not categorize Industrial Droppers as furnaces.
 * Furnace
 * Sub-categories include (but are not limited to): Research Center, Cell Furnace
 * Upgrader
 * Sub-categories include (but are not limited to): Manual Upgrader, Portable Upgrader, 0 Upgrader Counter
 * Every upgrader with a conveyor should be categorized according to their length [Length X upgrader, where X is how long its conveyor is (in units)]
 * Weapon (including all weapons and givers)
 * Infuser
 * Decoration
 * Walls have their own category named "Walls"
 * Every item gets categorized based on their size:
 * Tiny: items which take up an area of 3 units or less
 * Small: items which take up an area of 4 to 16 units
 * All 4x4 items belong to the Small category
 * Medium: items which take up an area of 17 to 39 units
 * All walls belong to the Medium category
 * Large: items which take up an area of 40 units or more
 * Only items get categorized by size.
 * Reborn-tier items belong to the "Reborn" tier. Items obtained through rebirth (including Reborn-tier items) belong to the "Rebirth" tier.
 * All items that were originally submissions (i.e. not built by any of the developers at the time) get categorized into the "Miner's Haven Submission" category.
 * Twitch items get their own "Twitch Items" category.
 * Items that are not evolutions or fusions of existing items but are clear remade or "deluxe" versions get the "Variation" category.
 * Categorize items based on their event/update of appearance (even if the item doesn't relate to the event).
 * Unobtainable items get the "Currently unobtainable" category unless they are made obtainable again.

__NONEWSECTIONLINK__