Subscribe to download
AI NPCs

This mod integrates OpenAI's ChatGPT into Barotrauma, aiming to increase immersion by enabling NPCs to respond via an AI chat system.
Please note that this mod is currently a work-in-progress.

• Lua for Barotrauma
  
• An API key from an AI chat provider (e.g., OpenAI)

Uses OpenAI and the latest ChatGPT 4o mini model (note: this is a paid service).
Configuration can be adjusted to use free models like the 7b model from OpenRouter (Documentation Here[openrouter.ai]). Keep in mind that free models often have lower rate limits, which may be insufficient for extended gameplay.

Include Lua for Barotrauma and AI NPCs in your active mods list via Settings and click Apply.

1. Install client-side Lua by following this guide: Lua Installation Guide.
   
2. Start the game.
   
3. Press ESC and use the AI NPCs Options menu to enter your API key. Click 'Done' when finished.

1. Set the Server Executable to Lua for Barotrauma when starting your server.
   
2. Press F3 to open the console.
   
3. Use "ai_setconfig APIKey <key>" to set your API key.
   
4. Use "ai_listconfig" to view all of the settings and their current values.

To use an alternative model, modify the API endpoint and model configuration settings.
In Singleplayer, this can be done through the AI NPCs Options menu.
In Multiplayer, use the "ai_setconfig APIEndpoint <url>" and "ai_setconfig Model <name>" console commands.

For example, to use MythoMist 7b through OpenRouter:

1. ai_setconfig APIEndpoint https://openrouter.ai/api/v1/chat/completions
   
2. ai_setconfig Model gryphe/mythomist-7b:free

Compatible with Single Player and Multiplayer modes (Campaign, Mission, Sandbox).

In Multiplayer, only the server needs to set up the API information.

To interact with an NPC, type "!" followed by the NPC's name and your message. For example: !artie how are you doing?

Token usage ranges from 200 to 4000 per interaction. Adjust token usage with "ai_setconfig SessionTokenCap <amount>" to manage costs effectively.

All F3 console commands are viewable by running the "help" command. They are all prefixed with "ai_" and support TAB autofilling for certain parameters like configuration settings and NPC names. There are commands for modifying individual NPC's personalities, such as "ai_giverandomprofile <name>".