MCOriax Identity Plugin

A robust, high-performance identity management system for Minecraft servers, supporting SpigotMC, PaperMC, and Folia — including native compatibility with Folia's regionalized multi-threading architecture.

Players equip and manage different personas ("Identities"), each characterized by its Profession and Stats. Skills, runes, and cosmetics ship as separate add-ons.

Key features

• Multi-platform: SpigotMC, PaperMC, and Folia from a single shaded engine jar.
• One permanent primary identity per player, plus unlockable alternative base identities browsable in a paginated GUI.
• Selectable storage: SQLite (default), MySQL, PostgreSQL, MongoDB, or the MCIdentity central REST server.
• RAM-cached and fully asynchronous — no blocking work on the game thread.
• Custom MCIdentity*Event types and a public MCIdentityProvider API for third-party plugins.
• Optional read-only AI tools for MCAgents, so players can ask about their own identity and stats.

Quick start

./gradlew build                            # compile every module and run tests
./gradlew :platforms:engine:shadowJar      # build the universal shaded jar

Drop the resulting jar into your server's plugins/ directory and restart. The default SQLite backend needs no configuration.

Documentation

Full documentation lives in wiki/INDEX.md.

Start here:

• Project Overview — what the plugin is and what it deliberately leaves to the add-ons.
• Installation & Setup — getting it running and connecting it to the central server.
• Commands & Permissions — every /identity subcommand and its permission node.

The project website is https://mcoriax.github.io/.

License

See LICENSE.