From 360e305849d3e1a24a13cda380b2fc91a75010ca Mon Sep 17 00:00:00 2001 From: Perttu Ahola Date: Fri, 21 Jan 2011 11:11:00 +0200 Subject: Documentation updates. --- doc/README.txt | 65 +++++++++++++++++++++++++--------------------------------- 1 file changed, 28 insertions(+), 37 deletions(-) (limited to 'doc/README.txt') diff --git a/doc/README.txt b/doc/README.txt index 5a8ce7203..04a996e22 100644 --- a/doc/README.txt +++ b/doc/README.txt @@ -1,25 +1,25 @@ Minetest-c55 --------------- - -Copyright (c) 2010 Perttu Ahola - An InfiniMiner/Minecraft inspired game. - -NOTE: This file is somewhat outdated most of the time. +Copyright (c) 2010 Perttu Ahola This is a development version: +------------------------------ - Don't expect it to work as well as a finished game will. - Please report any bugs to me. That way I can fix them to the next release. - debug.txt is useful when the game crashes. Public servers: +--------------- kray.dy.fi :30000 (friend's server) celeron.55.lt :30000 (my own server) Controls: +--------- - See the in-game pause menu Map directory: +-------------- - Map is stored in a directory, which can be removed to generate a new map. - There is na command-line option for it: --map-dir - As default, it is located in: @@ -30,6 +30,7 @@ Map directory: OS X: ~/Library/Application Support/map Configuration file: +------------------- - An optional configuration file can be used. See minetest.conf.example. - Path to file can be passed as a parameter to the executable: --config @@ -43,48 +44,38 @@ Configuration file: OS X: ~/Library/Application Support/minetest.conf Command-line options: +--------------------- - Use --help Compiling on GNU/Linux: +----------------------- -- You need: - * CMake - * Irrlicht - * Zlib -- You can probably find these in your distro's package repository. -- Building has been tested to work flawlessly on many systems. - -- Check possible options: - $ cd whatever/minetest - $ cmake . -LH - -- A system-wide install: - $ cd whatever/minetest - $ cmake . -DCMAKE_INSTALL_PREFIX=/usr/local - $ make -j2 - $ sudo make install - - $ minetest +Install dependencies. Here's an example for Debian/Ubuntu: +$ apt-get install libirrlicht-dev cmake libbz2-dev libpng12-dev libjpeg8-dev libxxf86vm-dev -- Install to home directory: - $ cd whatever/minetest - $ cmake . -DCMAKE_INSTALL_PREFIX=~/minetest_install - $ make -j2 - $ make install +Download source, extract (this is the URL to the latest of source repository, which might not work at all times): +$ wget https://bitbucket.org/celeron55/minetest/get/tip.tar.gz +$ tar xf tip.tar.gz +$ cd minetest - $ ~/minetest_install/bin/minetest +Build a version that runs directly from the source directory: +$ cmake . -DRUN_IN_PLACE=1 +$ make -j2 -- For running in the source directory: - $ cd whatever/minetest - $ cmake . -DRUN_IN_PLACE - $ make -j2 +Run it: +$ cd bin +$ ./minetest - $ ./bin/minetest +- Use cmake . -LH to see all CMake options and their current state +- If you want to install it system-wide (or are making a distribution package), you will want to use -DRUN_IN_PLACE=0 +- You can build a bare server or a bare client by specifying -DBUILD_CLIENT=0 or -DBUILD_SERVER=0 +- You can select between Release and Debug build by -DCMAKE_BUILD_TYPE= + - Note that the Debug build is considerably slower Compiling on Windows: - NOTE: Seems that the CMake build system produces executables that don't work for many people. The old build system is still included, but it's not - documented in here. + documented anywhere. - You need CMake, Irrlicht, Zlib and Visual Studio or MinGW - NOTE: Probably it will not work easily and you will need to fix some stuff. - Steps: @@ -94,8 +85,8 @@ Compiling on Windows: - Set up some options and paths - Hit "Configure" - Hit "Generate" - - VC: Open the generated .sln and build it - - MinGW: Browse to the build directory and run 'make' + - MSVC: Open the generated .sln and build it + MinGW: Browse to the build directory and run 'make' License of Minetest-c55 ----------------------- -- cgit v1.2.3