aozaink
by Aozaidev
aozaink is a NeoForge foundation library for handwritten Chinese glyphs, letting addon mods read characters drawn by the player in the world.
What it does
Players draw Chinese characters inside in-world handwriting input circles, and an ONNX-based recognizer identifies the glyph. Recognized glyphs are passed to event hooks, where addon mods decide what each one does. Self-cast writing modes anchor the writing to the world, so a glyph can be placed where the player is looking rather than only held in the hand.
The mod itself adds no spells, combat abilities, dungeons or progression. It provides the technical base that addon mods use for handwriting recognition as a gameplay input, and content mods define what a recognized glyph actually does. An official Java addon API lives under com.aozainkmc.api, and InkMark state records which addon mods are attached to a world or target.
Installing aozaink alone gives the handwriting system, ink staves in several material tiers, and their durability, repair and upgrade metadata, but no gameplay content. The library is required by Glyphbound: Hanzi Magic, which depends on it for its actual content. The environment is client and server, so the server and every player need the mod. aozaink is open source under the MIT License and is published for NeoForge on 1.21.1 only, with 0.1.1-alpha.1 as the latest alpha file from 2026-05-31.
Key features
In-world handwriting input
Players write characters inside input circles placed in the world, and the recognizer reads what was drawn.
Chinese character recognition
An ONNX-based model identifies handwritten Chinese characters and passes each recognized glyph to event hooks.
Ink staves
Ink staves come in several material tiers, each with durability, repair and upgrade metadata.
Addon API
An official Java API under com.aozainkmc.api lets addon mods attach marks, respond to recognized glyphs and select targets.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Required by 1 mod
Use cases
Who it’s for: Mod developers who want a handwriting recognition input for their own gameplay, and server owners running addon mods that depend on it. Players who only want the library itself will find it has no gameplay content on its own.
Questions
Does Glyphbound: Hanzi Magic need aozaink installed?
Does aozaink work on Fabric or Forge?
Do players need aozaink if the server runs it?
In the catalog
aozaink is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.
More from Aozaidev
Similar mods
What the author says
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…
Official listing
- Modrinth page
- modrinth.com/mod/aozaink
- Owner
- Aozaidev
- Published
- 2026-05-24
- Updated on Modrinth
- 2026-05-31
- Facts verified
- 2026-10-15
