ENG

🌌 R.A.S.G.O. — Complete Guide and Official Overview

R.A.S.G.O. (Resource Automation, Storage, Generation & Operations) is a technology mod for Minecraft 1.20.1 (Forge and NeoForge) that revolutionizes mass storage, remote automation, autocrafting, and resource generation. It was developed with a strict focus on maximum server performance (zero TPS lag), mathematical safeguards against item loss, and a modern industrial aesthetic inspired by the legendary Applied Energistics 2.

---

🧭 Table of Contents

1. The Heart of the System: R.A.S.G.O. Core
2. Security and Private Networks
3. Access Terminals & Built-in Magnet
4. Instant, Unlimited Autocrafting
5. Core Upgrade Modules
6. The Ultimate Challenge: Creative Upgrade & 9x Blocks
7. Remote Automation: Cables, Buses, and Interfaces
8. Infinite Resource Generation & Alchemy
9. Management Commands
10. Installation and Compatibility

---

1. The Heart of the System: R.A.S.G.O. Core

The Core is the central brain of every RASGO network.

• Effectively Infinite Virtual Capacity: Unlike conventional chests or pipe mods that drop physical item entities into the world when broken or overload chunks with bloated NBT data, RASGO uses a structure called a Transactional Ledger.
• 64-bit Item Counts (long): Each item type can have up to 9,223,372,036,854,775,807 (9.22 quintillion) units stored.
• Atomic Transactions: If the server crashes at the exact millisecond of a transfer, the system safely rolls back the operation. Items are never duplicated or deleted.

---

2. Security and Private Networks

RASGO features a robust permissions system for multiplayer servers:

• Protected Ownership: When you first place a Core, it binds to the player who placed it. Other players cannot break the block or remove its upgrades without permission.
• Open Networks: Friends and external pipes can freely deposit and withdraw items.
• Password-Protected Networks: Require password authentication, secured with a server-side salt.
• Member List: The owner can authorize specific player usernames directly through the security interface.

---

3. Access Terminals & Built-in Magnet

The terminal interface was designed for maximum ease of use.

🔍 Stationary Terminal and Wireless Terminal

• Instant Search: Enter an item name or search by mod identifier using @modid (e.g., @minecraft, @thermal). Compatible with Just Enough Items (JEI) through the @rasgostorage tag.
• Smart Sort Button: Switches inventory sorting between Name A–Z, Quantity, and Mod, with immediate notifications on screen and in chat.
• Armor Trim Filter: Click the gear icon (⚙) to access the Hide Trims option for recipes. Since the Smithing Upgrade unlocks every smithing template combination in the game, this filter is enabled by default to keep your recipe list clean and focused.
• Properly Layered Interface: Dialog boxes and buttons use a higher OpenGL rendering depth (z = 300), preventing item icons or numbers from showing through menus. Clicking outside a window automatically closes it.

🧲 Wireless Terminal with a 3-Mode Magnet

The Wireless Terminal lets you manage your items and autocrafting remotely. It also features a Built-in Magnet with three item collection modes:

1. OFF: Disables the magnet.
2. PLAYER: Pulls all nearby dropped items directly into the player's inventory.
3. NET: Collects dropped items and instantly sends them to the RASGO network's central storage!

---

4. Instant, Unlimited Autocrafting

Say goodbye to slow crafting systems that take minutes to complete crafting chains:

• Instant, Same-Tick Processing: If the materials are available in the network, an order for 1,000 pistons or complete armor sets is processed, crafted, and delivered within the same game tick.
• No Quantity Limit: Request as many items as you want at once, without artificial queue size restrictions.
• Precise Chat Notifications: If a complex recipe tree is missing an ingredient, the Core sends a clear report to your chat identifying the exact component and quantity required.
• Flexible Module Placement: Install your modules in any of the Core's seven upgrade slots.

---

5. Core Upgrade Modules

Interact directly with the Core using Shift + Right-Click to access its seven upgrade slots:

---

6. The Ultimate Challenge: Creative Upgrade & 9x Blocks

For the most ambitious players and servers focused on extreme automation, the Creative Upgrade now has a legitimate survival crafting recipe.

Place an Infinity Matrix in the center of the crafting grid and surround it with eight 9x Compressed Netherite Blocks:

Output: Creative Upgrade

🧱 Compressed Netherite Blocks (1x to 9x)

• Nine Netherite Blocks make a 1x Block. Nine 1x Blocks make a 2x Block, continuing all the way to the legendary 9x Block.
• Each block features gold-forged corner pieces and unique numerical markings. They can also be placed in the world as decorative blocks to show off your achievement.
• Supports lossless decompression: placing one compressed block in a crafting grid returns nine blocks of the previous tier, with no waste.
• A single 9x Block contains the equivalent of 3,486,784,401 Netherite Ingots.
• The eight 9x Blocks surrounding the center of the final recipe require approximately 27.89 billion Netherite Ingots!

🌌 Infinity Matrix

• The heart of the recipe: a 24-frame animated texture running at 60 FPS, depicting a cosmic spiral galaxy swirling inward like a fluid vortex.
• Crafted with one Nether Star, four Diamond Blocks, and four Netherite Ingots.

---

7. Remote Automation: Cables, Buses, and Interfaces

Easily connect chests, furnaces, and machines from other mods:

• Importer: Pulls items from adjacent inventories into the RASGO network. Redesigned with AE2's compact, directional bus form factor.
• Exporter: Sends filtered items from the network to external inventories and machines.
• Storage Connector: Exposes the network's entire inventory to external pipes and systems through Forge capabilities (ItemHandler and FluidHandler).
• Six-Sided Interfaces: Full cubic block variants that can pull or send items in all six directions simultaneously.
• Remote UUID Linking: No need to run miles of continuous cables! Connectors can be remotely linked to the UUID of an existing Core anywhere on the map, operating across arbitrary distances.

---

8. Infinite Resource Generation & Alchemy

Install generator cards in the Core's cell slots to make your network automatically synthesize resources:

• Resource Cards: Infinite Water, Lava, Cobblestone, Smooth Stone, Granite, Diorite, Andesite, Netherrack, and End Stone.
• Automated Alchemy with Infinite Water: Installing an Infinite Water Card in the Core allows the autocrafting system to automatically fill empty glass bottles, enabling chained potion crafting, such as Awkward Potions, without manually collecting water with a bucket.

---

9. Management Commands

Use the /rasgo commands to simplify server administration:

• /rasgo networks: Lists all networks owned by your player.
• /rasgo recover <UUID>: Recovers a network whose physical Core was lost or needs to be reconnected.
• /rasgo claim: Claims the Core you are pointing at.
• /rasgo security: Opens quick network protection options.

---

10. Installation and Compatibility

• Minecraft Version: 1.20.1
• Mod Loader: Forge (47.4.13+) or NeoForge (1.20.1) — 100% native compatibility.
• Java: Java 17
• Languages: Complete, synchronized translations in Brazilian Portuguese (PT-BR) and English (EN-US).
• Recommended Mod: JEI (Just Enough Items) for dynamic recipe viewing.

-----------------------------------------------------------------------------------------------------------------------

PT - BR

🌌 R.A.S.G.O. — Guia Completo e Apresentação Oficial

R.A.S.G.O. (Resource Automation, Storage, Generation & Operations) é um mod tecnológico para Minecraft 1.20.1 (Forge e NeoForge) que revoluciona o armazenamento em massa, a automação remota, o autocrafting e a geração de recursos. Ele foi desenvolvido com foco estrito em desempenho máximo de servidor (zero lag de TPS), segurança matemática contra perda de itens e uma estética industrial moderna inspirada no lendário Applied Energistics 2.

---

🧭 Índice do Guia

1. O Coração do Sistema: R.A.S.G.O. Core
2. Segurança e Redes Privadas
3. Terminais de Acesso & Magneto Integrado
4. Autocrafting Instantâneo e Sem Limites
5. Módulos de Upgrade do Core
6. O Desafio Máximo: Creative Upgrade & Blocos 9x
7. Automação Remota: Cabos, Buses e Interfaces
8. Geração Infinita de Recursos & Alquimia
9. Comandos de Gerenciamento
10. Instalação e Compatibilidade

---

1. O Coração do Sistema: R.A.S.G.O. Core

O Core é o cérebro central de qualquer rede RASGO.

• Capacidade Virtual Efetivamente Infinita: Ao contrário de baús convencionais ou mods de tubos que soltam entidades físicas de itens no mundo quando quebrados ou sobrecarregam chunks com dados NBT excessivos, o RASGO utiliza uma estrutura chamada Ledger Transacional.
• Contagem de 64 bits (long): Cada tipo de item pode ter até 9.223.372.036.854.775.807 (9,22 quintilhões) de unidades armazenadas.
• Transações Atômicas: Se o servidor cair no exato milissegundo de uma transferência, o sistema reverte a operação com segurança. Os itens nunca são duplicados nem excluídos.

---

2. Segurança e Redes Privadas

O RASGO possui um sistema robusto de permissões para servidores multiplayer:

• Propriedade Protegida: Ao colocar um Core pela primeira vez, ele se vincula ao jogador que o posicionou. Outros jogadores não podem quebrar o bloco nem remover seus upgrades sem permissão.
• Redes Abertas: Amigos e tubos externos podem depositar e retirar itens livremente.
• Redes Protegidas por Senha: Exigem autenticação por senha, protegida com salt no servidor.
• Lista de Membros: O proprietário pode autorizar nomes de jogadores específicos diretamente pela interface de segurança.

---

3. Terminais de Acesso & Magneto Integrado

A interface do terminal foi projetada para oferecer o máximo de praticidade.

🔍 Terminal Fixo e Wireless Terminal

• Busca Instantânea: Digite o nome de um item ou pesquise pelo identificador do mod usando @modid (por exemplo, @minecraft e @thermal). Compatível com Just Enough Items (JEI) por meio da tag @rasgostorage.
• Botão Sort Inteligente: Alterna a organização do inventário entre Nome A–Z, Quantidade e Mod, com notificações imediatas na tela e no chat.
• Filtro de Ornamentos de Armadura: Clique na engrenagem (⚙) para acessar a opção Ocultar Trims nas receitas. Como o Smithing Upgrade desbloqueia todas as combinações de moldes de ferraria do jogo, esse filtro vem ativado por padrão para manter sua lista de receitas limpa e objetiva.
• Interface Organizada em Camadas: As caixas de diálogo e os botões utilizam uma profundidade maior na renderização OpenGL (z = 300), impedindo que ícones ou números de itens apareçam sobre os menus. Clicar fora de uma janela a fecha automaticamente.

🧲 Wireless Terminal com Magneto de 3 Modos

O Wireless Terminal permite gerenciar seus itens e o autocrafting à distância. Ele também possui um Magneto Integrado com três modos de coleta:

1. OFF: Desativa o magneto.
2. PLAYER: Puxa todos os itens próximos que estiverem no chão diretamente para o inventário do jogador.
3. NET: Coleta os itens do chão e os envia instantaneamente para o armazenamento central da rede RASGO!

---

4. Autocrafting Instantâneo e Sem Limites

Diga adeus a sistemas lentos que levam minutos para concluir cadeias de fabricação:

• Processamento Instantâneo no Mesmo Tick: Se os materiais estiverem disponíveis na rede, um pedido de 1.000 pistões ou conjuntos completos de armadura é processado, fabricado e entregue no mesmo tick do jogo.
• Sem Limite de Quantidade: Solicite quantos itens quiser de uma só vez, sem restrições artificiais no tamanho da fila.
• Notificações Precisas no Chat: Se faltar algum ingrediente em uma árvore complexa de receitas, o Core envia um relatório claro no chat, identificando exatamente o componente e a quantidade necessários.
• Posicionamento Livre dos Módulos: Instale seus módulos em qualquer um dos sete compartimentos de upgrades do Core.

---

5. Módulos de Upgrade do Core

Interaja diretamente com o Core usando Shift + Botão Direito para acessar seus sete compartimentos de upgrades:

---

6. O Desafio Máximo: Creative Upgrade & Blocos 9x

Para os jogadores mais ambiciosos e servidores focados em automação extrema, o Creative Upgrade agora possui uma receita legítima de sobrevivência.

Coloque uma Infinity Matrix no centro da bancada e cerque-a com oito Blocos de Netherite Comprimidos 9x:

Resultado: Creative Upgrade

🧱 Blocos de Netherite Comprimidos (1x até 9x)

• Nove Blocos de Netherite formam um Bloco 1x. Nove Blocos 1x formam um Bloco 2x, progredindo até o lendário Bloco 9x.
• Cada bloco possui cantoneiras forjadas em ouro e marcações numéricas exclusivas. Eles também podem ser colocados no mundo como blocos decorativos para exibir sua conquista.
• Oferece descompressão sem perdas: colocar um bloco comprimido na bancada devolve nove blocos do nível anterior, sem desperdício.
• Um único Bloco 9x contém o equivalente a 3.486.784.401 Barras de Netherite.
• Os oito Blocos 9x que cercam o centro da receita final exigem aproximadamente 27,89 bilhões de Barras de Netherite!

🌌 Infinity Matrix — Matriz da Infinidade

• O coração da receita: uma textura animada de 24 quadros a 60 FPS, representando uma galáxia espiral cósmica girando para dentro de si mesma como um vórtice fluido.
• Fabricada com uma Estrela do Nether, quatro Blocos de Diamante e quatro Barras de Netherite.

---

7. Automação Remota: Cabos, Buses e Interfaces

Conecte facilmente baús, fornalhas e máquinas de outros mods:

• Importer — Importador: Puxa itens de inventários adjacentes para a rede RASGO. Remodelado com o formato compacto e direcional dos buses do AE2.
• Exporter — Exportador: Envia itens filtrados da rede para inventários e máquinas externas.
• Storage Connector: Disponibiliza todo o inventário da rede para tubos e sistemas externos por meio das capabilities do Forge (ItemHandler e FluidHandler).
• Interfaces de Seis Faces: Versões em blocos cúbicos completos, capazes de puxar ou enviar itens nas seis direções simultaneamente.
• Vinculação Remota por UUID: Não é necessário instalar quilômetros de cabos contínuos! Os conectores podem ser vinculados remotamente ao UUID de um Core existente em qualquer ponto do mapa, operando através de distâncias arbitrárias.

---

8. Geração Infinita de Recursos & Alquimia

Instale cartões geradores nos compartimentos de células do Core para fazer sua rede sintetizar recursos automaticamente:

• Cartões de Recursos: Água Infinita, Lava, Pedregulho, Pedra Lisa, Granito, Diorito, Andesito, Netherrack e Pedra do End.
• Alquimia Automatizada com Água Infinita: Instalar um Cartão de Água Infinita no Core permite que o sistema de autocrafting preencha frascos de vidro vazios automaticamente. Isso possibilita a fabricação de poções em cadeia, como Poções Estranhas (Awkward Potions), sem precisar coletar água manualmente com um balde.

---

9. Comandos de Gerenciamento

Use os comandos /rasgo para simplificar a administração do servidor:

• /rasgo networks: Lista todas as redes pertencentes ao seu jogador.
• /rasgo recover <UUID>: Recupera uma rede cujo Core físico foi perdido ou precisa ser reconectado.
• /rasgo claim: Reivindica o Core para o qual você está apontando.
• /rasgo security: Abre opções rápidas de proteção da rede.

---

10. Instalação e Compatibilidade

• Versão do Minecraft: 1.20.1
• Mod Loader: Forge (47.4.13+) ou NeoForge (1.20.1) — compatibilidade 100% nativa.
• Java: Java 17
• Idiomas: Traduções completas e sincronizadas em Português do Brasil (PT-BR) e Inglês (EN-US).
• Mod Recomendado: JEI (Just Enough Items) para visualização dinâmica de receitas.