## Chat with any mob in Minecraft! All creatures can talk & react using AI! ### Features - **AI-Driven Chats:** Using ChatGPT or open-source AI models, each conversation is unique and engaging! - **Behaviors:** Creatures can make decisions on their own and **Follow, Flee, Attack, Protect**, and more! - **Reactions:** Creatures automatically react to being damaged or receiving items from players. - **Friendship:** Track your relationships from friends to foes. - **Multi-Player:** Share the experience; conversations sync across server & players. - **Memory:** Creatures remember your past interactions, making each chat more personal. ### Create meaningful conversations and enduring friendships? A betrayal perhaps? [![CreatureChat Trailer Video](https://cdn.modrinth.com/data/rvR0de1E/images/f148f8602682eec3f116d3dafa06a71b33228afe.png)](https://youtu.be/GdY969Orsh0?si) ### Installation Instructions

Fabric (Recommended)

Fabric Instructions

Install Fabric Loader & API: Follow the instructions here.
Install CreatureChat Mod: Download and copy creaturechat-*.jar and fabric-api-*.jar into your .minecraft/mods folder.
Create an OpenAI API key: Visit https://platform.openai.com/api-keys, and use the + Create new secret key button. Copy/Paste your key into the /creaturechat key set <YOUR-SECRET-KEY-HERE> command.
Launch Minecraft with the Fabric profile.

Forge (with Sinytra Connector)

Forge Instructions

NOTE: Sintra Connector only supports Minecraft 1.20.1

Install Forge: Download Forge Installer, run it, select "Install client".
Install Forgified Fabric API: Download Forgified Fabric API and copy the *.jar into your .minecraft/mods folder.
Install Sinytra Connector: Download Sinytra Connector and copy the *.jar into your .minecraft/mods folder.
Install CreatureChat Mod: Download and copy creaturechat-*.jar into your .minecraft/mods folder.
Create an OpenAI API key: Visit https://platform.openai.com/api-keys, and use the + Create new secret key button. Copy/Paste your key into the /creaturechat key set <YOUR-SECRET-KEY-HERE> command.
Launch Minecraft with the Forge profile.

### In-game Commands

Configure CreatureChat

REQUIRED: /creaturechat key set <key>
- Sets the OpenAI API key. This is required for making requests to the LLM.
OPTIONAL: /creaturechat url set "<url>"
- Sets the URL of the API used to make LLM requests. Defaults to "https://api.openai.com/v1/chat/completions"
OPTIONAL: /creaturechat model set <model>
- Sets the model used for generating responses in chats. Defaults to gpt-3.5-turbo.
OPTIONAL: /creaturechat timeout set <seconds>
- Sets the timeout (in seconds) for API HTTP requests. Defaults to 10 seconds.
OPTIONAL: /creaturechat whitelist <entityType | all | clear> - Show chat bubbles
- Shows chat bubbles for the specified entity type or all entities, or clears the whitelist.
OPTIONAL: /creaturechat blacklist <entityType | all | clear> - Hide chat bubbles
- Hides chat bubbles for the specified entity type or all entities, or clears the blacklist.

Configuration Scope:

OPTIONAL: You can specify the configuration scope at the end of each command to determine where settings should be applied:
- Default Configuration (--config default): Applies the configuration universally, unless overridden by a server-specific configuration.
- Server-Specific Configuration (--config server): Applies the configuration only to the server where the command is executed.
- If the --config option is not specified, the default configuration scope is assumed.

[![How To Install Tutorial Video](https://cdn.modrinth.com/data/rvR0de1E/images/58484fdafb4fc388db0fd7a53b4f384dc0513b84.png)](https://youtu.be/P2txUop_kSM?si=4quU-kubGLBvb8HB) ## Costs & Security Using third-party Large Language Model (LLM) APIs, such as OpenAI, will incur usage-based **fees**. These fees are based on the amount of data processed. Before integrating your API key, please [review the pricing](https://openai.com/pricing#language-models) details provided by the API provider. Be aware of the **potential costs** and plan your usage accordingly to avoid unexpected charges. ## Does OpenAI offer a **FREE** model? While ChatGPT is a popular product and does offer a free version to their users on their website, the OpenAI developer API does not extend any free models or free usage. You will be charged for each token consumed and generated. We use the `gpt-3.5-turbo` model by default, due to its extremely low cost and fast performance... however it is not free. ## Contact & Resources - [Join us on Discord](https://discord.gg/m9dvPFmN3e) - [Documentation](http://gitlab.openshot.org/minecraft/creature-chat) ([Source Code](http://gitlab.openshot.org/minecraft/creature-chat)) - Follow Us: [YouTube](https://www.youtube.com/@CreatureChat/featured) | [Twitter](https://twitter.com/TheCreatureChat) | [TikTok](https://www.tiktok.com/@creaturechat)

jonoomph

CreatureChat