ModsFinder

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.

NeoForgeClient and serverMIT LicenseOpen source1.21.1

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

  1. In-world handwriting input

    Players write characters inside input circles placed in the world, and the recognizer reads what was drawn.

  2. Chinese character recognition

    An ONNX-based model identifies handwritten Chinese characters and passes each recognized glyph to event hooks.

  3. Ink staves

    Ink staves come in several material tiers, each with durability, repair and upgrade metadata.

  4. Addon API

    An official Java API under com.aozainkmc.api lets addon mods attach marks, respond to recognized glyphs and select targets.

Compatibility

Latest build for each game version and loader.

No stable releases
Every published file is a beta or alpha build.
1.21.10.1.1-alpha.1
ReleaseBetaAlphaNot available

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?

Yes. Glyphbound: Hanzi Magic requires aozaink, which provides the handwriting recognition and ink staves that the addon builds on.

Does aozaink work on Fabric or Forge?

No. The mod is published for NeoForge on 1.21.1 only, so it cannot be installed on other loaders or versions.

Do players need aozaink if the server runs it?

Yes. Servers that run it need every player to install it too.

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

All projects

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…
Aozaidev, on the Modrinth page

Official listing

Owner
Aozaidev
Published
2026-05-24
Updated on Modrinth
2026-05-31
Facts verified
2026-10-15

Tags