]> code.bitgloo.com Git - clyne/gamedev.git/commitdiff
Update README.md
authortcsullivan <tullivan99@gmail.com>
Sat, 4 Mar 2017 20:29:38 +0000 (15:29 -0500)
committerGitHub <noreply@github.com>
Sat, 4 Mar 2017 20:29:38 +0000 (15:29 -0500)
README.md

index 84d98c421041f359a6eac1a7be5fc5098af2c868..fa6350ae83266573c8442498ec55d5abff9e88db 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,26 +4,43 @@ gamedev
 gamedev is a high school project between drumsetmonkey and tcsullivan written in C++ and using SDL2/OpenGL. The goal of this project is to have a completed commercial-grade video game available to Linux and Windows users. We plan on profiting off of the game once we finish it, so once the game reaches its final stages it may become closed source (however, what was uploaded will stay for others to use as a resource).
 
 NOTE!!!!
-We're going through a major rewrite right now, so a lot of stuff probably won't work. Building should still be managable though.
+We're always working on this project. Some commits may contain broken code, or some bugs may be undocumented. Try older commits if the latest one doesn't work.
 
 Build Requirements
 ------------------
 
-The 'gamedev' project can be build on both Linux-based and Windows operating systems. The game has been verified to work on Debian, Arch Linux, 
-Fedora, FreeBSD, and Windows 7, 8 and 10. The following libraries are required to build 'gamedev':
+The 'gamedev' project can be build on both Linux-based and Windows operating systems. The game has been verified to work on Debian, Arch Linux, Fedora, FreeBSD, and Windows 7 (maybe 8 and 10, too). The following libraries are required to build 'gamedev':
 
 * SDL2, including SDL2_image and SDL2_mixer
 * FreeType (2? libfreetype6? who knows...)
 * GLEW
-* entityX (alecthomas/entityx on github)
 
-You will also need the GNU GCC compiler collection, the Makefile uses g++.
+Windows builds were done with MinGW. The compiler must support at least C++14.
 
-Building
---------
+The Makefile makes calls to g++, echo and rm.
+
+Build Preparation
+-----------------
+
+The Makefile expects a file named setup.mk to exist. It needs to define two variables on two lines:
+```
+TARGET_OS = # either win32 or linux
+TARGET_BITS = # either 32 or 64
+```
 
-To build 'gamedev', first create a directory named 'out' and then run make:
+A settings file must also exist. To take the sample one:
+```
+(from the root directory)
+cp config/settings.xml.example config/settings.xml
+```
 
+Finally, create an output directory (used for compiling):
+```
+mkdir out
+```
+
+Building
+--------
 ```
 make
 ```
@@ -31,15 +48,13 @@ make
 This command may be multithreaded using the -j argument.
 
 To run on Linux, once built:
-
 ```
 ./main
 ```
 
 To run on Windows:
-
 ```
-win32/main.exe
+main.exe
 ```
 
 The executable may take the following arguments:
@@ -58,13 +73,15 @@ The following are the controls for the game. Any extra controls can be found in
 Controls can kinda be adjusted using the in-game control menu.
 
 Movement:
-* 'a' and 'd' move the player left and right respectively
+* 'a' and 'd' move the player left and right
 * 'w' enters buildings
+* 'e' opens the inventory
 * 'space' make the player jump if he obtains the jumping skill
-* 'L-Shift' increase the players speed to a "sprint" if he obtains the running skill
-* 'L-Ctrl' decrease the players speed to a "walk"
+* 'L-Shift' sprints if the player obtains the running skill
+* 'L-Ctrl' decreases the player's speed
 * 'h' opens a quest menu
 
 Other:
 * 'f3' for debug information
-* 'f12' for screenshot (currently segfaults, fixing)
+* 'f12' for screenshot
+* 't' speeds up time (ticks)