Overview#
Artisan Integrations is a specialized expansion for the Artisan Worktables mod. Its primary purpose is to allow pack creators to integrate Artisan Worktables' complex crafting systems with other popular 1.12.2 mods. By installing this integration, players can use mana from Botania to power their tools, lock advanced crafting recipes behind Game Stages or Reskillable requirements, and utilize GregTech tools within Artisan recipes.
This mod does not function as a standalone; it requires Artisan Worktables and CraftTweaker to be installed. It acts as the glue that allows these systems to communicate, providing ZenScript support for various progression-based mechanics.
Botania Integration#
The Botania integration is the most content-heavy portion of the mod, adding new tool tiers and unique mana-based mechanics.
Mana-Infused Tools
Artisan Integrations adds Manasteel, Elementium, and Terrasteel variants for every tool type provided by Artisan Worktables. These tools possess the same harvest levels and efficiencies as their standard Botania counterparts but are designed for use in the Artisan Worktables tool slots.
| Tool Material | Durability | Mana Repair | Special Ability |
|---|---|---|---|
| Manasteel | 300 | Yes | Repairs using Mana from player's inventory. |
| Elementium | 720 | Yes | Repairs using Mana; higher durability than Manasteel. |
| Terrasteel | 2300 | Yes | Massive durability; efficient mana-to-durability ratio. |
Mana Crafting Mechanics
Beyond simple tool repairs, this integration allows recipes to consume Mana directly from the player's Mana Tablet or Ring instead of consuming tool durability. This is configured via ZenScript, allowing for 'magical' crafting processes that don't wear down the physical tool as long as the player has a sufficient mana supply.
Items#
The mod adds a vast array of tools corresponding to the materials from Botania. Each material type is applied to the full suite of Artisan Worktables tools.
Artisan Botania Tools
The following tools are added in Manasteel, Elementium, and Terrasteel variants:
- Artisan's Athame: Used for delicate magical cutting.
- Artisan's Beaker: Used in chemistry and fluid-based recipes.
- Artisan's Burner: Used for heat-based crafting.
- Artisan's Chisel: Used for stone and decorative carving.
- Artisan's Compass: Used for navigation-themed recipes.
- Artisan's Cutters: Used for wire and sheet metal work.
- Artisan's Driver: Used for mechanical assembly.
- Artisan's File: Used for smoothing and metalwork.
- Artisan's Framer: Used for wood construction.
- Artisan's Hammer: The standard heavy tool for smithing.
- Artisan's Lens: Used for precision optical crafting.
- Artisan's Mortar: Used for grinding materials into dust.
- Artisan's Needle: Used for tailoring and leatherwork.
- Artisan's Pan: Used for cooking-related recipes.
- Artisan's Pliers: Used for fine manipulation.
- Artisan's Punch: Used for leather and sheet holes.
- Artisan's Quill: Used for inscription and scrolls.
- Artisan's Razor: Used for fine shaving and harvesting.
- Artisan's Sifter: Used for separating materials.
- Artisan's Solderer: Used for electronic assembly.
- Artisan's Spanner: Used for heavy machinery adjustment.
- Artisan's Spoon: Used for small-scale material handling.
- Artisan's Trowel: Used for masonry and building.
Progression Integration#
Artisan Integrations provides deep hooks into several progression mods, allowing pack creators to restrict crafting until certain criteria are met.
Game Stages
Recipes in Artisan Worktables can be locked behind specific Game Stages. If a player does not have the required stage, they will be unable to craft the item. Additionally, the mod supports hiding these recipes in JEI (Just Enough Items) until the stage is unlocked.
Reskillable
Integration with Reskillable allows recipes to require specific skill levels. For example, a Masterwork Hammer recipe can be restricted to players with Level 20 Mining and Level 15 Smithing.
From the Ground Up (FTGU)
This integration allows Artisan Worktables recipes to be tied to FTGU research nodes. Players must complete the specific research in their FTGU book before the recipe becomes available in the worktable.
GregTech: Community Edition Integration#
For players using GregTech: Community Edition (GT:CE), this mod enables the use of GT tools within Artisan Worktables.
- Tool Compatibility: GregTech tools like the Wrench, Hammer, and File can be placed in the tool slots of Artisan Worktables.
- Durability Handling: The worktables will correctly consume the durability/energy of GT tools, including electric variants.
- Recipe Logic: Pack creators can write recipes that specifically require a GregTech tool to be present in the worktable's tool slot to complete the craft.
Patchouli Integration#
Artisan Integrations exposes custom recipe templates for Patchouli. This allows modpack authors to create in-game documentation books that automatically display Artisan Worktables recipes in a clean, formatted layout.
Supported templates include:
artisanworktables:recipe: Displays a standard worktable recipe including ingredients, tools, and fluid requirements.artisanworktables:recipe_weighted: Displays recipes that have multiple possible outputs with weighted chances.
Mechanics and Scripting#
The mod functions primarily through ZenScript (CraftTweaker). Below are the mechanical hooks provided for recipe builders:
Scripting Examples
Adding a Game Stage Requirement:
recipe.addGameStage("expert_blacksmith");
Adding a Reskillable Requirement:
recipe.addRequirement("reskillable:mining|10");
Adding an FTGU Research Requirement:
recipe.addResearch("ftgu:research/advanced_smithing");
Hiding Locked Recipes: By default, locked recipes may still show in JEI. This can be toggled in the configuration or via script to ensure players only see what they are capable of crafting:
recipe.setHidden(true);Configuration#
The mod includes a configuration file (artisanintegrations.cfg) that allows for fine-tuning the behavior of the various modules.
- Botania Module: Toggle the registration of Manasteel, Elementium, and Terrasteel tools.
- JEI Module: Global settings for hiding recipes locked by Game Stages or FTGU.
- Tool Repair: Adjust the rate at which Mana is consumed to repair Artisan tools.