]> git.lizzy.rs Git - dragonblocks_alpha.git/blobdiff - README.md
Fix blending issues
[dragonblocks_alpha.git] / README.md
index b8952bbfa76189d3752a2d826757fd0a5aa9687c..baa5eece7855deb29553b8e5118b53009e8b7620 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 A multiplayer voxelgame for POSIX systems.
 
-Head to <https://www.elidragon.com/dragonblocks_alpha/> for snapshot and release builds.
+Head to <https://www.elidragon.tk/dragonblocks_alpha/> for ubuntu snapshot and release builds.
 
 ## Invocation
 
@@ -19,43 +19,72 @@ or alternatively:
 
 ## Controls
 
-Use W, A, S and D to move forward / left / backward / right and Space to jump.
+| Key | Action |
+|-|-|
+| W | Move Forward |
+| A | Move Left |
+| S | Move Backward |
+| D | Move Right |
+| Space | Jump / When flying: Move Up |
+| Left Shift | When flying: Move Down |
+| F | Toggle flight |
+| C | Toggle collision |
+| T | Toggle timelapse |
+| F2 | Take screenshot |
+| F3 | Toggle debug info |
+| F11 | Toggle fullscreen |
+| ESC | Pause / unpause game |
 
 ## Dependencies
 
+Both the client and the server depend on ZLib.
 The client depends on GLFW3, OpenGL, GLEW and Freetype.
+The server depends on SQLite3.
+
+Ubuntu / Debian:
 
 ```bash
-sudo apt install libgl1-mesa-dri libglfw3 libglew2.1 libfreetype6
+sudo apt install zlib1g libgl1-mesa-dri libglfw3 libglew2.1 libfreetype6 libsqlite3-0
+
 ```
 
-The server depends on SQLite3.
+FreeBSD:
 
-```bash
-sudo apt install libsqlite3-0
+```csh
+sudo pkg install lzlib mesa-dri glfw glew freetype sqlite3
 ```
 
-both the client and the server depend on ZLib.
+OpenBSD:
 
-```bash
-sudo apt install zlib1g
+```sh
+sudo pkg_add lzlib glfw glew freetype sqlite3
 ```
 
+## Setup Requirements
+Dragonblocks Alpha targets PCs only. Non x86-64 platforms may work, however there is no guarantee whatsoever.
+You need a POSIX system conforming to the ISO C and POSIX 2008 standards. However, so far only GNU/Linux systems, in particular Ubuntu and Debian, have been tested.
+The minimum OpenGL version is 4.6.0. Dragonblocks has been tested on Intel Integrated and NVIDIA GPUs, however other graphics cards should work as well.
+A PC with at least 4 CPU cores is recommended, but not necessarily required.
+
 ## Current Features
-- Multiplayer
-- Map generation with mountains and blended biomes that determine grass color
+- Multiplayer, Animated player model, Nametags
+- Mountains, snow, temperature and humidity, dynamic grass color, oceans and beaches, vulcanos, boulders
 - Physics
 - FPS Camera
-- Mipmapping, Antialiasing, Shaders
-- HUD
-- Saving the map to a SQLite3 database
-- Multithreading for map generation, mesh generation and network
+- Mipmapping, Antialiasing, Face Culling, Frustum Culling, Diffuse Lighting, Skybox, Fog
+- Taking screenshots
+- Daylight cycle
+- GUI
+- Saving terrain, player positions and other data to a SQLite3 database
+- Multithreaded terrain generation, mesh generation and networking
 - Handlers for SIGINT und SIGTERM (just Ctrl+C to shut down the server)
+- Log levels: error, warning, access, action, info, verbose
+- Loading assets such as textures, models, schematics, shaders and fonts from files
 
 ## Usage
 
 ### Server
-The server currently stores all the world files (currently only map.sqlite) in the current working directory, and it will stay like that.
+The server currently stores the world database (world.sqlite) in the current working directory, and it will stay like that.
 If you want to have multiple worlds, just run the DragonblocksServer process from different directories.
 It's up to you how you organize the world folders, which is an advantage since the program really just "does one thing well"
 without having to search your system for share directories or maintaining a world list (like Minetest does).
@@ -82,10 +111,10 @@ The name "Dragonblocks _Alpha_" does not have anything to do with the game being
 - Exciting and feature-rich gameplay with the focus on exploring and adventuring, while still being multi-optional and not too bloated
 - A simple structure and invocation syntax
 - Using modern OpenGL to combine performance with graphics quality on high-end computers
-- Portability between PCs running POSIX systems (various Linux Distributions, BSD, MacOS, Plan 9)
+- Portability between PCs running POSIX systems (focus: Linux, BSD, MacOS, Plan 9 APE, Windows MinGW)
 
 ### What Dragonblocks Alpha does not aim to achieve
-- Portability to Windows or Phones / Consoles
+- Portability to Phones / Consoles
 - Good performance on low-end PCs
 - A fixed story or lore
 - Cloning Minecraft behavior