Minecraft Wiki:Style guide/Features

All articles about general in game features should use the following layout. On less regular feature articles, only the introduction and the section Achievements and following are required, though other sections should still get added.

Introduction
The very top of the article should start with applicable flags and templates, such as snapshot for anything not yet in the full release, Block for blocks, and so on.

The introduction section of an article is the section before the first heading. It should be capable of standing alone as a concise overview of the article, briefly describing its most important points.

The article's subject should be mentioned at the earliest natural point in the prose within the first sentence, and should appear in boldface. Only the first instance should be in boldface. For example:
 * Pickaxes are one of the most commonly used tools in the game, being required to mine all ores and many other types of blocks.

In addition, quotes pertaining to the article subject should be added above the introduction section, provided that the quote has general information about the subject matter and the quote is sourced from a Minecraft.net article or a Mojang employee. Up to two quotes are acceptable, though highly discouraged.

Occurrence
Note: this section is a relatively new addition to pages and the specification of this section may be subject to change.

This section is dedicated to blocks, and explains how the block can come to exist within a given world. This section is split into up to three subsections: Natural generation, which shows how the block can exist in the world upon generation through terrain generation or structures, Post-generation, which shows how the block can exist through other circumstances, with or without player interaction, and Placement, which explains how the block can be placed in the world by the player, usually if said block has special rules for placement.

Obtaining
NOTE: Block and item pages are currently undergoing a rewrite to accommodate for loot tables and recipe IDs and as such the following information may not be completely 100% accurate.

For blocks and items, this section is called "Obtaining" and contains information on how the block or item can be obtained in the inventory, firstly via loot tables (block drops, mob drops, chest loot, fishing, cat/villager gifts and bartering with piglins), then recipes (crafting, smelting, stonecutting, and the like), via trading with villagers and wandering traders, and then any other miscellaneous obtaining methods which do not fit under any of the above categories.

For structures, there are two sections here. Creation contains information on how to build the structure if the structure contains a use upon building (such as Nether portals), and Generation contains information on how the structure is generated by the game.

While this section should generally only contain information on how the article's topic is obtained in Survival, it may also state information on using Creative mode or commands to obtain the block or item or to spawn the mob if one of the following is met:


 * The block or item cannot be obtained in creative or with commands, or the mob cannot be spawned with a spawn egg. In this case, the exception may be stated.
 * This does not apply to non-mob entities.
 * The block, item, or entity cannot be obtained or spawned in Survival. In this case, the section may state if it can be obtained or spawned in Creative or using commands.

If there are multiple ways to obtain the block or item or spawn the mob, these should be listed as subsections of this section. Standard sections include:


 * Crafting: Anything the block or item can be crafted from.
 * Smelting: Anything the block or item can be smelted from.

Spawning
This takes the place of Obtaining for articles on mobs, and contains information on any ways the mob spawns. This includes information on the natural spawn cycle and spawners that generate naturally.

Usage
For blocks and items, this section contains information on what can be done with them. This includes using the article subject as a crafting or smelting ingredient, as food, or for trading, or exploiting special properties of a block, like using a button to create a redstone pulse. For blocks, this section should also start with information on breaking the block, which includes the fastest or required tool, if any, and what the block drops in a loot table template (or a No unique drops template for trivial cases), noting tools or enchantments that affect the blocks dropped.

For mobs, this section is called Drops and contains information on what the mob drops upon death.

For structures, this section is called Structure and details the composition of the structure.

Like the Obtaining section, this section should be divided into subsections if appropriate. Standard subsections for blocks and items include: Structures can have the standard section of Loot, which details possible contents of chests found in the structure.
 * Crafting ingredient: if the block or item is used in a crafting recipe. Crafting usage should be added using crafting usage. Recipes should only be entered manually (using crafting) if crafting usage doesn't display the correct recipes.
 * Smelting ingredient: if the block or item is used in a smelting recipe.
 * Brewing ingredient: if the block or item is used in a brewing recipe.

Headings should not be prefixed with an "As a". For example, Food should be used, not As a food.

Filling this section with tips on architecture and interior design should generally be avoided.

Behavior
For mobs, this section contains information on how they act towards the player and other mobs. It also contains information on how other mobs react towards this mob.

This section may have a subsection about how the mob behaves in combat.

Other sections
Any other sections go here, between Behavior and Sounds.

Sounds
A table containing all sounds associated with this object. They should be organised using the Sound table template; see Bee and Ladder for some good examples.

Data values
This section contains a list of possible Data values for the block or item in question. The list should be on a subpage of the main article, e.g. Coal/DV, and use dvt. The subpage should then be transcluded into the Data values section with.

If the section contains any descriptive text in addition to the list, this text should also be included in the /DV subpage.

Achievements
This section contains any achievements related to the article subject. Achievement sections should be transcluded using load achievements (e.g. Leader Of The Pack). Achievements should only be entered manually (using achievements) if load achievements does not display the correct achievement(s).

Video
The video section contains the video produced on the Minecraft Community Spotlight YouTube channel by Curse if it is still reasonably up to date and provides accurate and useful information. Videos in this section should be embedded in a subpage of the main article, e.g. Block/video, and then transcluded into the Video section with. The only thing that should be in this section is the, with exception of notes that correct anything wrong in the video, or if the video isn't in that article's subpage, like   on the String page.

If notes are made to correct the video, they should use video note, placed above the video itself. Videos that have been rendered too inaccurate by changes and updates to the game may be removed if placed on the page prior to November 9th, 2016. All videos placed after this date are subject to the updated Video Policy.

History
History sections should use History. To provide accuracy, changes made in snapshots should retain the exact version of the change even when the update is released (e.g., 12w08a in addition to 1.2). This can be done using the  parameter of   (e.g.,  ).

History sections should not contain bugs and bug fixes, as those belong on the tracker. Generally, a change that is reverted after a single version is subject to removal as a bug unless a source is provided that it is intended. An exception is if the bug has existed in at least one major release version and notably contradicts something on the article.

Issues
The Issues section should only contain Issue list. Nothing else goes in this section.

Trivia
The trivia section contains information about the feature that does not fit anywhere else in the article. If the trivia is relevant to another section, consider incorporating it into the main article before considering it for deletion.

Additions to trivia must fit the following guidelines:
 * Trivia should only be facts and contain no speculation or opinion.
 * Trivia should not be obvious to players and should be information that readers are not likely to know but would be interested in.
 * History-related trivia should be avoided if possible. E.g. “The original piston texture had an iron band running over the head. This was later removed, only leaving iron brackets around the corners and edges” should be merged into the relevant version information in the History section.
 * Notable exceptions to this include history not specifically related to the feature's development in Minecraft, such as Jeb's interest in a suggestion for nether gold ore.
 * Trivia related to game visuals should be avoided, especially if the piece of trivia does not hold true for custom resource packs.
 * Trivia should not state how a characteristic of a block, item, mob, or other game element relates to the characteristics of others.
 * This includes, but is not limited to, listing other game elements that share a certain characteristic, listing items that do not share a certain characteristic, or stating that a game element is the first or only one to have a certain characteristic.
 * Trivia related to the feature's in-game name when using translations is not allowed, as translations are not created by Mojang, making them unofficial.

If relevant, this section may have a subsection called Publicity containing information on the article topic in merchandise and other media.

Gallery
Use the gallery tag to add a gallery of images.