PHPackages                             adamjenkins/moodle-mod\_quizquest - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. adamjenkins/moodle-mod\_quizquest

ActiveMoodle-mod

adamjenkins/moodle-mod\_quizquest
=================================

A Moodle activity module that presents question bank questions as an interactive, escape-room style quest with progress images

v0.6.2(3w ago)00GPL-3.0-or-laterPHPCI passing

Since Jul 11Pushed 3w agoCompare

[ Source](https://github.com/adamjenkins/moodle-mod_quizquest)[ Packagist](https://packagist.org/packages/adamjenkins/moodle-mod_quizquest)[ RSS](/packages/adamjenkins-moodle-mod-quizquest/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (8)Versions (5)Used By (0)

Quiz Quest (`mod_quizquest`)
============================

[](#quiz-quest-mod_quizquest)

A Moodle activity plugin that presents question bank questions as an interactive, escape-room style quest. Students answer questions in a chat-like dialogue, advancing a step for each correct answer until they complete the quest. The interface is adapted from [AI Escape Room (`mod_aiescape`)](https://github.com/adamjenkins/moodle-mod_aiescape), with a question bank category taking the place of the AI.

Requirements
------------

[](#requirements)

- Moodle 5.0 or later
- A question bank category containing multiple choice (single answer) and/or short answer questions

Installation
------------

[](#installation)

1. Copy the plugin directory into `/public/mod/quizquest/`
2. Visit Site administration → Notifications to run the upgrade

How it works
------------

[](#how-it-works)

Each turn, one question is drawn at random from the configured question bank category:

- **Multiple choice** questions (single-answer only) are presented as choice buttons in random order
- **Short answer** questions accept a typed response, evaluated with the question's own matching rules (case sensitivity and `*` wildcards included)

Random selection prefers questions the student has never been asked in any of their attempts, then questions not yet asked in the current attempt, then anything eligible. A correct answer adds one step; the quest completes when the step tally reaches the configured **Steps to complete**. Optionally, wrong answers can subtract a step.

Answer feedback stored on the matched question answer is shown in the dialogue; otherwise a generic correct/incorrect message is used.

### Progress images

[](#progress-images)

Teachers can upload multiple images that display alongside the dialogue. With N images (ordered by file name), the first shows at the start and each subsequent image appears as the student completes an equal share of the required steps — reaching the last image at the end of the quest.

### Attempt management

[](#attempt-management)

- Configurable maximum attempts per student
- **Continue** button resumes an in-progress attempt (with full chat history replay)
- **Quit attempt** button lets students abandon a run early
- Optional partial scoring on quit (awards grade proportional to steps completed)
- Student review of completed attempts (configurable per activity)
- **Course reset** — the standard Moodle course-reset flow includes a "Delete all Quiz Quest attempts" checkbox

### Grading and completion

[](#grading-and-completion)

- Standard Moodle gradebook integration; completed attempts receive the full grade
- Abandoned attempts can receive a partial grade (configurable per activity)
- A "Complete the quest" custom completion rule, plus grade-based completion support

### Teacher preview

[](#teacher-preview)

Users with the `mod/quizquest:viewreports` capability (teachers, managers) can play through the activity themselves. These preview attempts are tracked separately from real student attempts and are excluded from attempt limits, gradebook, and completion.

### Fullscreen mode

[](#fullscreen-mode)

A fullscreen toggle button in the top-right corner of the game interface lets students expand the activity to fill the browser window.

Activity settings
-----------------

[](#activity-settings)

SettingDescriptionOpen/Close the questOptional open and close dates (shown on the course page like the quiz module); attempts still open at the close date are automatically abandonedQuestion categoryThe question bank category questions are drawn fromSteps to completeNumber of correct answers required to complete (1–100)Maximum attemptsHow many attempts a student may makeWrong answers subtract a stepOptional penalty; the tally never drops below zeroShow progressDisplay the step progress bar to students during playAllow student reviewLet students re-read completed attemptsPartial score on quitAward proportional grade when a student quits earlyProgress imagesImages displayed alongside the dialogue, switching with progressPrivacy
-------

[](#privacy)

This plugin stores attempt records (status, progress, timestamps) and the responses students give to questions. All personal data is exportable and deletable via Moodle's Privacy API (`\mod_quizquest\privacy\provider`).

License
-------

[](#license)

GNU GPL v3 or later —

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance94

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity27

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Total

4

Last Release

27d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c85ec09253e9a275a2586a0551aeea7e319d9560b0fcc4b7b41357b50e847e15?d=identicon)[wisecat](/maintainers/wisecat)

---

Top Contributors

[![adamjenkins](https://avatars.githubusercontent.com/u/11323818?v=4)](https://github.com/adamjenkins "adamjenkins (25 commits)")

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/adamjenkins-moodle-mod-quizquest/health.svg)

```
[![Health](https://phpackages.com/badges/adamjenkins-moodle-mod-quizquest/health.svg)](https://phpackages.com/packages/adamjenkins-moodle-mod-quizquest)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
