croc-prog-github / probability-manager.js

Una semplice libreria per JS che semplifica la gestione della probabilità, soprattutto per il riscatto di ricompense nei videogame.

Probability Manager.js

Una semplice libreria per JS che semplifica la gestione della probabilità, soprattutto per il riscatto di ricompense nei videogame.

---

Spiegazione

Istanze: Dentro di esse, puoi creare più di una Lista, verranno poi eseguite in ordine crescente in base al nome (cioè un numero > di 0; non possono esserci liste con lo stesso nome).

Liste: Sono un elenco di più Oggetti che possono essere estratti con una certa probabilità, scelta da te.

Oggetti: Un oggetto è una variabile, solitamente una stringa di caratteri di testo (esempio: Moneta d'oro), associato a una valore in percentuale (cioè la probabilità di essere estratto).
In una Lista, puoi aggiungere tutti gli Oggetti che vuoi, a condizione che la somma di tutti i valori in percentuale sia uguale a 100.

Utilizzo

Per utilizzare la libreria segui i passaggi sottostanti.

1. Scarica il file libreria (dall'ultimo Relase stabile) in base al linguaggio che utilizzi: JavaScript oppure TypeScript
2. Sposta il file nella directory del tuo progetto.
3. In un altro file Js o Ts, inserisci in alto la stringa: const probManager = new ProbabilityManager(); per dichiarare l'utilizzo della libreria.
4. Inizia a scrivere codice, usando i comandi illustrati appena sotto.

Comandi

In questa sezione sono specificati tutti i comandi utilizzabili, con la loro relativa spiegazione.

probManager.constructor() Viene utilizzato per creare un'istanza ProbabilityManager che gestirà le varie liste e oggetti con le loro probabilità.

probManager.addList(instanceName, listName) Aggiunge una nuova lista all'interno di una specifica istanza. Se l'istanza o la lista non esiste, viene creata. Le liste sono ordinate ed eseguite in ordine crescente: il nome deve essere un numero intero > di 0.

• instanceName: Il nome dell'istanza.
  
• listName: Il nome della lista da aggiungere (deve essere un numero intero > 0).

probManager.addObject(instanceName, listName, object, probability) Aggiunge un oggetto ad una lista all'interno di una specifica istanza con una determinata probabilità. La somma delle probabilità di tutti gli oggetti in una lista deve essere pari a 100.
Supporta anche la possibilità di inserire come Oggetti dei range di valori numerici, dichiarati così, ad esempio: 1-100. La probabilità è assegnata ad ogni numero del range di numeri, in modo Direttamente Proporzionale auto_InversProp o Inversamente Proporzionale auto_DirectProp al numero maggiore o minore.

• instanceName: Il nome dell'istanza.
  
• listName: Il nome della lista (cioè un numero int > 0) a cui aggiungere l'oggetto.
  
• object: Il nome dell'oggetto da aggiungere. Può essere anche un range di numeri.
  
• probability: La probabilità dell'oggetto di essere estratto, espresso in valore numerico. Può essere espresso come stringa: auto_InversProp o auto_DirectProp per assegnare la percentuale ad un range di numeri

probManager.getRandomObject(instanceName, listName) Estrae un oggetto casuale da una lista all'interno di una specifica istanza, basandosi sulle probabilità degli oggetti nella lista.

• instanceName: Il nome dell'istanza.
  
• listName: Il nome della lista da cui estrarre l'oggetto.

probManager.clearInstance(instanceName) Rimuove tutte le liste e gli oggetti associati a una specifica istanza.

• instanceName Il nome dell'istanza da rimuovere.

probManager.clearAll() Rimuove tutte le istanze, insieme a tutte le liste e gli oggetti associati.

probManager.toArray() Converte tutte le istanze in array bidimensionali per semplificarne la gestione.

probManager.toArrayForInstance(instanceName) Converte solo una specifica istanza in un array bidimensionale per semplificarne la gestione.

• instanceName: Il nome dell'istanza da convertire