English
Introduction
Emaki Series is a set of RPG plugin modules for Minecraft 26.1+. You install only the modules you need: CoreLib holds the shared infrastructure, and the business modules add attributes, equipment, strengthening, gems, accessories, levels, skills, crafting and cooking stations, the advancement/category codex, GUI storage, and custom mobs
Technical baseline
| Item | Value |
|---|---|
| Server | Paper 26.1+ (minimum supported: 26.1) |
| API | paper-api:26.1.2.build.74-stable |
| Java | 25 |
| paper-plugin.yml api-version | 26.1 |
| Build system | Multi-module Gradle project (wrapper pins Gradle 9.8.0) |
Modules
| Module | Version | Aggregation | Purpose |
|---|---|---|---|
| EmakiCoreLib | 4.8.36 | default | Shared infrastructure for all business modules |
| EmakiAttribute | 4.8.7 | default | Attributes, resources, damage, conditions, and API bridges |
| EmakiForge | 4.8.8 | default | Forging, blueprint requirements, material contributions, quality, recipe book |
| EmakiStrengthen | 4.8.9 | default | Star strengthening, protection, failure handling, presentation |
| EmakiCooking | 4.3.8 | default | World-based cooking stations |
| EmakiLevel | 1.6.9 | default | Multiple level types, exp sources, requirements, PDC, placeholders, and MythicMobs exp drops |
| EmakiCodex | 1.1.6 | default | Vanilla advancement pages, category-entry codex GUI, unlock/activation/claim state, and CoreLib actions |
| EmakiStation | 1.1.8 | default | General crafting stations, serial queues, paid queue slots, and a standalone dismantling station |
| EmakiGem | 2.8.11 | private-modules | Gems, sockets, opening, inlay, extraction, upgrades |
| EmakiSkills | 2.8.8 | private-modules | Active/passive skills, triggers, resources, MythicMobs bridge |
| EmakiItem | 2.8.16 | private-modules | Custom items, two-level browser GUIs, sets, triggers, auto update |
| EmakiStorage | 1.1.5 | private-modules | Paged GUI warehouse, large per-slot quantities, capacity tiers, paid unlocks |
| EmakiAccessory | 1.1.8 | private-modules | Multi-page isolated accessory slots, orphan retrieval, sets, and attribute/skill contributions |
| EmakiMobs | 1.0.13 | default | Custom mobs, spawn rules, loot tables, and skill behavior |
| EmakiStructure | 1.0.5 | private-modules | Structure template export and placement, multiblock interaction, transaction rollback, and furniture restoration |
| EmakiDungeon | 1.0.2 | default | Party dungeons: instanced worlds, entry limits and difficulty selection, stashed payouts, flow gates, and map editor |
The private-modules gate is the .key marker in the repository root (implemented in settings.gradle, not a Maven profile). When .key exists it adds EmakiSkills, EmakiGem, EmakiItem, EmakiStorage, EmakiStructure, and EmakiAccessory to the build. Without .key, 27 project modules are built; with it, 33 (33/33) :::
Besides the server plugins above, the project also builds one compile-time-only emaki-*-api jar per module. None of them are server plugins, so never put them into plugins/. The emaki.jiuwu.craft.skills.api.pdc package in emaki-skills-api owns the equipment skill PDC codec contract and is shaded and relocated into Item, Forge, Gem, and Strengthen at build time
Why CoreLib exists
Most modules need the same infrastructure: actions, GUI sessions, item-source resolution, PDC storage, economy access, expressions, and structured item presentation. CoreLib centralizes those pieces once, so each business module only has to focus on its own gameplay rules
Common module combinations
- Attribute-only combat: install CoreLib + Attribute. Add PlaceholderAPI, MythicMobs, or MMOItems only if you use those integrations
- Equipment progression: install CoreLib + Attribute + Item + Forge + Strengthen + Gem. Add Accessory for an extra progression line that does not occupy equipment slots
- Level progression: install CoreLib + Level. Add PlaceholderAPI, MythicMobs, Attribute, Cooking, or Forge when progression needs placeholders, mob drops, attributes, or process rewards
- Skill system: install CoreLib + Skills + MythicMobs. Add Attribute, Item, or Level when skills need resources, attributes, equipment unlocks, or level requirements
- Life-skill gameplay: install CoreLib + Cooking. Add Level for cooking/profession exp, and add CraftEngine, ItemsAdder, or Nexo when stations use custom blocks or items
- Production and warehousing: install CoreLib + Station. Add Storage so the warehouse supplies materials and receives outputs, plus Item or Level for custom results and profession exp
- Advancement codex: install CoreLib + Codex. Add PacketEvents for advancement tree coordinate injection, and PlaceholderAPI or MythicMobs for their integrations