Mirai: A JavaScript repository from gcolotti

An easy to use bot framework using the Eris library. NodeJS version 6+ is REQUIRED

Website | Support on Patreon | Documentation | Discord Server | Eris Docs | Todo List

Installing:

Install NodeJS Git and Python2.7 (and add them to your PATH).
Download Mirai Bot and configure it using the reference below.
Run npm i --no-optional --production and then, optionally, npm i eventemitter3 bluebird --no-optional --production.
Make any modifications.
Add your bot using https://discordapp.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot.
Run the bot with node Mirai.js

Example of a command

// Mirai\commands\examples\example.js
// Only 'task' is required. Everything else is optional.

module.exports = {
	desc: "A short description",
	help: "A longer description of what the command does and how to use it.",
	usage: "<hello> [world]",
	aliases: ['ex', 'e'], // Aliases 'ex' and 'e'
	cooldown: 5, // 5 seconds
	hidden: true, // Hidden from help command
	ownerOnly: true, // Only a user in config.adminIds can use this
	guildOnly: true, // This can't be used in a DM
	requiredPermission: 'manageMessages', // You need manageMessages to use this
	task(bot, msg, suffix, config, settingsManager) { // Available args
		if (suffix.startsWith('hello'))
			return bot.createMessage(msg.channel.id, suffix);
		return 'wrong usage'; // Send the correct usage to the user
	}
}

Example of an event

// Mirai\events\guildCreate.js

module.exports = function(bot, settingsManager, config, guild) {
	if (config.logNewGuilds)
		console.log(`New Guild: ${guild.name}`);
}

Config Reference

token: The Bot's token.
shardCount: The number of shards to run.
disableEvents: An object containing events to disable. This saves resources. A full list of events can be found here: Eris Reference.
commandSets: An object defining what commands to load. The key is the prefix, dir is the path to the from the root of the bot. If you want to make the commands a certain color in the console add a color property with a valid chalk color.
reloadCommand: The command to use for reloading modules/commands.
evalCommand: The command to use for running arbitrary code.
adminIds: An array of user ids that have full control over the bot.
logTimestamp: If the console should include timestamps.
cleverbot: If cleverbot should be enabled.
inviteLink: A link to add the bot to a server.
errorMessage: An optional error message to post in chat.
carbonKey: Your key for updating carbon information.
abalBotsKey: Your https://bots.discord.pw/ API key.
cycleGames: Randomly changes the bot's status.
bannedGuildIds: Servers that can not add the bot.
whitelistedGuildIds: For future use.

Naming commands and invalid prefixes

Command names must not contain a space or a |. Prefixes must not contain a |. Avoid using a @ as it may resolve into a user.