PneumaticCraft: Repressurized · Automation · Advanced

Programmable Drones Explained: Puzzle Pieces and Automation Setups

Master the graphical programming language of PneumaticCraft: Repressurized to build autonomous Drones capable of complex farming, mining, and base-wide logistics. Learning to chain Programming Puzzle Pieces in the Programmer allows you to automate spatial tasks without laying down sprawling networks of pipes or cables.

What you need

  • Programmer
  • Programming Puzzle Pieces (stored in an adjacent inventory or required depending on modpack config)
  • Drone (or specialized variants like Logistics Drone or Harvesting Drone for simpler tasks)
  • GPS Tool and GPS Area Tool
  • Charging Station with a Dispenser Upgrade installed
  • Active compressed air supply (Air Compressor and Pressure Tubes)
  • Inventory Upgrades, Speed Upgrades, and Volume Upgrades
  • Pneumatic Wrench

Step by step

  1. 1Set Up the Charging Infrastructure

    Place a Charging Station and connect it to your compressed air network using Pressure Tubes. Open the Charging Station GUI and insert a Dispenser Upgrade, which physically allows a Drone resting on top of the block to receive air. Add Volume Upgrades and Speed Upgrades to the station, and ensure your compressors maintain high pressure so visiting Drones recharge rapidly.

    Tip: Place a Security Upgrade in your Charging Station and Drone to prevent catastrophic pressure explosions if your line overpressurizes.

  2. 2Understand the Programmer Workspace

    Place the Programmer down and open its GUI to view the programming canvas and the puzzle piece tray on the right. Every functional script must begin with a 'Start' puzzle piece. Drag widgets from the tray onto the canvas and snap them vertically underneath the 'Start' block to define the top-to-bottom execution sequence.

    Tip: Use the search bar in the Programmer GUI to quickly locate specific puzzle pieces by name, and toggle difficulty modes at the bottom to reveal advanced flow-control widgets.

  3. 3Define Spatial Areas with GPS Tools

    Hold a GPS Tool and right-click a target block (such as a chest) to save its exact X, Y, Z coordinates. For multi-block zones, right-click two opposite corners using a GPS Area Tool to define a 3D bounding box. In the Programmer, place an 'Area' widget to the right of any action widget, then click the Area widget with your GPS Tool or GPS Area Tool to copy the saved coordinates directly into the code.

    Tip: Right-clicking an Area widget without a tool opens a configuration menu where you can change the bounding box shape from a solid filled Box to a hollow Frame, Cylinder, or Checkerboard pattern.

  4. 4Ensure Survival with the Standby and Charging Loop

    You do not need to manually program a low-air check; Drones automatically seek out a Charging Station containing a Dispenser Upgrade when their internal pressure drops to a critical level. However, if a Drone finishes its script and restarts immediately while no work is available, it will hover endlessly and burn air. Prevent this by attaching a 'Standby' widget at the end of an idle branch so the Drone shuts off its propellers to conserve pressure.

    Tip: Always name your Drone in an Anvil or the Programmer before deploying it so you can easily track it using a Pneumatic Helmet with Entity Tracker and Debugging upgrades.

  5. 5Build a Crop Farming Script

    Snap a 'Harvest' widget under the 'Start' block and attach an 'Area' widget defining your farmland. Configure the Harvest widget via right-click to check 'Require Hoe' only if you want automatic replanting (and ensure the Drone holds a tool or use the default harvest behavior for mature crops). Below 'Harvest', attach a 'Pickup Item' widget covering the same farmland Area, followed by an 'Inventory Export' widget pointed at a storage chest's single-block Area.

    Tip: Attach an 'Item Filter' widget to the right of 'Pickup Item' if you only want the Drone to collect specific crops and ignore unwanted seeds or mob drops.

  6. 6Create an Automated Mining Script

    Beneath 'Start', place a 'Dig' widget paired with a 3D Area widget covering your quarry zone. Because Drones cannot mine blocks without a tool unless configured, prepend an 'Inventory Import' widget at the start of the script that pulls a Pickaxe from a supply chest if the Drone's inventory is empty. Follow the 'Dig' command with 'Pickup Item' and 'Inventory Export' widgets so the Drone clears the drops and banks the ores before looping.

    Tip: In the 'Area' widget attached to your 'Dig' piece, ensure the traversal order is set to Top-to-Bottom so the Drone mines upper layers first and does not get trapped under falling gravel.

  7. 7Program Point-to-Point Item Logistics

    To move items dynamically, snap an 'Inventory Import' widget under 'Start' and attach an Area widget marking your source chest. To the right of 'Inventory Import', snap an 'Item Filter' widget and right-click it to select the exact item or tag you wish to pull. Below that, snap an 'Inventory Export' widget linked to your destination chest's coordinates. Configure the Import and Export pieces by right-clicking them to specify exact block faces (e.g., Top for furnace inputs, Bottom for extraction).

    Tip: Check the 'Use Count' box inside the 'Inventory Import' widget configuration to limit how many items the Drone grabs per trip, preventing destination machines from overflowing.

  8. 8Compile and Deploy the Drone

    Place your empty Drone into the upper-right slot of the Programmer GUI and click the export arrow button to write the puzzle logic onto the item. Take the programmed Drone, charge it inside your Charging Station first, and install Inventory Upgrades so it can actually carry items. Finally, shift-right-click the ground with the Drone in hand to deploy it into the world and begin execution.

    Tip: If your Drone freezes or behaves unexpectedly, shift-right-click it with a Pneumatic Wrench to safely dismantle it back into your inventory for reprogramming.

How it works

The Drone programming system operates as an infinite state machine. Execution starts at the 'Start' piece and moves sequentially down the vertical column. When the Drone reaches the bottom piece of the chain, it automatically loops back to the 'Start' block unless redirected by 'Label' and 'Jump' widgets. Every action block pauses the script's progression until the physical Drone in the world either completes that action across all valid blocks in the attached Area or determines that no valid targets currently exist.

Parameters in the language are positional. Main actions and conditions snap together vertically to form the execution spine. Modifiers—such as 'Area' widgets, 'Item Filter' widgets, or 'Text' boxes—always snap horizontally to the right or left of an action piece. Whitelisting parameters attach to the right side of an action block, while blacklisting parameters (explicitly telling the Drone which coordinates or items to ignore) attach to the left side.

Drones consume stored compressed air for every tick of flight and every block interaction. Their carrying capacity defaults to a single slot unless augmented with Inventory Upgrades inside an Upgrade Matrix or before deployment (depending on your game version, check the in-game Patchouli manual for exact upgrade insertion slots). Because pathfinding calculates 3D A-star routes around obstacles, keeping your operating areas free of dense foliage or floating blocks drastically reduces computation delays and air drain.

Common mistakes

  • Forgetting the Dispenser Upgrade in the Charging Station: A Charging Station only charges items inside its GUI slot by default; without a Dispenser Upgrade, a hovering Drone sitting on top of the block will starve of air and drop to the ground.
  • Leaving out Inventory Upgrades: A base Drone has minimal or zero internal item slots depending on the task. If your farming or mining Drone breaks blocks or tries to import items without Inventory Upgrades installed, the items will simply remain on the ground or in the chest.
  • Putting Whitelists on the Left Side: Attaching an Area or Item Filter to the left edge of an action piece turns it into a Blacklist. Always snap target areas and allowed items to the right side of the puzzle piece.
  • Not setting block faces on Inventory Import/Export: Many modded machines and vanilla furnaces require items to enter from specific sides. Failing to right-click the Import/Export widget to check the correct directional faces will cause the Drone to hover over the block and skip the task.
  • Creating solid 3D areas inside walls: If an Area widget includes inaccessible blocks sealed behind solid stone, the Drone will repeatedly attempt to pathfind to them, wasting air until it times out.

FAQ

Why is my Drone hovering over a chest or crop and doing nothing?

Either the Drone's inventory is full (or it lacks Inventory Upgrades), the target chest is full, or you did not select the correct directional block faces inside the Inventory Import/Export puzzle piece configuration.

How do I debug which puzzle piece my Drone is currently stuck on?

Equip a Pneumatic Helmet installed with the Entity Tracker Upgrade and the Drone Debugger Upgrade. When you look at the active Drone and open the debugging overlay, the exact puzzle piece currently executing will be highlighted.

Can I reuse a complicated program on multiple Drones without rebuilding it?

Yes. Leave the puzzle pieces on the Programmer's canvas and insert additional Drones into the programming slot one by one, or insert an existing programmed Drone and click the import button to load its code back onto the canvas.

How do I stop my Drone from running out of tools during a long mining job?

Use a 'Condition: Drone Inventory' widget at the start of the loop to check if the Drone has a pickaxe. Branch the false output to an 'Inventory Import' widget connected to a tool chest, and the true output directly to the 'Dig' widget.

By combining vertical action chains with horizontal Area and Item Filter modifiers in the Programmer, you can deploy self-charging PneumaticCraft Drones to automate virtually any spatial or logistical task in your base.

More PneumaticCraft: Repressurized guides

PneumaticCraft: Repressurized · Getting startedPneumaticCraft: Repressurized Getting Started & Progression GuideThis guide walks you through the foundational stages of PneumaticCraft: Repressurized, taking you from explosive raw materials to your first pressurized machines and plastic production. Mastering these early steps is essential because compressed air, heat management, and plastic form the backbone of all advanced automation, programmable drones, and high-tier armor in the mod.Beginner7 steps
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