JuByteNexus – Modul-Katalog
Vollständige Referenz aller mitgelieferten Module: Endpoints, Permissions,
Events und Config-Optionen. Modul-Endpunkte liegen unter
/api/v1/modules/<id>/…. Premium-Module benötigen ein Lizenz-Entitlement
(siehe Lizenz-API). Endpunkte ohne Permission sind
öffentlich bzw. nur authentifiziert (UCP-Self-Service oder token-gesicherte
Adapter-Ingestion).
Moderation
BanSystem — bansystem, premium: nein
Ban/Tempban/Mute/Kick/Warn mit Eskalation, BanID-Katalog, Evidenz und Entbannungsanträgen.
| Methode | Pfad (…/bansystem/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST | bans | bansystem.view / bansystem.ban.create | Strafen filtern / ausstellen |
| PUT/DELETE | bans/{id} · bans/{id}/reason · bans/{id}/purge | bansystem.reason.edit / .ban.revoke / .ban.delete | Bearbeiten / aufheben / löschen |
| GET/POST | appeals · appeals/{id}/decide | bansystem.appeals.manage | Entbannungsanträge |
| GET/POST/PUT/DELETE | reasons[/{id}] | bansystem.catalog.manage (GET: .view) | BanID-Katalog |
| GET/POST/PUT/DELETE | evidence… · evidence/{id}/image | bansystem.evidence (GET: .view) | Evidenz + Bilder |
| GET | me/evidence[/{id}/image] | – (eigentümergebunden) | Spieler-Evidenz (UCP) |
| GET | stats | bansystem.view | Strafstatistiken |
Weitere Punish-Gates: bansystem.punish.{ban,tempban,mute,warn,kick}, .ban.create.custom, .ipban.
Events: pub ban.{created,updated,revoked,deleted,expired}, ban.appeal.{created,decided}, bansystem.catalog.changed; sub chatlog.requested.
Config: escalation.{warn-threshold,tempban-days,stack-percent}, appeals.max-open, ip.enforce-bans.
ReportSystem — reportsystem, premium: nein
Ingame-/report → Live-Inbox, Claim/Resolve, Spam-Schutz, Eskalation ins BanSystem.
| Methode | Pfad (…/reports/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST | my | – (UCP) | Eigene Reports / einreichen |
| GET | `` · stats · {id}/chatlog | reports.view | Inbox / Statistik / Chatverlauf |
| POST | {id}/claim · {id}/resolve · bulk-resolve · {id}/punish | reports.manage | Bearbeiten/Bestrafen |
| GET/POST/DELETE | templates[/{id}] | reports.templates.manage (GET: .view) | Vorlagen |
Events: pub report.{created,claimed,resolved}, templates.changed; sub player.report. Config: spam.max-open-per-reporter.
TicketSystem — ticketsystem, premium: nein
Support-Tickets mit Verlauf, Zuweisung, internen Notizen und Bewertung; optional Entbannungsanträge als Tickets.
| Methode | Pfad (…/tickets/…) | Permission | Zweck |
|---|---|---|---|
| GET | `` · {id} | tickets.view | Inbox / Details (Staff) |
| POST | {id}/{reply,assign,close,priority} | tickets.manage | Bearbeiten (Staff) |
| GET/POST | my[/{id}][/reply,/close,/rating] | – (UCP) | Eigene Tickets |
Events: pub ticket.{created,updated,closed}; sub ban.appeal.created. Config: appeals.create-tickets.
ChatGuard — chatguard, premium: nein
Durchsuchbares Chat-Archiv (DSGVO-Retention) + Filter (Wortlisten/Regex/Caps/Spam) mit Eskalation.
| Methode | Pfad (…/chatguard/…) | Permission | Zweck |
|---|---|---|---|
| GET | messages · rules | chatguard.view | Chat durchsuchen / Regeln |
| POST/PUT/DELETE | rules[/{id}] | chatguard.manage | Filterregeln |
Events: pub chatguard.flagged; sub player.chat, config.changed. Config: retention-days/minutes, max-entries, filter.enabled, caps.{min-length,percent}, escalation.mute-minutes.
AntiCheat-Hub — anticheat-hub, premium: ja
Violations externer Anticheats korrelieren und eskalieren.
| Methode | Pfad (…/anticheat-hub/…) | Permission | Zweck |
|---|---|---|---|
| POST | violations | anticheat.report | Adapter pusht Violations |
| GET | violations | anticheat.view | Violations ansehen |
| POST | violations/{id}/review | anticheat.manage | Bewerten |
Events: pub anticheat.{violation,escalated,reviewed}. Config: correlation.window-hours, escalation.{threshold,tempban-hours}.
Staff Notes — staffnotes, premium: nein
Internes Team-Wiki/Knowledge-Base (nur Staff).
| Methode | Pfad (…/staffnotes/…) | Permission | Zweck |
|---|---|---|---|
| GET | `` | staffnotes.view | Notizen lesen |
| POST/PUT/DELETE | [/{id}] | staffnotes.manage | Schreiben/Bearbeiten/Löschen |
Config: limits.max-pinned, limits.body-max-length.
AuditPlus — auditplus, premium: nein
Forensik-Ingestion (CoreProtect-Logs, Inventar-Snapshots, Block-Events), token-gesicherte Adapter-API.
| Methode | Pfad (…/auditplus/…) | Permission | Zweck |
|---|---|---|---|
| POST | ingest | X-Audit-Token | Adapter pusht Events |
| GET | `` | auditplus.view | Events durchsuchen |
Config: ingest.token (secret), retention.days.
Community & Engagement
Vote & Rewards — votes, premium: nein
Serverlisten-Votes mit Streaks, Top-Voter, Dank-Broadcasts.
| Methode | Pfad (…/votes/…) | Permission | Zweck |
|---|---|---|---|
| POST | hook/{siteId} | – (Token) | Vote-Callback der Serverliste |
| GET | sites | – | Vote-Links + eigene Statistik (UCP) |
| GET/POST/DELETE | admin/sites[/{id}] | votes.manage (GET: .view) | Vote-Seiten verwalten |
| GET | admin/top | votes.view | Top-Voter |
Events: pub vote.received. Config: broadcast.enabled, message.thanks.
Shop — shop, premium: ja
UCP-Storefront + Command-Queue-Auslieferung mit Zustellgarantie.
| Methode | Pfad (…/shop/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST | catalog · orders · orders/my | – (UCP) | Katalog / bestellen / eigene Bestellungen |
| GET/POST/DELETE | admin/products[/{id}] | shop.manage (GET: .view) | Produkte |
| GET/POST | admin/orders[/{id}/mark-paid,/cancel] | shop.manage (GET: .view) | Bestellungen |
| POST | webhook | – (HMAC) | PSP-Zahlungs-Webhook |
Events: pub shop.order.{created,paid,cancelled,delivered}. Config: payments.sandbox, currency, payments.webhook-secret (secret).
Achievements — achievements, premium: nein
Event-getriebene Erfolge mit Fortschritt, Kategorien, Showcase.
| Methode | Pfad (…/achievements/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/PUT/DELETE | [/{id}] | achievements.manage (GET: .view) | Definitionen (ACP) |
| GET/PUT | me · showcase | – (UCP) | Eigener Fortschritt / Showcase (max 4) |
Events: sub diverse Trigger (z. B. player.join, vote.received), pub achievement.unlocked.
News & Events — news, premium: nein
ACP-gepflegte Posts, öffentlicher Feed.
| Methode | Pfad (…/news/…) | Permission | Zweck |
|---|---|---|---|
| GET | `` · feed | news.view / – | Alle (inkl. Drafts) / öffentlicher Feed |
| POST/PUT/DELETE | [/{id}] | news.manage | Posts |
Events: pub news.published.
Announcements — announcements, premium: nein
Geplante Broadcasts/Titel mit Rotation pro Server-Gruppe.
| Methode | Pfad (…/announcements/…) | Permission | Zweck |
|---|---|---|---|
| GET | `` | announcements.view | Rotation ansehen |
| POST/PUT/DELETE | [/{id}] · {id}/broadcast · rotate | announcements.manage | Verwalten/Broadcasten |
Config: rotation.enabled, rotation.interval-seconds.
Polls — polls, premium: nein
Community-Umfragen; Ergebnisse erst nach Abstimmung/Schließung.
| Methode | Pfad (…/polls/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | [/{id}] · {id}/close | polls.manage (GET: .view) | Umfragen (ACP) |
| GET/POST | open · {id}/vote | – (UCP) | Offene Umfragen / abstimmen |
Config: options.max-per-poll, limits.max-open.
Giveaways — giveaways, premium: nein
Verlosungen mit Teilnahme und Gewinnerziehung.
| Methode | Pfad (…/giveaways/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | [/{id}] · {id}/draw · {id}/close | giveaways.manage (GET: .view) | Verlosungen (ACP) |
| GET/POST | open · {id}/enter | – (UCP) | Offene / teilnehmen |
Config: limits.max-open, defaults.duration-hours.
Ideas — ideas, premium: nein
Vorschläge mit Upvotes und Status-Triage.
| Methode | Pfad (…/ideas/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | `` · {id}/status · {id} | ideas.manage (GET: .view) | Triage (ACP) |
| GET/POST | board · `` · {id}/vote | – (UCP) | Board / einreichen / upvoten |
Config: limits.max-open-per-account, submission.min-title-length, voting.enabled.
Applications — applications, premium: nein
Team-Bewerbungen mit Formularen und Entscheidung.
| Methode | Pfad (…/applications/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | forms[/{id}][/close] | applications.manage (GET: .review) | Formulare |
| GET/POST | queue · {id}/decide | applications.review | Warteschlange / entscheiden |
| GET/POST | open · mine · forms/{id}/apply | – (UCP) | Bewerben |
Events: pub application.{submitted,reviewed}. Config: limits.max-pending-per-account, limits.cooldown-hours, review.require-note-on-reject.
Daily Rewards — dailyrewards, premium: nein
Tägliche Belohnung mit Streak und Belohnungsleiter (Auslieferung via PlayerActions).
| Methode | Pfad (…/dailyrewards/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | tiers[/{id}] | dailyrewards.manage (GET: .view) | Leiter (ACP) |
| GET/POST | status · claim | – (UCP) | Status / beanspruchen |
Events — events, premium: nein
Events mit RSVP/Anmeldung (optional kapazitätsbegrenzt).
| Methode | Pfad (…/events/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | `` · {id}/cancel · {id} · {id}/attendees | events.manage (GET: .view) | Events (ACP) |
| GET/POST | upcoming · {id}/rsvp | – (UCP) | Kommende / anmelden |
Config: defaults.capacity, creation.reject-past-start.
Directory — directory, premium: nein
Kuratiertes Spielmodi-/Server-Verzeichnis fürs UCP.
| Methode | Pfad (…/directory/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/PUT/DELETE | [/{id}] | directory.manage (GET: .view) | Einträge (ACP) |
| GET | browse | – | Durchsuchen (UCP) |
Promo Codes — promocodes, premium: nein
Einlösbare Codes mit Belohnung, Limit und Ablauf.
| Methode | Pfad (…/promocodes/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | [/{id}] | promocodes.manage (GET: .view) | Codes (ACP) |
| POST | redeem | – (UCP) | Einlösen |
Kits — kits, premium: nein
Abholbare Kits mit Cooldown.
| Methode | Pfad (…/kits/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | [/{id}] | kits.manage (GET: .view) | Kits (ACP) |
| GET/POST | available · {id}/claim | – (UCP) | Verfügbar / beanspruchen |
Config: defaults.cooldown-minutes, limits.max-kits.
JuByteCase — jubytecase, premium: nein
Panel-Begleiter des eigenständigen JuByteCase-Plugins: CaseLog, Statistiken,
Case-Bestände (anzeigen/vergeben/entfernen), Seltenheiten-Verwaltung und
simulierte Testläufe; im UCP sehen Spieler ihre eigenen Statistiken, Bestände
und ihren eigenen CaseLog. Die Integration steckt direkt im Plugin (REST-Push
— läuft die JuByteNexusBridge auf demselben Server, verbindet sich das
Plugin vollautomatisch über deren Server-Key (X-Bridge-Key); es gibt
keinerlei manuelle Konfiguration (kein Token, keine URL). Panel-Änderungen
holt sich das Plugin beim nächsten Sync ab.
JuByteNexus ist keine Pflicht — ohne Panel läuft das Plugin unverändert weiter.
| Methode | Pfad (…/jubytecase/…) | Permission | Zweck |
|---|---|---|---|
| POST | ingest/{openings,sync,balances,ack} | – (X-Bridge-Key der NexusBridge) | Plugin-Push: CaseLog, Config-Snapshot, Bestände, Änderungs-Bestätigung |
| GET | log · overview · cases · rarities · balances | jubytecase.view | CaseLog / Statistiken / Cases / Seltenheiten / Bestände |
| PUT | rarities | jubytecase.manage | Seltenheit ändern (für nächsten Plugin-Sync eingeplant) |
| POST | balances/change | jubytecase.manage | Cases vergeben/entfernen (führt das Plugin beim Sync aus) |
| POST | testrun | jubytecase.testrun | Simulierte Öffnungen (echte Roll-Logik, ohne Nebenwirkungen) |
| GET | me · me/log | – (UCP) | Eigene Statistiken, Bestände und eigener CaseLog |
Events: pub jubytecase.{opened,synced,rarity.updated,cases.changed,testrun.completed}.
Config: log.retention-days, testrun.max-iterations.
Friends — friends, premium: nein
Netzwerkweite Freundesliste mit Online-Status, Anfragen, Block-Liste.
| Methode | Pfad (…/friends/my…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/DELETE | my · my/requests[/{id}/accept,/decline] · my/{id} · my/block | – (UCP) | Freunde verwalten |
Permission: friends.view (Support). Config: max-friends.
Levels & XP — levels, premium: nein
Event-getriebenes XP/Level-System (Joins/Votes/Achievements).
| Methode | Pfad (…/levels/…) | Permission | Zweck |
|---|---|---|---|
| GET | me · leaderboard | – | Eigenes Level / öffentliches Leaderboard |
| GET | player/{id} · top | levels.view | Spieler-Level / Top (ACP) |
Events: sub player.join, vote.received, achievement.unlocked. Config: xp.{join,vote,achievement}, level.base.
System & Infrastruktur
Statistics — statistics, premium: nein
Netzwerk-Analytics (ACP), persönliche Stats (UCP), öffentliche Leaderboards.
| Methode | Pfad (…/stats/…) | Permission | Zweck |
|---|---|---|---|
| GET | overview · export | stats.view | Analytics / CSV |
| GET | leaderboard · me | – | Leaderboard / eigene Stats |
Events: sub player.join, player.quit. Config: leaderboard.public, leaderboard.size.
Maintenance — maintenance, premium: nein
Wartungsmodus mit Kick-Screen + Whitelist (auch zeitlich begrenzt).
| Methode | Pfad (…/maintenance/…) | Permission | Zweck |
|---|---|---|---|
| GET | state · public | maintenance.view / – | Status |
| GET/POST/DELETE | whitelist[/{id}] · windows[/{id}] | maintenance.manage (GET: .view) | Whitelist / Zeitfenster |
Events: sub player.join (Whitelist-Prüfung). Config: maintenance.{enabled,message,scheduled-at}.
Cloud & Network — cloud, premium: nein
Live-Topologie dynamischer Cloud-Netzwerke (CloudNet u. a.) via token-gesichertem Heartbeat.
| Methode | Pfad (…/cloud/…) | Permission | Zweck |
|---|---|---|---|
| POST | report | – (X-Cloud-Token) | Connector-Heartbeat |
| GET | overview · scaling | cloud.view | Topologie / Scaling-Regeln |
| POST/PUT/DELETE | provision · services/{id}/stop · services/{id} · scaling[/{id}] | cloud.manage | Services / Auto-Scaling |
Config: report.token (secret), service.ttl-seconds, prune.after-seconds.
Notifications — notifications, premium: nein
In-Panel-Benachrichtigungen im UCP, gespeist aus vorhandenen Events.
| Methode | Pfad (…/notifications/me…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/PUT | me · me/unread-count · me/{id}/read · me/read-all · me/mutes | – (UCP) | Posteingang / Glocke / Stummschaltung |
Events: sub u. a. ticket.*, report.created, ban.appeal.created, shop.order.delivered, friend.*, application.*, server.alert, approval.requested, scheduler.run.failed.
Config: retention.max-per-account, team.notify-*.
Scheduler — scheduler, premium: nein
Cron-gesteuerte Server-Befehle (Due-Runner → scheduler.run → Bridge).
| Methode | Pfad (…/scheduler/…) | Permission | Zweck |
|---|---|---|---|
| GET/POST/PUT/DELETE | [/{id}] | scheduler.manage (GET: .view) | Befehle |
| POST | {id}/run · run-due · preview | scheduler.manage | Sofort/fällig ausführen, Vorschau |
| GET | stats · {id}/runs · runs · runs/{runId}/servers | scheduler.view | Run-Historie |
Config: retry.{enabled,max-attempts,backoff-seconds}, retention.days.
PlayerData — playerdata, premium: nein
Geräte-Fingerprints & Inventar-Snapshots pro Spieler (token-gesicherte Ingestion).
| Methode | Pfad (…/playerdata/…) | Permission | Zweck |
|---|---|---|---|
| POST | ingest/{device,inventory} | – (X-PlayerData-Token) | Adapter pusht Telemetrie |
| GET | devices · inventory | playermanagement.{devices,inventory}.view | Ansehen (ACP) |
| POST | inventory/{give,clear,set-slot} | playermanagement.inventory.manage | Live-Inventar |
Events: sub player.device, player.inventory. Config: ingest.token (secret), retention.days.