You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

getting-started.md 2.4 KiB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. ---
  2. uid: FAQ.Basics.GetStarted
  3. title: Beginner Questions / How to Get Started
  4. ---
  5. # Basic Concepts / Getting Started
  6. ## How do I add my bot to my server/guild?
  7. You can do so by using the [permission calculator] provided
  8. by FiniteReality.
  9. This tool allows you to set the permissions that the bot will be
  10. added with, and invite the bot into your guild. With this method,
  11. bots will also be assigned their own special roles that normal users
  12. cannot use; this is what we call a `Managed` role, and this is a much
  13. safer method of permission management than to create a role that any
  14. users can be assigned to.
  15. [permission calculator]: https://finitereality.github.io/permissions-calculator
  16. ## What is a token?
  17. A token is a credential used to log into an account. This information
  18. should be kept **private** and for your eyes only. Anyone with your
  19. token can log into your account. This applies to both user and bot
  20. accounts. That also means that you should never ever hardcode your
  21. token or add it into source control, as your identity may be stolen
  22. by scrape bots on the internet that scours through constantly to
  23. obtain a token.
  24. ## What is a client/user/object ID?
  25. Each user and object on Discord has its own snowflake ID generated
  26. based on various conditions.
  27. ![Snowflake Generation](images/snowflake.png)
  28. The ID can be seen by anyone; it is public. It is merely used to
  29. identify an object in the Discord ecosystem. Many things in the
  30. Discord ecosystem require an ID to retrieve or identify the said
  31. object.
  32. There are 2 common ways to obtain the said ID.
  33. ### [Discord Developer Mode](#tab/dev-mode)
  34. By enabling the developer mode you can right click on most objects
  35. to obtain their snowflake IDs (please note that this may not apply to
  36. all objects, such as role IDs, or DM channel IDs).
  37. ![Developer Mode](images/dev-mode.png)
  38. ### [Escape Character](#tab/escape-char)
  39. You can escape an object by using `\` in front the object in the
  40. Discord client. For example, when you do `\@Example#1234` in chat,
  41. it will return the user ID of the aforementioned user.
  42. ***
  43. ## How do I get the role ID?
  44. > [!WARNING]
  45. > Right-clicking on the role and copying the ID will **not** work.
  46. > This will only copy the message ID.
  47. Several common ways to do this:
  48. 1. Make the role mentionable and mention the role, and escape it
  49. using the `\` character in front.
  50. 2. Inspect the roles collection within the guild via your debugger.