Skip to content

A Moodle plugin to gamify students' learning experience by allowing them to level up in their courses.

Notifications You must be signed in to change notification settings

ConnorSheremeta/moodle-block_xp

 
 

Repository files navigation

Level up! (block_xp)

Engage your students! A Moodle plugin to gamify your students' learning experience by allowing them to level up in their courses.

Features

  • Automatically captures and attributes experience points to students' 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 ladder to display the ranking of the students
  • Ability to set the number of levels and the experience required to get to them
  • Images can be uploaded to customise for the appearance of the levels
  • The amount of experience points earned per event is customizable
  • Page to display the list of levels and a description
  • Experience points are earned per course
  • An event is fired when a student levels up (for developers)

Requirements

Moodle 2.7 or greater.

Installation

Simply install the plugin and add the block to a course page.

The plugin can be installed using composer at fmcorz/moodle-block_xp.

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.

Restricting access based on students' levels

Have a look at this availability plugin Level.

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!". Once set, any block newly or previously added will display the total experience points of your student.

Todo

  • Awarding a badge when a student reaches a level (blocked by MDL-39864)

License

Licensed under the GNU GPL License.

About

A Moodle plugin to gamify students' learning experience by allowing them to level up in their courses.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 97.1%
  • CSS 2.9%