https://github.com/mbrlabs/mundus

A 3D world/level editor built with Java, Kotlin & libGDX.
https://github.com/mbrlabs/mundus

3d editor engine game libgdx terrain

Last synced: 3 months ago
JSON representation

A 3D world/level editor built with Java, Kotlin & libGDX.

• Host: GitHub
• URL: https://github.com/mbrlabs/mundus
• Owner: mbrlabs
• License: apache-2.0
• Created: 2015-12-24T02:17:04.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2018-10-16T19:23:20.000Z (over 6 years ago)
• Last Synced: 2023-10-20T21:43:17.179Z (over 1 year ago)
• Topics: 3d, editor, engine, game, libgdx, terrain
• Language: Java
• Homepage:
• Size: 20.5 MB
• Stars: 205
• Watchers: 34
• Forks: 38
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# Mundus [![](https://travis-ci.org/mbrlabs/Mundus.svg?branch=master)](https://travis-ci.org/mbrlabs/Mundus)

Mundus is a platform independent 3D world editor, built with Java, Kotlin and LibGDX + VisUI.

The plan is, that the world you create with Mundus can be exported

into a unified format (such as JSON + assets). The exported data can then be imported into any Game Engine,

if someone writes a runtime/parser for that engine.

![Screenshot](https://raw.githubusercontent.com/mbrlabs/Mundus/master/screenshot.png)

This project is at a very early stage in development, so expect large

changes in the future.

## Current features

Please note, that a lot of the UI contains dummy controls for functionality that still needs to be

implemented.

Below are some of the more interesting features, that already work

- Creation of multiple terrains

- Height map loader for terrains

- Procedural terrain generation

- Texture splatting for the terrain texture (max 5 textures per terrain)

- A complete terrain editing system with texture & height brushes

- 4 different brushes (brush form can be an arbitrary image, like in Blender or Gimp)

- 3 brush modes for each brush: Raise/Lower, Flatten & texture paint

- A skybox (not exportable yet)

- Loading of g3db files

- Loading of obj/fbx/dae files (note, that the [fbx-conv](https://github.com/libgdx/fbx-conv) binary must be set in the settings)

- A visual translation & rotation tool (scaling coming soon)

- Multiple scenes in one project

- A component based scene graph (not fully implemented yet)

- Basic export of the project into a json format + assets

- Undo/Redo system for most operations

- Highly accurate game object picking system, based on id color coding & offscreen framebuffer rendering.

  Basic concept: http://www.opengl-tutorial.org/miscellaneous/clicking-on-objects/picking-with-an-opengl-hack/

  

## Things to consider

- Mundus is constantly changing. Especially the internal representation of save files. At this stage of the project i don't care 

very much for backward compatibility, so don't fall to much in love with your creations if you want to stay up to date ;)

- Depending on your keyboard layout some key shortcuts might be twisted (especially CTRL+Z and CTRL+Y for QWERTZ and QWERTY layouts) 

because of the default GLFW keycode mapping. You can change the layout mapping in the settings dialog under Window -> Settings.

## Runtime

Currently i'm in the process of implementing the libGDX runtime, which is included in this repository.

Runtimes for other engines/frameworks are not planed in the near future.

## Contributing

Contributions are greatly appreciated. To make the process as easy as possible please follow the [Contribution Guide](https://github.com/mbrlabs/Mundus/wiki/Contributing).

To get an overview over the project you might also want to check out the [Project overview & architecture](https://github.com/mbrlabs/Mundus/wiki/Project-overview-%26-architecture) article.

## Working from source

See this [wiki article](https://github.com/mbrlabs/Mundus/wiki/Working-from-source).

## Credits

Logo design: [Franziska Böhm / noxmoon.de](http://noxmoon.de) ([CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/))