Skip to the content

Kumimoji組み文字

Build crosswords from seeded English or Japanese tile bags, alone or at a shared table.

Kumimoji means assembled characters in Japanese. About the name

Contents

How-to

Load and judge with word lists

Load word lists in the browser or on the server, judge a layout with them, and keep their notices.

Separate browser and server loading

The core does not bundle both dictionaries. In browsers loadTileWords dynamically imports the selected dictionary; in Node import the words entry before loading. tileWords is synchronous and throws if the selected list has not loaded. A check without words must not claim a word is valid.

import {loadTileWordsFromModule} from "@johnmorrisdotca/kumimoji/words";
import {judgeWithWords,tileWordsReady} from "@johnmorrisdotca/kumimoji";
const words = await loadTileWordsFromModule("english");
const tiles = new Map([["0,0","c"],["0,1","a"],["0,2","t"]]);
console.log(tileWordsReady("english"),judgeWithWords(tiles,words).sound);
true true

Use the language mappings

TileWords has allowed words, encoded words by length, physical mix, glyph/reading conversions and wildcard/family functions. Prefer judgeWithWords rather than judging internal kana codes as visible text. tileWordsReady reports whether the selected language is cached. readTileWordsWith is a loader hook; configure it before the first load because already loaded lists remain cached.

Preserve the data notices

The English and Japanese data have their own notices, distinct from MIT code. NOTICE.md and the existing licence table preserve the terms and attribution. Generated dictionaries are changed through their source workflow, not edited by hand.

What the Japanese list leaves out

Children play this game, so the Japanese list leaves out readings that are not for them. A reading is out when every JMdict entry that spells it has a vulgar, X-rated, sensitive or derogatory mark on its first meaning, or a first meaning that names a sex act, a sex organ or the sex trade (a meaning that only mentions sex, as 性別 "gender" does, never bars). A short list of readings that are obscene in themselves is out too (まんこ, うんこ, おっぱい, ちんこ, れいぷ). JMdict's release of 2026-11-04 gives 1,266 such lines, and the list holds 162,324. A reading that an ordinary word is also spelt like stays, because the tiles play ば and ぱ as は, except the listed ones (れいぷ plays as れいふ, 霊符). The list is written by Kotoba's scripts/word-lists-ja.mjs with the rule in its scripts/children-bar.mjs; it is not edited by hand here, and a test holds the known bad readings out.

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/kumimoji 1.6.0.