Skip to main content

Repository map

Every top-level entry in the repository, annotated. Deeper dives live in the Module Reference.

Engine & foundations​

EntryKindDescription
App/C++ libThe engine: Instance tree (v8tree), DataModel (v8datamodel), physics (v8world, v8kernel, solver, humanoid), Lua (script/, Lua-5.1.4/), reflection, serialization (v8xml), terrain (voxel, voxel2), tools, util, security
Base/C++ libFoundations: TaskScheduler, platform layers, asserts, memory, profiling
Network/C++ libRakNet-based replication stack (RakNet vendored in Network/raknet/)
Rendering/C++ libsGfxBase, GfxCore (D3D9/D3D11/GL), GfxRender, RbxG3D, g3d, AppDraw, ShaderCompiler, LibOVR, OpenVR, VrApi
CSG/C++ libSolid boolean geometry kernel over vendored sgCore
App.BulletPhysics/C++ libEmbedded Bullet Physics distribution
ClientBase/C++ libClient-side base bits: MachineConfiguration, ReflectionMetadata (+ .xml)
ClientShared/C++ libCode shared by clients: DataModelSerialize, CookiesEngine (with Mac/, Mobile/ variants), SDLGameController, InfluxDbHelper, RobloxServicesTools, CountersClient

Applications​

EntryKindDescription
RobloxStudio/C++ app (Qt)The Studio editor — see Studio
WindowsClient/C++ appWindows player client — see Clients
Win/C++ libShared Windows launcher code (logging, error upload, video capture, anti-debug)
XboxClient/UWP appXbox One client (not building)
iOS/XcodeiOS app + tests
Android/GradleAndroid app, libroblox native build, tests
Mac/, RobloxMac/, MacClient.xcodeprojXcodeMac app & workspace scaffolding
RobloxHybrid/JS/nativeHybrid web-shell client (Closure-compiled)
GameChat/C++ libMicrosoft Xbox GameChat XDK sources (not building)
Microsoft.Xbox.Samples.NetworkMesh/C++Xbox mesh-networking samples (not building)

Services​

EntryKindDescription
RCCService/C++ serviceHeadless game host — see RCCService
Roblox.RccServiceArbiter/C#RCC supervisor/arbiter (JobManager.cs, …)
RCCService.Test/, RCCService.Thumb.Test/C# testsService & thumbnail tests
RCCService.PrepForUpload/, RCCServiceArbiter.PrepForUpload/packagingRelease packaging stubs

Testing​

EntryDescription
App.UnitTest/ + .Lib/ + .Run/Engine unit tests (not building)
Base.UnitTest/ + .Lib/ + .Run/Foundation unit tests w/ TeamCity integration (not building)
RobloxTest/Big simulation/API/physics test rig (not building)
RobloxTest.Run/, RobloxTest.MultiPlayerTest.Run/, RobloxTest.PhysicsTests.Run/, RobloxTest.PhysicsPerfTest.Run/Run-project stubs for the rig
Roblox.Test/MSUnit-based aggregate tests (TestCases/, Rig/, MSUnitProxy/, RemoteTestShim/)
RbxTestHooks/DLL exposing engine hooks for test injection (builds)
RobloxMobileTest/Mobile test target
SimulationTestUtility/Shared simulation-test utilities

Tools & plugins​

EntryDescription
CoreScriptConverter2/CoreScript compile/conversion tool (not building)
ScriptSigner/Script signing tool
IncludeChecker/C# include-hygiene checker
RobloxModelAnalyzer/Model loading/analysis host
SettingsComparisonTool/Settings JSON reader/differ
BuiltInPlugins/Plugins bundled with Studio (.rbxmx)
StudioPlugins/Lua plugins (terrain, water, wiring, utilities)
Installer/Bootstrappers for all artifacts
PrepAllForUpload/, *.PrepForUpload/, RobloxStudio.PrepForUpload/, WindowsClient.PrepForUpload/Upload-packaging stubs

Content & assets​

EntryDescription
content/Shared runtime content (fonts, music, particles, scripts, sky, sounds, textures)
PlatformContent/Per-platform variants (pc, android, ios, durango)
shaders/Shader sources
fmod/FMOD audio SDK (headers + platform libs)

Third-party libraries​

EntryDescription
Library/Boost, Qt 4.8.5 sources, SDL2, curl, zlib, VMProtect, cpp-netlib, Mesa, xulrunner, glsl-optimizer, hlsl2glslfork, cabsdk, SDK, w3c-libwww — see Libraries
boostlibs/Solution projects for static Boost & Boost.Test
QTitanRibbon/Qt ribbon UI library used by Studio

Build system & config​

EntryDescription
Roblox.slnMaster Visual Studio solution (~354 KB, hundreds of projects)
CMakeLists.txtRoot CMake build (Unix/Android)
cmake/CMake helper modules
CustomBuildRules.props/.rules/.targets/.xmlMSBuild custom build rules
PropertySheets/Shared MSBuild property sheets
buildshaders.bat / buildshaders.shShader compilation scripts
RobloxDebugVisualizers.txtVisual Studio debug visualizers for engine types
RobloxPlayer-Info.plistPlayer bundle metadata (Mac)
.github/Workflows (msvc, semgrep, osv-scanner, scorecard, label, stale, sync, docs-deploy), labeler config, resources
website/This documentation site (Docusaurus)
README.md, LICENSE (Apache-2.0), .gitattributes, .gitignoreRepo metadata

Misc one-offs​

EntryDescription
RefreshPolicies/Windows tool managing client cache/refresh policies
RbxTestHooks/(listed above under Testing)
RobloxHybrid/(listed above under Applications)