diff --git a/gradle.properties b/gradle.properties index 3685892..08d2f8f 100644 --- a/gradle.properties +++ b/gradle.properties @@ -23,7 +23,7 @@ neoVersion = 20.4.196 parchmentVersion = 2024.02.25 # Mod Dependencies -aeVersion = 17.10.4-beta +aeVersion = 17.12.0-beta jeiVersion = 17.3.0.49 reiVersion = 14.0.688 emiVersion = 1.1.2 diff --git a/guidebook/assets/gui.png b/guidebook/assets/gui.png new file mode 100644 index 0000000..99c693c Binary files /dev/null and b/guidebook/assets/gui.png differ diff --git a/guidebook/merequester.md b/guidebook/merequester.md index f127043..8d990e4 100644 --- a/guidebook/merequester.md +++ b/guidebook/merequester.md @@ -3,21 +3,141 @@ navigation: title: ME Requester icon: requester position: 100 - item_ids: - - merequester:requester - - merequester:requester_terminal +item_ids: + - merequester:requester + - merequester:requester_terminal --- # ME Requester -An add-on mod allowing you to keep items and fluids in your ME-System in stock. + + + + -### Getting Started +An add-on mod allowing you to keep items and fluids in your [ME System](ae2:getting-started.md#your-very-first-me-system) in stock. +
-To get started, place a and connect it to your network. Make sure to connect it to the same network -your Autocrafting logic is located in. It should host your crafting CPUs and -s. +## Getting Started -After configuration, it will operate automatically and scan if the specified items or fluids fall below a certain threshold. When falling -below the threshold, it will request crafts until the desired amount is reached again. You can also configure a batch size to specify how -many crafts are requested at once. +To get started, place a and connect it to your network. Make sure to connect it to the same network your +[Autocrafting](ae2:ae2-mechanics/autocrafting.md) logic is located in. It should host your +[Crafting CPU](ae2:ae2-mechanics/autocrafting.md#the-crafting-cpu)s and s. + + + +In order for the to function, you need to make sure that items or fluids you want to keep in stock have a pattern +and can also be crafted if you request them as a player. It will only automate the requesting itself. Crafting is handled by the +[ME System](ae2:getting-started.md#your-very-first-me-system). +
+ + + +## Configuration + +When opening the for the first time, you will see an overview of request settings. The number of slots a single +block can host is adjustable in the config. Each row of the GUI represents an individual request. +
+ +### Toggle Switch + +The checkbox to the left toggles the request configured on that row. When a request is disabled, no checks will run and the stock of your +request will not be maintained.
+This can be used to temporarily disable a specific request or to prevent the from emitting crafting jobs while +you are still making changes to a row. +
+ +### What to Stock + +In the second column, you can specify what you want to keep in stock. The slots are ghost slots and will not hold actual items. When +dragging an item to the slot, you can use right click to set the amount to 1 or left click to use the amount the stack you are dragging has. +When dragging a bucket with a fluid to the slot, you can use right click to set the contained fluid or left click to set the bucket itself. +You can also shift-click items to quickly set the item type. If you don't have the desired item in your inventory, you can also drag and +drop it from recipe viewers that are supported by Applied Energistics. +
+ +### Amount to Stock + +The Amount to Stock field indicates how much to stock. Specify what to stock first and then enter your desired value. For non-item requests, +the field will adapt to the type. For example, showing a `B` to indicate buckets for fluid.
+When the current stock falls below the specified amount, the will request more. +
+ +### Batch Size + +The next input field specifies the batch size that will be requested once the current stock falls below the threshold specified in the +Amount to Stock field.
+This can be used to put less stress on [Crafting CPU](ae2:ae2-mechanics/autocrafting.md#the-crafting-cpu)s and machines used in the craft +since the full amount will be requested at once, rather than as many individual jobs. +
+ +### Submit Button + +To apply changes to the request, enter the desired values in the Amount to Stock and Batch Size fields and then either press Enter or click +the submit button to the right on the current row. Clicking into any other row will reset the values to their previous state. +
+ +### Status Bar + +The bar below the input boxes and the submit button reflects the current status of the request. +
+
+ +## Statuses + +The following statuses are displayed in the status bar for each request. +
+ +### Gray - Empty + +The current row is disabled or nothing to stock has been specified. +
+ +### Green - Idling + +The target amount to stock is already reached or there is no pattern for the configured request. +
+ +### Red - Missing Ingredients + +The system is missing the required ingredients to emit the current job. It will continue as soon as enough ingredients are found in the +system. +
+ +### Yellow - Crafting + +The desired request is currently being crafted. The requester is waiting for the job to finish.
+While this status is active, the settings for the respective request inside the are locked and can't be changed. +
+ +### Purple - Exporting + +The received all results from the current job and is trying to export them into the storage system.
+This status is usually not visible. If it's active for too long, it means there is not enough space in your storage system. +
+ +### Block Appearance + +If any request in a has any status except idle or empty, it will change its appearance. + + + + Inactive + + + + Active + + + +
+ +## Terminal + +The mod also provides a new terminal called the . It allows you to access all s +in the same network from a central point. + +The terminal has the same features as the and allows you to search for a specific request. +Since all s have the same name by default, all requests will be grouped under the +same header. If you want a separate group of s in the , you can rename them in +an anvil or with the .