|
3 | 3 | GTMoreTools exposes addon APIs for its mod integrations. |
4 | 4 | The table below shows current coverage: |
5 | 5 |
|
6 | | -| Integration | API package | Status | |
7 | | -|---|---|---| |
8 | | -| Tinkers' Construct | `integration.tic.api` | Available | |
9 | | -| Better Builder's Wands | — | No API yet | |
10 | | -| Chisel | — | No API yet | |
| 6 | +| Integration | API package | Status | |
| 7 | +|------------------------|----------------------------------|-------------------------------| |
| 8 | +| Tinkers' Construct | `integration.tic.api` | Available | |
| 9 | +| Better Builder's Wands | — | No API yet | |
| 10 | +| Chisel | — | No API yet | |
| 11 | +| Storage Drawers | `integration.storagedrawers.api` | Available, but for mixin only | |
11 | 12 |
|
12 | 13 | All registration calls must happen during your mod's `preInit` phase, |
13 | 14 | **before** GTMT's `registerBlocks`, unless stated otherwise. |
@@ -160,3 +161,73 @@ Parallel count scales as `4^(tier − EV) / 2` from EV upward. |
160 | 161 | ### Bookshelf variants (Assembler) |
161 | 162 |
|
162 | 163 | 6 wood types × 1 recipe each: 6 planks + 3 Books → carved Bookshelf (100 EU, ULV). |
| 164 | + |
| 165 | +--- |
| 166 | + |
| 167 | +## Storage Drawers Integration |
| 168 | +An addon API currently exists, but it is mixin-based and not usable. The following describes the internal logic for reference. |
| 169 | + |
| 170 | +### What is added |
| 171 | + |
| 172 | +- Storage Upgrades made from GT materials will be registered for the GT materials specified in the cfg. |
| 173 | + |
| 174 | +### Config Options |
| 175 | + |
| 176 | +`removeOriginal` |
| 177 | +- Controls whether the default Storage Upgrade recipes are removed. |
| 178 | + - true: All original Storage Upgrade recipes are removed. Only recipes defined by this mod (via upgradeMaterials) will be available. |
| 179 | + - false: Original recipes remain alongside the newly added ones. |
| 180 | +- Use this if you want to fully replace the default progression with GT-based materials. |
| 181 | + |
| 182 | +`upgradeMaterials` |
| 183 | +- Defines custom materials used to craft Storage Upgrades. |
| 184 | +- Each entry adds a new Storage Upgrade variant based on a GT material. |
| 185 | + |
| 186 | +#### _Format_ |
| 187 | +`modId:materialName@multiplier%tier` |
| 188 | + |
| 189 | +#### _Parameters_ |
| 190 | +- `materialName`: Must be a valid GT material with a dust property. |
| 191 | +- `multiplier`: Determines the storage capacity multiplier of the upgrade. |
| 192 | + - Range: 1 to 2147483647 |
| 193 | + - Not affected by the StorageDrawers config. |
| 194 | +- `tier` (optional): Required Field Generator tier. |
| 195 | + - Range: 1 (LV) to 8 (UV) |
| 196 | + - If omitted, defaults to -1 (no Field Generator required). |
| 197 | + |
| 198 | +#### _Behavior_ |
| 199 | +- A Storage Upgrade using the specified material will be registered for each entry. |
| 200 | +- If the config is empty, only the original materials are available. |
| 201 | +- Original materials (Obsidian / Iron / Gold / Diamond / Emerald): |
| 202 | + - Always included automatically. |
| 203 | + - Use tier -1. |
| 204 | + - Their multipliers are controlled by the StorageDrawers config. |
| 205 | + - **Do NOT define them here.** |
| 206 | + |
| 207 | +#### _Example_ |
| 208 | +`gregtech:steel@4%2` |
| 209 | +- Adds a Steel Storage Upgrade |
| 210 | + - Multiplier: x4 |
| 211 | + - Requires MV-tier Field Generator |
| 212 | + |
| 213 | +#### _Logging_ |
| 214 | +- Registration results can be checked in the log. |
| 215 | +- The process starts with `[GT More Tools]: UpgradeMaterialData registration started.` and ends with `[GT More Tools]: UpgradeMaterialData registration finished.` |
| 216 | +- On successful registration, the following message is logged: `[GT More Tools]: Registered UpgradeMaterial (Material=..., meta=..., multiplier=x..., requiredTier=...)` |
| 217 | + - For example, a successful registration will produce a log like: `[GT More Tools]: Registered UpgradeMaterial (Material=steel, meta=324, multiplier=x4, requiredTier=2 (MV))` |
| 218 | +- Entries with an invalid format will be skipped, and the log will indicate the issue. |
| 219 | + |
| 220 | +### Crafting |
| 221 | + |
| 222 | +``` |
| 223 | +P S P |
| 224 | +S U S |
| 225 | +P X P |
| 226 | +``` |
| 227 | + |
| 228 | +- **P** = `plate` |
| 229 | +- **S** = `screw` |
| 230 | +- **U** = Upgrade Template |
| 231 | +- **X** = If _tier_ is -1, a `stickLong`; otherwise, a `Field Generator` of the specified tier |
| 232 | + |
| 233 | +- _Storage Upgrade_ conversion recipes between StorageDrawers and GTMoreTools are always added for Obsidian / Iron / Gold / Diamond / Emerald. |
0 commit comments