BF2 Command Control Monitor

=====================
Achtung:

Die Texas Teamplayer bitten darum das File nicht selbst zu hosten, sondern per Link auf das TTP-Forum bzw. die Homepage zu verweisen zu verweisen.
=====================

Als Serveradmin hat man es oft nicht leicht. Tonnenweise Spam im Ingame-Chat und gerade wenn man nicht selbst mitspielt, kostet das Beobachten der Texte viel Zeit. Das dachte sich wohl auch Lemures von den Texas TeamPlayers und schrieb kurzerhand ein Tool für das Tool: den BF2CC Monitor, der einzig und alleine den Chat überwacht. Schreibt dort jemand vordefinierte Stichwörter wie "Cheat", "Hack" oder "Admin", erklingt auf dem Rechner des Admins ein akustischer Hinweis durch das Wort "Warning", das als .wav File mit geliefert wird. Das nette Tool gibt es Inzwischen übrigens auch in einer Version für 2142CC. Den Klang der Warnung haben wir für euch kurz auf Basis eines Besuchs unseres BF2-Servers aufgenommen und die Worte "Glitch" und "Hack" aus dem Standardfilter eingetippt.

Installation und Konfiguration
Das Tool selbst muss ins selbe Verzeichnis wie der BF2CC bzw. BF2142CC Client gelegt werden, wo es einmal ohne BF2CC gestartet wird. Dabei entsteht zwar eine Fehlermeldung und der Debug-Modus wird gestartet, allerdings werden auch eine eine .ini und eine .wav Datei erstellt. Von nun an startet mit einem Klick auf die .exe des Monitors auch das Hauptprogramm. Die per Default eingestellten Alerts sind admin, teamkill, hack, glitch, bei denen die Datei warning.wmv abgespielt wird. Über die Optionen können jedoch sowohl Alert als auch Sounddatei geändert werden. Das Tool bietet zudem die Möglichkeit verschiedene Alerts zu erstellen und diesen Sounds zuzuweisen. Wichtiger sind jedoch die Ausnahmen, über die man bestimmte Standards wie die Auto-Message für Teamkills ausklammert, während die Beschwerde eines Spielers eine Warnung auslöst. Für die genaue Konfiguration wurde ein Readme erstellt.

Deutsches Readme
Die englischsprachige Originalanleitung wurde von C.ZI auf Deutsch übersetzt. Den Originaltext findet ihr im Anhang. BF2CC Monitor (BF2CCM) funktioniert so, dass es den Reiter "Chat" im BF2CC auf Schlüsselwörter überwacht und bei einem Fund einen Alarmton abspielt. Dafür werden benutzerdefinierte Alarmtöne für einzelne oder Gruppen von Wörtern eingerichtet.

1. Wenn Du BF2CCM.exe das erste mal startest, erstellt es eine .ini, eine .gif und eine .wav Datei. Die BF2CCM.exe solltest du ins BF2CC Verzeichnis installieren, um keine unvorhergesehenen Nebenwirkungen hervorzurufen.

2. Starte BF2CCM. Stelle für diese Einführung bitte sicher, dass BF2CC NICHT gestartet ist. BF2CCM wird nun melden, dass das BF2CC Fenster nicht gefunden werden konnte und dass es nun im Debug Modus läuft. Klicke auf OK. In deiner Taskleiste solltest du nun das BF2CCM Tray-Icon sehen. Rechtsklicke darauf. "Help" ("Hilfe"), "About" ("Über") und "Exit" ("Beenden") sollten selbsterklärend sein. Gehe zuerst auf "Options" ("Optionen").

3. "Global Ignores" ("global Ignorierte", Ausnahmen) sind Wörter, die dazu führen, dass das Programm die betreffende Zeile ignoriert. Beispielsweise wird standardmäßig jede Zeile, die "TKPUNISH" enthält, keinen Alarm auslösen. Merk dir bitte, was hier steht, weil es später noch wichtig sein wird.

4. "Refresh Rate" ("Wiederholrate") bestimmt, wie oft, in Sekunden, das Programm den "Chat" Reiter überprüfen wird. Ich empfehle 0.5 Sekunden (= 2mal pro Sekunde überprüfen), weil das eine gute Balance zwischen hoher Systembelastung und schneller Benachrichtigung darstellt. Je höher dieser Wert eingestellt ist, desto länger kann es dauern, bis du über einen Alarm informiert wirst. Je niedriger dieser Wert eingestellt ist, desto mehr Systemressourcen nimmt BF2CCM in Anspruch.

5. Klicke auf OK oder Cancel ("Abbrechen"). Rechtklicke erneut auf das Tray-Icon.
   Beachte, dass alle Einträge über "New Alert" ("neuer Alarm") benutzerdefinierte Alarme darstellen, wobei "Standard Alerts" die standardmäßig vorhandene Alarmgruppe ist. Klicke auf "Standard Alerts". Hier kannst du diesen Alarm konfigurieren.
   Wie du siehst ist dieser Alarm darauf eingestellt, die Datei "BF2CCM_Warning.wav" immer dann abzuspielen, wenn die Stichwörter "admin", "teamkill", "hack" oder "glitch" im Chat fallen. Es sind keine Ausnahmen eingestellt.
   Klicke auf OK oder Cancel. Rechtsklicke das Tray-Icon und gehe auf "New Alert".

6. "Alert Name" ist der Name dieses Alarms. Nennen wir ihn mal "Alamo".

7. "Words" definiert mindestens ein Wort, für das der Alarm ausgelöst wird. Leerzeichen werden ignoriert, sodass "team kill" und "teamkill" das gleiche Wort darstellen. Trenne mehrere Wörter durch Kommas. Nehmen wir mal die Wörter "commander, rücktritt".
   Beachte, dass "commander,rücktritt" (ohne die Leerzeichen) gleich funktionieren würde.

8. Unter "Ignores" stehen die Ausnahmen für unseren Alarm. Nehmen wir hier mal "vergiss" rein. Das bedeutet, wenn irgendjemand schreibt: "commander, wir brauchen arty!" wird BF2CCM diesen Alarm abspielen. Wenn aber jemand schreibt: "commander, vergiss es", wird kein Alarm ausgelöst.
   Beachte, dass die globalen Ausnahmen auch hier gelten, sodass "WARNING! commander" ebenfalls ignoriert wird. Außerdem spielen bei den Ausnahmen auch Leerzeichen eine Rolle, "WARNING!, KICKING!" ist hier also nicht dasselbe wie "WARNING!,KICKING!". Merk dir das bitte, wenn du auf deinem eigenen Server die Ausnahmen definierst.
   Der Alarmtyp kann aus der Liste "Alert type" ausgewählt werden. Für unser Beispiel nehmen wir "MessageBox and Sound". Wähle mit "Browse" ("Durchsuchen") eine Sounddatei aus, oder benutze den Standard. Klicke auf "Play" ("Abspielen") um den ausgewählten Alarmton zu testen.

9. Klicke jetzt auf OK um den Alarm zu speichern. Rechtsklicke wieder auf das Tray-Icon. Dort werden jetzt zwei Alarme angezeigt: "Standard Alerts" und "Alamo" (siehe #6).

10. Lass uns nun unsere Alarme testen. Weil wir im Debug Modus sind (siehe #2) müssen wir [STRG]+[UMSCHALT]+[P] drücken um eine Zeile zu testen. Zuerst den Standardtext. Du wirst merken, dass der Alarmton abgespielt wird, weil der standardmäßige Alarm auf "admin" reagiert. Drücke jetzt [STRG]+[UMSCHALT]+[P] erneut und gib "commander" ein. Drücke OK. Jetzt wirst du von "Alamo" durch einen Alarmton und eine Textmeldung benachrichtigt. Versuche jetzt "admin vergiss es". Du solltest den Ton hören. Versuche danach "commander vergiss es". Nichts sollte passieren, weil wir "vergiss" als Ausnahme für denselben Alarm gesetzt haben, der auf "commander" reagiert, nicht jedoch für den Alarm der auf "admin" reagiert. Rechtsklicke jetzt wieder auf das Tray-Icon. Klicke hier auf "Alamo" um den Alarm zu bearbeiten. Wir wollen ihn löschen. Klicke dazu auf "delete". Wenn du jetzt auf das Tray-Icon rechtsklickst, wirst du feststellen, dass "Alamo" nicht mehr zu sehen ist.
    Drücke jetzt [STRG]+[UMSCHALT]+[E] um BF2CCm zu beenden.

11. Du solltest jetzt ausreichend verstanden haben, wie BF2CCM funktioniert. Wenn du BF2CCM im selben Verzeichnis wie die BF2CC.exe hast wird BF2CCM automatisch auch BF2CC starten, wenn er gestartet wird. Ansonsten, starte BF2CCM erst, wenn BF2CC schon offen ist. Beachte, dass BF2CCM nur funktioniert, wenn das BF2CC Fenster geöffnet und auf den "Chat" Reiter eingestellt ist. Wenn das der Fall ist, kannst du machen was immer du willst, du darfst nur nicht das BF2CC Fenster schließen, minimieren oder auf einen anderen Reiter wechseln. In den Hintergrund schieben darfst du es dagegen schon.

Anmerkung des Übersetzers: Warum das so ist sollt ihr den Autor des Programms zwar nicht fragen, ich sags euch aber trotzdem: BF2CCM sucht sich bei Programmstart über eine WindowsAPI Funktion das sog. HANDLE (="Griff") des Chatfensters im BF2CC. Dann fragt es in regelmäßigen Intervallen (siehe #4) über eine andere WinAPI Funktion den Text ab, der im Chatfenster steht. Wird BF2CC nun minimiert, auf einen anderen Reiter eingestellt oder gar geschlossen, wird das Chatfenster von Windows "zerstört", das HANDLE ist ungültig und sein Inhalt kann nicht mehr von anderen Programmen abgefragt werden.
Wer diese Erklärung verstanden hat, weiß nun wo das Problem liegt, wer ihn nicht verstanden hat, muss es nicht wissen.

Tipps

• Wenn du irgendwie alles furchtbar verbogen hast, genügt es, die .wav und .ini Datei zu löschen und BF2CCM neu zu starten. BF2CCM wird einfach eine neue .wav Datei und eine .ini Datei mit den Standardeinstellungen erstellen .

• Installiere die BF2CCM.exe in dasselbe Verzeichnis wie BF2CC und erstelle eine Verknüpfung zum BF2CCM. Da BF2CCM das BF2CC automatisch startet, solange du es nicht umbenannt hast, brauchst du nur noch eine Verknüpfung auszuführen.

• Du kannst die .ini Datei mit deinen eigenen Alarmen auch mit anderen Serveradmins austauschen. Diese müssen einfach nur ihre .ini Datei mit der von dir überschreiben und schon sind auf allen Servern diesselben Alarme eingestellt.

English Manual

BF2CC Monitor (BF2CCM) works by monitoring the "chat" tab in BF2CC for specific words, and then sounding an alert when one is seen. This is done by setting up user defined alerts for either individual or groups of words.
1. When you run BF2CCM, it will create a .ini file, a .gif file, and a default .wav file to use. I advise keeping the BF2CCM.exe file in your BF2CC folder so as to not clutter anything else up.
2. Run BF2CCM. For this walkthrough, please ensure that BF2CC is NOT open. BF2CC Monitor will report that the BF2CC window was not detected, and that it is entering debug mode. Click OK. In your taskbar, you should see the BF2CCM icon. Right click it. "Help", "About", and "Exit" should be self explanatory. First, go to "Options".
3. Global Ignores are words that make the program ignore the line. For example, by default, anything done by "TKPUNISH" will not sound an alert. Please make note of what is here, as it will be relevant later.
4. Refresh Rate is how often the program will check the "chat" tab in seconds. I suggest 0.5 seconds, as it is a good balance between system resource usage and prompt monitoring.
5. Click OK or Cancel. Right click the taskbar icon again. Note that anything above "New Alert" is a user-defined alert, with "Standard Alerts" being the default. Click "Standard Alerts". Here you can configure this particular alert. Notice that this alert is set up to play the sound "BF2CCM_Warning.wav" whenever "admin", "teamkill", "hack", or "glitch" is said on the "chat" tab. There are no specific ignores for this alert. Click OK or Cancel. Right click the taskbar icon, and go to "New Alert".
6. Alert Name is the name of this particular alert. Let's name it "Alamo".
7. Words is the word or words that this alert will monitor for. Spaces are irrelevant, meaning that "team kill" and "teamkill" are the same thing. Separate the words by commas. Lets set our Words to "commander, retreat". Note that "commander,retreat" (without the space) would also work.
8. Ignores is the specific ignores for this alert. Lets set ours to "disregard". This means that if anybody says "commander we need arty", BF2CCM will sound an alert, but if somebody says "commander disregard that request", no alert will be sounded. Note that the global ignores also apply here, so if somebody said "WARNING! commander", no alert would sound. Spaces ARE relevant in the Ignores field, both here and for Global Ignores. This means that "WARNING!, KICKING!" is different from "WARNING!,KICKING!". Please keep this in mind when setting up your own ignores on your own server. Alert type can be chosen from the drop down list. For our example, we will choose "MessageBox and Sound". Choose a sound with Browse, or use the default. Click "Play" to play the sound you have chosen.
9. Now click OK to save this alert. Right click the icon in the taskbar, and notice that you have two alerts: "Standard Alerts" and "Alamo".
10. Now let's test our alerts out. Because we are in debug mode, we need to press "ctrl-shift-p" to test a line. First, test the default text. You'll notice that the warning sound plays, because our "Standard Alert" is set to monitor for "admin". Now press "ctrl-shift-p" again and type in "commander". Press OK. Notice how you are alerted with a sound and a message box, as per the "Alamo" alert. Now try "admin disregard". You should hear the sound.Now try "commander disregard". Nothing should happen, because we set "disregard" as an ignore for the alert that was monitoring for "commander".Now right click the icon in the taskbar. Click "Alamo". Here you can modify settings for your alert. We are going to delete it. Click delete. Right click the icon in the taskbar again, and notice how "Alamo" is gone. Now press "ctrl-shift-e" to close BF2CCM.
11. You should now have a decent understanding of how to work BF2CC Monitor. If you have BF2CCM in the same folder as BF2CC.exe, BF2CCM will auto-execute BF2CC.exe when run. Otherwise, run BF2CCM while BF2CC is already open. Please note that BF2CCM can only monitor text while BF2CC is both at the "chat" tab and is NOT minimized. This means that as long as BF2CC is open to the "chat" tab, you can do anything else you want. Step away from the computer, surf the Internet, or even play Battlefield 2, and BF2CCM will still work. This is important, please do not ask me why BF2CCM is not working if you have BF2CC minimized or opened to the wrong tab!