Touhou Additional RPG System

If you encounter any errors, bugs, glitches, or malfunctions, please leave a comment or reach out to me via my TikTok profile PLS!!!

# 🌸 Touhou Little Maid RPG

**Turn your Touhou Little Maid maids into true RPG companions.** Every maid gets her own level, experience, professions, attributes, skill trees and specializations, plus a smarter AI that protects you, follows your orders and works on her own.

This is an **addon**, not a replacement. It works with the **original maids** of Touhou Little Maid, keeps their original inventory and tasks, and adds a full RPG layer on top.

> ⚠️ **Requires [Touhou Little Maid](https://www.curseforge.com/minecraft/mc-mods/touhou-little-maid) 1.5.x** · Minecraft **1.20.1** · Forge **47.x**
> Must be installed on **both client and server**.

🇧🇷 *Versão em português logo abaixo.*

---

## ✨ Features

### 📈 Levels & Experience
- Each maid levels up **from 1 to 100** (configurable).
- Maids earn XP by **harvesting, mining, chopping trees, cooking, smelting, brewing, building, exploring, fishing, healing and defeating monsters**, including while doing the original Touhou Little Maid tasks.
- Every level grants **attribute points**. Level-ups heal the maid and play a small celebration.
- Default XP curve: **100 / 250 / 450 / 700…** total XP for levels 2 / 3 / 4 / 5. Everything can be changed in the config.

### 🛠️ 13 Professions
The maid's profession comes from the task she is doing. Original TLM tasks count automatically, and **10 new tasks** were added to the original task list.

| Profession | What she does |
|---|---|
| 🌾 **Farmer** | Original TLM farming tasks (crops, melons, cocoa, sugar cane, honey, milk, shears, animals…) |
| ⛏️ **Miner** *(new)* | Mines **exposed, reachable ores** and prioritizes rare ones. Never digs tunnels and avoids lava. |
| 🪓 **Lumberjack** *(new)* | Finds natural trees, fells the **whole trunk** and **replants saplings** |
| 🏹 **Hunter** | Original TLM attack tasks (sword, bow, crossbow, danmaku, trident) |
| 🛡️ **Bodyguard** *(new)* | Stays close to you and attacks anything that threatens you |
| 🍳 **Cook** *(new)* | Uses real **furnaces and smokers** to cook, and **feeds you when you are hungry** |
| ⚒️ **Smith** *(new)* | Smelts ores in furnaces and blast furnaces, and **repairs damaged tools** (skill) |
| 🎣 **Fisher** | Original TLM fishing task |
| ⚗️ **Alchemist** *(new)* | Runs **brewing stands**: water bottles, nether wart, ingredients and blaze powder |
| 🧱 **Builder** *(new)* | **Builds or repairs** a structure from a blueprint you capture |
| 🧭 **Explorer** *(new)* | Explores safely and records **rare ores, spawners, loot chests and structures** |
| 💊 **Medic** *(new)* | Heals you and other maids with **potions and food**, emergencies first |
| 📦 **Transporter** *(new)* | Carries resources to your **storage chest** and fetches your priority item |

- **Each profession levels up separately.** A maid can be level 25 overall, Farmer level 8 and Miner level 4.
- Titles: **Basic → Experienced → Specialist → Master**.
- At profession level 15 you choose **1 of 3 permanent specializations**: faster work, extra yield or more experience.

### 💪 Attributes
Each maid is born with **slightly different base stats**. Every attribute has a real gameplay effect:

| Attribute | Effect |
|---|---|
| **Strength** | Melee damage, mining and chopping speed |
| **Agility** | Movement, attack and work speed |
| **Intelligence** | More XP, faster combat decisions |
| **Resistance** | Max health, armor, retreats later |
| **Perception** | Bigger search radius for resources and threats |
| **Efficiency** | Less tool wear, bigger batches, extra yield |
| **Loyalty** | Larger protection radius, bonus XP near you |

### 🌳 Skill Trees
**65 skills** (5 per profession), each with prerequisites, a required profession level and a skill point cost. They have real effects, for example:
- **Efficient Harvest:** chance of extra crops
- **Ore Identification:** prioritizes diamonds and emeralds
- **Ally Protection:** also defends your other maids
- **Emergency Intervention:** teleports to you when you're attacked far away
- **Repair:** combines damaged tools of the same type
- **Fertilizer:** uses bone meal on growing crops

### 🧠 Smarter AI
Maids decide what to do by priority:
1. Protect the master from immediate threats
2. Retreat when low on health
3. Help in combat
4. Follow direct orders
5. Work on their profession
6. Organize their inventory

The AI also:
- Never attacks players, maids, villagers or tamed animals, and avoids hitting creepers in melee.
- Avoids lava, fire, powder snow and cacti, and avoids water when possible (configurable).
- Detects when she is stuck: she jumps, recalculates and skips unreachable targets.
- Comes back to you if she gets lost.
- Remembers home, storage chest, last work spot, dangerous areas and points of interest. This memory is saved.

### 📜 Master's Orders
**Stay by my side · Protect me · Work · Stop working · Return home · Organize items · Follow me · Wait here · Defend this area · Collect resources · Prioritize resource · Set home · Set storage chest · Build here**

Orders have a **priority** (Low / Normal / High). An impossible order gets a polite reply in a chat bubble instead of breaking the AI.

### 🎒 Smart Inventory
- Uses the **original TLM inventory**. Nothing is replaced.
- Automatically equips the right tool for the job.
- Keeps important items (tools, food, equipment) and never deposits them.
- Organizes and merges stacks, and deposits loot in chests when the inventory is full.

### 🏷️ Random Names
Every unnamed maid gets a **random female name** (Japanese or Brazilian) as soon as she appears in the world: summoned, from the starting item, from a photo or film, or old maids already in your world. The name list is configurable.

### 🖥️ Interface
- **3 new tabs** inside the original maid inventory: RPG Panel, Orders, Skill Tree.
- An **RPG card** next to the inventory with level, XP, profession, loyalty and current order.
- A full **RPG panel** with 7 tabs: Info, Profession (with **one-click task assignment**), Attributes, Skills, Statistics, Orders and Memory.
- **"Lv.X"** on the maid's name tag, and a small HUD when you look at your maid.

### 🇧🇷 Bonus: Brazilian Portuguese for Touhou Little Maid
Includes the **complete Brazilian Portuguese (pt_br) translation of Touhou Little Maid**: interface, configs, advancements, maid chat bubbles, messages, guide book and model descriptions. The TLM jar is not modified.

---

## ⌨️ Commands
You can target a maid by **name** (Tab suggests your maids' names). If you leave the name out, the command uses the maid you are looking at, or else your nearest maid.

| Command | Description |
|---|---|
| `/maidrpg list` | Lists your maids (name, level, profession, position) |
| `/maidrpg info [maid]` | Shows the maid's RPG summary |
| `/maidrpg rename <name> [maid]` | Renames a maid |
| `/maidrpg order <order> [maid]` | Gives an order (e.g. `protect`, `follow`, `return_home`) |
| `/maidrpg blueprint capture <from> <to> [maid]` | Captures a blueprint for the Builder (max 64×64×64) |
| `/maidrpg blueprint clear [maid]` | Clears the blueprint |
| `/maidrpg setlevel <level> [maid]` | *(OP)* Sets the level |
| `/maidrpg addxp <amount> [maid]` | *(OP)* Gives XP |
| `/maidrpg reset [maid]` | *(OP)* Resets the RPG profile |

## ⚙️ Configuration
`config/tlmrpg-common.toml` lets you change:
- maximum level and XP curve
- progression speed and XP per action
- anti-exploit XP limit
- profession multipliers, and turning each profession on or off
- specialization level
- AI on/off, decision frequency, follow and protect distances, retreat health
- task difficulty
- random names

## 📥 Installation
1. Install **Minecraft Forge 1.20.1 (47.x)**.
2. Put **Touhou Little Maid 1.5.x** and **Touhou Little Maid RPG** in your `mods` folder.
3. Tame a maid with a cake, open her inventory and click the 👑 tab.

## 🔒 Fair Play
- All actions are validated on the server: only the owner can control a maid.
- XP has anti-exploit protection: there is a cooldown per block and a limit per minute, and picking up items gives no XP.
- No item duplication: extra-yield bonuses work like Fortune, at harvest time.

## ❓ Known Limitations
- The Smith smelts and repairs, but does not craft new tools or armor.
- The Builder can't place scaffolding, so very tall parts of a blueprint may be out of reach.
- The internal speed of original TLM tasks is not changed. Attributes affect them through movement speed, damage, health and harvest/fishing bonuses.

## 🤝 Credits
- **Touhou Little Maid** by TartaricAcid and team. This addon depends on it and uses only its public API.
- Touhou Project © Team Shanghai Alice.

---
---

# 🌸 Touhou Little Maid RPG (Português)

**Transforme as maids do Touhou Little Maid em verdadeiras companheiras de RPG.** Cada maid tem nível, experiência, profissões, atributos, árvores de habilidades e especializações próprias, além de uma IA mais inteligente que protege você, obedece suas ordens e trabalha sozinha.

Este é um **addon**, não um substituto. Ele funciona com as **maids originais** do Touhou Little Maid, mantém o inventário e as tarefas originais e adiciona uma camada completa de RPG.

> ⚠️ **Requer [Touhou Little Maid](https://www.curseforge.com/minecraft/mc-mods/touhou-little-maid) 1.5.x** · Minecraft **1.20.1** · Forge **47.x**
> Precisa estar instalado **no cliente e no servidor**.

---

## ✨ Funcionalidades

### 📈 Níveis e experiência
- Cada maid sobe **do nível 1 ao 100** (configurável).
- A maid ganha XP **colhendo, minerando, cortando árvores, cozinhando, fundindo, fazendo poções, construindo, explorando, pescando, curando e derrotando monstros**, inclusive nas tarefas originais do Touhou Little Maid.
- Cada nível dá **pontos de atributo**. Ao subir de nível, a maid recupera a vida e há uma pequena comemoração.
- Curva padrão: **100 / 250 / 450 / 700…** de XP total para os níveis 2 / 3 / 4 / 5. Tudo pode ser alterado na configuração.

### 🛠️ 13 profissões
A profissão vem da tarefa que a maid está fazendo. As tarefas originais do TLM contam automaticamente, e **10 tarefas novas** foram adicionadas à lista original.

| Profissão | O que ela faz |
|---|---|
| 🌾 **Agricultora** | Tarefas originais de fazenda do TLM (plantações, melancia, cacau, cana, mel, leite, tesoura, animais…) |
| ⛏️ **Mineradora** *(nova)* | Minera **minérios expostos e alcançáveis** e prioriza os raros. Nunca cava túneis e evita lava. |
| 🪓 **Lenhadora** *(nova)* | Encontra árvores naturais, derruba o **tronco inteiro** e **replanta as mudas** |
| 🏹 **Caçadora** | Tarefas originais de ataque do TLM (espada, arco, besta, danmaku, tridente) |
| 🛡️ **Guarda-costas** *(nova)* | Fica perto de você e ataca o que te ameaçar |
| 🍳 **Cozinheira** *(nova)* | Usa **fornalhas e defumadores** de verdade para cozinhar e **te alimenta quando você está com fome** |
| ⚒️ **Ferreira** *(nova)* | Funde minérios em fornalhas e altos-fornos e **conserta ferramentas** (habilidade) |
| 🎣 **Pescadora** | Tarefa original de pesca do TLM |
| ⚗️ **Alquimista** *(nova)* | Opera **suportes de poção**: garrafas d'água, fungo do Nether, ingredientes e pó de blaze |
| 🧱 **Construtora** *(nova)* | **Constrói ou repara** uma estrutura a partir de um projeto capturado por você |
| 🧭 **Exploradora** *(nova)* | Explora com segurança e registra **minérios raros, spawners, baús de tesouro e estruturas** |
| 💊 **Médica** *(nova)* | Cura você e outras maids com **poções e comida**, emergências primeiro |
| 📦 **Transportadora** *(nova)* | Leva recursos para o seu **baú de depósito** e busca o item prioritário |

- **Cada profissão tem nível próprio.** Uma maid pode ser nível 25 no geral, Agricultora nível 8 e Mineradora nível 4.
- Títulos: **Básica → Experiente → Especialista → Mestra**.
- No nível profissional 15 você escolhe **1 de 3 especializações permanentes**: trabalho mais rápido, rendimento extra ou mais experiência.

### 💪 Atributos
Cada maid nasce com **atributos base levemente diferentes**. Todos têm efeito real no jogo:

| Atributo | Efeito |
|---|---|
| **Força** | Dano corpo a corpo, velocidade de mineração e de corte |
| **Agilidade** | Velocidade de movimento, de ataque e de trabalho |
| **Inteligência** | Mais XP, decisões de combate mais rápidas |
| **Resistência** | Vida máxima e armadura; recua mais tarde |
| **Percepção** | Raio maior de busca de recursos e de ameaças |
| **Eficiência** | Menos desgaste de ferramentas, lotes maiores, rendimento extra |
| **Lealdade** | Raio de proteção maior, XP extra perto de você |

### 🌳 Árvores de habilidades
**65 habilidades** (5 por profissão), cada uma com pré-requisito, nível profissional mínimo e custo em pontos. Todas têm efeito real, por exemplo:
- **Colheita Eficiente:** chance de colheita extra
- **Identificação de Minérios:** prioriza diamante e esmeralda
- **Proteção de Aliados:** defende também suas outras maids
- **Intervenção de Emergência:** teletransporta até você quando é atacado longe dela
- **Reparo:** combina ferramentas danificadas iguais
- **Adubação:** usa farinha de osso nas plantações em crescimento

### 🧠 IA mais inteligente
As maids decidem o que fazer por prioridade:
1. Proteger o mestre de ameaças imediatas
2. Recuar quando estão com pouca vida
3. Ajudar no combate
4. Cumprir ordens diretas
5. Trabalhar na profissão
6. Organizar o inventário

A IA também:
- Nunca ataca jogadores, maids, aldeões nem animais domesticados, e evita atacar creepers corpo a corpo.
- Evita lava, fogo, neve fofa e cactos, e evita água quando possível (configurável).
- Percebe quando está presa: pula, recalcula e desiste de alvos inalcançáveis.
- Volta até você se se perder.
- Lembra da casa, do baú de depósito, do último local de trabalho, das áreas perigosas e dos pontos de interesse. Essa memória fica salva.

### 📜 Ordens do mestre
**Fique ao meu lado · Proteja-me · Trabalhe · Pare de trabalhar · Retorne para casa · Organize seus itens · Siga-me · Aguarde aqui · Defenda esta região · Colete recursos · Priorize recurso · Definir casa · Definir baú · Construir aqui**

As ordens têm **prioridade** (Baixa / Normal / Alta). Uma ordem impossível recebe uma resposta educada em um balão de fala, sem travar a IA.

### 🎒 Inventário inteligente
- Usa o **inventário original do TLM**. Nada é substituído.
- Equipa sozinha a ferramenta certa para o trabalho.
- Guarda itens importantes (ferramentas, comida, equipamentos) e nunca os deposita.
- Organiza e junta pilhas, e deposita o que coletou em baús quando o inventário enche.

### 🏷️ Nomes aleatórios
Toda maid sem nome ganha um **nome feminino aleatório** (japonês ou brasileiro) assim que aparece no mundo: invocada, saída do item inicial, de uma foto ou de um filme, ou maids antigas que já estavam no mundo. A lista de nomes é configurável.

### 🖥️ Interface
- **3 abas novas** dentro do inventário original da maid: Painel RPG, Ordens e Árvore de Habilidades.
- Um **cartão RPG** ao lado do inventário, com nível, XP, profissão, lealdade e ordem atual.
- Um **painel RPG** completo com 7 abas: Informações, Profissão (com **atribuição de tarefa em um clique**), Atributos, Habilidades, Estatísticas, Ordens e Memória.
- **"Lv.X"** na plaquinha de nome da maid e um pequeno painel na tela quando você olha para ela.

### 🇧🇷 Bônus: Touhou Little Maid em português
Inclui a **tradução completa do Touhou Little Maid para português do Brasil (pt_br)**: interface, configurações, conquistas, balões de fala das maids, mensagens, livro-guia e descrições dos modelos. O jar do TLM não é alterado.

---

## ⌨️ Comandos
Você pode indicar a maid pelo **nome** (o Tab sugere os nomes das suas maids). Se não informar o nome, o comando usa a maid para quem você está olhando ou, senão, a sua maid mais próxima.

| Comando | Descrição |
|---|---|
| `/maidrpg list` | Lista suas maids (nome, nível, profissão, posição) |
| `/maidrpg info [maid]` | Mostra o resumo RPG da maid |
| `/maidrpg rename <nome> [maid]` | Renomeia uma maid |
| `/maidrpg order <ordem> [maid]` | Dá uma ordem (ex.: `protect`, `follow`, `return_home`) |
| `/maidrpg blueprint capture <de> <até> [maid]` | Captura um projeto para a Construtora (máx. 64×64×64) |
| `/maidrpg blueprint clear [maid]` | Apaga o projeto |
| `/maidrpg setlevel <nível> [maid]` | *(OP)* Define o nível |
| `/maidrpg addxp <quantidade> [maid]` | *(OP)* Dá XP |
| `/maidrpg reset [maid]` | *(OP)* Reinicia o perfil RPG |

## ⚙️ Configuração
O arquivo `config/tlmrpg-common.toml` permite ajustar:
- nível máximo e curva de XP
- velocidade de progressão e XP por ação
- limite anti-exploração de XP
- multiplicadores por profissão, e ligar ou desligar cada profissão
- nível de especialização
- IA ligada ou desligada, frequência de decisão, distâncias de acompanhamento e de proteção, vida para recuar
- dificuldade das tarefas
- nomes aleatórios

## 📥 Instalação
1. Instale o **Minecraft Forge 1.20.1 (47.x)**.
2. Coloque o **Touhou Little Maid 1.5.x** e o **Touhou Little Maid RPG** na pasta `mods`.
3. Dome uma maid com um bolo, abra o inventário dela e clique na aba 👑.

## 🔒 Jogo justo
- Todas as ações são validadas no servidor: só o dono controla a maid.
- O XP tem proteção anti-exploração: há um tempo de espera por bloco e um limite por minuto, e pegar itens do chão não dá XP.
- Não há duplicação de itens: os bônus de rendimento funcionam como a Fortuna, no momento da colheita.

## ❓ Limitações conhecidas
- A Ferreira funde e conserta, mas não fabrica ferramentas nem armaduras novas.
- A Construtora não monta andaimes, então partes muito altas de um projeto podem ficar fora de alcance.
- A velocidade interna das tarefas originais do TLM não é alterada. Nelas, os atributos agem pela velocidade de movimento, dano, vida e bônus de colheita e pesca.

## 🤝 Créditos
- **Touhou Little Maid**, de TartaricAcid e equipe. Este addon depende dele e usa apenas a API pública.

## 🤝 Créditos
- **Touhou Little Maid**, de TartaricAcid e equipe. Este addon depende dele e usa apenas a API pública.
- Touhou Project © Team Shanghai Alice.