Skip to documentation
    Plugin library
    AI Branched Scenario — LMS Labs
    Activity module

    AI Branched Scenario

    Decision-based scenario training a teacher builds in minutes: illustrated scenes, spoken narration, choices with consequences, a world that remembers, and reports that show a trainer what to teach next.

    Checking release…
    Moodle™ 4.4 - 5.2
    v3.0.0 release guide
    Choice architecture
    THE MOMENTDECIDEPAUSEREPAIRESCALATE

    A choice can diverge, converge at a deliberate bottleneck, or lead to a distinct outcome.

    Release access is checked before download

    Commercial access is read from the live release manifest. Prices, credit access and archive availability are never guessed here.

    Marketplace price pendingCredit unlock pending50 Credits ($5 USD) · one-time site access via Moodle Marketplace USD OR LMS Labs credits
    All plugins
    01

    Source to situation

    Policies, procedures and notes become a context for decisions.

    02

    Consequences first

    Learners see what follows a choice before the explanation.

    03

    Debrief with evidence

    Skills and principles return to the material that shaped them.

    Complete buyer and teacher guide

    Decision training that remembers the route, then shows a trainer what to teach.

    This is the complete v3.0.0 release guide. The live release manifest remains authoritative for the downloadable package and currently identifies it here as Checking release….

    1 · The player

    What a learner sees

    01

    Principles first

    Three to eight principles, each with a worked phrase and a plausible pitfall.

    02

    Opening situation

    An establishing frame and hook put the learner in the place.

    03

    A decision

    The scene and question fit together. Generated scenarios use three choices; authored scenarios may use two to four options.

    04

    The consequence

    What happened appears before the explanation; Engagement, Trust and Tension respond.

    05

    Back and forward

    Settled decisions can be re-read without resubmission or re-scoring.

    06

    The world remembers

    Authored or imported scenarios can use flags, readable documents, picture hotspots and remembered visual tags.

    07

    Escalation

    High tension can switch to crisis words and an alternate picture.

    08

    An earned ending

    Achievements can recognise holding ground, recovery, a faultless route and leaving the room settled.

    09

    The debrief

    Every decision is compared with the roads not taken before formal source-grounded knowledge returns.

    Teaching example · no plugin scoring

    ROLE · SUPPORT WORKER

    Context: an anxious family at a medication round. Principle: acknowledge concern without guessing. Pitfall: promise an answer before checking the record.

    A family member asks why a resident’s medication is late. Which response protects both the relationship and the safety process?

    2 · Two routes, one validator

    What a teacher does

    Route A

    Generate in Moodle

    Collect source, audience, role, setting, tone, complexity, objectives and a named cast with role, appearance, behaviour under pressure and gender. Generate, inspect every route, then publish.

    Route B

    Bring your own text

    Copy the complete prompt to an external assistant and paste its result back. LMS Labs makes no text-generation charge on this route; the external provider’s subscription or usage fees may apply. LMS Labs media requests remain chargeable.

    Both routes reach the same review

    The advisory quality panel can name weak non-decisions, missing pressure, principles without examples or pitfalls, duplicate choices or consequences, collapsing routes, static readings, spelling-variety conflicts, cast-pronoun conflicts, unused flags, impossible tags, unactionable document faults, debrief vocabulary leaking into scenes, and individually missing pictures. Notices do not block publishing; structural validation still rejects loops, dangling or unreachable targets and unsafe definitions.

    3 · Billing contract

    Pricing: plugin quote and actual runtime tariff

    Quotes displayed by the v3.0.0 plugin

    Plugin-displayed quoteCreditsApprox. USD
    Scenario only100US$10
    Scenario + illustrations150US$15
    Scenario + narration150US$15
    Scenario + both media types200US$20

    Confirmed actual service tariff

    Billed runtime operationCreditsUSD
    Scenario generation20US$2.00
    Wizard population3US$0.30
    Each suggestion1US$0.10
    Each image request5US$0.50
    Each narration request5US$0.50

    Ten credits equal one US dollar. Learner play and replay use no generation credits. A confirmed refunded run spends nothing against the daily allowance. Until confirmed, treat a refund as support-required. The 50-credit one-time plugin acquisition is separate from these usage charges and is not part of this mismatch; access remains controlled by the live Marketplace controls above.

    4 · Frames and voice

    Illustrations, narration and sound

    Pictures

    Every screen that needs a picture can have its own frame. Six treatments are documented: photorealistic, cinematic, illustration, watercolour, noir and oil. Repeated cast sheets and treatment instructions support a coherent series, without guaranteeing identical provider output. Briefs exclude readable text, captions, logos, identifiable real people, children, injury, violence and weapons. Documents remain structured text rather than unreadable generated text inside an image.

    Narration

    Text-to-speech supports en-AU · en-GB · en-US · en-NZ · es-ES · fr-FR · de-DE · it-IT · pt-BR · nl-NL · hi-IN · id-ID · ja-JP · ko-KR · cmn-CN · ar-XA · vi-VN · th-TH. Narrator, male-character and female-character voices are configurable separately. Narration can cover the title, situation, document, question and lettered options; it is never the only reading route.

    Sound

    Optional synthesised cues distinguish ordinary progress, strong calls under pressure and poor outcomes. There is no game-show buzzer. Sound is a separate site-wide control from narration, costs no credits, carries no unique information and can be muted by learners.

    5 · Training-manager evidence

    Reports that distinguish gaps from misconceptions

    A score says who may need help. Decision evidence says what to teach on Monday.

    Gap

    A poor choice made while the learner marked “I am not sure”. They recognise the edge of their knowledge; a rule or example can close it.

    Misconception

    A poor choice made without uncertainty. The learner believes the answer is sound; seeing the consequence is more useful than repeating the rule.

    The optional uncertainty tick is read before the outcome is shown and is never required. Cohort bars use the scenario’s decision quality, rank teachable decisions worst first and report decisions rather than profiling people. Below five answers, the report says there is too little data rather than presenting a percentage as fact. The attempt report separately shows each learner, attempt, score, outcome band, start time and decision route. Confirmed deletion removes answers, event log, gradebook mark and completion together.

    6 · Administration

    Settings and capabilities

    Site settingReference
    Credentials and connectionLMS Labs site ID/API key via Central Config when installed; API host, timeout and connection status
    Spend and sourceDaily allowance per user/24 hours; maximum source characters; generation-job retention
    Media controlsAllow illustrations, narration and scenario sounds; narrator, male and female voices
    Learner signalAllow learners to mark that they are not sure
    DefaultsLanguage, theme and every activity default pre-fill new activities
    Activity settingWhat it controls
    Illustrations / narrationGenerate scene images / spoken audio
    Show progress / readings / debriefPosition, Engagement/Trust/Tension and full debrief
    Attempts / replayAttempts may be spent; abandoned runs do not count
    Grading / completionHighest, last, first or average; finish and minimum-score rules; point grades and scales

    Find settings at Site administration → Plugins → Activity modules → AI Branched Scenario. Eight capabilities are checked at entry points: view · attempt · addinstance · manage · publish · generate · viewreports · deleteattempts. Keeping generate separate from manage lets a teacher edit without permission to spend credits.

    7 · RTO buyer reference

    Privacy and data

    No AI-provider credential is stored in the plugin.

    The plugin authenticates to LMS Labs with a site ID and API key. Supplied source content, wizard context, media-generation text and site authentication leave Moodle for generation. LMS Labs carries out external processing; this guide makes no external retention or erasure promise. Do not paste personal, learner or commercially sensitive material into source content.

    • Privacy API declarations cover attempts, decision events, uncertainty signals, generation jobs and publisher attribution.
    • Erasure clears attempts, events, gradebook and completion and removes publisher attribution while preserving revisions needed by in-progress learners.
    • Only a learner’s earned state reaches their browser; returned narrative is rendered as plain text, never provider HTML.
    • API keys are redacted before request records. Provider errors, prompts, credential fragments and stack traces are not exposed to the browser or plugin logs.

    8 · Operational release

    Requirements and compatibility

    RequirementCurrent reference
    Promoted releaseChecking release…
    MoodleMoodle™ 4.4 - 5.2
    PHP / databasesAs required and supported by the installed Moodle
    Componentmod_aibranchedscenario
    Maturity / licenceStable / GPL v3 or later
    CronGeneration uses an ad-hoc task; standard Moodle cron must run
    Backup / restoreActivity content, revisions and generated media are supported

    9 · v3.0.0 editorial evidence

    How it is built

    The author’s v3.0.0 build report records these checks for that build. LMS Labs did not independently rerun them for this documentation update. They are build-report evidence, not live-service success, uptime evidence or accessibility certification.

    2,295

    automated checks across Moodle 4.4, 4.5 and 5.2

    45 / 364

    unit tests / assertions

    Moodle CS

    0 errors reported

    96 rendered cells

    three frame heights × four widths × light and dark

    7 sweeps

    alignment, contrast, hostile themes and mobile

    Negative control

    layout sweep must fail with its fix disabled

    78 invariants

    audit baseline across content, billing and Privacy API

    When a fault is found, ask which surface it lives on and whether any check can see that surface. If nothing can, build the check before the fix.

    The supplied audit history records faults that coding rules alone would miss: wire fields dropped by a mapper, an attempt-table alignment error, a report query producing a confidently wrong 100%, and schema coverage that reached only one supported Moodle. This documentation does not claim a current external-provider run has succeeded.

    10 · Practical answers

    Frequently asked questions

    Can I use my own OpenAI or Gemini key?

    Not inside the plugin. Route B lets you use an external assistant and paste the result back; its provider fees may apply, and LMS Labs media requests are still charged.

    Can learners point at something in a picture?

    Yes in an authored or imported scenario written with hotspots. Lettered, keyboard-reachable options remain available. Automatic generation is not currently claimed to emit hotspots.

    Do learners see each other’s answers?

    No. Learner-earned state is filtered server-side. Individual attempts are available only in the protected attempt report.

    Does the cohort report name learners?

    No. It identifies decisions with gaps or misconceptions. The separate attempt report contains individual routes behind the reports capability.

    What happens if generation fails part-way?

    The job records failure. Only a confirmed refund can be described as uncharged; an unconfirmed refund is support-required. Missing media can be requested individually.

    Does playback need the external service?

    No. Published scenes and media play from Moodle. Generation requires outbound LMS Labs access.

    Can I edit generated content?

    Yes. Review every route and edit the draft before publishing. Publishing creates an immutable revision for learners already in progress.

    Is it suitable for VET or an ASQA audit?

    It preserves source-grounded decisions and per-decision records, but does not guarantee compliance or an audit outcome.

    What about accessibility?

    Keyboard reachability, visible focus, optional narration, words as well as colour, and reduced-motion support are documented. No manual assistive-technology audit or certification is claimed here.

    11 · Moodle administration

    Installation

    1. Use the protected purchase or credit-unlock control above to obtain the current promoted ZIP. Do not infer its filename from this editorial guide.
    2. Open Site administration → Plugins → Install plugins, upload the ZIP and complete Moodle’s install. Alternatively unpack it to /mod/aibranchedscenario and visit Notifications.
    3. Open the activity module settings, enter the LMS Labs site ID and API key, and verify connection status.
    4. Purge caches and confirm standard Moodle cron is running.

    12 · Before learners arrive

    Ready-to-publish checklist