Skip to content
An easy to use VR toolkit for Oculus Quest development using the Godot game engine
Jupyter Notebook GDScript Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
OQ_Toolkit add Feature_PlayerCollision Jan 12, 2020
addons/godot_ovrmobile add Feature_PlayerCollision Jan 12, 2020
demo_scenes add Feature_PlayerCollision Jan 12, 2020
doc added simple hand gesture detection Dec 26, 2019
utilities Finalized walk in place demo Dec 12, 2019
.gitignore added OQ_ButtonPressable Jan 3, 2020 add Feature_PlayerCollision Jan 12, 2020
LICENSE Initial commit Sep 26, 2019
default_env.tres Initial commit Sep 26, 2019
export_presets.cfg add Feature_PlayerCollision Jan 12, 2020
icon.png Initial commit Sep 26, 2019
project.godot added toggle button demo to test scene Jan 4, 2020

Godot Oculus Quest Toolkit

This is an early alpha version of a toolkit for basic VR interactions with the Oculus Quest using the Godot game engine. The toolkit in this repository requires (at the time of writing) a recent version of Godot 3.2. If you have questions or run into problems please open an issue here or contact me at the official Godot Discord: @NeoSpark314 or in the #XR channel.

Features (so far... early alpha)

  • Touch controller button handling and controller models
  • Hand Tracking support with included hand models and basic gesture detection
  • VR Simulator and VR Recorder (for easier testing on desktop)
  • Joystick locomotion and rotation (smooth and step)
  • Walk in Place detection
  • 2D UI canvas with controller interaction
  • Falling and Climbing logic
  • Rigid body grab
  • Several utilities to accelerate prototyping and debugging (Log, Labels, ...)

Feature Images Medieval City Test Scene Simple Hand Gestures

A video of some of the early alpha features can be seen on youtube here.


The documentation is in the project wiki. It includes a more detailed getting started section and an overview of the included features.

Known issues

As this is a very early version there are some known issues that are not yet resolved. If you know a solution feel free to open a github issue to further discuss it or catch me on the official Godot Discord: @NeoSpark314.

  • No shader precompilation/caching. This means there will be a very noticeable hiccup when new objects/materials are rendered for the first time (like showing the UI pointer or when transitioning scenes). This will be essential to resolve for actual applications!
  • No mip-mapping for UI canvas (thus text looks very bad at some distance)

Planned features

There are a lot of potential extensions and missing features. Some of the things I think I will tackle next are on this list; but if you have some other suggestions feel free to open an issue to discuss it.

  • Teleport movement option
  • Jumping of ledges while climbing
  • Grabbed objects
    • more grab-follow modes (like kinematic body)
    • handing over objects
    • interaction trigger
  • Improvements to the labeling system
  • Physics interactors (levers, rotators, buttons, maybe doors)



The Godot Oculus Quest Toolkit and the demo scenes in this repository are licensed under an MIT License. The Oculus Touch controller 3d models the hand model and the Oculus Mobile SDK contained in this repository are copyright Oculus, see for license information. The Roboto font used is licensed under an Apache License and available at

You can’t perform that action at this time.