backpack-infinita/README.md

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
• Sistema de Cursor: Controle preciso ao mover itens entre mochila e inventário

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 no cursor
   • Shift + clique esquerdo: Move stack todo diretamente pro inventário
3. Para colocar itens no inventário (com item no cursor):
   • Clique esquerdo no slot vazio: Coloca stack todo
   • Clique direito no slot vazio: Coloca 1 item
4. Para mover itens pro mochila:
   • Shift + clique esquerdo no item: Move diretamente
   • Clique esquerdo no item: Move pro cursor
5. 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

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.