Gameit is an attempt towards an intelligent gamification framework that accepts a set of predefined rules and uses a high level language to generate respective functions in Python-3.
Gameit uses rules for constructing the functions, but what are rules? every rule contains a set of conditions and is defined by a logical relation between these conditions.
Conditions, in other hand are combination of attributes and operations which define a particular behavior for an entity.
In order to get the Gameit to work, you need to define three separate files so that it can use them for generating the functions. These three files are:
- Methods
- Awards
- Rules
You can read the full documentation in doc directory.
Well, all you need is writing your desired description regard a particular award in natural language and apply some simple tweaks to make it an understandable syntax for Gameit:
I want to give
QuickLoyalaward to any user that paybacks in a group after someone's request less than N minute as the first person.
You can simply define your rule as following:
pay_back_rule = {
cond1 = (payback.datetime - payack.payrequest_id.datetime) < time(h=3)
cond2 = (count(payack.payrequest_id.pay_off) == count(payack.payrequest_id.involved_users))
rule = cond1 and cond2
award = "QuickLoyal"
}
Note that you should have already defined the Award_x in awards.json file like following:
QuickLoyal = {
point = 5
badge = "QuickLoyal"
privilege = None
message = "Congratulations you got the 'QuickLoyal' badge!"
}
And following methods in methods.json file:
{
"payback": {
"parent": "user",
"attributes": {
"pay_request_id":"int",
"datetime":"datetime",
"amount":"float"},
},
"pay_rquest": {
"parent": "user",
"attributes": {
"request_id":"int",
"datetime": "datetime",
"amount":"float",
"involved_users":"list",
"pay_off":"list"
}
}