aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKarel Kočí <cynerd@email.cz>2016-03-30 23:33:27 +0200
committerKarel Kočí <cynerd@email.cz>2016-03-30 23:41:15 +0200
commit7c635fe498b2c7d158a44ceaa525fe7317adb079 (patch)
treee1e517a6d1f583668973ee6e82d0e2b3199c66ee /README.md
parent51278d4ef4aaa5d7b9e497fd333bd4e61f582fc9 (diff)
downloadmcserver-wrapper-7c635fe498b2c7d158a44ceaa525fe7317adb079.tar.gz
mcserver-wrapper-7c635fe498b2c7d158a44ceaa525fe7317adb079.tar.bz2
mcserver-wrapper-7c635fe498b2c7d158a44ceaa525fe7317adb079.zip
Removing configuration files and more
Such small application doesn't requires configuration files. Originally intended for more expansion, but now those features are developed separately. This is not indented as simple SystemD friendly wrapper simple as possible.
Diffstat (limited to 'README.md')
-rw-r--r--README.md99
1 files changed, 45 insertions, 54 deletions
diff --git a/README.md b/README.md
index a5eeac5..0c8ce72 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
-MINECRAFT-WRAPPER
-=================
+MCSERVER-WRAPPER
+================
[![Build Status](https://travis-ci.org/Cynerd/minecraft-wrapper.svg?branch=master)](https://travis-ci.org/Cynerd/minecraft-wrapper)
-Python server wrapper for extracting informations about server status and list of
-online players.
+Minecraft server wrapper written in Python3 that extracts server status and list
+of online players.
Requires:
-----------------
@@ -10,72 +10,63 @@ Requires:
* Python3
* Dependencies for Minecraft server (Java)
-Usage
------------------
+MCWRAPPER
+---------
+### Usage
```
-mcwrapper [arguments...] IDENTIFIER
- This script is executing Minecraft server and reads its output. From output is
- extracted server status and list of online players.
+mcwrapper [-h] [--verbose] [--quiet] [--status-file] [--players-file]
+ ...
+
+This script is executing Minecraft server and reads its output. From output is
+extracted server status and list of online players. And standard input can be
+accessed by fifo file.
- arguments
- -h, --help
- Prints this help text.
- -v, --verbose
- Increase verbose level of output.
- -q, --quiet
- Decrease verbose level of output.
- --config CONFIG_FILE
- Specify configuration file to be used.
- --configfile
- prints used configuration file and exits.
+positional arguments:
+ command Command to be executed to start Minecraft server.
- IDENTIFIER
- Identifier for new server. This allows multiple servers running with this
- wrapper. Identifier is word without spaces and preferably without special
- characters.
+optional arguments:
+ -h, --help show this help message and exit
+ --verbose, -v Increase verbose level of output
+ --quiet, -q Decrease verbose level of output
+ --status-file, -s Outputs server status to file "status"
+ --players-file, -p Outputs list of online players to file "players"
```
-How it works
------------------
+### How it works
Script is reading Minercraft server standard and error output. It's looking for
-known lines that signals change of server output and players joining and leaving.
+known lines that signals change of server status and players joining and leaving.
Minecraft server output is well designed for information parsing. Informations are
-in exported to directory specified in configuration as `status`.
+exported to directory working directory or websocket server.
+
+#### Input pipe
+This is unix pipe. This file is located in working directory and named as
+`input_pipe`. This pipe is input to Minercraft server standard input. If you have
+write access rights (default 640), then you can send any command to Minecraft
+server by writing to this pipe.
+
+#### Server.pid file
+This file contains PID of Minecraft server process. This is used to detect if
+server is running when status files exists. It has probably no usage for user, but
+shouldn't be tempered with.
-###Status file
-This file is in status directory named as `status`. If it exists, it specifies in
-what status is server in the moment.
+#### Status file
+This file is in working directory and is named as `status`. If it exists, it
+specifies in what status is server in the moment.
Status can be:
+
* Starting
* Running
* Stopping
If file not exists, then server is not running at all.
-###Players file
+#### Players file
This file in in status directory and is named as `players`. If server is running,
it contains online players. Player name per line. If server isn't running, it
content don't have to be valid.
-###Input pipe
-This is unix pipe. This file is located in status directory and named as
-`input_pipe`. This pipe is input to Minercraft server standard input. If you have
-write access rights (default 640), then you can send any command to Minecraft
-server by writing to this pipe.
-
-###Server.pid file
-This file contains PID of Minecraft server process. This is used to detect if
-server is running when status files exists. It has probably no usage for user, but
-shouldn't be tempered with.
-
-Configuration
------------------
-You can use `example.conf` as base configuration. Configuration file is in fact
-Python3 script that is executed and its variables are used as configuration.
-Script is searching for configuration in these files (in order of precedence):
- * mcwrapper.conf
- * mcwrapper.conf
- * ~/.mcwrapper.conf
- * ~/.config/mcwrapper.conf
- * /etc/mcwrapper.conf
-Or you can use `--config` argument to specify any other file with valid content.
+MCWRAPPER-TERMINAL
+------------------
+This application is going to be used for interactive terminal access to minecraft
+server console. It should use latest minecraft server log as input and output will
+be pushed to input pipe of mcwrapper. This app is currently in development.