Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 21 Aug 23:58
· 7 commits to main since this release

Added

  • Initial stable release: a deduction crossword-style vocabulary activity for Moodle. Each
    round draws a mystery phrase (a course concept's own hint) and a set of clues (other
    concepts whose words share letters with it); solving a clue reveals its shared letters
    everywhere they occur, by letter identity rather than spatial position. Students can also
    risk a direct mystery-phrase guess at any point, earning a bonus proportional to how many
    clues were still unresolved.
  • A configurable win condition: resolving every clue and guessing the mystery phrase, or the
    mystery-phrase guess alone (clues remain optional but still help by revealing letters). A
    clue that runs out of attempts under the "both required" condition ends the round
    immediately as a loss instead of leaving the student stuck.
  • Word sources: manual entry, automatic import from the course Glossary (with per-activity
    stopword filtering), and AI-assisted generation via local_aihub (BYOK) or Moodle's
    core_ai subsystem, respecting the per-course "Enable AI tools" toggle. Inactive pool words
    are flagged automatically for whoever manages the activity.
  • A toggleable per-clue hint system: hint reveal can be turned off entirely for the activity,
    capped to a fixed number of reveals per round (default 3), or left unlimited — optionally at
    a PlayerHUD item cost. Revealing enough hints to uncover every letter wins the round on its
    own.
  • Configurable round rules: independent length ranges for the mystery phrase and the clue
    words, 3–10 clues per round, an optional attempts-per-clue cap, round limit (1–10 or
    unlimited) with a configurable cooldown between rounds, word mode (random or a shared
    sequence for the whole class), and accent-insensitive matching with true-spelling reveal —
    including a long-press accent picker on the on-screen keyboard's vowel keys.
  • Optional integration with block_playerhud: an item can be required to start a round or to
    reveal a clue's hint, and an item can be granted for each round won, with an anti-farming
    rule that withholds the bonus XP on activities configured for unlimited rounds.
  • Per-clue scoring (full credit on the first two attempts, then scaled down) plus an optional
    bonus for guessing the mystery phrase directly, combined with four grading methods (highest,
    average, first attempt, last attempt), fully integrated with the Moodle gradebook.
  • Top-5 ranking leaderboard (respecting separate groups) and per-student attempt history, with
    a paginated report for whoever manages the activity.
  • Custom activity completion rule (minimum completed rounds).
  • First-visit onboarding: the how-to-play modal opens automatically once, site-wide, the very
    first time a student encounters the activity, and is always reachable again from the
    toolbar.
  • Accessibility: WCAG AA contrast on every puzzle tile, non-colour state indicators,
    aria-labels on every input, and per-letter-box focus behaviour mirroring a
    verification-code input.
  • Backup and restore (moodle2), full Privacy API compliance, and Portuguese (pt_br)
    translation alongside English.