groverburger / G3d

groverburger's 3D engine (g3d) simplifies LÖVE's 3d capabilities to be as simple as possible.
View the original forum post here.

Features

• 3D Model rendering
• .obj file loading
• Basic first person movement and camera controls
• Perspective and orthographic projections
• Simple, commented, and organized

Getting Started

1. Download the latest release version.
2. Add the g3d subfolder folder to your project.
3. Add g3d = require "g3d" to the top of your main.lua file.

For more information, check out the g3d wiki!

Games made with g3d

Hoarder's Horrible House of Stuff by alesan99

Flamerunner by groverburger (that's me!)

Demo Code

The entire main.lua file for the Earth and Moon demo is under 30 lines, as shown here:

-- written by groverbuger for g3d
-- january 2021
-- MIT license

g3d = require "g3d"

function love.load()
    Earth = g3d.newModel("assets/sphere.obj", "assets/earth.png", {0,0,4})
    Moon = g3d.newModel("assets/sphere.obj", "assets/moon.png", {5,0,4}, nil, {0.5,0.5,0.5})
    Background = g3d.newModel("assets/sphere.obj", "assets/starfield.png", {0,0,0}, nil, {500,500,500})
    Timer = 0
end

function love.mousemoved(x,y, dx,dy)
    g3d.camera.firstPersonLook(dx,dy)
end

function love.update(dt)
    Timer = Timer + dt
    Moon:setTranslation(math.cos(Timer)*5, 0, math.sin(Timer)*5 +4)
    Moon:setRotation(0,-1*Timer,0)
    g3d.camera.firstPersonMovement(dt)
end

function love.draw()
    Earth:draw()
    Moon:draw()
    Background:draw()
end

Additional Help and FAQ

Check out the g3d wiki!