CrsBenjamin (talk | contribs) |
CrsBenjamin (talk | contribs) No edit summary |
||
| Line 1: | Line 1: | ||
| ⚫ | |||
| − | This is a guide for local wiki admins who wish to create new achievements, edit existing achievements, or delete achievements. |
||
| − | |||
| − | ==Types of Achievements== |
||
| − | |||
| − | There are several distinct types of achievements. It is good to understand the differences between them and how they are managed and awarded. |
||
| − | |||
| − | ===Local Achievements=== |
||
| − | |||
| − | The vast majority of achievements fall into this category. Local achievements are specific to a particular wiki. They can only be earned on that wiki and will only display on that wiki, even if a similar or identical achievement exists on another wiki. For instance, after making an edit to Minecraft wiki, a user will receive the "My First Edit" achievement on that site. If they view their profile page on Terraria Wiki, they will not see that achievement until they have made an edit to Terraria wiki, thus earning the achievement for that wiki. |
||
| − | |||
| − | ====Auto-trigger Achievements==== |
||
| − | |||
| − | Auto-trigger achievements are awarded automatically to a user once certain conditions have been met. These conditions are tied to one or more actions tracked by the wiki ("hooks") as well as a counter. When a hook is triggered, the counter advances by one and when the specified number is reached on the counter the achievement is awarded by the system. All of the default achievements are of this type. |
||
| − | |||
| − | ====Manually Awarded Achievements==== |
||
| − | |||
| − | Manually awarded achievements are those that are not awarded by the system automatically because they are not associated with any hooks or a counter. While no default achievements are of this variety, they could be used for giving recognition to users who have performed a certain task or who are deserving of special recognition. Once created by an administrator, these achievements must be manually awarded using [[Special:AwardAchievement]]. |
||
| − | |||
| − | ====Meta Achievements==== |
||
| − | |||
| − | Meta Achievements are those achievements that are only awarded when a user earns a specific set of achievements. For instance, an administrator could create the "One of Everything" Achievement as a meta achievement awarded to users who earn each of the awards for 1 Edit, 1 Patrol, 1 Image, and 1 New Article. Meta achievement requirements can also be combined with other hook/counter triggers. |
||
| − | |||
| − | ===Mega Achievements=== |
||
| − | |||
| − | Global achievements, also called "Mega" Achievements, are achievements which once earned are displayed on all Gamepedia wikis regardless of where it was earned. There is a [[Achievements#Mega_Achievements|standard Mega achievement]] for each wiki. Local achievements can be added or removed from that list at a local level, but large changes will require the assistance of a Gamepedia staff member. Mega achievements are also used by the Gamepedia team to recognize one-time events or accomplishments. |
||
| − | |||
| ⚫ | |||
| − | |||
[[File:SpecialAchievements.jpg|thumb|350px|left|An admin view of Special:Achievements]] |
[[File:SpecialAchievements.jpg|thumb|350px|left|An admin view of Special:Achievements]] |
||
A list of all available achievements can be viewed at [[Special:Achievements]]. There is a [[Achievements#List_of_Base_Achievements|standard set of achievements]] that all wikis have by default. Many of these achievements can be removed, altered, or added to by a local wiki administrator using [[Special:ManageAchievements]]. All achievements, even those marked as "secret," are visible to administrators. |
A list of all available achievements can be viewed at [[Special:Achievements]]. There is a [[Achievements#List_of_Base_Achievements|standard set of achievements]] that all wikis have by default. Many of these achievements can be removed, altered, or added to by a local wiki administrator using [[Special:ManageAchievements]]. All achievements, even those marked as "secret," are visible to administrators. |
||
| − | To delete an achievement, simply click the corresponding button for that achievement. Achievements can be deleted by any admin, but they can also be restored as well. Therefore, the delete function more accurately serves to hide the achievement and prevent it from being awarded by the system. As a note, anyone who has previously earned that achievement will retain it on their profile page. It is still possible to remove the achievement using [[Special: |
+ | To delete an achievement, simply click the corresponding button for that achievement. Achievements can be deleted by any admin, but they can also be restored as well. Therefore, the delete function more accurately serves to hide the achievement and prevent it from being awarded by the system. As a note, anyone who has previously earned that achievement will retain it on their profile page. It is still possible to remove the achievement using [[Special:AwardAchievement]]. Likewise, the achievement can be manually awarded even after deletion. |
Clicking the edit button will open the editing interface. When editing or creating an achievement, a live preview is provided at the top of the screen. |
Clicking the edit button will open the editing interface. When editing or creating an achievement, a live preview is provided at the top of the screen. |
||
| Line 36: | Line 9: | ||
There are 3 main parts to each achievement: Achievement Display, Meta, and Completion Rules. |
There are 3 main parts to each achievement: Achievement Display, Meta, and Completion Rules. |
||
| − | ===Achievement |
+ | ===Achievement display=== |
| − | |||
Most of the fields in the Achievement display are fairly self-explanatory. |
Most of the fields in the Achievement display are fairly self-explanatory. |
||
| − | [[File: |
+ | [[File:Add achievement.png|thumb|350px|The window to create an achievement]] |
'''Display Name''' - This is the main title of the achievement. |
'''Display Name''' - This is the main title of the achievement. |
||
| Line 56: | Line 28: | ||
===Criteria=== |
===Criteria=== |
||
| − | |||
Criteria is seemingly the most complex part of the achievement creation interface, but it is not as tricky as it appears! There are two parts to any completion rules, along with some additional options: '''Stats''' and '''Combined Stats Value Increment'''. A Stat is some action tracked by the achievements system. Each time that trigger is activated, the increment will increase by 1. Once the specified number is reached, the achievement will be awarded (provided any meta requirements are also met). |
Criteria is seemingly the most complex part of the achievement creation interface, but it is not as tricky as it appears! There are two parts to any completion rules, along with some additional options: '''Stats''' and '''Combined Stats Value Increment'''. A Stat is some action tracked by the achievements system. Each time that trigger is activated, the increment will increase by 1. Once the specified number is reached, the achievement will be awarded (provided any meta requirements are also met). |
||
| Line 63: | Line 34: | ||
Streak is a set of options that allows you to create achievements linked to repeating actions, or completing certain actions within a given timeframe. |
Streak is a set of options that allows you to create achievements linked to repeating actions, or completing certain actions within a given timeframe. |
||
| − | ===Required |
+ | ===Required achievements=== |
| ⚫ | |||
| − | |||
| ⚫ | |||
Revision as of 16:32, 12 April 2017
Viewing and editing achievements
An admin view of Special:Achievements
A list of all available achievements can be viewed at Special:Achievements. There is a standard set of achievements that all wikis have by default. Many of these achievements can be removed, altered, or added to by a local wiki administrator using Special:ManageAchievements. All achievements, even those marked as "secret," are visible to administrators.
To delete an achievement, simply click the corresponding button for that achievement. Achievements can be deleted by any admin, but they can also be restored as well. Therefore, the delete function more accurately serves to hide the achievement and prevent it from being awarded by the system. As a note, anyone who has previously earned that achievement will retain it on their profile page. It is still possible to remove the achievement using Special:AwardAchievement. Likewise, the achievement can be manually awarded even after deletion.
Clicking the edit button will open the editing interface. When editing or creating an achievement, a live preview is provided at the top of the screen.
There are 3 main parts to each achievement: Achievement Display, Meta, and Completion Rules.
Achievement display
Most of the fields in the Achievement display are fairly self-explanatory.
The window to create an achievement
Display Name - This is the main title of the achievement.
Short Description - This is a brief description of what the achievement is awarded for.
Category - For ease of navigation, each achievement must be assigned to a category. Where possible, it is recommended to add it to an existing category, but a new category can be created by being manually entered into this field.
Image Name - If the image you wish to use is already uploaded to the wiki, you can type its filename here (e.g. File:AchievementImage1.jpg). If not, an image can be uploaded by either clicking on the box or dragging and dropping a file, which will then automatically be uploaded to the wiki and the URL added to the appropriate field. Images should be square and at least 120px in size. All regularly supported file types are accepted. The default Achievement images are available on the Hydra Commons.
Points Awarded - This is the number of bonus Wiki Points that are given to the user for earning this achievement. It is suggested that admins carefully consider the number of points being awarded are in line with the difficulty of the achievement.
Secret - If checked, this achievement will not be displayed to non-admin users until it is awarded.
In addition to these categories, Gamepedia staff also has the ability to create Global achievements or alter the "Mega" Achievement for a wiki. If you have a suggestion for a new global achievement or need to edit your wiki's Mega Achievement, please reach out to the Gamepedia team.
Criteria
Criteria is seemingly the most complex part of the achievement creation interface, but it is not as tricky as it appears! There are two parts to any completion rules, along with some additional options: Stats and Combined Stats Value Increment. A Stat is some action tracked by the achievements system. Each time that trigger is activated, the increment will increase by 1. Once the specified number is reached, the achievement will be awarded (provided any meta requirements are also met).
If multiple stats are selected, they will all increment the same counter. For instance, if you set up the article_edit and admin_patrol stats with an increment of 10, then each time a user either edited an article OR patrolled a page, the counter would increase by one until it reached 10 at which point the achievement would be triggered. Therefore, a user could edit 10 pages, patrol 10 pages, or any combination of those two actions.
Streak is a set of options that allows you to create achievements linked to repeating actions, or completing certain actions within a given timeframe.
Required achievements
The Required Achievements box displays a list of all achievements existing on the local wiki. Any achievement that is checked in this list will be added as a prerequisite for earning the achievement currently being edited. Achievements can have Meta requirements, Completion Rules, or both.
| |||||