OpenMiner/README.md

OpenMiner

• Project goal
• Wiki
• Keys
• How to compile
  • Using Windows
  • Using Linux
  • Using MacOS
• Discussion
• Project status
• Screenshots
• Credits

Project goal

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

Wiki

• Getting started
  • Contributing
  • Coding style
• Lua API
  • Core API
  • Mod API
  • GUI API
  • C++ classes in Lua
• Network Protocol

Keys

• Movement: WASD
• Inventory: E
• Creative window: H
• Chat: T
• Jump: Space
• Sprint: Ctrl
• Jetpack: X
• Exit: Escape
• Debug: F3
• Fullscreen: F11

How to compile

Using Windows

• Wiki: Compiling on Windows using CMake and MinGW-w64
• Wiki: Compiling on Windows using CMake and Visual Studio 2019

Using Linux

• Wiki: Compiling on Linux

Using MacOS

• Dependencies:
  • A compiler with C++17 support (GCC >= 7.0 or clang >= 5.0)
  • git and CMake (>= 3.12.4)
  • Optional: ninja (much faster builds)
  • Check Homebrew for packages.
• Run cmake -B build . && cmake --build build; if you installed ninja above, add -GNinja before -B in the previous command.
• Run the client with ./build/openminer
• If you want a multiplayer game, run the server with ./build/openminer_server

Discussion

• Discord: join server
• IRC: irc.freenode.net #openminer

Project status

This list is non exhaustive.

Implemented features

• Menus (title screen, server selection, pause, settings)
• Basic worldgen (biomes, lakes, trees, flowers, pseudo-caves)
• Infinite world in X/Y/Z axis (#25)
• Smooth lighting
• Networking (#20)
• Chat system with support for commands (#57)
• Lua API
  • Block/item/recipe/biome/tree/sky/dimension/entity definition
  • Custom GUI creation
• Special blocks (workbench, furnace)
• Block metadata
• Player model display (without animation)
• Dimensions (like the Nether or the Ender in Minecraft) (#80)
• World loading/saving (using /save <name> and /load <name> commands, see #26)
• Texture pack system (partially implemented, see #34)
• Entities (#90)

Missing features

• Fluid propagation (#62)
• Day/night cycle with sun/moon display (#73)
• Real worldgen (seed-based, cave tunnels) (#79)
• Clouds (#52)
• Particle system

Screenshots

Credits

• xMrVizzy (Faithful 32x texture pack, will completely replace Vanilla textures)
• ThePhD (sol2)
• skypjack (EnTT)