SBSRV Installation 
Index
- Einleitung
- Installation auf deinen Server
- Befehle
- sb_info
- sb_login
- sb_licenselock
- sb_licenseid
- sb_licensecode
- Variablen
- sb_server
- sb_action
- sb_advert
- sb_amxbansurl
- sb_customurl
- sb_customkick
- sb_status
- Firewall Einstellungen
- Beispiele
- Server Port
- Änderungen (In Englisch)
Das SteamBans Plugin ist unsere verbesserte Variante für den RCON Scanner.
Unser Plugin erlaubt jetzt ein flexibleres Prüfen von Cheatern und spart dabei, im Vergleich zu dem RCON Scanner, sehr viel CPU Auslastung.
Jetzt ist es möglich die Vorgehensweise gegen Cheater , mit Hilfe von sb_actionselbst zu bestimmen und in Verbindung mit sb_amxbansurl deine eigene
Ban Datenbank abzufragen.
Neuerungen dieses Plugins sind unter anderem:
- Ein sb_advert update, dieser Befehl erlaubt nun mehr Einstellungen.
- Ein sb_status update, dies erlaubt den SteamBans Admins besser Hilfe zu geben.
Wenn du das Archiv entpackst hast du entweder eine .dll oder eine .so Datei, dies hängt davon ab welches Betriebssystem du nutzt.
Die sbsrv_mm_i386.so ist für Linux, und die sbsrv.dll ist für Windows.
Die Installationsanleitung ist für beide Systeme gedacht.
- Also erstes musst du sicher stellen das du metamod richtig installiert hast.
Du kannst mit Hilfe des Rcon Befehls "metamod_version" überprüfen, welche Version du benutzt.
Damit das Plugin einwandfrei funktioniert, stelle sicher, das du die neuste Version benutzt.
- Wenn du metamod richtig installiert hast, wechsel in das addons Verzeichnis und erstelle dort ein neues Verzeichnis "sbsrv". In dieses Verzeichnis solltest du das Plugin entpacken.
- Jetzt müssen wir das Plugin aktivieren, wechsel dazu in das Metamod Verzeichnis.
In diesem Verzeichnis erstelle (oder editiere) die plugins.ini, und füge folgende Zeile (deinem Betriebssystem entsprechend) hinzu:
win32 addons/sbsrv/sbsrv.dll
linux addons/sbsrv/sbsrv_mm_i386.so
- Wenn alles richtig ist solltest du die folgende Verzeichnisstruktur haben:
GAME \ addons \ metamod \ dlls \ metamod.dll
\ plugins.ini
\ sbsrv \ sbsrv.dll ( Für Windows )
\ sbsrv \ sbsrv_mm_i386.so ( Für Linux )
- Starte oder restarte nun deinen Spieleserver und überprüfe, ob Metamod und das Plugin arbeiten. Dies kannst du tun mit Hilfe des Rcon Befehls "meta list".
Sobald dein Spieleserver vollständig geladen hat, benutze den Rcon Befehl: sb_login
Jetzt solltest du folgende Nachricht sehen:
[SBSRV] Performing a debugged SteamBans Login. (not threaded)
[SBSRV] [001] Will not login, missing or incorrectly written licensedetails.
[SBSRV] [003] Missing: sb_licensecode.
Diese Nachricht teilt uns mit, das der Lizenz Code noch nicht eingeben wurde.
- Um die Lizenz Information zu bekommen, musst du dich auf der Webseite einloggen, und in deinem Menu rechts auf "Manage Server" klicken".
Du musst Team Admin sein, um den Lizenz Code einsehen zu können. Solltest du ihn nicht sehen können, kontaktiere deinen Team Admin.
Wenn du "Details" bei SB Accesscodes klickst, öffnet sich ein neues Fenster mit den Zugangs Codes.
sb_licenseid 123 (Beispiel Codes)
sb_licensecode abcdefghijklmnop123456789
sb_action ar
Füge die Informationen in deine server.cfg und gib über Rcon "exec server.cfg" auf deinem Server ein.
Nun versuche erneut sb_login und du wirst folgende Nachricht erhalten:
[SBSRV] Performing a debugged SteamBans Login. (not threaded)
[SBSRV] Logged in to SteamBans.com!
- Du solltest jetzt die Webseite überprüfen und du wirst auf deiner Teamseite folgende temporäre Information finden:
"Waiting for server info..."
Das bedeutet, dass dein Server erfolgreich zu unserem System hinzugefügt wurde, das Plugin deinen Server aber noch nicht vollständig gescannt hat.
Innerhalb 1 Stunde wird dein Server vollständig auf der Webseite erscheinen.
- Herzlichen Glückwunsch, dein Server ist nun geschützt durch SteamBans !
Befehle
Der sb_info Befehl zeigt an, wie das Plugin funktioniert und ob es Spieler scannt, Fehler auftreten, etc..
Probiere es einfach aus, und du wirst Informationen sehen wie zum Beispiel:
[SBSRV] The current running SBSRV version is 2.3 (Core: 1.1, Build: 1234)
[SBSRV] Current plugin server is: pluginserver.steambans.com (137.224.240.10)
[SBSRV] Current server IP:Port is: 1.2.3.4:27015
[SBSRV] Checked 105 ID's, and banned 2 ID's during server uptime.
Sollte das Plugin nicht richtig arbeiten, zeigt es dir den entsprechenden Fehlercode:
Mit diesen kannst du auf der SteamBans Webseite nachlesen, wie du diesen Fehler in Zukunft beheben kannst.
[SBSRV] Most recent error message:
[SBSRV] - [001] Will not login, missing or incorrectly written licensedetails.
Sollte das Plugin deaktiviert sein, erhältst du folgende Meldung:
[SBSRV] SteamBans is currently DISABLED, sb_action oo
Bitte nutze immer sb_info, wenn du Fehler dem SteamBans Team meldest.
Der sb_login Befehl erzwingt eine Anmeldung auf dem SteamBans Server.
Wenn Fehler auftreten, werden sie genauso, wie bei sb_info, in der Console anzeigt.
Warnung: Wenn der Pluginserver nicht erreichbar ist, kann es deinen Gameserver überlasten.
Sichert deine Lizens vor Änderungen oder Betrachtung. Diese Option ist sinnvoll falls du verhindern willst das andere rcon Nutzer deine Lizensdaten sehen können
Auch sinnvoll für Serverprovider die nun mit einer einzigen Lizens alle ihre Server schützen können ohne das die Kunden an die Daten können.
Hinweis: Dieser Befehl ist nicht umkehrbar, du mußt den Server neu starten um die Lizensdaten wieder sehen zu können.
Diese Variable beinhaltet deine Team ID und ist Teil der Authentifizierung. Nur dieser Teil kann gelesen werden nach sb_licenselock.
Diese Variable enthält deinen Lizenzcode und wurde von SteamBans generiert. Wenn sb_licenselock ausgeführt wurde kommt nur '##LOCKED##' als Antwort.
[SBSRV] sb_licensecode is "##LOCKED##"
Variablen
Diese Einstellung entspricht dem Pluginserver, den du nutzt. Standart (pluginserver.steambans.com). Belasse dies am besten so.
Aktion, wenn ein Spieler als Cheater erkannt wird:
- sb_action oo - Das Plugin reagiert gar nicht.
- sb_action al - Eine Nachricht wird im Serverlog gespeichert.
- sb_action aa - Das Plugin teilt allen Spielern mit, das diese Person Cheats benutzt, unternimmt aber nichts.
- sb_action ar - Entfernt den Spieler und teilt dies allen Spielern mit.
sb_advert besteht aus 3 Bits die die Meldungen auf deinem Server steuern.
Voreingestellt ist sb_adverts "111", wobei jedes Bit separat abgeschaltet werden kann indem man es auf 0 setzt (sb_advert "000" schaltet alles ab)
111: Zeigt eine Willkommensnachricht, dem Spieler, der gerade dem Spiel beigetreten ist.
You are playing on a SteamBans protected server.
Visit www.steambans.com for more information.
111: Zeigt allen Spielern, das keine positive Übereinstimmung gefunden wurde.
[SteamBans.com] No positive match found for STEAM_1:2:3456.
111: Gibt eine Meldung in die Konsole wenn ein Spieler erfolgreich gescannt wurde.
[SteamBans.com] No positive match found for STEAM_1:2:3456.
Wenn dein Team die erweitere Lizenz (advanced license) (3 - 10 Server) besitzt, kannst du die AMXBans Integration verwenden.
Du kannst nun SteamBans mit deiner eigenen AMXBans Datenbank oder mit deiner eigenen STEAM ID Datenbank verknüpfen.
Ein Beispiel wie du das sb_amxbansurl Skript nutzen kannst.
Wenn dein Team im Besitz der Silber Lizenz (silver license) oder einer höheren (min. 10 Server) ist, kannst du auch den Befehl sb_customurl nutzen.
Dieser arbeitet genau wie sb_amxbansurl, aber es stehen dir mehr Variablen zur Verfügung.
Ein Beispiel wie du das sb_customurl Skript nutzen kannst.
Damit kannst du die Nachricht ändern, wenn ein Spieler durch die eigenen Skripts vom Server getrennt wurde.
Eine gute Idee wäre zum Beispiel, deine Webseite anzugeben, du kannst es aber auch einfach auf der Standartnachricht lassen.
Die Standart Kicknachricht ist: "You have been banned from this server by the local admin."
Der Grund für SteamBans, warum dieser Befehl eingeführt wurde ist, um Betrugsversuche mit Steamids zu vermeiden.
Dieser Befehl beinhaltet die meisten Daten, wie der normale status Befehl, aber fügt SteamBans eigene Sicherheitstechniken hinzu.
sb_status ist eine Pflichtvoraussetzung um Demos bei SteamBans einzuschicken, damit wir gewährleisten können, das an dieser Demo nicht manipuliert wurde.
Der sb_status Befehl wurde deswegen allen Spielern zur Verfügung gestellt.
Kommunikation vom Plugin zu SteamBans funktioniert auf 2 Wege.
Du solltest dem Plugin erlauben auf pluginserver.steambans.com:1809 (TCP) zu verbinden.
und ebenso auf plugin.steambans.com:80 (TCP).
Warnung: Die IPs dieser DNS Adressen sind NICHT statisch, so könnten falsche Einstellungen eine Fehlfunktion hervorrufen.
Ein Bespiel für ein mögliches AMXBans Skript haben wir beigelegt und findest du hier. (Achtung, diese Datei sollte als PHP ausgeführt werden.)
Wenn dein Skript zum Beispiel hochgeladen ist auf: http://webhost.com/amxbans.php
solltest du die sb_amxbansurl ändern in: "http://webhost.com/amxbans.php?steamid=%s"
Das Plugin ruft nun die sb_amxbansurl auf deinem Webserver auf und ersetzt %s mit der Steamid.
Das Skript überprüft dann die Datenbank, ob die Steamid gebannt ist.
Es sollte "!MATCH\0" ausgeben gewerden, wenn der Spieler entfernt wird,
und "!NOMATCH\0" wenn der Spieler nicht gebannt ist.
Das sb_customurl Format ist ein bisschen erweitert im Vergleich zu amxbansurl.
Das Format ist zum Beispiel: "http://webhost.com/custombans.php?steamid=%s&nick=%s&sip=%s&sport=%s&clip=%s".
Das Skript ersetzt nun die Variablen SteamID, Nickname, ServerIP, ServerPort und ClientIP (in dieser Reihenfolgen) in deinem custombans.php Skript.
Du könntest nun zum Beispiel nach IP Bans suchen, oder Statistiken auf deiner Webseite damit anzeigen lassen. Den Möglichkeiten ist dabei keine Grenzen gesetzt.
Natürlich kannst du weiterhin anstelle von sb_customurl, die einfachere Variante sb_ambansurl nutzen.
Dieser Abschnitt ist nur dann wichtig, wenn dein Server nicht auf dem Standartport 27015 läuft.
Damit das Plugin sich richtig in unsere Datenbank eintragen kann muß es wissen auf welchem Port der Server arbeitet.
Hierfür benutzt HL1 die Kommandozeile des Servers in der der Port beschrieben wird. Normalerweise ist das zum Beispiel +port 27100.
Sollte dein Serverprovider allerdings die veraltete -port Variable nutzen, kann das Plugin den Port nicht richtig einsetzen und meldet sich bei uns mit dem Standartport an.
Ändere (bei eigenem Server) also die Variable auf +port, oder (bei gemietetem Server) frage bei deinem Provider nach ob er die Zeile für dich ändert.
In der Zwischenzeit kannst du dir selber helfen indem du einfach eine Zeile in deine server.cfg einfügst mit "port 27100" (ohne die Anführungszeichen) und den Server neu startest.
Ob dein Provider -port nutzt erkennst du ganz leicht daran das auf der Manage Servers Seite dein Server nicht mit dem richtigen Port eingetragen ist.
Jan 03, 2007 - 3.3 - Core 2.3
C1) changed the format of sb_advert.
C2) Fixed sb_custom check fully following the http specifications
C3) 080, 005 errors should be eliminated.
C4) Fixed threading issue during steamid-check.
C5) Several security and bugfixes.
Sep 21, 2006 - 3.2 - Core 2.2
C1) Improved login sequences
Jul 15, 2006 - 3.1 - Core 2.1
C1) Fixed a sb_requireauth bug
C2) Fixed bug causing sb_status to crash if login failed.
C3) Applied a patch to prevent flooding the pluginserver on a global recheck.
Jun 11, 2006 - 3.0 - Core 2.0
1) Redesigned the calling API from scratch.
C1) Redesigned the core from scratch.
C2) Added more security / improvements to the sb_status call.
C3) Removed the requirement to allow localhost connections.
C4) Added better locking to custom checks.
C5) Made licensedetails lockable.
Apr 20, 2006 - 2.6 - Core 1.4
C1) Removed issues from the plugin when working with bots
C2) Added improvements to the sb_status function
Jan 23, 2006 - 2.5 - Core 1.3
1) Moved the location of the advert out of the crosshair when playing on low resolutions
C1) Fixed an issue with the CRC on 64bit servers
Jan 13, 2006 - 2.4 - Core 1.2
C1) Fixed a bug on the windows versions when calculating CRC's
C2) Fixed a bug that caused the plugin to crash on newer glibc versions
Dec 21, 2005 - 2.3 - Core 1.1
C1) Added a patch to the sb_status call to give better support
C2) Added a patch to the checking mechanism that caused error 022 and 023 to occur
C3) Added a patch to the messenging system.
Nov 18, 2005 - 2.2 - Core 1.0
1) Moved SteamBans functions to a central core that is shared with SBSRC
2) Fixed an error when sb_action is oo, sb_info notifies you of that now
3) Disabled the use of LAN ip's when connecting the plugin to SteamBans
4) Added some improved security measures.
5) Added new chapters to the manual
Oct 19, 2005 - 2.1
1) Fixed bug that could server crashes when player was clear.
2) Added old sb_advert settings
3) sb_info shows no more error screens when a successfull check has been made
4) Added a 64bit plugin for linux.
Oct 10, 2005 - 2.0
1) Completely redesigned the plugin from scratch.
2) Added sb_info and sb_login.
3) Updated the login / check codes for speed improvements
Mar 08, 2005 - 1.05
1) Added VIP option to disable adverts
2) Modified custom check feature to pass IP of the connecting player as well
3) "sb_status verbose" tested and being tested in a controlled setting (partners only)
for possible hltv demo acceptance from non official matches.
Jan 21, 2005 - 1.04
1) Added some more efficiency tweaks.
2) Fixed a few int to long issues that made it not run right on amd64
3) Added two additional binaries for those with different server specs
a) sbsrv_mm_1386 - optimized binary
b) sbsrv_mm_compat_i386 - normal binary for those running older distros
c) sbsrv_mm_amd64 - optimized binary for those running 64 bit metamod
Jan 14, 2005 - 1.03
1) Set pthread state to detached to fix memory leak some users were having
Thank you to Leff and W0kk3L from #crew-nexus for agreeing to be the test
dummy for this experiment.
Jan 07, 2005 - 1.02
1) Added custom banlist integration for larger licenses (Silver/Gold/Mega)
2) Fixed the active alert spam bug mentioned in the forums
Jan 02, 2005 - 1.01
1) Threaded the sb_status socket
2) Fixed the sockets in close_wait state (bug posted on forums)
3) Fixed all int -> long type warnings
4) Added verbose sb_status function for future HLTV demo support (uses server say to display data)
Dec 22, 2004 - 1.00
1) Defaulted sb server to use cname instead of IP
2) Entered final status. Please be sure to post any issues that arise in our forums
so that we can fix them.
Dec 20, 2004 - 0.11 beta
1) Fixed handling of results data to default to FAILED on error to prevent false positives.
2) Fixed a typo in admin mod check for passive alert
Dec 15, 2004 - 0.10 beta
1) Fixed a few issues with the sb_advert b method including it not showing up on dod.
Dec 09, 2004 - 0.09 beta
1) Added cvar sb_advert for advert methods as well as an alternate advertise method
see above for more info.
Dec 08, 2004 - 0.08 beta
1) Made checks multi-threaded to prevent lag spikes.
2) Recoded check function for efficiency.
Nov 22, 2004 - 0.07 beta
1) Fixed an RFC compliance issue.
Nov 21, 2004 - 0.06 beta
1) Fixed the plugin so it should run properly from any directory.
2) Fixed up CRC routine to match the polynomial from Ethernet/php
3) The issue with anti-cheat showing up as none should be resolved
4) Added name passing for irc relay integration
Nov 9, 2004 - 0.05 beta
1) Rework of 0.04 due to problems with the same situation.
Nov 9, 2004 - 0.04 beta
1) Reverted back to GET_MOD_DIR due to data inconsistency.
This should resolve the problem posted by Rawh at
http://www.steambans.com/forums.php?fid=11&tid=406
Nov 9, 2004 - 0.03 beta
1) Added sb_status support through server console
2) Fixed a minor bug in CRC routine
3) Switched plugin to use GET_PLUGIN_PATH instead of GET_MOD_DIR so it should work from any directory
Nov 8, 2004 - 0.02 beta
1) Fixed the license cvars from being publically available. They are now created with FCVAR_PROTECTED.
2) Fixed a CRC Verification error.
Nov 6, 2004 - Initial beta release.
Ende der Datei.