Getting Started
This page helps server administrators quickly understand the deployment process and recommended activation order for Emaki Series.
Requirements
| Item | Requirement |
|---|---|
| Java | 25 or higher (GraalVM recommended) |
| Server | Spigot 1.21+ (or compatible forks such as Paper) |
| Runtime Libraries | Adventure, exp4j, BoostedYaml (automatically loaded by CoreLib via plugin.yml libraries) |
提示
When deploying EmakiCoreLib 3.2.0 for the first time, make sure the server allows downloading runtime libraries via plugin.yml libraries, or prepare the corresponding library cache in advance.
Recommended Activation Order
Follow this order to enable modules step by step, minimizing troubleshooting effort:
Step 1: Infrastructure and Attribute Layer
- EmakiCoreLib — Hard dependency for all modules, must be installed first
- EmakiAttribute — Attribute and combat system, provides the numerical foundation for subsequent equipment progression
Verification: Confirm CoreLib loads correctly, and Attribute definitions and combat calculations work properly.
Step 2: Equipment Progression Loop
- EmakiForge — Forging system
- EmakiStrengthen — Strengthening system
Verification: Confirm forging recipes execute correctly, and the strengthening process and star-level progression work properly.
Step 3: World Interaction and Gem Progression
- EmakiGem — Gem system
- EmakiCooking — Cooking system
Verification: Confirm gem inlaying/extraction/upgrading processes work correctly, and cooking stations are interactable.
Step 4: Active Skill System
- EmakiSkills + MythicMobs content packs
注意
EmakiSkills is a skill management layer; the actual skill effects are handled by MythicMobs configurations. Skills can still be enabled without MythicMobs, but actual skill casting will fail.
Module Dependency Matrix
| Module | Hard Dependencies | Soft Dependencies |
|---|---|---|
| EmakiCoreLib | — | Vault, ExcellentEconomy, PlaceholderAPI, MMOItems, ItemsAdder, Nexo, NeigeItems, CraftEngine |
| EmakiAttribute | EmakiCoreLib | MythicMobs, PlaceholderAPI, MMOItems |
| EmakiForge | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiStrengthen | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiCooking | EmakiCoreLib | CraftEngine, ItemsAdder, Nexo |
| EmakiGem | EmakiCoreLib | EmakiAttribute, PlaceholderAPI |
| EmakiSkills | EmakiCoreLib | MythicMobs, EmakiAttribute, PlaceholderAPI |
Command Quick Reference
| Module | Root Command | Aliases |
|---|---|---|
| EmakiAttribute | /emakiattribute | /eattribute, /ea |
| EmakiForge | /emakiforge | /eforge, /ef |
| EmakiStrengthen | /emakistrengthen | /estrengthen |
| EmakiCooking | /ecooking | /ec |
| EmakiGem | /emakigem | /egem, /eg |
| EmakiSkills | /emakiskills | /eskills |
Default Resource Locations
Each module's configuration and resource files are automatically extracted to the server's plugins/<module-name>/ directory on first startup:
| Module | Main Resource Directories |
|---|---|
| EmakiCoreLib | config.yml, lang/ |
| EmakiAttribute | attributes/, conditions/, damage_types/, lore_formats/, profiles/, config.yml |
| EmakiForge | recipes/, gui/, lang/, config.yml |
| EmakiStrengthen | recipes/, gui/, lang/, config.yml |
| EmakiCooking | recipes/, gui/, lang/, item_adjustments/, config.yml |
| EmakiGem | gems/, items/, gui/, conditions/, lang/, config.yml |
| EmakiSkills | skills/, resources/, gui/, lang/, config.yml |
Upgrade Notes
- Back up custom configurations, language files, and default resource copies before upgrading
- Migrate all custom vanilla item/block sources to
minecraft-xxx,mc-xxx,v-xxx, or bare ID format - Migrate custom presentations to
structured_presentation - For detailed upgrade instructions, see the Changelog