Potion Belt
- By
Potion Belt is a vanilla-friendly Minecraft mod that adds upgradeable belts for storing and quickly using potions, reducing inventory clutter while preserving brewing, consumption, progression, and Minecraft's natural balance.
Curse Maven Snippet
What's new
# Changelog - Potion Belt Mod
Todas as mudanças notáveis neste projeto serão documentadas neste arquivo.
O formato é baseado em [Keep a Changelog](https://keepachangelog.com/pt-BR/),
e este projeto adere ao [Versionamento Semântico](https://semver.org/lang/pt-BR/).
---
## [1.0.12] - 14/07/2026 (Initial Release)
### ✨ Added
#### Items (Itens)
- **Alchemist's Belt** - Cinturão alquímico de primeiro nível
- 3 slots para poções
- 4 poções máximas por slot (12 total)
- Receita: Couro (5) + Barbante (1) + Frasco de Vidro (1)
- Equip no slot de Curios "belt"
- **Master Alchemist's Belt** - Cinturão alquímico de segundo nível
- 4 slots para poções
- 8 poções máximas por slot (32 total)
- Receita: Lingote de Ferro (4) + Pó de Blaze (1) + Lingote de Cobre (2) + Alchemist's Belt (1) + Frasco de Vidro (1)
- Requer Alchemist's Belt como ingrediente
- **Grandmaster Alchemist's Belt** - Cinturão alquímico de terceiro nível
- 5 slots para poções
- 16 poções máximas por slot (80 total)
- Receita: Lingote de Ouro (4) + Sucata de Netherite (1) + Vara de Blaze (2) + Master Alchemist's Belt (1) + Frasco de Vidro (1)
- Requer Master Alchemist's Belt como ingrediente
- Máxima capacidade de armazenamento
- **Advanced Alchemy Bench** - Bancada especializada
- Bloco para gerenciar poções nos cinturões
- Interface intuitiva para adicionar/remover poções
- Salva automaticamente as mudanças no cinturão
- Receita: Lingote de Cobre (2) + Suporte de Fermentação (1) + Pedra (5) + Mesa de Trabalho (1)
#### Enchantments (Encantamentos)
- **Magic Gulp** (3 Níveis) - Encantamento de armadura de peito
- Aumenta velocidade de consumo de poções do cinturão
- Nível I: -20% de tempo de consumo
- Nível II: -40% de tempo de consumo
- Nível III: -60% de tempo de consumo
- Encontrado em: casas de Clérigo das vilas, bibliotecas de Stronghold, Câmaras de Julgamento, Mansões da Floresta e Cidades Antigas
#### Features (Funcionalidades)
- **Quick-Use Keys** - Teclas de atalho configuráveis (Z, X, C, V, B)
- Beber poções sem abrir inventário
- Arremessar Splash Potions e Lingering Potions diretamente pelo cinto
- Suporta customização em Configurações → Controles
- Respeita cooldown e validação do servidor
- **Configurable HUD** - Interface de usuário personalizável
- Mostra slots do cinturão equipado
- Exibe quantidade de poções por slot
- Mostra tecla de atalho correspondente
- Barra compacta sincronizada mostrando o cooldown de 5 segundos
- Posição customizável (esquerda/direita)
- Tamanho ajustável
- Opção de mostrar/ocultar slots vazios
- **Server-Authoritative Potion Storage** - Sistema seguro de armazenamento
- Validação completa no servidor
- Prevenção de duplicação de poções
- Seguro para multiplayer
- Cooldown entre consumos
- Retorno automático de garrafas vazias
#### Configuration (Configuração)
- **Common Config** (`potionbelt-common.toml`)
- `durationMultiplier`: Multiplicador do tempo de consumo (padrão: 1.0)
- `activationCooldownTicks`: Tempo entre usos em ticks (padrão: 100 / 5 segundos)
- `allowWhileSprinting`: Permite beber enquanto corre (padrão: true)
- Chances de Magic Gulp configuráveis individualmente por estrutura e nível
- **Client Config** (`potionbelt-client.toml`)
- `showHud`: Mostra/oculta o HUD (padrão: true)
- `hudSide`: Posição configurável do HUD
- `hudScale`: Tamanho do HUD (padrão: 1.0)
- `showEmptySlots`: Mostra slots vazios (padrão: true)
- `showKeyNames`: Mostra as hotkeys dos slots (padrão: true)
#### Loot Tables
- Magic Gulp enchantment books em:
- Village Cleric Houses (Casas de Clérigo das aldeias)
- Stronghold Libraries (Bibliotecas de Stronghold)
- Trial Chambers Rewards (Recompensas de Câmaras de Julgamento)
- Trial Chambers Ominous Rewards
- Woodland Mansions (Mansões da Floresta)
- Ancient Cities (Cidades Antigas)
#### Modding Integration
- **Curios API** - Integração completa
- Slot de cinturão customizado
- Rendering inteligente
- Compatibilidade com outros mods de accessories
- **Item Tag System** - Suporte a poções modded
- Tag padrão: `potionbelt:belt_potions`
- `minecraft:potion`, `minecraft:splash_potion` e `minecraft:lingering_potion` incluídas
- Suporte opcional a poções de outros mods por tag
#### Translations (Traduções)
- **English (en_us)** - Completo
- Nomes de itens
- Descrições
- Mensagens do jogo
- **Português Brasileiro (pt_br)** - Completo
- Nomes dos itens em português
- Descrições detalhadas
- Mensagens do sistema
### 📖 Documentation (Documentação)
- **README.md Completo** - Guia de usuário
- Requisitos do sistema
- Descrição detalhada de cada item
- 4 receitas visuais com materiais
- Guias passo-a-passo de uso
- Explicação de Magic Gulp com exemplos numéricos
- Tabelas de controles e capacidades
- Checklist de progressão para jogadores
- Instruções de configuração
- Compatibilidade com mods
- **Receitas Craftáveis**
- Alchemist's Belt - receita shaped
- Master Alchemist's Belt - receita shaped
- Grandmaster Alchemist's Belt - receita shaped
- Advanced Alchemy Bench - receita shaped
### 🔧 Technical (Técnico)
- **Custom Data Components**
- `BeltContents` - Armazenamento imutável de poções
- Codecs de disco e rede
- Cópia defensiva de ItemStack
- **Networking**
- `UseBeltPotionPayload` - Payload de consumo de poção
- Validação server-side
- Proteção contra cheats
- **Architecture**
- Pacotes organizados: `belt`, `block`, `menu`, `network`, `client`, `config`, `registry`
- Encantamentos data-driven
- Integração com sistema de eventos de NeoForge
### 📦 Dependencies
- **NeoForge** 21.1.235
- **Minecraft** 1.21.1
- **Curios API** 9.5.1+1.21.1
- **Java** 21+
### 🎮 Gameplay Balance
| Item | Slots | Cap./Slot | Cap. Total | Difficulty |
|------|-------|-----------|-----------|-----------|
| Alchemist's Belt | 3 | 4 | 12 | 🟢 Easy |
| Master Alchemist's Belt | 4 | 8 | 32 | 🟡 Medium |
| Grandmaster Alchemist's Belt | 5 | 16 | 80 | 🔴 Hard |
**Progressão Equilibrada:**
- Cada nível requere o anterior
- Materiais progressivamente mais raros
- Capacidade crescente proporcionalmente
- Encantamento Magic Gulp adiciona profundidade
### ✅ Testing (Testes)
- ✓ Ambiente Java 21 configurado
- ✓ Build completo do Gradle
- ✓ Cliente Minecraft iniciado com sucesso
- ✓ Todos os mods carregados (NeoForge, Curios, Potion Belt)
- ✓ JEI funcionando para visualizar receitas
- ✓ HUD renderizado corretamente
- ✓ Sistema de validação servidor funcional
- ✓ Receitas criáveis em survival
- ✓ 3 GameTests aprovados para livros Magic Gulp, formas de poção e pilhas da bancada
### 🐛 Known Issues (Problemas Conhecidos)
- ⚠️ Belt body renderer ainda não implementado (futuro)
- ⚠️ Component-preserving upgrade serializer pendente (futuro)
- ⚠️ Full GameTest suite incompleta (futuro)
- ⚠️ Renderização temporária de poção na mão do jogador não implementada (futuro)
### 📝 Breaking Changes (Mudanças Significativas)
- Nenhuma (primeira versão - 1.0.0)
---
## Histórico de Versões
### Versão 1.0.0 (Atual)
- Data: 14/07/2026
- Status: **Initial Release / Lançamento Inicial**
- Plataforma: CurseForge (pronta para publicação)
- Compatibilidade: Minecraft 1.21.1 + NeoForge
---
## Como Ler Este Changelog
- **Added** - Novas funcionalidades adicionadas
- **Changed** - Mudanças em funcionalidades existentes
- **Deprecated** - Funcionalidades que serão removidas em breve
- **Removed** - Funcionalidades removidas
- **Fixed** - Bugs corrigidos
- **Security** - Correções de segurança
---
## Contribuindo
Se você encontrou um bug ou deseja sugerir uma melhoria:
1. Verifique se já existe um issue similar
2. Descreva o bug/sugestão em detalhes
3. Inclua versão do mod, NeoForge e Minecraft
4. Se possível, inclua prints ou logs de erro
---
## Suporte
Para suporte ou dúvidas:
- GitHub Issues: [link para issues]
- CurseForge Comments: [link para comentários]
- Email: caristeotecnologia@gmail.com
---
**Última atualização:** 14/07/2026
**Versão atual:** 1.0.0
**Status:** Pronto para CurseForge ✅
All Relations
- All Relations
- Embedded Library
- Optional Dependency
- Required Dependency
- Tool
- Incompatible
- Include
This mod has no related projects