|
|
|
|
|
|
NordicBots Dokumentation
Einleitung
Willkommen auf den NordicBots Dokumentations-Seiten! Diese Seite sollte alle Informationen beeinhalten, die du benötigst, um einen Bot zu bekommen.
Hier findest du eine Liste mit Links, welche dich zu den entsprechenden Bereichen leiten:
Hauptinformationen - Zeigt dir grundlegende Informationen zu unseren Bots. Geht ins Detail bei: Requesting, Identifikation, den Userlevels, usw.
Globale Kommandos -
Liste mit Kommandos, die nicht den Channel betreffen.
Channel-bezogene Kommandos - Zeigt alle Kommandos, die du im Bezug auf Channels benötigst.
Channel Einstellungen - Zeigt dir sämtliche Channel Einstellungen an.
Öffentliche Kommandos - Zeigt alle öffentlichen Kommandos an, z.B.: votes, quotes, triggers, commandchar usw.
Hauptinformationen
Einen Bot bekommen
Wenn du bisher noch keinen Bot in deinem Channel hast, du aber einen haben möchtest, dann kannst du einen anfordern. Anforderungen können über den Web request gemacht werden. Bevor du
einen Bot anforderst, lies bitte unsere Regeln genau durch! Du kannst den Bot auch direkt im IRC anfordern, joine einfach #NordicBots und gib folgendes ein: /msg
NB-Request request <chan> <botnick> <email>. Du musst allerdings bei Q angemeldet sein, um einen Bot anzufordern.
Den Bot in einen anderen Channel verschieben
Wenn du deinen Bot von deinem Channel in einen neuen verschieben möchtest, joine bitte #NordicBots und gib ein: !move
#alter-chan #neuer-chan. Nur der Besitzer (Owner) kann den Bot verschieben. Deine Einstellungen, die Userlist usw. gehen dabei nicht verloren! Wenn du die Channel-Statistiken zurückgesetzt haben möchtest, frage bitte ein Mitglied von NordicBots.
Den Bot austauschen
Wenn dich dein bisheriger Botname nervt, dann kannst du ihn durch einen anderen Bot ersetzen lassen, indem du einfach folgendes eingibst: /msg <bot> CHANGEBOT <chan>
<newbot> Bevor du das tust, solltest du in der Liste der verfügbaren Bots nachsehen, ob dein gewünschter Bot dabei ist, das kannst du hier.
Alle Einstellungen bleiben dabei erhalten.
Den Bot entfernen
Wenn dein Channel nicht mehr benötigt wird, oder du den Bot einfach nicht mehr haben willst, joine bitte #NordicBots und gib folgendes ein: !remove
<chan> <reason> um den Bot zu entfernen. Nur der Besitzer (Owner) kann den Bot entfernen.
Channel suspended?
Wenn du gegen unsere Regeln verstösst oder jemand in deinem Channel, werden wir deinen Channel suspenden.
Das bedeutet, dass der Bot für 7 Tage den Channel verlassen wird, alle Einstellungen bleiben erhalten. Wenn der suspend innerhalb dieser Zeit nicht aufgehoben wird, wird der Bot endgültig entfernt. Der Besitzer (Owner) des Channels wird eine Nachricht via E-Mail erhalten, wenn der Channel suspendet wird. Du kannst hier sehen, ob dein Channel suspendet wurde. Falls dein Channel suspendet wurde, und du möchtest ihn zurück, joine #NordicBots und frage einen Admin.
Identifikation
Unsere Bots erkennen dich anhand deines Q-Accounts. Um mit dem Bot zu kommunizieren, musst du bei Q angemeldet sein. Nachdem du angemeldet bist, solltest du die Kommandos auf dieser Seite benutzen können. Wenn der Bot behauptet, dass er dich nicht kennt, sagt du bist nich eingeloggt, oder du hast keinen Zugriff, versuche folgendes Kommando: /msg
<bot> IDENT
Beachte, dass der Bot auf dieses Kommando keine Antwort gibt (du wirst nur eine Nachricht erhalten, dass der Bot Überprüft, ob du eingeloggt bist), versuche nach ein paar Sekunden das Kommando nochmals auszuführen, nun sollte es funktionieren.
Falls du Fragen dazu hast, melde dich ruhig in #NordicBots.
User levels
Das Level eines User sagt dir, was der User in deinem Channel tun kann. Die folgenden Levels stehen zur Verfügung:
| Friend |
Wird nicht "bestraft" für "flooden" oder Werbenachrichten. |
| Voice |
Kann sich selbst Voice (+v) geben und wird automatisch ge-voiced, falls CHANSET
'autovoice' aktiviert ist. |
| Op |
Kann sich selbst Op (+o) geben und wird automatisch geopt, falls
CHANSET
'autoop' aktiviert ist. |
| Master |
Kann verschiedene Channel Kommandos über das CHANSET
Kommando durchführen. Kann User mit dem Level Friend, Voice und Op adden. |
| Owner |
Hat volle Kontrolle über den Channel. Kann User mit dem Level Owner oder Master adden. | Die meisten Berechtigungen beinhalten die geringeren Stufen, z.B. wird ein Op nicht für Spammen bestraft, oder kann sich auch selbst +v geben.
top
Hauptkommandos
Die folgenden Kommandos können über /msg <bot>
<command> ausgeführt werden, z.B.: /msg <bot>
help
Kommandos, die für jeden verfügbar sind:
| HELP |
Gibt die Hilfe für ein bestimmtes Kommando aus. |
| IDENT |
Loggt dich beim Bot ein, falls du erst, nachdem du deinen Channel gejoint hast, dich bei Q einloggst. |
| SHOWCOMMANDS |
Zeigt dir eine Liste mit für dich verfügbaren Kommandos - ACHTUNG: Lange Liste! |
| VERSION |
Gibt die aktuelle Version des Botservice aus. |
| WHOAMI |
Der Bot sagt dir, ob und wie er dich kennt. |
Kommandos nur verfügbar, wenn du bei Q eingeloggt bist:
| ACCESS |
Zeigt das Level eines Users. |
| ADDNOTE |
Fügt eine zeitliche Notiz hinzu (Zur Zeit nur für Mitteleuropäische Zeit verfügbar). |
| EMAIL |
Legt deine E-Mailadresse fest. |
| LISTNOTES |
Zeigt alle Notizen, die mit ADDNOTE angelegt wurden. |
| WHOIS |
Zeigt dir an, ob und wie der Bot jemanden kennt. |
Das waren die Kommandos, die nicht für Channeleinstellungen verantwortlich sind. Für eine Liste mit Kommandos, die für Channeleinstellungen da sind, lese weiter. top
Channeleinstellungen
Syntax für die Kommandos: /msg
<bot> <command>, z.B.: /msg <bot>
help
Kommandos für User mit dem Level 'Friend' oder höher
| INVITE |
Invitet in den Channel. |
| SETTOPIC |
Zeigt (oder setzt das Topic, falls du 'Master' oder ein höheres Level hast) das Topic des Channels. |
Kommandos für User mit 'Voice' oder höher
| DEVOICE |
Entfernt dein (oder eines anderen, falls du mindestens Op bist)
voice (-v) im Channel. |
| VOICE |
Gibt dir (oder einem anderen User, sofern du mindestens Op bist)
voice (+v) im Channel. |
Kommando fü das Level 'Op'
| BAN |
Setzt einen Ban im Channel. |
| DEOP |
Entfert dein (oder das eines anderen, falls du mindestens Master bist) Op (-o) im Channel. |
| KICK |
Kickt jemanden aus dem Channel. |
| OP |
Gibt dir (oder jemanden anderem, sofern du mindestens Master bist)
Op (+o) im Channel. |
| SAY |
Bringt den Bot dazu, etwas im Channel sagen. |
| UNBAN |
Entfernt einen Ban aus dem Channel (und der Datenbank). |
| UNBANALL |
Entfernt alle Bans vom Channel. |
|
Kommandos für User mit dem Level 'Master' oder höher
| ADDBADWORD |
Addet ein Badword, hier findest du Informationen über Badwords. |
| ADDTRIGGER |
Fügt oder updated einen Trigger, lies diese Informationen über Trigger. |
| CHANLEV |
Dies ist ein Alias für USERLEV und verhält sich genauso. |
| CHANSET |
Setzt die verschiedenen Einstellungen für deinen Channel, hier findest eine Liste der Einstellungen. |
| CYCLE |
Der Bot wird deinen Channel verlassen und sofort wieder betreten. |
| DELALLBANS |
Entfernt alle Channel-Bans. |
| DELBADWORD |
Entfernt ein Badword, welches mit ADDBADWORD erstellt wurde. |
| DELTRIGGER |
Entfernt einen Trigger, der mit ADDTRIGGER erstellt wurde. |
| GREET |
Setzt die Begrüssung für dich im Channel . |
| MODTRIGGER |
Ändert einen Trigger. Hier findest du Informationen über die
Trigger. |
| USERLEV |
Setzt das Level für einen User, hier findest du Informationen über die
Levels. |
Kommandos, die nur dem Owner zur Verfügung stehen.
| CHANGEBOT |
Erlaubt dir den Bots zu wechseln. Alle Einstellungen bleiben erhalten. | top
Channel-Einstellungen
Die folgenden Einstellungen können über das CHANSET Kommando durchgeführt werden, welche nur Master oder Owner erlaubt sind.
Um diese zu aktivieren, gib folgendes ein:
/msg <bot> CHANSET <chan> +<setting>
[extra]
Um sie zu deaktivieren nutze: /msg <bot> CHANSET
<chan> -<setting>
Verfuegbare Einstellungen
| advertise |
Enables anti-advertising which will which will warn/kick/ban users if
they advertise. Read more about the warn/kick/ban settings here. |
| autoop |
Vergibt automatisch +o ('Op') an User mit dem Level 'Op' oder höher, wenn sie den Channel betreten. Beachte: Es wird nicht automatisch jeder +o erhalten, das kann der Bots nicht und ist auch nach unseren Regeln verboten. |
| autovoice |
Vergibt automatisch +v ('Voice') an die User, die mindestens das Level 'Voice' beim Bot haben. Beachte: Wenn du möchtest, dass jeder +v erhält, benutze die 'massvoice'
Einstellung. |
| badwords |
Schaltet die "Badword"-Funktion ein. Benutzer, die ein "Badword" im Channel sagen, werden dann gewarnt/gekickt oder gebannt. Hier findest du mehr Informationen zu Badwords. |
| bitch |
Falls jemand ge-opt (+o) wird, dem der Bot nicht als Op bekannt ist, wird dieser sofort wieder deopt. |
| commandchar |
Dies bietet dir die Möglichkeit an, verschiedene Kommandos mit Triggern wie "!" und "?" zu verwenden (z.B. !op, und ?kick).
Lies mehr über Commandchar
hier. |
| dynamicbans |
Entfernt Channel-Bans [minuten] Minute(n), nachdem sie im Channel erstellt worden sind (standard: aktiviert, 5m). Lies mehr über das Ban-System
weiter unten. |
| enforcebans |
Kickt gebannte User, die durch jemanden anderen im Channel gebannt wurden. Lies hier mehr über das Ban-System . |
| flood |
Aktiviert das Anti-Flooding. Entsprechende User werden gewarnt/gekickt/gebannt, wenn sie mehr als <x> Zeilen in <y> Sekunden schreiben. Lies hier mehr über dieseEinstellung. |
| greet |
Aktiviert die Begrüssung der einzelnen User, die über eine Greet-Nachricht verfügen. |
| hidelogs |
Falls du die Channel-Statistiken aktivieren willst, aber die Logs nicht angezeigt werden sollen, dann aktiviere diese Einstellung. |
| infobot |
Aktiviert verschiedene Kommandos wie z.B. !date und chaninfo?. |
| massvoice |
Es werden automatisch alle User ge-voiced (+v), die deinen Channel joinen. |
| modes |
Der Bot setzt die ihm mitgeteilten Modes für den Channel. |
| onjoin |
Setzt eine Nachricht, die jedem angezeigt wird, der deinen Channel betritt (%n
ersetzt den Namen des Users, %p zeigt den Channel Peak an). |
| peak |
Zeichnet auf, wieviele User gleichzeitig im Channel waren und zeigt bei dem Kommando !peak
die Maximalanzahl an. |
| quotes |
Aktiviert das Quote System. Lies mehr über das Quote-System
weiter unten. |
| showbanby |
Wenn aktiviert, zeigt es den Namen des Users, der einen Ban erstellt hat.
(standard: aktiviert). Lies mehr über das Ban-System
weiter unten. |
| stats |
Wenn aktiviert, wird der Bot alle 3 Stunden Channelstatistiken generieren. Mehr Informationen sind etwas tiefer zu lesen. |
| statslang |
Stellt die Standardsprache der Stats ein. Lies hier, welche Sprachen verfügbar sind. |
| timedquotes |
Aktvieren, um alle paar Minuten ein Quote vom Bot ausgeben zulassen. |
| timezone |
Setzt die Zeitzone für deinen Channel (wird für !date
benötigt). |
| topic |
Wenn aktiviert, erlaubt der Bot nur Mastern oder Ownern, das Topic zu verändern. |
| tv |
Aktiviert das !tv Kommando, welches dir ausgibt, was gerade im schwedischen Fernsehen läuft. |
| userbans |
Erlaubt ALLEN Usern Bans zu erstellen (andernfalls werden die Bans durch den Bot verwaltet). (Standard: aktiviert). Lies mehr über das Ban-System
weiter unten. |
| vote |
Aktiviert das !vote Kommando, welches dir erlaubt, Abstimmungen in deinem Channel zu machen. Lies mehr über das Vote-System. |
Statistiken (stats)
Unsere Bots können Stats erstellen, wenn das 'stats' CHANSET (weiter oben) aktiv ist. Eine Beispielseite findest du hier, Das sind die Statistiken unseres Channels. Ausserdem werden dir die Channel-Logs angezeigt, das kannst du dir hier ansehen. Wenn du die Logs abschalten willst, musst du 'hidelogs' CHANSET (weiter oben) aktivieren. Das wird deine Log-Seite verstecken. Wenn du es wieder deaktivierst, werden die Logs wieder angezeigt. Die Sprache der Stats kannst du mit 'statslang' CHANSET in einer der folgenden Sprachen generieren:
Albanisch - al
Bulgarisch -
bg
Catalanisch - ca
Tschechisch - cz
Dänisch - dk
Niederländisch - nl
Niederländisch (Flämisch) - be
Englisch - en
Estisch - ee
Finnisch - fi
|
Französisch - fr
Deutsch -
de
Griechisch - gr
Hebräisch - he
Ungarisch - hu
Isländisch -
is
Italienisch - it
Norwegisch - no
Polnisch - pl
Portugiesisch -
pt
|
Portugiesisch (Brasilien) -
br
Romänisch - ro
Russisch - ru
Serbisch - yu
Slovakisch -
sk
Slovenisch - si
Spanisch - es
Schwedisch - se
Türkisch -
tr
| Wenn deine Sprache nicht dabei ist, und du sie gerne Übersetzen möchtest, dann kontaktiere einen Admin in #NordicBots. Öffentliche Kommandos
Folgende Kommandos kann jeder im Channel benutzen, sofern du es so eingestellt hast.
Badwords/advertise/flood Einstellungen
Du kannst die Badwords aktivieren mit: /msg <bot>
CHANSET <chan> +badwords [type] [duration]
Du kannst den advertise Mode mit /msg <bot> CHANSET <chan> +advertise
[type] [duration] aktivieren
Flood-Mode kannst du aktivieren mit: /msg
<bot> CHANSET <chan> +flood [lines:sec] [type]
[duration]
Wie du sehen kannst, gibt es viele Parameter, eine Liste findest du hier:
| warn |
Warnt den User. |
| warn+kick |
Warnt den User, bei zweiten Mal wird der User gekickt. |
| warn+ban |
Zuerst wird der User gewarnt, beim zweiten Mal wird der User gebannt. * |
| kick |
Kick ohne Warnung. |
| ban |
Bann ohne Warnung. * |
Funktionen mit '*' bannen den User nur temporär. Du kannst diese Zeitspanne (duration) in Minuten angeben, falls du sie nicht mit angibst, wird der Standard von 5 Minuten verwendet.
Badwords hinzufügen
Ist diese Einstellung aktiviert, kannst du Badwords erstellen. Badwords werden mit:
/msg <bot>
ADDBADWORD <chan> <badword> hinzugefügt
Badwords werden mit dem 'DELBADWORD' Kommando entfernt. top
Ban-System
Ban Arten (Zieltypen):
/msg <bot> ban #chan nick 7d <reason> |
Bannt den Host des Users und ggf. auch den Q-Auth. |
/msg <bot> ban #chan #auth 7d <reason> |
Bannt den Q-Auth des Users. |
/msg <bot> ban #chan *!*@host 7d <reason> |
Bannt nur den Host. |
Ban Arten (Zeiten und Gründe):
/msg <bot> ban #chan <target> |
Bannt für 1 Stunde (= default) mit der Begründung 'Requested' (=
Standard). |
/msg <bot> ban #chan <target> 7d |
Bannt das Ziel für 7 Tage mit der Begründung 'Requested' (=
Standard). |
/msg <bot> ban #chan <target> perm
<reason> |
Bannt das Ziel unbegrenzt, mit 'reason' als Begründung. |
Ban Arten (Spezial):
/msg <bot> ban #chan <target> 7d
*<reason> |
Bannt das Ziel im Bot und im Channel.
(siehe [1]). |
Unban Arten:
/msg <bot> unban #chan nick |
enfernt alle Bans, die den User betreffen (wenn möglich). |
/msg <bot> unban #chan #auth |
entfernt alle Bans dieses Q-Auth's (wenn möglich). |
/msg <bot> unban #chan *!*@* |
entfernt einen bestimmten Ban (wenn gefunden). |
/msg <bot> unbanall #chan |
entfernt alle Bans im Bot, nicht die im Channel. |
/msg <bot> delallbans #chan |
entfernt restlos alle Bans. |
top
Commandchar
Erlaubt dir Trigger wie z.B.
"!" and "?" für bestimmte Kommandos. Eine Liste findest du weiter unten.
aktivieren mit: /msg <bot> CHANSET <chan> +commandchar
<character>
Beispiel, +commandchar !, ermöglicht z.B. !kick. +commandchar . würde .kick ermöglichen
| access <nick> |
Zeigt die Berechtigung im Channel. |
| addtrigger <trigger> <text> |
Erstellt einen Trigger. |
| deltrigger <trigger> |
Entfernt einen Trigger. |
| kick <nick> |
Kickt jemanden aus dem Channel. |
| ban <nick> |
Bannt jemanden aus dem Channel. |
| unban <nick> |
Entfernt einen Ban aus dem Channel. |
| voice <nick> |
Vergibt +v an einen User (sofern Level entsprechend). |
| devoice <nick> |
Setzt -v auf einen User. |
| op <nick> |
vergibt +o an einen User (sofern Level entsprechend). |
| deop <nick> |
Setzt -o auf einen User. |
| greet <nick> |
Legt die Begrüssung fest. |
| chanset <setting> |
Setzt/entfernt eine Channel-Einstellung. |
| userlev <nick> <level> |
Vergibt die Berechtigung bei einem User. | top
Quote system
Du kannst es mit: /msg <bot>
CHANSET <chan> +quotes aktivieren
Folgende Kommandos gibt es:
| !quote |
zufälliges Quote wird angezeigt. |
| !quote add <text> |
Quote hinzufügen. |
| !quote info <id> |
Gibt Informationen zu dem entsprechenden Quote aus. |
| !quote find <text> |
Suche nach einem Quote. |
| !quote del <id> |
Löscht das entsprechende Quote. | top
Trigger-System
Master oder Owner können Trigger erstellen, z.B.: !ip, !help, ?info, .status usw. diese zeigen einen selbstdefinierten Text an.
Um einen Trigger hinzuzufügen oder zu aktualisieren nutze: /msg <bot> ADDTRIGGER
<chan> <trigger> <text>
Zum Entfernen nutze:
/msg <bot> DELTRIGGER <chan> <trigger>
To
Zum Ändern: /msg <bot> MODTRIGGER <chan>
<trigger> <add/edit/del> [zeilennummer] [zeile]
Trigger Typen
Es gibt 3 Arten von Triggern: öffentlich (-public, standard), Privat (-private, gibt eine Private Nachricht aus) und Notiz
(-notice, schickt die Antwort als Notiz).
Level
Du kannst die Trigger auch nur für z.B. Master limitieren. Eine Liste der Level gibts hier.
Argument Unterstützung
Du kannst Platzhalter von %1 bis %9 um individuelle Parameter zu nutzen.
Ein Beispiel: /msg ^Donkey^ ADDTRIGGER #NordicBots !test /me slaps %1 around
a bit with %2-
Wen du nun folgendes eingibst: !test NB-Service a large
trout
Zeigt der Bot folgendes an: ^Donkey^ slaps NB-Service around a bit with a
large trout top
Vote System
Aktiviere das Vote System mit: /msg <bot>
CHANSET <chan> +vote
Folgende Kommandos gibt es:
| !vote start |
Um einen Vote zu starten: !vote start
<Zeit> <Frage> Der User muss im Channel geaddet sein. |
| !vote no |
mit 'Nein' voten. |
| !vote yes |
Mit 'Ja' voten. |
| !vote status |
Zeigt Infos zum laufenden Vote. |
| !vote stop |
Stoppt den Vote. | top
Verschiedene Kommandos
Hier siehst du eine Liste mit öffentlichen Kommandos.
| !date |
Zeigt die aktuelle Zeit im Channel an, falls sie nicht stimmt, überprüfe die 'timezone' Einstellung |
| !google <keyword> |
Wenn CHANSET
+infobot aktiviert wurde, kannso du so bei Google nach etwas suchen, die ersten beiden Ergebnisse werden angezeigt. |
| !image <keyword> |
Wenn CHANSET
+infobot aktiviert wurde, kannst du nach Bildern bei Google suchen, die ersten beiden Ergebnisse werden angezeigt. |
| !peak |
Wenn CHANSET
+peak aktiviert wurde, zeigt der Bot dir die maximale Anzahl an Benutzern, die gleichzeitig im Channel waren. |
| chaninfo? |
Zeigt eine URL zu einer Seite, wo du dir die Einstellungen deines Bots ansehen kannst. Dies kannst du auch auf dieser Seite finden. |
| stats? |
Zeigt dir die URL zu deiner Statistik- und Log-Seite an. Auch hier zu finden. |
Falls du noch Fragen hast, oder Probleme mit dem Bot, melde dich in #NordicBots. top
|
|
|
|
|
|
brunette
