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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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!

  7. 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.

  8. 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.

More PneumaticCraft: Repressurized guides

PneumaticCraft: Repressurized · ExplainedAir Pressure, Volume, and Danger Limits ExplainedMastering the relationship between air volume, pressure, and danger limits is the single most important skill in PneumaticCraft: Repressurized. This guide will teach you the core math behind compressed air, how to safely scale your storage with Volume Upgrades, and how to prevent your machines from violently exploding.Beginner7 steps
PneumaticCraft: Repressurized · TroubleshootingHow to Prevent Pipe and Machine Explosions (Troubleshooting Guide)In PneumaticCraft: Repressurized, leaving an Air Compressor running unchecked will inevitably cause your Pressure Tubes and machines to explode violently. This beginner's troubleshooting guide will teach you how to build a completely explosion-proof pneumatic network using Safety Tube Modules, Pressure Gauge Tube Modules, and Regulator Tube Modules. Mastering pressure control protects your hard-earned base and prevents costly fuel waste.Beginner8 steps
PneumaticCraft: Repressurized · Setup guideHow to Build and Automate the Pressure ChamberIn this guide, you will learn how to construct and fully automate the Pressure Chamber in PneumaticCraft: Repressurized. Mastering this core multiblock machine is essential because it unlocks the automated production of Compressed Iron, Transistors, Capacitors, and Empty PCBs required for all advanced pneumatic technology.Beginner7 steps
PneumaticCraft: Repressurized · ExplainedPneumaticCraft Heat Mechanics and Thermal Management ExplainedMastering the heat mechanics in PneumaticCraft: Repressurized is essential for advancing beyond basic pressure generation into oil refining, plastic production, and high-tier automation. This guide explains the underlying physics of thermal resistance and heat capacity, showing you how to manipulate temperatures using Vortex Tubes, Heat Sinks, and thermal conductors. By the end, you will be able to efficiently heat industrial processors and keep advanced compressors running at peak efficiency.Intermediate7 steps
PneumaticCraft: Repressurized · Setup guideComplete Oil Refining and Plastic Production Line SetupIn this guide, you will learn how to build a complete oil extraction and refining setup in PneumaticCraft: Repressurized to automate the production of Plastic Sheets. Mastering this thermal and pneumatic production line is essential for mid-to-late game progression, as plastic unlocks advanced circuit boards, Programmable Drones, and high-tier pneumatic machinery. Along the way, you will also generate high-efficiency liquid fuels to power your base's compressors.Intermediate7 steps
PneumaticCraft: Repressurized · PowerCompressors Guide: Building a 20-Bar High-Pressure Power PlantMastering high-pressure air generation in PneumaticCraft: Repressurized is essential for powering late-game machinery like the Assembly Line, Aerial Interface, and high-speedCharging Stations. This guide compares the mod's major compressor types and walks you through constructing a fully automated, cooled, and self-regulating 20-bar power plant using the Advanced Liquid Compressor. By the end, you will have an explosion-proof pressure network that maximizes fuel efficiency and never wastes a single drop of refined fuel.Intermediate8 steps