Epic Core API

EpicCoreAPI

This mod provides entity manipulation APIs and commands based on CoreMod (ITransformationService), Java Agent, and Mixin technologies, plus a set of feature modules: BossShow, entity extensions, Blender GLB models and animation, block extensions, item extensions, screen filters, the ECA shader generator, custom factions, and custom raids. Note that while the entity-manipulation methods may share names with vanilla logic, the underlying implementation is completely different. For example, the set health API can modify entities using custom health values (including but not limited to entity data, numeric fields, and hash tables); the remove API performs low-level Minecraft container cleanup; the set invulnerable API provides a more powerful implementation than vanilla creative mode invulnerability. Additionally, this mod unlocks vanilla attribute limits to Double.MAX_VALUE by default. You can disable this in the config file with "Unlock Attribute Limits" option.

The original intent of this mod is to provide developers with simplified entity manipulation APIs while achieving a certain level of strength under the premise of ensuring performance and compatibility. Therefore, please do not use this mod for mod power comparisons or endless code arms races. Additionally, in modpack survival environments, it is best to ensure that the Attack and Defence Radical Logic config options are disabled.

This mod also provides an MCreator plugin for MCreator users to conveniently use the APIs in this mod.

Usage for Players

Players can use the following /eca commands (requires permission level ≥ 2):

• /eca setHealth <targets> <health> [report] - Set entity health. Add report to write one structured <entity>_health_report_<timestamp>.txt file per living target directly under logs/; the report includes the health-model judgment, channel outcome, delayed verification, complete per-source dataflow inversion trace, and related background analysis.
• /eca setMaxHealth <targets> <maxHealth> - Set entity max health (reverse-calculates attribute base value)
• /eca setInvulnerable <targets> <true|false> - Set entity invulnerability
• /eca lockHealth <targets> true <value> - Lock entity health at specific value
• /eca lockHealth <targets> false - Unlock entity health
• /eca lockMaxHealth <targets> true <value> - Lock entity max health at specific value
• /eca lockMaxHealth <targets> false - Unlock entity max health
• /eca banHealing <targets> true [value] - Ban healing for entities (value optional, defaults to current health)
• /eca banHealing <targets> false - Unban healing for entities
• /eca hurt <targets> <amount> - Force entity damage (vanilla hurt first, forced write when the health loss does not land; kill credit goes to the executor when run by a living entity)
• /eca kill <targets> - Kill entities
• /eca remove <targets> [reason] - Remove entities from world
• /eca memoryRemove <targets> - DANGER! Requires Attack Radical Logic config. Remove entities via LWJGL internal channel
• /eca teleport <targets> <x> <y> <z> - Teleport entities
• /eca lockLocation <targets> <true|false> [x y z] - Lock/unlock entity location
• /eca cleanBossBar <targets> - Clean up boss bars
• /eca allReturn <targets> <true|false> - DANGER! Requires Attack Radical Logic config. Enable/disable return transformation on all boolean and void methods of the mod file owning the target entity, retransforming its already-loaded classes. Vanilla entities (players included) own no transformable mod file, so the target falls back to the mod files owning their equipped items
• /eca allReturn global <true|false> - DANGER! Enable/disable global AllReturn for all non-whitelisted mods
• /eca banSpawn <targets> <seconds> - Ban spawning of selected entities' types for specified duration
• /eca banSpawn clear - Unban all spawns in current dimension
• /eca setForceLoading <targets> <true|false> - Enable/disable force chunk loading for entities
• /eca setInvulnerable show_all - Show all invulnerable entities
• /eca entityExtension get_registry - Show entity extension registry
• /eca entityExtension get_active - Show active entity extension types in current dimension
• /eca entityExtension get_current - Show the currently effective entity extension
• /eca entityExtension clear - Clear active entity extension table and all global effects in current dimension
• /eca entityExtension set_skybox <preset> - Set global skybox shader preset
• /eca setFilter <targets> true <type> - Apply a screen filter to players (type: sketch, spotlight, matrix, rain, desert, snow, toxic, cosmos)
• /eca setFilter <targets> false - Remove all active filters from players
• /eca bossShow edit - Open the in-game cinematic editor (switches to spectator mode)
• /eca bossShow exit - Exit the editor and restore the previous game mode
• /eca bossShow list - List all loaded cutscenes
• /eca bossShow play <viewer> <target> <id> - Force-play a cutscene
• /eca bossShow stop <viewer> - Stop the viewer's current cutscene
• /eca bossShow reload - Reload all cutscene JSON definitions from disk
• /eca bossShow clearHistory <player> - Clear a player's "already seen" records
• /eca shaderGenerator - Open the in-game shader preset generator
• /eca resurrection start - Start the resurrection daemon thread
• /eca resurrection stop - Stop the resurrection daemon thread
• /eca resurrection status - Show daemon thread state and revival/check counts
• /eca resurrection add <targets> - Add entities to resurrection tracking (auto-revived on death every poll cycle)
• /eca resurrection remove <targets> - Remove entities from resurrection tracking
• /eca resurrection list - List all tracked entities with container integrity status
• /eca resurrection check <target> - One-shot container integrity check for an entity