Little Whale AI

Quick rating

Little Whale AI

No reviews yet

Little Whale AI (小鲸鱼AI) - Your own AIBot in Minecraft

AI Art
Mod Loaders
Fabric
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

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

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Unsupported
Server Required

About

Project Details

Type
Mod
License
MIT License
Latest Version
1.0.0
Authors

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

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

A lightweight, fully asynchronous Fabric mod that brings a friendly AI player named Little Whale into your Minecraft server. Powered by any OpenAI-compatible API, it can chat with players in private or public, understand context, and speak their language.

✨ Features

  • 3 Chat Modes – Switch between private, public, or mixed mode:
    • Private (mode 1): Players use @ai <message> to talk to the AI. Only the sender sees the reply.
    • Public (mode 2): Every public chat message is treated as conversation with the AI. The AI replies publicly to everyone. Context is globally shared.
    • Mixed (mode 3): @ai triggers private conversation, while normal chat triggers public AI replies. Private and public contexts are kept separate.
    • Player-aware AI – In public/mixed modes, the AI sees who said what via [PlayerName]: message format. It can address players by name naturally.
    • Multilingual – The AI automatically replies in the same language the player used (Chinese, English, etc.).
    • Plain Text Only – The AI is instructed never to use Markdown, code blocks, or special formatting, keeping output clean for the in-game chat.
    • Safe & Non‑blocking – All HTTP requests run on background threads; the server main thread is never blocked.
    • Context Management – Auto-clears conversation history after a configurable interval or manually via commands.
    • Fully Configurable – Change the API endpoint, model, temperature, system prompt, prefix, and more through config/aichat.json.
    • Admin Commands – Powerful /aichat commands to clear contexts, reload config, and view status.

📦 Installation

  1. Install Fabric for Minecraft 1.21.8.
  2. Download the mod .jar file and place it into the mods/ folder.
  3. Launch the server or client. A default configuration file will be generated at config/aichat.json.
  4. Edit config/aichat.json and fill in your apiKey and (optionally) apiUrl. Save the file.
  5. Run /aichat reload (requires OP) or restart the server.

⚙️ Configuration (config/aichat.json)

Key Type Default Description
apiUrl String https://open.bigmodel.cn/api/paas/v4/chat/completions API endpoint (OpenAI-compatible)
apiKey String "" Your API key
systemPrompt String (multilingual, anti-prefix, plain‑text prompt) System prompt that defines AI behavior
modelName String "general" Model name to send to the API
temperature Double 0.7 Creativity of responses (0.0–2.0)
autoClearContext Boolean true Enable automatic context clearing
contextExpireSeconds Integer 300 Seconds between auto‑clears
prefix String "<LittleWhale> " Prefix added to every AI reply (supports color codes)
mode Integer 2 Chat mode: 1 = private, 2 = public, 3 = mixed

🎮 Usage

Chat Triggers

  • Private / Mixed: Start your message with @ai. Example: @ai How do I craft a furnace?
  • Clear private context: @ai clear (works in private/mixed mode)
  • Public mode: Just talk in chat – every message triggers a public AI reply.

Admin Commands (requires OP, permission level 2)

Command Description
/aichat clear Clear your own private context (mode 1/3)
/aichat clear <player> Clear the private context of a specific player
/aichat clearglobal Clear the global public conversation context
/aichat clearall Clear all contexts (private + global)
/aichat reload Reload the configuration without restarting
/aichat info Display current settings (API, model, mode, etc.)

Screenshots

Gallery

  • in Chinese server
    in Chinese server

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

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
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