Skip to content

Wave-Play/robo.js

Repository files navigation

✨🎃 Hacktoberfest 2024 - Build stuff, win free swag 🎃✨


Robo.js

GitHub license npm install size Discord All Contributors

Power up Discord with effortless activities, bots, web servers, and more!

Upgrade your Discord projects with effortless integration, dynamic plugins, and advanced debugging—unlocking the full potential of Discord.js and beyond. 🚀✨

Heads up! This is a pre-release, so brace for some breaking changes before v1.0. 🚧

Documentation

Get well-versed with Robo.js and unlock its full potential!

📚 Documentation: Getting started

📖 Tutorial: Making a "To-do" Robo

🚀 Community: Join our Discord server

Quick start

Kickstart your own Robo.js bot with our super-helpful CLI:

npx create-robo my-awesome-bot

We'll walk you through a breezy customization process and whip up a fully working template in no time!

Upgrading an existing bot

Got a bot that's simple or loaded with complexity? No worries! We've whipped up three migration paths that cater to all bot types. For the full lowdown, our migration guide is ready and waiting. Pick the path that makes your bot's transition smoother than butter on a hot day.

📚 Documentation: Migration guide

Epic Simplicity

Robo.js dishes out Discord.js goodness with a focus on simplicity, making it easy-peasy to craft bots that truly sparkle – all without compromises! 🌟

  • Easy-peasy: No fuss, just a smooth start to bot development, so you can focus on crafting cool features.
  • Built-in awesomeness: Commands, events, plugins - it's all there, ready to create bots that pack a punch.
  • Sage's helping hand: Sage simplifies command interaction and offers smart error replies, making debugging a breeze.
  • Customizable & scalable: Adjust, grow, and adapt your bot as needed with Robo.js's flexibility.
  • Community power: Tap into the know-how and support of the Discord.js community.

Usage

Crafting a simple Robo is a piece of cake! First, whip up a /ping command by creating a ping.js file in your /src/commands folder:

export default () => {
	return 'Pong!'
}

Miss your interaction object? No worries, it's still got your back! Here's another example using interaction.reply:

export default (interaction) => {
	interaction.reply('Pong!')
}

For events, say you want to listen to messageCreate events. Create a messageCreate.js file inside your /src/events folder:

export default (message) => {
	if (message.content.includes('hello')) {
		message.channel.send('Hello there!')
	}
}

Following the above examples, your file structure should look a lil' something like this:

src/
├── commands/
│   └── ping.js
└── events/
    └── messageCreate.js

Before you get your Robo rockin', update your .env with DISCORD_TOKEN and DISCORD_CLIENT_ID. Then, hit robo dev and let the show begin! Seriously, that's it!

Crave more power? Check the Documentation! 🔥

No Learning Curve

Get ready for a twist - there's virtually no learning curve with Robo.js!

Wait, is it actually an... inverse learning curve? You heard right, there's more to unlearn than learn! It's that simple, yet you still have access to all that Discord.js has to offer, just easier and with less code. 🎉

License 📜

We're all about freedom, so we've got you covered with the permissive MIT License! Go wild and build amazing bots without worrying about legalities.

Contributors

Pkmmte Xeleon
Pkmmte Xeleon

💻 🚧
Alexander
Alexander

💻 🚧
Mouiz
Mouiz

📖
Matej Bošnjak
Matej Bošnjak

📖
Arnav K
Arnav K

💡 🔌 📖
waru
waru

💻
Add your contributions