lazybot v1.10.11

LAZYbot

Discord bot operating in the House server, servicing over 1,300 members March 2019. Written in Node.JS. Currently not available on multiple servers.

This bot has also spawned off LAZYmail, a version of the bot with just the below-mentioned ModMail module. This is in use in the official IBO Discord server and services over 13,800 members March 2019.

Hosting

• Provider: Amazon EC2 Instance
• Region: eu-west-2a
• Instance Type: t2.small
• OS: Windows (for now)
• Running Cost: £0.28 November 2018

Highlights

• Election module - runs a fully-automated election system on Discord with no third-party libs that, in order:
  • Allow choosing of customisable settings, such as date, voting system, scope of election, electorate list, various rules such as whether to find and exclude dupe accounts, where to set a minimum threshold on messages, on sponsors required for nominations, on number of elections able to run for (if holding several at the several time), and who the voters are.
  • Allows a 'sponsoring' system to nominate candidates
  • Registers candidates, registers votes (based on members in Discord server)
  • Sends round customisable ballots
  • Receives votes through DM channels (for secret ballots), parses the information, and stores them
  • Counts them and parses results
  • Outputs winners using an 'emoji react' system - when a sufficient number of emojis are pressed, results are revealed
• Profile module - creates a 'profile' for each Discord user with:
  • Basic administratory information (user ID, date joined and the like from Discord API)
  • Integration with the lichess and chess.com API to support account linking
  • Customisable finger notes
  • Count messages sent in the server
  • Ability for moderators to add Trophies to certain users
• ModMail module - new modmail created from scratch that's intuitive, aesthetic, and easy to use
  • Specifically designed to not rely on a database of messages
  • Allows actions on mods' side: 'close', 'reply anonymously', 'reply', 'warn user', 'timeout user'
  • Supports image attachment
  • Display basic user information
• Systemised event handler through the router module
  • Handles events generated from the Discord client in an expandable and readable way
• An effective Parse API that takes data stored in a Discord message and parses it into a useful object that can be interacted with for the purposes of the bot
• An effective Search-resolvable API where functions using Discord members, channels, servers, roles, and emojis can search for them by ID, tag, username, aliases, or nickname.
• Permissions system that allows limitations on certain commands to who can use them
• Linking of Discord account with Lichess and Chess.com, parsing data from their APIs
  • Parses rating data and automatically updates it, available through !profile
  • Parses other personal information (like name, country) and makes it available through !profile
  • Compares that data in the database with that of other users, for comparison in leaderboards through the command !lb
  • Allows users to use !myrank to display one's ranking compared to all other users for all variants

Other features (src/modules)

• Custom reactions system with either set phrases, embeds, or emojis
• Help modules with !commands and individual messages with !help
• Stores and returns embeds which are editable:
  • Some of which are multiple pages long;
  • Accepts emoji reactions as acceptable inputs to turn pages
• Backs up data periodically
• Allows users to change their username colour
• Extends the native maths library to include:
  • Combinations and permuations
  • Binomial calculations
  • Random generators
• Reddit API to detect when subreddits are mentioned and provide a link to them
• Odds generator for betting between any two matches based on percentage change of winning a single game
• Uses an API from chessvariants.training to get, parse, and generate random puzzles from the !puzzle command. Also, displays the daily puzzle from lichess by crawling the lichess puzzle
• Handles, parses, and generates boards using the chess.com API from FENs (Forsyth-Edwards Notation, a format of representing a position on a chess board)
• Utility functions such as setting bot username, nickname, streaming link and title, bot version
• As well as basic utility functions such as get ping, uptime, and quote messages
• As well as developers utility functions such as convert a Discord Embed to raw JSON, convert Discord text to Markdown, output JSONs, output various strings and errors

In active development