Hangul Quest 3.2.0

Added

• Taiga and savanna villagers speak their region's dialect. Taiga villagers talk Busan (Gyeongsang) Korean,
  savanna villagers Jeju Korean — in every line they say, not only in the conversations written for their region:
  the general and profession conversations got regional versions too, and the conversation picker prefers the
  one that fits the village. Player answers stay in standard Korean, so the learner keeps practising the standard
  form. The dialect covers the endings (-예, -우다, -심더, -수다, -이소 …) and the few words that differ (묵- for
  먹-, 하영, 혼저, 아이가), not the vocabulary the lessons teach.
• Adult voices for every villager. The eight personality voices and the two child voices were redesigned: the
  old pack had a woman at 445 Hz because the voice descriptions asked for a "high-pitched, bubbly" delivery and
  only a lower pitch bound was checked. Every voice now sits in the normal adult speaking range (men 99–132 Hz,
  women 194–260 Hz, children 341/353 Hz) and is picked from several takes by measured pitch.
• Region accent voices. Sixteen more voices carry the two dialects — one Busan and one Jeju voice per
  personality (cranky 111/109 Hz, lazy 124/134, smug 133/109, jock 138/175, normal 193/200, snooty 216/215,
  sisterly 229/233, peppy 274/269). A villager's voice follows the region it lives in and changes with it.

Changed

• Translations in conversations follow the setting. The gloss under a villager's line and under the answer
  choices is only drawn while "Übersetzungen in Quests" is on; it stays off by default, so a conversation is Korean
  only. The gloss of a single word on hover stays as the learning aid.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.1.1

Added

• Name tags for villagers you have met. Once a villager has introduced itself, its name floats above its head like a name tag. Client side only: nothing is sent to the server or saved in the world, and a villager with a real name tag keeps that name.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.1.0

Added

• Villagers have a personality. Every villager you talk to gets one of eight personalities (inspired by
  life-sim games: lazy, sporty, grumpy, suave, kind, peppy, snooty, big sister), a gender, a Korean name from its
  gender's pool of 40 and the region of its village. All of it is kept, so a villager always has the same name and
  voice, also as a grown-up child. Snooty villagers speak 합쇼체, the others 해요체, children 반말.
• Conversations follow the villager. A villager introduces itself the first time, then picks small talk written
  for its personality and region, the most fitting one you have not heard first, and never above your level.
• Friendship. Talking once a day adds a heart, a finished request two (up to ten). At three, six and ten hearts a
  villager has something new to say; a close lazy, sporty, peppy or big-sister villager may offer to switch to 반말
  with a player at level 4 or more.
• Villager requests. Villagers ask for small things outside the quest tree that depend on their region: show
  them something you hold, drop something they pick up (bread, wheat, carrots …) or do something and come back.
  An accepted request is a row of the quest log with the villager's name; it takes the place of the game's oldest
  own pick when the log is full, and waits in the journal when every slot holds a quest you chose. Up to three at
  once, one per villager; declining costs nothing and a request can be abandoned in the journal.
• Villagers page in the journal (주민). Everyone you met, in the order you met them: name, personality,
  region, profession, hearts and the open request (track, untrack, abandon).
• Villagers speak. With a voice pack that has the lines, each conversation line is spoken in the villager's
  own voice (one per personality, two for children); R or the play mark repeats it. Without one it stays silent.
• Content. 277 personality conversations (56 introductions, 112 small talk, 24 friendship talks, 4 반말 offers,
  16 children's talks and the nine old profession talks rewritten for every personality) and 58 regional requests:
  3,869 Korean lines, all with English and German glosses. The nine conversations without a personality (farm,
  library, fishing, smithy, maps, cleric, greetings, child, elder) are gone.
• Voices 1.2.0. Every conversation line has a clip in its villager's voice (eight adult voices and two children's
  voices, Qwen3-TTS, Apache-2.0); R repeats it. The pack is optional, as before.
• For content authors: python3 tools/validate_dialogue_drafts.py <folder> checks drafted conversations and requests
  before they are copied in (see content/briefs/VILLAGERS.md).

Changed

• The progress file moves to schema v5 (the villager requests); the v4 file is backed up first. Villager names move
  from villager-names.json to villagers.json, which now also keeps personality, region and friendship; the old
  names are kept.
• The journal has a ninth tab; Settings is now the last of nine.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.0.3

Added

• Every block, item and mob has a voice. Words that only have their name from the game (andesite, birch
  stairs, a glow squid …) now play a clip as well, with Hangul Quest Voices 1.1.0 or later (768 new words, event
  word.mc_<id> and word.mc_entity_<id>). With an older pack they stay silent, as before.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.0.2

Fixed

• Reset progress also ends the started quests. The quests in the log (and the ones set aside) used to come back
  after a reset, because only the highlighted quest was dropped. Now every started quest is forgotten, the open
  next-quest choice closes and new starter quests are picked.
• G names what you look at, also far away. It looked only as far as your arm reaches and otherwise showed the
  word of the quest step, so a distant village, ice a few blocks off or anything seen while falling came out as the
  quest's word (campfire, glass). It now follows your view up to 128 blocks to the first block or mob; with only sky
  in view it names the item in your hand, and something without a word shows nothing.
• G says more words. A block that only has its plain game name (a birch log, a spruce fence) is named with the
  voiced word for its kind (통나무, 울타리), as the oak log already was.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.0.1

Changed

• The word card has its own key. The vocabulary card in the bottom-right corner and its spoken word now come
  only from G (Show word, rebindable): the block or mob under the crosshair, else the held item, else the word
  of the focused step. Looking at blocks, picking up items and the hint key no longer pop it up or say the word, and
  the card is not one of the windows H closes; it fades on its own.

Fabric mod for Minecraft 26.3. Requires Fabric Loader 0.19.5+ and Fabric API 0.162.0+26.3 on Java 25. Client-side only. Check the download with sha256sum -c SHA256SUMS.

Hangul Quest 3.0.0

Hangul Quest 3.0 is a new course, not an update of the old one. Every trail from level 1 to level 6 was
rebuilt on a curriculum built from language-learning research.

• 422 trails at six levels. Each level adds grammar step by step, from -아/어요 at level 1 to -(으)ㄹ수록 at
  level 6. From level 2 on, many steps can only be solved by reading the Korean form (위 vs 아래, -기 전에,
  밤이 되면 …): about two in five at level 2, more than half from level 4.
• Words come back in new tasks. A word returns many times, each time as a different task (the torch is made,
  placed next to a door, held in a cave, given to a villager …). Almost every sentence has at most one word you
  don't know yet.
• Honest spaced review (FSRS). Only real recall moves a word forward. Quiz cards, syllable tiles and typed answers
  (두벌식) live in their own screen, so the hotbar keys are never captured.
• More than quests:
  • a grammar book with rule cards;
  • villager dialogue, with the speech level to choose: 합쇼체 to elders, 반말 to children;
  • 24 graded stories that open once you know nearly every word;
  • culture notes;
  • the sound forge, a listening game for ㄱ/ㄲ/ㅋ and similar sound sets.
• Korean you can check. Every line went through a Korean linter and two blind AI linguist reviews. The public review
  site lets native speakers confirm or correct any line with one click.
• The optional Hangul Quest Voices pack speaks every word in four synthetic voices.
• Your progress is kept. Old saves are copied and converted, never overwritten (see below).

Before you update (read this)

• Your progress is kept. Words, review state, streak, achievements, finished and started trails, the quest log
  and the options are all converted when you first start 3.0. Nothing is reset.
• Saves are converted and backed up. Progress is now stored per Minecraft account in
  config/hangulquest/profiles/<account-id>/progress.json (schema 4). The first time a profile opens, your old
  config/hangulquest/progress.json is copied into it; the old file is never moved, changed or deleted. Before
  an old-format file is converted the mod also writes progress.v<N>-backup-<time>.json next to it, and daily and
  weekly copies are kept in backups/. A word's old level stays in the file, and its new review card starts from
  it (a word you had marked known starts at 30 days), so nothing comes due all at once. config.json is upgraded
  in place (version 5).
• Trails that were rebuilt keep their state. The curriculum was rebuilt trail by trail. Finished trails stay
  finished; a renamed trail, step or word is mapped to its new id, and retired content is flagged, never deleted.
• How to roll back. Close the game, put the 2.1.0 jar back into mods/, and delete
  config/hangulquest/config.json (it is rebuilt with defaults). 2.1.0 reads the untouched
  config/hangulquest/progress.json, so you are back where you were before updating. What you learned in 3.0 stays
  in the profiles/ folder and is not carried back. To go back to a state inside 3.0, copy one of the backup files
  over the profile's progress.json. A copy of the whole config/hangulquest/ folder made before updating is the
  safest rollback of all.

For players

What changes in play

• Windows stay until you close them. The hint, rule cards, culture notes, word cards, banners, toasts, the
  quiz prompt, the next-quest popup and the completion cards no longer time out. One press of the hint key (H)
  closes exactly one window, the top one; waiting windows show a "+N" badge; a repeat is not queued twice. Closing a
  window is never a hint and never changes grading. Each window shows its key ([H] 닫기 · close) and none covers
  the crosshair or the hotbar. Settings → Auto-close windows brings back the old timeouts (off by default).
• The game fills your quest log. Three regular quests that fit the start of the game, and a fourth slot that
  follows where you are (a snow trail in the snow, a cave trail underground). When you finish one, the next one
  follows. Quests you tick yourself are never replaced, and a quest you take out stays out for 30 minutes of play.
  Settings → Pick quests automatically turns this off.
• A readable quest tree. The tree shows what matters now: trails you can start, the ones in your log and,
  greyed out, those waiting directly behind them. Finished trails fold into one "완료 · Completed" button, and
  Show all trails shows the whole map. A locked trail says what it is waiting for. There is also a second view by
  life situation (house, fire and light, field, animals, ...).
• A welcome screen and the Hangul prerequisite. The first time you join a world, a short screen asks whether
  you can read Hangul and, if not, points to free lessons. The mod teaches words and grammar, not the alphabet.
  Skip it, ask to be reminded once, or switch it off; it never blocks a quest. It stays in the journal's Info tab.
• The curriculum was rebuilt. The 420 trails of 2.x were mostly generated and repeated themselves. Over 200
  trails of levels 1 and 2 were rewritten in batches of 15 around one small idea each (the first steps, the village,
  the kitchen and the feast, the smithy, the sea and harbour, animals and pets, colours and the garden, mountains,
  ice and night, and more), with the words recycled on purpose. The rebuild goes on in the 3.x releases. The tree has
  422 trails and 1,661 steps in a quest tree 22 trails deep; the word catalog has about 1,300 concepts.
• A grammar ladder that teaches. Each Korean level has one instruction ending: level 1 -아/어요, levels 2 and 3
  -(으)세요, levels 4 to 6 -아/어야 해요. You read at most one level above the grammar you have met; a new
  construction shows a two-line rule card once, the journal has a grammar book, and the review quiz has grammar cloze
  cards. Hints always stay at level 1.
• New things to do. Trails now ask you to craft, smelt, give, put into a chest, hold while doing something, do
  things in a sequence ("before", "after", "and then"), avoid something, place things next to or between other things
  or in a wall, cross or stair pattern, light a candle, breed animals, trade (the direction of 에게서 / 에게 is
  checked), write on a sign, hear a bell or a jukebox, wait, swim, lie down, mount, take out, go in and out, put
  armour on, shear, dye and tie animals, and jump from a height onto snow. Every sentence still says every condition.
• A real review scheduler. Reviews use FSRS-6 instead of the seven-step ladder, with a retention setting and 5, 10
  or 15 new words a day. Cards are multiple choice with four options, self-graded recall, syllable tiles and, for
  stable words, typing with a 두벌식 keyboard (also on QWERTZ). The streak is gentle: a weekly goal of four days
  and two automatic freezes a month. Mastery needs recall on three study days.
• Reading and people. A Books tab with graded stories (a word must be known to 98% before a story opens) and
  eight culture notes; villagers you sneak-click talk Korean, with speech-level choices (반말 to a child, 합쇼체 to a
  librarian). Verbs get their forms from a morphology engine; the word list shows Sino-Korean families.
• Pronunciation in brackets. Where the spelling hides the sound, the card shows the sound in Hangul
  (횃불 [홰뿔]). There is no romanisation.
• Four interface languages. English, German, Spanish and French (see below).
• Privacy is unchanged. No network code, no telemetry. The optional research export is manual only, hashes ids
  and shows a consent text.

Languages shipped

Language	Interface	Quest text	State
English	complete	complete	the source language
Deutsch	complete	about 88%	proofread (Gemini draft, Claude second pass)
Español	complete	about half	proofread (Gemini draft, Claude second pass)
Français	complete	about a third	proofread (Gemini draft, Claude second pass); the rest of the quest text falls back to English

A text a language lacks is shown in English, never in German. The quest itself is always Korean. Coverage is measured
against all 6,068 rows of the current content and moves with every new content batch. No translation has been
approved by a native speaker yet.

The optional voices pack

"Hangul Quest Voices" is a separate resource pack with machine-made clips for words. It is not part of the mod jar
and has its own download and project page. Without it the mod is silent, as before. Drop it into resourcepacks/ and
switch it on; a listen key plays a word when the pack has a clip for it. The clips are made offline with an open
text-to-speech model and checked by a speech-recognition round trip. They are not native recordings. audio in
config.json switches playback off.

Korean text and its review

• Every Korean line, authored, generated or from the word catalog (6,536 lines in this build), passes the project's
  Korean linter, and each line has an id, its context and a status.
• Two independent AI reviewers (Claude and Gemini, blind to each other) have checked 365 lines, about 6%, and
  both said "fine" for all of them. The rest are lint-checked only. New content batches get a dual review; the registry
  is updated as the reports are imported.
• No line is native-approved yet. Nobody who speaks Korean natively has signed off on any line, and the review
  site says so ("AI checked", not "native approved").
• The GitHub review path. A static review site lists every Korean line with its context. Anyone with a GitHub
  account presses Looks right or Suggest a correction, which opens a prefilled issue form. A line becomes
  native-approved with two approvals from accounts at least 30 days old, or one from a trusted reviewer; nobody can
  approve their own line. The review bot turns accepted corrections into pull requests that the maint...

Hangul Quest 3.0.0-rc.9

New in rc.9: level 4 begins, and the sound forge.

• 30 level-4 trails: the far kingdoms (the End and the dragon, an ocean monument, a library, a lighthouse, the star
  map, a trading fleet, the cloud path) and 15 small poems. About half of their steps now depend on the Korean form:
  밤이 되면 …, 돌을 캐서 …, 꽃을 꺾으러 … 가야 해요.
• Sound forge (소리 대장간): a listening game in the journal's Study tab for ㄱ ㄲ ㅋ, ㄷ ㄸ ㅌ, ㅂ ㅃ ㅍ, ㅈ ㅉ ㅊ, ㅅ ㅆ and
  ㅓ ㅗ. A run is 60 trials in a random voice, and you hear both sounds again after each answer. A listening test before
  and after uses voices that never appear in training. The sounds come from the optional voices pack. They are
  synthetic for now, and recordings by native speakers would make them better.
• The voices pack now covers every word, but no sentences until the mod plays them (about 44 MB).

Sound forge, technical details: a listening mini-game in the journal's Study tab for the sounds that sound alike to an
English or German ear: ㄱ ㄲ ㅋ, ㄷ ㄸ ㅌ, ㅂ ㅃ ㅍ, ㅈ ㅉ ㅊ, ㅅ ㅆ and ㅓ ㅗ (never ㅐ ㅔ). A voice says a syllable or a word, you
pick which of two or three it was (keys 1 2 3, R to hear it again, or click), and you hear both sounds again with the
answer. A run is 60 trials in a random voice each time. A 30-trial listening test before and after (8 to 10 runs over at
least 3 weeks) uses voices that never appear in training, and the start page shows before, lately and after per contrast.
Answers go to the review log as the new mode HVPT (kind HVPT; it never touches a schedule) and the progress file gets
a small hvpt record (finished runs and a tally per contrast) without a schema bump. The sounds come from the optional
Hangul Quest Voices pack (synthetic for now, marked source: tts in its manifest); without it the screen says so.
tools/audio/hvpt_texts.py writes the texts, build_pack.py --hvpt adds them to the pack. learn/audio/Pitch (YIN F0)
is the base for a later pitch view.

New in rc.8: the grammar for levels 4 to 6.

• Level 4: conditions become "if/when" clauses (밤이 되면 횃불을 놓아야 해요), steps join with -아/어서
  (돌을 캐서 화로를 만들어야 해요), and purpose trips use -(으)러 가요 (나무를 베러 숲으로 가야 해요).
• Level 5: colour adjectives (빨간 침대), "while" clauses (해가 지는 동안 기다려야 해요) and "even if"
  (밤이 되어도 자지 마세요).
• Level 6: "the higher, the colder" (높이 올라갈수록 추워져요), plus forms for formal and casual speech.
• A new check keeps each construction at its own level and in the right kind of line.

New in rc.7: new kinds of quests, ready for level 4.

• Shooting and throwing: hit a target block or a creature with a bow, crossbow, trident, snowball or egg
  (활로 과녁을 맞히세요), some from far away or with one arrow through two mobs.
• Compass directions: walk north, south, east or west (북쪽으로 이십 블록 가세요), or face a direction while doing
  something.
• "Don't" works on creatures too: 주민을 물리치지 마세요.
• More natural numbers: heights and distances use Sino-Korean numbers (높이 백 블록), and counts up to 99 use native
  numbers (스물네 개).
• Sequences no longer repeat the same object twice, and swimming in the ocean reads 바다에서 수영하세요.
• Six flavour lines from the last two batches now state plain facts.

New in rc.6: level 3 is complete.

• All 108 level-3 trails are rebuilt, and nearly half of their steps now depend on the Korean form.

• The last two batches are small mood trails: miners and smiths, caves and gems, forest herbs, foxes and bees. There
  are also three watchtowers.

• Finale lines were tightened after review: no plans, and no claims the quest doesn't check.

• Generator wave 9 (what the mountain, ice and night and the animal batches found). A fall is a goal (FALL: a jump
  onto a soft block, or a fall that costs no health; 높은 곳에서 가루눈 위로 뛰어내리세요). The tool in the hand decides
  the verb on a creature (가위로 양털을 깎아요, 끈으로 소를 묶어요, 솔로 아르마딜로를 닦아요, 가위로 늑대의 갑옷을 벗겨요), armour is
  put on a creature (늑대에게 갑옷을 입히세요) and dye colours a sheep (파란색 염료로 양을 염색하세요). A name that ends in its
  own counter is counted with 개 (꿀이 든 병을 네 개), a row has the size that was built, conditions are spoken in a fixed
  order (time, weather, place, what is held), seconds of a look are spoken as 삼 초, a sequence says a shared object once
  and teaches its word in every part, a colour stands in front of the dye or the wool, and the material of a fence ring
  or a plank pillar is the kind word (울타리, 판자). Goals and conditions refuse unknown or missing fields. Rabbits,
  frogs, goats, turtles, bees, mules, parrots and axolotls can anchor a placement.
  New in rc.5:

• Explorers: a spyglass on a mountain, music in the meadow, leather boots on powder snow, a cloud city, an
  observatory, the far north.

• Wonders of the world: the world market, a giant tree, a pyramid, a harbour, the pirate's chest, desert and
  jungle temples, a desert town.

• Level 3 meets its grammar goal: more than a third of its steps now depend on the Korean form (before/after,
  "don't").

• French covers every rebuilt trail, proofread.

New in rc.4: two more level-3 batches.

• The village heroes: curing a zombie villager, the iron golem, the raid patrol, enchanting, the ender eye, diamond
  gear, and the trade, post and fishing guilds.
• The hunter: bow, crossbow, spear and shield, night hunts, the wolf.

Finale lines across levels 3 and 4 now claim only what the quest checks. Pouring water reads 붓다, and rails laid in
a row read 깔다.

New in rc.3: the second level-3 batch: the first diamond, the jewellers' guild, amethyst and the crystal smithy,
the mine with rails and a minecart, the respawn anchor, wither skeletons and the bastion. The first four level-4
trails arrive with it (brewing, a stronger potion, a beacon base, the skull tower), using the level-4 ending
-아/어야 해요.

New in rc.2: the first level-3 batch. The way into the Nether is rebuilt: obsidian, the portal, piglins and
gold, the fortress and blaze rods, the bastion, striders, crying obsidian and ancient debris. Level 3 brings
"before" and "after" (-기 전에, -(으)ㄴ 후에), "don't" (-지 마세요) and "can" (-(으)ㄹ 수 있어요). The Nether
branch now starts after the lava-bucket trail. Several BATCH-015 finale lines were corrected so they claim only
what the quest checks.

Hangul Quest 3.0 rebuilds the curriculum around what a player does in the world, replaces the old review ladder
with a real spaced-repetition scheduler, and opens the Korean text to review by native speakers. It needs
Minecraft 26.3, Fabric Loader 0.19.5+, Fabric API 0.162.0+26.3 and Java 25, like 2.1.0.

Before you update (read this)

• Your progress is kept. Words, review state, streak, achievements, finished and started trails, the quest log
  and the options are all converted when you first start 3.0. Nothing is reset.
• Saves are converted and backed up. Progress is now stored per Minecraft account in
  config/hangulquest/profiles/<account-id>/progress.json (schema 4). The first time a profile opens, your old
  config/hangulquest/progress.json is copied into it; the old file is never moved, changed or deleted. Before
  an old-format file is converted the mod also writes progress.v<N>-backup-<time>.json next to it, and daily and
  weekly copies are kept in backups/. A word's old level stays in the file, and its new review card starts from
  it (a word you had marked known starts at 30 days), so nothing comes due all at once. config.json is upgraded
  in place (version 5).
• Trails that were rebuilt keep their state. The curriculum was rebuilt trail by trail. Finished trails stay
  finished; a renamed trail, step or word is mapped to its new id, and retired content is flagged, never deleted.
• How to roll back. Close the game, put the 2.1.0 jar back into mods/, and delete
  config/hangulquest/config.json (it is rebuilt with defaults). 2.1.0 reads the untouched
  config/hangulquest/progress.json, so you are back where you were before updating. What you learned in 3.0 stays
  in the profiles/ folder and is not carried back. To go back to a state inside 3.0, copy one of the backup files
  over the profile's progress.json. A copy of the whole config/hangulquest/ folder made before updating is the
  safest rollback of all.
• Release candidate. This is a pre-release. Please report anything that looks wrong.

For players

What changes in play

• Windows stay until you close them. The hint, rule cards, culture notes, word cards, banners, toasts, the
  quiz prompt, the next-quest popup and the completion cards no longer time out. One press of the hint key (H)
  closes exactly one window, the top one; waiting windows show a "+N" badge; a repeat is not queued twice. Closing a
  window is never a hint and never changes grading. Each window shows its key ([H] 닫기 · close) and none covers
  the crosshair or the hotbar. Settings → Auto-close windows brings back the old timeouts (off by default).
• The game fills your quest log. Three regular quests that fit the start of the game, and a fourth slot that
  follows where you are (a snow trail in the snow, a cave trail underground). When you finish one, the next one
  follows. Quests you tick yourself are never replaced, and a quest you take out stays out for 30 minutes of play.
  Settings → Pick quests automatically turns this off.
• A readable quest tree. The tree shows what matters now: trails you can start, the ones in your log and,
  greyed out, those waiting directly behind them. Finished trails fold into one "완료 · Completed" button, and
  Show all trails shows the whole map. A locked trail says what it is waiting for. There is also a second view by
  life situation (house, fire and light, field, animals, ...).
• A welcome screen and the Hangul prerequisite. The first time you join a world, a short screen asks whether
  you can read Hangul and, if not, points to free lessons. The mod teaches words and grammar, not the alphabet.
  Skip it, ask to be reminded...

Hangul Quest 3.0.0-rc.8

New in rc.8: the grammar for levels 4 to 6.

• Level 4: conditions become "if/when" clauses (밤이 되면 횃불을 놓아야 해요), steps join with -아/어서
  (돌을 캐서 화로를 만들어야 해요), and purpose trips use -(으)러 가요 (나무를 베러 숲으로 가야 해요).
• Level 5: colour adjectives (빨간 침대), "while" clauses (해가 지는 동안 기다려야 해요) and "even if"
  (밤이 되어도 자지 마세요).
• Level 6: "the higher, the colder" (높이 올라갈수록 추워져요), plus forms for formal and casual speech.
• A new check keeps each construction at its own level and in the right kind of line.

New in rc.7: new kinds of quests, ready for level 4.

• Shooting and throwing: hit a target block or a creature with a bow, crossbow, trident, snowball or egg
  (활로 과녁을 맞히세요), some from far away or with one arrow through two mobs.
• Compass directions: walk north, south, east or west (북쪽으로 이십 블록 가세요), or face a direction while doing
  something.
• "Don't" works on creatures too: 주민을 물리치지 마세요.
• More natural numbers: heights and distances use Sino-Korean numbers (높이 백 블록), and counts up to 99 use native
  numbers (스물네 개).
• Sequences no longer repeat the same object twice, and swimming in the ocean reads 바다에서 수영하세요.
• Six flavour lines from the last two batches now state plain facts.

New in rc.6: level 3 is complete.

• All 108 level-3 trails are rebuilt, and nearly half of their steps now depend on the Korean form.
• The last two batches are small mood trails: miners and smiths, caves and gems, forest herbs, foxes and bees. There
  are also three watchtowers.
• Finale lines were tightened after review: no plans, and no claims the quest doesn't check.

New in rc.5:

• Explorers: a spyglass on a mountain, music in the meadow, leather boots on powder snow, a cloud city, an
  observatory, the far north.
• Wonders of the world: the world market, a giant tree, a pyramid, a harbour, the pirate's chest, desert and
  jungle temples, a desert town.
• Level 3 meets its grammar goal: more than a third of its steps now depend on the Korean form (before/after,
  "don't").
• French covers every rebuilt trail, proofread.

New in rc.4: two more level-3 batches.

• The village heroes: curing a zombie villager, the iron golem, the raid patrol, enchanting, the ender eye, diamond
  gear, and the trade, post and fishing guilds.
• The hunter: bow, crossbow, spear and shield, night hunts, the wolf.

Finale lines across levels 3 and 4 now claim only what the quest checks. Pouring water reads 붓다, and rails laid in
a row read 깔다.

New in rc.3: the second level-3 batch: the first diamond, the jewellers' guild, amethyst and the crystal smithy,
the mine with rails and a minecart, the respawn anchor, wither skeletons and the bastion. The first four level-4
trails arrive with it (brewing, a stronger potion, a beacon base, the skull tower), using the level-4 ending
-아/어야 해요.

New in rc.2: the first level-3 batch. The way into the Nether is rebuilt: obsidian, the portal, piglins and
gold, the fortress and blaze rods, the bastion, striders, crying obsidian and ancient debris. Level 3 brings
"before" and "after" (-기 전에, -(으)ㄴ 후에), "don't" (-지 마세요) and "can" (-(으)ㄹ 수 있어요). The Nether
branch now starts after the lava-bucket trail. Several BATCH-015 finale lines were corrected so they claim only
what the quest checks.

Hangul Quest 3.0 rebuilds the curriculum around what a player does in the world, replaces the old review ladder
with a real spaced-repetition scheduler, and opens the Korean text to review by native speakers. It needs
Minecraft 26.3, Fabric Loader 0.19.5+, Fabric API 0.162.0+26.3 and Java 25, like 2.1.0.

Before you update (read this)

• Your progress is kept. Words, review state, streak, achievements, finished and started trails, the quest log
  and the options are all converted when you first start 3.0. Nothing is reset.
• Saves are converted and backed up. Progress is now stored per Minecraft account in
  config/hangulquest/profiles/<account-id>/progress.json (schema 4). The first time a profile opens, your old
  config/hangulquest/progress.json is copied into it; the old file is never moved, changed or deleted. Before
  an old-format file is converted the mod also writes progress.v<N>-backup-<time>.json next to it, and daily and
  weekly copies are kept in backups/. A word's old level stays in the file, and its new review card starts from
  it (a word you had marked known starts at 30 days), so nothing comes due all at once. config.json is upgraded
  in place (version 5).
• Trails that were rebuilt keep their state. The curriculum was rebuilt trail by trail. Finished trails stay
  finished; a renamed trail, step or word is mapped to its new id, and retired content is flagged, never deleted.
• How to roll back. Close the game, put the 2.1.0 jar back into mods/, and delete
  config/hangulquest/config.json (it is rebuilt with defaults). 2.1.0 reads the untouched
  config/hangulquest/progress.json, so you are back where you were before updating. What you learned in 3.0 stays
  in the profiles/ folder and is not carried back. To go back to a state inside 3.0, copy one of the backup files
  over the profile's progress.json. A copy of the whole config/hangulquest/ folder made before updating is the
  safest rollback of all.
• Release candidate. This is a pre-release. Please report anything that looks wrong.

For players

What changes in play

• Windows stay until you close them. The hint, rule cards, culture notes, word cards, banners, toasts, the
  quiz prompt, the next-quest popup and the completion cards no longer time out. One press of the hint key (H)
  closes exactly one window, the top one; waiting windows show a "+N" badge; a repeat is not queued twice. Closing a
  window is never a hint and never changes grading. Each window shows its key ([H] 닫기 · close) and none covers
  the crosshair or the hotbar. Settings → Auto-close windows brings back the old timeouts (off by default).
• The game fills your quest log. Three regular quests that fit the start of the game, and a fourth slot that
  follows where you are (a snow trail in the snow, a cave trail underground). When you finish one, the next one
  follows. Quests you tick yourself are never replaced, and a quest you take out stays out for 30 minutes of play.
  Settings → Pick quests automatically turns this off.
• A readable quest tree. The tree shows what matters now: trails you can start, the ones in your log and,
  greyed out, those waiting directly behind them. Finished trails fold into one "완료 · Completed" button, and
  Show all trails shows the whole map. A locked trail says what it is waiting for. There is also a second view by
  life situation (house, fire and light, field, animals, ...).
• A welcome screen and the Hangul prerequisite. The first time you join a world, a short screen asks whether
  you can read Hangul and, if not, points to free lessons. The mod teaches words and grammar, not the alphabet.
  Skip it, ask to be reminded once, or switch it off; it never blocks a quest. It stays in the journal's Info tab.
• The curriculum was rebuilt. The 420 trails of 2.x were mostly generated and repeated themselves. Over 200
  trails of levels 1 and 2 were rewritten in batches of 15 around one small idea each (the first steps, the village,
  the kitchen and the feast, the smithy, the sea and harbour, animals and pets, colours and the garden, mountains,
  ice and night, and more), with the words recycled on purpose. The rebuild goes on in the 3.x releases. The tree has
  422 trails and 1,661 steps in a quest tree 22 trails deep; the word catalog has about 1,300 concepts.
• A grammar ladder that teaches. Each Korean level has one instruction ending: level 1 -아/어요, levels 2 and 3
  -(으)세요, levels 4 to 6 -아/어야 해요. You read at most one level above the grammar you have met; a new
  construction shows a two-line rule card once, the journal has a grammar book, and the review quiz has grammar cloze
  cards. Hints always stay at level 1.
• New things to do. Trails now ask you to craft, smelt, give, put into a chest, hold while doing something, do
  things in a sequence ("before", "after", "and then"), avoid something, place things next to or between other things
  or in a wall, cross or stair pattern, light a candle, breed animals, trade (the direction of 에게서 / 에게 is
  checked), write on a sign, hear a bell or a jukebox, wait, swim, lie down, mount, take out, go in and out, put
  armour on, shear, dye and tie animals, and jump from a height onto snow. Every sentence still says every condition.
• A real review scheduler. Reviews use FSRS-6 instead of the seven-step ladder, with a retention setting and 5, 10
  or 15 new words a day. Cards are multiple choice with four options, self-graded recall, syllable tiles and, for
  stable words, typing with a 두벌식 keyboard (also on QWERTZ). The streak is gentle: a weekly goal of four days
  and two automatic freezes a month. Mastery needs recall on three study days.
• Reading and people. A Books tab with graded stories (a word must be known to 98% before a story opens) and
  eight culture notes; villagers you sneak-click talk Korean, with speech-level choices (반말 to a child, 합쇼체 to a
  librarian). Verbs get their forms from a morphology engine; the word list shows Sino-Korean families.
• Pronunciation in brackets. Where the spelling hides the sound, the card shows the sound in Hangul
  (횃불 [홰뿔]). There is no romanisation.
• Four interface languages. English, German, Spanish and French (see below).
• Privacy is unchanged. No network code, no telemetry. The optional research export is manual only, hashes ids
  and shows a consent text.

Languages shipped

Language	Interface	Quest text	State
English	complete	complete	the source language
Deutsch	complete	about 88%	proofread (Gemini draft, Claude second pass)
Español ...

Hangul Quest 3.0.0-rc.7

New in rc.7: new kinds of quests, ready for level 4.

• Shooting and throwing: hit a target block or a creature with a bow, crossbow, trident, snowball or egg
  (활로 과녁을 맞히세요), some from far away or with one arrow through two mobs.
• Compass directions: walk north, south, east or west (북쪽으로 이십 블록 가세요), or face a direction while doing
  something.
• "Don't" works on creatures too: 주민을 물리치지 마세요.
• More natural numbers: heights and distances use Sino-Korean numbers (높이 백 블록), and counts up to 99 use native
  numbers (스물네 개).
• Sequences no longer repeat the same object twice, and swimming in the ocean reads 바다에서 수영하세요.
• Six flavour lines from the last two batches now state plain facts.

New in rc.6: level 3 is complete.

• All 108 level-3 trails are rebuilt, and nearly half of their steps now depend on the Korean form.
• The last two batches are small mood trails: miners and smiths, caves and gems, forest herbs, foxes and bees. There
  are also three watchtowers.
• Finale lines were tightened after review: no plans, and no claims the quest doesn't check.

New in rc.5:

• Explorers: a spyglass on a mountain, music in the meadow, leather boots on powder snow, a cloud city, an
  observatory, the far north.
• Wonders of the world: the world market, a giant tree, a pyramid, a harbour, the pirate's chest, desert and
  jungle temples, a desert town.
• Level 3 meets its grammar goal: more than a third of its steps now depend on the Korean form (before/after,
  "don't").
• French covers every rebuilt trail, proofread.

New in rc.4: two more level-3 batches.

• The village heroes: curing a zombie villager, the iron golem, the raid patrol, enchanting, the ender eye, diamond
  gear, and the trade, post and fishing guilds.
• The hunter: bow, crossbow, spear and shield, night hunts, the wolf.

Finale lines across levels 3 and 4 now claim only what the quest checks. Pouring water reads 붓다, and rails laid in
a row read 깔다.

New in rc.3: the second level-3 batch: the first diamond, the jewellers' guild, amethyst and the crystal smithy,
the mine with rails and a minecart, the respawn anchor, wither skeletons and the bastion. The first four level-4
trails arrive with it (brewing, a stronger potion, a beacon base, the skull tower), using the level-4 ending
-아/어야 해요.

New in rc.2: the first level-3 batch. The way into the Nether is rebuilt: obsidian, the portal, piglins and
gold, the fortress and blaze rods, the bastion, striders, crying obsidian and ancient debris. Level 3 brings
"before" and "after" (-기 전에, -(으)ㄴ 후에), "don't" (-지 마세요) and "can" (-(으)ㄹ 수 있어요). The Nether
branch now starts after the lava-bucket trail. Several BATCH-015 finale lines were corrected so they claim only
what the quest checks.

Hangul Quest 3.0 rebuilds the curriculum around what a player does in the world, replaces the old review ladder
with a real spaced-repetition scheduler, and opens the Korean text to review by native speakers. It needs
Minecraft 26.3, Fabric Loader 0.19.5+, Fabric API 0.162.0+26.3 and Java 25, like 2.1.0.

Before you update (read this)

• Your progress is kept. Words, review state, streak, achievements, finished and started trails, the quest log
  and the options are all converted when you first start 3.0. Nothing is reset.
• Saves are converted and backed up. Progress is now stored per Minecraft account in
  config/hangulquest/profiles/<account-id>/progress.json (schema 4). The first time a profile opens, your old
  config/hangulquest/progress.json is copied into it; the old file is never moved, changed or deleted. Before
  an old-format file is converted the mod also writes progress.v<N>-backup-<time>.json next to it, and daily and
  weekly copies are kept in backups/. A word's old level stays in the file, and its new review card starts from
  it (a word you had marked known starts at 30 days), so nothing comes due all at once. config.json is upgraded
  in place (version 5).
• Trails that were rebuilt keep their state. The curriculum was rebuilt trail by trail. Finished trails stay
  finished; a renamed trail, step or word is mapped to its new id, and retired content is flagged, never deleted.
• How to roll back. Close the game, put the 2.1.0 jar back into mods/, and delete
  config/hangulquest/config.json (it is rebuilt with defaults). 2.1.0 reads the untouched
  config/hangulquest/progress.json, so you are back where you were before updating. What you learned in 3.0 stays
  in the profiles/ folder and is not carried back. To go back to a state inside 3.0, copy one of the backup files
  over the profile's progress.json. A copy of the whole config/hangulquest/ folder made before updating is the
  safest rollback of all.
• Release candidate. This is a pre-release. Please report anything that looks wrong.

For players

What changes in play

• Windows stay until you close them. The hint, rule cards, culture notes, word cards, banners, toasts, the
  quiz prompt, the next-quest popup and the completion cards no longer time out. One press of the hint key (H)
  closes exactly one window, the top one; waiting windows show a "+N" badge; a repeat is not queued twice. Closing a
  window is never a hint and never changes grading. Each window shows its key ([H] 닫기 · close) and none covers
  the crosshair or the hotbar. Settings → Auto-close windows brings back the old timeouts (off by default).
• The game fills your quest log. Three regular quests that fit the start of the game, and a fourth slot that
  follows where you are (a snow trail in the snow, a cave trail underground). When you finish one, the next one
  follows. Quests you tick yourself are never replaced, and a quest you take out stays out for 30 minutes of play.
  Settings → Pick quests automatically turns this off.
• A readable quest tree. The tree shows what matters now: trails you can start, the ones in your log and,
  greyed out, those waiting directly behind them. Finished trails fold into one "완료 · Completed" button, and
  Show all trails shows the whole map. A locked trail says what it is waiting for. There is also a second view by
  life situation (house, fire and light, field, animals, ...).
• A welcome screen and the Hangul prerequisite. The first time you join a world, a short screen asks whether
  you can read Hangul and, if not, points to free lessons. The mod teaches words and grammar, not the alphabet.
  Skip it, ask to be reminded once, or switch it off; it never blocks a quest. It stays in the journal's Info tab.
• The curriculum was rebuilt. The 420 trails of 2.x were mostly generated and repeated themselves. Over 200
  trails of levels 1 and 2 were rewritten in batches of 15 around one small idea each (the first steps, the village,
  the kitchen and the feast, the smithy, the sea and harbour, animals and pets, colours and the garden, mountains,
  ice and night, and more), with the words recycled on purpose. The rebuild goes on in the 3.x releases. The tree has
  422 trails and 1,661 steps in a quest tree 22 trails deep; the word catalog has about 1,300 concepts.
• A grammar ladder that teaches. Each Korean level has one instruction ending: level 1 -아/어요, levels 2 and 3
  -(으)세요, levels 4 to 6 -아/어야 해요. You read at most one level above the grammar you have met; a new
  construction shows a two-line rule card once, the journal has a grammar book, and the review quiz has grammar cloze
  cards. Hints always stay at level 1.
• New things to do. Trails now ask you to craft, smelt, give, put into a chest, hold while doing something, do
  things in a sequence ("before", "after", "and then"), avoid something, place things next to or between other things
  or in a wall, cross or stair pattern, light a candle, breed animals, trade (the direction of 에게서 / 에게 is
  checked), write on a sign, hear a bell or a jukebox, wait, swim, lie down, mount, take out, go in and out, put
  armour on, shear, dye and tie animals, and jump from a height onto snow. Every sentence still says every condition.
• A real review scheduler. Reviews use FSRS-6 instead of the seven-step ladder, with a retention setting and 5, 10
  or 15 new words a day. Cards are multiple choice with four options, self-graded recall, syllable tiles and, for
  stable words, typing with a 두벌식 keyboard (also on QWERTZ). The streak is gentle: a weekly goal of four days
  and two automatic freezes a month. Mastery needs recall on three study days.
• Reading and people. A Books tab with graded stories (a word must be known to 98% before a story opens) and
  eight culture notes; villagers you sneak-click talk Korean, with speech-level choices (반말 to a child, 합쇼체 to a
  librarian). Verbs get their forms from a morphology engine; the word list shows Sino-Korean families.
• Pronunciation in brackets. Where the spelling hides the sound, the card shows the sound in Hangul
  (횃불 [홰뿔]). There is no romanisation.
• Four interface languages. English, German, Spanish and French (see below).
• Privacy is unchanged. No network code, no telemetry. The optional research export is manual only, hashes ids
  and shows a consent text.

Languages shipped

Language	Interface	Quest text	State
English	complete	complete	the source language
Deutsch	complete	about 88%	proofread (Gemini draft, Claude second pass)
Español	complete	about half	proofread (Gemini draft, Claude second pass)
Français	complete	about a third	proofread (Gemini draft, Claude second pass); the rest of the quest text falls back to English

A text a language lacks is shown in English, never in German. The quest itself is always Korean. Coverage is measured
against all 6,068 rows of the current content and moves with every new content batch. No translation has been
approved by a native speaker yet.

The optional voices pack

"H...