EmakiLevel

View Full Wiki Documentation | Join Discord Community | QQ Group

EmakiLevel is the level and multi-experience-type module of the Emaki plugin family. It stores long-term player progression outside the vanilla experience bar, allowing servers to maintain main level, combat, mining, fishing, crafting, brewing, smelting, taming and other level tracks at the same time.

The plugin connects experience sources, upgrade requirements, upgrade rewards, PDC sync, PlaceholderAPI, CoreLib Actions, MythicMobs integration and EmakiAttribute stat contribution into one configurable progression system. It is suitable for RPG servers, profession systems, life skills, combat progression, quest rewards and cross-plugin experience rewards.

Functional modules

• Multiple level types: Each types/*.yml file defines an independent level type with display name, description, start level, max level, auto/manual upgrade, PDC and stat contribution settings.
• Experience source rules: Configure sources for kills, mining, gathering, mature crops, fishing, crafting, brewing, furnace extraction, taming and MythicMob kills.
• Requirement curves: Use global, group or type-specific formulas, or exact required experience values per target level.
• Upgrade flow: Supports automatic upgrades after gaining experience and manual /elv levelup, with economy costs, material costs, item rewards and CoreLib Actions.
• Player data storage: Stores each player's level, current experience, total experience and update time in data/<uuid>.yml.
• PDC sync: Writes level, experience, total experience, required experience and progress to online player PDC.
• Attribute contribution: When EmakiAttribute is installed, level formulas can contribute real RPG stats.
• MythicMobs integration: Supports MythicMob kill sources and non-item experience drops named emakilevel_exp or elv_exp.
• Placeholders and rankings: Provides %emakilevel_*% placeholders and cached rankings for scoreboards, menus and external displays.
• Web Console entry: Lets CoreLib Web Console edit main config, level types, source rules, GUI templates and language files.

Main features

• Create independent progression tracks for main level, combat level and profession or life-skill levels.
• Add, disable or remove level types through configuration as long as referenced type IDs stay consistent.
• Use %key% variables in experience formulas, including event context such as entities, blocks, result amount and MythicMob level.
• Use anti-abuse tracking to avoid repeated experience from player-placed blocks.
• Let administrators add, remove or set experience and levels, or reset a player's data for one type.
• Reward level experience from EmakiCooking, EmakiForge, scripts, quests or other systems through CoreLib Actions.
• Expose level, experience, required experience, progress percentage and rankings through PlaceholderAPI.
• Refresh PDC and EmakiAttribute stat contribution when level data changes.

Commands and permissions

/emakilevel (aliases /elv, /elevel) is used to view level information, manually level up, view rankings, manage player experience and levels, reload configuration and debug requirements or PDC sync.

Basic access permission is emakilevel.use. Common player permissions include emakilevel.levelup and emakilevel.top. Administration permissions include emakilevel.reload, emakilevel.debug and emakilevel.admin. All subcommands check emakilevel.use first, so administration commands should be limited to trusted staff.

Configuration and management

EmakiLevel creates the plugins/EmakiLevel/ directory, commonly including config.yml, requirements.yml, types/, sources/, gui/level_gui.yml, lang/, web-console.yml and data/<uuid>.yml.

A typical setup starts with types/, requirements.yml and sources/: decide which level tracks the server needs, configure the requirement curves, then define which events grant which type of experience. If real stat progression is needed, configure attributes.values in types/<type>.yml and install EmakiAttribute.

Compatibility and installation

• Install only EmakiLevel-1.0.0.jar on the server.
• EmakiCoreLib is required and must load first.
• Do not place emaki-level-api-*.jar in the plugins folder; API jars are developer compile dependencies.
• MythicMobs can provide mob kill experience and non-item experience drops.
• EmakiAttribute can convert level formulas into real stat contribution.
• PlaceholderAPI can display level, progress and ranking information in scoreboards, menus and chat formats.
• EmakiCooking, EmakiForge and other modules can reward level experience through CoreLib Actions.

Information