Custom Bots | Noxyr-Dokumentation

Was ein Custom Bot ist

Ein Custom Bot ist Noxyr, das unter einem Bot-Token läuft, das dir gehört. Mitglieder sehen deinen Namen und deinen Avatar, aber der Code, die Einstellungen und die Datenbank gehören Noxyr. Eine Änderung im Dashboard gilt für beide Bots, und nichts wird doppelt angelegt.

Noxyr hostet ihn für dich auf einem seiner Nodes. Pro Server gibt es genau einen Bot: Wo dein Custom Bot ist, zieht sich Noxyr zurück und antwortet nicht mehr. Wo er nicht ist, arbeitet Noxyr wie bisher weiter. Ein Discord-Konto bekommt einen Custom Bot, und denselben Bot kannst du auf beliebig vielen Servern nutzen, die du verwaltest.

Was du brauchst

Eine Top.gg-Abstimmung: Eine Abstimmung für Noxyr auf Top.gg schaltet das Einrichtungsformular für 12 Stunden frei. Mehr kostet es nicht, denn es gibt keinen bezahlten Tarif.
Deine eigene Anwendung: Erstelle sie im Discord Developer Portal. Noxyrs eigenes Token wird abgelehnt, ein User-Token ebenfalls.
Zwei privilegierte Intents: Server-Mitglieder-Intent und Nachrichteninhalt-Intent müssen unter Bot → Privileged Gateway Intents aktiviert sein. Das Dashboard prüft das, bevor es das Token annimmt.
Noxyr auf dem Server: Dein Custom Bot läuft mit Noxyrs Einstellungen und Datenbank, deshalb muss Noxyr auf jedem Server bleiben, den er betreut.
Administrator: Nur Personen, die den Server im Dashboard öffnen können, dürfen dafür einen Custom Bot einrichten.

Einrichtung

Stimme auf Top.gg für Noxyr ab und öffne dann Custom Bot im Server-Dashboard.
Drücke im Developer Portal auf New Application und gib der Anwendung den Namen, den der Bot tragen soll. Setze im Tab Bot den Avatar und aktiviere beide privilegierten Intents.
Drücke auf Reset Token, kopiere das Token einmal und füge es auf der Seite Custom Bot ein. Es wird verschlüsselt gespeichert, und nur die Website und der Node, der deinen Bot betreibt, können es lesen.
Wähle einen Host (Automatisch nimmt den schnellsten Node mit freier Kapazität) und drücke auf Start my bot.
Nutze den Einladungslink, den die Seite anzeigt. Der Bot ist in etwa zwanzig Sekunden online und registriert die Befehle von Noxyr unter seinem eigenen Namen.

Nur die Person, die das Token eingefügt hat, kann es später ersetzen. Andere Admins des Servers sehen den Bot, können aber kein anderes Token unter deinem Namen einsetzen.

Abstimmungsfenster, Schonfrist und Erinnerungen

Eine Abstimmung hält den Custom Bot 12 Stunden lang freigeschaltet, und so oft lässt Top.gg dich auch abstimmen. Wenn dieses Fenster schließt, beginnt eine Schonfrist von 74 Stunden. Der Bot läuft weiter, aber die Seite Custom Bot bleibt gesperrt, bis du erneut abstimmst.

Eine Erinnerungs-DM kommt 24 Stunden nach deiner letzten Abstimmung, also 12 Stunden in die Schonfrist, mit einem Countdown bis zur Abschaltung. Läuft auch die Schonfrist ab, geht der Bot offline und seine Befehle werden vom Server entfernt. Nichts wird gelöscht: Token, Einstellungen sowie alle Tickets, Produkte und Rechnungen bleiben genau dort, wo sie waren, und eine Abstimmung schaltet alles wieder ein.

Abstimmungsfenster: 12 Stunden ab der Abstimmung. Beide Uhren laufen auf der Seite Custom Bot live herunter.
Schonfrist: 74 Stunden nach Ende des Fensters. Bot läuft, Dashboard gesperrt.
Erinnerungs-DM: Einmal pro Fenster gesendet, 24 Stunden nach der Abstimmung.
Ausgeschaltet: Nach der Schonfrist. Stimme erneut ab, und der Bot startet automatisch neu.

Mehr Zeit ohne Abstimmung

Abstimmungen sind nicht der einzige Weg, einen Custom Bot am Laufen zu halten. Jede Option unten fügt Stunden zu dem hinzu, was dir noch bleibt, sodass nichts verloren geht. Auf der Seite Mehr Zeit holen (Custom Bot → Mehr Zeit holen) siehst du deinen Countdown, deinen Stand bei jeder Option und jede Stunde, die dir gutgeschrieben wurde.

Noxyr Rush: Ein Browser-Minispiel auf der Website. Erreiche 3,000 Punkte in einem Durchgang und erhalte 12 Stunden. Du kannst bis zu 12 Spielstunden gleichzeitig halten. Sind sie aufgebraucht, kannst du sie erneut verdienen. Nur Konten mit einem Custom Bot sammeln Zeit, und der Server prüft jeden Durchgang.
Einen Freund einladen: Teile deinen Empfehlungslink von der Seite Mehr Zeit holen. Wenn der Freund seinen ersten Custom Bot einrichtet, erhaltet ihr beide 12 Stunden. Das zählt einmal pro Freund. Dessen Discord-Konto muss mindestens 30 Tage alt sein, und du kannst alle 30 Tage Zeit von bis zu 10 Freunden verdienen.
Fehlerberichte und Vorschläge: Sende einen über das Support-Center. Wenn das Noxyr-Team ihn genehmigt, erhältst du 12 Stunden, einmal pro Bericht.
Vom Team: Das Noxyr-Team kann Zeit direkt gutschreiben, zum Beispiel nach einem Ausfall.

Wenn Noxyr vom Server entfernt wird

Da der Custom Bot von Noxyrs Anwesenheit abhängt, stoppt das Entfernen von Noxyr den Custom Bot auf diesem Server innerhalb von etwa einer Minute. Der Bot schickt der Person, die Noxyr entfernt hat, eine DM mit einem Einladungslink. Ist das eine andere Person, bekommt auch der Bot-Besitzer die DM.

Lade Noxyr wieder ein, dann startet der Custom Bot von selbst neu. Solange er aus diesem Grund gestoppt ist, wird dein Abstimmungsfenster pausiert statt verbraucht, solange kein anderer Bot von dir noch läuft.

Dein Abstimmungsfenster an jemand anderen übergeben

Die Person, die abstimmt, und die Person, der der Bot gehört, müssen nicht dasselbe Konto sein. Auf der Seite Custom Bot kannst du dein restliches Fenster über die Benutzer-ID an einen anderen Discord-Nutzer übergeben, entweder ganz oder eine bestimmte Anzahl Stunden.

Die Zeit kommt zu dem hinzu, was die Person bereits hat. Eine Übergabe macht sie also nie schlechter. Deine Schonfrist bleibt bei dir, damit dein eigener Bot nicht mitten im Satz stoppt. Ihr erhaltet beide eine DM, in der steht, was übertragen wurde.

Nur ein aktives Fenster kann übergeben werden. In der Schonfrist gibt es nichts mehr zu übergeben. Übergaben unter fünf Minuten werden abgelehnt.

Fehlerbehebung

„Discord hat dieses Token abgelehnt“ (Gateway-Code 4004): Das Token wurde im Developer Portal zurückgesetzt, daher ist das alte ungültig. Der Bot bleibt ausgeschaltet, bis du erneut auf Reset Token drückst und das neue Token auf der Seite Custom Bot einfügst.
„Discord hat die Verbindung verweigert“ (Gateway-Code 4013 / 4014): Nach der Einrichtung wurde ein privilegierter Intent ausgeschaltet. Aktiviere Server-Mitglieder-Intent und Nachrichteninhalt-Intent wieder und schalte den Bot dann im Dashboard erneut ein.
„Stimme zuerst auf Top.gg ab“: Dein Abstimmungsfenster ist abgelaufen. Stimme ab und versuche es dann erneut. Die Seite wird sofort freigeschaltet.
„Dieser Bot ist bereits der Custom Bot für den Server von jemand anderem“: Eine Anwendung kann nur einem Besitzer gehören. Erstelle eine neue Anwendung für dich selbst.
„Du betreibst bereits …“: Ein Konto, ein Custom Bot. Nutze den bestehenden Bot auch auf diesem Server (die Seite bietet ihn an) oder lösche ihn vorher.
Node ändern ist ausgegraut: Jeder Wechsel ist eine neue Discord-Anmeldung, deshalb gibt es zwischen zwei Wechseln eine Wartezeit von fünf Minuten.
Status zeigt „suspended“: Entweder sind Abstimmung und Schonfrist abgelaufen, oder Noxyr wurde vom Server entfernt. Die Statusmeldung auf der Seite sagt, welches davon zutrifft.