Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Privacy

Hangul Quest is built so that the question “what does it send?” has a short answer: nothing.

No network

  • No telemetry, no analytics, no crash reporting, no update check.
  • No sockets are opened, no HTTP client exists in the jar. You can run it with the network cable pulled.
  • Quests are verified from the client’s own view of the world. Nothing is requested from the server and nothing is reported to it.

The welcome screen and the journal’s About reading Hangul page list a few external Hangul lessons. A link opens in your browser only when you click it and confirm Minecraft’s own “open this link?” screen. The mod itself never contacts those sites.

What is stored locally

FileContent
config/hangulquest/config.jsonyour settings
config/hangulquest/profiles/<account>/progress.jsonwords met, review schedule, due dates, streak days, achievements, trail state
config/hangulquest/profiles/<account>/reviews.ndjsonthe review log: one line per answer or encounter (word, time, how you answered, how long it took, where it happened)
config/hangulquest/profiles/<account>/probes.jsonwhich words are set aside as held-out probes, and when (see below)
config/hangulquest/vocab/lute-vocab.csvyour Lute export — read, never written
config/hangulquest/questlines/*.jsonthe questlines (shipped copies plus your own)

That is all. There is no account, no identifier, no machine fingerprint.

The review log

The scheduler needs to know what you answered and when, so the mod keeps a log next to your progress. It is a plain text file you can open, copy or delete. Each month’s lines are packed into reviews-YYYY-MM.ndjson.gz in the same folder. The log stays on your computer: nothing in the mod reads it to send it anywhere, and it holds no name, no chat and no coordinates. If progress.json is ever lost, the log can rebuild the review schedule. Deleting it only costs you that safety net and your own history.

Research export

Hangul Quest can help find out what actually makes Korean stick, but only if you choose to take part. Nothing happens by itself. Everything below stays on your computer unless you share a file by hand.

  • Held-out probes. About one in twenty words that you know well enough to be asked less often is set aside: it gets no reviews for a while. After 7 and 30 days it is asked once as a plain four-option question, and the answer is written to the review log. This tells us what you remember when nothing helps you. Which words are set aside is worked out from your install’s random key, so it is the same every time.
  • Word experiments. Some settings are compared word by word: half of the words use one review setting and half another (for example a desired retention of 85% or 90%). Which setting a word has is worked out from the same random key. The review log notes it in its arm field. If you change the retention yourself in the journal settings, your choice wins.
  • Vocabulary check. The journal’s first page has an optional 3-minute Yes/No vocabulary check. It is never required. Words you say you know are scheduled for a quick check in a few days.
  • Export research data. The journal settings have a button that writes config/hangulquest/hangulquest-research-<date>.zip. It contains your review log with every word id replaced by a hash made with a random key that is created for that export and then thrown away (so the ids cannot be turned back into words and two exports cannot be matched), and a consent.txt in English and German that says what is inside. There are no player, account, world, server or chat names, no coordinates, no settings and no quest names. The times in it are real. The mod never sends the file; if you want to take part, attach it yourself where the project asks for it. If you do not, delete it.

Logs

The mod logs with the [hangulquest] prefix: which trail started, which file was reloaded, which questline failed to parse. It does not log chat, player names, server addresses or coordinates. If you attach a log to an issue, check it anyway — Minecraft’s own log lines around it do contain your instance path.

Screenshots

The screenshots in this repository and in the guide were taken in a clean test world. If you post a screenshot of a quest and would rather not show your coordinates or your server’s chat, crop them; the mod’s own UI never draws either.

Lute

The import reads a file you exported and does not talk to Lute or to any server. If you disable Lute-Import in the journal, nothing is read at all.

Changes

This page describes 3.0.0. If a future version ever needs the network for anything, it will be opt-in, documented here and in the changelog before it ships.