Skip to main content

Natural Chat

CraftyAI's core feature is its ability to understand and respond to natural language directly within Minecraft's chat. Players don't need to learn complex commands—they just talk.

How It Works​

To interact with the AI, a player simply types a message in chat that includes one of the AI's aliases (or the configured prefix). The AI will process the message and respond in chat.

Examples​

Player: crafty how do I find diamonds?
Crafty: To find diamonds, you should mine between Y-levels -50 and -64. The most efficient method is strip mining!

Player: @ai what is this biome?
Crafty: You are currently in a Mangrove Swamp biome! Look out for mud and mangrove propagules.

Configuration​

You can customize how players trigger the AI in your config.yml (or craftyai.json):

  • aliases: A list of names the AI responds to (e.g., ["crafty", "craftyai", "ai", "helper"]).
  • prefix: An optional character required before the alias (e.g., @).
  • require-prefix: If set to true, players must use the prefix (e.g., @crafty). If false, just saying "crafty" works.
  • fuzzy-match: If true, the AI will still trigger even if players slightly misspell the alias (like "crafti").
  • cooldown: The delay (in seconds) required between requests from the same player.

Conversation Context​

CraftyAI doesn't just read the text; it reads the game. When a player asks a question, the AI automatically knows:

  • The player's current biome and coordinates
  • Their health and hunger levels
  • Their current inventory and equipment
  • The time of day and weather

This allows for highly contextual answers!

Private Mode (/ask)​

If a player wants to ask a question privately without cluttering the global server chat, they can use the /ask command:

/ask How do I craft a brewing stand?

The AI's response will only be visible to that player.