Emaki Series

English

简体中文

English

简体中文

Appearance

Emaki SeriesPaper RPG Plugin Suite

A Paper 1.21.8+ / Java 25 RPG plugin suite. Install only the modules you need; CoreLib unifies actions, GUI, item sources, PDC data, and presentation rebuilds.

Getting Started
Architecture

Check CoreLib first

Every business module depends on CoreLib. Understand item sources, actions, GUI, PDC, expressions, and economy before editing module YAML.

Put attributes in PDC

Attribute defines stats, resources, damage types, and conditions. Equipment stats should be written as PDC payloads, not only as lore text.

Equipment is layered

Item, Forge, Strengthen, and Gem write separate layers. CoreLib rebuilds the final name, lore, attributes, and display state.

Read levels, skills, and stations separately

Level manages multi-type progression and exp sources. Skills manages triggers and cooldowns. Cooking manages world stations and result branches.

Emaki Series Documentation ​

Emaki Series is a set of installable Paper RPG modules. CoreLib provides the shared action, GUI, item-source, PDC, and presentation systems. Business modules add attributes, items, forging, strengthening, gems, levels, skills, cooking stations, codex advancements, and GUI storage.

Who should read this documentation ​

  • Server owners and configurators: installation order, YAML fields, commands, permissions, and troubleshooting.
  • Gameplay designers: equipment growth, materials, strengthening stages, gems, skills, and cooking stations.
  • Developers: CoreLib actions, GUI, item source, PDC, assembly layers, and Attribute APIs.
  • Maintainers: module boundaries, runtime dependencies, and debugging entry points.
  1. Read Introduction to decide which modules to install.
  2. Read Getting Started to build, install, and verify the plugins.
  3. Before writing YAML, read CoreLib for item sources, actions, conditions, expressions, and GUI.
  4. For equipment progression, read Attribute → Item → Forge / Strengthen / Gem.
  5. For progression and gameplay systems, read Level, Skills, Cooking, Codex, and Storage separately. They solve different problems.

Module overview ​

ModuleRoleTypical use
EmakiCoreLibShared foundationStart here: actions, GUI, item sources, PDC, expressions, economy, structured presentation.
EmakiAttributeAttribute and combatDefine stats, resources, damage types, conditions, and public attribute APIs.
EmakiItemCustom itemsGenerate stable item IDs, base attributes, skills, sets, and triggers.
EmakiForgeForgingUse blueprints and materials to modify equipment or create new results.
EmakiStrengthenStrengtheningHandle star upgrades, success rates, materials, failure penalties, and protection.
EmakiGemGemsManage sockets, opening, inlay, extraction, upgrades, and resonance.
EmakiLevelLevel progressionManage multiple level types, exp sources, requirements, PDC, placeholders, and MythicMobs exp drops.
EmakiSkillsSkillsManage active/passive triggers, cooldowns, resource costs, and MythicMobs execution.
EmakiCookingCooking stationsManage chopping board, wok, grinder, steamer, oven, juicer, and fermentation barrel.
EmakiCodexCodex and advancementsDefine vanilla advancement pages and nodes in YAML, granted by commands, CoreLib actions, the public API, or event triggers.
EmakiStorageGUI storageHold long-scale amounts per slot while preserving the original item, with capacity from config, permissions, command grants, and paid expansion, plus search and sorting.