Wiki / Core Features / Livelli e XP / Importare i livelli da un altro bot

Importare i livelli da un altro bot

Aggiornato da Maxime_48 · 1 ora fa · Visualizzazioni: 107

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

Cambiare bot di livelli di solito significa dire alla tua community che tutti tornano al livello 0. Non devi farlo. Apri Livelli → Importa nel pannello e porta con te gli XP dei tuoi membri: direttamente da MEE6, oppure da un export JSON di qualsiasi altro bot di livelli.

Non viene scritto nulla finché non hai visto un'anteprima e confermato.

Vieni proprio da MEE6? Passare da MEE6 a YAWBDB ti accompagna in tutto il passaggio, non solo nella schermata di importazione.

La scheda Importa della pagina Livelli con la scelta dell'origine, il campo dell'ID del server e il pulsante Anteprima evidenziati

  1. Scegli l'origine: MEE6 o un file JSON.
  2. Inserisci l'ID del server Discord su MEE6.
  3. Anteprima mostra cosa verrebbe importato. Non viene scritto nulla finché non confermi.

📥 Importare da MEE6

Scegli MEE6, inserisci l'ID del server Discord (il tuo è già compilato) e premi Anteprima.

La classifica di MEE6 deve essere pubblica. Nella dashboard di MEE6, attiva "Make my server's leaderboard public". Senza, MEE6 rifiuta di consegnare i dati e l'importazione si ferma con una spiegazione invece di un risultato parziale e silenzioso.

Puoi importare da un server diverso da quello che stai configurando: basta incollare l'ID di quel server. Utile se stai unendo due community.

L'anteprima mostra quanti membri sono stati trovati, quanti di loro hanno già XP qui e un campione della parte alta della classifica.


📄 Importare da un file JSON

L'API pubblica di Amari è stata chiusa e la maggior parte degli altri bot di livelli non ne ha mai avuta una, quindi la seconda via è un file. Scegli File JSON e carica un export.

Il parser è volutamente tollerante. Accetta:

  • un semplice array JSON di membri,
  • un oggetto che contiene un array players (una risposta grezza di MEE6 funziona così com'è),
  • un oggetto che contiene un array data (la forma usata da Amari: va bene anche l'XP come stringa),
  • e i soliti alias dei campi: id / user_id / discord_id e xp / exp / experience.

Ogni voce ha bisogno solo di due cose per essere utilizzabile: un ID utente Discord e una quantità di XP. Le voci a cui manca una delle due vengono saltate invece di far fallire l'intero file.

Se il file contiene anche ricompense di ruolo (role_rewards o rewards), vengono recuperate anche quelle.

Il percorso di andata e ritorno è integrato: ↓ Esporta JSON di Livelli → Classifica produce un file esattamente in questa forma, array players compreso. Esporta da un server, importa in un altro, oppure tienilo come backup da riportare subito dentro. Vedi Scheda di rango e classifica pubblica.


📐 La curva dei livelli: l'unica decisione che vale la pena leggere

Due bot possono contenere esattamente gli stessi XP e mostrare comunque livelli diversi, perché il livello è solo una ricerca su una curva, e non tutti i bot usano la stessa.

MEE6 richiede 5·l² + 50·l + 100 XP per lasciare il livello l. La formula di YAWBDB ha la stessa forma ma è indicizzata sul livello che si sta raggiungendo. La conseguenza pratica: importare gli XP di MEE6 sul nostro preset predefinito fa scendere esattamente di un livello ogni membro. I loro XP sono intatti e corretti: semplicemente corrispondono a un gradino più in basso.

Per questo l'anteprima lo misura sui tuoi dati reali e te lo dice chiaramente, per esempio: "412 dei 900 membri che abbiamo potuto confrontare cambierebbero livello qui: fino a 1 livello in meno."

Poi scegli:

  • Mantieni la tua curva: gli XP vengono importati esattamente, i livelli vengono ricalcolati con la tua formula. I membri vedono il loro numero scendere di uno.
  • Usa la curva dell'origine: YAWBDB porta la formula di questo server sul preset personalizzato a = 5, b = 40, c = 55, che riproduce la curva di MEE6 fino all'ultimo XP. Tutti mantengono il livello che avevano.

Adottare la curva è un'impostazione a livello di server, quindi ricalcola anche il livello dei membri che c'erano già prima dell'importazione. I loro XP non vengono mai modificati, solo il livello a cui corrispondono. È voluto: lasciare metà della classifica sulla vecchia formula sembrerebbe un bug.

Se il tuo server usa già una curva identica a quella di MEE6, la domanda non viene proprio posta.


⚙️ Membri che hanno già XP qui

Scegli cosa succede in caso di collisione:

Opzione Cosa fa
Tieni l'XP più alto Importa solo se l'origine ne ha di più. L'opzione più sicura e quella predefinita.
Sostituisci con l'XP importato Vince l'origine, anche se è più basso.
Non toccarli Vengono importati solo i membri che qui non hanno XP.

I membri che sono nell'importazione ma non hanno mai scritto qui non sono mai colpiti dal decadimento XP finché non diventano davvero attivi: un'importazione non fa partire un conto alla rovescia di decadimento.


🎖️ Ricompense di ruolo

Se l'origine espone ricompense di ruolo, puoi importarle contemporaneamente. Ognuna viene aggiunta al tuo Grafico premi come una coppia «livello raggiunto → assegna ruolo».

I percorsi esistenti vengono controllati prima, quindi rifare un'importazione non impila rami duplicati sulla tua tela. Se il tuo grafico premi è al limite di nodi, l'importazione riempie ciò che può e ti dice quante ne sono state aggiunte su quante ne aveva trovate.


🔕 Cosa non fa un'importazione

Un'importazione è una migrazione di dati, non un evento in tempo reale:

  • nessun messaggio di salita di livello viene inviato, per quanti livelli guadagni un membro,
  • nessuna ricompensa viene attivata retroattivamente: il grafico non viene rieseguito sulla cronologia importata,
  • le ricompense di ruolo importate si applicano dal prossimo livello che un membro raggiunge.

È voluto. Annunciare migliaia di salite di livello in una volta inonderebbe il server, e assegnare retroattivamente i ruoli a un'intera classifica raramente è ciò che vuoi davvero.


⏳ Mentre procede

Le classifiche grandi vengono importate in background. La pagina mostra una barra di avanzamento e puoi chiuderla: l'importazione continua e l'avanzamento c'è ancora quando torni.

Quando finisce ottieni un riepilogo: membri aggiunti, aggiornati, saltati e ricompense di ruolo importate.

Può essere in corso una sola importazione alla volta per server.


👍 Ordine consigliato

  1. Configura prima i Livelli (tassi di XP, attesa, canale delle salite di livello).
  2. Esegui l'Anteprima e leggi il confronto delle curve.
  3. Decidi la curva prima di importare: cambiarla dopo significa che il livello di ogni membro si sposta di nuovo.
  4. Importa, poi controlla Livelli → Classifica.
  5. Aggiungi o regola le ricompense nel Grafico premi.