ForumCommunity

Wiki - Lancio dei dadi

    Cos'è


    A partire da maggio 2020 è presente, nei post delle varie discussioni di forum e blog, la possibilità di inserire un lancio di dadi. Si tratta di una funzione che consente, esattamente come quando viene lanciato un dado, di ottenere casualmente dei numeri da 1 a un massimo personalizzabile. L’uso più comune riguarda soprattutto giochi di ruolo, estrazioni, contest e lotterie.

    Attivazione


    Per poter attivare il lancio dei dadi occorre recarsi in Amministrazione > Sito web > Statistiche e opzioni, nel gruppo di opzioni dedicate ai post. Sono presenti tre voci inerenti a questa funzione:
    1. attiva il lancio dei dadi: se spuntata, rende disponibile la funzione nei vari post del forum o blog;
    2. permetti agli admin e mod di cancellare il lancio dei dadi: se attivata, rende possibile la cancellazione dei lanci presenti in un qualsiasi post da parte di amministratori e moderatori (maggiori informazioni nel paragrafo dedicato);
    3. blocca agli utenti la cancellazione di post con dadi: se attivata, inibisce all’utente che ha inviato il post la possibilità di cancellarlo (maggiori informazioni nel paragrafo dedicato). Gli amministratori e i moderatori potranno in ogni caso cancellare il messaggio.



    Utilizzo


    Per lanciare un dado è sufficiente cliccare sull’apposito pulsante Lancio dado presente tra le varie opzioni sopra il box di scrittura.
    Attenzione: per questioni di spazio, di default il pulsante è nascosto graficamente nelle risposte rapide, rimanendo visibile solo nelle pagine di risposta completa e creazione di nuova discussione. Per mostrarlo anche nel form di risposta rapida, è sufficiente aggiungere in Amministrazione > Grafica > Colori e stili il seguente codice:

    CODICE
    .fast.send .dice-button {display: inline!important}

    Analogamente, se si desidera aggiungerlo anche nella versione mobile, è possibile incollare lo stesso codice in Amministrazione > Grafica > Mobile/App.

    Cliccando sul pulsante, viene mostrato un box (c.d. modal) che permette l’inserimento di un lancio di dadi. Le opzioni disponibili sono:
    • descrizione: in questo campo è possibile inserire una descrizione personalizzata che sarà visualizzata come titolo per il lancio effettuato (maggiori informazioni nel paragrafo dedicato);
    • dado: tramite questi campi è possibile specificare il dado da lanciare:
      • nell’input precedente la scritta dadi occorre specificare il numero di volte che si intende lanciare il dado;
      • nell’input precedente la scritta facce occorre inserire il numero di facce (ossia il numero massimo estraibile) che possiede il dado lanciato;
      • cliccando sul pulsante con le tre linee orizzontali è possibile effettuare delle operazioni con i risultati dei lanci indicati nei due campi precedenti. Le operazioni disponibili sono addizione, sottrazione, moltiplicazione e divisione. È possibile effettuare operazioni solo con numeri interi, ad esempio non è possibile aggiungere 3,2 o dividere per 1,7; bensì, continuando l’esempio precedente, si può aggiungere 3 o dividere per 2;
      • cliccando sulla X rossa è possibile annullare l’inserimento del dado corrispondente;
    • pulsante +: cliccando sul pulsante col simbolo +, è possibile aggiungere i campi per predisporre un nuovo dado;
    • inserisci: cliccando questo pulsante, il modal verrà chiuso e nella textarea della risposta sarà aggiunto il codice per eseguire il lancio o i lanci specificati.



    Widget


    L’utilizzo del modal è stato creato al fine di facilitare l’inserimento di uno o più lanci di dadi con esclusivamente le opzioni basilari. In verità, è possibile aggiungere dei lanci utilizzando direttamente l’apposito widget [dice].

    Il suo uso è il seguente:
    1. tutte le opzioni del widget vanno inserite senza spazi;
    2. dopo il simbolo dell’uguale, occorre inserire il numero di lanci da effettuare, seguito dalla lettera d. Di default, il numero è impostato a 1. Ciò significa che, inserendo [dice=d6], verrà effettuato 1 lancio di un dado da 6 facce;
    3. dopo la lettera d, occorre inserire il numero di facce che deve possedere il dado lanciato. Questo numero deve essere obbligatoriamente specificato. Ad esempio, [dice=3d8] effettuerà 3 lanci di un dado da 8 facce ciascuno;
    4. dopo il numero di facce, è possibile inserire un simbolo tra +-*/ che indica un’operazione matematica da eseguire con il risultato del lancio, rispettivamente addizione, sottrazione, moltiplicazione, divisione. Naturalmente, dopo il simbolo dell’operazione si deve specificare il numero intero con cui eseguire tale operazione. Ad esempio [dice=5d6+3] effettuerà 5 lanci di un dado da 6 facce e ad ogni risultato sommerà 3.
    5. successi e fallimenti: in alcuni casi si rende necessario considerare, insieme ai lanci di un dado, una condizione che indica se ciascun lancio è stato un successo o un fallimento sulla base del risultato del lancio stesso. Il meccanismo è piuttosto semplice: viene specificato un numero che rappresenta il minimo richiesto affinché il lancio venga considerato un successo e un altro numero che, al contrario, se ottenuto, rappresenta un fallimento. Esemplificando, lanciando un dado da 10 facce e specificando come successo 6 e come fallimento 1, il risultato del lancio sarà considerato un successo se il numero ottenuto è maggiore (o maggiore o uguale) a 6, mentre sarà considerato un fallimento se il numero ottenuto è esattamente pari a 1. Al momento, non è possibile indicare un range per il fallimento, ossia, ad esempio, "minore o uguale a 3", bensì si deve inserire il numero esatto. Ciò significa che, se viene specificato come fallimento il numero 3, tutti i risultati diversi da 3 non saranno considerati fallimenti. Ogni fallimento elimina un successo: ad esempio lanciando 5 volte un dado da 10 facce e indicando come successo 6 e fallimento 1, supponendo di ottenere i numeri 7, 8, 3, 4, 1, il risultato, dato dalla differenza tra successi e fallimenti, sarà pari a 1, in quanto sono presenti due successi (7 e 8) e un fallimento (1). Se i fallimenti sono maggiori dei successi, il risultato sarà negativo. Per specificare i successi e i fallimenti si utilizza la sintassi [dice=5d10>=6f1], dove dopo il simbolo maggiore o uguale (>=), ovvero, se si desidera, solo maggiore (>), si indica il numero minimo per avere un successo e dopo la lettera f si indica il numero che rappresenta il fallimento;
    6. lancio di più dadi: è possibile lanciare dadi differenti separando ciascun lancio con una virgola. Ad esempio [dice=4d10,3d8] effettuerà 4 lanci di un dado da 10 facce e 3 lanci di un dado da 8 facce, sommando alla fine tutti i risultati;
    7. classe personalizzata: ai fini delle personalizzazioni grafiche (maggiori informazioni nel paragrafo dedicato) è possibile specificare una classe personalizzata che sarà aggiunta all’elemento HTML che racchiude il lancio del dado nel post. Per fare ciò, occorre utilizzare la sintassi class:customclass, dove al posto di customclass si deve inserire il nome della classe da aggiungere: [dice=4d10,class:customclass];
    8. descrizione personalizzata: per inserire una descrizione, è possibile racchiudere il testo tra i tag [dice]. Ad esempio: [dice=5d10]Descrizione[/dice].

    Limiti


    Sono presenti i seguenti limiti ai lanci di dadi:
    • ogni dado può avere al massimo 100 facce e deve avere almeno 2 facce. Pertanto, sintassi come [dice=d1] o [dice=d101] non saranno accettate;
    • ogni dado può essere lanciato al massimo 10 volte. Pertanto, sintassi come [dice=11d50] non saranno accettate;
    • ogni singolo widget (cioè ogni macro-lancio) può contenere al massimo il lancio di 10 dadi differenti. Ciò significa che sintassi come

      CODICE
      [dice=d10,2d20,3d30,4d40,5d50,6d60,7d70,8d80,9d90,10d100,1d8]

      non saranno accettate, in quanto richiedono il lancio di più di 10 dadi. Volendo massimizzare tutti i parametri, il macro-lancio più alto si può ottenere con

      CODICE
      [dice=10d100,10d100,10d100,10d100,10d100,10d100,10d100,10d100,10d100,10d100]

      ossia un macro-lancio che contiene 10 dadi (numero massimo di dadi per macro-lancio) da 100 facce ciascuno (numero massimo di facce per dado), ognuno dei quali viene lanciato 10 volte (numero massimo di volte con cui un singolo dado può essere lanciato);
    • ogni post può contenere al massimo 5 macro-lanci (ossia 5 widget [dice] distinti).

    Lettura dei risultati ottenuti


    Graficamente, il lancio di dadi senza successi e fallimenti, dopo aver cliccato sulla riga del lancio per visualizzarne i dettagli, si presenta in questo modo (widget utilizzato per generare l'esempio: [dice=5d10,6d20]):



    Al posto di Lancio dado verrà inserita la descrizione personalizzata, se specificata. Il numero in grassetto accanto alla descrizione indica il valore totale ottenuto da tutti i lanci effettuati. Ogni lancio, rappresentato da un punto dell’elenco, contiene informazioni in merito al dado lanciato, al numero di lanci effettuati e ai risultati ottenuti. Se sono state effettuate operazioni, queste verranno specificate tra parentesi, come di seguito (widget utilizzato per generare l'esempio: [dice=5d10+3,6d20]):



    Infine, viene specificata la data e l’ora in cui è stato effettuato il lancio, nonché il nickname dell’utente che lo ha inserito, utile soprattutto nel caso in cui chi inserisce il dado non coincide con l’autore del post, ma, ad esempio, si tratta di un moderatore o amministratore del forum.
    Se, al contrario, sono stati specificati i parametri per i successi e i fallimenti, graficamente il lancio si presenta come di seguito (widget utilizzato per generare l'esempio: [dice=5d10>=6f1,6d20>=12f1]):



    Tra le parentesi quadre nella legenda saranno riepilogati il numero di successi, quello di fallimenti e il risultato ottenuto dalla differenza tra successi e fallimenti.

    Controlli di sicurezza


    Al fine di evitare che si possa barare lanciando un dado, sono stati inseriti una serie di controlli di sicurezza per garantire l’attendibilità di un lancio presente in un post:
    • un lancio di dadi non è mai modificabile. Sia l’autore del post che gli amministratori o moderatori del forum non possono in alcun modo modificare un lancio già effettuato. Ciò significa che, per verificare in modo immediato se un lancio è veritiero, è sufficiente cliccare sul pulsante di modifica del post: se il lancio non compare nel testo modificabile, allora è corretto, in caso contrario è un lancio fasullo. Una volta lanciato, infatti, un dado non compare mai nel box di modifica di un post;



    • il lancio di un dado viene inserito sempre in fondo al post di riferimento. Nel caso in cui sia presente la scritta Modificato da... per i post modificati, il lancio comparirà sotto tale scritta. Se un lancio è visualizzato in mezzo al contenuto del post, allora non è un lancio veritiero;
    • nel caso in cui prima di inviare un post ne venga visualizzata l’anteprima, il lancio verrà effettuato e verrà visualizzato il risultato. Tuttavia, si tratta di un lancio c.d. mock-up, ovvero, una volta inviato effettivamente il post, il lancio sarà effettuato nuovamente, con un risultato di conseguenza differente. Non vi è quindi alcun modo di sapere in anticipo, prima di inviare il messaggio, il risultato di un lancio di dadi;
    • se viene abilitata l’apposita opzione, gli amministratori e i moderatori possono, dalla pagina di modifica del post, rimuovere il lancio di un dado. Non possono in ogni caso modificare il lancio, bensì solo rimuoverlo tramite l'apposito checkbox;



    • se viene abilitata l’apposita opzione, all’utente che ha inviato il post con un lancio di dadi viene inibita la possibilità di cancellare quel post. Questa scelta è stata effettuata al fine di evitare che, una volta inviato un post con un dado, tale post venga rimosso e sostituito con uno identico, ma con un nuovo lancio, magari più favorevole. Infatti, nonostante la presenza di logs anche per la cancellazione dei messaggi, si è reso necessario inibire completamente tale funzione all’utente che ha inviato il post, in quanto non tutti i membri dello staff di un forum hanno i permessi necessari per visualizzare la pagina amministrativa Registro e recupero dati. Ciò consente inoltre di evitare di verificare ogni volta se il post è stato cancellato e inviato nuovamente. Merita di essere sottolineato il fatto che, in ogni caso, amministratori e moderatori possono sempre cancellare i post, sia propri che altrui, anche se contenenti dei lanci di dadi.
    • per controllare l’ora esatta e l’utente che ha inserito il lancio è possibile fare riferimento ai dati mostrati in fondo ad ogni lancio. Tali dati sono attendibili e non modificabili.

    Personalizzazioni grafiche


    Da un punto di vista del codice, un lancio di dadi, una volta inserito in un post, è rappresentato da un elemento details con la classe .dice-roll. Nel tag summary è racchiusa la legenda con descrizione e somma totale dei risultati ottenuti, mentre un ul raggruppa tutti i lanci. L’ultimo elemento dell’ul, con classe .dice-time, contiene le informazioni in merito alla data e all’account che ha inviato il dado.



    Normalmente, i risultati di un lancio possiedono un colore differente a seconda del numero ottenuto rispetto al massimo ottenibile:

    CODICE
    .dice-roll .dice-low {color: indianred}
    .dice-roll .dice-medium {color: darkorange}
    .dice-roll .dice-high {color: mediumseagreen}
    .dice-roll .dice-highest {color: forestgreen}

    Ad esempio, lanciando un dado da 100 facce, il risultato assumerà i seguenti colori:
    • tra 1 e 25: classe .dice-low, colore rosso;
    • tra 26 e 50: classe .dice-medium, colore arancio;
    • tra 51 e 75: classe .dice-high, colore verde chiaro;
    • tra 76 e 100: classe .dice-highest, colore verde scuro.
    Per poter visualizzare tutti gli elementi e le classi associati al lancio del dado, è possibile infine utilizzare la funzione Ispeziona elemento (o simile) del browser, presente nel menù che appare cliccando col tasto destro del mouse su un elemento della pagina.