Skip to content

Bricks & Entities

Bricks are the fundamental building blocks of the Vertexia world.

Base Properties (Part)

  • Name: String identifier.
  • Color: The RGB diffuse color.
  • Transparency: Controls alpha visibility (0.0 to 1.0).
  • Material: The surface shading profile. Options are Plastic, Wood Planks, and Metal.
  • Shape: The geometric mesh structure. Options are Cube, Sphere, Cylinder, Wedge, and CornerWedge.
  • ShowStuds: Toggles the procedural stud top-texture.
  • Position: Vector3 coordinate in world space.
  • Rotation: Vector3 Euler angles in degrees.
  • Size: Vector3 scale multiplier.
  • PhysicsEnabled: Toggles RigidBody physics vs Static positioning.
  • CanCollide: Controls interaction with the collision layer.
  • Bounciness: The restitution multiplier during physics impacts.
  • Density: The mass calculation multiplier.

Special Entities

Truss

Inherits standard part properties but automatically registers as climbable geometry for player characters.

Seat

Inherits standard part properties but binds a Weld to any player character that collides with it, snapping them into a sitting animation state.

SpawnLocation

Registers internally to the spawn_locations group. During player instantiation or respawn, the engine randomly selects from these locations to place the character.

Decal

Projects a 2D texture onto a 3D surface. * TextureId / NormalMapId: Fetched dynamically from the asset server. * Face: Maps projection to Front, Back, Top, Bottom, Left, or Right. * AlbedoMix / EmissionEnergy: Modifies material blending. * ScaleFreely: Allows decoupling the decal scale from its parent surface.

Sound

A 3D spatialized audio emitter. * SoundId: The fetched MP3/OGG/WAV asset ID. * Volume / Pitch: Standard audio modifiers. * PlaybackRange: The maximum distance the audio travels before fully attenuating. * Loop / Spatial / PlayOnAwake: State flags.

TextLabel (3D)

Renders crisp, billboarded or static text in 3D space. * Text / FontSize: Core text definitions. * Color / OutlineColor / OutlineSize: Visual modifiers.

NPC

A fully functional humanoid entity. * Appearance: FaceId, ShirtId, PantsId, TShirtId, Hat1Id, Hat2Id, Hat3Id. * Chat: ChatBubbleText, AutoRemoveBubble, BubbleDuration. * Stats: Health, MaxHealth, WalkSpeed, JumpPower.