PoiBuilder 0.9.167
/ Start here / Build the room. Export the map.

Build the room. Export the map.

PoiBuilder is a ProBuilder-style mesh builder that lives in the Godot 4 editor. Drag shapes on any surface, edit vertices, paint, then export a modern GLB or a retro map measured on a PSP.

Build a cube in 60 secondsInstall
60 secondsA cube, a pulled face, a doorway. The first win. Build a mapEmpty project → splats, decals, waterfall, particles, neon lightmap room → play and export. End to end. Go retroThe same map as a .pbm — verify it, then implement the format in your engine from the spec and the reference renderer. Mesh opsExtrude, inset, bevel, knife, loop cut, weld, detach. Shift+Move extrudes live. UV editorA dedicated 2D canvas, selection synced both ways, projections for ramps. Retro exportTile-baked .pbm with vertex light, running on a Sony PSP.
The full showcase film: the courtyard built start to finish in the editor, then the same map running on a real PSP.
Alpha. PoiBuilder is in its first alpha release. Grab the newest build from Releases (or the Asset Library) — see Install. Saved scenes may still break between alphas until 1.0.

What you are looking at

PoiBuilder is a Godot 4 editor plugin. You enable it, and a toolbar appears under the 3D viewport. From there you create PBMesh nodes — editable meshes that keep faces, UVs, materials and collision in one place.

It is pure GDScript. It runs on standard Godot and Godot .NET. Development and heavy testing happen on Godot 4.7; surface-level testing on Godot 4.6 stable passes (see Install).

Typical work:

  1. Drag a floor, walls, stairs, a door.
  2. Pull faces, cut loops, bevel edges, fill holes.
  3. Assign materials, paint blends, stamp a poster, scroll a waterfall.
  4. Nudge how a texture sits on a face from the 3D view itself — texture mode (6) moves the face's UVs with the same gizmo.
  5. Place particle emitters and billboards from the dock.
  6. Poibuilderize a GLB prop you dragged in, boolean a hole with CSG.
  7. Export a modern GLB, or a retro .pbm with textures sanitized for the PSP.

The walkthroughs do all of it in one pass on one map — with screenshots of the finished result.

Two ways to read these docs

  • Start here — Install, then First minutes. One cube. One pulled face.
  • Reference — every tool, every default key, every gotcha. Use the sidebar. The keys table is generated from the plugin's action list.

The film of the plugin building a courtyard (and the same map on a PSP) is the README embed. Short clips on later pages are cut from that capture.

Where the docs live

These pages are static HTML. No CDN. They work offline.

  • Bundled with the addon at addons/poibuilder/docs-site/index.html — the toolbar DocsExport...DocsRow 2 · ExportDocsOpens the bundled offline documentation (the site you are reading).Needs: Nothing (always enabled) button opens them.
  • GitHub Pages, built from the same Markdown.
A greyed-out toolbar button is not broken. It is the wrong selection for that op; the tooltip names the context it wants.