Taal
Anvil · Discord7 min lezen

Anvil in Discord

Eén bot, één uitnodiging, en geen applicatie te registreren. Dit is wat hij post, waar hij het post, wat hij in je server mag veranderen — en waar je naar kijkt op de dag dat het stopt.

Eén bot gedeeld, niets aan te maken~5 min van uitnodiging tot eerste postOpt-in elke feed staat uit tot je hem ergens op richt
Deze vertaling naar het Nederlands is nog door geen enkele moedertaalspreker nagelezen. Leest een zin verkeerd, dan is de Engelse pagina het origineel — en het ons laten weten is wat het rechtzet.
Stap 1

Eén bot, al gebouwd

#

Er is geen Discord-applicatie aan te maken, geen token te genereren en geen geheim te plakken. Anvil draait één bot die elke clan deelt, dus koppelen is een uitnodiging en verder niets.

Je kunt nog steeds je eigen meebrengen — plak een token onder Use your own bot instead (advanced) en die wordt in plaats daarvan gebruikt. Alleen de moeite waard als je wilt dat de bot de naam en avatar van je clan draagt in de ledenlijst; alles in deze gids werkt hoe dan ook hetzelfde.

Kanalen bekijken, Berichten versturen, Links insluiten, Bestanden bijvoegenDe basis. Zonder deze staat hij in je server en zwijgt hij.
Webhooks beherenZodat Set it up for me en Post here webhooks voor je kunnen maken, in plaats van dat jij URL’s met de hand uit Discord kopieert, en zodat Anvil oude webhooks voor je kan opsporen om te verwijderen.
Rollen beherenAlleen als je rolsynchronisatie aanzet. Hij kan dan de rollen uitdelen die je koppelt — en hij kan nooit aan een rol boven de zijne komen, wat Discords regel is, niet de onze.
Bijnamen beherenAlleen als je bijnaamsynchronisatie aanzet, zodat de servernaam van een lid op hun RSN gezet kan worden.
Kanalen beherenVoor privé-teamkanalen tijdens een draft, en voor gidsen die als nieuwe categorie of forum worden geplaatst. Sla het over en de rest werkt gewoon.
Threads beheren, Berichten versturen in threadsVoor gidsen in een forum: schrijven in de post en die weer verwijderen — zonder dit laat Discord een bot zelfs zijn eigen forumpost niet verwijderen.
Bijnaam wijzigenAlleen als je de bot de naam van je clan geeft onder Connection → Bot appearance in your server. Het verandert alleen de naam van de bot in jouw server.
Hij vraagt ze allemaal tegelijk
Discord kan een permissie niet later alsnog vragen, dus de uitnodigingslink vraagt de hele set en de functies die je nooit aanzet gebruiken de hunne nooit. De link opnieuw openen is ook hoe je een permissie herstelt die iemand heeft weggehaald.
Stap 2

Koppelen

#

Twee dingen, in deze volgorde. De bot moet in je server zitten, en Anvil moet weten welke server de jouwe is.

Nodig de bot uitAdmin → Discord → Connect your Discord server (of Add Anvil to Discord). Discord vraagt aan welke server je Anvil wilt toevoegen en stuurt je daarna hierheen terug, dus je kunt hem niet per ongeluk aan de verkeerde toevoegen. Later staat Invite / re-invite the bot onder More settings → Connection.
Stel het server-ID inAlleen als de knop het niet kan: open Can’t use the button? Enter the server ID, rechtsklik op je servericoon in Discord → Server-ID kopiëren (vereist Ontwikkelaarsmodus, onder Geavanceerd in Discords eigen instellingen), plak het in Your Discord server’s ID en druk op Save. Dit veld maakt de koppeling specifiek van jou.

Het paneel vertelt je daarna de waarheid in plaats van je bedoeling: of de bot echt lid is van die server, en welke permissies hij mist. Een groene regel daar is meer waard dan een opgeslagen formulier.

Het server-ID is de hele koppeling
Een server hoort op Anvil bij precies één clan, en slash-commando’s uit een server die niemand geclaimd heeft worden geweigerd in plaats van geraden. Tot je het instelt is de bot uitgenodigd en werkloos.
Stap 3

Webhooks instellen

#

Anvil post via webhooks, één per kanaal, en elk daarvan is optioneel. Er wordt nergens iets gepost tot je een feed op een kanaal richt — een verse clan is stil met opzet, niet per ongeluk.

Zit de Anvil-bot in je server, dan maakt Set it up for me bovenaan Admin → Discord de kanalen aan en richt hij elke feed erop. Wil je het met de hand doen, open dan More settings → What goes where en begin met het Catch-all channel op Clan & events, daarna de In-game catch-all op In-game (plugin): kies een kanaal uit de keuzelijst en het wordt opgeslagen. Zonder bot open je in Discord bij dat kanaal Kanaal bewerken → Integraties → Webhooks, maak je er een, kopieer je de URL, kies je Paste a webhook… in de keuzelijst, plak je hem en druk je op Save. Een webhook-URL kan in zijn kanaal posten, dus behandel hem als een wachtwoord; verwijder hem in Discord en maak een nieuwe als hij uitlekt. Test, en Add another om drukke posts over twee webhooks te verdelen, staan onder Post without a bot.

Catch-all-kanaalHet belangrijkste kanaal, op het tabblad Clan & events. Start en einde van events, inschrijvingen die openen, standen, wekelijkse resultaten — alles wat de site post zonder eigen kanaal. Stel alleen dit in en je hebt een werkende clan.
Catch-all in het spelOp het tabblad In-game (plugin): hier komt alles uit de game terecht dat geen eigen kanaal heeft. Stel dit als tweede in.
Mijlpalen en meerOp het tabblad In-game (plugin). Slayer, clues, speedruns, killcounts, BA-gambles en eigen chatberichten worden hier geplaatst zodra spelers ze aanzetten. Met de knop Filters bepaal je wat je clan standaard aan leden geeft. Eigen sjablonen en privésoorten van spelers staan in Settings, page by page.
De gesplitste feedsEventberichten, boards die je samen host, Skill & boss of the week en clan-kalenderevents kunnen worden afgesplitst van het catch-all-kanaal; rare drops, pets, collection log, levels, combat achievements, quests, diaries, deaths en PvP-kills kunnen worden afgesplitst van het catch-all-kanaal in het spel. Wijzigingen in de ledenlijst, goedkeuringen van inschrijvingen en het kassaboek staan onder Staff only. Lege gesplitste feeds vallen terug op hun catch-all-kanaal. De kas is de uitzondering: leeg betekent dat er geen geld wordt geplaatst. Leagues en andere modi hebben hun eigen tabblad Game modes.
Splits eerst de doden af
Doden zijn op de meeste borden de feed met het meeste volume en degene die al het andere bedelft. Als je maar één ding splitst, splits dat.
Stap 4

Leagues, Deadman en andere modi

#

Leagues, Deadman, hardcore en andere modi draaien op hun eigen werelden met hun eigen personages. Hun berichten worden altijd gelabeld en tellen nooit mee voor boards of competities. Ze hebben een eigen tabblad: Admin → Discord → What goes where → Game modes. Een modus verschijnt daar de eerste keer dat een lid hem speelt.

Elke modus heeft een schakelaar en een kanaal To. Zet Send game-mode posts to their own channels aan om die kanalen te gebruiken; laat je het uit, dan gaan alle modi naar de gewone kanalen, wel gelabeld. Met de knop Posts in de rij van een modus zie je alle soorten die hij stuurt — de gebruikelijke en de eigen events van de modus — elk met een eigen schakelaar.

Onder die lijst maken Custom thresholds dat een modus minder plaatst dan het hoofdspel. Post drops rarer than 1 in… (minstens 2) en Post drops worth at least (gp) (minstens 1,000) stellen hun eigen ondergrens in (leeg = hetzelfde als het hoofdspel). Druk daarna op Save drop thresholds: items die altijd worden geplaatst, worden nog steeds geplaatst, maar drops die alleen op waarde tellen niet. Use its own level milestones plaatst een level-up alleen als die aan beide regelsets voldoet.

Strenger, nooit losser
De filters van een modus kunnen alleen posts weghalen. De plugin heeft je instellingen voor het hoofdspel al toegepast, dus niets wat een modusfilter doet kan een post terugbrengen.
Stap 5

Oude webhooks van andere plugins of bots

#

Zit de bot in je server, dan toont de Discord-pagina elke webhook daarin die niet van Anvil is. Coming from other plugins? biedt Use the same channels aan, zodat Set it up for me post waar je oude feeds postten en er voor je leden niets verschuift.

Zodra je leden op Anvil zitten, ga je naar Remove old webhooks from other plugins, vink je aan welke weg mogen en druk je op Remove … webhooks, daarna op Yes, remove them. Dat verwijdert ze voorgoed in Discord — het kan niet ongedaan worden gemaakt.

De lijst bevat elke webhook die niet van Anvil is, niet alleen die van een andere plugin. Wil je er een houden, zoals de feed van een andere bot? Druk op Keep en hij verdwijnt uit de lijst; met Show kept en Put back haal je hem terug. Houden verbergt hem alleen hier — in Discord verandert er niets.

Vereist Webhooks beheren
De bot leest de webhooks van je server om ze te vinden. Zonder Webhooks beheren op zijn rol meldt de pagina dat hij ze niet kan zien.
Stap 6

Rollen en bijnamen

#

Beide synchronisaties staan uit tot je ze inschakelt onder Admin → Discord → Roles & nicknames, en beide worden aangestuurd door de ledenlijst. Zet Enable Discord role sync aan, laat Auto-match in-game rank → Discord role by name aanstaan, kies eventueel algemene Member roles en Guest roles, sla op en druk op Sync roles & nicknames now. Iedereen heeft ook een gekoppelde Discord-identiteit nodig; het synchronisatierapport noemt iedereen die het niet kon thuisbrengen.

RolsynchronisatieVoor automatisch koppelen van rangen moet de naam van de Discord-rol overeenkomen met de clanrang in het spel: Owner, Deputy Owner, Coordinator, Overseer, General, Captain, Lieutenant, Sergeant, Corporal of Recruit. Eigen rangen werken ook, als hun Discord-rol precies diezelfde naam heeft. Hoofdletters maken niet uit en onderstrepingstekens tellen als spaties, maar extra woorden komen niet overeen: General werkt, OSRS General niet. Leden- en gastrollen kies je apart, dus die mogen elke naam hebben.
BijnaamsynchronisatieZet de servernaam van een lid op hun RSN. Standaard vult hij een lege bijnaam in, en je kunt hem opdragen er een te overschrijven die iemand zelf koos — dat is de instelling om vooraf over na te denken, niet achteraf.
De rol van de bot moet boven de rollen staan die hij beheert
Discord laat geen enkele bot aan een rol op of boven zijn eigen komen, en weigert dat van jouw kant zwijgend — de synchronisatie doet dan gewoon niets. Sleep de Anvil-rol omhoog in Serverinstellingen → Rollen en hij werkt; opnieuw uitnodigen hoeft niet.
Stap 7

Slash-commando’s

#

De bot beantwoordt /bingo in je server (het bord, de stand, de regels, je eigen kaart) plus clancommando’s zoals /sotw, /stats en /coffer. Ze lezen de live site, dus niemand hoeft Discord te verlaten om te zien hoe hij ervoor staat. Elk commando en zijn opties heeft een eigen pagina.

Ze verschijnen ongeveer een minuut nadat de bot binnenkomt. Verschijnen ze helemaal niet, dan gaf de uitnodiging de bot wel maar zijn commando’s niet — dat zijn twee losse permissies, en een oudere uitnodigingslink vroeg er maar één. Gebruik opnieuw Invite / re-invite the bot onder Connection op de Discord-pagina; dat schopt de bot er niet uit en zet niets terug.

Hij antwoordt in ieders eigen taal
Standaard antwoordt de bot in de taal die dat lid in Discord ingesteld heeft, met Engels als terugval. Kies één taal onder Bottaal om dat voor iedereen te overschrijven — dat is ook de enige manier om Arabisch te krijgen, omdat Discord geen Arabische clienttaal heeft om te detecteren.
Stap 8

Wat hij post, en wanneer

#

Twee bronnen, en het is nuttig te weten welke welke is als er iets niet klopt.

De site post events: een bord dat opengaat, aanmeldingen, een start, standen, de uitslag. Die komen uit Anvil zelf en blijven werken of iemand nu de plugin heeft of niet.

De plugin post wat er in het spel gebeurt: drops, pets, doden, levels, collection log-slots, combat achievements. Die bestaan alleen voor leden die hem draaien, dus een stil dropskanaal betekent meestal een stille plugin, niet een kapotte webhook.

Niets wordt dubbel gepost
Een drop die een tegel afrondt is één post, niet één van de plugin en nog een van het bord.
Stap 9

Dropterskels

#

Anvil begint bij 1m gp of 1 in 1,000. Een drop wordt geplaatst als hij aan een van beide voldoet. Niemand kan eigen getallen lager zetten dan die, en 0 schakelt er een uit.

Stel de standaarden van je clan in onder Admin → Discord → What goes where → Drops: Default minimum drop value (gp), Default: post drops rarer than 1 in… en Require both. Zet Require both aan en een drop moet zowel aan de waarde and aan de zeldzaamheid voldoen.

Elk personage volgt de standaard van de clan waarvan het lid is, en de standaard van Anvil als er geen is. Spelers kunnen eigen getallen kiezen in Settings. Er staat Using clan default of Custom, en met Reset ga je terug.

Hard floor: never post drops more common than 1 in… is de strikte. Leden kunnen in de kanalen van je clan niet losser gaan dan dat. Hun eigen webhooks kunnen dat wel.

Meer over de kant van de speler
De eigen getallen, sjablonen en webhooks van spelers staan in Settings, page by page.
Stap 10

Meer webhooks voor drukke kanalen

#

Eén webhook kan maar zo snel verzenden. Voor een drukke event voeg je meer webhooks toe aan hetzelfde kanaal. Druk op Busy channel? Let the bot add … more webhooks (dat vereist Manage Webhooks), of plak meerdere webhooklinks in het vak van het kanaal. Anvil stelt meer voor als je 50 of meer spelers hebt, veel berichten per minuut, of als Discord recent “slow down” heeft gezegd. Tot 10 is ruim genoeg.

Anvil wisselt af tussen ze. Als Discord voor één webhook “slow down” zegt, rust die even en pakt de volgende het bericht. Als er één wordt verwijderd of stopt met werken, wordt die 10 minuten overgeslagen. Berichten blijven doorstromen zolang één webhook werkt.

Ze moeten allemaal naar hetzelfde kanaal wijzen. Anvil waarschuwt je als dat niet zo is. Gebruik Test om er een te controleren, of Stop posting here om er een te verwijderen.

Zelfde kanaal, zelfde berichten
Extra webhooks plaatsen nooit iets dubbel. Ze verdelen alleen het werk. Hetzelfde idee staat bij Drop thresholds hierboven en de beheerkant in Running the event.
Stap 11

Posten in Discord

#

Admins kunnen als de bot posten via Post to Discord, onder Clan in het adminmenu. Kies een Channel, schrijf je tekst in Message en druk op Send message. Lange tekst, zoals een reglement, wordt vanzelf over meerdere berichten verdeeld.

Send as an embed staat standaard aan en voegt een optionele Title en een Accent colour toe; zet het uit voor platte tekst. Met Ping kies je een rol, of @everyone, om te vermelden, en Anvil vraagt het je voordat het verstuurt.

Elke post die je verstuurt staat onder Sent from here. Edit past hem aan in Discord zonder opnieuw te pingen, en Delete verwijdert hem.

Alleen admins, met de bot
Het post als de bot van Anvil, dus koppel eerst je server. Moderators zien het niet. Het is de schakelaar Post to Discord onder Clan settings → Features; staat die uit, dan verdwijnt het uit het menu.
Stap 12

Als het stil wordt

#

Op volgorde, want elk punt sluit het volgende uit:

Zit de bot echt in de server?Connection op de Discord-pagina zegt het rechtstreeks. „Token geldig” en „in je server” zijn verschillende feiten en het eerste impliceert het tweede niet — bij een gedeelde bot is het token altijd geldig.
Klopt het server-ID?Een verkeerd-maar-echt ID ziet er precies zo uit als een goed ID, tot je merkt dat de posts ergens anders heen gaan.
Bestaat de webhook nog?Een Discord-kanaal verwijderen verwijdert zijn webhook, en Anvil houdt de dode URL. Kies er opnieuw een kanaal voor onder What goes where.
Staat de rol van de bot hoog genoeg?Alleen voor rol- en bijnaamsynchronisatie — zie hierboven. Dit is degene die zwijgend faalt.
Hij kan mensen die binnenkomen niet begroeten
Discord meldt binnenkomsten alleen via een gateway-verbinding, die een gedeelde bot niet voor elke server openhoudt. Er is dus geen „welkom”-post — zet de aanmeldlink in plaats daarvan in een #rollen- of #begin-hier-kanaal, waar mensen toch al kijken.

Alles hier staat op Admin → Discord: bovenaan de snelle installatie, daaronder More settings — Connection, What goes where, Event posts, Roles & nicknames, Team channels, Commands en Post without a bot.

Vastgelopen, of klopt er iets niet? Vraag het in de Anvil-support-Discord