Skip to content

Commands and Permissions

The main command of EmakiCoreLib is /emakicorelib, with /corelib and /emakicore as aliases. These commands are mainly for server administrators: reloading CoreLib, running config prechecks, inspecting JavaScript extensions, listing or executing registered Actions, and debugging loop Action tasks.

Commands

CommandPermissionDescription
/corelib reloademakicorelib.reload or emakicorelib.adminReload CoreLib configuration, the Action system, and JavaScript runtime. If precheck fails, the previous config remains active.
/corelib check [module|report|--fix]emakicorelib.adminRun config prechecks, check one module, or show the latest report. --fix is currently read-only and does not apply automatic fixes.
/corelib script listemakicorelib.adminList global JavaScript scripts and current script extension registrations.
/corelib script inspect <script>emakicorelib.adminShow which extension entries were registered by one JavaScript file.
/corelib script reloademakicorelib.adminReload Action / JavaScript related systems.
/corelib action listemakicorelib.adminList registered Actions with id, category, source, owner, execution mode, and parameter names.
/corelib action run <actionId> key=value ...emakicorelib.adminExecute one currently registered Action. /corelib action <actionId> key=value ... is also accepted as shorthand.
/corelib debug all [on|off|status]emakicorelib.adminToggle the global Debug switch at runtime. Without an argument it behaves as status. A reload restores the configured debug.global_all value.
/corelib debug loops [list|player|key|cancel|cancel-player]emakicorelib.adminInspect active loop Action tasks and cancel them by key or player.
/corelib helpnoneShow subcommand help. Also shown when no argument or an unknown subcommand is given.

The action subcommand may also be written as actions; both are equivalent.

Permissions

PermissionDefaultDescription
emakicorelib.reloadopAllows CoreLib reload.
emakicorelib.adminopAdministrative fallback permission; includes emakicorelib.reload.

Common operations

Reload CoreLib

text
/corelib reload

Use this after changing CoreLib configuration, language files, Actions, or scripts. Reload runs a config precheck first; if the precheck fails, the currently active configuration is kept.

Run config prechecks

text
/corelib check
/corelib check report
/corelib check corelib

check validates configuration references, Action templates, item sources, and CoreLib-related settings. report shows the latest precheck report. Passing a module id checks only that module.

Inspect JavaScript extensions

text
/corelib script list
/corelib script inspect examples/hello.js
/corelib script reload

Use these commands to inspect global scripts, script extension registrations, and reload status. See JavaScript for the full scripting system.

List and execute registered Actions

text
/corelib action list
/corelib action run sendmessage text="hello"

action list shows what is currently registered in the Action registry. action run parses <actionId> key=value ... as a normal Action line, so parameters, quoting, @if, @chance, and @delay follow the same rules as Action lines in configuration files. Console execution has no player context, so Actions that require a player fail through normal Action validation.

Debug loop Actions

text
/corelib debug loops list
/corelib debug loops player Steve
/corelib debug loops key some-loop-key
/corelib debug loops cancel some-loop-key
/corelib debug loops cancel-player Steve

These commands are for troubleshooting or cleaning up loop Actions. Do not keep large-scale loop task debugging enabled on production servers longer than necessary.

Toggle global Debug

text
/corelib debug all status
/corelib debug all on
/corelib debug all off

This has the same effect as temporarily overriding debug.global_all in config.yml and affects every Emaki module that uses CoreLib's DebugLogger. The toggle is not written back to the config file; /corelib reload restores the configured value.