Installation

1. Installation

This page walks you through installing the i3d Importer add-on in Blender and doing the one-time setup it needs before the first import.

Before you start — requirements

• Blender 5.1 or newer. The add-on will not load on older versions.
• Farming Simulator 25 (or FS22) installed locally. The add-on reads the game's textures and shaders to rebuild materials. It only reads these files — it never changes anything in your game folder.
• Operating system: Windows is regularly tested and supported. Linux and macOS should work in principle (the add-on contains no native programs), but they are untested.
• Optional: the Parallax Node Extension. If installed, debug materials use true parallax occlusion mapping; without it, a simpler bump-mapping fallback is used. You do not need it to import models.

Step 1 — Download the add-on

1. Go to the project's Releases page.
2. Download the latest blender_i3d_importer.zip.

Keep the file as a .zip — do not unzip it.

Step 2 — Install into Blender

There are two ways. Drag & drop is the quickest.

Option A — Drag & drop (recommended)

1. Open Blender.
2. Drag the downloaded blender_i3d_importer.zip from your file manager straight onto the Blender window.
3. Confirm the install prompt that appears. Please note: If you have never used this installation method in Blender before, you might have to do it twice: First to confirm that you want to use this installation method, second to install the add-on.

Option B — Via Preferences

1. In Blender, open Edit ▸ Preferences ▸ Add-ons.
2. Click the dropdown arrow in the top-right corner of the window.
3. Choose Install from Disk….
4. Select the downloaded .zip file.
5. Tick the checkbox next to the add-on's name to enable it.

Step 3 — Confirm it's enabled

After installing, you should find i3d Importer in the add-on list with its checkbox ticked. You can type i3d into the search box to find it quickly.

Two quick signs the add-on is active:

• File ▸ Import now contains an entry called Farming Simulator i3d (.i3d).
• In the 3D viewport, pressing N opens the sidebar, which now has an i3d Importer tab.

Step 4 — One-time setup (required)

The add-on needs to know where your game is installed. Without this, an import will be blocked with a "Configuration required" message.

1. Open Edit ▸ Preferences ▸ Add-ons and find i3d Importer.
2. Expand its preferences (click the arrow next to its name). (If you do not see the preferences, untick the "enable" checkbox and disable/re-enable the add-on. That should fix it.)
3. In the Paths section, set FS25 game data folder (required) to your Farming Simulator installation root — the folder that contains the data/ subfolder.

That single setting is enough to start importing. All the other preferences are optional defaults — see Preferences for the full tour.

---

Next: 2. Preferences →