Getting started

This walkthrough takes you from a fresh install to a useful production plan. You will choose a project, sync its Factorio data, and make a block for one automation science pack per second.

What you need

• Factorio 2.1 installed on the same computer as PyOps.
• The mod set and startup settings you want to plan with already configured in Factorio.
• Factorio closed while PyOps performs the initial data sync.

Optional: connect the companion mod

You can complete this walkthrough without the in-game connection. For a plan that follows your current save, connect the Companion mod under Settings → In-game link and start Factorio from Live bridge → Launch Factorio.

The companion mod connects through PyOps' live bridge. It enables the in-game panel, live research and TURD choices, machine and production statistics, and actions such as locating a good or showing a block in-game. The navigation status changes from no game to game linked when the connection is active.

The first-run path

Home adapts to the active project. A new project shows these setup steps in order; after you have a working plan, it becomes a command center for the next block problem, factory deficit, build shortfall, data drift, and game-link state.

Once a project has solved blocks, Home leads with the most urgent planning action and keeps the factory's current state visible without opening every workspace.

1. Install PyOps.
2. Choose or create a project for this factory or mod set.
3. Sync game data from Factorio into that project.
4. Build your first block and choose its recipe and machine.
5. Read the Factory view to decide what to plan next.

What PyOps changes

PyOps reads Factorio's prototypes during sync and stores its own plans locally. It does not change your save during this walkthrough.

The model in one minute

1. 1ProjectOne local plan and mod set
2. 2Game dataRecipes and machines from Factorio
3. 3BlocksGoals, recipes, rates, and boundaries
4. 4FactoryWhole-plan deficits and surpluses

A project is a separate PyOps database, usually for one save or one mod set. A block is a production unit with a target output, selected recipes, and selected machines. The Factory view combines the solved flows from your enabled blocks so you can see what the whole plan produces and still needs.

You do not need to describe the entire recipe chain up front. Start with the product you want, solve one useful block, and use its imports as the next planning decisions.