Skip to content
This repository was archived by the owner on Sep 18, 2024. It is now read-only.

Readme edits #184

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 63 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,70 @@
---
description: 'The unofficial Discord.js beginner''s guide, written by idiots for beginners.'
---
<div align='center'>
<h1>An Idiots Guide</h1>
<h4>Discord.JS Bot Guide</h4>
<p>
<em>The unofficial Discord.JS beginner's guide, written by idiots, for beginners</em>
</p>
</div>

# Welcome
Table of Contents
==============

## Introduction
- [Getting Started](https://anidiots.guide/getting-started/)
- [Long Version](https://anidiots.guide/getting-started/getting-started-long-version/)
- [TL;DR (short) Version](https://anidiots.guide/getting-started/getting-started-tl-dr/)

This guide makes a best effort attempt at humanizing the use of the Discord.js library, in its current version 13 iteration. It is maintained by York\#0001 and Discordaholic\#0001 \("Evie.Codes"\), with the help of many precious contributors that enable us to keep updating and enhancing this guide.
- [First Bot](https://anidiots.guide/first-bot/)
- [Your First Bot](https://anidiots.guide/first-bot/your-first-bot/)
- [Adding a Config File](https://anidiots.guide/first-bot/adding-a-config-file/)
- [Command with Arguments](https://anidiots.guide/first-bot/command-with-arguments/)
- [Basic Command Handler](https://anidiots.guide/first-bot/a-basic-command-handler/)
- [The BETTER Basic Command Handler](https://anidiots.guide/first-bot/better-basic-handler/)
- [Using Embeds in Messages](https://anidiots.guide/first-bot/using-embeds-in-messages/)

It was born out of necessity - the first version of this guide for Discord.js version 7, more than 5 years ago, was the first of its kind because I \(Evie\) could not find any such beginner's guide and the documentation was \(and still is\) unfathomably difficult to navigate for anyone without a sufficiently advanced knowledge of JavaScript concepts.
- [Coding Guides](https://anidiots.guide/coding-guides/)
- [SQLite-Based Points System](https://anidiots.guide/coding-guides/sqlite-based-points-system/)
- [Using Emojis](https://anidiots.guide/coding-guides/using-emojis/)
- [Making a Starboard](https://anidiots.guide/coding-guides/making-your-own-starboard/)
- [Tracking Used Invites](https://anidiots.guide/coding-guides/tracking-used-invites/)
- [Using Audit Logs](https://anidiots.guide/coding-guides/using-audit-logs/)

In this guide we make every effort to _teach_ you how to use the library and how to extend it with your own code. We do, however expect you to have a basic understanding of JavaScript before attempting to write bots. Discord.js \(and other discord libraries\) require some median-to-advanced concepts that might be hard to grasp for anyone that doesn't have a good footing with the language.
- [Understanding](https://anidiots.guide/understanding/)
- [Events and Handlers](https://anidiots.guide/understanding/events-and-handlers/)
- [Collections](https://anidiots.guide/understanding/collections/)
- [Roles & Permissions](https://anidiots.guide/understanding/roles/)
- [Sharding](https://anidiots.guide/understanding/sharding/)

## Get Support
- [Examples](https://anidiots.guide/examples/)
- [Making an "Eval" command](https://anidiots.guide/examples/making-an-eval-command/)
- [Misc. Examples](https://anidiots.guide/examples/miscellaneous-examples/)

If you have any questions after reading this guide, please don't hesitate to join us on our Discord server, "An Idiot's Guide". The link is located at the top of this page. If you wish to consult with the discord.js developers and official community, the Discord.js official discord is right next to ours, still at the top of the page!
- [Discord Webhooks](https://anidiots.guide/discord-webhooks/)
- [Webhooks (Part 1)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-1/)
- [Webhooks (Part 2)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-2/)
- [Webhooks (Part 3)](https://anidiots.guide/discord-webhooks/discord-webhooks-part-3/)

- Video Guides *(coming.. soon™️)*

- [Other Guides](https://anidiots.guide/other-guides/)
- [Installing and Using "Atom"](https://anidiots.guide/other-guides/installing-and-using-a-proper-editor/)
- [Using "Git" to Update and Share Code](https://anidiots.guide/other-guides/using-git-to-share-and-update-code/)
- [Using Environment Variables](https://anidiots.guide/other-guides/env-files/)
- [Async / Await](https://anidiots.guide/other-guides/async-await/)


Welcome!
========

## What even is this?

This guide makes a best effort attempt at humanizing the use of the Discord.JS library, in its current version 13 iteration. It is maintained by York#0001 and Discordaholic#0001 *("Evie.Codes")*, with the help of many precious contributors that enable us to keep updating and enhancing this guide.

## How did it start?

It was born out of necessity - the first version of this guide for Discord.js version 7, more than 5 years ago, was the first of its kind because I *(Evie)* could not find any such beginner's guide and the documentation was *(and still is)* unfathomably difficult to navigate for anyone without a sufficiently advanced knowledge of JavaScript concepts.

In this guide we make every effort to _teach_ you how to use the library and how to extend it with your own code. We do, however expect you to have a basic understanding of JavaScript before attempting to write bots. Discord.js *(and other discord libraries)* require some median-to-advanced concepts that might be hard to grasp for anyone that doesn't have a good footing with the language.

## Need Support?

If you have any questions after reading this guide, please don't hesitate to join us on our [Discord](https://discord.gg/vXVxsAjSMF) server, "An Idiot's Guide". If you wish to consult with the Discord.JS developers and official community, you can join their Discord [here](https://discord.gg/djs)
5 changes: 4 additions & 1 deletion coding-guides/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,4 @@
# Coding Guides
Coding Guides
=============

In this section, we are going to give you some guides on how to add even cooler things to your bot such as a point system, starboard system, and more!
6 changes: 4 additions & 2 deletions discord-webhooks/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
# Discord Webhooks

Discord Webhooks
================

Now we're getting into the "cool zone" 😎

In this section we will teach you everything you need to know about Discord and their cool-ass webhooks
7 changes: 6 additions & 1 deletion examples/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,6 @@
# Examples
Examples
========

Trust me, we know that sometimes getting that extra example or 2 will really help you.

And that's exactly what this section is about!
7 changes: 6 additions & 1 deletion first-bot/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,6 @@
# First Bot
First Bot
=========

We've got you started! Awesome!

Now we are going to get your first bot up and running that has: commands, handlers, and all of that cool-fun-stuff!
9 changes: 7 additions & 2 deletions getting-started/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
# Getting Started
Getting Started!
================

In this section we will teach you how to get started in the world of bot development!
You've finally decided to give in and start developing Discord bots and ditching bots like *"MEE6"* and *"Dyno"*

We promise, you've made the good decision.

In this section we are going to get you started in the world of Discord Bot Development!
6 changes: 4 additions & 2 deletions other-guides/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
# Other Guides

Other Guides
============

Well aren't you just a smart cookie for wanting to learn more!

Here throughout the different sub-sections of this section, we are going to provide some other useful guides that may be valuable!
7 changes: 6 additions & 1 deletion understanding/README.md
Original file line number Diff line number Diff line change
@@ -1 +1,6 @@
# Understanding
Understanding
=============

We get it, there are a lot of words being thrown at you like "Collections", "Sharding", and all that shat like that.

In this section, we will help you understand everything you need to understand to get you off your feet and on your way to making the next *"Dyno"* !