![\"mod-logo\"](\"https:\/\/raw.githubusercontent.com\/sailex428\/SecondBrain\/refs\/heads\/main\/logo.png\"){kind=logo}
<\/p>\n<\/p>\n
A Fabric mod that brings intelligent NPCs to your minecraft world. Create player-like characters controlled by LLMs that respond to your chat messages and perform basic player actions.<\/p>\n
**This mod works fully serverside. It must also be installed on a client for setup.**<\/p>\n
## Requirements<\/p>\n
– **Minecraft Version**: 1.20.1\/1.21.1
\n– **Running Ollama server OR Player2 App OR an OpenAi Key**<\/p>\n
## Mod Installation<\/p>\n
1. **Download the Mod**:
\n – Get the latest version of the `SecondBrain` mod from the Modrinth page.
\n2. **Install the Mod**:
\n – Place `secondbrain.jar` in your `mods` folder on your minecraft fabric server and client.
\n3. **Launch Minecraft**:
\n – Start the Minecraft client and the server, and you’re ready!<\/p>\n
## Usage with Ollama\/OpenAi<\/p>\n
>Note: Player must be an operator to execute the following commands<\/p>\n
### GUI
\n– Open the gui with the `\/secondbrain` command and create\/spawn, despawn\/delete or edit the NPCs there.
\n– Also edit the base configuration there.<\/p>\n
### ~~Commands (Deprecated)~~
\n>~~Warning: This command uses default ollama\/openai settings!~~<\/p>\n
1. **~~Spawn NPCs~~**: **Interact with NPCs**: ## Setup Ollama 2. **Install and Run Ollama**: 3. **Connect to the Mod**: ## Setup OpenAi (Paid) ## Usage with Player2 App<\/p>\n >The mod will automatically sync the selected Characters from the player2 App to NPCs in your singleplayer world. **Interact with NPCs** ## Setup Player2 (Free, Limited) 2. **Start the App and select Characters** ## License<\/p>\n This project is licensed under the LGPL-3.0 ## Credits Thank you to the developers of these projects for their amazing work!<\/p>\n","protected":false},"excerpt":{"rendered":" AI-powered NPCs that chat and play like real players<\/p>\n","protected":false},"featured_media":136807,"template":"","meta":{"_minecraft_slug":"secondbrain","_minecraft_project_id":"CfgaDAdq","_minecraft_author":"sailex","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":20941,"_minecraft_follows":91,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"secondbrain.zip","_minecraft_size_bytes":611939024,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-16T22:00:37.434372Z","_minecraft_date_created":"2024-11-12T04:25:07.773024Z","_minecraft_date_modified":"2026-04-18T22:12:56.078059Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/secondbrain","_minecraft_icon_attachment_id":136807,"_minecraft_imported_at":"2026-06-08T01:59:40+00:00","_minecraft_import_hash":"10a25a7c8ee6afc20cc2f0389d3bd611","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,97,867,123],"mod_loader":[99],"minecraft_version":[36,93,94,37,40,41,74,81],"class_list":["post-136806","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-fabric","mod_category-social","mod_category-technology","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-3","minecraft_version-1-21-8"],"yoast_head":"\n
\n – ~~Use the `\/secondbrain add
\n2. **~~Remove NPCs~~**:
\n – ~~Use the `\/secondbrain remove
\n– Just write in the chat to interact with the NPC.<\/p>\n
\n### Ollama (Local LLM)
\n1. **Download Ollama**:
\n – Visit Ollamas Website and download the installer for your operating system.<\/p>\n
\n – Follow the setup instructions to install.
\n – Start Ollama and ensure it’s running in the background.<\/p>\n
\n – Use the gui to create\/edit an NPC and put in the address to your ollama server (complete url with http:\/\/…;
\n if you’re running your ollama on your local pc then you can just use the one that’s already typed in)<\/p>\n
\n1. **Create API Key**
\n – Visit OpenAi’s website, sign up\/log in and create a API key
\n – Copy the created key
\n2. **Use the Key in the mod**
\n – Open the GUI and create an NPC with the LLM Type `OPENAI` and paste key into the Key field. (The key wont be ever shared with any other clients that has access to the GUI, also not your client. It will be saved in a secondbrain config file on the server)<\/p>\n
\nIf you updated a description\/name in the player2 App you can sync these changes with the command `\/secondbrain player2 SYNC`
\nIt’s not possible to change any configs from the Character with this mod.<\/p>\n
\n– Write messages in the chat or directly to a specific NPC
\n– Press and hold alt (win) or opt (macOS) key to talk directly to the LLM\/AI
\n– Activate Text-To-Speech for any NPC in the config gui to hear the LLM\/AI output<\/p>\n
\n1. **Download Player2 App**
\n – Visit player2’s website and download the App for your operating system.<\/p>\n
\n – Start the downloaded App and select the Characters you wanna use as NPCs<\/p>\n
\n## Disclaimer<\/p>\n
\nThis project utilizes components from the following projects:
\n– fabric-carpet
\n– automatone
\n– player2<\/p>\n