From your first part
to a robot that responds.
A practical, illustrated manual for building, connecting, programming and testing in BotSims. Start small, understand the model, then make the next iteration better.
Your first AI rover
Load a working reference, read the sensors and see how power, wiring and code interact.
Follow the walkthrough →02 / MASTER THE WORKBENCHAssemble with intent
Snap parts to mounts, isolate groups and save subsystems as reusable modules.
Learn assembly →03 / ADD INTELLIGENCEYour model. Your key.
Discover a model, review its action and apply a short, bounded command to the simulator.
Connect a model →33 of 33 chapters
Start here06
What BotSims does
Understand the workbench, its models, and the quickest route to your first working robot.
Read chapterChoose robot families and ESP32 variants
Browse 16 prepared robot assemblies and understand their simulation coverage.
Read chapterWalkthrough: your first AI rover
A complete guided session from template to measurements, fault diagnosis, and export.
Read chapterWalkthrough: an expressive emoji robot
Try a display, a servo pose, text events, and optional AI interaction.
Read chapterFind your way around the workspace
Know which panel to use for assembly, wiring, code, AI, and verification.
Read chapterMake the playground larger and show only the panels you need
Show or hide seven workspace panels on every editor tab, and save or restore a focused layout.
Read chapterBuild and connect15
Place on the ground, attach parts, and check available force
Separate loose parts from physical mounts and compare mass, power and traction demand.
Read chapterReplace a component model while retaining its wiring
Right-click a part, review related models and preview the exact wiring impact.
Read chapterBrowse the categorized component library
Find parts by purpose, compare variants, and understand what adding a component creates.
Read chapterPlace, rotate, and inspect components
Use the 3D viewport and root-relative transforms with consistent units.
Read chapterDrag, snap, and attach compatible parts
Use magnetic mount previews, exact alignment, grid settings and direct manipulation.
Read chapterObject actions, visibility, and edit locks
Use contextual actions and keyboard shortcuts without losing track of the physical assembly.
Read chapterSave groups as reusable module presets
Build from starter subsystems or create your own library with internal wiring and mounts.
Read chapterGroup components and edit a subsystem in isolation
Organize a larger robot into power, compute, drivetrain, perception and interaction subsystems.
Read chapterRemove parts, remove wires, and undo changes
Delete components from any project and recover accidental edits.
Read chapterConnect named pins on the draggable wiring canvas
Drag, magnetically snap, reconnect and diagnose real electrical pin connections.
Read chapterWire power, signals, and motor outputs
Make real logical connections and understand why a device can be visible but unavailable.
Read chapterChoose wire thickness and plan connectors
Use AWG variants and a clear resistance example without treating it as a wiring rating.
Read chapterPlan gears, belts, chains, and mechanisms
Arrange transmission parts and distinguish layout formulas from active drivetrain physics.
Read chapterEdit engineering values with the right units
Understand battery, motor, load, sensor, and environment parameters before changing them.
Read chapterAdd a custom component definition
Create a saved geometry/mass part from JSON and avoid common import errors.
Read chapterProgram and simulate06
Write and execute your robot program
Use the actual JavaScript API, safe sensor handling, and persistent controller state.
Read chapterRun, pause, reset, and single-step
Understand simulation timing, restart behavior, and execution limits.
Read chapterConnect your own AI provider and test a bounded action
Discover account models, use a tab-only key, inspect sensor/image inputs and apply validated goals.
Read chapterUse camera input, displays, and audio devices
Know what the simulated devices expose and how image-input failures are resolved.
Read chapterExport, import and review recorded AI actions
Replay validated commands without making another provider request.
Read chapterUse PID feedback with output limits and anti-windup
API v3 provides bounded deterministic loops inside the isolated JavaScript controller.
Read chapterTest and reference06
Test scenarios and design diagnostics
Use reference checks correctly and test your own program in the live simulator.
Read chapterRead power, motion, and engineering reports
Interpret measurements and export the evidence from a run.
Read chapterSave, reopen, import, and export projects
Keep your work across sessions and move it between browsers safely.
Read chapterUnderstand accuracy and physical limits
Use the equations meaningfully and recognize what remains outside this release.
Read chapterTroubleshooting and frequently asked questions
Resolve common assembly, wiring, runtime, AI, and storage issues.
Read chapterTest your own program with assertions and export the result
Run the current project source in a fresh isolated controller and physics world.
Read chapter