Instant Gratification: Stack Size Adjuster Wiki
Bem-vindo à documentação enciclopédica oficial do Instant Gratification: Stack Size Adjuster. Este mod para Fabric no Minecraft permite que administradores de servidores e jogadores personalizem dinamicamente os limites de pilhas de itens em três categorias naturais (itens empilháveis até 64, até 16 e não empilháveis) até quantidades extremas sem inflação de NBT, além de otimizar a queda de contêineres e oferecer proteção contra transbordamento.
📌 Isenção de responsabilidade sobre o código-fonte: A documentação nesta Wiki reflete o estado atual do código-fonte no repositório, que pode incluir commits recentes não lançados ou recursos em desenvolvimento antes dos lançamentos públicos no CurseForge e Modrinth.
📦 Diretório de versões do Minecraft
- Guia do Minecraft 26.2 — Instalação oficial, dependências e configuração para Minecraft 26.2.
- Matriz de compatibilidade de versões — Versões suportadas, verificação
ModVersionGuarde limites de dependências.
🎮 Guias para jogadores e administradores
- Referência de GameRules dinâmicas — GameRules no jogo (
items_64_limit,items_16_limit,items_1_limit,max_drop_entities). - Limites de empilhamento por categoria — Funcionamento do dimensionamento de itens de 64, 16 e itens únicos.
- Otimização de quedas de contêineres — Limites de entidades geradas, divisão de slots e prevenção de lag ao quebrar baús.
- Proteção contra transbordamento de baús grandes — Matemática de transbordamento de inteiros (limite seguro de $39.768.215$) e criação rápida de dupla precisão.
- Configuração do ModMenu e YACL — Configuração no menu principal (
stack-size-adjuster.json) e integração com tela YACL 3.9.5. - Renderização da quantidade de itens na GUI — Redução dinâmica de escala de fonte para números de vários dígitos.
- Integração com Item Clumps — Sinergia de mesclagem de entidades no chão com Item Clumps.
- Solução de problemas e Perguntas Frequentes — Dúvidas comuns, prevenção de transbordamento e sincronização servidor-cliente.
💻 Referência técnica e para desenvolvedores
- Configuração de desenvolvedor e compilação — Ambiente JDK 25, Gradle 9.3+, Loom 1.15+ e fluxos de compilação.
- Arquitetura e estrutura de pacotes — Árvore de arquitetura do sistema, pacotes e segurança de concorrência.
- Referência de Mixins e pontos de injeção — Pontos de injeção em
Item,ItemStack,Container,GiveCommandeDataComponents. - API de sobreposição para addons — Registro de sobreposições personalizadas via
StackSizeManager.registerOverride. - Protocolo de sincronização de rede — Carga útil S2C
stack-size-adjuster:sync_limite atualização de inventário ao vivo. - Processamento do comando Give —
GiveCommandHelperpersonalizado que suporta grandes pilhas sem travamentos. - Perfis de comportamento e condições — Máquina de estados de sincronização de GameRules.
- Guia de integração para mods consumidores — Guia de integração completo para desenvolvedores de complementos.
- Desempenho e impacto na memória — Zero inflação de NBT e benchmarks de memória.
- Progressos e distintivos — Matriz de progressos e paridade com o jogo original.
📜 Direitos autorais e atribuição
Desenvolvido por Dasik (Rifaditya) sob a GNU General Public License v3.0 (GPLv3).
