PneumaticCraft: Repressurized · Addon guide · Advanced
Custom Machinery PneumaticCraft Guide: Adding Air & Heat to Custom Machines
This guide teaches modpack developers and advanced players how to integrate PneumaticCraft: Repressurized air pressure and heat mechanics into custom-built blocks using the Custom Machinery mod. By configuring JSON machine definitions and datapack recipes, you can create specialized industrial processors that natively interact with Pressure Tubes, Vortex Tubes, and Compressors. This allows you to seamlessly blend custom progression requirements into PneumaticCraft's multi-dimensional power and thermal systems.
What you need
- PneumaticCraft: Repressurized installed
- Custom Machinery and its PneumaticCraft integration addon (or built-in compatibility layer, depending on your Minecraft version)
- A text editor for editing JSON files (such as VS Code)
- Basic knowledge of Minecraft datapacks or KubeJS
- In-game testing tools: Pressure Tubes, Creative Compressor, Vortex Tube, Heat Pipe, and Pneumatic Wrench
Step by step
1Set Up the Machine Definition File
Navigate to your world's datapack folder (or global KubeJS data directory) and create a new machine JSON file inside the `data/<your_namespace>/machines/` directory. Define the basic name and appearance blocks for your custom machine so the game registers it as a valid tile entity. Load into a test world and use the `/reload` command to verify that your blank Custom Machine block appears in JEI.
Tip: Keep your Minecraft client open while editing JSON files so you can quickly test syntax changes using `/reload` and check the game log for parsing errors.
2Add the Pneumatic Air Component
Inside the `components` array of your machine definition JSON, add a new object with the type referencing the PneumaticCraft pressure component (typically `custommachinery:pneumatic` or `custommachinerypnc:pneumatic` depending on your exact mod version). Define the `volume` property (in mL, such as 5000 or 10000), along with the `danger_pressure` and `critical_pressure` limits (for example, 5.0 bar and 7.0 bar for a Tier 1 machine, or 20.0 and 25.0 for Tier 2). This step grants your custom block an internal air buffer capable of connecting directly to standard Pressure Tubes.
Tip: Match your danger and critical pressure thresholds to standard PneumaticCraft tiers so players know whether to connect basic Pressure Tubes or Advanced Pressure Tubes.
3Add the Thermal Heat Component
In the same `components` array, add the heat component entry (usually `custommachinery:heat` or `custommachinerypnc:heat`). Configure the `capacity` parameter to determine how much thermal resistance the machine has (how fast it heats up or cools down) and set the `thermal_resistance` to control heat transfer speeds with adjacent blocks. Once reloaded, placing a Vortex Tube or Heat Sink against your custom machine in-game will now actively transfer thermal energy to it.
Tip: Place Compressed Iron Blocks or Heat Pipes next to your custom machine in-game and inspect it with a Pneumatic Wrench or One Probe to confirm its base ambient temperature initializes properly.
4Configure GUI Elements for Player Feedback
Players cannot manage pressure or heat safely if they cannot see the internal state of the machine. In the `gui` array of your machine JSON, add the matching pressure gauge and temperature gauge elements, specifying their `x` and `y` pixel coordinates on the machine's interface screen. When you right-click the machine in-game, you should now see the familiar PneumaticCraft radial pressure dial and thermal bar responding in real time to attached Creative Compressors.
5Create a Custom Recipe Datapack File
Create a new recipe JSON file inside `data/<your_namespace>/recipes/` and set the recipe `type` to `custommachinery:custom_machine`. Point the `machine` field to the resource location ID of the custom machine you created in Step 1, and define a `time` value in ticks (for example, 100 ticks for a 5-second operation). Add a simple item input and item output to act as a test payload while you dial in the pneumatic requirements.
6Define Pressure and Air Volume Requirements
In the `requirements` array of your recipe JSON, add a pneumatic requirement object. Set the `mode` to `input`, specify the `min_pressure` required for the recipe to operate (e.g., 3.5 bar), and set an `air` consumption value (in mL). Note that consuming air every single tick drains compressors rapidly, so double-check whether your integration syntax drains the specified `air` total once per craft or per tick via a `per_tick` boolean flag. If the pressure drops below `min_pressure` mid-operation, the recipe will pause or reset.
Tip: You can also set the mode to `output` with negative pressure thresholds to create vacuum-requiring recipes, or have the recipe generate compressed air like an custom compressor!
7Define Temperature Thresholds and Heat Drain
Add a heat requirement object to the recipe's `requirements` array alongside the pneumatic entry. Specify the required temperature range (usually defined in Kelvin or Celsius depending on the addon version; check JEI after reloading to verify the unit displayed) to force players to heat the machine above a threshold, such as 100°C, using a Vortex Tube or Liquid Hopper fed with Lava. Additionally, include a heat consumption value (`amount` or `heat`) so the active recipe draws thermal energy out of the machine casing, forcing the player to maintain a continuous heat supply rather than just heating the block once.
Tip: To create an exothermic machine that overheats during crafting, configure the heat requirement as an `output` so the player must attach Heat Sinks or Air Grates to keep the machine within a safe operating temperature range.
8Test and Balance In-Game
Run `/reload` in your test world and inspect your custom recipe in JEI to confirm both the pressure gauge icon and temperature bar render with accurate numbers. Place your custom machine down, hook up an Advanced Liquid Compressor with Pressure Tubes, and attach a Vortex Tube with a Heat Sink on the cold side. Insert your test items and watch the machine's internal GUI gauge to ensure air volume depletes smoothly and the temperature drops as expected during processing.
Tip: Always test what happens when you intentionally over-pressurize your custom machine past its critical limit—it should violently explode just like native PneumaticCraft blocks!
How it works
Understanding why PneumaticCraft uses two separate numbers for air—Volume (mL) and Pressure (bar)—is critical for balancing your custom JSON recipes. Think of a machine's internal `volume` as the physical size of an air tank, while `air` (measured in milliliters) is the total quantity of gas crammed inside that tank. Pressure is simply the ratio between the two: `Pressure = Air / Volume`. If your custom machine has a base volume of 5,000 mL, a player's compressor must pump 15,000 mL of air into the block just to reach a baseline working pressure of 3.0 bar.
When your custom recipe runs and consumes a set amount of `air` (mL), the total air inside the machine drops, which immediately lowers the internal `pressure` (bar). If a recipe requires a high minimum pressure (like 4.5 bar) AND consumes a massive volume of air per tick, a small internal volume will cause the machine's pressure to plummet below 4.5 bar after just a few ticks, causing the machine to stutter and stall. By increasing the machine component's base `volume` in the machine JSON, you give it a larger buffer, allowing pressure to remain stable during heavy crafting operations.
The heat system operates on thermal equilibrium rather than simple power consumption. Every block with a heat component tries to equalize its temperature with the surrounding air and adjacent thermal blocks. Setting a high `capacity` in your machine's JSON means it requires a lot of thermal energy to change its temperature by one degree, whereas `thermal_resistance` acts as an insulator slowing down how fast heat moves in or out. When your recipe actively consumes heat during crafting, it lowers the block's internal temperature, forcing the player to supply steady thermal input (like burning fuel or running a Vortex Tube) to keep the machine above the recipe's minimum temperature threshold.
Common mistakes
- Confusing Air Volume (mL) with Pressure (bar) in Recipe JSONs: Setting an air drain requirement of '5' heals/drains almost nothing because 5 mL is negligible, whereas setting '5000' per tick will instantly empty an entire compressor network. Always check whether the field expects pressure (typically 0.0 to 20.0 bar) or volume (hundreds or thousands of mL).
- Setting Recipe Pressure Higher than Machine Danger Limits: If you configure a recipe to require 7.0 bar of pressure, but you left the machine component's `danger_pressure` at the Tier 1 default of 5.0 bar, the custom machine will explode before it can ever start crafting.
- Forgetting Heat Consumption on Thermal Recipes: If you only require a minimum temperature of 150°C without adding an active heat drain to the recipe, a player can heat the machine once with a single torch or Lava bucket, surround it with insulating blocks, and run infinite crafts for free without maintaining a heat source.
- Making Machine Volume Too Small for High-Drain Recipes: Giving a machine a tiny 1,000 mL volume while requiring 4.5 bar and 500 mL of air per craft will cause the pressure to instantly drop by 0.5 bar mid-craft, stalling the recipe even when hooked up to a max-speed compressor.
FAQ
Can players put PneumaticCraft Volume or Security Upgrades into my Custom Machine?
By default, standard PneumaticCraft upgrades do not go into Custom Machinery upgrade slots unless the specific addon version explicitly bridges the upgrade item registry. Instead, use Custom Machinery's native upgrade system to allow items (even PneumaticCraft upgrade items) to multiply the machine's recipe speed or energy efficiency, and give the machine a generous base air volume in the JSON.
How do I require Vacuum (negative pressure) in a custom recipe?
In the pneumatic requirement section of your recipe JSON, set the minimum/maximum pressure values into the negative range (between 0.0 and -1.0 bar). In-game, players will need to hook a Vacuum Pump up to your custom machine using Pressure Tubes to suck the air out and reach the negative threshold.
Why is my custom machine's temperature reading in the hundreds when it is sitting idle?
PneumaticCraft calculates internal temperatures in Kelvin (where 300K is roughly 27°C, normal biome room temperature). Some JSON configurations ask for values in Kelvin while displaying Celsius in JEI. If your machine idles around 300, configure your JSON recipe thresholds using the Kelvin scale (e.g., 373 for 100°C).
Can I combine PneumaticCraft air with Forge Energy (FE) and Fluids in the same recipe?
Yes! That is the biggest strength of Custom Machinery. You can easily include `custommachinery:energy`, `custommachinery:fluid`, `custommachinery:pneumatic`, and `custommachinery:heat` in the same machine and recipe JSONs to build hybrid endgame machines.
By properly balancing internal air volume, pressure tiers, and active thermal drain in your Custom Machinery JSON files, you can design immersive custom blocks that seamlessly expand PneumaticCraft: Repressurized's engineering challenges.