All Collections
Gamoteca Enterprise
Gamoteca's LMS Integration
Gamoteca's LMS Integration

Integrating your Learning Managment System with Gamoteca

Written by Gamoteca Support
Updated over a week ago

Integrating Gamoteca with your current Learning Management System (LMS) allows:

  • Learners to have a seamless user experience when joining Gamoteca games via the LMS

  • Have their game progress and completion data updated in the LMS

To get started with the Learning Management System (LMS) integration, you will need:

The following LMS platforms are currently supported:

  1. Moodle

  2. Totara Learn

Features of Gamoteca-LMS integration

1. Create a Seamless User Experience

With LMS Integration, learners are ready to access game-based learning experiences directly via your LMS course pages on the browser or mobile. Trainers are easily able to add single or multiple Gamoteca games as activities within a course on the LMS using the Moodle plugin.

2. Synchronize Game Progress Automatically

Need to have Gamoteca progress recorded in your LMS? The integration allows you to set a passing score or game completion as the criteria to mark the activity as completed in the LMS course.

How to integrate Gamoteca with your LMS

The following steps are required to complete the integration with your LMS, please share these details with your LMS manager/administrator:

1. Install the Gamoteca plugin

Install the plugin to your LMS from:

2. Enter the user details encryption key on the LMS

Once the plugin is installed, a plugin-level setting key in Moodle / Totara is used to encrypt details passed from the LMS to Gamoteca, and ensures the user and course information are synced up between the two platforms.

The encryption key to be entered is available for Gamoteca team administrators under (Manage Teams / Integrations).

Copy this key from Gamoteca and paste this key in Moodle / Totara under (Site Administration / Plugins / Gamoteca).

3. Turn on the Web Service on the LMS

The Web Service on Moodle / Totara enables learners progress data (courseid, gameid, userid, score, status and timespent) to be sent from Gamoteca to the LMS asynchronously.

The Webservice [TOKEN] needs to be generated on Moodle / Totara under (Site Administration/ Web services / Manage tokens).

Once the token is created, it needs to be added to Gamoteca under (Manage Teams / Integrations).

How to add a Gamoteca game to an LMS course?

Once the technical integration is completed, it only takes a few steps to add Gamoteca games into LMS courses.

1. Choose the course you want to add the Gamoteca learning experience

Firstly, you have to choose which course on your LMS you want to add a Gamoteca game to. You would usually link a game to a course, i.e. the relation is 1 to 1 between a game and a course. You can make multiple copies of the game to add it to different courses.

Once you have decided which course you want to add the game to, navigate to the course URL and copy the course ID from it. On the URL you will be able to see a part that reads “ID= a number”. That number is the Course ID (the course ID is different for each course on the LMS).

2. Add the course ID to the Gamoteca game

On Gamoteca select the game you want to add to the LMS, click on it to see the details. Once you are on the game’s detail page, on the bottom left there's a “Show advanced options”, click on it.

New options will display, including Moodle Service Setting options. On the first field called “Course ID”, type the course ID retrieved on step 1.

3. Add a Gamoteca activity module

Now that you have retrieved the Course ID, it’s time to create the Gamoteca activity module. The activity module is where the Gamoteca game resides and can be treated as any other activity within the LMS, e.g. a self-guided SCORM module or quiz.

Let’s go back to the LMS and start by clicking on the “Add an activity or resource” within a course or course block.

Once the menu with all the activities appears on your screen, select “Gamoteca” and click on the “Add” button.

4. Select the parameters for the game

A new screen called “Adding a new Gamoteca“ will appear, in it you’re able to choose the parameters for the game on the LMS like:

  • Name: The name of the game on Gamoteca

  • Game URL: The game URL is the specific address of the game you want to add (see step 5)

On Gamoteca, select the game that you want to add to the course. Click the "Play game" to publish the game and then click the “Copy game URL”. The URL will be automatically copied to your clipboard.

Let’s go back to the LMS screen called “Adding a new Gamoteca”. Type in the name of the game, and on the Game URL section, paste the game URL you retrieved from Gamoteca above.

6. Add activity completion information

At the bottom of the page, you will find a section on activity completion. This allows you to set up specific completion criteria regarding the learner’s interaction with the game. You can select either:

  • Game completion in order to complete the course (if the player lands on an End Game screen in Gamoteca). Note: there can be multiple game endings in Gamoteca.

  • A minimum score on the game in order to complete the course

7. Retrieving the Module ID

Similarly to step 1, you have to retrieve the Module ID from the LMS, as well. You can only do this once you have created the new Gamoteca activity module in the LMS (steps 4-6).

To do that click on the Edit button next to the newly created Gamoteca activity module at the top right of the Module, then click on the “Edit Settings” options.

Once you’re in the settings, you will have to copy the module ID. It’s located in the URL of the page, between the “=” sign and the “&”

8. Add the Module ID to Gamoteca

Go back to Gamoteca, select the game you are adding to the LMS, click on it to see the details.

Follow the same instructions from step 2, and once you’re in the game’s detail page, on the bottom left click on the “Show advanced options”.

On Moodle Service Setting options, go to the second field called “Course Module ID” and paste the course module ID retrieved in step 7.

All done! It is advised to test the game before making it available to all users. You can do this by launching the game from the LMS as a learner, (inviting other players if necessary) and checking everything works fine.

If you want to know more about how to integrate Gamoteca into your LMS read this article about Gamoteca Enterprise.

Did this answer your question?