Versie van 6 aug 2020 08:54

Dolfje

Oorsprong

Tijdens Weerwolven 2 - Wakkerdam waar meer dan 40 man aan mee deed werd polly gebruikt voor de stemming. De gratis versie van polly heeft echter een aantal nadelen, zo kan je maar 10 opties toevoegen aan de poll en door een optie toe te voegen beïnvloed je de (anoniem) stemming. Als oplossing werd gekeken naar de betaalde versie van Polly, maar uiteindelijk heeft foaly besloten zelf een slack bot te maken, zodat niet alleen de stemming maar ook andere dingen er mee geregeld konden worden. In Weerwolven 4 - Toy Story werd Dolfje voor het eerst gebruikt, een heel aantal dingen werden al ondersteund, maar bijvoorbeeld het verdelen van rollen zat er nog niet in. Na interesse vanuit andere slack community's is Dolfje [[1]] opensource geworden en wordt er door meerdere mensen (waaronder vooral Martin) aan gewerkt. Inmiddels ondersteund Dolfje meerdere spellen tegelijk.

Handleiding

Voor het spelen van weerwolven met Dolfje zijn er een reeks commando’s welke hier kort worden toegelicht, dit zal niet alle vragen afdekken, dus aarzel niet om door te vragen. Voor de meeste commando’s is het belangrijk dat het commando uitvoert in een kanaal dat betrokken is bij het spel !

Commando’s voor de verteller

/wwstartregistratie

Het spel begint altijd met het openen van de registratie. Dit geeft de kans aan spelers om zich te registeren, je kunt je alleen registeren tijdens een registratie periode. Er zijn 4 parameters nodig voor /wwstartregistratie [wachtwoord] [stemstijl] [naam van spel] [mogelijke reanimatie spelers (0 = nee, 1 =ja)] Het wachtwoord is om misbruik te voorkomen en kan worden opgevraagd bij een oud-verteller. De stemstijl is de manier van stemmen, op dit moment wordt alleen blind ondersteund. De naam van het spel is vooral voor registratie redenen en wordt gebruikt voor bepaalde verteller commando's en meldingen. Dit commando moet uitgevoerd worden in een openbaar kanaal waar iedereen zich in kan aanmelden.

/wwikdoemee

Tijdens de registratie periode kunnen spelers zich inschrijven met dit commando. Dit wordt vervolgens bevestigd en spelers krijgen een welkomsbericht. Indien er meerdere spellen open staan voor registratie, krijgen registranten een bericht met de vraag voor welke van de openstaande spellen zij willen inschrijven.

/wwikkijkmee

Spelers die mee willen kijken met het spel kunnen zich aanmelden om mee te kijken met dit commando. Als het spel al begonnen is, worden spelers automatisch toegevoegd aan het dorp, het stemhok en het sectator kanaal. Deze actie wordt bevestigd naar de vertellers. Indien er meerdere spellen open staan voor kijkers, krijgen registranten een bericht met de vraag voor welke van de openstaande spellen zij willen inschrijven.

/wwikdoenietmeermee

Tijdens de registratie periode kunnen spelers zich uitschrijven met dit commando. Dit wordt vervolgens bevestigd.

/wwstartspel

Dit beëindigt de registratie periode en start het spel. Er zijn 3 parameters nodig voor /wwstartspel [naam van het spel] [aantal spelers] [naam van het hoofdkanaal]. De naam van het spel is nodig om het juiste spel te starten. Het aantal spelers bepaalt het aantal spelers dat mee mag doen. Als het aantal spelers lager is dan het aantal inschrijvingen dan wordt er geloot. Hierbij hebben mensen die in vorige potjes uitgeloot zijn voorrang en hoe lang het geleden is dat je bent uitgeloot. De derde parameter is de naam van het hoofdkanaal, Dolfje maakt vervolgens dit kanaal aan (kanaal naam mag dus nog niet bestaan!) en nodigt iedereen die ingeloot is en de sectators daarin uit.

/wwstartstemronde

Start de stemronde, dit commando moet uitgevoerd worden in het stemlokaal. Dit commando heeft een optionele parameter [naam van de stemming]. Deze wordt vermeld in het kanaal en opgeslagen in de DB.

/wwstemherinnering

Tijdens een stemronde kan er een stemherinnering verstuurd worden. Er is één commando nodig voor /wwstemherinnering [eindtijd]. De eindtijd is de tijd waarom de stemming sluit. Deze tijd wordt vermeld in de herinnering.

/wwstopstemronde

Stopt de huidige stemronde. Dit commando moet uitgevoerd worden in het stemlokaal. De stemming wordt gesloten en de uitslag wordt bekend gemaakt.

/wwdood

Dit commando markeert een speler als dood. Er is 1 parameter nodig voor /wwdood [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals/sectatorkanaal zodat de gebruiker hiervoor uitgenodigd kan worden. De bot stuurt de gebruiker een DM met het slechte nieuws en een verzoek haar status aan te passen.

/wwreanimeer

Dit commando markeert een speler als levend. Er is 1 parameter nodig voor /wwreanimeer [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals/sectatorkanaal zodat de gebruiker daar uitgegooid kan worden. De bot stuurt de gebruiker een DM met het goede nieuws en een verzoek haar status aan te passen.

/wwextraverteller

Voegt een extra verteller toe. Er is 1 parameter nodig voor /wwextraverteller [@user]. @-mention een gebruiker die je verteller wilt maken. Die mag vervolgens alle verteller commando’s uitvoeren en wordt uitgenodigd met het uitnodig commando. Als het spel al begonnen is wordt de verteller ook toegevoegd aan alle kanalen van het spel.

/wwstopspel

Stopt het spel, pas als het huidige spel gestart is kan de registratie voor een volgend spel gestart worden. Er is 1 parameter nodig voor /wwstopspel [wachtwoord].

/wwarchiveren

Archiveert alle kanalen die zijn gerelateerd aan het spel. Heeft 1 parameter nodig /wwarchiveren [wachtwoord].

/wwverdeelrollen

Verdeelt de rollen. Dit commando vereist de rollen als argumenten. De vorm daarvoor is: rol:aantal. Je kunt ook een range aangeven qua rollen op de volgende manier: rol:minAantal-maxAantal. Je moet afsluiten met de standaard rol zonder aantal of met een flexibel aantal dus bijvoorbeeld: /wwverdeelrollen wolf:5 ziener:1 slet:1 heks:2 jager:2 burger: || /wwverdeelrollen wolf:4 ziener 1 heks:1-3 burger:8-10

Commando’s voor iedereen

/wwkanaal

Dit commando start een kanaal en nodigt automatisch alle vertellers en Dolfje uit. Dit commando kan in alle kanalen waar Dolfje inzit worden uitgevoerd, zolang dit kanaal bij een spel hoort. Het nieuwe kanaal wordt dan ook direct aan dat spel gekoppeld. Dit commando heeft één parameter nodig: /wwkanaal [naam van het nieuwe kanaal]

/wwnodigvertellersuit

Nodigt iedereen met de rol van verteller in het kanaal waar je dit commando uitvoert uit. Gebruik bij voorkeur /wwkanaal voor het aanmaken van nieuwe kanalen.

/wwnodigspelersuit

Nodigt iedereen in het spel uit, om vergissingen met nodigvertellersuit te voorkomen moet dit bevestigd worden met ikweethetzeker, het volledige commando is dus: /wwnodigspelersuit ikweethetzeker

/wwlijst

Geeft een lijst van iedereen in het huidige kanaal. Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.

/wwregels

Laat de huidige regels zien. Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten. (regels moeten voorlopig handmatig in DB worden toegevoegd en gekoppeld en in de wiki worden toegevoegd)

/wwstartvluchtigestemronde

Maakt een stemming aan die niet opgeslagen wordt in de database. De stemming kan door iedereen worden aangemaakt en door iedereen worden gesloten.

/wwlotto

Dolfje geeft stemadvies. Dolfje kiest een willekeurige nog levende speler, dat kan je dus ook zelf zijn! Schat dit advies altijd op waarde. Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.

/wwstatus

Geeft de huidige status van het spel weer en geeft aan in welke spellen jij actief bent (als verteller, speler of sectator). Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.

/wwhelp

Stuurt een DM met de help tekst.

Automatisch stemmen

Gebruik Slackbots remind functie om het stemmen te schedulen, bijvoorbeeld: /remind #stemhok “hey @dolfje start de stemming" every monday at 1200 Opent de stemming elke maandag om 12 uur. /remind #stemhok “hey @dolfje stop de stemming nu" every friday at 2000 Sluit de stemming elke vrijdag om 12 uur. /remind #stemhok “hey @dolfje herinner spelers voor [2000] te stemmen” every friday at 1930 Herinnert iedereen die nog niet gestemt heeft vrijdag om 1930, om voor 2000 te stemmen.

Onderstreepte woorden zijn in deze volgorde vereist (inclusief de haken om de tijd waarop de stembus sluit).

“Every friday” kan ook zijn “every day” of “every weekday”

Als er geen stemming geopend of gesloten kan worden wordt het bericht van Slackbot genegeerd.

@@ Regel 2: / Regel 2: @@
 ==Oorsprong==
-Tijdens [[Weerwolven 2 - Wakkerdam]] waar meer dan 40 man aan mee deed werd polly gebruikt voor de stemming. De gratis versie van polly heeft echter een aantal nadelen, zo kan je maar 10 opties toevoegen aan de poll en door een optie toe te voegen beïnvloed je de (anoniem) stemming. Als oplossing werd gekeken naar de betaalde versie van Polly, maar uiteindelijk heeft foaly besloten zelf een slack bot te maken, zodat niet alleen de stemming maar ook andere dingen er mee geregeld konden worden. In [[Weerwolven 4 - Toy Story]] werd Dolfje voor het eerst gebruikt, een heel aantal dingen werden al ondersteund, maar bijvoorbeeld het verdelen van rollen zat er nog niet in. Na interesse vanuit andere slack community's is Dolfje [[https://github.com/decentaur/dolfje opensource]] geworden en wordt er door meerdere mensen (waaronder vooral Martin) aan gewerkt.
+Tijdens [[Weerwolven 2 - Wakkerdam]] waar meer dan 40 man aan mee deed werd polly gebruikt voor de stemming. De gratis versie van polly heeft echter een aantal nadelen, zo kan je maar 10 opties toevoegen aan de poll en door een optie toe te voegen beïnvloed je de (anoniem) stemming. Als oplossing werd gekeken naar de betaalde versie van Polly, maar uiteindelijk heeft foaly besloten zelf een slack bot te maken, zodat niet alleen de stemming maar ook andere dingen er mee geregeld konden worden. In [[Weerwolven 4 - Toy Story]] werd Dolfje voor het eerst gebruikt, een heel aantal dingen werden al ondersteund, maar bijvoorbeeld het verdelen van rollen zat er nog niet in. Na interesse vanuit andere slack community's is Dolfje [[https://github.com/decentaur/dolfje]] opensource geworden en wordt er door meerdere mensen (waaronder vooral Martin) aan gewerkt. Inmiddels ondersteund Dolfje meerdere spellen tegelijk.
 ==Handleiding==
-Voor het weerwolven met de bot zijn er een reeks commando’s ik zal deze hier kort in toelichten, dit zal niet alle vragen afdekken, dus aarzel niet om door te vragen. Voor de meeste commando’s is het belangrijk dat je Dolfje eerst in het kanaal uitnodigt!
+Voor het spelen van weerwolven met Dolfje zijn er een reeks commando’s welke hier kort worden toegelicht, dit zal niet alle vragen afdekken, dus aarzel niet om door te vragen. Voor de meeste commando’s is het belangrijk dat het commando uitvoert in een kanaal dat betrokken is bij het spel !
 ===Commando’s voor de verteller===
@@ Regel 15: / Regel 15: @@
 Het spel begint altijd met het openen van de registratie. Dit geeft de kans aan spelers om zich te registeren, je kunt je alleen registeren tijdens een registratie periode.
-Er zijn 3 parameter nodig voor /wwstartregistratie [wachtwoord] [stemstijl] [naam van spel]
+Er zijn 4 parameters nodig voor /wwstartregistratie [wachtwoord] [stemstijl] [naam van spel] [mogelijke reanimatie spelers (0 = nee, 1 =ja)]
-Het wachtwoord is om misbruik te voorkomen en kan worden opgevraagd bij een oud-verteller. De stemstijl is de manier van stemmen, op dit moment wordt alleen blind ondersteund. De naam van het spel is vooral voor registratie redenen en wordt als melding ingegeven.
+Het wachtwoord is om misbruik te voorkomen en kan worden opgevraagd bij een oud-verteller. De stemstijl is de manier van stemmen, op dit moment wordt alleen blind ondersteund. De naam van het spel is vooral voor registratie redenen en wordt gebruikt voor bepaalde verteller commando's en meldingen.
 Dit commando moet uitgevoerd worden in een openbaar kanaal waar iedereen zich in kan aanmelden.
 ====/wwikdoemee====
-Tijdens de registratie periode kunnen spelers zich inschrijven met dit commando. Dit wordt vervolgens bevestigd.
+Tijdens de registratie periode kunnen spelers zich inschrijven met dit commando. Dit wordt vervolgens bevestigd en spelers krijgen een welkomsbericht. Indien er meerdere spellen open staan voor registratie, krijgen registranten een bericht met de vraag voor welke van de openstaande spellen zij willen inschrijven.
 ====/wwikkijkmee====
-Spelers die mee willen kijken met het spel kunnen zich aanmelden om mee te kijken met dit commando. Als het spel al begonnen is, worden spelers automatisch toegevoegd aan het dorp, het stemhok en het sectator kanaal. Deze actie wordt bevestigd naar de vertellers.
+Spelers die mee willen kijken met het spel kunnen zich aanmelden om mee te kijken met dit commando. Als het spel al begonnen is, worden spelers automatisch toegevoegd aan het dorp, het stemhok en het sectator kanaal. Deze actie wordt bevestigd naar de vertellers. Indien er meerdere spellen open staan voor kijkers, krijgen registranten een bericht met de vraag voor welke van de openstaande spellen zij willen inschrijven.
 ====/wwikdoenietmeermee====
@@ Regel 33: / Regel 33: @@
 ====/wwstartspel====
-Dit beëindigt de registratie periode en start het spel. Er zijn 2 parameters nodig voor /wwstartspel [aantal spelers] [naam van het hoofdkanaal]. Aantal spelers bepaalt het aantal spelers dat mee mag doen. Als het aantal spelers lager is dan het aantal inschrijvingen dan wordt er geloot. Hierbij hebben mensen die in vorige potjes uitgeloot zijn voorrang en hoe lang het geleden is dat je bent uitgeloot. (Er is verbetering nodig voor dat algoritme, maar het werkt).
+Dit beëindigt de registratie periode en start het spel. Er zijn 3 parameters nodig voor /wwstartspel [naam van het spel] [aantal spelers] [naam van het hoofdkanaal]. De naam van het spel is nodig om het juiste spel te starten. Het aantal spelers bepaalt het aantal spelers dat mee mag doen. Als het aantal spelers lager is dan het aantal inschrijvingen dan wordt er geloot. Hierbij hebben mensen die in vorige potjes uitgeloot zijn voorrang en hoe lang het geleden is dat je bent uitgeloot.
-De tweede parameter is de naam van het hoofdkanaal, de bot maakt vervolgens dit kanaal aan (kanaal naam mag dus nog niet bestaan!) en nodigt iedereen die ingeloot is daarin uit.
+De derde parameter is de naam van het hoofdkanaal, Dolfje maakt vervolgens dit kanaal aan (kanaal naam mag dus nog niet bestaan!) en nodigt iedereen die ingeloot is en de sectators daarin uit.
 ====/wwstartstemronde====
@@ Regel 50: / Regel 50: @@
 ====/wwdood====
-Dit commando markeert een speler als dood. Er is 1 parameter nodig voor /wwdood [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals zodat de gebruiker hiervoor uitgenodigd kan worden. De bot stuurt de gebruiker een DM met het slechte nieuws en een verzoek haar status aan te passen.
+Dit commando markeert een speler als dood. Er is 1 parameter nodig voor /wwdood [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals/sectatorkanaal zodat de gebruiker hiervoor uitgenodigd kan worden. De bot stuurt de gebruiker een DM met het slechte nieuws en een verzoek haar status aan te passen.
 ====/wwreanimeer====
-Dit commando markeert een speler als levend. Er is 1 parameter nodig voor /wwreanimeer [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals zodat de gebruiker daar uitgegooid kan worden. De bot stuurt de gebruiker een DM met het goede nieuws en een verzoek haar status aan te passen.
+Dit commando markeert een speler als levend. Er is 1 parameter nodig voor /wwreanimeer [@user]. @-mention de user waarom het gaat. Voer dit commando uit in het hiernamaals/sectatorkanaal zodat de gebruiker daar uitgegooid kan worden. De bot stuurt de gebruiker een DM met het goede nieuws en een verzoek haar status aan te passen.
 ====/wwextraverteller====
@@ Regel 66: / Regel 66: @@
 ====/wwarchiveren====
-Stuurt een DM met de optie om kanalen te archiveren. Heeft 1 parameter nodig /wwarchiveren [wachtwoord].
+Archiveert alle kanalen die zijn gerelateerd aan het spel. Heeft 1 parameter nodig /wwarchiveren [wachtwoord].
 ====/wwverdeelrollen====
 Verdeelt de rollen. Dit commando vereist de rollen als argumenten. De vorm daarvoor is:
-rol:aantal. Je moet afsluiten met de standaard rol zonder aantal dus bijvoorbeeld:
+rol:aantal. Je kunt ook een range aangeven qua rollen op de volgende manier: rol:minAantal-maxAantal. Je moet afsluiten met de standaard rol zonder aantal of met een flexibel aantal dus bijvoorbeeld:
-/wwverdeelrollen wolf:5 ziener:1 slet:1 heks:2 jager:2 burger:
+/wwverdeelrollen wolf:5 ziener:1 slet:1 heks:2 jager:2 burger:  || /wwverdeelrollen wolf:4 ziener 1 heks:1-3 burger:8-10
 ===Commando’s voor iedereen===
@@ Regel 78: / Regel 78: @@
 ====/wwkanaal====
-Dit commando start een kanaal en nodigt automatisch alle vertellers en Dolfje uit. Dit commando kan in alle kanalen waar Dolfje inzit worden uitgevoerd. Dit commando heeft één parameter nodig: /wwkanaal [naam van het nieuwe kanaal]
+Dit commando start een kanaal en nodigt automatisch alle vertellers en Dolfje uit. Dit commando kan in alle kanalen waar Dolfje inzit worden uitgevoerd, zolang dit kanaal bij een spel hoort. Het nieuwe kanaal wordt dan ook direct aan dat spel gekoppeld. Dit commando heeft één parameter nodig: /wwkanaal [naam van het nieuwe kanaal]
 ====/wwnodigvertellersuit====
-Nodigt iedereen met de rol van verteller in het kanaal waar je dit commando uitvoert uit.
+Nodigt iedereen met de rol van verteller in het kanaal waar je dit commando uitvoert uit. Gebruik bij voorkeur /wwkanaal voor het aanmaken van nieuwe kanalen.
 ====/wwnodigspelersuit====
@@ Regel 95: / Regel 95: @@
 Laat de huidige regels zien. Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.
-(regels moeten voorlopig handmatig in DB worden toegevoegd en gekoppeld)
+(regels moeten voorlopig handmatig in DB worden toegevoegd en gekoppeld en in de wiki worden toegevoegd)
 ====/wwstartvluchtigestemronde====
@@ Regel 104: / Regel 104: @@
 Dolfje geeft stemadvies. Dolfje kiest een willekeurige nog levende speler, dat kan je dus ook zelf zijn! Schat dit advies altijd op waarde.
+Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.
 ====/wwstatus====
-Geeft de huidige status van het spel weer. Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.
+Geeft de huidige status van het spel weer en geeft aan in welke spellen jij actief bent (als verteller, speler of sectator). Dit is in een privé bericht. Gebruik optionele paramater public om het naar het kanaal zelf te posten.
 ====/wwhelp====

Dolfje: verschil tussen versies