> For the complete documentation index, see [llms.txt](https://docs.morpheusemulator.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpheusemulator.com.br/dashboard/client-hub/client-files.md).

# Client files

**Edit the client files (server list and friends) and publish the update to your players.** Open **Client Hub → Client Files**.

For details about each client file, see the MuServer reference: [Client files](/client/client.md).

## Page layout

1. **File selector** at the top – pick which client file to edit with its visual editor.
2. A yellow notice when files are pending: **N file(s) pending publication for this server. Review and publish.** (the link opens [Publish updates](/dashboard/client-hub/publishing-updates.md)).
3. The **visual editor** of the selected file.
4. **Other files (download / upload)** – a table of client files without a visual editor.
5. **Release history** – previous publications with **Version**, **When**, **By**, **Status**, **Files**, **Time** and **Details**.

## Files with a visual editor

| File                               | What it controls                                                                                 |
| ---------------------------------- | ------------------------------------------------------------------------------------------------ |
| **ServerList.bmd**                 | Server list shown after login (name, position, description, NonPvp per slot).                    |
| **Text.bmd** (per language)        | Pool of localised strings that feeds the whole UI (chat, NPCs, error messages, buttons).         |
| **Item.bmd** (per language)        | Master item catalog: name, sprite, class, damage, defense, requirements, drop/trade/store flags. |
| **MoveReq** (per language)         | Maps of the `/move` window (M key).                                                              |
| **ItemTooltip**                    | Tooltip of each item: name, colour and up to 12 text lines.                                      |
| **ItemTooltipText** (per language) | Phrases used by the tooltip lines.                                                               |
| **Mix**                            | Mix window recipes for the 14 NPC types.                                                         |

{% hint style="info" %}
Every save on this page ends with a confirmation such as **Saved (English, Portuguese) — waiting to be published.** This means the file is saved on your server and is now waiting in the [publish queue](/dashboard/client-hub/publishing-updates.md).
{% endhint %}

## Server list (ServerList.bmd)

| Column              | Description                                                                                                                                               |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Index**           | Unique server ID (0–65535). Must never be duplicated.                                                                                                     |
| **Name**            | Text shown in the Select Server list. Max 31 characters.                                                                                                  |
| **Pos**             | Visual position/grouping (0–255). Servers with the same Pos form one group.                                                                               |
| **Sequence**        | Display order within the Pos group (lower = first).                                                                                                       |
| **Description**     | Free text shown on hover/tooltip. Empty = no description.                                                                                                 |
| **NonPvp per slot** | Each slot controls the PvP level of one internal sub-server: **0** = free PvP, **1** = PK allowed with penalty, **2** = duel only, **3** = fully non-PvP. |

Steps:

1. Click **+ Add server** (or edit existing rows).
2. Fill in the columns. Use **remove** to delete a server (*The change only takes effect after you save.*).
3. Click **Save**, then publish.

{% hint style="warning" %}
The client list only controls what players **see**. The real server list is in the ConnectServer configuration — keep both consistent and use **Reload ServerList** on the ConnectServer (see [Services and reload](/dashboard/services-and-reload.md#connectserver-modules)).
{% endhint %}

## Game texts (Text.bmd)

1. Select **Text.bmd**. The editor loads every available language (English, Portuguese, Spanish…).
2. Filter with **filter by key or text…**.
3. Edit the **Text** column of any **Key**; add entries with **+ entry**.
4. **Find and replace**: type in **search…** and **replace with… (empty = remove)**, then **replace** (filtered rows) or **apply to all** (`12 replacement(s) applied to all entries`).
5. Click **save N languages**.

## Items (Item.bmd)

A full item editor with category filters (**Weapons**, **Helms**, **Armors**, **Pants**, **Gloves**, **Boots**, **Shields**, **Pendants**, **Rings**, **Wings**, **Pets**, **Jewels**, **Other**) and **Search by name, type or index…**.

Item fields are organised in tabs: **Identity**, **Combat**, **Requirements**, **Classes**, **Resistances**, **Flags**, **Economy**, **Advanced**. Examples:

| Field                                                                                      | Description                                                        |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| **Item name**                                                                              | Name shown in game.                                                |
| **Size (X × Y)**                                                                           | Inventory slots.                                                   |
| **Damage** / **Defense** / **Attack speed**                                                | Combat values.                                                     |
| **Strength**, **Agility**, **Energy**, **Vitality**, **Command**, **Character level**      | Requirements to equip.                                             |
| Classes                                                                                    | Per class: blocked, **Base**, **1st**, **2nd**, **3rd** evolution. |
| **Drop**, **Trade**, **Store Personal**, **Warehouse**, **Sellable (NPC)**, **Repairable** | Behaviour flags.                                                   |
| **Base price (zen)**, **Stack (overlap)**                                                  | Economy.                                                           |

Useful tools:

* **Duplicate** an item, create a **+ New item**, or **Delete** (only applied on save; **Reload** before saving to undo).
* **group edits** – for armor sets, edit fields **concurrently** across all pieces of the set (Helm/Armor/Pants/Gloves/Boots). The name is never shared.
* Filters **any class** / **only \<class>** and **complete sets only**.

{% hint style="warning" %}
Item changes must match the server item tables. Create a [backup](/dashboard/backups-and-restore.md) before bulk changes and apply the server side with **Reload Item** or a restart.
{% endhint %}

## Move list (MoveReq)

Maps of the `/move` window: **No.** (unique), **Map**, **Sub-map**, **Min level**, **Max level** (*no limit* = any level), **Zen** and **Gate**. Each language has its own file. *The real /move is validated by the server (Move.txt/Gate.txt). Keep the same numbers and levels on both sides.*

## Tooltips (ItemTooltip and ItemTooltipText)

* **ItemTooltip** – per item: **Name**, **Name color**, **Bold**, **No tax**, **Special option**, **Show level**, **Level tooltip** and up to 12 **Lines** (each line = a phrase number from ItemTooltipText and a colour). A **Preview** shows the result. The file has exactly 8192 slots (`used of total slots in use`); adding uses a free slot.
* **ItemTooltipText** – phrases by number. Keep `%d` / `%s` in the same count and order as the original.

## Mix recipes (Mix)

Recipes of the mix window, by NPC type (**Goblin — normal**, **Goblin — chaos item**, **Castle (Senior)**, **Elpis**, socket NPCs…). Each recipe has names/descriptions (Text.bmd numbers), **Mix no.**, **Max rate (%)**, **Required level**, **Zen**, **Inventory space**, **Ingredient rule**, charms, **Ingredients** and a **Rate formula**.

{% hint style="warning" %}
The mix file only controls the client **screen** (recipes shown, items accepted and rate shown). The real result is decided by the GameServer — also change the server mix configuration.
{% endhint %}

## Visual and text modes

Several editors offer **Visual** and **Text** modes. Text mode shows the file as plain text: one line per record, texts in quotes, `//` for comments. A line with an error is marked and nothing is applied until it is fixed.

Rows can be moved (**Move up** / **Move down**), duplicated (**Duplicate**) or removed (**Remove**). If a language is missing a file, use **Create from the first language**.

## Other files (download / upload)

Files without a visual editor are listed with their **Role in the game**:

1. Click **Download**.
2. Edit the file in your own tool.
3. Click **Upload** to send it back. You'll see `uploaded (N B).` and the file joins the publish queue.

## Release history

Every publication is listed with its version, date, author, status and file count. Use **reload** to refresh.

{% hint style="info" %}
The **Reindex from FTP** button is a recovery tool used after moving to a new machine or uploading updates manually. Use it only when support asks you to.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.morpheusemulator.com.br/dashboard/client-hub/client-files.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.