react-native-godot is a communication layer and embedding system that integrates the Godot game engine into cross-platform mobile applications. It allows Godot game scenes and logic to be rendered as interactive visual components within a mobile user interface.
The project provides a threaded logic bridge that executes engine functions on dedicated background threads using worklets. This ensures that game engine operations do not block the main application user interface.
The system covers engine lifecycle management, including the ability to start, stop, and pause instances to load different projects. It enables cross-language engine control by mapping JavaScript or TypeScript calls to native engine methods and synchronizing object properties. Additionally, it features a signal-based event mapping system to connect internal engine events to script-level callbacks.