TonkManager

This project is abandoned.

Whether this project is out of date or its author marked it as abandoned, this project is no longer maintained.

If you wish to take this project over, please report it and state your intentions.

TonkManager main frame v0.5

TonkManager (by lonestar).

Description:
-----------------
This plugin manages event times of the Dalanis events (Tonk, Fendus, ...) and
the Southern/Northern Janost Forest Events (Misty Grove, Ruins of Bymorsh, Sley Farm).
When you take part at an event it will automatically calculate the next time,
the event will happen. Additionally the user can specify the event times manually.
Bugged events can be specified too. This has to be possible, since the events fail usually
one after another during the days after a server restart. When an event fails it won't
recover until the server is restarted.

The addon supports multiple timezones on one server. To activate this,
specify the timezone in which you want to broadcast using the dropdown in the main window.

Additionally the synchronization using a hidden chat channel is supported. Every few minutes
your addon will publish your times to the channel and all other players who use this addon
automatically load your times if they are more detailed than their own.
To avoid chat flooding your own broadcast will only be done if the last broadcast was less
detailed than yours (ie.: if you took part at an event, that the broadcaster has not up-to-date
times yet.)
This way usually only one message every few minutes will be sent overall.
Warning: when you log on it may take about 5 minutes until you get the correct times.

The addon has a small window, that displays the next 3 events and the time until those occur.
Double-clicking this window will send the next event info to the group chat.

Output format of broadcast:
----------------
As there have been quite some questions regarding this one:
It currently looks like that:
Tonk: 12:33. / - / ?
This means:
T1 = 12:33
T2 = bugged
T3 = unknown by broadcaster (empty input field and bugged not checked)

The "." means, that this is a recorded time, that has been calculated by TonkManager and
not by direct input from the user.

The format of this message is not configurable, as it needs to be common for all
TonkManager instances, so that they can load the correct times from the output
of one instance.
Example:
Player A broadcasts to group channel.
Player B, who is in the same group automatically has those times stored in his TonkManager

The "Tonk: " prefix of the line is needed, so that the addon knows, that this message is sent by
the TonkManager addon.

Overall the output is trimmed for parseability and brevity.

Description of the events:
----------------
TonkManager supports the following events:

Tonk:
    other names: Tonk, Carf
    Location: Thunderhoof 45/58
    Repeated every: 120 minutes
Fendus:
    other names: Sternhorn, Stern
    Location: Thunderhoof 57/61
    Repeated every: 150 minutes
Kanal:
    other names: Kanal, Bugs
    Location: Thunderhoof 59/48
    Repeated every: 100 minutes
Misty Grove:
    other names: Nebelhain, Haim, Nebel
    Location: Southern Janost Forest 40/67
    Repeated every: 60 minutes
Ruins of Bymorsh:
    other names: Ruinen von Bymorsh, Bym, Ruine
    Location: Southern Janost Forest 70/54
    Repeated every: 60 minutes
Sley Farm:
    other names: Weeds
    Location: Nothern Janost Forest 58/69
    Repeated every: 60 minutes
Yasheedee:
    other names: ?
    Location: Limo Desert 35/25
    Repeated every: 40 minutes

Communication with other Addons:
----------------
The file TonkManagerAPI.lua provides some functions for other addons.
Currently the following functions are available:
- TonkManagerAPIGetInfo: get info about a specified event
- TonkManagerAPIGetNextEvents: get an ordered list of events

for further documentation please consult TonkManagerAPI.lua

Installation:
----------------
UnZip the TonkManager.zip file to your Runes of Magic AddOns directory and re-login to the game.  
When you UnZip it you should end up with a folder similar to this:
C:\Program Files\Runes of Magic\Interface\AddOns\TonkManager

Todo:
----------
- currently this addon is limited to exactly 4 channels. Maybe on some servers there can be more?
- eliminate popup on auto sync when Interface->Messages->Private channel is activated

Usage:
----------
When you are in the game, simply type "/tm" or "/tonkmanager" in a chat window (or set up a macro
button to type this for you).  
/tmguild, /tmzone, /tmgroup: broadcast times to chat
/tmchannel <channel number> = broadcast to channel

Thanks:
----------
My special thanks go to the authors of the following plugins:
Notepad, ComeOnIn, Groupinvite, scrutinizer ...
    
I copied quite some code from them and therefore was able to quickly develop this addon.

I copied the monospace font "LiberationMono-Bold.ttf" from
http://www.fontspace.com/category/monospaced
it is a free font with a GPL copyright

Contributors:
The Southern Janost event support has been done with help from "Biermeile" on the server Aontacht
The Auto ETA Reply feature was implemented by jrmstuff@curse.
4th channel coding and alternate event labels implemented by "Sindar" on Govinda server

Changes:
--------------
v3.0:
- support for "Yasheedee" event in "Limo Desert"
v2.5:
- added API to communicate with other addons (requested by the author of groupinvite)
v2.4.2:
- fixed the update detection
- suppressing chat popup window now, even when Interface settings allow a chat popup
v2.4.1:
- disabled some triggers for the events Tonk, Fendus, Sewers, so that events that become bugged won't
  be listed as starting in 100/120/150 minutes again. I will for now not disable compatibility to the
  older 2.4 versions, so that by synchronization the bug may still appear from clients that use 2.4.
v2.4:
- added /tmgroupnext and /tmguildnext macro commands
- added spam filter to "eta" command: every player may only ask this once every minute. Otherwise the command will be ignored
- changed the mini-event window font to a monospace font.
- to avoid problems with the older TM versions, that know nothing about the 4th channel,
  this version will be incompatible with the old sync messages once more.
mods added by SindarAkuma
- Added support for 4 channel servers, still reads sync data from 3 channel version
- Changed event labels to the names commonly used on north american servers
- Added a checkbox to be able to use the original event labels
- Added sound warnings at 15 min prior to start moving towards event location, and 10 min prior to warn of impending event roll call
- Improved look of the tabs
- Added some alternate trigger texts to improve event end time capture
As result of these changes some events will be renamed from "Kanal" to "Sewers" and from "Fendus" to "Baron".

-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------

TonkManager (by lonestar).

Beschreibung:
-----------------
Dieses Plugin verwaltet die Zeiten der Dalanis Events (Tonk, Fendus, ...) und
die Events im Südlichen/Nördlichen Janostwald.
Die Folgezeiten von Events, an denen man teilnimmt werden automatisch berechnet.
Zusätzlich kann der Spieler die Eventzeiten aber auch manuell angeben.
Man kann auch bei Events angeben, dass sie momentan nicht funktionieren.
Dies ist vor allem deswegen notwendig weil momentan nur kurz nach einem
Server-Neustart alle Events funktionieren. Im Laufe der Tage fallen sie dann der
Reihe nach aus.

Das Addon unterstützt nun auch Spieler von unterschiedlichen Zeitzonen auf einem
Server. Dies wird z.B. von Spielern in Amerika benötigt. Man gibt die
Zeitzone an, in der im Chat die Ausgabe gesendet werden soll.

Außerdem wird die Synchronisation der Zeiten über einen versteckten Chat Kanal unterstützt.
Alle paar Minuten werden die eigenen Zeiten in den versteckten Kanal ausgegeben und alle
anderen Spieler laden die Zeiten jeweils wieder, wenn sie detaillierter sind als die eigenen.
Damit der Chat Kanal nicht durch zu viele Zeiten belastet wird, werden die eigenen Zeiten nur
dann gesendet, wenn sie detaillierter sind als die letzte Ausgabe.
In Summe sollte also in Summe nur alle paar Minuten eine Ausgabe im Chat Kanal erfolgen.
Warnung: Nach dem Login kann es ein paar Minuten (~5) dauern, bis man Zeiten bekommt.

Das Addon hat auch ein kleines Fenster, das die nächsten 3 events anzeigt.
Wenn man dieses doppelt anklickt, wird das nächste Event im Gruppenchat ausgegeben.

Ausgabeformat:
----------------
Da es ein paar Anfragen gegeben hat, bezüglich des Ausgabeformats:
Momentan sieht dies so aus:
Tonk: 12:33. / - / ?
Das heisst:
T1 = 12:33
T2 = fehlerhaft ("bugged")
T3 = unbekannt (leeres Eingabefeld und nicht als fehlerhaft markiert)

Der "." bedeutet, daß diese Zeit eine automatisch berechnete Zeit ist. (Im Gegensatz zu Zeiten,
die vom Benutzer eingegeben wurden)

Das Format der Ausgabe ist nicht konfigurierbar, da es für alle onkManager Instanzen gleich sein
muss, damit das Laden der zeiten aus dem Chat funktionieren kann.

Beispiel:
Spieler A sendet seine Zeiten in den Gruppenchat.
Spieler B, der in derselben Gruppe ist: die Zeiten werden automatisch in seinem TonkManager gespeichert

Das "Tonk: " am Anfang der Zeile wird benötigt, damit das TonkManager addon erkennt, dass diese
Chat Nachricht von einem anderen TonkManager addon kommt.

In Summe ist die Ausgabe also auf Kürze und Maschinenlesbarkeit aufgebaut

Beschreibung der Events:
----------------
TonkManager unterstützt die folgenden Events:

Tonk:
    andere Namen: Carf
    Ort: Donnerhuf 45/58
    Wiederholung alle: 120 Minuten
Fendus:
    andere Namen: Sternhorn, Stern
    Ort: Donnerhuf 57/61
    Wiederholung alle: 100 Minuten
Kanal:
    andere Namen: Kanal, Bugs
    Ort: Donnerhuf 59/48
    Wiederholung alle: 100 Minuten
Misty Grove:
    andere Namen: Nebelhain, Haim, Nebel
    Ort: Südlicher Janostwald 40/67
    Wiederholung alle: 60 Minuten
Ruins of Bymorsh:
    andere Namen: Ruinen von Bymorsh, Bym, Ruine
    Ort: Südlicher Janostwald 70/54
    Wiederholung alle: 60 Minuten
Farmen von Sley:
    andere Namen: Weeds, Farm
    Ort: Nothern Janost Forest 58/69
    Wiederholung alle: 60 Minuten
Yasheedee:
    andere Namen: ?
    Ort: Wüste Limo 35/25
    Wiederholung alle: 40 Minuten
    
    
Kommunikation mit anderen Addons:
----------------
Für die Kommunikation mit anderen Addons stehen in der Datei TonkManagerAPI.lua
zwei Funktionen bereit um die Eventdaten auszulesen:
- TonkManagerAPIGetInfo: liest Info über ein einzelnes Event aus
- TonkManagerAPIGetNextEvents: liefert eine geordnete Liste der nächsten Events

weitere Beschreibung siehe in der Datei TonkManagerAPI.lua

Installation:
----------------
Die Datei TonkManager.zip muss in das Runes of Magic AddOns Verzeichnis entpackt werden. Danach
muss ein neuer Login durchgeführt werden.
Der Ordner sollte als so aussehen:
C:\Program Files\Runes of Magic\Interface\AddOns\TonkManager

In Planung:
----------
- Momentan werden nur genau 4 Kanäle unterstützt
- option um die Zeitzone im 12 Stunden Format anzuzeigen?

Nicht geplante Features:
----------
- Sprachübersetzung: Auch wenn das Addon auf allen Sprachen funktioniert, bleiben die Texte englisch.
  Mir gefällt hier einfach die API für Übersetzungen nicht.

Verwendung:
----------
Mittels /tm kann das hauptfenster aufgerufen werden.
/tmguild, /tmgroup, /tmzone schreibt die Zeiten in die jeweiligen chats
/tmchannel <kanalnummer> = schreibt die Zeiten in den angegeben Kanal (man muss bereits beigetreten sein)

Danksagung:
----------
Danke an die Entwickler folgender addons:
Notepad, ComeOnIn, Groupinvite, scrutinizer ...

Ich habe von Ihnen einiges an Code übernommen und das hat bei der Entwicklung sehr geholfen.

Mitwirkende:
Die Unterstützung der Events des südlichen Janostwaldes wurde mit Hilfe von "Biermeile" auf dem Server Aontacht realisiert.

You must login to post a comment. Don't have an account? Register to get one!

  • 3 comments
  • Avatar of Surtalogj Surtalogj Aug 06, 2010 at 16:43 UTC - 0 likes

    Hiho thx für das nette addon

    da es inzwsichen auch im südlichen Janoswald 3 Events gibt Ruine,Räuber & Nebel wäre meine frage ob sich das i-wie mit einbauen liese in den bestehenden Tonkmanager Dank vorab

  • Avatar of lonestaricl lonestaricl Jul 23, 2010 at 20:22 UTC - 0 likes

    das wäre natürlich schon möglich. Mal sehen obs mich mal freut...

  • Avatar of romlongknife romlongknife Jul 23, 2010 at 08:26 UTC - 0 likes

    1A Job Lonestar ! Kannst Du das Minifenster evtl Flexibler machen ? So das auch 6 Events Platz hätten ;) ? Wenn nicht, ists nicht schlimm - aber geiler wärs schon :)

  • 3 comments

Facts

Date created
Jun 24, 2010
Categories
Last update
Dec 04, 2010
Development stage
Abandoned
License
Public Domain
Downloads
62,274
Recent files

Authors