MCAI

Quick rating

MCAI

No reviews yet

MCAI is a mod that serves as an intermediary between Minecraft and Character AI.

QoL & Tweaks
Mod Loaders
Fabric
Quilt
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
mcai-v2-1.21
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

MCAI - Minecraft (Character) Artificial Intelligence

Have you ever played Minecraft alone? Well, let me tell you something - it gets very lonely, very quickly when you're all alone in a vast blocky world and the only human-ish thing in the game just makes 'hrm' and 'huh' noises. This mod aims to alleviate that by providing you access to your very own AIs for you to chat with.

Setup

MCAI requires setup to work properly. This is because c.ai, like most websites, requires an authorization token before it gives you any data.

Luckily, obtaining your authorization token is simple.

First, head to c.ai. Log in or create a new account.

Then, open Inspect Element, navigate to Application, find Local Storage -> https://beta.character.ai

Once you're there, you will need to find a key called char_token. This should be a JSON file with two keys; value and ttl. You can ignore the ttl key; you only need the value key.

Copy the value of the value key, go to either the mod config (mcai.toml) and locate [General], where you will find the authorization field in which you can paste the value of value. Then you're good to go! Alternatively, you can use the /ai authorize <token> command in-game to automatically update the configuration file.

To register an AI to chat with, you can manually edit the configuration file, or you can use the command /ai register <character id> <aliases (optional)>. The aliases field is an optional space-separated list of alternative names to ping the AI with in chat, sort of like a nicknames system for the AI.

The character id field is used to get basic information about the character (like their name) and also as a way to know which character to send messages to. You can obtain the character ID of a character by going to c.ai, opening a chat with the character you want the ID from, and then copying the value of char= from the URL.

Chatting with registered AIs

There are two methods to chat with registered AIs - pinging them in a message via @<AI's name/alias> or via the /ai talk <name> <text> command. [insert gif of chatting with an AI here]

Commands

/ai authorize <token> - an admin-only command that changes the access token the mod uses to interface with c.ai in-game.

/ai context <name> <broadcast (optional)> - retrieves the last few messages from the chat with the AI. Note that changing the format in the MCAI config may or may not cause it to fail when retrieving the name of the message sender. As the command defaults to only giving you context, broadcast is an available option for admins to broadcast the last few messages to everyone in chat.

/ai disable <name> - like /ai unregister, but less permanent.

/ai enable <name> - undoes /ai disable.

/ai list - lists all available AIs and relevant information (such as whether they're enabled, and their aliases).

/ai register <character id> <aliases (optional)> - character ID is the ID obtained from the c.ai website. Registers an AI so that you can chat with 'em.

/ai unregister <character id> - permanently removes an AI.

/ai reload - reloads the mod's config so that any edits made with an external tool are loaded without requiring a complete restart of Minecraft.

/ai reset <name> - wipes the memory of an AI.

/ai talk <name> <text> - alternative to pinging the AI that's arguably more clunky.

FAQ

Q: Is this mod client-side?

A: Nope! This mod is fully server-side. You can look at the development of the client-side port here.

Q: How do I talk with an AI?

A: Read this!

Q: I don't like the AIs randomly responding to my messages! How do I stop them from doing that?

A: You can disable random responses by switching the disableRandomResponses to true in the config's general section.

Q: Will you make a Forge port?

A: Nope! You're welcome to port it yourself, if you really want it on Forge, though.

MCAI - Minecraft (Character) Artificial Intelligence

Have you ever played Minecraft alone? Well, let me tell you something - it gets very lonely, very quickly when you're all alone in a vast blocky world and the only human-ish thing in the game just makes 'hrm' and 'huh' noises. This mod aims to alleviate that by providing you access to your very own AIs for you to chat with.

Setup

MCAI requires setup to work properly. This is because c.ai, like most websites, requires an authorization token before it gives you any data.

Thankfully, obtaining your authorization token is simple.

First, head to c.ai. Log in or create a new account.

Then, open Inspect Element, navigate to Application, find Local Storage -> https://beta.character.ai

Once you're there, you will need to find a key called char_token. This should be a JSON file with two keys; value and ttl. You can ignore the ttl key; you only need the value key.

Copy the value of the value key, go to either the mod config (mcai.toml) and locate [General], where you will find the authorization field in which you can paste the value of value. Then you're good to go! Alternatively, you can use the /ai authorize <token> command in-game to automatically update the configuration file.

To register an AI to chat with, you can manually edit the configuration file, or you can use the command /ai register <character id> <aliases (optional)>. The aliases field is an optional space-separated list of alternative names to ping the AI with in chat, sort of like a nicknames system for the AI.

The character id field is used to get basic information about the character (like their name) and also as a way to know which character to send messages to. You can obtain the character ID of a character by going to c.ai, opening a chat with the character you want the ID from, and then copying the value of char= from the URL.

Chatting with registered AIs

There are two methods to chat with registered AIs - pinging them in a message via @<AI's name/alias> or via the /ai talk <name> <text> command. [insert gif of chatting with an AI here]

Commands

/ai authorize <token> - an admin-only command that changes the access token the mod uses to interface with c.ai in-game.

/ai context <name> <broadcast (optional)> - retrieves the last few messages from the chat with the AI. Note that changing the format in the MCAI config may or may not cause it to fail when retrieving the name of the message sender. As the command defaults to only giving you context, broadcast is an available option for admins to broadcast the last few messages to everyone in chat.

/ai disable <name> - like /ai unregister, but less permanent.

/ai enable <name> - undoes /ai disable.

/ai list - lists all available AIs and relevant information (such as whether they're enabled, and their aliases).

/ai register <character id> <aliases (optional)> - character ID is the ID obtained from the c.ai website. Registers an AI so that you can chat with 'em.

/ai unregister <character id> - permanently removes an AI.

/ai reload - reloads the mod's config so that any edits made with an external tool are loaded without requiring a complete restart of Minecraft.

/ai reset <name> - wipes the memory of an AI.

/ai talk <name> <text> - alternative to pinging the AI that's arguably more clunky.

FAQ

Q: Is this mod client-side?

A: Nope! This mod is fully server-side. You can look at the development of the client-side port here.

Q: How do I talk with an AI?

A: Read this!

Q: I don't like the AIs randomly responding to my messages! How do I stop them from doing that?

A: You can disable random responses by switching the disableRandomResponses to true in the config's general section.

Q: Will you make a Forge port?

A: Nope! You're welcome to port it yourself, if you really want it on Forge, though.

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

~5,000
Total Downloads
CurseForge
~2,000
Modrinth
~2,000
Last Updated
CurseForge
Modrinth
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works