FPK Documentation

First Person Kit (FPK) is a Blender add-on for building first person games. You author everything inside Blender, and a complete Godot 4.6+ project rides along inside the add-on. Tag your meshes, set a few options, and the kit wires up doors, items, radios, light switches, look cameras, level transitions, menus, save and load, and inventory for you.

The add-on lives in three places in Blender. Each one handles a different slice of your game.

The N panel3D Viewport sidebar

Global settings for the whole game and per-level settings. Create projects and levels, tune the player, set up menus, preview lighting, and publish. Press N in the viewport and pick the FPK tab.

Object Propertiesper object

Object-specific behaviour. Select a mesh, open the Object Properties tab, and you get the FPK Object Tools panel for roles, triggers, and Godot import hints.

Object Data Propertieslights

For lights, FPK adds a Light Settings panel here so your real-time Godot lighting matches the Blender preview.

1. 1Download the add-on .zip and install it in Blender from Edit, Preferences, Add-ons, Install from Disk. Install the zip itself. The Godot project template lives inside it.
2. 2Open the FPK tab in the 3D viewport sidebar (press N). In the FPK Project panel, hit New FPK Project to scaffold a ready to run Godot project into a folder you pick.
3. 3Set your Godot executable path in the add-on preferences so you can Play test and publish straight from Blender.
4. 4Create a level, then press Play to drop into a playable starter level with menus, save and load, and inventory already wired up.

The top of the FPK tab. It shows which project is active, keeps you in sync, and gives you one-click Play testing. This is your home base.

Active project

The folder name and full path of the project you are working on, with a checkmark when the folder holds a valid project.godot.

Open Folder

Opens the project folder in your file browser.

Change

Point the add-on at a different existing FPK project folder, or set your Godot executable path.

Sync status

Tells you whether everything is synced and ready to Play. A filling ring shows while a save is importing. If config-only edits (like footsteps or music) are pending, you get a Sync All Changes button to push them.

Open in Godot

Launches the Godot editor on this project.

Play

Runs the game from the main level. Available once a level exists and no import is mid-flight. If your .blend is unsaved, save first so the latest geometry syncs.

New FPK Project

Scaffolds a brand new project from the bundled template. See the next section.

Creates a full Godot project from the template that ships inside the add-on. You get the player, menus, save system, inventory, and all the runtime scripts, ready to open in Godot.

Project Name

The name of your game and the folder it lands in.

Location

Where the project folder gets created on disk.

Make this the add-on's active project

Switches the add-on to the new project right away so the rest of the FPK tab targets it.

Open the project folder when done

Pops the new folder open in your file browser after it builds.

A level in FPK is a folder under levels/<Name>/ plus a thin Godot wrapper scene that loads your geometry. Create Level sets that structure up for you so the .blend you are working in becomes a real, playable level.

Level Name

The level's name. Creates levels/<Name>/, and a level_load value of "<Name>" will resolve to it.

Save this .blend into the level folder

Saves your current .blend inside the new level folder so it becomes the source geometry for that level.

Create Godot wrapper scene (.tscn)

Builds the .tscn that Godot loads for this level. Usually leave this on.

Set as game's main level (New Game starts here)

Marks this level as where New Game begins. Keep it ticked for your first level so the game has something to Play.

Once your .blend lives inside a levels/<Name>/ folder, this panel shows the level's name and its per-level presentation: an intro card and background music.

Play card when entering level

Toggles a title card that shows when the player enters this level. Great for chapter titles and location names.

Title, Subtitle, Duration

The text shown on the card and how long it stays up. Edit Text & Duration opens a small editor. The title falls back to the level name if you leave it blank.

Card Sound

A sting that plays with the card. Use the built-in global sting, browse for your own file (copied into audio/sounds/), or clear it.

Background Music

A per-level playlist with a Volume slider. Add Music to drop in tracks. With no tracks the level is silent.

A set of cleanup helpers that get a .blend ready for a clean Godot import. Prep Textures for Godot runs the recommended steps in one go. You can also run each step on its own.

Prep Textures for Godot

The one-button option. Tidies textures and data so they import cleanly. Save the .blend first.

Purge

Removes unused data blocks from the .blend.

Pack / Unpack

Packs resources into the .blend or unpacks them back out to disk.

Clean Unused Textures

Drops textures that are not referenced by any material.

Per-level environment settings. These are saved to the level's environment.json and rebuilt as a Godot WorldEnvironment when the level loads. Apply to Preview pushes the same values onto the Blender world so the viewport matches what Godot will render.

Background

The flat sky / background color, plus a Background Energy brightness multiplier.

Ambient

A constant ambient light color and its Ambient Energy intensity, so nothing sits in pure black.

Distance Fog

Cheap depth and height fog. When enabled you get color, density per metre, a start height, height falloff, and how much it tints the sky.

Volumetric Fog

Light-scattering fog with density, albedo, emission, anisotropy, length, ambient inject, and sky affect. Needs the Forward+ renderer, which the project targets.

Apply to Preview / Reset

Apply to Preview matches the Blender world to these values. The trash icon resets the level back to FPK defaults by deleting environment.json.

Opens a view-only Godot window that mirrors this level's real lighting, live, while you work in Blender. It is the fastest way to see how your lights and environment will actually look in-game without leaving your scene.

Open Lighting Preview

Launches the preview window. Needs your Godot path set in preferences. The view and lights update as you make changes.

Force Reload

Reloads the preview if it gets out of sync with your scene.

Global settings for the whole game: how the player moves, what footsteps sound like, your menu branding, the game icon, and menu music. These are written into the project so they apply everywhere.

Player Settings

Walk, sprint, and crouch speed, jump force, player height, mouse and gamepad sensitivity, and footstep volume. Written to game_config.json and applied over the defaults at game start. Restore Defaults drops your overrides.

Footstep Sounds

Pick a footstep set from the built-in surface folders (concrete, wood, grass, tile, metal, carpet) or the global default. Open Footsteps Folder lets you drop in your own.

Main Menu

Set Game Logo for the title screen image and Menu Accent Color for the menu's highlight color (shown as a hex value).

Game Icon

The window, taskbar, and .exe icon, separate from the logo. A square PNG between 64 and 1024 px, 256x256 is ideal. Reset to Default restores the kit icon.

Menu Music

A global playlist for the main menu with a Volume slider. Add Music to add tracks. No tracks means a silent menu.

Builds your finished game straight from Blender. Set the build details, pick how you want to distribute it, choose your platforms, and hit Publish Game.

Build Details

Game Name, Version, and Author / Company, plus the Output Folder the build lands in.

Distribution profile

How the build is packaged. Three options, below.

Platforms

Windows and Linux checkboxes. Pick at least one. macOS needs signing on a Mac and is not built here.

Build: Release / Debug

Release is for shipping. Debug builds are for testing only.

Publish Game

Runs the export. Enabled once you have a main level and at least one platform selected.

Select any object and open the Object Properties tab to find this panel. It is where you turn a plain mesh into a gameplay object. Pick a Role and the add-on writes the right custom properties for you, then shows only the settings that role needs.

Role

What this object becomes in-game. Picking a role sets object_type and reveals that role's properties. See the Roles section for each one in detail.

Role Properties

The settings box that appears under the role, for example a door's open angle and lock, or a radio's sound. Only the relevant fields show.

Clear All FPK Properties

Strips every FPK tag off the object so it imports as plain geometry again.

Renames an object with a suffix so Godot builds collision or occluders for it on import. This is for static level geometry like walls, floors, and stairs. FPK roles add their own colliders, so you do not need a suffix on tagged gameplay objects.

Footstep Surface

Once a collision suffix is on, a collidable surface can override the player's footstep sound. Pick a set (concrete, wood, grass, and so on) and it plays when the player walks on it, or leave it on the global default.

A role is what an object becomes in-game. Open the FPK Object Tools panel, pick a role from the dropdown, and the add-on writes the right custom properties and shows only the settings that role needs. An object has one role at a time. Clear All FPK Properties resets it to plain geometry.

Every role below has its own properties. Anything left at default can stay unticked. The detailed sections that follow cover each role's variables and when to reach for it.

Turns the mesh into a RigidBody3D at runtime. It falls under gravity, gets pushed around, and the player can pick it up with interact and throw it.

Weight (kg)default 1.0

Mass of the object. Heavier objects are harder to shove and land with more force. Lighter ones skitter and fly.

On interact the player lifts the object up to study it close, rotates it freely, then puts it back exactly where it was. The object stays in place the rest of the time.

Interact Textdefault Inspect

The verb shown in the crosshair prompt when the player looks at it.

A toggleable source of looping positional audio. It plays on and off SFX as you flip it, and has an emissive glow that dims when it is off. The sound is 3D, so it gets louder as you approach.

Sound

The track to loop. Browse to pick any .ogg, .wav, or .mp3 and it is copied into audio/sounds/ for you, or type the name of one already there (the extension is optional).

Start On

Whether the radio is already playing when the level loads.

Interact Textdefault Listen

The crosshair verb shown when the player looks at it.

A hinged door that swings away from the player. Set the pivot at the hinge edge in Blender (move the object origin to the hinge). It can be a plain door, or locked behind an inventory key.

Open Angledegrees, default 90

How far the door swings open.

Open Speeddefault 3.0

Animation speed multiplier for the swing.

Open Sound / Close Sound

Optional SFX for opening and closing, by filename from audio/doors/.

Locked

Whether the door starts locked. Turning this on reveals the key and lock-sound fields below.

Item IDLocked only

The inventory item the player must be carrying to unlock this door. The key is kept, not consumed. Match this to an Item's Item ID to make that item the key.

Locked Sound / Unlock SoundLocked only

SFX for rattling a still-locked door and for the moment it unlocks.

Interact Text

Optional override for the crosshair verb.

A collectible. On interact it adds its Item ID to the global inventory and disappears. Items show up in the inventory menu and can be used to unlock doors.

Item ID

The id added to the inventory on pickup. Use the same id on a door's Item ID to make this item that door's key.

Display Name

The friendly name shown in the inventory UI, for example A Gold Key. Falls back to the Item ID when left blank.

Interact Text

Optional override for the crosshair verb, for example Take.

A collectible voice recording. On interact it plays as a 2D voiceover with subtitles that appear in time with the speech, registers itself in the inventory's Audio Logs tab so the player can replay it anytime, then despawns.

Audio Clip

The voice file. Browse to pick a clip and it is copied into audio/logs/ on sync.

Interact Text

Optional override for the crosshair verb.

Title / Speaker

Shown with the log in the inventory and on screen, so the player knows what they picked up and who is talking.

Transcript & Subtitles

Play the clip right in Blender and hit Capture Line at the moment each subtitle should appear, building the timed spoken lines in order. Reorder lines with the arrows, then Save. An offline auto-transcribe can fill the lines in for you to fine tune.

Plays a Blender animation in-game on a continuous loop. Animate the object in Blender, tag it Animated, and it keeps animating in Godot with no export step. Each animated object runs independently.

Action

The Blender action to play. Pick one from the list, or leave it on Auto-detect to let the importer match an action by the object's name.

Anim Speeddefault 1.0

Playback rate multiplier. Negative values play the animation in reverse.

Loop

Replays the clip from the start each time it finishes.

Ping-Pong

Plays the clip forward then backward, back and forth, instead of restarting.

Sound

An optional sound that plays when the animation starts. It loops while the clip loops or ping-pongs, and plays once otherwise. Browse to pick a file, copied into audio/sounds/.

Play Sound At

Whether that sound comes from the object's location (positional) or from the player (always full volume).

The spawn point for the level. On entry the player is teleported to this object's position and facing (yaw), then the marker deletes itself. It is best applied to an Empty so it does not show up as geometry.

No properties

Position and rotation are the settings. Place and aim the Empty where you want the player to land and look.

A trigger is a stackable capability you can add to any object, on top of its role. Make this object a trigger, choose how it fires, optionally gate it behind conditions, then stack the actions it runs. There is one trigger per object, and all its power lives in the action stack.

Interact

Fires when the player looks at the object and presses the use button. This is the choice for things the player deliberately operates: levers, buttons, switches, examining a panel.

Volume

Fires when the player walks into the object's bounds, no button needed. The mesh becomes an invisible trip volume sized to itself. Great for ambushes, scripted moments, and entering an area.

PromptInteract only, default use

The verb shown in the crosshair prompt while the player is looking at the object, for example pull lever or open.

Re-fireVolume only

Every Entry fires the trigger each time the player walks in. Once fires a single time per playthrough then disarms, and that is remembered in saves.

Fire

Runs the action stack top to bottom on every activation.

Toggle

Alternates on each activation: it runs the stack, then reverses it next time, then runs it again, and so on. Perfect for a switch that turns something on, then off.

Conditions gate a trigger behind named game states. With no conditions the trigger always fires. Add one or more and the trigger only fires when they all pass. States are set by Set State actions elsewhere, which is how objects talk to each other and how you build puzzles and progression.

State name

The named state to check, for example power_on or has_seen_intro. The plus button adds a condition, the X removes one.

Operator

How the state is compared. The options are listed below. Equals and not equals also show a value field to compare against.

Show prompt even if conditions are not metInteract only

Keeps the crosshair prompt showing while the conditions fail, so the object still looks interactive. It will not actually fire until the conditions pass. Off means no prompt appears until they pass.

Actions are where triggers get powerful. A single trigger can hold as many actions as you like, and they run top to bottom in the order they are listed. Reorder them with the up and down arrows on each action's header to control exactly what happens first.

Drop a Delay action into the stack and everything below it waits that many seconds before running. Stack several delays and you have a simple timeline: play a sound, wait half a second, swing a door, wait a second, switch the lights, then transition to the next level. No scripting required.

• •Add actions with the Add menu. Each one gets a collapsible header showing a one-line summary.
• •Reorder with the up and down arrows. Order is the order they fire.
• •Animation and Sound actions can target the trigger object itself (Self) or another object.
• •A Delay pauses the stack before the actions beneath it, so you can stagger and sequence events.
• •If the trigger's mode is Toggle, the whole stack reverses on every other activation.

Plays a Blender action on the target object when the trigger fires. The target needs an animation assigned in Blender so it can export.

Self / Object

Whether to animate the trigger object itself or another object you pick.

Action

The Blender action (clip) to play. Auto-detected by name when left blank.

Speeddefault 1.0

Playback rate multiplier.

Loop / Ping-Pong

Loop replays from the start. Ping-Pong plays forward then backward. Leave both off for a one-shot play.

Plays a sound when the trigger fires, either positionally at an object or flat at the player.

Self / Object

Which object the sound is associated with when played positionally.

Sound

Browse to pick a file, copied into audio/sounds/, or type the name of one already there.

Object / Player

Object plays the sound at that object's position in 3D space. Player plays it flat at the player, always full volume, good for stings and UI feedback.

Loop

Whether the sound repeats until something stops it.

Blends the player's view into a fixed camera, then hands control back when they exit. Use it for curated framing: sitting at a desk, lying on a bed, peering through a window, focusing on a scripted moment.

Camera

The camera object to blend the view into.

Transition (s)default 0.2

How long the blend into the camera takes.

Can Look Around

When on, the player can nudge the view within a clamped glance range while in the camera.

Exit when

Press Interact lets the player leave on the use button (with its own prompt). Timer leaves automatically after a set time.

Leave After (s)Timer exit, default 3.0

How long the view stays in the camera before returning to the player.

Switches lights on, off, or toggles them. Each time the trigger fires, the light or group toggles. This is the modern replacement for the old light switch, and it works with the Light Channel role for grouping.

Light / Collection

Target a single light object, or a whole collection of lights to switch together.

Light / Collection picker

Which light object or collection this action controls.

Starts

On means the light is on at level load and the trigger turns it off first, then on, and so on. Off means it starts off and the trigger turns it on first.

Sets, toggles, or clears a named game state. States are the memory that ties your world together. Other triggers read them through Only if conditions, so this is how you build cause and effect across objects.

State

The name of the state to change, for example power_on or switches_flipped.

Set

Sets the state to the Value you type below.

Toggle

Flips a true/false state to the opposite of what it is now.

Clear

Removes the state, so an is unset condition would pass again.

ValueSet only

What to set the state to. Type true or false, a number, or text, and it lands as the right type for conditions to compare.

Travels to another level in your game when the trigger fires, running the loading screen and title card on the way. This is the action behind a door that leads to the next area, or a volume the player walks through.

Level

Pick the destination from the levels in your project. If the list is empty, create another level first so it can be picked.

Quietly saves the game to the autosave slot and shows a brief Saving indicator in the bottom-right. It has no settings, just drop it into a stack.

Fails the player and shows the game-over menu, where they can continue from the last save or quit to the main menu.

Fail Messagedefault YOU DIED

The line shown on the game-over screen.

Ends the game with a victory screen. It rolls the credits with your credits music, both set in Game Settings.

Win Messagedefault THE END

The line shown as the game wraps up.

Pauses the stack before the actions below it run. This is the key to sequencing: place delays between actions to time out a whole chain of events.

Secondsdefault 0.5

How long to wait before the actions beneath this one fire.

Select a light and open the Object Data Properties tab to find this panel. Blender's glTF export only carries a light's type, color, energy, range, and spot cone. Everything that makes real-time lighting look right in Godot (shadows, soft-shadow size, attenuation, specular, indirect and volumetric energy) gets dropped, and Blender Area lights are not exported at all. This panel closes that gap.

It writes snake_case custom properties onto the light so they ride through to Godot on import, and Apply to Blender Light pushes the same values onto the Blender light so your viewport preview matches the game. Energy is expressed in Godot units and used as the single source of truth, so the panel value, the Blender preview, and the in-game light all agree.

Light type

Omni (point), Spot, Directional (sun), or Area (rectangle). Area lights become a Godot 4.7 AreaLight3D, which FPK rebuilds on import since Blender cannot export them.

Light

Energy (brightness in Godot units), Color, Specular strength, Indirect Energy for GI contribution, and Volumetric Energy inside fog.

Shape & Falloff

Per type. Range and Attenuation for omni, spot, and area. Cone Angle and Cone Softness for spot. Width, Height, and Normalize Energy for area. Attenuation of 2 is physically accurate inverse-square.

Shadows

Cast Shadows, Source Size for soft penumbras (Angular Size on the sun), Shadow Bias and Normal Bias to fight acne, Shadow Opacity, and the sun's cascade Shadow Mode.

Apply to Blender Light

Pushes these values onto the Blender light datablock so the viewport preview matches Godot as closely as Blender can.

Clear FPK Light Settings

Removes the FPK light tags from the object.