Home›Java›Mods›AI Villager Chat
AI Villager Chat
ModsJava

AI Villager Chat

Java mod listed for Minecraft 1.20. Download on the author's site.

by morwapi · on CurseForge

⬇ Download on CurseForge

Morwapi AI Villager

AI-Powered Autonomous Villagers / AI駆動の自律型村人Mod


✨ What This Mod Does / このModでできること

This mod uses AI to control villagers, making them autonomously follow player instructions. Morwapi AI Villagerは、村人をAIで制御し、プレイヤーの指示に従って自律的に行動させるModです。

Key Features / 主な特徴

🤖 Natural Language Commands / 自然言語で指示

⚒️ Automated Crafting / 自動クラフト

🏗️ Building Support / 建築サポート

💼 Chest Management / チェスト管理

🧠 Memory System / メモリシステム


🇬🇧 English Version

🚀 Quick Start

1. Installation

  1. Install Fabric API
  2. Install Cloth Config API
  3. Place this mod in your mods folder

2. Configuration

In-game: Mod Menu → Morwapi AI Villager → Config

  1. Enter API URL (e.g., https://generativelanguage.googleapis.com/v1beta/models/)
  2. Enter API Key
  3. Set Model Name (recommended: gemini-2.5-flash)

2.1. Get API Key (Free)

Gemini API has a free tier:

  1. Visit Google AI Studio
  2. Sign in with your Google account
  3. Click "Create API Key"
  4. Click "Create new project" to create a new project
  5. Copy the generated API key and paste it into the mod configuration

3. Basic Usage

Spawn Villager

/generate <villager_name>

Example: /generate kein

Give Commands to Villager

Main Method (Recommended):

  1. Look at the villager
  2. Press "V" key (Opens villager inventory screen)
  3. Enter your instruction in the input field at the bottom
  4. Click "Send" button

Alternative (Command):

/control <villager_name> <instruction>

Basic Command Examples:

Advanced Command Examples:


🎯 Core Features in Detail

🔨 Automated Crafting

Villagers can automatically craft 400+ items.

Supported Categories:

Recursive Crafting: When you command "Craft a diamond pickaxe":

  1. Auto-crafts sticks from wood
  2. Crafts pickaxe using diamonds and sticks
  3. Reports any missing materials

🏃 Movement & Following

Look at villager, press "V", and enter:

Follow me
Move to (100, 64, 200)
Wait here

⛏️ Mining

Look at villager, press "V", and enter:

Mine 10 stone
Mine the diamond in front of you

📦 Inventory Management

Look at villager, press "V", and enter:

Get 32 wood from the chest
Put all iron in the chest
Equip diamond sword

🧠 Memory System

Each villager has individual memory that persists after server restart.

Look at villager, press "V", and enter:

Remember my home at (123, 64, 456)
Go back to the home location
Forget the home location

Stored Data:


🎮 Complete Action List

Movement Actions

Action Description Example (via V key)
MOVE Move to coordinates Move to (100, 64, 200)
FOLLOW Follow player Follow me
PATROL Patrol between points Patrol between A and B
STOP Stop movement Stop
JUMP Jump Jump
LOOK Look at direction Look north

Work Actions

Action Description Example (via V key)
MINE Break block Chop tree
PLACE Place block Place stone
CRAFT Craft item Craft sword
INTERACT Interact with block Open door

Inventory Actions

Action Description Example (via V key)
WITHDRAW Take from chest Get diamond from chest
DEPOSIT Put in chest Put iron in chest
EQUIP Equip item Equip sword
DROP Drop item Drop dirt

Communication Actions

Action Description Example (via V key)
CHAT Send chat message Say hello
REMEMBER Save to memory Remember home location
FORGET Delete from memory Forget home location

🛠️ Technical Specifications

System Requirements

Supported AI Providers


⚙️ Advanced Configuration

In-Game Settings

Mod Menu → Morwapi AI Villager → Config

Setting Description Default
API URL API endpoint URL -
API Key API key -
Model Name Model name to use gemini-2.5-flash

Recommended Settings

Gemini (Recommended):

API URL: https://generativelanguage.googleapis.com/v1beta/models/
Model Name: gemini-2.5-flash
API Key: [Your Gemini API Key]

🔧 Troubleshooting

Common Issues

1. Villager Not Responding

Cause: API connection error
Solution:

2. Crafting Fails

Cause: Missing materials or no crafting table
Solution:


📊 Complete Implementation List

✅ Completed Features

Core Systems

AI Features

Villager Actions

Farming System

Crafting System

UI

User Guidance

Memory & Persistence

Advanced Features

Optimizations

Error Handling & Localization


🔮 Future Plans

Under Consideration

---

🇯🇵 日本語版

🚀 クイックスタート

1. インストール

  1. Fabric API をインストール
  2. Cloth Config API をインストール
  3. このModをmodsフォルダに配置

2. 設定

ゲーム内で Mod Menu → Morwapi AI Villager → 設定 から:

  1. API URLを入力 (例: https://generativelanguage.googleapis.com/v1beta/models/)
  2. APIキーを入力
  3. モデル名を設定 (推奨: gemini-2.5-flash)

2.1. APIキーの取得(無料)

Gemini APIは無料枠があります:

  1. Google AI Studio にアクセス
  2. Googleアカウントでログイン
  3. 「Create API Key」をクリック
  4. 「Create new project」をクリックして新規作成
  5. 生成されたAPIキーをコピーして、Mod設定に貼り付け

3. 基本的な使い方

村人の生成

/generate <村人の名前>

例: /generate kein

村人に指示を出す

メイン操作方法(推奨):

  1. 村人を見る
  2. 「V」キーを押す (村人のインベントリ画面が開く)
  3. 画面下部の入力欄に指示を入力
  4. 「Send」ボタンをクリック

コマンドでの操作(代替方法):

/control <村人の名前> <指示内容>

基本的な指示例:

高度な指示例:


🎯 主要機能の詳細

🔨 自動クラフト

村人は400種類以上のアイテムを自動でクラフトできます。

対応カテゴリ:

再帰的クラフト:
「ダイヤのツルハシを作って」と指示すると:

  1. 木材から棒を作成
  2. ダイヤモンドと棒を使ってツルハシを作成
  3. 不足している素材があれば報告

🏃 移動・追従

村人を見て「V」キーを押し、以下のように指示:

ついてきて
(100, 64, 200)に移動して
その場で待って

⛏️ マイニング

村人を見て「V」キーで指示:

石を10個掘ってきて
目の前のダイヤを掘って

📦 インベントリ管理

村人を見て「V」キーで指示:

チェストから木材を32個取ってきて
チェストに鉄を全部入れて
ダイヤの剣を装備して

🧠 記憶機能

各村人は個別の記憶を持ち、サーバー再起動後も保持されます。

村人を見て「V」キーで指示:

私の家は(123, 64, 456)だと覚えて
さっき覚えた家の場所に戻って
家の場所を忘れて

記憶されるデータ:


🎮 全アクション一覧

移動系

アクション 説明 例(Vキーで入力)
MOVE 指定座標へ移動 (100, 64, 200)に移動
FOLLOW プレイヤーを追従 ついてきて
PATROL 複数地点を巡回 AとBの間をパトロール
STOP 移動を停止 止まって
JUMP ジャンプ ジャンプして
LOOK 指定方向を向く 北を向いて

作業系

アクション 説明 例(Vキーで入力)
MINE ブロックを破壊 木を切って
PLACE ブロックを設置 石を置いて
CRAFT アイテムをクラフト 剣を作って
INTERACT ブロックと相互作用 ドアを開けて

インベントリ系

アクション 説明 例(Vキーで入力)
WITHDRAW チェストから取り出す チェストからダイヤを取って
DEPOSIT チェストに入れる チェストに鉄を入れて
EQUIP アイテムを装備 剣を装備
DROP アイテムを捨てる 土を捨てて

コミュニケーション系

アクション 説明 例(Vキーで入力)
CHAT チャットメッセージ送信 こんにちはと言って
REMEMBER 記憶に保存 家の場所を覚えて
FORGET 記憶を削除 家の場所を忘れて

🛠️ 技術仕様

システム要件

AIプロバイダー対応


⚙️ 詳細設定

ゲーム内設定

Mod Menu → Morwapi AI Villager → 設定

設定項目 説明 デフォルト
API URL APIエンドポイントURL -
API Key APIキー -
Model Name 使用するモデル名 gemini-2.5-flash

推奨設定

Gemini(推奨):

API URL: https://generativelanguage.googleapis.com/v1beta/models/
Model Name: gemini-2.5-flash
API Key: [Your Gemini API Key]

🔧 トラブルシューティング

よくある問題

1. 村人が反応しない

原因: API接続エラー
解決策:

2. クラフトが失敗する

原因: 素材不足または作業台がない
解決策:


📊 実装済み機能の完全リスト

✅ 完了した機能

コアシステム

AI機能

村人アクション

クラフトシステム

UI

メモリ・永続化

最適化

エラーハンドリング


🔮 今後の予定

検討中


バージョン / Version: 1.0.1
最終更新 / Last Updated: 2025-11-25
対応Minecraft / Minecraft Version: 1.20.1
開発者 / Developer: Morwapi

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

AI Villager Chat is a free Minecraft Java mod. Compatible with Minecraft 1.20.1. Downloaded 728 times (via CurseForge). Download it and open it directly in the game.

Explore more