Aozai Ink MC is a foundation mod for handwritten Chinese glyph systems in Minecraft.

It provides the technical base for addon mods that want to use handwriting recognition as a gameplay input. By itself, Aozai Ink MC does not add spells, combat abilities, dungeons, or progression content. Content mods define what each recognized glyph actually does.

What it provides

In-world handwriting input circles
ONNX-based Chinese character recognition
Self-cast and world-anchored writing modes
Ink stave items with multiple material tiers
Stave durability, repair, progression, and upgrade metadata
InkMark state records for addon mods
Official Java addon API under com.aozainkmc.api
Event hooks for recognized glyphs, attached marks, and block target selection
A two-step block selection flow for mechanics such as seals or remote targeting

Who this is for

This mod is mainly for:

Players installing addon mods that require Aozai Ink MC
Modpack makers who want glyph-based addon content
Developers building mods around handwritten Chinese characters

If you install only Aozai Ink MC, you will get the handwriting system and ink staves, but not a full spell system. For actual gameplay content, install an addon mod that depends on it.

Current limitations

Current gameplay flow is focused on singleplayer / integrated worlds.
The addon API is in its first public alpha and may change during early versions.
Recognition depends on the bundled ONNX model and supported character labels.