Lua Virtual Reality Engine
Go to file
bjorn 679c5beff8 Switch between glfw/win32 based on LOVR_USE_GLFW flag; 2024-05-19 15:57:10 -07:00
.github actions: Adjust MoltenVK paths for newer SDK version; 2024-03-17 21:37:48 -07:00
deps rm ode; 2024-05-18 18:30:33 -07:00
etc Work around glslang bug; 2024-05-19 02:20:30 -07:00
plugins Update lovr-http; 2024-05-03 10:55:03 -07:00
src Switch between glfw/win32 based on LOVR_USE_GLFW flag; 2024-05-19 15:57:10 -07:00
.gitignore Tweak gitignore; 2021-07-19 00:02:10 -07:00
.gitmodules Stop using glslang fork; 2024-05-19 02:04:13 -07:00
CHANGES.md Update changelog; 2024-05-18 18:56:20 -07:00
CMakeLists.txt Try to get everything using the same MSVC runtime library; 2024-05-19 01:09:19 -07:00
LICENSE Year; 2024-01-07 14:07:35 -08:00
README.md Update README; 2023-07-24 14:52:00 -07:00
Tupfile.lua tup: generate glslang build_info.h; 2024-05-19 02:03:23 -07:00

README.md

LÖVR

A simple Lua framework for rapidly building VR experiences.

You can use LÖVR to easily create VR experiences without much setup or programming experience. The framework is tiny, fast, open source, and supports lots of different platforms and devices.

Build Version Matrix Discord

Homepage | Documentation | FAQ

Features

  • Cross-Platform - Runs on Windows, macOS, Linux, and Android.
  • Cross-Device - Supports Vive/Index, Oculus Rift/Quest, Windows MR, and has a VR simulator.
  • Beginner-friendly - Simple VR scenes can be created in just a few lines of Lua.
  • Fast - Writen in C11 and scripted with LuaJIT, includes optimized single-pass stereo rendering.
  • Asset Import - Supports 3D models (glTF, OBJ), skeletal animation, HDR textures, cubemaps, fonts, etc.
  • Spatialized Audio - Audio is automatically spatialized using HRTFs.
  • Vector Library - Efficient first-class support for 3D vectors, quaternions, and matrices.
  • 3D Rigid Body Physics - Including 4 collider shapes, triangle mesh colliders, and 4 joint types.
  • Compute Shaders - For high performance GPU tasks, like particles.

Getting Started

It's really easy to get started making things with LÖVR. Grab a copy of the executable from https://lovr.org/download, then write a main.lua script and drag it onto the executable. Here are some example projects to try:

Hello World

function lovr.draw(pass)
  pass:text('Hello World!', 0, 1.7, -3, .5)
end

Spinning Cube

function lovr.draw(pass)
  pass:cube(0, 1.7, -1, .5, lovr.timer.getTime())
end

Hand Tracking

function lovr.draw(pass)
  for _, hand in ipairs(lovr.headset.getHands()) do
    pass:sphere(vec3(lovr.headset.getPosition(hand)), .1)
  end
end

3D Models

function lovr.load()
  model = lovr.graphics.newModel('model.gltf')
end

function lovr.draw(pass)
  pass:draw(model, x, y, z)
end

More examples are on the docs page.

Building

You can build LÖVR from source using CMake. Here are the steps using the command line:

mkdir build
cd build
cmake ..
cmake --build .

See the Compiling Guide for more info.

Resources

  • Documentation: Guides, tutorials, examples, and API documentation.
  • FAQ: Frequently Asked Questions.
  • Matrix: The LÖVR community for discussion and support.
  • Nightly Builds: Nightly builds for Windows.
  • Compiling Guide: Information on compiling LÖVR from source.
  • Contributing: Guide for helping out with development 💜
  • LÖVE: LÖVR is heavily inspired by LÖVE, a 2D game framework.

Contributors

License

MIT, see LICENSE for details.