world-building-3d

Compose, ground, align, and validate 3D scene objects using bounded spatial tools in Summer Engine.

66|4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/SummerEngine/summer --skill world-building-3d-summerengine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: world-building-3d
Source: https://github.com/SummerEngine/summer/tree/main/library/skills/world-building-3d
Command: npx skills add https://github.com/SummerEngine/summer --skill world-building-3d-summerengine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Placing props, aligning object groups, and validating navigation positions in 3D game scenes usually requires hand-tuned transforms and guesswork. This Skill replaces that with four bounded spatial tools that produce verifiable evidence for each geometric decision. ## Core Features & Use Cases - Placement Testing: Evaluate a candidate pose with summer_test_placement before mutating the scene, checking overlap counts, grounded state, and floor gap. - Surface Snapping: Seat objects on floors, shelves, tables, or ramps with summer_snap_to_surface, including slope alignment via alignUp. - Group Alignment: Align or evenly distribute 2–16 objects along a chosen world axis with summer_align_distribute_3d. - Navigation Validation: Probe whether NPCs, pickups, or portals are reachable on the navigation map with summer_navigation_probe. - Use Case: When building a level, snap furniture onto a sloped floor, distribute crates evenly along a wall, then probe that an enemy spawn point is reachable from the player start — verifying each result with a rendered screenshot. ## Quick Start Open my 3D scene in Summer Engine and place the crate prop on the warehouse floor, then verify it is grounded and reachable on the navigation map.

Frequently Asked Questions about world-building-3d

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place a 3D prop on a floor or shelf in Summer Engine?

Use summer_snap_to_surface with a world-space direction to seat the object on the support surface. For a candidate pose you want to evaluate first, call summer_test_placement, which is read-only and reports overlap counts, grounded state, and floor gap.

How do I align or evenly space multiple 3D objects?

Use summer_align_distribute_3d with 2 to 16 subjects passed in intentional order and an explicit world axis. Choose align_min, align_center, or align_max for shared anchors, or distribute_centers and distribute_gaps for even spacing.

How do I check if an NPC or portal position is reachable on the navigation map?

Call summer_navigation_probe from the player start point to the destination. A result is meaningful only when ready is true; also check the requested-to-snapped endpoint distance against the navigation agent radius before trusting a reachable result.

Does this work for 2D scenes in Summer Engine?

No. These tools read Node3D transforms, world AABBs, 3D physics, and World3D navigation state, so they only apply to 3D scenes. For 2D scenes or bulk procedural placement with computed positions, use the scene-scripting skill instead.

Why does summer_test_placement return fits: null?

A null fits value means the physics backend could not prove completeness, because Godot exposes no broadphase-completeness bit. It must not be treated as success; only zero known overlaps with complete evidence supports a fits claim.

What are the limitations of the 3D spatial tools?

The tools require a running Summer Engine with live scene, physics, and navigation state, and there is no raw .tscn fallback. Alignment solves one axis only and does not prove clearance on the other two, and snap results do not expose the raw support normal.