DS Workbench
DS Workbench is a planning tool for the browser game "Tribal Wars" (http://www.die-staemme.de/).
It is implemented as desktop application and written mostly in Java. Formerly, this project and
its releases were hosted at http://www.dsworkbench.de but as of December 24, 2015 this domain
won't be associated with DS Workbench any longer.
Instead, this code was made available as open source under the Apache License, Version 2.0 and
everybody who is willing to continue this work is allowed to contribute. However, there are some
things to be aware of:
- Some PHP-based services, e.g. the luck bar or troop table generator for reports, are still hosted
by myself at http://www.torridity.de. If you need access to their source
code please contact me.
- NEVER integrate any additional interaction with the game itself, e.g no login or reading/sending
data directly from/to the game.
- NEVER change or remove the 'Klick-Konto'/'Click-Account' feature from the tool.
- Please do not republish the tool with another name. If you anyhow do, please refer to the original
tool 'DS Workbench'.
All official releases you can find here.
How to install
- Install the latest OpenJDK (JRE versions will be enough for running DSWorkbench) for your platform from https://adoptopenjdk.net/ and follow the installation instructions (you may also use the official releases but setup might need much more effort and expertise)
- Download the current release, e.g. DSWorkbench-3.72.zip and extract the file into a new folder, preferably into your user directory, not containing blanks, e.g. DSWorkbench
Linux/MacOS
- Open a terminal window and change to the folder where you extracted DS Workbench, by calling e.g.
cd ~/DSWorkbench
- Make the launch script executable by calling
chmod +x DSWorkbench
- Run DSWorkbench from the current folder by calling
./DSWorkbench
Windows
- Open the file explorer and change into the folder where you extracted DS Workbench
- Press and hold the 'Alt' key and drag the file 'DSWorkbench.bat' to your Desktop, which will create a shortcut (don't forget pressing 'Alt', otherwise the file is moved to the Desktop and DSWorkbench won't run)
- Launch DSWorkbench by double-clicking the shortcut on your Desktop
How to build
In order to build DS Workbench you'll need:
- OpenJDK 9 or newer
- Apache Maven 3
After obtaining the sources change to the folder where the sources are located and just call:
user@localhost:/home/user/DSWorkbench$ mvn install assembly:assembly
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] DSWorkbench
[INFO] Core
[INFO] ParserPlugin
[...]
user@localhost:/home/user/DSWorkbench$
Afterwards, you'll find DS Workbench in the sub-folder release/DSWorkbench-<VERSION>
with a
<VERSION>
defined in the pom.xml. The release contains all libraries, config files and start
scripts for Unix and Windows. The Unix script has to be made executable before using it by calling:
user@localhost:/home/user/DSWorkbench$ chmod +x release/DSWorkbench-<VERSION>/bin/DSWorkbench
user@localhost:/home/user/DSWorkbench$
More Information
License
DS Workbench is licensed under the Apache License, Version 2.0.