Veröffentliche bis zu 2 Panels pro Server. Die Kanalnachricht zeigt die Top-Liste; jeder Spieler klickt auf Ranking ansehen und blättert in einer Nachricht, die nur er sieht. Premium-Plan · WebLogs ≥ 9.6.
Einrichtung
- 1Meine Server → DiscordBot → Verbinden (derselbe Bot wie für VIP, Tickets und Gewinnspiele).
- 2Menü Ranking: Kategorien (Zombies wird automatisch angelegt), Emoji, Zurücksetzen und 24h/7T-Ansichten, Embed-Stil.
- 3Neues Panel → Discord-Kanal + Kategorien → Veröffentlichen.
- 4Addiere in FiveM Punkte mit dem Export (Adictos_Zombies ruft ihn bereits bei jedem Kill auf).
Zeiträume, Zurücksetzen und Events
In jeder Kategorie kannst du die Ansichten Heute, 7 Tage, 30 Tage und Gesamt aktivieren. Die Zeiträume beruhen auf Kalendertagen, daher beginnt Heute um Mitternacht leer – wie ein tägliches Ingame-Ranking. Du kannst auch Beginn und Ende eines Events festlegen: Es zählen nur Punkte innerhalb dieses Zeitraums; zum Ende werden Gewinner (und Top 10) gespeichert und die Bestenliste geleert. Das Zurücksetzen alle N Tage leert die Gesamtwertung automatisch (Panel-Cron).
Wo die Punkte gespeichert werden
Die Tabellen werden beim Öffnen von Ranking oder beim ersten empfangenen Paket automatisch angelegt. Mit der Quelle Export sammeln sich die Punkte im Panel (ranking_scores, Rockstar-Lizenz ohne Präfix license:). Mit der Quelle ox_inventory oder qb_inventory wird das Ranking live aus dem Inventar-JSON in derselben MySQL wie das Panel gelesen. Das Intervall des öffentlichen Embeds stellst du unter Panel Settings → Discord ein.
| Tabelle / Feld | Wofür |
|---|---|
ranking_categories | Kategorien (Schlüssel, Emoji oder ohne, Zurücksetzen, Ansichten, Quelle) |
ranking_scores | Gesamtsummen aus dem Export |
ranking_scores_daily | Tägliche Buckets: eine Zeile pro Spieler, Kategorie und Tag (Rankings Heute / 7T / 30T) |
ranking_event_winners | Gewinner und Metadaten beim Abschluss eines Events |
ranking_event_standings | Alle archivierten Platzierungen; Aufbewahrung = Log-Tage des Plans (Free/Premium) |
ranking_panels | Bis zu 2 Discord-Nachrichten (Kanal, Kategorien, Aktualisierung) |
servers.weblogs_ranking_config | JSON: Modul an/aus, Farbe, Fußzeile, Zeilen pro Seite |
Export (Adictos_WebLogs)
Cache im Speicher von FiveM und Versand an das Panel alle N Sekunden (Panel Settings → Flush Ranking; standardmäßig 60 s). Optionales Delta (Standard 1).
exports['Adictos_WebLogs']:Ranking(source, 'Zombies')
exports['Adictos_WebLogs']:Ranking(source, 'pesca')
exports['Adictos_WebLogs']:Ranking(source, 'MisionesDiarias')
exports['Adictos_WebLogs']:Ranking(source, 'Tomate', cantidad)
exports['Adictos_WebLogs']:Ranking(source, 'Zombies', 1) -- deltaBestenliste aus einem Skript lesen (RankingBoard)
Für Pausenmenüs, HUDs oder eigene Skripte kannst du die Top-Liste beim Panel abfragen (dieselbe Bestenliste wie auf Discord). Erfordert WebLogs ≥ 9.6 und dass die Kategorie unter Ranking → Kategorien existiert.
-- Histórico, página 1
exports['Adictos_WebLogs']:RankingBoard('zombies', 1, nil, function(ok, board)
if not ok or type(board) ~= 'table' then return end
for _, e in ipairs(board.entries or {}) do
print(('#%s %s — %s'):format(e.rank, e.player_name, e.score))
end
end)
-- Ranking 7 días (period: 0=histórico, 1=24h, 7, 30)
exports['Adictos_WebLogs']:RankingBoard('pesca', 1, 7, function(ok, board) ... end)
-- Atajo: solo callback (página 1, histórico)
exports['Adictos_WebLogs']:RankingBoard('zombies', function(ok, board) ... end)
exports['Adictos_WebLogs']:RankingFlush() -- forzar envío de puntos pendientes
exports['Adictos_WebLogs']:RankingPendingCount() -- cuántos hay en caché| Feld des Boards | Inhalt |
|---|---|
entries[] | Jede Zeile: rank, player_name, score, license |
total / page / pages | Seitenumbruch (Zeilen pro Seite = Ranking → Embed) |
period_days | 0 gesamt · 1 24h · 7 · 30 |
period_label | Lesbarer Text des aktiven Zeitraums |
category | Metadaten (Bezeichnung, Emoji, Quelle Export/Inventar) |
zombies, pesca…). WebLogs wandelt ihn in Kleinbuchstaben um. Das Panel cacht das Board einige Sekunden (Panel Settings → RankingBoard-Cache, Standard 15 s) für Pausenmenüs mit vielen Spielern; der Cache wird ungültig, sobald neue Punkte eintreffen. Live-Inventarkategorien (ox/qb) werden nicht gecacht.So sieht das Embed aus
Öffentliche Nachricht (Standardkategorie, erste Seite). Farbe und Fußzeile bearbeitest du unter Ranking → Embed.
Carlos — 1.234María — 890Luis — 512Ana — 120Pedro — 98Fehlerbehebung
| Problem | Was prüfen |
|---|---|
| Punkte steigen nicht | WebLogs ≥ 9.6, Ranking-Modul AN, Export mit der source des Spielers, Flush in den Panel Settings |
| Embed wird nicht veröffentlicht | DiscordBot verbunden; Textkanal; der Bot darf Embeds und Buttons senden |
| Buttons reagieren nicht | Interactions Endpoint URL des Bots zeigt auf das Panel (wie bei Gewinnspielen) |
| 401 Unauthorized beim Veröffentlichen | Ungültiger Bot-Token. Panel Settings → Discord: Füge den Bot Token ein (Bot → Reset Token), nicht den Public Key. Lade den Bot unter Meine Server → DiscordBot ein. |
| Inventar bei 0 | Wähle die Quelle ox_inventory/qb_inventory und das richtige Item; dieselbe MySQL wie das Panel. Oder nutze Export und rufe Ranking(src, Schlüssel) auf. |