The Contest Rules is where you define the conditions for awarding points, as well as the Contest Start and End.
An example of the Rules system in CompetitionLabs is shown.
RULES fields
EXAMPLES
» Points calculation ModelMandatory
| Points calculation can be replaced with Custom points, as a Ruleset that lets you create more complex competitions. You can add, subtract or multiply points, or use your own adjustment factor. |
To add an extra rule set that will calculate differently with different actions, just click on Add Rule Set, add your Custom points rule set, and the rule sets will work together.
You can read more about Rules at Competitions and Contests -> Rules guide, or here
» Start the contests ModelMandatory
| A contest start is pre-selected when its parent contests are finalised. All the prior contests need to be finalised before the new one starts. |
If there are no contests before the one you are creating (i.e. it is the first or only contest) – then the contest will start when the competition starts
» Finish the contests ModelMandatory
| A contest will finish when it has been active for exactly, or more than the time set for it, or at the Competition end time. |
The constant can be set manually, or you can select a pre-created constant
» Finalise the contests ModelMandatory
| The contest will finalise according to the configured setting “the contests finished is equal or more than X”, which is typically set to complete within 1 minute. |
The Constant can only be numeric, and it represents the finalisation time.
APP Example:
| Points calculation |  |
| Start the contests |  |
| Finish the contests |  |
| Finalise the contests |  |
API Example:
{"jsonClass": "Contest",
...
"ruleSets": [
{
"jsonClass": "RuleSet",
"priority": 1,
"scope": "contest",
"action": "open.contest",
"conditions": [
{
"jsonClass": "MainConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"rules": [
{
"jsonClass": "MainRule",
"fact": "contest.parents.status",
"operator": "==",
"constant": "$finalised.status"
}]
}]
},
{
"jsonClass": "RuleSet",
"priority": 2,
"scope": "contest",
"action": "finish.contest",
"conditions": [
{
"jsonClass": "MainConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"rules": [
{
"jsonClass": "MainRule",
"fact": "contest.active.elapsed",
"operator": ">=",
"constant": "$competitions.scheduled.end"
}]
}]
},
{
"jsonClass": "RuleSet",
"priority": 3,
"scope": "contest",
"action": "finalise.contest",
"conditions": [
{
"jsonClass": "MainConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"rules": [
{
"jsonClass": "MainRule",
"fact": "contest.finish.elapsed",
"operator": ">=",
"constant": "1"
}]
}]
},{
"jsonClass": "RuleSet",
"priority": 4,
"scope": "contest",
"action": "contests.points.calculated.custom",
"conditions": [
{
"jsonClass": "MainConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"rules": [
{
"jsonClass": "MainRule",
"fact": "event.count",
"operator": ">=",
"constant": "1",
"subConditions": [
{
"jsonClass": "SubConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"subRules": [
{
"jsonClass": "SubRule",
"fact": "event.action.type",
"operator": "==",
"constant": "bet"
}]
}]
}]
}],
"onMatchThen": "add",
"onMatchConstant": "1"
},
{
"jsonClass": "RuleSet",
"priority": 5,
"scope": "contest",
"action": "contests.points.calculated.custom",
"conditions": [
{
"jsonClass": "MainConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"rules": [
{
"jsonClass": "MainRule",
"fact": "event.count",
"operator": ">=",
"constant": "1",
"subConditions": [
{
"jsonClass": "SubConditionSet",
"matchCondition": "All",
"mustEvaluateTo": true,
"subRules": [
{
"jsonClass": "SubRule",
"fact": "event.action.type",
"operator": "==",
"constant": "win"
}]
}]
}]
}
],
"onMatchThen": "add",
"onMatchConstant": "3"
}
],
...
}
The API example provides only a simplified version of the POST body. A full example of POST Contest can be found in the Contest APP API documentation here
The rule sets shown is a working example. Any edits made can influence the contests starting, finishing, finalising or points calculation. Please be aware of this and test a contest before going live with it.
You can read more about Rules, and preview some templates and their combinations here.