Skip to main content

Pulse.World

Pulse.World wraps common workspace navigation patterns to be nil-safe. Instead of workspace.Titans.Alive:GetChildren() crashing when Alive doesn't exist yet, you get an empty table.

API​

-- Find a folder/instance by path (returns nil if any step is missing)
local alive = Pulse.World.find("Titans", "Alive")

-- Get children of a path (returns {} on failure — never throws)
local titans = Pulse.World.children("Titans", "Alive")

-- Get a game service safely
local ts = Pulse.World.service("TweenService")

-- Wait for a child with timeout
local hrp = Pulse.World.await(character, "HumanoidRootPart")
local hrp = Pulse.World.await(character, "HumanoidRootPart", 5)  -- 5s timeout

When to use it​

find and children are useful for one-off reads where the instance might not exist. For actively tracked live entity sets, the polling approach in globals.lua is more reliable — it handles spawning and despawning automatically.

await is useful in init or task.spawn blocks where you want to wait for an instance to appear before proceeding.