Melvor Idle:Contributing

From Melvor Idle
Revision as of 08:44, 9 May 2024 by Malcs (talk | contribs)
This page is up to date (v1.3.1).

Editing the Wiki requires an account. If you wish to assist us, please take the time to register to enable editing.

If you want to discuss anything regarding the wiki, join our Discord and head to the #wiki-discussion channel.

What to do

If you want to help but don't know what you can do, here are a couple of things you can do: Contributing/To-Do List

What not to do

A lot of the content on the Wiki is also generated via Lua functions. Please be cautious around this. If you notice a page generated by Lua, contact one of the Wiki Admins before editing the page.

If you wish to add information on pages with generated content, please edit the text above the placement of the template. For example, Crown of Rhaelyx.

Generated content currently includes:

If you do find an issue with the accuracy of information in any of these templates, it is possible that the internal game data is flawed, or there has been a recent hotfix (hidden update without a version number change) to the game code and the Lua data modules need to be updated.

Templates

We use a number of templates on the wiki for various purposes. Such as the {{Menu}} template for the menu at the bottom of the page. To access the source page of a template, as for example the Menu template, simply go to the Template:Menu page. Because these pages are templates, they will automatically be imported when referred to, and therefore do not need the prior colon. Otherwise you'd need to prepend a colon to the page name {{:Menu}} to include its content.

Templates furthermore support numeric arguments, referenced in the templates by {{{1}}}, but also named arguments. An example of this would be {{{text}}} for {{ItemIcon|Mole|text=A summon}}.

Some of the templates are simply wrappers for Lua modules, which will include {{#invoke:SomeModule|someFunction}}. To access the module source files, simply go to Module:SomeModule, and look for someFunction in there.

Also note that if an argument is optional, you can simply append a pipe symbol after its name (be it numeric or a named keyword argument) to default to the empty string.

Versioning

We have created a system of templates to mark which pages are up to date. At the top of every page there should be a template indicating for which version the page is written. This will look like either {{V}} or {{V|1.0}}.

  • If a page is entirely populated by Lua-powered templates, then simply add {{V}} to the top of the page.
  • If a page contains a decent amount of user-written text that has the potential to change with each version, then the version number should be specified. For example, if a page is written for version 1.0 you would add {{V|1.0}} to the top of the page.

Each page should have a version attached to it. Every version can be found in the Versions Category. One of the main tasks is to make sure that pages are up to date.

You can view the versioning system in action on the top right corner of this page.

Referencing other pages

If you have a bit of text in a page but have more text explaining that concept on another page, it might be a good idea to use the Main Template. This template adds a formatted link to the main article to the page.

Usage: {{Main|Reference=Contributing}}


If there is a guide for a page you're working on somewhere else, you should probably refer to it using the Guide Template. This adds a formatted link to the guide on the page.

Usage: {{HasGuide|page=Contributing}}


If you've made a moneymaking guide, consider adding a reference to it on its main page with the Moneymaking guide template. The template adds a formatted link to the guide.

Usage: {{HasMMG|page=Contributing}}

Icons

There are a number of icon templates which allow contributors to easily add icon formatting to links and inline with text, some examples are provided below.

For a comprehensive list of all icon templates and documentation of parameters these functions use, see Template:Icon.

{{Icon|Loot Container Stacking}} Loot Container Stacking
{{Icon|Zarrah|type=pet}}
Error creating thumbnail: File missing
Zarrah
{{PetIcon|Zarrah}}
Error creating thumbnail: File missing
Zarrah
{{MonsterIcon|Necromancer}} Necromancer
{{Icon|Princess|type=thieving}}
Error creating thumbnail: File missing
Princess
{{ZoneIcon|Strange Cave}}
Error creating thumbnail: File missing
Strange Cave
{{Skill|Mining|Rock extraction}}
Error creating thumbnail: File missing
Rock extraction
{{PrayerIcon|Eagle Eye}}
Error creating thumbnail: File missing
Eagle Eye
{{ItemIcon|Pig}}
Error creating thumbnail: File missing
Pig
{{Icon|Wind Strike|type=spell}}
Error creating thumbnail: File missing
Wind Strike
{{Icon|Weakening III|type=curse}}
Error creating thumbnail: File missing
Weakening III
{{Icon|Fury III|type=aurora}}
Error creating thumbnail: File missing
Fury III
{{UpgradeIcon|Golbin Crate|nolink=true}} Golbin Crate
{{ItemIcon|Lucky Herb Potion}} Lucky Herb Potion
Combat icon {{Icon|Melee|notext=true}} Combat icon
Error creating thumbnail: File missing
{{GP|1000.25}} 1,000.25GP
{{SC|1337}} 1,337SC
{{RC|42069}} 42,069RC

Tables

{{AreaMonsters|Spider Forest}}
Name Combat Lvl HP Max Hit Style Count
Spider 51 250
Error creating thumbnail: File missing
72
Error creating thumbnail: File missing
3
Brown Spider 52 300
Error creating thumbnail: File missing
72
Error creating thumbnail: File missing
2
Evil Spider 90 750
Error creating thumbnail: File missing
102
Error creating thumbnail: File missing
2
Spider King 158 2,000
Error creating thumbnail: File missing
142
Error creating thumbnail: File missing
1
{{CombatTriangleAdjustmentTable}} Template:CombatTriangleAdjustmentTable
{{EquipmentTableFromList|Aeris God Helmet,Aeris God Platebody,Aeris God Platelegs,Aeris God Boots,Aeris God Gloves}}
ERROR: Some items not found in database: 'Aeris God Helmet,Aeris God Platebody,Aeris God Platelegs,Aeris God Boots,Aeris God Gloves'
{{Obstacles/Recommended
|obs11 = Rope Climb
|obs31 = Pit Jump
|obs41 = Coal Stones
|obs51 = Rooftop Run
|obs52 = Tree Climb
}}
Template:Obstacles/Recommended
{{Equipment/Recommended
|helm1 = Glacia God Helmet
|helm2 = Ancient Wizard Hat
|neck1 = Fury of the Elemental Zodiacs
|neck2 = Elite Amulet of Magic
|cape1 = Skull Cape
|body1 = Glacia God Platebody
|legs1 = Glacia God Platelegs
|familiar11 = Ent
|familiar21 = Wolf
|familiar22 = Leprechaun
}}

Tables with Sticky Headers

Some of the tables on the wiki have headers which are "sticky", that is they will remain at the top of a table as the user scrolls down. See Equipment for an example of this. In order to implement this on your tables first add the class "stickyHeader" to the start of the table. E.g:

{| class="wikitable sortable"

would become:

{| class="wikitable sortable stickyHeader"

Before you start your first row of headers you then add |- class="headerRow-0" before it.

If you have a second row of headers you must add |- class="headerRow-1" before it.

As an example:

Can be generated with the following wikitext

{| class="wikitable sortable stickyHeader"
|- class="headerRow-0"
! First Column 1
! Second Column 1
! Third Column 1
|- class="headerRow-1"
! First Column 2
! Second Column 2
! Third Column 2
|-
| 1
| 2
| 3
|}


Special wiki stuff

#REDIRECT [[Currency]] A single line with this in a page, will redirect it to the given page
{{:Currency}} Includes the whole Currency page here
<nowiki>something</nowiki> Disables wiki formatting for the string inside
<onlyinclude>Hello</onlyinclude> When including the page, it will only display this text
<includeonly>Hello</includeonly> Will only include the text while transcluding it, not in the source page
<noinclude>Hello</noinclude> Removes this text when importing the page it as an include
[[Contributing]] Links to another page on the wiki
[[Contributing|Want to help write the wiki?]] Want to help write the wiki?