Heraldry is a Minecraft plugin that gives players and factions a coat of arms, and puts it in the world where people can see it.
Vanilla banners can express a few dozen layered patterns. Real heraldry cannot be expressed that way — a proper coat of arms has charges, divisions and tinctures that no banner pattern set covers. Heraldry solves this by rendering arms onto Minecraft maps, which are the one surface a vanilla client will display an arbitrary image on. Arms can be imported from Armoria, the open coat-of-arms generator, or from any image.
It is designed to sit alongside Medieval Factions, so a nation's arms belong to the nation.
This plugin was proposed from a Kingdom: First Era player request on 2026-09-04 ("Needs patterns coat of arms flags for medieval Minecraft" / "We can use Armoria flag for coat of arms").
Pre-implementation. No code yet. The scope of the first release is defined in MVP.md.
- Import a coat of arms from an image, including one exported from Armoria
- Render it to a Minecraft map item that any vanilla client can see
- Assign arms to a player or to a Medieval Factions faction
- Reissue a faction's arms to any member
Not yet released. Once there is a build, installation will follow the usual DPC pattern: drop the jar in plugins/ and restart. It will also be available through Dan's Plugin Manager.
- Medieval Factions — lets arms belong to a faction rather than only to a player.
- MVP – Scope of the first release, and its deliberate non-goals
USER_GUIDE.md, COMMANDS.md, CONFIG.md and CHANGELOG.md land with the first release, per DOCUMENTATION_PRACTICES.md.
You can find the support Discord server here.
Please fill out a bug report here.
This repository follows the standards in dpc-conventions. CONTRIBUTING.md arrives with the build tooling.
This project is licensed under the GNU General Public License v3.0.
See the LICENSE file for full details.