Author: World Builder ONE Team

  • Packaging & Standalone Installer Distribution Guide

    One of the most frustrating parts of distributing custom flight simulation scenery is guiding end users through manual folder extraction, library dependencies, and editing scenery_packs.ini. World Builder Pro solves this with an integrated Standalone Installer Compiler.

    1. The DAG-Based Incremental Build Pipeline

    When you click Build All, World Builder executes a Directed Acyclic Graph (DAG) pipeline across four staged layers:

    • Overlays: Assembles placed 3D objects, facades, forests, lines, strings, and town autogen polygons into compiled DSF overlay tiles.
    • Landmarks: Compiles procedural OBJ8 models, verifies UV atlases, and ensures accompanying _LIT.png textures exist.
    • Mesh & Orthos: Slices elevation triangles and compresses photographic textures with proper mipmap generation.
    • Assembly & Validation: Verifies every texture reference and checks that no external library paths are missing.

    2. Scenery Pack Consistency Checks

    The builder performs automated sanity tests before packaging:

    • Detects missing or broken texture references that would cause simulator load errors.
    • Verifies that exclusion zones do not inadvertently suppress your own custom airport buildings.
    • Confirms that all custom .obj and .fac definitions match official X-Plane 12 format standards.

    3. Generating the Standalone Installer

    In World Builder Pro, navigate to Publish > Create Standalone Installer. Configure your product title, version number, custom branding banner, and optional license agreement.

    World Builder compiles a single, self-extracting executable installer for macOS and Windows. When your end users run the installer:

    • It automatically locates their X-Plane 12 installation directory.
    • It extracts the scenery files directly to Custom Scenery/.
    • It correctly places your pack at the top of scenery_packs.ini, preventing priority ordering conflicts.
  • AI Automation with Model Context Protocol (MCP)

    World Builder Pro introduces native support for the Model Context Protocol (MCP)—an open standard created by Anthropic that allows AI assistants to safely interact with local development applications.

    How MCP Works in World Builder

    World Builder runs a lightweight, local MCP server. When you connect an external AI assistant (such as Claude Desktop, Antigravity, or Cursor), the assistant gains the ability to call World Builder’s internal authoring tools on your command.

    Connecting Claude Desktop to World Builder

    To connect Claude Desktop to your local World Builder session, add the following configuration to your claude_desktop_config.json file:

    {
      "mcpServers": {
        "world-builder": {
          "command": "/Applications/World Builder.app/Contents/MacOS/World Builder",
          "args": ["--mcp-server"]
        }
      }
    }

    Core MCP Tool Actions

    Once connected, your AI assistant can execute commands across all major studio subsystems:

    • create_landmark: Procedurally generates a textured 3D OBJ8 model from architectural parameters and inserts it into your DSF overlay.
    • download_osm & build_osm_overlays: Queries OpenStreetMap boundaries, extracts building footprints and road networks, and compiles autogen town zones.
    • audit_airport: Scans runways, taxiways, and ramp starts for coordinate disconnects and Gateway compliance.
    • build_pack: Triggers the incremental build pipeline, validates textures, and produces an exportable pack.

    Creating Custom Reusable Skills

    Advanced developers can chain multiple MCP tools into repeatable scripts or “skills” (for example, automating an entire regional island scenery pipeline). The AI executes the steps sequentially, reporting progress and handling validation errors automatically.

  • Terrain Sculpting & Orthophoto Aerial Imagery Guide

    In real-world flight simulation, the quality of the earth beneath your aircraft defines the visual experience. World Builder Pro combines terrain mesh sculpting and aerial orthophoto management into an interactive, visual workflow.

    1. Terrain Mesh Sculpting & Elevation Brush

    Default simulation meshes often leave airport boundaries jagged, with runways cutting unnaturally into hillside terraces. In the Terrain layer, select the Elevation Brush to manipulate vertex heights interactively:

    • Smooth Tool: Soften steep mesh cliffs around airport perimeters for natural terrain transitions.
    • Flatten Tool: Establish clean, uniform elevation planes across airport ramp operational areas.
    • Slope Tool: Draw a vector line across a sloped runway to enforce a smooth, continuous longitudinal gradient matching real-world charts.

    2. Ingesting Aerial Orthophotos

    World Builder Pro supports bringing your own aerial photographic sources. You can import local high-resolution GeoTIFF files or connect supported imagery tile providers using your personal API keys.

    Once ingested, imagery tiles are automatically reprojected, aligned to the underlying elevation mesh, and sliced into X-Plane’s native 1-degree DSF tile boundaries.

    3. Seasonal Texture Calibration

    X-Plane 12 features a dynamic 4-season climate engine. World Builder’s Seasonal Look Editor lets you preview how your orthophotos appear in Summer, Autumn, Winter, and Snow conditions.

    Apply non-destructive color balancing and desaturation curves to generate matching seasonal variants, ensuring your scenery blends seamlessly into surrounding default terrain regardless of the month you fly.

  • Creating Custom 3D Landmarks with Model Builder

    In World Builder Pro, creators no longer need to depend on complex external 3D software to build custom buildings, towers, and terminals. The built-in Model Builder is a dedicated CAD-grade modeler tailored specifically for X-Plane’s native OBJ8 engine.

    Why Native OBJ8 Modeling Matters

    General 3D software lacks awareness of flight simulator performance bottlenecks. Models built in external tools frequently suffer from un-instanced draw calls, misaligned normal maps, and broken night lighting. Model Builder enforces optimal flight sim practices from the first polygon.

    1. Reference Photo Sampling

    Start by dragging ground or aerial reference photos into the Model Builder viewport. The integrated color sampler analyzes lighting across the photograph and extracts a true-to-life architectural palette—eliminating toy-like oversaturated colors.

    2. Procedural Massing and Geometry

    Use procedural primitives designed for real architecture:

    • Extrusions & Booleans: Carve out arched windows, hangar door bays, and inset balconies using clean boolean operations.
    • Roof Shapes: Select from flat parapets, gabled roofs, domes, or spires with parameterized overhangs and pitches.
    • Parametric Repeaters: Add repeating pillars, window mullions, and roof trusses along linear or curved paths without duplicating vertex data.

    3. Smart UV Atlasing & Draw Calls

    When modeling multiple structures for an airport or landmark group, Model Builder packs all geometry UV coordinates into a consolidated texture atlas. This minimizes the texture swapping overhead for the GPU and preserves 60 FPS in dense environments.

    4. Synchronized Night Lighting (LIT)

    Switch the viewport look mode to Night. Select facade surfaces and designate emissive office window patterns, illuminated storefronts, or rooftop FAA obstruction beacons. Model Builder automatically generates the paired _LIT.png texture map with appropriate bloom and falloff.

    5. Placing Directly into Scenery

    Click Place in Scenery. Your landmark model is instantly compiled to .obj and inserted into your scenery’s DSF overlay at your current cursor position, automatically conforming to local ground elevation.

  • Airport Creation & Laminar Scenery Gateway Guide

    The Laminar Scenery Gateway is the lifeblood of X-Plane’s worldwide airport ecosystem. World Builder Basic provides a seamless, integrated environment to build, audit, and submit 3D airports to the Gateway—completely free of charge.

    Step 1: Discover and Download a Gateway Airport

    To start improving an airport, navigate to File > Import from Gateway. Search by ICAO code or airport name. World Builder fetches the latest approved Gateway revision, downloads its layout and default asset placements, and opens it directly in the 3D viewport.

    Step 2: Runway & Taxiway Layout

    In the left toolbar under the Airports section, select the Runway or Taxiway tool:

    • Runway Setup: Click to place the start and end thresholds. In the properties panel, choose surface type (asphalt, concrete, grass), set runway width, enable centerline lighting, and configure approach light systems (ALS).
    • Bezier Taxiway Curves: Click to draw polygon boundary vertices. Hold Alt while clicking to create smooth bezier curves. Adjust handle tangents directly in 3D to match satellite imagery.
    • Pavement Markings & Signs: Use the Line primitive to draw yellow centerlines, taxiway edges, and hold-short lines. Place taxiway guidance signs with exact codes (e.g., {@L}B{@@}).

    Step 3: Populating Ramps with Default Assets

    Gateway submissions strictly require using default X-Plane library assets (no custom external models). Open the Asset Browser (Cmd+Shift+A) and filter by X-Plane Default. Drag and drop baggage carts, fuel trucks, pushback tugs, wind socks, and terminal building facade kits directly into the scene.

    Step 4: Running the Gateway Validation Audit

    Before submitting, navigate to Airports > Audit Gateway Rules. World Builder runs an automated diagnostic check across your entire layout:

    • Verifies all taxiway lines connect cleanly without orphaned nodes.
    • Ensures ramp starts are assigned valid ATC sizes and airline codes.
    • Checks that no unauthorized third-party custom assets are referenced.
    • Validates boundary perimeters against exclusion zones.

    Step 5: Direct Submission

    Once all validation checks pass with green badges, click Submit to Gateway. Enter your Scenery Gateway credentials, provide a changelog summary for the moderators, and transmit your verified submission with one click.

  • Migrating Legacy WED Projects to World Builder

    One of the core design goals of World Builder Basic (Free) is ensuring 100% round-trip compatibility with Laminar Research’s legacy World Editor (WED). You can open your existing WED projects, enhance them in full real-time 3D, and export them back to WED XML without losing any data.

    Non-Destructive Import Architecture

    When you open an existing scenery folder containing an earth.wed.xml file, World Builder follows a strict non-destructive rule: the original source pack is never written to directly.

    Instead, World Builder creates an isolated project workspace: your project metadata, staged modifications, backups, and incremental build artifacts are kept separate. Your original source WED project remains completely untouched until you explicitly choose to export.

    How WED Entities Map into 3D

    World Builder parses the full hierarchical node tree of your WED project:

    • Airports & Boundaries: All ICAO codes, elevations, metadata properties, and airport boundary perimeters are loaded directly into the dedicated Airports layer.
    • Runways & Helipads: Surface types, dimensions, lighting, displaced thresholds, and runway end markings are rendered as high-fidelity 3D meshes adhering to terrain relief.
    • Taxiways & Markings: Bezier control points are preserved with mathematical precision. Pavement curves, edge lines, and hold-short bars retain their exact vertex coordinates.
    • Default Library Objects: References to X-Plane’s default library assets (ramp vehicles, hangar kits, towers, taxiway lights) are immediately loaded and rendered in 3D.

    Exporting Back to WED XML

    When you are ready to share your work with other creators who still use legacy WED, or submit to the Laminar Scenery Gateway, navigate to File > Export > WED XML. World Builder validates the hierarchy, checks for orphaned nodes, and writes a fully compliant .xml file ready for WED or Gateway ingestion.

  • Getting Started: The Unified 3D World Workspace

    Welcome to World Builder Studio. Whether you are creating a community airport for the Laminar Scenery Gateway or designing a massive regional VFR scenery, this guide will walk you through the core principles of the workspace.

    1. The Four-Pane Unified Interface

    Unlike older flight simulation utilities that spread tools across floating windows and separate dialogs, World Builder organizes everything into an integrated four-pane layout:

    • Header Bar: Displays your active project name, current coordinate reference, and real-time build pipeline state.
    • Left Toolbar (Primitives, Tools, Operators): Always accessible on the left. Pick overlay primitives (objects, facades, forests, lines, strings, autogen, polygons), tools (select, move, rotate, scale, edit contour), and operators (repeaters, cloners).
    • Central Viewport: The interactive canvas supporting seamless transitions between 2D Map, Satellite aerial context, and the full 3D Viewport.
    • Right Sidebar (Scene Tree & Inspector): The top section houses the Scene Tree (Imagery, Terrain, Overlays, Landmarks, Airports) while the bottom displays contextual properties for the active selection.

    2. Projection and Look Modes

    In the top-right corner of the viewport, quick-toggle buttons give you instant control over how your world is displayed:

    • Map View: Clean vector map mode ideal for high-level airport perimeter alignment and boundary checks.
    • Satellite View: High-resolution aerial photographic context for accurate placement against real-world geography.
    • 3D View: The primary interactive creation space. Walk or fly through your scenery with realistic physics and camera controls.
    • Render Look: Simulates X-Plane’s native lighting engine, atmospheric scattering, and sun angles.
    • Clay Look: Strips textures to reveal raw 3D geometry—perfect for checking facade alignments and mesh slopes.
    • Wireframe Look: Visualizes underlying polygon tessellation and vertex density.

    3. Transform Gizmos & Snapping

    Manipulating assets in World Builder uses industry-standard 3D gizmos. Selecting any asset reveals translation, rotation, and scale rings. Toggle grid snapping, heading quantization (15°, 45°, 90°), and terrain ground-clamping to position buildings and ramp equipment with millimeter precision.

    Next Steps

    Now that you are familiar with the interface, explore our guides on importing existing WED XML files or building custom 3D landmarks.