@NPCKeys 4 MinAI

[stnfnk]

@NPCKeys 4 MinAI

View File

---

This is a quality of life mod for MinAI. If you don't have MinAI (and CHIM), you don't need this mod.

 

Remember that these are simply messages to your AI-enabled populace mapped to hotkeys, how they respond is entirely up to your LLM and the rest of your context. These are not direct controls. Customizing the messages is highly recommended.

 

@NPCKeys 4 MinAI allows you to assign custom keybinds and chat commands to specific AI-enabled NPCs, empowering advanced AI interactions and immersive roleplay scenarios. You can register up to 10 NPCs, configure up to three individual keybinds per NPC, and customize the messages they receive on hotkey. MinAI NoActions, NoSexActions, and NoNSFWActions Factions are also exposed per NPC and can be toggled. @lastSpeaker and @everyone group messages are also available.

 

This beta release is intended for wider testing and feedback. Please report any bugs or suggestions!

 

*Tip for VR users: VRIK allows you to use VRIK Gestures to "emulate hotkey". I have right-touchpad + gesture right assigned to emulate Hotkey 3, then use that to bind Hotkey 3 to "Start Looting" message. Initial tests are very promising!

 

There are also a number of other Hotkey enhancement mods that will probably work well with this mod. Let me know if you have a favorite and if it needs any special handling.

 

Requirements: 

• CHIM
• MinAI
• SKSE64  
• PapyrusUtil  
• Papyrus Extender  
• Papyrus Tweaks NG

Features

• Register up to 10 NPCs for custom keybinds and chat commands.
• Customize messages in JSON files
• MCM Integration:
  • Manage NPC Registry and individual NPC settings.
  • Toggle faction membership: MinAI No Actions, No Sex Actions, No NSFW Actions Factions.
  • Send group messages on hotkey - @everyone.
  • Send messages to last speaker on hotkey - @lastSpeaker.
  • Assign keybinds for a simple RequestResponse and/or up to two additional custom messages for each NPC.
  • Choose from a list of pre-defined or customize (in JSON) messages for each custom keybind.
  • Esc to unbind hotkeys.
  • Clear all hotkeys and registry reset options.
  • Toggle on-screen notifications and debug logging.
  • Set default preferences for 'Send as'.
  • Enable RegisterEvent for @everyone page (Custom message as event to everyone, no response request)
  • Backup/Restore NPC Registry
  • Import/Export Configuration Settings
  • Uninstall button

Usage

• Target AI-enabled NPC in crosshair
• Open the **MCM** (Mod Configuration Menu) in-game.
• Use the "Add NPC to registry" button.
• Toggle factions, assign keybinds, select messages and style (Send as Player, Narrator, or Dungeon Master) for each NPC.
• Use your assigned keys in-game to send chat commands to registered NPCs.
• Check Context_sent_to_llm.log to see exactly what your hotkey is doing.
• This mod just injects custom messages into context on hotkey and requests response. The LLM will respond however it wants. Experiment!
• Enable Debug Logging in MCM and check Papyrus.0.log for troubleshooting.
• NPC and keybind data is stored in `NPCKeys4MinAI.json` for easy backup and editing.

Customizing Messages

• Edit `CustomMessages.json`, `GroupMessages.json`, and `CustomEvents.json` to add or change available messages. Edit anytime, re-open MCM to refresh.
• Each message now has a `label` (for MCM display), a `message1stp` (Player/Narrator style), and a `message3rdp` (Dungeon Master style).

Example:

json
{
  "label": "Start Looting",
  "message1stp": "Start looting the area now.",
  "message3rdp": "starts to loot the area."
}

`label`: The action name shown in the MCM.

`message1stp`: Used for Player and Narrator chat types (direct request, e.g., "Start looting the area now. (Talking to {npc})").

`message3rdp`: Used for Dungeon Master chat type (third-person, e.g., "{npc} starts to loot the area.").

 

How chat types use these fields:

• Player: Sends `message1stp` to the NPC as chatnf.
• Narrator: Sends `message1stp` as a narration (e.g., "The Narrator: Start looting the area now. (Talking to Lydia)").
• Dungeon Master: Sends `message3rdp` using the Dungeon Master direct message (e.g., "Lydia starts to loot the area.").

Uninstallation

• Reset the NPC Registry (this removes all NPCs from registry and unregisters all keybinds).
• Use the Uninstall button in MCM and then save.
• Remove the mod from your load order.
• Remove mod files.

Credits

• MinAI Team
• CHIM Team
• SKSE Team
• Expired6978 (PapyrusUtil)
• Ryan (Papyrus Extender, Papyrus Tweaks NG)
• SkyUI Team (MCM framework)
• All testers and contributors

License

This mod is provided as-is for beta testing. Do not redistribute without permission.

---

• Submitter
  stnfnk
• Submitted
  05/03/2025
• Category
  Adult Mods

 

[stnfnk]

This beta test adds @gameDirector, along with @everyone and @lastSpeaker to the top slots in NPC Registry.

 

@gameDirector has its own CustomDirector.json for custom messages and three hotkey slots to assign. I just copied the CustomEvents.json for a default placeholder, customize the messages to your needs.

 

Messages @gameDirector -> toggles on CHIM Director Mode (godmode), sends the message directly to CHIM, toggles off CHIM Director Mode (if it wasn't already on). This is for The latest updates of CHIM and just exposes the direct calls so you don't have to toggle or type all the time for repeated messages you want on hotkey. I haven't successfully tested this because I'm on the previous CHIM, let me know if it works!

 

EDIT: Moved file to main downloads as v0.92

 

Edited June 11, 2025 by stnfnk

[Fraying9981]

Hi, any chance this may be compatible with CHIM 1.0.2? (Jan 20225)

[stnfnk]

5 minutes ago, Fraying9981 said:

Hi, any chance this may be compatible with CHIM 1.0.2? (Jan 20225)

 

Use v0.91, there is no CHIM Director Mode earlier than 1.3.3, I think.

 

Or just ignore the @gameDirector panel and json.

Edited June 15, 2025 by stnfnk

[Fraying9981]

On 6/15/2025 at 5:36 PM, stnfnk said:

 

Use v0.91, there is no CHIM Director Mode earlier than 1.3.3, I think.

 

Or just ignore the @gameDirector panel and json.

 

 

thanks, it seems to be working by the notification logs.

I noticed two things:

1. by default the some hotkeys are active: handjob & let's relax. I was wondering why people relaxed all the time

2. wait here doesn't work for me, for @everyone. however if i type normally something like *Follower is to use wait here command* to one follower it does work. I'm using deepseek v3

[stnfnk]

15 hours ago, Fraying9981 said:

 

 

thanks, it seems to be working by the notification logs.

I noticed two things:

1. by default the some hotkeys are active: handjob & let's relax. I was wondering why people relaxed all the time

2. wait here doesn't work for me, for @everyone. however if i type normally something like *Follower is to use wait here command* to one follower it does work. I'm using deepseek v3

 

All the hotkeys should be Esc by default. If something is bound, you can unbind with Esc.

 

You can change the text in the json to whatever you type normally that works. Then the hotkey for @everyone will send your message to the nearest AI NPC or the one you are facing/pointing at.