EmakiCoreLib | Script-Powered Modular Plugin Framework

EmakiCoreLib 4.0.0 Release

A major update introducing a JavaScript scripting engine, reversible item modification system, and new built-in actions for the Emaki plugin family.

New Features

• JavaScript Scripting Engine: Execute custom .js scripts via the runjs action (aliases: runscript, javascript). Scripts access player data, trigger context, item info, random utilities, shared state, and action dispatch via the built-in emaki global object. Powered by GraalJS with configurable timeout (default 1000ms), content-hash caching, and security sandboxing.
• dropitem Action: Drop items at specified world coordinates with relative coordinate support and all item source types (vanilla / CraftEngine / ItemsAdder / Nexo).
• placeblock Action: Place blocks at specified coordinates, supporting vanilla and custom blocks. Properly fires BlockPlaceEvent for compatibility with other plugins.
• Item Operation Ledger: Reversible item name/lore modification system stored in item PDC. Supports precise single-operation revert or batch revert by namespace. Provides unified text modification infrastructure for gem socketing, strengthening, forging, etc.
• EmakiAttribute Bridge API: Stable interface for soft-depending on EmakiAttribute — read resources, consume resources, query attribute values, and invoke the damage pipeline.
• Enhanced Condition System: New none_of condition type and nested condition groups (type: group) for combining all_of / any_of / none_of in complex logic.

Improvements

• Config and language files auto-merge new keys on upgrade without manual editing.
• YAML loading errors now show specific error messages and file locations in console.
• Item text read/write uses legacy format for better compatibility with plugins using traditional color codes.

Upgrade Notes

• Config version updated to 4.0.0 with new script section (auto-merged on upgrade).
• Script engine enabled by default; set script.enabled: false to disable.
• Script files are placed in plugins/EmakiCoreLib/scripts/ — categorized subdirectories and example scripts are auto-created on first startup.

View Full Documentation | Join Discord Community | QQ Group