OuroReal

# OuroReal

**A gold and glass HUD for World of Warcraft.** Polished gold rings with a feathered wing, small sapphires and smoked glass, on the pieces you look at all the time, while everything else stays the game's own.

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

---

## ✨ What it changes

### Unit frames
- **Player, target and target of target** in a gold ring with a feathered wing, a round portrait and the level in a small medallion.
- Health and power in framed boxes: **value on the left, percent on the right**.
- A thin segmented strip under the bars: **your experience**, and **the target's cast** on the target frame.
- The target's buffs and debuffs right under its frame (the game's own aura row, so it keeps working in combat).

### A free-form action bar
- No rows, no columns: **every button stands on its own**.
- In the edit mode, add a **row**, a **column** or a **block** of any size (up to 48 per line), with the gap you want.
- Each block becomes a **group with a gold handle**: drag the handle to move it, or drag any button alone. Buttons snap to their neighbours.
- **All 180 action slots of the game**: bars 1 to 8 with your key bindings, then the extra pages.
- Thin gold frames, keys above the buttons (or inside, or hidden), and the game's own cooldowns, ranges, procs and charges.

### Cast bar
- Spell icon in a gold frame with sapphires, the spell's name on a fading band.
- A **latency zone measured on every cast** (the green end of the bar) and your ping in ms: once the fill reaches it, you can move or queue the next spell.

### Minimap, menu and info
- **Round minimap in a gold ring** with four sapphires, and a plate with the zone and the clock.
- **Micro menu with 10 hand-made gold icons** (character, spellbook, talents, bags, quests, guild, achievements, collections, game menu, help) and your money.
- **Info line**: FPS, ping, durability, bag space, friends online and time.

### Character + bags window
- **One window for your character and your bags**, in smoked glass with gold wings on its corners.
- Your character in 3D (drag to turn it) **in front of your race's own scene** (the night elf forest, Durotar, the Undercity…).
- Equipment slots with quality borders, **Attributes / Reputation / Currency** tabs.
- Search, sort, filters (All, Gear, Consumables, Materials, Reagents) and a grid that **scrolls** when your bags are big.

### Your way
- **Edit mode**: drag every piece, mouse wheel to resize, right click to reset. Grid to line things up.
- **Settings panel** (`/ouro`) with a page for each piece, and an **OuroReal** page in *Esc > Options > AddOns*.
- **English and Portuguese**, following the game's language (or chosen in the panel).

### What it does *not* touch
Bank, mail, quests, map, professions, the game's menus… **stay exactly as Blizzard made them.** OuroReal only replaces the pieces it was designed for.

---

## ⌨️ Commands

| Command | What it does |
|---|---|
| `/ouro` | Opens the settings panel |
| `/ouro editar` | Edit mode |
| `/ouro quadros 0.8` | Size of the player, target and target-of-target frames |
| `/ouro fundo` | Race scene behind the character on/off |
| `/ouro erros` | Lists any error the addon caught (for bug reports) |

Right click on the **gear icon** of the menu also opens the settings.

---

## ❓ FAQ

**Does it work with other UI addons?**
Turn off other addons that replace the same pieces (unit frames, action bars, bags). Everything else is fine.

**Something looks wrong / an error showed up.**
Type `/ouro erros` and send what it says in the comments. Errors the game hides are told in chat by the addon.

**The textures didn't show after an update.**
New textures need a full game restart (not just `/reload`).

---

## ☕ Support us

OuroReal is free. If it made your game look better, you can support its development:

**[☕ Buy me a coffee on Ko-fi](https://ko-fi.com/ouroreal)**

Every bit of support helps keep the addon updated and make new pieces. Thank you for playing with OuroReal!

---
---

# 🇧🇷 OuroReal (português)

**Uma HUD de ouro e vidro para World of Warcraft.** Argolas de ouro polido com asa de penas, pequenas safiras e vidro fumê nas peças que você olha o tempo todo, e o resto continua sendo o do próprio jogo.

## ✨ O que muda

### Quadros
- **Jogador, alvo e alvo do alvo** numa argola dourada com asa, retrato redondo e o nível num medalhão.
- Vida e mana em caixas com borda: **valor à esquerda, porcentagem à direita**.
- Faixa fina segmentada embaixo das barras: **sua experiência** e, no alvo, **o cast dele**.
- Buffs e debuffs do alvo logo embaixo do quadro (a fileira do próprio jogo, que continua funcionando em combate).

### Barra de ações livre
- Sem linhas nem colunas fixas: **cada botão é solto**.
- No modo de edição, adicione uma **linha**, uma **coluna** ou um **bloco** do tamanho que quiser (até 48 por linha), com o espaço que preferir.
- Cada bloco vira um **grupo com uma alça dourada**: arraste a alça para mover o grupo ou arraste cada botão sozinho. Os botões se alinham aos vizinhos.
- **Todos os 180 espaços de ação do jogo**: barras 1 a 8 com seus atalhos, depois as páginas extras.
- Molduras douradas finas, teclas acima dos botões (ou dentro, ou escondidas), com recarga, alcance, procs e cargas do próprio jogo.

### Barra de cast
- Ícone da magia numa moldura dourada com safiras e o nome numa faixa que some para a direita.
- **Zona de latência medida a cada cast** (o fim verde da barra) e o ping em ms: quando o preenchimento chega nela, dá para se mexer ou soltar a próxima magia.

### Minimapa, menu e informações
- **Minimapa redondo numa argola dourada** com quatro safiras e uma faixa com a zona e o relógio.
- **Micro menu com 10 ícones dourados feitos à mão** (personagem, grimório, talentos, bolsas, missões, guilda, conquistas, coleções, menu do jogo, ajuda) e o seu dinheiro.
- **Linha de informações**: FPS, ping, durabilidade, espaço na bolsa, amigos online e hora.

### Janela de personagem + mochila
- **Uma janela só para o personagem e as bolsas**, em vidro fumê com asas douradas nos cantos.
- Seu personagem em 3D (arraste para girar) **na frente do cenário da sua raça** (a floresta dos elfos noturnos, Durotar, a Cidade Baixa…).
- Slots de equipamento com a cor da raridade e abas **Atributos / Reputação / Moedas**.
- Busca, organizar, filtros (Tudo, Equip., Consum., Materiais, Reagentes) e grade que **rola** quando as bolsas são grandes.

### Do seu jeito
- **Modo de edição**: arraste cada peça, rodinha muda o tamanho, clique direito volta ao padrão. Grade para alinhar.
- **Painel de configurações** (`/ouro`) com uma página para cada peça, e uma página **OuroReal** em *Esc > Opções > AddOns*.
- **Português e inglês**, seguindo o idioma do jogo (ou escolhido no painel).

### O que ele *não* mexe
Banco, correio, missões, mapa, profissões, os menus do jogo… **ficam exatamente como a Blizzard fez.** O OuroReal só troca as peças para as quais foi desenhado.

## ⌨️ Comandos

| Comando | O que faz |
|---|---|
| `/ouro` | Abre o painel de configurações |
| `/ouro editar` | Modo de edição |
| `/ouro quadros 0.8` | Tamanho dos quadros do jogador, alvo e alvo do alvo |
| `/ouro fundo` | Liga/desliga o cenário da raça atrás do personagem |
| `/ouro erros` | Lista os erros que o addon capturou (para relatar bugs) |

Clique direito na **engrenagem** do menu também abre as configurações.

## ❓ Perguntas frequentes

**Funciona com outros addons de interface?**
Desligue os que trocam as mesmas peças (quadros, barras de ação, bolsas). O resto convive normalmente.

**Algo ficou estranho / apareceu um erro.**
Digite `/ouro erros` e mande o que aparecer nos comentários. Os erros que o jogo esconde o addon avisa no chat.

**As texturas não apareceram depois de atualizar.**
Texturas novas precisam que o jogo seja fechado e aberto de novo (não só `/reload`).

## ☕ Apoie

O OuroReal é gratuito. Se ele deixou o seu jogo mais bonito, você pode apoiar o desenvolvimento:

**[☕ Apoie no Ko-fi](https://ko-fi.com/ouroreal)**

Cada apoio ajuda a manter o addon atualizado e a fazer peças novas. Obrigado por jogar com o OuroReal!