Skip to main content

Platform & Cross-File Divergence Matrix

R2K16 targets multiple platforms: Windows (x86/x64), macOS, iOS, Android, and Xbox One (Durango). This matrix identifies all functions whose behavior or implementation differs across target platforms or code files.

Divergence Categories​

  1. Conditional Preprocessor Guards (#ifdef _WIN32, #ifdef __APPLE__, #ifdef ANDROID, #ifdef _DURANGO): The function's implementation branches internally at compile time to utilize platform-native APIs (e.g. WinINet vs WebKit vs POSIX sockets).
  2. Multi-File Platform Variants: The engine defines separate implementation files per platform (e.g., ClientShared/Win/CookiesEngine.cpp vs ClientShared/Mac/CookiesEngine.cpp vs ClientShared/Mobile/CookiesEngine.cpp).
  3. Caller Context Divergence: The function exhibits differing runtime behavior depending on whether it is executed within RobloxStudio (Qt UI loop), WindowsClient (DirectX VSync loop), or RCCService (headless unthrottled loop).

Divergent Functions Directory​

FunctionSource FilePlatform Preprocessor FlagsDivergence Summary
ChatWidget::processApp/gui/ChatWidget.cppMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp.
GuiItem::processApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp.
RelativePanel::initApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.cpp, XboxClient/VoiceChat.cpp, `W...
TopMenuBar::initApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.cpp, XboxClient/VoiceChat.cpp, `W...
TopMenuBar::processApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp.
TopMenuBar::getSizeApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
UnifiedWidget::initApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.cpp, XboxClient/VoiceChat.cpp, `W...
UnifiedWidget::processApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp.
TextDisplay::initApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.cpp, XboxClient/VoiceChat.cpp, `W...
TextDisplay::getSizeApp/gui/GUI.cppMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
Widget::processApp/gui/Widget.cppMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp.
getStateApp/humanoid/HumanoidState.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/UserTranslator.h.
HumanoidState::createApp/humanoid/HumanoidState.cppMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
getSizeApp/include/gui/ChatOutput.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
getSizeApp/include/gui/GUI.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
isEnabledApp/include/gui/Widget.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
getComputeEventBaseAddressApp/include/humanoid/HumanoidState.hWindows (Win32/x64 API)Behavior branches internally via conditional compilation for: Windows (Win32/x64 API).
getValueApp/include/lua/LuaBridge.hWindows (Win32/x64 API)Behavior branches internally via conditional compilation for: Windows (Win32/x64 API).
getNameApp/include/reflection/Callback.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
singletonApp/include/reflection/EnumConverter.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/MobileDevelopmentDeployer.cpp.
singletonApp/include/reflection/EnumConverter.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/MobileDevelopmentDeployer.cpp.
createApp/include/reflection/Event.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
executeApp/include/reflection/Event.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/marshaller.cpp.
sendEventApp/include/reflection/Event.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/UserInput.cpp, XboxClient/XbLiveUtils.cpp.
getNameApp/include/reflection/Event.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
getNameApp/include/reflection/Function.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
executeApp/include/reflection/Function.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/marshaller.cpp.
getNameApp/include/reflection/Property.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
writeApp/include/reflection/Property.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp, `App/util/Darwin/HttpC...
readApp/include/reflection/Property.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp, App/util/WinHttp.cpp...
getDataSizeApp/include/reflection/Property.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h.
getDataSizeApp/include/reflection/Property.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h.
singletonApp/include/reflection/Type.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/MobileDevelopmentDeployer.cpp.
getApp/include/reflection/Type.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxMainWindow.cpp, `XboxClient/UserTranslator....
getNameApp/include/reflection/YieldFunction.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
singletonApp/include/reflection/reflection.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/MobileDevelopmentDeployer.cpp.
isEnabledApp/include/script/DebuggerManager.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
sizeApp/include/script/LuaArguments.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
updateApp/include/script/ScriptContext.hWindows (Win32/x64 API)Behavior branches internally via conditional compilation for: Windows (Win32/x64 API). Alternative platform-specific imp...
checkAnchorApp/include/script/ScriptContext.hWindows (Win32/x64 API)Behavior branches internally via conditional compilation for: Windows (Win32/x64 API).
createApp/include/script/ScriptStats.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
getApp/include/script/ThreadRef.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxMainWindow.cpp, `XboxClient/UserTranslator....
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
getSizeApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/solver/ConstraintJacobian.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
startApp/include/solver/SolverProfiler.hMulti-File VariantAlternative platform-specific implementations exist in: Win/DSVideoCaptureEngine.cpp.
updateApp/include/solver/SolverSerializer.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/filewatcher/FileWatcherWin32.cpp.
sizeApp/include/util/Average.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/ClusterCellIterator.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/ClusterCellIterator.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/ControlledLRUCache.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/DoubleEndedVector.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
resetApp/include/util/ExponentialRunningAverage.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/util/ExponentialRunningAverage.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
resetApp/include/util/ExponentialRunningAverage.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
sizeApp/include/util/Extents.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
containsApp/include/util/Extents.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
sizeApp/include/util/ExtentsInt32.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
containsApp/include/util/ExtentsInt32.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
containsApp/include/util/ExtentsInt32.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
sizeApp/include/util/Face.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/FixedArray.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
getNameApp/include/util/Guid.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
createApp/include/util/Guid.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
sizeApp/include/util/HttpPlatformImpl.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/HttpPlatformImpl.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/IndexArray.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
sizeApp/include/util/LRUCache.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
maxSizeApp/include/util/LRUCache.hMulti-File VariantAlternative platform-specific implementations exist in: Base/rbx/Android/ifaddrs.c.
getNameApp/include/util/Name.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
createApp/include/util/Object.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
containsApp/include/util/Rect.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
sizeApp/include/util/Rect.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/p2p.h.
getSizeApp/include/util/Region3.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxRibbonMainWindow.cpp.
containsApp/include/util/Region3Int16.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
getCenterApp/include/util/Rotation2d.hMulti-File VariantAlternative platform-specific implementations exist in: App/util/IndexBox.cpp.
runApp/include/util/RunStateOwner.hMulti-File VariantAlternative platform-specific implementations exist in: Win/ScriptErrorUploader.cpp, Win/DumpErrorUploader.cpp.
pauseApp/include/util/RunStateOwner.hMulti-File VariantAlternative platform-specific implementations exist in: Win/VideoControl.cpp.
stopApp/include/util/RunStateOwner.hMulti-File VariantAlternative platform-specific implementations exist in: Win/DSVideoCaptureEngine.cpp, WindowsClient/RenderJob.cpp, `...
isRunningApp/include/util/RunStateOwner.hMulti-File VariantAlternative platform-specific implementations exist in: Win/DSVideoCaptureEngine.cpp.
getApp/include/util/Sound.hMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxMainWindow.cpp, `XboxClient/UserTranslator....
sleepTimeApp/include/util/SoundService.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/renderJob.cpp, App/util/Win/CheatEngine.cpp, `Win...
errorApp/include/util/SoundService.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/async.h, App/util/Win/CheatEngine.cpp.
stepDataModelJobApp/include/util/SoundService.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/renderJob.cpp, WindowsClient/RenderJob.cpp.
createApp/include/util/SoundService.hMulti-File VariantAlternative platform-specific implementations exist in: XboxClient/VoiceChatMaxNet.h, XboxClient/async.h, `Rendering...
readApp/include/util/Utilities.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp, App/util/WinHttp.cpp...
writeApp/include/util/Utilities.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.cpp, `App/util/Darwin/HttpC...
resetApp/include/util/Utilities.hMulti-File VariantAlternative platform-specific implementations exist in: Network/Replicator.NewInstanceItem.h.
getApp/include/util/base64.hppMulti-File VariantAlternative platform-specific implementations exist in: RobloxStudio/RobloxMainWindow.cpp, `XboxClient/UserTranslator....
isEnabledApp/include/v8datamodel/ChangeHistory.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
startApp/include/v8datamodel/ColorSequence.hMulti-File VariantAlternative platform-specific implementations exist in: Win/DSVideoCaptureEngine.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
doItApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
doItApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
doItApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
doItApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.
isCheckedApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
doItApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.cpp.
isEnabledApp/include/v8datamodel/Commands.hMulti-File VariantAlternative platform-specific implementations exist in: WindowsClient/GameVerbs.h, WindowsClient/GameVerbs.cpp.

Case Study: Key Multi-File Implementation Variants​

1. CookiesEngine Subsystem​

  • Windows Implementation (ClientShared/Win/CookiesEngine.cpp): Utilizes Microsoft WinINet APIs (InternetGetCookieEx, InternetSetCookieEx) hooked into Internet Explorer / Win32 cookie cache.
  • Mac Implementation (ClientShared/Mac/CookiesEngine.cpp): Utilizes macOS WebKit / Foundation NSHTTPCookieStorage synchronized with user WebKit storage.
  • Mobile Implementation (ClientShared/Mobile/CookiesEngine.cpp): Employs an isolated filesystem-backed cookie jar optimized for iOS / Android sandboxed app environments.

2. Crypt Cryptography Subsystem​

  • Windows Implementation (Base/rbx/Crypt.cpp & WindowsClient/Crypt.cpp): Interfaces with Win32 CryptoAPI / Crypt32 for hardware-assisted key storage and verification.
  • Unix / POSIX Implementation (Base/rbx/Unix/Crypt.cpp): Employs portable RC4/AES software ciphers independent of Windows DLLs.

3. FileSystem Path Resolution​

  • Windows (App/util/Win/FileSystem.cpp): Resolves paths via SHGetFolderPathW pointing to C:\Users\<User>\AppData\Local\Roblox.
  • Android (App/util/Android/FileSystem.cpp): Queries Android JNI context to locate /data/data/com.roblox.client/files.