Utility: PyEye1.33 dom-III client. Now 3.20 compliant.

[WraithLord]

This is a GUI client that tells you the status of TCP games. Like which nations have already played turns, which are AI controlled, how much time left for host etc.

Check the screenshot to get an idea what's it about.

The zip contains two dirs
If you're using windows you need to copy the PyEyeGui_Windows to wherever you like.
Then run the exe in bin directory, the one named py_eye_gui.exe.

Linux/Unix/MAC need to install python and tkinter (python GUI infrastructure) and run the PyEyeSource\py_eye_gui.py file.

To configure the client go to settings and enter game path (where dom is installed), flags if you want, path to backup turn files (optional) and whether or not you want to autosave your turns.
Then you go to games to Add/Remove/Edit a game. Its should be straightforward to configure.

Now that you've got it all configured you can either:
1. Query for turn status.
2. Play your turn, the client will fire up dominions (and connect it to server), you'll play your turn. When you quit the client will save your turn (if you configured it to do so).

Ver 1.3.3
Support for new nations

Ver 1.3.2
Fixed bugs:
-> Fix a tiny bug of unexpected exception when server was down
-> Nation number 95 instead of 80 (Thanks Ich) so turn status will work well for 3.14

Added:
-> Bogarus, (Indie flag for now)

Ver 1.3.1,
This is hopefully the last version.
Fixed bugs:
-> Auto save settings is now saved between sessions

Added:
-> Source code distribution under GPL license (so that free source programmers could use it).
The source code is in the attached file in directory PyEyeSource. Linux/Unix/MAC users should just copy this directory to a desired location, make sure they have python > 2.5 on their system and run python py_eye_gui.py.


ver 1.3, This is a major version with better quality (lots of bugs got scrubbed and new functionality)

Fixed bugs:
-> Lots of bugs that had to do with error conditions, server down, wrong configuration etc got fixed.

Added:
-> Auto save (setting->Auto save on/off) after playing turn
-> All games report screen.


ver 1.2
Fixed bugs:
-> Saving or launching game disabled querying server

Added:
-> Menu for saving games. First set directory to save to under settings.

ver 1.1
Added:
-> Settings menu
-> Play turn menu


Ver 1.02
Fixed bugs:
-> Some conditions led to wrong AI tooltip
-> midgard icon fix
-> turn # and time to host got mixed

Added:
-> help->usage

Yeah, I've noticed by now there are a couple of those available which is a good thing. However, I wanted a to have a cross platform client and besides it was a loose end I wanted to tie after writing the CLI right when dom-III came out ( PyEye CLI ). The name pyEye is a homage of sorts to dom-II god's eye client

Anyway, work on the client is coming along nicely and I expect to have it ready by the end of this week. Attached is a screenshot, of course comments at this early stage of its development are welcome as they'll allow me to adjust rapidly.

The client is written in python and I intend to test it under windows, Linux and cygwin. It should work for Mac as well but I can't test it since I don't have access to one.
I will release an exe for windows and the source code with an install routine for the ??NIX systems.

It supports all the nations up to 3.10 and modded nations can be added easily via a configuration file.

I want to thank zepath for allowing me to use his beautiful nation icons.

updates will follow.

[WraithLord]

Windows exe is ready. Actually that are two of those, a normal one and a debug version one (for those volunteers that would like to help me troubleshoot issues).

The exe is attached to the first post. To install do the following:
1. Extract the attachment
2. Copy PyEyeGui_Windows to Program Files or where ever you want it to be (for the debug version copy PyEyeGui_Windows_Debug).
3. Run bin/py_eye_gui.exe, I've found creating a shortcut and putting it on the desktop to be convenient.

Usage:
Games menu allows to add/remove/edit games.
Query menu allows to query status of game servers

[WraithLord]

Fixed a few small bugs and added a screenshot.

[WraithLord]

I found it tedious to maintain desktop shortcuts for launching games so I've added a "Play game" to version 1.1.

Use settings to configure path to dom-III exe on your system and whatever flags you'd like for it to use. Then use "Play turn"->your game to connect to your game server.

Next I think I'll implement a save functionality and then pick up on the Linux/MAC distribution thing (I haven't had much success so far with python packaging API)

[WraithLord]

New version 1.2 adds the capability to save the turn files. For that you need to configure settings->set turns backup path
and then before/after playing your turn hit the save turn->your game and the turn will be saved.

I assume that some ppl did indeed download the thing. I wonder what comments if at all they may have (hopefully it didn't format their hard drives). In any case comments and or request for additional functionality are welcomed.

I will upload ver 1.2 once I've had some chance to run it through BATS.

[WraithLord]

FYI
Just found out that the 1.1 functionality of launching a game has a bug that don't allow to query the server status after launching a game. It is fixed in ver. 1.2 that I will upload tomorrow after completing testing it (and also has the save turn functionality).

[WraithLord]

I was entraining some thoughts about adding functionality to pull/send turns from mail accounts (GMAIL, pop3/IMAP) but OtOH I'm quite anxious to start on the combat SIM, so unless I hear requests for additional features I will stop at that point.

[Jurri]

This is a really sweet little program. I'm only in one server game, yet I still use it since it's much faster probing the server than the game itself is! Definitely recommended for folks who play a lot of server-games. Even if the server has email-notification: removing the need for separate shortcuts is quite convenient.

The package has a number of pre-configured games by the way. (Thanks for saving me the trouble on configuring Invisible Swarm2 ) They are easy enough to remove of course, but you might want to remove them for aesthetic reasons.

[WraithLord]

Thanks for the feedback Jurri. Good note about the pre-configured games, I will remove them on the next release.

I'm glad you're using the invisible swarm configuration, hopefully my hidden trojan will perform well in sending me reports on your turns, they will be well used by the inquisition

Seriously now, is there any additional feature you'd like to see in this program?

[Jurri]

I can't really think of anything: this does what it's designed to do perfectly. The only thing missing is the program actually playing my turn for me.

Well, if you want to bloat it here's some ideas: for someone who had more than one server game ongoing, maybe a function for checking all of them with a single click would be useful? Then perhaps a summary page that shows which games need his turn and how much time there's left. (You'd need to add the nation played in the configuration for this.)

The save-turn function doesn't seem to work, now that I try it... It doesn't seem to actually copy the turn files at least to the specified directory. A feature that might be nice for it would be autosave, so that you didn't need to manually save each turn if you should want to back them all up.

Also: knowing of the threat in Invisible Swarm is quite removed from actually avoiding it! So spy all you want, it won't save your bacon