Getting Started

This page explains how to build, install, start, and verify Emaki Series.

Requirements

Item	Requirement
Java	25
Server	Spigot / Bukkit 1.21+; current plugin descriptors declare Folia support
Build tool	Maven
Required base module	EmakiCoreLib

Build

From the project root:

mvn -DskipTests package

Default aggregated modules are CoreLib, Attribute, Forge, Strengthen, and Cooking. When the private-modules profile is available, Gem, Skills, and Item can also be aggregated.

Recommended installation order

1. EmakiCoreLib.
2. EmakiAttribute if attributes, combat, resources, or attribute payloads are needed.
3. Equipment modules: EmakiItem, EmakiForge, EmakiStrengthen, EmakiGem.
4. Gameplay modules: EmakiSkills, EmakiCooking.
5. Optional ecosystem plugins: PlaceholderAPI, Vault or ExcellentEconomy, MythicMobs, CraftEngine, ItemsAdder, Nexo, MMOItems.

First start

1. Put the required plugin jars into plugins/.
2. Start the server and let the plugins generate default files.
3. Stop the server or ensure no players are using the systems.
4. Edit generated files under plugins/Emaki*/.
5. Start again and check the console.
6. Use module commands to verify that the systems are available.

Troubleshooting basics

• If business modules cannot start, check CoreLib first.
• If YAML fails to load, check indentation, quotes, enum values, and field names.
• If PlaceholderAPI, Vault, or MythicMobs features do not work, confirm the external plugin is installed and loaded.
• For equipment issues, inspect real PDC data instead of trusting Lore only.