Dolfje

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 [opensource] geworden en wordt er door meerdere mensen (waaronder vooral Martin) aan gewerkt.

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!

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 3 parameter nodig voor /wwstartregistratie [wachtwoord] [stemstijl] [naam van spel] 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. 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.

/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.

/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 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). 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.

/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 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.

/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

Stuurt een DM met de optie om kanalen te archiveren. 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: /wwverdeelrollen wolf:5 ziener:1 slet:1 heks:2 jager:2 burger:

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. 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.

/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)

/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.

/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.

/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.