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