Commit 0c33541e by Jonathan Thomas

Updating README with local llm and Minecraft Forge install instructions

parent ccb3655c
...@@ -9,6 +9,7 @@ All notable changes to **CreatureChat** are documented in this file. The format ...@@ -9,6 +9,7 @@ All notable changes to **CreatureChat** are documented in this file. The format
### Added ### Added
- New automated deployments for Modrinth and CurseForge (GitLab CI Pipeline) - New automated deployments for Modrinth and CurseForge (GitLab CI Pipeline)
- Death messages added for all named creatures except players and tamed ones (RIP) - Death messages added for all named creatures except players and tamed ones (RIP)
- Added Minecraft Forge installation instructions
### Fixed ### Fixed
- Parse OpenAI JSON error messages, to display a more readable error message - Parse OpenAI JSON error messages, to display a more readable error message
......
...@@ -18,10 +18,19 @@ ...@@ -18,10 +18,19 @@
Ready to deepen your Minecraft journey with meaningful conversations and enduring friendships? Ready to deepen your Minecraft journey with meaningful conversations and enduring friendships?
**Step into the world of CreatureChat 🗨 and spark your first conversation today!** **Step into the world of CreatureChat 🗨 and spark your first conversation today!**
## Installation ## Recommended Installation (with Fabric)
1. **Install Fabric Loader & API**: Follow the instructions [here](https://fabricmc.net/use/). 1. **Install Fabric Loader & API**: Follow the instructions [here](https://fabricmc.net/use/).
1. **Install CreatureChat Mod**: Download and copy `creaturechat-*.jar` and `fabric-api-*.jar` into your `.minecraft/mods` 1. **Install CreatureChat Mod**: Download and copy `creaturechat-*.jar` and `fabric-api-*.jar` into your `.minecraft/mods` folder.
folder. 1. **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.
## OR
## Forge Installation (with Sinytra Connector)
1. **Install Forge:** Download [Forge Installer](https://files.minecraftforge.net/), run it, select "Install client," and launch Minecraft with the Forge profile.
1. **Install Forgified Fabric API:** Download [Forgified Fabric API](https://curseforge.com/minecraft/mc-mods/forgified-fabric-api) and copy the `*.jar` into your `.minecraft/mods` folder.
1. **Install Sinytra Connector:** Download [Sinytra Connector](https://www.curseforge.com/minecraft/mc-mods/sinytra-connector) and copy the `*.jar` into your `.minecraft/mods` folder.
1. **Install CreatureChat Mod**: Download and copy `creaturechat-*.jar` into your `.minecraft/mods` folder.
1. **Create an OpenAI API key**: Visit https://platform.openai.com/api-keys, and use the **+ Create new secret key** button. 1. **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. Copy/Paste your key into the `/creaturechat key set <YOUR-SECRET-KEY-HERE>` command.
...@@ -59,6 +68,13 @@ the OpenAI developer API does not extend any free models or free usage. You will ...@@ -59,6 +68,13 @@ the OpenAI developer API does not extend any free models or free usage. You will
consumed and generated. We use the `gpt-3.5-turbo` model by default, due to its extremely low cost 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. and fast performance... however it is not free.
## Free Local LLM
CreatureChat fully supports **free & open-source** LLMs. An HTTP endpoint which supports the OpenAI Chat Completion
JSON syntax is required. We highly recommend using [Ollama](https://ollama.com/) or [LiteLLM](https://litellm.vercel.app/) as your HTTP proxy.
LiteLLM supports **100+ LLMs** (including Anthropic, VertexAI, HuggingFace, Google Gemini, and Ollama), and proxies them through a
local HTTP endpoint in a compatible format with CreatureChat. *NOTE: You must have a very expensive GPU to run a local
LLM on your computer at a speed which is fast enough to be playable in Minecraft.*
## Screenshots ## Screenshots
![Interact with Minecraft Creatures](src/main/resources/assets/creaturechat/screenshots/salmon-follow.png) ![Interact with Minecraft Creatures](src/main/resources/assets/creaturechat/screenshots/salmon-follow.png)
![Panda Following the Player](src/main/resources/assets/creaturechat/screenshots/panda-follow.png) ![Panda Following the Player](src/main/resources/assets/creaturechat/screenshots/panda-follow.png)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment