Difference between revisions of "Challenge checker"

From Project-GC
Jump to: navigation, search
(Removed info about challenge exceptions and added info about disabled checkers.)
(Removed the part about "a script checking for 100 mysterys" since my understanding is that this would be a _tag_ and not a _script_.)
Line 1: Line 1:
 
== What is it? ==
 
== What is it? ==
A '''Challenge checker''' uses program code that checks if a user has fullfilled the requirements of a [[challenge cache]].  Per the guidelines of Geocaching.com a [[challenge cache]] published after April 21, 2015, must include a link to a web-based challenge checker. <ref>[https://www.geocaching.com/help/index.php?pg=kb.chapter&id=127&pgid=206 Guidelines for Challenge caches] at Geocaching.com's Help Center.</ref> So far Project-GC is the only allowed challenge checker. More general information about challenge caches is available in the article [[challenge cache]]s, for example information about [[Challenge cache#Challenge Exceptions|challenge exceptions]].
+
A '''Challenge checker''' uses program code that checks if a user has fullfilled the requirements of a [[challenge cache]].  Per the guidelines of Geocaching.com a [[challenge cache]] published after April 21, 2015, must include a link to a web-based challenge checker. <ref>[https://www.geocaching.com/help/index.php?pg=kb.chapter&id=127&pgid=206 Guidelines for Challenge caches] at Geocaching.com's Help Center.</ref> So far Project-GC is the only allowed challenge checker.  
  
 
== How does it work? ==
 
== How does it work? ==
A challenge checker consists of two parts: a challenge checker script and a tag. The script is a piece of program code written in the programming language Lua.  The script checks for a certain condition, for example a script can check if the user has found 100 mystery caches. Another script can check if a user found a cache on 365 calendar days. A tag associates one or more scripts with a specific challenge cache, and defines (customizes) cache type and quantity for a script to match the challenge cache.
+
A challenge checker consists of two parts: a challenge checker script and a tag. The script is a piece of program code written in the programming language Lua.  The script checks for a certain condition, for example a script can check if the user has found a cache on 365 calendar days. A tag associates one or more scripts with a specific challenge cache, and defines (customizes) things like cache type, quantity, region or what is needed to make a script match the challenge cache.
  
 
The tag links a checker script, a challenge cache, and (optionally) a set of parameters for the checker script. This means that the same script can be used both for a challenge that requires the user to have found 100 mystery caches and a challenge that requires the user to have found 1000 traditional caches, since the cache type and quantity of finds required is specified in the tag.  
 
The tag links a checker script, a challenge cache, and (optionally) a set of parameters for the checker script. This means that the same script can be used both for a challenge that requires the user to have found 100 mystery caches and a challenge that requires the user to have found 1000 traditional caches, since the cache type and quantity of finds required is specified in the tag.  
  
The same checker script can be used for multiple challenge caches (For instance, most calendar challenges are handled by the same checker script). The tag is what makes this possible.  
+
The same checker script can be used for multiple challenge caches, for instance, most calendar challenges are handled by the same checker script. The tag is what makes this possible.  
  
 
Project-GC also calculates how difficult a challenge is, more information at: [[Challenge difficulty]]
 
Project-GC also calculates how difficult a challenge is, more information at: [[Challenge difficulty]]
  
 
== Checker Requests ==
 
== Checker Requests ==
Challenge checkers are created by volunteers and can be requested in the [https://project-gc.com/forum/list?8 Checker request forums], it is important to read the READ FIRST-post before posting a request.
+
Challenge checkers are created by volunteers and can be requested in the [https://project-gc.com/forum/list?8 Checker request forums], make sure to read the READ FIRST-post before posting a request.
 
 
==Disabled checkers==
 
Project-GC has a system for disabling the challenge checker if the cache lacks the Challenge-attribute, this is because the challenge-attribute is mandatory per the guidelines.  
 
  
 
== FAQ ==
 
== FAQ ==
Visit [https://project-gc.com/Home/FAQ#3082063764 Project-GC's FAQ] to find answers to many of the most common questions.
+
Visit [https://project-gc.com/Home/FAQ#3082063764 Project-GC's FAQ] to find answers to many of the most common questions.<!--The information should of course be moved/duplicated to the wiki.-->
  
 
== Related paid membership feature ==
 
== Related paid membership feature ==
Line 29: Line 26:
 
== Tools ==
 
== Tools ==
 
The checker script system can be used to create different tools to check for statistics that are not otherwise available at the site. See [[Tools in the checker system]] for more information.
 
The checker script system can be used to create different tools to check for statistics that are not otherwise available at the site. See [[Tools in the checker system]] for more information.
 +
 +
== Challenge Exceptions ==
 +
By default all geocaches with the Challenge attribute will be considered as challenge caches. Exceptions to that rule can be added here [https://project-gc.com/Tools/Challenges?challengeExceptions Challenge Exceptions] Either by adding additional challenges, or by adding geocaches that shouldn't be listed as challenges. A group of cachers who have moderation rights vote on any caches that appear on the list.
 +
A moderation team have been voting on caches for several years but when the introduction of the 'challenge cache attribute' was introduced it had been hoped that correct use of that would eliminate the need for moderation - however it soon became evident that moderation was still required and so this exception list continues to be used.
 +
 +
Though this list can be viewed by all, only the moderators have access to vote - The list is sorted on a confidence score, the more homogeneous votes, the higher the confidence. The order in the list is only updated on page load. Use the up-arrow to vote that it is a challenge, and the down-arrow if it's not a challenge.
 +
The following was advice for moderators regarding voting consideration - Note that your vote shall not be based on today's Challenge guidelines but rather on the fact that the Geocache requires you to do something before/when logging it. You shall not take into consideration if it's a good challenge or not, neither if you like it as a challenge.
 +
 +
Only geocaches with a confidence score of at least 35% will be be considered as an exception. Three homogeneous votes should be enough for that, while for example 3 up-votes and 1 down-vote won't.
 +
 +
There is a forum available to discuss special cases and believes related to these exceptions. [https://project-gc.com/forum/list?12 Checker Exceptions Forum] The forum is readable by everyone, but only those with voting access can write in it.
  
 
== Notes ==
 
== Notes ==

Revision as of 00:12, 30 January 2021

What is it?

A Challenge checker uses program code that checks if a user has fullfilled the requirements of a challenge cache. Per the guidelines of Geocaching.com a challenge cache published after April 21, 2015, must include a link to a web-based challenge checker. [1] So far Project-GC is the only allowed challenge checker.

How does it work?

A challenge checker consists of two parts: a challenge checker script and a tag. The script is a piece of program code written in the programming language Lua. The script checks for a certain condition, for example a script can check if the user has found a cache on 365 calendar days. A tag associates one or more scripts with a specific challenge cache, and defines (customizes) things like cache type, quantity, region or what is needed to make a script match the challenge cache.

The tag links a checker script, a challenge cache, and (optionally) a set of parameters for the checker script. This means that the same script can be used both for a challenge that requires the user to have found 100 mystery caches and a challenge that requires the user to have found 1000 traditional caches, since the cache type and quantity of finds required is specified in the tag.

The same checker script can be used for multiple challenge caches, for instance, most calendar challenges are handled by the same checker script. The tag is what makes this possible.

Project-GC also calculates how difficult a challenge is, more information at: Challenge difficulty

Checker Requests

Challenge checkers are created by volunteers and can be requested in the Checker request forums, make sure to read the READ FIRST-post before posting a request.

FAQ

Visit Project-GC's FAQ to find answers to many of the most common questions.

Related paid membership feature

If a user have a paid membership Project-GC automatically runs challenge checkers for the user in the background. See the article about Auto-challenge-checkers for more information.

With a paid membership there is no limit on how many challenge checkers you can run. Non paying users are only allowed to run 10 challenge checkers per 24 hours. The limit is a rolling rate limit.

The Map of challenge caches is a tool that can show the challenge caches of the world on a map. Different filters can be applied.

Tools

The checker script system can be used to create different tools to check for statistics that are not otherwise available at the site. See Tools in the checker system for more information.

Challenge Exceptions

By default all geocaches with the Challenge attribute will be considered as challenge caches. Exceptions to that rule can be added here Challenge Exceptions Either by adding additional challenges, or by adding geocaches that shouldn't be listed as challenges. A group of cachers who have moderation rights vote on any caches that appear on the list. A moderation team have been voting on caches for several years but when the introduction of the 'challenge cache attribute' was introduced it had been hoped that correct use of that would eliminate the need for moderation - however it soon became evident that moderation was still required and so this exception list continues to be used.

Though this list can be viewed by all, only the moderators have access to vote - The list is sorted on a confidence score, the more homogeneous votes, the higher the confidence. The order in the list is only updated on page load. Use the up-arrow to vote that it is a challenge, and the down-arrow if it's not a challenge. The following was advice for moderators regarding voting consideration - Note that your vote shall not be based on today's Challenge guidelines but rather on the fact that the Geocache requires you to do something before/when logging it. You shall not take into consideration if it's a good challenge or not, neither if you like it as a challenge.

Only geocaches with a confidence score of at least 35% will be be considered as an exception. Three homogeneous votes should be enough for that, while for example 3 up-votes and 1 down-vote won't.

There is a forum available to discuss special cases and believes related to these exceptions. Checker Exceptions Forum The forum is readable by everyone, but only those with voting access can write in it.

Notes

  1. Guidelines for Challenge caches at Geocaching.com's Help Center.