https://github.com/groverburger/g3d

Simple and easy 3D engine for LÖVE.
https://github.com/groverburger/g3d

g3d love2d lua simple

Last synced: about 13 hours ago
JSON representation

Simple and easy 3D engine for LÖVE.

• Host: GitHub
• URL: https://github.com/groverburger/g3d
• Owner: groverburger
• License: mit
• Created: 2019-02-26T01:55:18.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-03-09T12:41:42.000Z (10 months ago)
• Last Synced: 2025-01-04T00:14:23.586Z (8 days ago)
• Topics: g3d, love2d, lua, simple
• Language: Lua
• Homepage:
• Size: 18.9 MB
• Stars: 584
• Watchers: 31
• Forks: 36
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-love2d - g3d - Simple and easy 3D engine for LÖVE. (3D)

README

        
![g3d_logo](https://user-images.githubusercontent.com/19754251/91235387-502bb980-e6ea-11ea-9d12-74f762f69859.png)

groverburger's 3D engine (g3d) simplifies [LÖVE](http://love2d.org)'s 3d capabilities to be as simple to use as possible.


View the original forum post [here](https://love2d.org/forums/viewtopic.php?f=5&t=86350).

![pic1](demo.gif)

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

```lua

-- written by groverbuger for g3d

-- may 2021

-- MIT license

local g3d = require "g3d"

local earth = g3d.newModel("assets/sphere.obj", "assets/earth.png", {0,0,4})

local moon = g3d.newModel("assets/sphere.obj", "assets/moon.png", {5,0,4}, nil, {0.5,0.5,0.5})

local background = g3d.newModel("assets/sphere.obj", "assets/starfield.png", {0,0,0}, nil, {500,500,500})

local timer = 0

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, math.pi - timer, 0)

    g3d.camera.firstPersonMovement(dt)

    if love.keyboard.isDown("escape") then love.event.push("quit") end

end

function love.draw()

    earth:draw()

    moon:draw()

    background:draw()

end

```

## Features

- 3D Model rendering

- .obj file loading

- Basic first person movement and camera controls

- Perspective and orthographic projections

- Easily create your own custom vertex and fragment shaders

- Basic collision functions

- Simple, commented, and organized

- Fully documented, check out the [g3d wiki](https://github.com/groverburger/g3d/wiki)!

## 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](https://github.com/groverburger/g3d/wiki)!

## Games and demos made with g3d

[Hoarder's Horrible House of Stuff](https://alesan99.itch.io/hoarders-horrible-house-of-stuff) by alesan99


![Hoarder's Gif](https://img.itch.zone/aW1hZ2UvODY2NDc3LzQ4NjYzMDcuZ2lm/original/byZGOE.gif)

[Lead Haul](https://hydrogen-maniac.itch.io/lead-haul) by YouDoYouBuddy


![image](https://user-images.githubusercontent.com/19754251/134966103-014a1f67-c79f-4bf6-bece-5764d6c22ee5.png)

[First Person Test](https://github.com/groverburger/g3d_fps) by groverburger


![First Person Test Gif](https://user-images.githubusercontent.com/19754251/108477667-6012f900-7248-11eb-97e9-8fbc03a09a99.gif)

[g3d voxel engine](https://github.com/groverburger/g3d_voxel) by groverburger


![g3d_voxel3](https://user-images.githubusercontent.com/19754251/146161518-7e94510f-5683-4a3c-aaa2-c39d4d23f0bd.png)

## Additional Help and FAQ 

Check out the [g3d wiki](https://github.com/groverburger/g3d/wiki)!