dopa-drill README

The project's README from github.com/grmchn/dopa-drill. As one markdown file: README.md.

ドパドリル

算数を1問解くたびに、演出と音楽がどんどん盛り上がっていく計算ドリルです。ブラウザだけで動きます。

マスコットの「ドパキチ」が入力した数字を運び、正解すると祝ってくれます。問題を進めるほど画面と音が増えていき、最後はお祭りのような状態になります。まちがえても勢いは落ちず、ゲームオーバーもありません。

特徴

遊び方(ローカル)

ビルドは不要です。app/ を静的に配信するだけで動きます。

python3 -m http.server 8000 -d app

ブラウザで http://localhost:8000/ を開いてください。ES Modulesを使っているため、file:// で直接開くと動きません。

テスト

Node.js 20以上で実行します。

node --test tests/*.test.mjs

構成

パス 内容
app/ ゲーム本体(依存ライブラリなしのES Modules)
docs/SPEC.md 仕様書
docs/curriculum.md 学年別カリキュラムとスキルツリーの設計
docs/dopakichi.svg ドパキチの造形の原典
tests/ 単体テスト
tools/build_fonts.sh フォントのサブセット再生成(画面の文言を追加したときに実行)

ライセンス

詳細は LICENSE を参照してください。

ドパキチ・ドパドリルの二次創作について

営利目的でなければ、連絡なしで自由に使えます。

公開するときは、非公式であることが分かるようにしてください。LICENSEの英文と内容が異なる場合は、英文が優先します。

dopa-drill (grmchn/dopa-drill)

vanilla-javascript
Searching Database…

What is this?A browser-only math drill game ('Dopadrill') where the visual effects and music keep escalating with every correct answer. A mascot named Dopakichi carries your typed numbers and celebrates each correct result, building toward a festival-like finale.
Is this a native app, or just a web page I open in a browser?It's a static web app with no build step: the whole game lives in app/ as dependency-free vanilla JavaScript using ES Modules, served directly from a static file server.
How do I run it?Serve the app/ folder with any static file server and open it in a browser. Opening it directly via file:// will not work because it relies on ES Modules.
Do I need Node.js or any build tools just to play it?No — the game itself has zero dependencies and no build step. Node.js 20+ is only needed if you want to run the project's unit tests.
Does getting an answer wrong end the game?No — there's no game over state, and mistakes don't reduce the escalating momentum; you just keep playing.
Does it work on a phone too, or only on PC?It supports both smartphone portrait screens and PC, with number-key and Backspace input available on PC.
What math skills does it cover?58 skills spanning grades 1-6 based on Japan's school curriculum, including addition, subtraction, multiplication, division (including long-division working steps), decimals, fractions, and ratios.
How does scoring work?Answering everything correctly earns 100 points. If your first-try accuracy is 80% or higher, you unlock a timed extra round where you can score above 100.
What is the 'My Level' mode?An adaptive mode that starts from a quick skill-check assessment and then unlocks new skills progressively as you master each one, alongside separate grade-based, practice, review, and skill-tree screens.
Are the music and sound effects actual audio files?No — all music and sound effects are synthesized in real time with the Web Audio API; the project ships no audio files at all.
Creator
grmchn
Size
0.6 MB
Stars
243
Updated
CommitOct 13
Age
22d
Commits · 90 Days