34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# Hogwarts Arithmancy Flash Cards
|
||
|
||
Interactive, themeable multiplication drill game with a Hogwarts aesthetic. Solve equations quickly to push back the “dementor” overlay, earn gold, buy cosmetics, and track mastery. Supports keyboard play and a quick-use consumables bar.
|
||
|
||
## Highlights
|
||
- Progressive levels tied to specific fact sets; XP queues focus facts (no auto-master).
|
||
- Dementor pressure overlay + CAST timer that scales with problem difficulty.
|
||
- Keyboard + on-screen keypad; quick consumables bar for instant use.
|
||
- Gold shop: skins (Houses, Marauder’s Map, Spellbook), trails, pets; snitch bonuses (infrequent, hides when dementor is near).
|
||
- Hint grid after repeated misses; darker overlays brighten UI/text for readability.
|
||
- Persistent progress via `localStorage`.
|
||
|
||
## Play
|
||
1) Open `index.html` in a browser (or serve the folder with any static server).
|
||
2) Enter answers via keypad or keyboard (`0–9`, `Backspace`, `C`/`Esc` to clear, `Enter` to CAST).
|
||
3) Earn gold/XP on correct answers; spend gold in the Student Trunk; quick-use consumables from the bar under the keypad.
|
||
|
||
## Gameplay logic
|
||
- Timer: CAST bar drains with dementor; duration scales with problem difficulty (larger factors give more time). Timer-out counts as a third miss after a brief grace period.
|
||
- Miss flow: 1st miss shakes; 2nd miss shakes + shows star grid; 3rd miss (or timeout) auto-fills the answer, adds to trouble list, and requires pressing CAST to continue.
|
||
- Focus facts: XP fills queue entries instead of auto-mastering; queued facts are injected into upcoming questions.
|
||
- Snitch: appears rarely (45–75s) and only when dementor pressure is low; grants bonus gold when clicked.
|
||
- Data/key: `arithmancyDataV17` stored in `localStorage`.
|
||
|
||
## Development
|
||
- Tech: vanilla HTML/CSS/JS (no build step).
|
||
- Entry points: `index.html`, `style.css`, `app.js`.
|
||
|
||
## License
|
||
MIT License. See `LICENSE` for details.
|
||
|
||
## Credits
|
||
- Game design & playtesting: Alyssa, Jolene, Kathleen, Evelyn
|