Wiki / Core Features / Leveling & XP / Levels importeren vanuit een andere bot

Levels importeren vanuit een andere bot

Bijgewerkt door Maxime_48 · 2 uur geleden · Weergaven: 117

Talen: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

Van levelingbot wisselen betekent normaal dat je je community moet vertellen dat iedereen weer op level 0 staat. Dat hoeft niet. Open Leveling XP → Importeren in het paneel en haal de XP van je leden over - rechtstreeks van MEE6, of uit een JSON-export van een andere levelingbot.

Er wordt niets geschreven voordat je een voorbeeld hebt gezien en hebt bevestigd.

Kom je specifiek van MEE6? Van MEE6 naar YAWBDB overstappen loopt de hele overstap door, niet alleen het importscherm.

Het tabblad Importeren van de pagina Leveling met de bronkeuze, het veld voor de server-ID en de knop Voorbeeld gemarkeerd

  1. Kies de bron: MEE6 of een JSON-bestand.
  2. Vul de Discord-server-ID bij MEE6 in.
  3. Voorbeeld toont wat er zou worden geïmporteerd. Er wordt niets geschreven voordat je bevestigt.

📥 Importeren vanuit MEE6

Kies MEE6, vul de Discord-server-ID in (die van jou is al ingevuld) en klik op Voorbeeld.

De MEE6-ranglijst moet openbaar zijn. Zet in het MEE6-dashboard "Make my server's leaderboard public" aan. Zonder dat weigert MEE6 de gegevens te geven en stopt de import met een uitleg in plaats van een stil half resultaat.

Je kunt importeren van een andere server dan degene die je configureert - plak gewoon de ID van die server. Handig als je twee communities samenvoegt.

Het voorbeeld toont hoeveel leden zijn gevonden, hoeveel van hen hier al XP hebben, en een steekproef van de top van de ranglijst.


📄 Importeren uit een JSON-bestand

De openbare API van Amari is stopgezet en de meeste andere levelingbots hadden er nooit een, dus de tweede route is een bestand. Kies JSON-bestand en upload een export.

De parser is bewust coulant. Hij accepteert:

  • een gewone JSON-array met leden,
  • een object met een players-array (een ruw MEE6-antwoord werkt zoals het is),
  • een object met een data-array (de vorm die Amari gebruikte - XP als tekenreeks is prima),
  • en de gebruikelijke veldaliassen: id / user_id / discord_id, en xp / exp / experience.

Elke invoer heeft maar twee dingen nodig om bruikbaar te zijn: een Discord-gebruikers-ID en een XP-hoeveelheid. Invoer waaraan een van beide ontbreekt, wordt overgeslagen in plaats van het hele bestand te laten mislukken.

Als het bestand ook rolbeloningen bevat (role_rewards of rewards), worden die ook meegenomen.

De omweg heen en terug is ingebouwd: ↓ JSON-export bij Leveling XP → Ranglijst levert een bestand in precies deze vorm, inclusief de players-array. Exporteer van de ene server, importeer in een andere - of bewaar het als back-up die je zo weer kunt inladen. Zie Rangkaart en openbare ranglijst.


📐 De levelcurve - de ene beslissing die je moet lezen

Twee bots kunnen precies dezelfde XP bijhouden en toch verschillende levels tonen, omdat het level slechts een opzoeking op een curve is, en niet elke bot dezelfde curve gebruikt.

MEE6 rekent 5·l² + 50·l + 100 XP om level l te verlaten. De formule van YAWBDB heeft dezelfde vorm, maar is geïndexeerd op het level dat je bereikt. Het praktische gevolg: MEE6-XP importeren op onze standaardvoorinstelling laat elk lid precies één level zakken. Hun XP blijft onaangeroerd en correct - ze komt alleen één trede lager uit.

Het voorbeeld meet dat dus op je echte gegevens en zegt het duidelijk, bijvoorbeeld: "412 van de 900 leden die we konden vergelijken zouden hier van level veranderen - tot 1 level lager."

Dan kies je:

  • Je eigen curve behouden - XP wordt exact geïmporteerd, levels worden herberekend met jouw formule. Leden zien hun getal met één dalen.
  • De curve van de bron gebruiken - YAWBDB zet de formule van deze server op de aangepaste voorinstelling a = 5, b = 40, c = 55, die de curve van MEE6 tot op de XP nauwkeurig reproduceert. Iedereen behoudt het level dat hij had.

De curve overnemen is een instelling voor de hele server, dus ze herberekent ook het level van leden die er vóór de import al waren. Hun XP wordt nooit gewijzigd - alleen het level waar ze op uitkomt. Dat is bewust: de helft van de ranglijst op de oude formule laten staan zou op een bug lijken.

Als je server al een curve gebruikt die identiek is aan die van MEE6, wordt de vraag helemaal niet gesteld.


⚙️ Leden die hier al XP hebben

Kies wat er bij een botsing gebeurt:

Optie Wat het doet
Hoogste XP behouden Importeert alleen als de bron meer heeft. De veiligste optie en de standaard.
Vervangen door de geïmporteerde XP De bron wint, ook als die lager is.
Ongemoeid laten Alleen leden die hier helemaal geen XP hebben, worden geïmporteerd.

Leden die in de import staan maar hier nooit iets hebben gezegd, worden nooit door XP-verval geraakt totdat ze echt actief worden: een import start geen verfalklok.


🎖️ Rolbeloningen

Als de bron rolbeloningen toont, kun je ze tegelijk importeren. Elke beloning wordt aan je beloningsgrafiek toegevoegd als een paar "level bereikt → rol toewijzen".

Bestaande paden worden eerst gecontroleerd, dus een import opnieuw uitvoeren stapelt geen dubbele takken op je canvas. Als je beloningsgrafiek zijn limiet voor knooppunten heeft bereikt, vult de import wat kan en vertelt hoeveel er zijn toegevoegd van hoeveel er werden gevonden.


🔕 Wat een import niet doet

Een import is een gegevensmigratie, geen live gebeurtenis:

  • er worden geen level-upberichten verstuurd, hoeveel levels een lid ook erbij krijgt,
  • er wordt geen beloning met terugwerkende kracht geactiveerd - de grafiek wordt niet opnieuw afgespeeld over de geïmporteerde geschiedenis,
  • geïmporteerde rolbeloningen gelden vanaf het volgende level dat een lid bereikt.

Dit is bewust. Duizenden level-ups tegelijk aankondigen zou de server overspoelen, en rollen aanvullen voor een hele ranglijst is zelden wat je echt wilt.


⏳ Terwijl het draait

Grote ranglijsten worden op de achtergrond geïmporteerd. De pagina toont een voortgangsbalk en je kunt hem sluiten: de import loopt door en de voortgang is er nog als je terugkomt.

Als hij klaar is, krijg je een overzicht: toegevoegde, bijgewerkte en overgeslagen leden, en geïmporteerde rolbeloningen.

Per server kan er maar één import tegelijk draaien.


👍 Aanbevolen volgorde

  1. Configureer eerst Leveling (XP-snelheden, wachttijd, level-upkanaal).
  2. Voer het Voorbeeld uit en lees de curvevergelijking.
  3. Beslis over de curve voordat je importeert: als je haar achteraf wijzigt, verschuift het level van elk lid opnieuw.
  4. Importeer en controleer dan Leveling XP → Ranglijst.
  5. Voeg beloningen toe of pas ze aan in de beloningsgrafiek.