Forge AI Documentation

-- Open forge.loopmobile.io/chat and type any of these:

"Give me a sword in StarterPack"
"Add 2 zombie enemies that chase the player"
"Build a shop UI with 3 items and a Buy button"
"Generate a magical purple crystal in 3D"
"Create an obby with 5 stages and checkpoints"
"Drop a screenshot of UI → I'll rebuild it in Roblox"
"Make NPCs that talk and give quests"
"Audit my place and tell me what's broken"

-- You type in the chat:
"Build me a combat system with a sword and health bar"

-- Forge AI creates:
-- + ReplicatedStorage/Remotes/CombatRemote
-- + ServerScriptService/CombatServer (84 lines)
-- + StarterGui/HealthBarUI (dark theme, animated)
-- + ServerStorage/Weapons/ClassicSword
-- + StarterPlayerScripts/CombatClient (56 lines)
-- Done in ~45 seconds, 1 credit used

--!strict
-- StarterPlayerScripts/SprintHandler (LocalScript)
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
local SPRINT_SPEED = 32
local WALK_SPEED = 16

UserInputService.InputBegan:Connect(function(input, processed)
    if processed then return end
    if input.KeyCode == Enum.KeyCode.LeftShift then
        local char = player.Character
        if char then
            local hum = char:FindFirstChildOfClass("Humanoid")
            if hum then hum.WalkSpeed = SPRINT_SPEED end
        end
    end
end)

UserInputService.InputEnded:Connect(function(input)
    if input.KeyCode == Enum.KeyCode.LeftShift then
        local char = player.Character
        if char then
            local hum = char:FindFirstChildOfClass("Humanoid")
            if hum then hum.WalkSpeed = WALK_SPEED end
        end
    end
end)

-- Type in chat:
"Generate a low-poly medieval castle"
"Create a cartoon treasure chest"
"Make a sci-fi laser gun, blue glow"

-- Forge will:
-- 1. Generate the 3D model via AI
-- 2. Upload it to Roblox
-- 3. Insert it into Workspace
-- 4. Position it near your camera

-- Type: "Audit my game and give me a quality score"

-- Forge runs a comprehensive scan:
-- Structure: SpawnLocation, script placement, hierarchy
-- Security: RemoteEvent validation, client-side currency
-- Performance: Part count, unanchored parts, StreamingEnabled
-- Dead Code: Unused RemoteEvents, empty/disabled scripts
-- Gameplay: Baseplate, DataStore usage, kill bricks

-- Output: Game Quality Score: 72/100
-- + offers to fix each issue automatically

-- Type: "Profile my game's performance"

-- Forge measures:
-- Memory: 245 MB (OK)
-- FPS: ~58 (OK)
-- Instances: 12,450
--   Parts: 3,200 (MeshParts: 890)
--   Scripts: 45 (Active: 38)
--   GUI Objects: 120
--   Particles: 18
-- StreamingEnabled: true

-- Issues Found:
-- 1. 340 unanchored parts causing physics load
-- 2. 7 disabled scripts (delete or re-enable)
-- 3. 3 unused RemoteEvents

-- Type: "Make NPCs that talk and give quests"

-- Forge creates:
-- + DialogData (ModuleScript) - dialog trees
-- + DialogServer (Script) - proximity + state
-- + DialogClient (LocalScript) - typewriter UI
-- + QuestServer (Script) - progress tracking
-- + QuestUI (ScreenGui) - quest log + tracker
-- + NPC Models with ProximityPrompt

-- Quest types: collect, kill, visit, talk, deliver
-- All progress tracked server-side via Attributes

-- Terrain:
"Create a desert terrain with sand dunes"
"Build a mountain range with snow peaks"
"Make an ocean with a small island"

-- Effects:
"Add fire particles to the torch"
"Create a healing glow effect"
"Make a dash trail effect"

-- Lighting:
"Set up horror lighting with fog"
"Create a sunset atmosphere"
"Add underwater post-processing"