diff --git a/README.md b/README.md index 1ac393e..77ca112 100755 --- a/README.md +++ b/README.md @@ -1,6 +1,9 @@
+
+
+
@@ -17,17 +20,67 @@
In seekers, AIs compete against each other with the aim of scoring as many points as possible. This project is competition-oriented for students.
-## Setup
+## Getting started
-| Folder | Purpose |
-|:---------:|---------------------------------------|
-| `dist` | Distribution binaries for the clients |
-| `players` | Bot files from the players |
-| `plugins` | Loading plugin jar files |
-| `results` | Save tournament results |
+Please note that at least java 11 is required.
+
+### Installation
+
+Get a jar file from the release or build it on your own.
+
+#### From release
+
+There is currently no official release available, however you can check out [Jitpack](https://jitpack.io/#seekers-dev/seekers-server)
+for snapshot builds.
+
+#### Build it on your own
+
+First get this repo locally. You can download the zip file or fork and clone it. You can build the jar with the following command:
+
+```shell
+bash mvnw install
+```
+
+That's it! You can find the jar file in the `target` folder. Please note that for execution you will need the file with
+the uber classifier.
+
+### Run it
+
+You can run the jar file with the following command:
+
+```shell
+java -jar seekers-server-*.*.*.jar
+```
+
+If you start the server for the first time, the following file and folders will be created:
+
+| Folder | Purpose |
+|:------------:|---------------------------------------|
+| `config.ini` | Config file for changing the settings |
+| `players` | Bot files from the players |
+| `plugins` | Loading plugin jar files |
+| `results` | Save tournament results |
+
+Before the server starts, the app checks first if all listed paths exist. If a path does not exist, it will be created.
+Then it will launch all plugins.
+
+## Config
+
+In the `config.ini`, you can set properties for the game and your plugins. Note that all plugins have their own section.
+For example, the section of the python plugin is `[python-plugin]`. The name of the section is equivalent to the id of
+the plugin. Please note that the config file of the seekers-py repo and this config file are interchangeable. If you
+have already altered your config file for python, you can simply reuse it for the server.
+
+## Players
+
+## Plugins
+
+## Results
## Structure
+This is the class diagram of important types in this program:
+
```mermaid
classDiagram
Entity: update()
diff --git a/pom.xml b/pom.xml
index cbb3bca..c24a3b7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,6 +7,7 @@