Unofficial fork notice: Numen-Re is an independently maintained, unofficial fork of Numen by Dwinovo. Do not report Numen-Re bugs or request Numen-Re support from Dwinovo or the original project. Report issues only through the Numen-Re repository.

非官方分支声明： Numen-Re 是 Dwinovo 原作 Numen 的独立维护非官方分支。请勿将 Numen-Re 的问题、崩溃或支持请求反馈给 Dwinovo 或原项目；请仅在 Numen-Re 仓库提交问题。

Numen-Re — LLM AI Companions for Forge 1.20.1

Numen-Re adds persistent, LLM-powered companions to Minecraft Forge 1.20.1. Summon named companions, give each one an AI configuration, and use natural language to direct multi-step in-game work.

This release is a complete standalone JAR. The numen_api compatibility layer is bundled, so no separate API mod is required.

What companions can do

• Travel, follow coordinates and navigate around obstacles.
• Inspect blocks, entities, inventories, containers and recipes.
• Mine, collect, craft, smelt, equip, eat, place and break blocks.
• Fight mobs, shoot targets and manage equipment.
• Plan and build saved blueprints.
• Store long-term memories, manage autonomous work and recover durable tasks after restart.
• Maintain separate model/provider settings for multiple named companions.

Reliability and safety work

• Stable resource-based network packet IDs prevent registration-order desync and virtual-LAN/tunnel disconnects.
• Configurable conversation compaction reduces unnecessary long-context stalls.
• Recoverable JSON state with backups for conversations, tasks, memory and configuration.
• Local secret protection and diagnostic redaction.
• Public-URL validation and bounded HTTP behavior for optional web access.
• Configurable companion attributes, respawn behavior and creative-grade absolute invulnerability.

Supported environment

• Minecraft: 1.20.1
• Mod loader: Forge 47.x (built against 47.4.20)
• Java: 17
• Side: Client and server
• Multiplayer: install the same Numen-Re JAR on every participating client and server
• Required separate mods: none

Installation

1. Install Forge for Minecraft 1.20.1.
2. Put the Numen-Re JAR in the mods folder on the client and server.
3. Start the game and open the companion roster/workspace (default key: G).
4. Configure a provider, model and your own API key.
5. Summon a companion in the UI, or use /numen_re player summon <name>.

Numen-Re does not include API access, free inference or provider credits. Provider availability, pricing, model IDs and capabilities are controlled by each provider.

Project identity, source and support

• Numen-Re source/releases/issues: https://github.com/laodafeijibei/numen-re
• Original Numen project by Dwinovo: https://github.com/Dwinovo/minecraft-numen
• Independent maintainer: laodafeijibei
• Main mod ID: numen_re
• Bundled compatibility mod ID: numen_api

Numen-Re is not an official Numen build. Please do not ask Dwinovo to debug, support or answer for this fork.

License and assets

The complete Numen-Re derivative and combined JAR are distributed under GNU Lesser General Public License v3.0 (LGPL-3.0). Upstream copyright and attribution are preserved in the source and JAR notices. The historically bundled API compatibility component is documented separately in LICENSE-API and THIRD_PARTY_NOTICES.md.

Numen-Re does not use the original Numen logo as its branding. Its dark navy/cyan revision mark and bundled UI textures are independently generated assets.

Minecraft is a trademark of Mojang Studios. Numen-Re is not affiliated with Mojang, Microsoft, Dwinovo, the original Numen project, or any listed AI provider.