Files
backpack-infinita/README.md
2025-12-11 19:22:09 -03:00

71 lines
2.3 KiB
Markdown

# Backpack Infinita
Plugin para Minecraft que adiciona uma mochila infinita ao servidor, permitindo armazenar itens ilimitados com paginação e controle preciso de quantidades.
## Funcionalidades
- **Mochila Infinita**: Armazenamento ilimitado com paginação (45 itens por página)
- **Comando**: `/backpack` ou `/bp` para abrir a mochila
- **Controle de Quantidades**:
- Clique esquerdo: Move 1 item para o cursor (permite escolher onde colocar)
- Clique direito no inventário: Coloca 1 item do cursor no slot
- Shift + clique esquerdo: Move o stack todo diretamente
- **Suporte a Itens Renomeados**: Preserva nomes customizados
- **Shulker Boxes**: Tratamento especial - não mesclam para evitar duplicação de conteúdo
- **Limites de Segurança**: Máximo 1000 itens por mochila, validação contra itens inválidos
- **Persistência**: Dados salvos em SQLite, sobrevive reinícios
## Instalação
1. Baixe o JAR mais recente do plugin
2. Coloque o arquivo no diretório `plugins` do seu servidor Minecraft
3. Reinicie o servidor ou use `/reload`
4. Configure permissões se necessário
## Como Usar
1. Digite `/backpack` no chat para abrir sua mochila
2. **Para tirar itens da mochila**:
- Clique esquerdo: Pega 1 item
- Shift + clique esquerdo: Move stack todo diretamente pro inventário
3. **Para mover itens para a mochila**:
- Shift + clique esquerdo no item: Move diretamente para a mochila
4. **Shulker Boxes**: Sempre ficam separadas na mochila para preservar conteúdo
## Permissões
- `backpack.use`: Permite usar o comando /backpack (padrão: todos os jogadores)
## Desenvolvimento
### Pré-requisitos
- Java 21
- Maven
### Compilação
```bash
mvn clean package
```
O JAR será gerado em `target/backpack-infinita-1.1.jar`
### Estrutura do Projeto
- `src/main/java/`: Código fonte
- `src/main/resources/`: Configurações (plugin.yml)
- `pom.xml`: Dependências Maven
## Bugs Conhecidos e Fixes
- Corrigido: Duplicação ao mover itens além do disponível
- Corrigido: Itens renomeados perdendo nome
- Corrigido: Shulker boxes mesclando incorretamente
- Corrigido: Problemas com sistema de cursor
## Suporte
Para bugs ou sugestões, abra uma issue no repositório.
## Licença
Este projeto está sob a licença GNU Lesser General Public License v3.0. Veja LICENSE para detalhes.