Anzeigen:
Modul: Dice

Eine Instanz von DiceConfiguration repräsentiert eindeutig eine Konfiguration zum würfeln. Wurde gewürfelt, so können die Konfigurationen verglichen werden, um zu prüfen, ob exakt die Würfel gewürfelt wurden, die gewürfelt werden sollten.

Methoden

equals

(
  • diceConfiguration
)
Boolean

Vergleicht, ob zwei Konfigurationen inhaltlich identisch sind

Parameter:

Rückgabewert:

Beispiel:

const wantedDiceConfiguration = DiceConfigurationFactory.fromString('10w2');

this.onUserDiced = function(diceEvent)
{
    var user = diceEvent.getUser();
    
    var diceResult = diceEvent.getDiceResult();
    var configuration = diceResult.getDiceConfiguration();
    
    if (!configuration.equals(wantedDiceConfiguration)) 
    {
        var diceLink = '°>' + wantedDiceConfiguration + '|"<°';
    
        user.sendPrivateMessage('Du hast nicht mit den richtigen Würfeln gewürfelt: ' + diceLink);
    }
};

getChatCommand

() String

Verfügbar ab Revision AppServer 82248

Liefert den Befehl, der im Chat eingegeben werden kann, um einen Wurf auszuführen, der zur DiceConfiguration passt.

Rückgabewert:

Beispiel:

var chatCommand = diceConfiguration.getChatCommand(); // i.e.: /dice 10w2

getDices

() Dice[]

Liefert ein Array mit Würfeln, mit denen gewürfelt wurde.

Rückgabewert:

Beispiel:

var dices = diceConfiguration.getDices(); // i.e.: [ Dice, Dice, Dice ]

isUsingOpenThrow

() Boolean

Informiert, ob es sich um einen offenen Würfelwurf handelt. Offene Würfelwürfe sind speziell. Falls die Augenzahl des Würfels die Maximalsumme zeigt, so wird noch einmal gewürfelt und die neue Zahl dazu addiert, solange bis der Würfel nicht mehr die Maximalsumme zeigt.

Beispiel: /diceo 1w4 -> 4 -> 4 -> 3 = 11

Rückgabewert:

Beispiel:

var openThrow = diceConfiguration.isUsingOpenThrow(); // i.e.: false

isUsingPrivateThrow

() Boolean

Informiert darüber, ob die Würfel privat geworfen worden sind. Würfelwürfe zählen als privat, wenn am Ende des Würfelbefehls ein Ausrufezeichen steht. Beispiel: /dice 10w2!

Rückgabewert:

Beispiel:

var privateThrow = diceConfiguration.isUsingPrivateThrow(); // i.e.: false