Basic Rules

## Overview

* Please only make legitimate additions/amendments, based on in-game details. We do not want to be forced to "lock down" changes to only administrators...
* All dates (release dates, etc) are in terms of the general servers in use, as opposed to the Test servers
* This wiki uses scripting as much as possible to ensure any new hero added (and their abilities) will be automatically reflected on as many summary pages/sections/navigations as possible. However, this is not 100% (*See also: List of places where heroes need to be manually added*).

## Adding a new hero

There are three (3) steps to adding a new hero to the wiki:

1. Upload hero and ability images
2. Create a new page for the hero
3. Amend the top navigation

### Overall notes

* The easiest mechanism to obtain the hero details and most of the images is via the in-game *Hero Gallery*
* This ensures that even if you do not have the hero, or not levelled sufficiently, you can:
	+ Get the consistent Awakened hero image
	+ Obtain its Advanced Class
	+ See all of the Abilities and obtain colour versions of their images

### Upload hero and ability images

The following table clarifies the following:

* What images are required
* The naming convention of the image files
* Where to source the image from, in-game

• The automated scripting can handle the following file extensions (but no others, and only with these capitalisations): *.png*, *.jpg*, and *.JPG*
 Navigation Hero Image
• An image devoid of a star level can be sourced from the player's *Info* screen and then pretending to change their avatar to the new hero
* This is only possible, however, if the player has obtained the hero in question
* The new hero will be near the bottom of the gallery of avatars, but before the *Common* heroes

• Otherwise, the image can be found by going to the *Hero Gallery*, selecting the hero, and going to the *Guides* tab
* This image is a tad smaller, though
 Ability Images
• SSR heroes will have four (4) Ability images, and UR heroes will have five (5)
• As the cropped images have a circle, there will be some background remnants in them - a tool to remove these, and make these transparent will be required
* An example of an online tool to do this is https://www.inpixio.com/remove-background

• In order for the scripting to derive the Ability navigation to function, these images require inclusion of the Template: Ability Subset template
* Once the images have been uploaded, they can be edited like any page and this template added
* It can actually be easier to add this template during the upload (nominally with only the *hero-name* attribute filled in). The images will still require editing for the remaining (individual to each Ability) attributes, but it can save time...

#### Notes

* It is **imperative** that the naming convention for the files be adhered to! This includes **strict** case-sensitivity.
* The screenshots, from the above sources, will require cropping to only include the image component desired
	+ There are obviously a significant number of tools capable of this, but *Microsoft Powerpoint* is one which is often overlooked but is already available to many users
* This guide is high level and does not cover extra images, such as those related to the hero's skins; but adding these will be obvious
* Likewise, there is a rare chance that an Ability either has the same name as an existing one, or contains characters not allowed in wiki page/file names. If this is the case, the easiest solution is to simply contact an administrator

### Create a new page for the hero

A new page, named exactly the same way as the hero is named should be created. The easiest way to create a page is to click on the vertical ellipsis (three dots in a column) button an the top-right of any existing wiki page.

The page will contain:

* A Template:Infobox heroes template entry, to describe the overall hero
* Four (4) (five (5) for UR heroes) copies of the Template:Ability template, to describe each of the hero's abilities

**Note:** All of the below sources are based on the hero details in the in-game *Hero Gallery*.

#### Notes

* It is probably easiest to simply copy an existing hero page and amend it to suit
* OCR tools can be used automate getting the content directly from screenshots, but please ensure that it is proofread to alleviate any mistakes. A couple of examples of online OCR tools are:
	1. https://www.imagetotext.io
	2. https://www.onlineocr.net
* Indeed, even if entering the content manually, please proofread them to ensure correctness
* However any errors found in the in-game text should be transcribed exactly as it is in-game, and not corrected (nominally with *(sic)* added to them or a Template:Special note added
* For consistency, it is vital that the correct templates be used:
	+ The Template:Infobox heroes template instead of the old *MLA\_HERO* one
	+ Template:Ability instead of the old *MLA\_SKILL* template
	+ Inclusion of the Template:Hero navigation template, near the end of the page
* Most categories are automatically added via usage of the *Infobox heroes* template; so check the existing listed categories on the page before adding new ones to the page

### Example

Example of the current "pattern" in use when making hero pages (as of 15-Apr-22):

```
{{Infobox heroes
}}

'''HERONAME''' is a [[TYPE]] [[Heroes|hero]] from [[Mobile Legends: Adventure Wiki|Mobile Legends: Adventure]].

==Abilities==
{{Ability
}}

{{Ability
}}

{{Ability
}}

{{Ability
}}

==Gallery==
<gallery hideaddbutton="true">
MLA_Hero_HERONAME.jpg|HERONAME Info
HERONAME_SKINNAME_full.jpg|HERONAME "SKINNAME" Skin
</gallery>

{{Hero navigation}}

```

### Amend the top navigation

Steps:

1. From the toolbar, at the bottom-right of the screen, select the *Admin* option
	* If this option is not available, then you will not be able to perform these steps. Please notify and administrator to complete these.
2. Select the *Top Navigation* option
3. Add the hero name in the appropriate spots, conforming with the correct number of asterisk prefixes (it should be four (4)). There are two (2), possibly four (4) spots to add it to (the latter extra two for Hybrid heroes).
	1. Under each applicable Faction, including *Hybrid* where applicable
	2. Under the hero's applicable Advanced Class

#### Notes

* Please ensure you put the hero in the appropriate location, to maintain alphabetical order
* Reaffirming, only admins can amend the top navigation, please notify them to complete this, if you cannot perform these steps
* Unfortunately, there was no way to automate this, as the content to generate this navigation only uses static content, and cannot "handle" content generated from **DPL** scripting

### References

1. ↑ This tool now either requires a paid license, or results in lower quality images with the a logo added to it. If you know of a better tool, then please either leave a message on the Discussion Page or on Chaosworrier's Message Wall
2. ↑ 2.0 2.1 2.2 Either leave a message on the Discussion Page or on Chaosworrier's Message Wall