Merge pull request #37 from Satherov/mkdocs

Mod Guides Section, AE2 Guide and restructuring

docs/.pages

@@ -13,6 +13,7 @@ nav:
    - All The Mods 6: atm6
    - Legacy Packs: legacy
 # - Misc: misc
- - Additional Guides : guides
+ - Mod Guides: mods
+ - Additional Guides: guides
  - Help: help
  - About: about

docs/atm9/apotheosis.md

@@ -11,7 +11,7 @@ authors:
 
 ## Kaimonick's Apotheosis Overview
 
-[Click here to view Kai's guide!](../guides/kaimonickguides.md/#apotheosis)
+[Click here to view Kai's guide!](../mods/kaimonickguides.md/#apotheosis)
 
 ## Starting Enchanting Setup
 

docs/atm9/mysticalagriculture.md

@@ -64,7 +64,7 @@ ATM9 adds **Mystical Agriculture Tiered Crystals** which, as the name suggests,
 
 !!! warning "This farm requires a general understanding of **AE2** and **Thermal Series**"
 
-[Click here to view Kai's AE2 guide!](../guides/kaimonickguides.md/#apotheosis)
+[Click here to view Kai's AE2 guide!](../mods/kaimonickguides.md/#apotheosis)
 
 <!--- No I did not link to apotheosis on accident ^^^ --->
 

docs/atm9/productivebees.md

@@ -10,7 +10,7 @@ authors:
 
 ## Kaimonick's Bee Guides
 
-[Click here to view Kai's bee guide!](../guides/kaimonickguides.md/#productive-bees)
+[Click here to view Kai's bee guide!](../mods/kaimonickguides.md/#productive-bees)
 
 ## Jonh09's Bee Guide
 

docs/guides/.pages

@@ -1,5 +1,4 @@
 nav:
  - Contributing to ATG: contributing
  - Contributing Translations: translations.md
- - kaimonickguides.md
  - ...

docs/guides/README.md

@@ -10,7 +10,7 @@ description: How our guides work!
 
 #### Welcome to the Guides! 
 
-You'll find various mods in the sidebar with tips on how they can be utilized, as well as how to contribute your own guides to this website or to help contribute translations!
+Here you'll fine out how to contribute your own guides to this website or to help contribute translations as well as some tips on how to create your own guides!
 
 ---
 

docs/mods/.pages

@@ -0,0 +1,6 @@
+nav:
+ - Mod Guides: README.md
+ - Kaimonick's Guides: kaimonickguides.md
+ - Applied Energistics 2: ae2
+ - Bigger Reactors: biggerreactors.md
+ - Integrated Dynamics: integrateddynamics

docs/mods/README.md

@@ -0,0 +1,17 @@
+---
+title: All The Guides
+name: Mod Guides
+description: All the Mod Guides
+---
+
+# Mod Guides
+
+---
+
+#### Welcome to the Mod Guides!
+
+This section is essentially a mini-wiki for loads of mods, filled with tips and setups to make your playthrough as pleasant as possible.
+
+---
+
+> All The Mods | [GitHub](https://github.com/AllTheMods) | [Discord](https://discord.com/invite/allthemods) | [Akliz Server Hosting](https://www.akliz.net/allthemods)

docs/mods/ae2/.pages

@@ -0,0 +1,9 @@
+nav:
+ - Applied Energistics 2: README.md
+ - Introduction: introduction.md
+ - Channels: channels.md
+ - P2P: p2p.md
+ - Storage: storage.md
+ - Autocrafting: autocrafting.md
+ - Subnets: subnets.md
+ - Setups: setups

docs/mods/ae2/README.md

@@ -0,0 +1,59 @@
+---
+title: Applied Energistics 2
+description: Applied Energstics 2 Guide
+authors: 
+  - Satherov
+---
+
+# Applied Energistics 2
+
+---
+
+![](img/logo.png)
+
+Welcome to Applied Energistics 2 and my attempt at a guide that's simple enough for anyone to understand.
+
+!!! tip "If you're wondering how to automate something or need a step-by-step, you can look into the [Setups](setups) section"
+
+---
+
+## Capabilities of AE2
+
+AE2 probably one of the most **well-known** mods out there, and the best (completely unbias) mod out there.
+
+### Logistic
+With AE2 you can move so many **different things** around and in probably the **best** performing way any mod does. Using your **Me System** you can move any item anywhere at any point at near instant speeds.  
+
+### Storage
+The **Matter Energy System** can be used to store many different things, ranging from items and fluids to mana and energy. You can store **billions** of items without much effort, search for them and use all those items to craft even more.
+
+### Autocrafting
+Using all the stored items from your system, you can **autocraft** both using AE2's Molecular Assemblers or machines from **other mods**. You can make ginormous crafts, using millions of items and dozens of machines and AE2 will take all this effort from you with a single click.
+
+---
+
+## Limitations of AE2
+
+I know many people out there prefer **Refined Storage** because of its simpler approach to a lot of things, so I want to use this opportunity to address some of the seemingly **nonsensical limitations** right away.
+
+### Channels
+Probably the biggest complaint right at the beginning: **Channels**. Channels arent as much of a problem as so many people make it seem.
+
+You can easily get thousands of Channels, and when using P2P, moving all those Channels isn't much of an issue as well.
+
+For more info on channels, check [Channels](channels.md)
+
+### Type Limit
+The so despaired **Type Limit** the **ME Storage Cells** have, once again exists for a very simple reason: Protecting you from yourself.
+
+**NBT Items** or items with unique data on them, cannot be stacked unlike regular items and therefore take up quite a bit of memory. If you have too much memory in a single chunk, your game will **crash**, and you will be locked out of your world.
+
+AE2 directly discourages you from having too many **NBT Items** inside your **ME System** by making them fill your storage incredibly quickly. Other Mods like **Refined Storage** do ***not*** have this limitation and therefore will very quickly run into issues. 
+
+There are also some **Applied Energistics Addons** that promise to either remove or increase the type limit. **ABSOLUTELY DO NOT TRUST THEM!** Some of the mods that remove the Type limit have some ways to prolong the effects of NBT Overflow, but especially the ones that just increase the limit often have **absolutely no protection!**
+
+For more info on Types, check [Storage](storage.md)
+
+---
+
+> Applied Energistics 2 | [Curseforge](https://www.curseforge.com/minecraft/mc-mods/applied-energistics-2)

docs/mods/ae2/autocrafting.md

@@ -0,0 +1,119 @@
+---
+title: Applied Energistics 2
+description: Autocrafting with the ME System and how to connect it to other mods
+authors:
+  - Satherov
+---
+
+# Autocrafting
+
+---
+
+Probably *the* thing your ME System is supposed to do for you is taking all that nasty crafting from you and have it **autocraft** for you. In this Section I'm going over how you set up your **ME System** for just that.
+
+---
+
+## Crafting Pattern
+
+To get your System to do anything, you need to teach your System how to do it first. For that, AE2 offers **four different Patterns**, which you can make in the **Pattern Encoding Terminal**. 
+
+!!! tip "You can paste in any recipe from **EMI** by clicking the `+` icon. You can also **drag** items from EMI"
+
+???+ info "Crafting"
+    All but the **Processing Patterns** are done in the **Molecular Assembler**. You do **not** have to connect a **Smithing Table** or **Stonecutter** to a **Pattern Provider**.
+
+### Crafting Pattern
+The **Crafting Pattern** is used to automate all recipes done in the **Crafting Table**. 
+
+???+ note "Substitution"
+    - ![](img/patternSubstitution.png) When creating Patterns, you can see these small buttons. They allow you to enable/disable Substitution
+    - The first one allows you to toggle **Item Substitution**. When **disabled**, your system will only use the **exact** items set in the pattern. **Disable** this if you have a recipe with **NBT-Items** or reusable items such as **Tools**.
+    - The second one allows you to toggle **Fluid Substitution**. When **enabled**, your system will use Fluids directly, instead of a **bucket** with the Fluid inside.
+
+### Processing Pattern
+The **Processing Pattern** can be used to automate basically anything. You have to specify the Input and expected Output yourself. 
+
+!!! danger "Reusable Items"
+    **Processing Patterns** do not have Substitution and always use the **exact** Item. 
+    Therefore, you have to make sure you **don't** have any items in a craft that get **reused** or your System will try to make one of said reusables for **every single craft**.
+    ??? example "Inscriber Presses"
+        **Inscriber Presses** are a prime example, for something that should **not** be included in a Pattern.
+
+### Smithing Table Pattern
+The **Smithing Table Pattern** is used to automate all recipes done in the **Smithing Table**, such as turning Diamond gear into **Netherite**.
+
+### Stonecutting Pattern
+The **Stonecutting Pattern** is used to automate all recipes done in the **Stonecutter**, such as turning a full block into slabs.
+
+---
+
+## Pattern Provider
+
+The **Pattern Provider** is the star of autocrafting. It's the block that **pushes** the items set by the **Patterns** into adjacent machines.
+
+You can set the Pattern Provider to **Blocking Mode**, which will **prevent** it from pushing another batch of items into an inventory if there are **already** some inside. 
+This is useful for automating something like the **Powah Energizing Orb**.
+
+!!! tip "You can access all Pattern Providers connected to a System via the **Pattern Access Terminal**."
+
+### Molecular Assemblers
+They normally go hand-in-hand with the **Pattern Provider**. If you place the **Molecular Assemblers** place next to them, they will be able to craft all but the **Processing Patterns**.
+
+The best possible Setup is a **Pattern Provider** surrounded by **6 Molecular Assemblers**.
+
+!!! info "Molecular Assemblers do not consume a channel, but still transfer up to 8 Channels"
+
+!!! tip "It's very much recommended you use **Acceleration Cards** to speed up your Assemblers"
+
+![](img/ppSetup.png)
+
+### Other Machines
+You can use the **Pattern Provider** to automate almost **any machine**. Once you request a craft, it will automatically **push** a batch of items into **neighboring** inventories.
+
+![](img/ppAltSetup.png)
+
+---
+
+## Crafting Processing Units
+
+The **CPUs** will decide how **large** your craft can be and how many **steps** of the recipe will be crafted at once. 
+Each Multiblock will only do **1 Request** at a time. If you want to start multiple requests at the same time, you'll have to build more **CPUs**
+
+### Crafting Monitor
+Probably the most boring part. All it does is show the current craft being fulfilled by the CPU.
+
+### Crafting Storage
+The **Crafting Storage** will decide how **large** the craft can be. The larger a Craft can be, the more **sub-steps** it can have.
+
+They come in the same sizes as **Storage Cells** and also use **Bytes**.
+
+### Co-Processors
+The Amount of **Co-Processors** tells the System **how often** to send **how many** items to the Pattern Providers, essentially speeding up the craft.
+
+They are generally **more important** than the **Crafting Storage**.
+
+### The Multiblock
+The structure **MUST** be **rectangular**. Any other Shape will **not** work.
+
+![](img/craftingCpu.png)
+
+!!! tip "Crafting Storage to Co-Processors ratio"
+    It's recommended that you have a lot more **Co-Processing Units** than **Crafting Storage**. 
+    For most crafts, a single max-sized **Crafting Storage** will be large enough, so just spam a bunch of **Co-Processors**.
+
+!!! info "The entire Multiblock only takes 1 Channel"
+
+---
+
+## Requesting a Craft
+
+Now that you have all the setup, you want to actually request a craft. You can do this by simple `Middle-Clicking` on the Item in your Terminal, specify an amount and click **craft**.
+
+!!! warning "Make sure you don't have a **Keybind conflict**. Sorting your inventory is often causing trouble"
+
+!!! tip "Keep Stock"
+    Do you always want to have a set amount of a certain Item in your ME System? You can use an **ME Requestor**.
+
+---
+
+> Applied Energistics 2 | [Curseforge](https://www.curseforge.com/minecraft/mc-mods/applied-energistics-2)

docs/mods/ae2/channels.md

@@ -0,0 +1,100 @@
+---
+title: Applied Energistics 2
+description: Channels, Wireless and Quantum Ring
+authors:
+  - Satherov
+---
+
+# Channels
+
+---
+
+Here, I'm going to teach you all about **Channels**, how to **wirelessly** move them, as well as how **P2P** works.
+
+---
+
+## Obtaining Channels
+
+To even get some Channels, you'll need the **ME Controller** which will provide you with **32 Channels** per face.
+
+![](img/obtainingChannels.png)
+
+### Ad-Hoc Network
+
+You can have a Network **without** a controller, but you can only have a maximum of **8 Devices** in it. Such a network is commonly referred to as an **Ad-Hoc-Network**. You'll need to supply power to it through somthing like the **Energy Acceptor** or the **Crystal Resonance Generator**, a device that can directly connect to AE2 Cables and produces a small amount of free Energy.
+
+![](img/ad-hoc-network.png)
+
+---
+
+## Moving Channels
+
+To get your channels to where you want, you'll obviously need some **Cables**. There are **Small Cables** which carry **8 Channels** and **Dense Cables** which carry **32 Channels**
+
+|        Name         | Channels |    Shows Usage    |
+|:-------------------:|:--------:|:-----------------:|
+|     Glass Cable     |    8     | :material-close:  |
+|    Covered Cable    |    8     | :material-close:  |
+|     Smart Cable     |    8     | :material-check:  |
+| Dense Covered Cable |    32    | :material-close:  |
+|  Dense Smart Cable  |    32    | :material-check:  |
+
+### Internal
+Full Block Devices, like the **Interface** or the **Pattern Provider** can move up to **8 Channels** through them, acting as a **small Cable**.
+
+### Cable Variants
+Additionally, there are also a handful of **subcategories** of cables.
+
+- **Covered Cables** are purely visual and offer no gameplay advantage.
+- **Smart Cables** will display the **Amount of Channels** currently used at the top of the screen. (Required is WAILA / TOP / Jade / etc.)
+
+![](img/jade.png)
+
+### Colored Cables
+All Cables are available in **17 different Colors**, all vanilla colors and **Fluix**, which is the "default" color.
+
+- **Colored Cables** will **not** connect to each other.
+- **Fluix Cables** will connect to **any** cable.
+- To completely prevent cables connecting to each other, use **Cable Anchors**.
+
+### Hiding Cables
+You can hide Cables using **Facades**. Surround any block with **Cable Anchors**.
+
+![](img/facadeRecipe.png)
+
+### Moving Power, but not Channels
+To power something without giving it **Channels** use a **Quartz Fiber**.
+
+---
+
+## Channel Usage
+
+Every device connected to your **ME Network** will need a **Channel** to function. If you don't have enough Channels on a Cable, the device will no work.
+
+![](img/channelUsage.png)
+
+???+ example "Imagine **Channels** as **USB-Cables**"
+    - You have a bundle of **USB-Cables**. (ME Cable)
+    - You get those Cables from your **PC**. (ME Controller)
+    - Each Device you plug in, needs one **USB-Connection**. (one Channel)
+    - If you run out of **USB-Connections** you still have your Bundle, but no more connections. (No more channels on the cable)
+
+---
+
+## Wirelessly moving Channels
+
+When it comes to moving Channels **without** Cables, you have two options.
+
+### Wireless Connector
+The **Me Wireless Connector** can move up to **32 Channels** over a short distance and can also be **colored**. They use an **exponential amount** of **Energy** for every block and they do **not** work **cross-dimensionally**. They need to be connected via the **ME Wireless Setups Kit**.
+
+![](img/wirelessConnectors.png)
+
+### Quantum Ring
+The **Quantum Ring** is a **3x3x1 Multiblock** that can transfer up to **32 Channels** over an **infinite distance** and also functions **cross-dimensionally**. To link two **Quantum Rings** you will need **Quantum Entangled Singularities**, of which you get two by **blowing up** an **Enderpearl** and a **Singularity**.
+
+![](img/quantumRing.png)
+
+---
+
+> Applied Energistics 2 | [Curseforge](https://www.curseforge.com/minecraft/mc-mods/applied-energistics-2)