AutonomeNPC

An offline companion NPC that mines, smelts and crafts for you. No AI service, no API key.

• A worker mod with no colony to build. Start with just one companion.
• No API key, no subscription, fully offline.
• Minecraft 1.21.1 / NeoForge supported.

⚠️[NOTICE]

To help improve the mod, please feel free to report any bugs or share your feedback. I will look into them and respond as quickly as possible.

This mod is primarily developed for the Japanese language environment. English language support is secondary.

Overview

AutonomeNPC adds a companion NPC that follows you, and — once assigned a job — works on its own: mining, exploring, smelting, crafting, and restocking materials it runs out of. Movement is powered by PathEngine, a from-scratch asynchronous A* pathfinding engine (a separate required library mod) that lets the companion bridge gaps, climb, swim, and build mining routes without freezing the game thread.

Important: despite the name, this is not connected to any external AI service. All “AI” behavior — pathfinding, job logic, natural-language command parsing — runs entirely locally as rule-based code. No internet connection or API key required.

Features

Companion basics

• Tame with an empty hand right-click; the tamer becomes the owner
• Follows the owner automatically; right-click to toggle sit/follow
• Personal inventory (sneak + right-click to open), saved with the world
• Nameable; chat reports are prefixed with the companion’s name
• Per-companion toggle for teleport-to-owner when left behind
• Works across the Overworld, Nether, and End
• Radial quick-menu (keybind) for wait / follow / retreat / combat / passive / recall
• New players receive 4 items on first join (management item + 3 wands) — spawn eggs are not included in this starter kit

Management item (GUI)

• A handheld remote control with 5 tabs
• Basic Actions (recall/follow/wait/retreat, combat toggle, add/remove companion, job assignment, melee/ranged combat range)
• Work Mode (configure each autonomous job)
• Appearance (built-in skin presets + custom PNG skins from a folder)
• Smelting (fuel priority list)
• Settings (HUD size, shield-guard HP threshold)

Jobs & autonomous work (role caps: 1 Combat / 2 Exploration / 2 Base)

• Base role: operates furnaces, crafts on request via free-text chat commands (“craft me a…”) and reports progress
• All roles: automatically gather and craft materials they’re short on
• Tool progression: wood → full stone kit → iron crafted as needed. Netherite is never self-crafted — the companion waits for the owner to hand it over
• Mining: target up to 5 block IDs (or any ore) with a goal quantity
• Item search: locate and retrieve a specified item
• Auto-Sort: redistributes chest contents into matching chests within a designated area and merges partial stacks
• Base Work: pulls raw resources from protected-area chests, smelts them, and returns the results

Status system

• HP/hunger unified to 20 max HP, Totem of Undying support
• Dedicated top-left HUD (heart/food icons) with hit/heal feedback
• Starvation is treated as non-lethal damage
• Extended inventory: 18-slot backpack + food slot + 9-slot pouch + 2 potion slots (pouch/potions excluded from auto-sort/auto-pickup)
• Auto-uses healing/regen potions below 50% HP and speed potions on sprint (during combat/mining/exploring only, with cooldowns)
• Auto-restocks offhand items (e.g. shields) from the pouch when broken/consumed

Combat AI

• Engages enemies that attack the owner, that the owner attacks, or hostile mobs nearby; toggle combat active/passive
• Retreats to the owner when HP drops below a configurable threshold
• Opportunistic jump attacks for crits, with hole/lava avoidance
• Shield guarding with a per-companion HP threshold slider
• Ranged (bow) kiting AI with arrow consumption logic (Infinity-enchanted bows don’t consume arrows) and retreat when out of ammo
• Switch melee/ranged focus from the management GUI

Utility

• Protection wand: restricts block changes by companions within a marked area
• Storage/sorting destination wands for Auto-Sort targets
• Auto-places torches in dark areas
• Natural-language chat commands (fully local, rule-based, Japanese and English) — free-text is currently limited to Base-role crafting requests

Requirements

How to Use

1. Install PathEngine and AutonomeNPC together (both required).
2. Join a world — you’ll automatically receive a management item and 3 wands (one-time, first join only).
3. Right-click the item to open the GUI, or find a companion via the “Add Companion” button (subject to role caps).
4. Right-click the companion with an empty hand to tame it.
5. Assign a job from the Work Mode tab and configure its target.

License

All Rights Reserved. Redistribution and modification of this mod are not permitted. Inclusion in modpacks is welcome — no permission required.

MODの品質向上のため、不具合やフィードバックがあればお気軽にご報告ください。確認次第、速やかに対応いたします。

Description (日本語)

マイクラ内で採掘・製錬・クラフトを自分でこなす、完全オフラインのコンパニオンNPC。外部AIサービス・APIキーは不要です。

• 拠点づくり不要、1体から始められる作業員MOD
• API キー不要・課金不要・オフライン
• Minecraft 1.21.1 / NeoForge 対応

概要

AutonomeNPC は、プレイヤーに追従し、役職を与えると自律的に採掘・探索・製錬・クラフト・不足素材の自動調達までこなすコンパニオンNPCを追加するMODです。移動処理は前提ライブラリ PathEngine（別途必須の依存MOD）が担当し、スクラッチ実装の非同期A*経路探索により、メインスレッドを止めずに橋渡し・段差登り・遊泳・採掘ルート構築まで自力で行います。

重要な注意点：MOD名に「AI」とありますが、外部のAIサービスとは一切接続していません。経路探索・作業ロジック・自然言語コマンド解析を含むすべての「AI」挙動は、完全にローカルで動作するルールベースの処理です。インターネット接続やAPIキーは不要です。

機能一覧

コンパニオンの基本

• 素手で右クリックしてテイム。テイムしたプレイヤーが「オーナー」になる
• オーナーに自動追従。右クリックで「待機／追従再開」をトグル
• 専用インベントリ（しゃがみ＋右クリックで開閉、ワールドに保存）
• 名前を付けられる。以降のチャット報告は個体名を接頭辞に表示
• 追従テレポート（離れすぎた時の自動テレポート）を個体ごとにON/OFF可能
• オーバーワールド／ネザー／エンドをまたいで管理可能
• ラジアルメニュー（キーバインド）で待機／追従／撤退／戦闘／パッシブ／呼び戻しを素早く操作
• 各プレイヤーのワールド初回参加時にMODアイテム4種（管理アイテム＋ワンド3種）を1回だけ支給（スポーンエッグは対象外）

NPC管理アイテム（GUI）

• 5タブ構成の遠隔操作端末
• 基本操作（呼び戻し・追従・待機・撤退・戦闘ON/OFF・NPC追加削除・役職割り当て・近接/遠隔切り替え）
• 作業モード（各自律作業の設定）
• 見た目（プリセット＋カスタムPNGスキン読み込み）
• 精錬（燃料優先順位）
• 設定（HUDサイズ・盾ガード開始HP割合）

役職と自律作業（頭数上限：戦闘1体／探索2体／拠点2体）

• 拠点役：かまど製錬・クラフトを担当。「〇〇作って」の自由文指示に対応し、進捗をチャット報告
• 全役共通：作業に必要な素材が不足すると自動で調達・クラフトして補う
• 道具進行：木ツルハシ→石ツール一式→鉄以降は都度クラフト。ネザライトは自作せずプレイヤーの手渡しを待つ
• 採掘：対象ブロックID（最大5種／空欄で任意鉱石）と目標個数を指定
• アイテム探索：指定アイテムを探して回収
• 自動仕分け：搬入チェストの中身を、同種を持つチェストへ振り分け＋半端スタックを統合
• 拠点作業：保護エリア内チェストから未製錬資源を取り出し、かまどで製錬してエリア内チェストへ戻す

ステータスシステム

• 最大HP20に統一、不死のトーテム対応
• 画面左上に専用HUD（ハート／肉アイコン）、被弾・回復フィードバック
• 自然HP再生。餓死は非致死ダメージ扱い
• インベントリ拡張：バックパック18＋食料スロット＋ポーチ9＋ポーション2（ポーチ・ポーションは自動収納・自動ピックアップ対象外）
• HP50%未満で回復系ポーション、ダッシュ開始時に速度ポーションを自動使用（戦闘／採掘／探索中のみ、クールダウンあり）
• 盾などのオフハンド装備が壊れたらポーチから自動補充

戦闘AI

• オーナーを攻撃した敵／オーナーが攻撃した敵／周囲の敵性Mobに応戦。戦闘アクティブ／パッシブ切り替え可
• HPが設定割合を下回ると撤退
• クリティカル狙いの自発ジャンプ攻撃（穴・溶岩回避判定あり）
• 個体別スライダーで設定できる盾ガード
• 弓によるカイティング射撃（無限エンチャントは矢非消費、矢切れで退避）。GUIで近接／遠隔を切り替え可能

その他

• エリア保護ワンド：範囲内でのNPCによるブロック改変を制限
• 収納先／整理先ワンド：自動仕分けの対象エリア指定
• 自動たいまつ設置
• 自然言語コマンド（完全ローカル・ルールベース、日本語／英語対応。自由文対応は拠点役のクラフト指示のみ）

動作環境

導入・使い方

1. PathEngine と AutonomeNPC を両方導入する（PathEngineは必須依存）。
2. ワールドに初回参加すると、管理アイテムとワンド3種が自動で1回支給される。
3. アイテムを右クリックしてGUIを開き、GUI内「NPCを追加」でその場に1体追加（役職の空きが必要）。
4. 素手で右クリックしてテイム。
5. 作業モードタブから役職と作業内容を設定。

ライセンス

All Rights Reserved。本MODの再配布・改変は禁止します。モッドパックへの同梱は歓迎（許可申請不要）です。