You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Pedro Gimeno 780b39605f Adapt the code to the latest changes in GameKit 15 hours ago
client Adapt the code to the latest changes in GameKit 15 hours ago
cmake [CMakeLists.txt] Now allows compiling on Windows. 4 weeks ago
common Adapt the code to the latest changes in GameKit 15 hours ago
doc [doc] Added. 1 year ago
external [SimplexNoise] Removed. [TerrainGeneration] Now using FastNoise for land height. 1 week ago
mods/default [TerrainGenerator] Tall Grass added. 23 hours ago
resources Shaders don't use blockID anymore. Fixes #48. 23 hours ago
server Adapt the code to the latest changes in GameKit 15 hours ago
.codedocs [doc] Added. 1 year ago
.gitignore [Config] New function 'loadConfigFromFile' automatically loads 'config.lua' if present. 4 days ago
.travis.yml [.travis.yml] Added. 1 year ago
CMakeLists.txt [CMakeLists.txt] Small improvements. 6 days ago [] Added. 1 year ago
LICENSE Small fixes. 1 year ago
Notes Server can be closed correctly now. 1 year ago [ClientApplication] Pressing 'F11' now switch to/from fullscreen mode. 2 days ago
TODO [Network] PlayerInventory and BlockActivated packets now send screen size and gui scale informations. 5 days ago
screenshot1.png [screenshots] Updated. 2 days ago
screenshot2.png [screenshots] Updated. 1 year ago
screenshot3.png [] Screenshots updated. 4 weeks ago
screenshot4.png [screenshots] Updated. 2 days ago


Build Status Documentation License Discord Donate

Project goal

The long-term goal of this project is to provide a viable alternative to Minecraft modding.


  • Movement: WASD
  • Inventory: E
  • Jump: Space
  • Sprint: Ctrl
  • Jetpack: X
  • Exit: Escape
  • Debug: F3
  • Fullscreen: F11


How to compile

Using Linux

  • Dependencies:
    • A compiler with C++14 support
    • CMake
    • GameKit (requires SDL2 + tinyxml2, will switch to SFML starting from 2.6)
    • SFML (only used for network)
    • Lua
    • Linux users: Check your distribution repositories for packages.
  • Run cmake .
  • Run make -j8
  • Run the server with ./server/openminer_server
  • Run the client with ./client/openminer

Using Windows


  • Discord: join server
  • IRC: #openminer

Project status

This list is non exhaustive.

Implemented features

  • Menus (title screen, server selection, pause menu, settings menu)
  • Basic worldgen (lakes, trees, flowers, pseudo-caves)
  • Infinite world in X/Y/Z axis (#25)
  • Lighting system with smooth lighting
  • Networking (#20)
  • Lua API
    • Block/item/recipe definition
    • Custom GUI creation
  • Special blocks (workbench, furnace)
  • Block metadata

Missing features

  • Texture pack system (#34)
  • World loading/saving (#26)
  • Particle system
  • Fluid propagation
  • Player model display (currently displaying an ugly box)
  • Day/night cycle with sun/moon display
  • Real worldgen (seed-based, biomes, cave tunnels)
  • Entities (block drops, mobs, etc...)
  • Clouds (#52)


Previous attempts

  • Here is the commit matching the end of the first attempt made in 2013.
  • And here is the commit matching the end of the second attempt made in 2014.

You can find an history of the project here.


  • MadPixel (Minecrafter font) [CC BY-ND]
  • xMrVizzy (Faithful 32x texture pack, will completely replace Vanilla textures)