Skip to content

Action rework#511

Open
RANGROO wants to merge 7 commits intounstablefrom
action_rework
Open

Action rework#511
RANGROO wants to merge 7 commits intounstablefrom
action_rework

Conversation

@RANGROO
Copy link
Copy Markdown
Collaborator

@RANGROO RANGROO commented Apr 28, 2026

⚠️ ALL PR'S MUST BE SUBMITTED TO THE UNSTABLE BRANCH ⚠️


What

  • Reworked the action system so built-in and imported custom actions share one catalog/runtime path.
  • Added metadata-driven action requirements and cooldowns, so actions can be filtered by NPC type, state, activity, and other runtime conditions.
  • Improved custom action import/editing:
    • safer import behavior with import_version
    • editable action config and parameter schema in the Action Editor
    • better filtering/sorting for built-in vs custom actions
    • carriage/ferry allowlists and similar settings moved out of conf.php into action-table config
  • Added support for reusable mod actions through CHIM packages like CHIM-NFF, including renamed/cleaned action names and richer return templating.
  • Added structured NPC activity/status support so prompts and UI can reflect what nearby/current NPCs are doing instead of relying on legacy event text.
  • Added plugin-aware mod/form resolution support using a loaded-plugin manifest, so action requirements and description lookups can safely work with modded records.

Why

  • The previous action flow was split across hardcoded server logic, connector-specific behavior, and ad hoc custom integrations.
  • Custom actions were harder to extend, harder to configure, and easier to break or overwrite on re-import.
  • Prompt action lists were too broad and not state-aware, so NPCs were often offered actions they could not or should not perform.
  • Modded form/faction references were load-order-sensitive, which made action requirements and description resolution unreliable for large modlists.
  • NPC status/context relied too heavily on one-off event text instead of structured game state.

Related PRs

  • Related HerikaAI-NG changes for:
    • structured NPC activity/status sync
    • plugin manifest sync for mod-aware form resolution
    • barter/crafting/consume execution and feedback improvements
  • Related aiagent-aiff changes for:
    • Action/CHIM Papyrus integration updates
    • CHIM-NFF bridge cleanup and action support

Notes

  • This PR is part of the broader action_rework effort and is intended for the unstable branch.
  • import_version is intentionally a simple first-pass safeguard: same-version reimports preserve local edits, while newer imports can still replace them.
  • Action metadata is now the main extension point for requirements, config, parameter templates, and editor behavior.
  • Some CHIM custom actions now depend on corresponding game-side bridge support being present in the deployed mod/plugin stack.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant