# Metropolize Companions

Thank you for your interest in the open beta of the Metropolize Companions mod! This release grants access to **Talos**, a robot companion that offers a preview into the capabilities of our AI generated agents. This mod is still under active development. In the coming months, we plan to continue adding new capabilities, behaviors, and even new companions with varying personalities.

Furthermore, we are continuously working to improve the AI creation engine behind Talos. We hope to eventually open this service to the public, allowing you to create and customize your own Talos-like companions!

### Getting Started

1. First, make sure that you have Minecraft 1.20.1 installed with a compatible version of Forge. Visit <https://files.minecraftforge.net/net/minecraftforge/forge/index_1.20.1.html> to see all available downloads.
2. Download Metropolize Companions from Modrinth using the following link: <https://modrinth.com/project/metropolize-companions>
3. The downloaded JAR should be named something like `mtz_companions-0.5.0-beta+1.20.1-all.jar`. Move this file to your Minecraft mods directory.
   1. By default, your mods folder should be located at `%APPDATA%\.minecraft\mods`.
4. Now, launch Minecraft and **create a new world**. This step is required for Talos to function as-intended.
   1. During this world creation, please make sure **cheats are enabled**.
5. After your world has finished creating, you can summon Talos using the following command.
   1. <pre data-full-width="true"><code>/summon mtz_companions:talos
      </code></pre>
6. That's it! Have fun playing with Talos! You can see a full list of commands in the [Command Documentation](/metropolize-companions-mod/commands.md).
7. \[Optional] Join our Discord community using the link here! <https://discord.gg/UQUe3gMvXZ>

{% hint style="danger" %}
You MUST create a new world after installing the mod to experience Talos' full feature-set.
{% endhint %}

### Current Features

* Talos is able to...
  * Follow players
  * Mine blocks + collect items
  * Equip armor and fight (with fists/a sword), including blocking melee attacks
  * Sleep (you can still end the day without Talos in bed)
  * Eat
  * Craft using crafting tables or the inventory menu
  * Respawn on death
* Additionally, he can independently gather materials and learn about your world through...
  * Surface exploration
  * Cave exploration
    * Note: Talos will only explore caves when he has a pickaxe in his inventory
* To reach various destinations, whether for exploration or just following you around your world, Talos will...
  * Navigate by placing blocks to get to previously unreachable locations
  * Break blocks to access caves and other desirable areas
  * Swim underwater
* You can interact with Talos by...
  * Right-clicking him! This will give you access to Talos' inventory
  * Calling the `/summon mtz_companions:talos` command to spawn Talos into your world
  * Using the `/kill` command to **permanently** kill Talos
  * Using the `/mtz_command_companion` command to tell Talos what to do
  * Using `/mtz manage` to open the companion management UI (settings, gather, tether, inventory)
  * Or by running any of the other helpful commands listed here: [Command Documentation](/metropolize-companions-mod/commands.md)
* Some other notes about Talos:
  * You'll be able to see his nametag, just like another player!
  * Talos will respawn at the server spawn/last bed slept in if he dies
  * Talos can navigate by placing blocks. He prefers to use dirt, cobblestone, and sandstone.
* Miscellaneous mod information:
  * There is a configurable `keepInventory` option to let Talos keep his stuff if he dies.
  * There's also a configurable `showCompanionId` option that adds an ID to Talos' nametag (in case you summon multiple).
* For a full list of changes, see the [v0.5.0-beta (2026-03-11)](/metropolize-companions-mod/changelog/v0.5.0-beta-2026-03-11.md) or [Previous changes](/metropolize-companions-mod/changelog/changelog.md).

### Known Issues

* Talos doesn't fully mine trees sometimes
* Talos doesn't fully mine ore veins sometimes

### FAQ

#### Q: How do I access the beta?

> 🎉Our **open beta** release date was August 1st.🎉
>
> The mod is now available for download via our [Modrinth page](https://modrinth.com/mod/metropolize-companions). Thank you to all of our closed beta testers for helping uncover bugs and provide helpful feedback to our team!

#### Q: What are the system requirements for the mod?

> Talos should be able to run on any machine, as long as it has Minecraft 1.20.1 and a compatible version of Forge (or NeoForge) installed.
>
> The mod is not hardware intensive, so it should run fine on lower-end machines.

#### Q: Is Metropolize Companions compatible with other mods?

> Talos is not designed to work with other mods. Talos may not recognize or understand how to interact with modded items, blocks, mobs, or other mechanics.
>
> Currently, we're focusing on teaching Talos the mechanics of the base game (and there is still a long way to go!) For this reason, *we will not be working on compatibility in the near future*.

#### Q: Is this mod compatible with other versions of Minecraft?

> Minecraft 1.20.1 is the main version that we've been developing and testing our mod with. Other major and/or minor versions may run just fine with `MtzCompanions` installed, but we provide no functionality or stability guarantees.

#### Q: Can I speak to Talos through the chat?

> This feature is actively being worked on. As of `v0.3.0`, Talos will not use the chat or respond to chat messages.
>
> However, we hope to start introducing this feature soon! It'll be very exciting when we do :)

#### Q: How does this mod work?

> We are teaching an AI model how to play Minecraft, then using it to precompute a brain for Talos, which we then insert into a Minecraft mob.
>
> This makes the mod very lightweight, as we do not interface with any computationally intensive models during runtime.
>
> An important downside of this is that Talos cannot learn new things during gameplay. In order to teach Talos how to use a new item or build a structure, we have to feed the information to our model and have it spit out a shiny new brain for Talos.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://metropolize.gitbook.io/metropolize-companions-mod/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
