## Blocks: Level up! - Gamification

block_xp
Maintained by Frédéric Massart
The easiest way to add gamification to your Moodle site! Engage your students! Gamify their learning experience by allowing them to level up in their courses. #gamification #game
3463 sites
295 fans
Moodle 2.7, 2.8, 2.9, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6

Our website dedicated to Level up! is here.

## What's new?

• Arbitrary information can be added to the information page.
• The shortcode xpladder supports displaying the Top students
• The progress bar can be set to display the progression towards the ultimate level with Level up! Plus.
• And more...

## Feature request and bug reports

Please report the issues you find, problems you experience or any feature request on the issue tracker. Thanks!

## Features

• Automatically attributes points to students for their actions
• Block that displays current level and progress towards next level
• Report for teachers to get an overview of their students' levels
• Notifications to congratulate students as they level up
• A leaderboard to display the ranking of the students
• Ability to customise the number of levels, the points they require and their appearance
• Total control over the points earned per action
• Unlock content when a certain level is reached
• Experience points earned per course, or for the entire site
• Support for shortcodes to include in content
• GDPR compliant

### Level up ! Plus add-on features

• Mobile app support
• Activity completion support
• Course completion support
• Course selection rule
• Resilient cheat guard
• Limit learners rewards in time frame
• Progress bar can display progress towards next or ultimate level
• Substitute experience points for other symbols
• Viewing the block on someone's profile displays their level
• Email support

## How are experience points calculated?

This block listens to events triggered in Moodle and captures some according to pre-defined rules. It then attributes experience points based on the information contained in the event. For more information about the events, refer to the documentation.

Only the users with the capability block/xp:earnxp can earn experience points. This capability is given by default to students. Also, actions triggered by guests, non-logged in users or administrators are ignored.

The following events are always ignored:

• Events from another context than course or module
• Events having another educational level than participating
• Events flagged as anonymous, e.g. in an anonymous Feedback

The rest is up to you. By default, the plugin comes with a minimal set of rules to attribute experience points to actions, and to ignore some redundant ones. Visit the Rules page in the plugin itself to view or override them.

Note: Repeated actions within a short time interval are ignored to prevent cheating.

## How to use one block for all courses?

In order to gather experience points from all the courses a student is participating in, you have to set the admin setting Where are experience points used? to 'For the whole site'. This setting is located under "Site administration > Plugins > Blocks > Level up! > General settings". Once set, any block newly or previously added will display the total experience points of your students.

## How to unlock content at a certain level?

Please refer the Level up! documentation.

## How to unlock a course at a certain level?

Please refer the Level up! documentation.

## Shortcodes supported

What are those? Shortcodes can be used in text editors throughout Moodle to include or modify the content. The plugin Shortcodes must be installed to enable them.

Level up! comes with shortcodes to display the learner's level badge, their progress bar, or even the leaderboard anywhere you like. Shortcodes can also be used to conditionally display content according to a learner's current level. For a list of available shortcodes and their documentation, please refer to Level up! documentation.

Provided by

### Sets

This plugin is part of sets Experience Points (XP), MoodleCloud, Gamification.

### Contributors

• Thu, 24 May 2018, 11:01 PM
This does not include the rule I suggested to use. The alternative is to disable slasharguments altogether.
• Sun, 27 May 2018, 1:42 AM
Hi Frederic,
I created a new rewrite rule you can check it here https://1drv.ms/u/s!Amdk-vbboLpgh0qcGTN2p81i8R60 and I also made a test pattern shown in the screenshot is that the expected values for the rewrite?
• Sun, 27 May 2018, 2:11 AM
Hi Frederic,
It is now working fine for me
the pattern should be ^(blocks\/xp\/[^\?]+?\.php)(\/.+)\$
and the rewrite URL should be {R:1}?_r={R:2}
screenshot below show the correct rule for the workaround

https://1drv.ms/u/s!Amdk-vbboLpgh0taTJqtwiOcaXFE

this rewrite {R:1}\?_r={R:2} is not correct
• Thu, 19 Jul 2018, 6:16 PM
Hi Frédéric,
Thanks a lot for combining Level up with Shortcodes. Brilliant! Finally I can display Ladder directly in html block. However, it would be great if ladder could be displayed more neatly or directly in Level up blocks instead of redirecting to a page.
- my screenshot:

Cheers,
• Thu, 19 Jul 2018, 6:18 PM
Hi Phuong, thank you for your feedback, we will consider it for future upgrades. Feel free to raise issues on Github if you have other concerns. Thanks!
• Thu, 19 Jul 2018, 6:21 PM
Also, note that the shortcode xpladder is _not_ the just the top 5, it is actually displayed according to the current user. As you probably are an admin/teacher and are not ranked, you see the top students. If you login as the 20th student, the ladder will show students ranked from 18th to the 24th.
• Mon, 30 Jul 2018, 11:55 AM
Hi Frederic,

Love the plugin! Thanks for the great work!

Question - is it possible to grade a certain number of XP based on a grade received in a quiz?

For example, a quiz will have 5 Grade Boundaries, being High Distinction, Distinction, Credit, Pass, Fail. Is it possible award say 10XP for HD, 8 for D, 6 for C, 3 for P and 0 for F?

Appreciate the assistance!

Cheers,
Ray
• Mon, 30 Jul 2018, 12:04 PM
Hi Ray. Thanks for your kind words. Not grade-based rewards are not supported at the moment, but it's high on our priority list!
• Sat, 24 Nov 2018, 12:02 PM
Cool plugin! On my site, I want to reward participants who rate the forum posts of other participants. I’d also like to display the name of the poster’s level next to forum posts (e.g. “Beginner,” “Expert” etc.). It doesn’t look like the current short-codes would support that— I only see the ability to display based on the current user. Do you have any suggestions?
• Mon, 26 Nov 2018, 11:56 AM
Hi Elizabeth. Ratings do not seem to be triggered events when they occur, they would be needed to enable support in Level up!. Displaying the level of another person's than the currently logged in one is possible, but not with shortcodes. It requires a bit of coding, here are some snippets that you may find useful: https://gist.github.com/FMCorz/2e6d29c8dda5ec9d6d6c349d6b2e8528
• Mon, 26 Nov 2018, 3:50 PM
Thanks, Frédéric!
• Mon, 11 Feb 2019, 7:57 PM
Hello. Excellent plugin – thank you! I just have one question. What is the reason behind the blue coloured line with some student’s name in the ladder? I have been testing different situations … Is it the first time when that students gets to see change in his/her result … Is it when the points are manually changed? Is it when that student levelled up? But sometimes it changes to blue, sometimes not. I get that you can see this blue colour only for yourself. It must be something simple, I just can’t see it. Thank you!
• Mon, 11 Feb 2019, 10:02 PM
Hi Katja, the blue background is simply a mean to quickly spot yourself in the leaderboard. There is no other meaning to it but this one, however if some users aren't seeing themselves highlighted, that may indicate the presence of a bug, in which case we'd appreciate if you could provide us with replication steps. Thanks!
• Tue, 12 Feb 2019, 9:28 PM
Hi Frédéric. My team and I figured it out. The blue background as you explained only works for participants who would have had white background otherwise. It does not work for those in the grey. In other words, you see yourself blue if you are in the 2nd, 4th, 6th … place.
• Wed, 13 Feb 2019, 9:53 AM
Hi Katja, could you please confirm which theme you are using? That is likely an issue where the theme's styling preferences take precedence over Level up's. Thank you!