EmakiCoreLib Changelog

[1.11.0] - 2026-03-31

New Features

CoinsEngine Economy Support

• Added the GiveCoinsAction action, supporting currency operations for the CoinsEngine economy plugin.
• Action Parameters:
  • amount (required): The amount of currency.
  • currency (required): The type of currency.
• Automatically registered to the built-in action list, supporting templated configuration.
• Requires the CoinsEngine plugin to be installed on the server.

Improvements & Optimizations

Action System Improvements

• All built-in Action IDs have been uniformly changed from underscore format to camelCase format.
  • send_message → sendmessage
  • play_sound → playsound
  • broadcast_message → broadcastmessage
  • send_title → sendtitle
  • send_action_bar → sendactionbar
  • give_money → givemoney
  • take_money → takemoney
  • set_money → setmoney
  • give_exp → giveexp
  • take_exp → takeexp
  • set_exp → setexp
  • set_health → sethealth
  • give_potion_effect → givepotioneffect
  • remove_potion_effect → removepotioneffect
  • clear_potion_effects → clearpotioneffects
  • spawn_particle → spawnparticle
  • run_command_as_player → runcommandasplayer
  • run_command_as_op → runcommandasop
  • run_command_as_console → runcommandasconsole
  • use_template → usetemplate

Enhanced Error Messages

• Improved error messages for missing actions (missingActionResult).
• Automatically detects Action ID format and provides normalization suggestions.
• Example: When using send_message, prompts "Use 'sendmessage' instead".
• Helps developers quickly locate and fix configuration errors.

ActionExecutor Optimization

• Added missingActionResult() method to uniformly handle cases where actions are not found.
• Improved Action ID normalization logic, removing underscores before lookup.
• Optimized error message format to provide clearer migration guidance.

Configuration Changes

Configuration Template Updates

• Action IDs in the example configuration templates have been updated to the new format.
• Comment examples have been synchronized, demonstrating the correct way to configure actions.

Code Improvements

BuiltinActions

• Added registration for GiveCoinsAction.
• Maintained the registration order of other built-in actions.

All Action Implementation Classes

• Updated the return value of the id() method to camelCase format.
• Kept action functionality and parameters unchanged.

Usage Notes

Action ID Migration

• Important: All action configurations must be migrated from underscore format to camelCase format.
• The system will automatically detect and provide migration suggestions, but it is recommended to proactively update configuration files.
• Affected configuration files:
  • Action templates in EmakiCoreLib/config.yml
  • Quality actions in EmakiForge/config.yml
  • Custom action configuration files
  • Action calls in scripts and plugins.

CoinsEngine Integration

• To use the givecoins action, ensure the CoinsEngine plugin is installed on the server.
• CoinsEngine is an optional dependency and does not affect core functionality.
• Clear error messages are returned if the action execution fails.

Compatibility

• Maintains backward compatibility with configuration files from older versions.
• Error prompts will help developers quickly locate issues.
• It is recommended to back up configuration files before upgrading.

Known Issues

• None