/sebedius-myz-discord-bot

A Discord bot with command utilities for several Year Zero games.

Primary LanguageJavaScriptMIT LicenseMIT

Year Zero Discord Bot

Sebedius is a Discord bot with command utilities for the Mutant: Year Zero, Forbidden Lands and ALIEN roleplaying games by Fria Ligan.

Discord Bots

Add the Bot to your Server

Follow this link: https://discordapp.com/api/oauth2/authorize?client_id=543445246143365130&scope=bot&permissions=289856

The link will prompt you to authorize the bot on a server. Once the bot's authorized, you'll see it in the Member List.

Available Commands

Commands are triggered with the prefix !. This prefix can be configured for your server. Most of the commands can be executed from channels and privately through DMs.

Generic commands

  • help – The bot's manual. Read it!
  • setconf prefix [value] – Changes the bot's prefix to a new value (can be '?' or '>' or anything else). Only a member with administrator rights can change this setting.
  • initiative [quantity] – Draws one or more initiative cards. The deck is specific to each Discord channel. Use the parameter shuffle to reset it. (Which is probably needed at the beginning of every new encounter.)

MYZ commands

  • roll <dice> – Rolls dice for the Mutant: Year Zero roleplaying game. See possible outcome:
    • roll d6|d66|d666 [name] – Rolls a D6, D66, or D666.
    • roll Xd|Xd6 [name] – Rolls X D6 and sums their results.
    • roll res d6|d8|d10|d12 [name] – Rolls a Resource Die. (Concept imported from Forbidden Lands.)
    • roll init [bonus] – Rolls initiative with or without a bonus.
    • roll [Xb][Ys][Zg] [Artifact Die] [name] [--fullauto] – Rolls a pool of dice following the rules of MYZ:
      • X b – Rolls X base dice (yellow color).
      • Y s – Rolls Y skill dice (green color). Use n instead of s for negative dice.
      • Z g – Rolls Z gear dice (black color).
      • Artifact Die – Rolls an Artifact Die (d6|d8|d10|d12). (Concept imported from Forbidden Lands.)
      • --fullauto – Allows unlimited pushes.
  • crit [table] – Rolls for a random critical injury. You may specify a table or a numeric value. The default is the damage table. Other available tables are:
    • nontypical or nt – Critical injury for non-typical damage.
    • horror or h – The Forbidden Lands Horror traumas, adapted for MYZ.
    • pushed – Critical injury for pushed damage (none).
  • scrap [quantity] – Gets you a bunch of scrap.
  • rumor – Tells a random rumor. (Thanks to Myr Midon's work.)
  • mutation – Draws a random mutation (no details).
  • artifact – Draws a random artifact (no details).
  • threat – Draws a random Zone threat (no details).
  • arkthreat – Draws a random threat against the Ark (no details).
  • monster – Generates a random monster according to the tables found in Zone Compendium 1: The Lair of the Saurians.

Forbidden Lands commands

  • rollf <dice> – Rolls dice for the Forbidden Lands roleplaying game. See possible outcome:
    • rollf d6|d66|d666 [name] – Rolls a D6, D66, or D666.
    • rollf Xd|Xd6 [name] – Rolls X D6 and sums their results.
    • rollf res d6|d8|d10|d12 [name] – Rolls a Resource Die.
    • rollf init [bonus] – Rolls initiative with or without a bonus.
    • rollf [Xb][Ys][Zg] [Artifact Die] [name] [--fullauto] – Rolls a pool of dice following the rules of MYZ:
      • X b – Rolls X base dice (yellow color).
      • Y s – Rolls Y skill dice (green color). Use n instead of s for negative dice.
      • Z g – Rolls Z gear dice (black color).
      • Artifact Die – Rolls an Artifact Die (d6|d8|d10|d12).
      • --fullauto – Allows unlimited pushes.
  • crit [table] – Rolls for a random critical injury. You may specify a table or a numeric value. The default is the damage table from MYZ. Other available tables are:
    • horror or h – The Forbidden Lands Horror traumas, adapted for MYZ.
  • demon – Generates a random demon according to the tables found in the roleplaying game Forbidden Lands.
  • legend – Generates a random legend according to the tables found in the roleplaying game Forbidden Lands.

ALIEN commands

  • rolla <dice> – Rolls dice for the ALIEN roleplaying game. See possible outcome:
    • rolla d6|d66|d666 [name] – Rolls a D6, D66, or D666.
    • rolla Xd|Xd6 [name] – Rolls X D6 and sums their results.
    • rolla res|supply <rating> [name] – Rolls for a supply.
    • rolla init [bonus] – Rolls initiative with or without a bonus.
    • rolla [Xb][Ys][Zg] [Artifact Die] [name] [--fullauto] – Rolls a pool of dice following the rules of ALIEN:
      • X b – Rolls X base dice (black color).
      • Y s – Rolls Y stress dice (yellow color).
      • --fullauto – Allows unlimited pushes.
  • crit [table] – Rolls for a random critical injury. You may specify a table or a numeric value. The default is the damage table from MYZ. Other available tables are:
    • alien or a – The ALIEN Critical injuries.
    • synth or s – The ALIEN Critical injuries on Synthetics and Androids.
    • xeno or x – The ALIEN Critical injuries on Xenomorphs.
    • mental or m – The ALIEN Permanent Mental traumas.
  • panic <stress> – Rolls a random panic effect for the ALIEN roleplaying game.
  • star – Generates a random star sector for the ALIEN rpg.
  • colony – Generates a random colonized planet for the ALIEN rpg.
  • job – Generates a random job for the ALIEN rpg.

Roll Examples

roll 4b1g – Rolls 4 base and 1 gear dice.

roll 5b3s Shake-It Off! – Rolls 5 base, 3 skill dice, named "Shake-It Off!".

roll 4b3s2g d10 Uber ROLL --fullauto – Rolls 4 base, 3 skill, 2 gear dice and a D10 Artifact Die. The roll is named "Uber ROLL" and can be pushed any number of times.

rolla 8b2s – Rolls 8 base and 2 stress dice for ALIEN. Pushing them will add an extra stress die.

roll d66 – Rolls a D66 (D6 × 10 + D6).

roll 2d – Rolls two hexahedrons and sums their results.

roll res d8 Torches – Rolls a D8 Resource Die for "Torches".

rolla supply 6 Air – Rolls supply for "Air" with six stress dice and count ones (banes).

roll init 1 – Rolls a D6 labelled "Initiative" and adds 1 to the result.

init or init 1 – Draws one initiative cards.

init shuffle – Shuffles all the initiative cards in a new deck (= reset).

panic 4 – Rolls a D6 and adds 4 to the result, then returns the result from the ALIEN roleplaying game Panic table.

Dice Cap

The maximum number of dice that can be rolled at once is capped at 42. (Discord messages have a limited number of characters.)

Pushing

The push option for the dice pool roll is available for 60 seconds. Only the user who initially rolled the dice can push them.

Command Aliases

Most commands have aliases. For example, hitting !roll or !sla or !rm has the same output.

Send !help <command> for a list of aliases for a specific command.

Permissions

This is a detailed list of needed permissions:

  • ADD_REACTIONS : The bot uses a reaction menu for roll pushing.
  • VIEW_CHANNEL : Mandatory.
  • SEND_MESSAGES : Mandatory.
  • MANAGE_MESSAGES : The bot needs this permission to remove pushing reaction emojis.
  • EMBED_LINKS : The bot uses rich embed to display the dice results.
  • USE_EXTERNAL_EMOJIS : The bot uses custom dice emojis.

List of Changes

See the CHANGELOG for a complete list of changes applied to the Bot.

License

The literal and graphical information presented with this bot about Mutant: Year Zero, Forbidden Lands & ALIEN, including the textures, is copyright Fria Ligan / Free League Publishing. This bot is not produced by, endorsed by, supported by, or affiliated with Fria Ligan.

The bot's JS source code is under MIT license.

FBL dice's images are courtesy of M. Hilton Perantunes. Thanks to him for sharing them.

ALIEN dice's images are courtesy of M. Radomir Balint. Thanks to him for sharing them.

Contact

Stefouch#5202 on Discord. Hit me up if you've any question!

Join the Year Zero Worlds discord server for extra support and testing the bot.

=]¦¦¦¬