Object Primitives - Game Builder Engine

📦 Available Primitives

Primitives are basic 3D shapes that come with the engine. Use them for prototyping, level design, or as components of more complex objects.

🧊

Cube

6-sided box shape. The most versatile primitive for walls, floors, platforms, and buildings.

Uses: Walls, Floors, Crates, Buildings

🔴

Sphere

Perfectly round shape with adjustable segment count for smooth or faceted appearance.

Uses: Balls, Planets, Projectiles, Orbs

🛢️

Cylinder

Circular tube with flat top and bottom. Great for pillars and mechanical parts.

Uses: Pillars, Pipes, Barrels, Trees

📐

Plane

Flat rectangular surface. Single-sided by default - perfect for grounds and walls.

Uses: Ground, Water, Walls, Screens

🍩

Torus

Donut shape with adjustable major and minor radius for rings and tubes.

Uses: Rings, Portals, Tires, Pipes

🔺

Cone

Pointed shape tapering from circular base. Useful for trees and indicators.

Uses: Trees, Arrows, Roofs, Indicators

💊

Capsule

Cylinder with rounded ends. Perfect for character colliders and pills.

Uses: Characters, Colliders, Power-ups

💎

Icosphere

Sphere made of triangles for more uniform polygon distribution.

Uses: Gems, Low-poly spheres, Particles

➕ Adding Primitives

There are three ways to add primitives to your scene:

Method 1: Menu

Go to Add Object → Primitives and select your shape. It will appear at the world origin (0, 0, 0).

Method 2: Right-Click

Right-click in the Hierarchy panel → Create → Primitive → select your shape.

Method 3: Keyboard Shortcut

Press Shift + A to open the Add menu, then navigate to Primitives.

⚙️ Primitive Properties

Each primitive has configurable properties in the Inspector panel:

Property	Description	Primitives
Width/Height/Depth	Dimensions of the shape	Cube, Plane
Radius	Size from center to edge	Sphere, Cylinder, Cone, Capsule
Height	Vertical size	Cylinder, Cone, Capsule
Segments	Polygon detail level (higher = smoother)	All curved shapes
Radial Segments	Subdivisions around the circumference	Cylinder, Cone, Torus
Tube Radius	Thickness of the tube	Torus

🎨 Materials & Textures

By default, primitives use a basic gray material. To customize:

Select the primitive
In the Inspector, find the Material section
Click + Add Material or drag a material from the Assets panel
Adjust color, texture, metallic, roughness, and other properties

💡 Tip: UV Mapping

All primitives come with proper UV coordinates for texturing. Textures will wrap naturally around the shape.

🧊 Object Primitives