Skip to main content

Natural Chat

Players talk in Minecraft chat, the AI answers. No slash commands to memorize.

CraftyAI Natural Chat

How it works​

A player types a message that contains one of the AI's aliases (or the configured prefix). The AI reads the message and responds in chat for everyone to see.

The default aliases are crafty, craftyai, ai, and helper. You can change or add to the list in your config.

A few examples​

Player: crafty how do I find diamonds?
Crafty: Strip mine between Y -50 and Y -64. Branch mining is more efficient
        if you want to avoid lava.

Player: @ai what is this biome?
Crafty: You're in a Mangrove Swamp. Watch for mud and mangrove propagules
        in shallow water.

Player: helper, where is the nearest village?
Crafty: Running /locate... Found a village 380 blocks northeast.

Configuration​

You can tune how players trigger the AI:

  • aliases: The names the AI responds to. By default: crafty, craftyai, ai, helper.
  • prefix: An optional character before the alias. With @ as the prefix, players type @crafty to trigger the AI.
  • require-prefix: If true, players must use the prefix. If false, just saying crafty, where's my house? works.
  • fuzzy-match: If true, the AI triggers on misspelled aliases like crafti or craafti.
  • cooldown: How many seconds a player has to wait between questions. Default is 0 on the client and configurable on the server.

What the AI sees​

When you ask a question, the AI gets your chat message plus your current game state:

  • Your biome and coordinates
  • Your health, hunger, and armor
  • Your main hand item
  • The time of day and weather
  • Recent chat from the same player (last few messages)

That context lets it answer questions like "is it safe to fight this creeper" without you having to explain what you're holding or where you are.

Private questions​

If you want to ask something only you can see, use /ask:

/ask How do I craft a brewing stand?

The AI replies to you privately. Nobody else in the chat sees the question or the answer.

Asking the AI to do something​

The AI can change the time, give you items, scan nearby blocks, and so on. You don't use a slash command for that, just ask in chat:

crafty, make it day
ai, scan the nearby area
helper, give me 64 stone

The AI figures out what you want and does it. Some actions need permissions, see the Server Admin Guide for details.