diff --git a/docs/es/general/rabot.md b/docs/es/general/rabot.md index ee8cae09..a375cf45 100644 --- a/docs/es/general/rabot.md +++ b/docs/es/general/rabot.md @@ -5,53 +5,29 @@ description: Aprende sobre RABot, el bot oficial de RetroAchievements en Discord # RABot, el bot de RA para Discord -RABot es el robot oficial de RetroAchievements en Discord. Por tanto, para interactuar con él, necesitas ser miembro del [servidor de Discord de RA](https://discord.gg/dq2E4hE). +RABot es el robot oficial de RetroAchievements en Discord. Por tanto, para interactuar con él, necesitas ser miembro del [servidor de Discord de RA](https://discord.gg/retroachievements). RABot tiene muchos comandos geniales y útiles, y en esta página verás algunos ejemplos de cómo se pueden usar algunos de ellos. -RABot utiliza [JavaScript](https://developer.mozilla.org/es/docs/Web/JavaScript), [Node.js](https://nodejs.org/es/), [discord.js](https://discord.js.org/) y [Commando](https://discord.js.org/#/docs/commando/master/general/welcome). - -**Agradecimientos especiales**: al [bot Xiao de DragonFire](https://github.com/dragonfire535/xiao/), ya que ha sido una gran fuente de inspiración para muchos de los comandos geniales que tenemos en RABot, como [`!bulbapedia`](#bulbapedia), [`!manga`](#manga), [`!translate`](#translate), [`!define`](#define) y otros. +RABot utiliza [Bun](https://bun.sh/), [TypeScript](https://www.typescriptlang.org/), [discord.js](https://discord.js.org/), y [Drizzle ORM](https://orm.drizzle.team/). ## Obtener ayuda -### `!help` - -Este comando hace que RABot envíe un mensaje directo con la lista de comandos disponibles. - -Si necesitas ayuda sobre un comando específico, usa `!help nombre_del_comando`. - -### `!docs` - -Proporciona enlaces a la documentación de RetroAchievements. - -![docs](/rabot-docs.png) +### `/topic` -![docs1](/rabot-docs1.png) - -### `!rarch` - -Proporciona información básica sobre RetroArch. - -![rarch](/rabot-rarch.png) +![topic command usage](/rabot-topic.png) ### `!rules` Muestra las reglas, o una en concreto. -![rules](/rabot-rules.png) - -### `!about` - -Muestra información sobre el RABot. +![rules](/rabot-rule.png) -![about](/rabot-about.png) +### `/status` -### `!panic` +Displays bot status and statistics. -Qué hacer cuando el sitio está caído. - -![panic](/rabot-panic.png) +![status command usage](/rabot-status.png) ## Crear encuestas @@ -65,176 +41,27 @@ Crea una encuesta simple. La gente puede votar añadiendo reacciones, pero tambi Crear una encuesta cronometrada. En este tipo de encuesta, solo la primera reacción se considera un voto, y si la gente reacciona con una reacción no listada, entonces el voto se anula. -![tpoll](/rabot-tpoll.png) - -## Tratar con números - -### `!hex` - -Convierte un número no negativo de decimal (o binario) a hexadecimal (o viceversa). - -![hex](/rabot-hex.png) - -### `!bin` - -Convierte un número no negativo de decimal (o hexadecimal) a binario (o viceversa). - -![bin](/rabot-bin.png) - -### `!calculator` - -**Alias**: `!calc` - -Evalúa la expresión matemática dada y responde con el resultado. - -![calculator](/rabot-calculator.png) - -## Obtener información/enlaces de RetroAchievements.org - -### `!ragame` - -**Alias**: `!game` - -Busca un juego en RetroAchievements.org y muestra el enlace. - -![ragame](/rabot-ragame.png) - -### `!tickets` - -Devuelve el enlace de la página de tickets abiertos del nombre del juego dado. - -![tickets](/rabot-tickets.png) - -### `!whatgame` - -**Alias**: `!wg` - -Responde con un juego aleatorio que tenga logros. - -![whatgame](/rabot-whatgame.png) - -![whatgame1](/rabot-whatgame1.png) - -### `!whatcheevo` - -Responde con un logro aleatorio. - -## Datos curiosos - -### `!funfact` - -Responde con un dato curioso sobre videojuegos retro. - -**Nota**: puedes sugerir más entradas de datos curiosos [aquí](https://github.com/RetroAchievements/RABot/issues/2). - -![funfact](/rabot-funfact.png) - -### `!memefact` - -**Alias**: `!meme` - -Responde con un dato curioso sobre RetroAchievements en forma de meme. - -**Nota**: puedes sugerir más entradas de datos curiosos [aquí](https://github.com/RetroAchievements/RABot/issues/6), pero ten en cuenta estas 2 reglas simples **1)** no puedes sugerir tu propia cita; y **2)** al sugerir una cita, asegúrate de obtener la aprobación del autor y/o de la persona mencionada. - -![memefact](/rabot-memefact.png) - -## Obtener información relacionada con los videojuegos - -### `!gamefaqs` - -**Aliases**: `!gamefaq`, `!gfaq` - -Busca un juego en GameFAQs y muestra el enlace. - -![gamefaqs](/rabot-gamefaqs.png) - -### `!longplay` - -**Aliases**: `!lplay`, `!lp` - -Busca un video de longplay en youtube y muestra el enlace. - -![longplay](/rabot-longplay.png) - -### `!vgmaps` - -**Alias**: `!vgmap` - -Busca en vgmaps.com el mapa de un videojuego. - -![vgmaps](/rabot-vgmaps.png) - -### `!howlongtobeat` - -**Alias**: `!hltb` - -Busca un juego en howlongtobeat.com y muestra el enlace. - -![howlongtobeat](/rabot-howlongtobeat.png) - -## Miscelánea - -### `!define` - -**Aliases**: `!dictionary`, `!dict` - -Define una palabra. - -![define](/rabot-define.png) - -### `!translate` - -**Alias**: `!tr` - -Traduce un texto a un idioma específico. **Gracias a ** - -![translate](/rabot-translate.png) - -![translate1](/rabot-translate1.png) - -### `!urban` - -Define una palabra, pero con Urban Dictionary. - -![urban](/rabot-urban.png) - -### `!wikipedia` - -**Alias**: `!wp` - -Busca en Wikipedia tu consulta. - -![wikipedia](/rabot-wikipedia.png) - -### `!youtube` - -**Alias**: `!yt` - -Busca un video en youtube y muestra el primero que encuentre. - -![youtube](/rabot-youtube.png) -### `!bulbapedia` +## Comandos del desarrollador -Busca en Bulbapedia tu consulta. +### `/gan ` -![bulbapedia](/rabot-bulbapedia.png) +![gan command usage](/rabot-gan.png) -### `!movie` +### `/gan2 ` -Busca en TMDB tu consulta, obteniendo resultados de películas. +![gan2 command usage](/rabot-gan2.png) -![movie](/rabot-movie.png) +### `!mem` -### `!manga` +![mem command usage](/rabot-mem.png) -Busca en AniList tu consulta, obteniendo resultados de manga. +## Comandos de herramientas y diversión -![manga](/rabot-manga.png) +### `/dadjoke` -### `!anime` +![dadjoke command usage](/rabot-dadjoke.png) -Busca en AniList tu consulta, obteniendo resultados de anime. +### `/frames` -![anime](/rabot-anime.png) +![frames command usage](/rabot-frames.png) diff --git a/docs/general/rabot.md b/docs/general/rabot.md index 7e371482..2f3c359e 100644 --- a/docs/general/rabot.md +++ b/docs/general/rabot.md @@ -5,236 +5,101 @@ description: Learn about RABot, the official RetroAchievements Discord bot, and # RABot, the RA Discord Robot -RABot is the official RetroAchievements Discord robot. Therefore, to interact with him, you need to be a member of the [RA Discord server](https://discord.gg/dq2E4hE). +RABot is the official RetroAchievements Discord robot. +Therefore, to interact with it, you need to be a member of the [RA Discord server](https://discord.gg/retroachievements). -RABot has many cool and useful commands, and in this page you'll see some examples of how some of them can be used. +RABot has many cool and useful commands, and on this page you'll see some examples of how some of them can be used. -RABot is powered by [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript), [Node.js](https://nodejs.org/), [discord.js](https://discord.js.org/) and [Commando](https://discord.js.org/#/docs/commando/master/general/welcome). +RABot is powered by [Bun](https://bun.sh/), [TypeScript](https://www.typescriptlang.org/), [discord.js](https://discord.js.org/), and [Drizzle ORM](https://orm.drizzle.team/). -**Special thanks**: the [DragonFire's Xiao bot](https://github.com/dragonfire535/xiao/) is a great source of inspiration for many of the cool commands we have in RABot, like [`!bulbapedia`](#bulbapedia), [`!manga`](#manga), [`!translate`](#translate), [`!define`](#define) and others. +RABot is open source! You can view its code on GitHub at [RetroAchievements/RABot-Next](https://github.com/RetroAchievements/RABot-Next). +Contributions are welcome! -## Getting help +## General Commands -### `!help` +### `/topic` -This command makes the RABot send a DM with the list of commands available. +Displays the current channel topic. -If you need help about a specific command use `!help command_name`. +![topic command usage](/rabot-topic.png) -### `!docs` +### `!rule` -Provide links to RetroAchievements documentation. +Note: This command has not yet been converted to a slash command yet! -![docs](/rabot-docs.png) +Displays server rules, or a specific rule if specified. -![docs1](/rabot-docs1.png) +![rule command usage](/rabot-rule.png) -### `!rarch` +![rule command usage](/rabot-rule-2.png) -Provide basic info about RetroArch. +### `/contact` -![rarch](/rabot-rarch.png) +Shows contact information for various RA teams. -### `!rules` +![contact command usage](/rabot-contact.png) -Show the rules, or a specific one. +### `/status` -![rules](/rabot-rules.png) +Displays bot status and statistics. -### `!about` +![status command usage](/rabot-status.png) -Show info about the RABot. +## Poll Commands -![about](/rabot-about.png) +### `/poll` -### `!panic` +Creates a simple poll (up to 10 options) -What to do when the site is down. +![poll command usage](/rabot-poll.png) -![panic](/rabot-panic.png) +### `/tpoll` -## Creating polls +Creates a timed poll that automatically closes. -### `!poll` +Note that a native Discord poll might be easier and more intuitive to use, and also closed automatically. -Creates a simple poll. People can vote adding reactions, but they can also vote with unlisted reactions. See [`!tpoll`](#tpoll) if you are interested in a more advanced and serious poll. +![tpoll command usage](/rabot-tpoll.png) -![poll](/rabot-poll.png) +Example when it closes: -### `!tpoll` +![tpoll command usage](/rabot-tpoll-closed.png) -Creates a timed poll. In this kind of poll only the first reaction is considered a vote, and if people react with an unlisted reaction then the vote is voided. +## Developer Commands -![tpoll](/rabot-tpoll.png) +Developers, these are for you! -## Dealing with numbers +### `/gan ` -### `!hex` +Generates an achievement news template. -Converts a non-negative integer from decimal (or binary) to hexadecimal (or vice-versa). +![gan command usage](/rabot-gan.png) -![hex](/rabot-hex.png) +### `/gan2 ` -### `!bin` +Generates a pretty achievement news template with colors. -Converts a non-negative integer from decimal (or hexadecimal) to binary (or vice-versa). +![gan2 command usage](/rabot-gan2.png) -![bin](/rabot-bin.png) +### `!mem` -### `!calculator` +Note: This command has not yet been converted to a slash command yet! -**Alias**: `!calc` +Parses MemAddr strings and show achievement logic. +Supply either an achievement id, achievement url, or a memaddr. -Evaluates the given math expression and responds with the result. +![mem command usage](/rabot-mem.png) -![calculator](/rabot-calculator.png) +## Fun & Tool Commands -## Getting RetroAchievements.org info/links +### `/dadjoke` -### `!ragame` +Gets a random dad joke. -**Alias**: `!game` +![dadjoke command usage](/rabot-dadjoke.png) -Google for a game at RetroAchievements.org and show the link. +### `/frames` -![ragame](/rabot-ragame.png) +Converts between time and frames at different frame rates. -### `!tickets` - -Return the URL for the open tickets page of the given game name. - -![tickets](/rabot-tickets.png) - -### `!whatgame` - -**Alias**: `!wg` - -Responds with a random game that has achievements. - -![whatgame](/rabot-whatgame.png) - -![whatgame1](/rabot-whatgame1.png) - -### `!whatcheevo` - -Responds with a random achievement. - -## Random facts - -### `!funfact` - -Responds with a retrogaming fun fact. - -**Note**: you can suggest more fun fact entries [here](https://github.com/RetroAchievements/RABot/issues/2). - -![funfact](/rabot-funfact.png) - -### `!memefact` - -**Alias**: `!meme` - -Responds with a RetroAchievements meme fact. - -**Note**: you can suggest more meme fact entries [here](https://github.com/RetroAchievements/RABot/issues/6), but keep these 2 simple rules in mind **1)** you can't suggest your own quote; and **2)** when suggesting a quote, be sure to get an approval from the author and/or the person being mentioned. - -![memefact](/rabot-memefact.png) - -## Getting gaming related info - -### `!gamefaqs` - -**Aliases**: `!gamefaq`, `!gfaq` - -Google for a game at GameFAQs and show the link. - -![gamefaqs](/rabot-gamefaqs.png) - -### `!longplay` - -**Aliases**: `!lplay`, `!lp` - -Search for a longplay video on youtube and post the link. - -![longplay](/rabot-longplay.png) - -### `!vgmaps` - -**Alias**: `!vgmap` - -Searches vgmaps.com for a video game's map. - -![vgmaps](/rabot-vgmaps.png) - -### `!howlongtobeat` - -**Alias**: `!hltb` - -Google for a game at howlongtobeat.com and show the link. - -![howlongtobeat](/rabot-howlongtobeat.png) - -## Miscellaneous - -### `!define` - -**Aliases**: `!dictionary`, `!dict` - -Defines a word. - -![define](/rabot-define.png) - -### `!translate` - -**Alias**: `!tr` - -Translates text to a specific language. **Powered by ** - -![translate](/rabot-translate.png) - -![translate1](/rabot-translate1.png) - -### `!urban` - -Defines a word, but with Urban Dictionary. - -![urban](/rabot-urban.png) - -### `!wikipedia` - -**Alias**: `!wp` - -Searches Wikipedia for your query. - -![wikipedia](/rabot-wikipedia.png) - -### `!youtube` - -**Alias**: `!yt` - -Search for a video on youtube and post the first one found. - -![youtube](/rabot-youtube.png) - -### `!bulbapedia` - -Searches Bulbapedia for your query. - -![bulbapedia](/rabot-bulbapedia.png) - -### `!movie` - -Searches TMDB for your query, getting movie results. - -![movie](/rabot-movie.png) - -### `!manga` - -Searches AniList for your query, getting manga results. - -![manga](/rabot-manga.png) - -### `!anime` - -Searches AniList for your query, getting anime results. - -![anime](/rabot-anime.png) +![frames command usage](/rabot-frames.png) diff --git a/docs/public/rabot-about.png b/docs/public/rabot-about.png deleted file mode 100644 index 8215970a..00000000 Binary files a/docs/public/rabot-about.png and /dev/null differ diff --git a/docs/public/rabot-anime.png b/docs/public/rabot-anime.png deleted file mode 100644 index c84999f9..00000000 Binary files a/docs/public/rabot-anime.png and /dev/null differ diff --git a/docs/public/rabot-bin.png b/docs/public/rabot-bin.png deleted file mode 100644 index 1d97f281..00000000 Binary files a/docs/public/rabot-bin.png and /dev/null differ diff --git a/docs/public/rabot-bulbapedia.png b/docs/public/rabot-bulbapedia.png deleted file mode 100644 index 8325684c..00000000 Binary files a/docs/public/rabot-bulbapedia.png and /dev/null differ diff --git a/docs/public/rabot-calculator.png b/docs/public/rabot-calculator.png deleted file mode 100644 index 5260ec59..00000000 Binary files a/docs/public/rabot-calculator.png and /dev/null differ diff --git a/docs/public/rabot-contact.png b/docs/public/rabot-contact.png new file mode 100644 index 00000000..441ef7fa Binary files /dev/null and b/docs/public/rabot-contact.png differ diff --git a/docs/public/rabot-dadjoke.png b/docs/public/rabot-dadjoke.png new file mode 100644 index 00000000..72dcc971 Binary files /dev/null and b/docs/public/rabot-dadjoke.png differ diff --git a/docs/public/rabot-define.png b/docs/public/rabot-define.png deleted file mode 100644 index 9d4096fe..00000000 Binary files a/docs/public/rabot-define.png and /dev/null differ diff --git a/docs/public/rabot-docs.png b/docs/public/rabot-docs.png deleted file mode 100644 index 073970ae..00000000 Binary files a/docs/public/rabot-docs.png and /dev/null differ diff --git a/docs/public/rabot-docs1.png b/docs/public/rabot-docs1.png deleted file mode 100644 index aa6bf496..00000000 Binary files a/docs/public/rabot-docs1.png and /dev/null differ diff --git a/docs/public/rabot-frames.png b/docs/public/rabot-frames.png new file mode 100644 index 00000000..cacde1c2 Binary files /dev/null and b/docs/public/rabot-frames.png differ diff --git a/docs/public/rabot-funfact.png b/docs/public/rabot-funfact.png deleted file mode 100644 index 8985be3b..00000000 Binary files a/docs/public/rabot-funfact.png and /dev/null differ diff --git a/docs/public/rabot-gamefaqs.png b/docs/public/rabot-gamefaqs.png deleted file mode 100644 index 711bdf10..00000000 Binary files a/docs/public/rabot-gamefaqs.png and /dev/null differ diff --git a/docs/public/rabot-gan.png b/docs/public/rabot-gan.png new file mode 100644 index 00000000..cb7f8ce4 Binary files /dev/null and b/docs/public/rabot-gan.png differ diff --git a/docs/public/rabot-gan2.png b/docs/public/rabot-gan2.png new file mode 100644 index 00000000..f3598ec8 Binary files /dev/null and b/docs/public/rabot-gan2.png differ diff --git a/docs/public/rabot-hex.png b/docs/public/rabot-hex.png deleted file mode 100644 index 8190cc9a..00000000 Binary files a/docs/public/rabot-hex.png and /dev/null differ diff --git a/docs/public/rabot-howlongtobeat.png b/docs/public/rabot-howlongtobeat.png deleted file mode 100644 index ac13088a..00000000 Binary files a/docs/public/rabot-howlongtobeat.png and /dev/null differ diff --git a/docs/public/rabot-longplay.png b/docs/public/rabot-longplay.png deleted file mode 100644 index a7c06ba2..00000000 Binary files a/docs/public/rabot-longplay.png and /dev/null differ diff --git a/docs/public/rabot-manga.png b/docs/public/rabot-manga.png deleted file mode 100644 index a3853a9c..00000000 Binary files a/docs/public/rabot-manga.png and /dev/null differ diff --git a/docs/public/rabot-mem.png b/docs/public/rabot-mem.png new file mode 100644 index 00000000..4be15b96 Binary files /dev/null and b/docs/public/rabot-mem.png differ diff --git a/docs/public/rabot-memefact.png b/docs/public/rabot-memefact.png deleted file mode 100644 index 6588911f..00000000 Binary files a/docs/public/rabot-memefact.png and /dev/null differ diff --git a/docs/public/rabot-movie.png b/docs/public/rabot-movie.png deleted file mode 100644 index 46cdcbaf..00000000 Binary files a/docs/public/rabot-movie.png and /dev/null differ diff --git a/docs/public/rabot-panic.png b/docs/public/rabot-panic.png deleted file mode 100644 index fcc7d0eb..00000000 Binary files a/docs/public/rabot-panic.png and /dev/null differ diff --git a/docs/public/rabot-poll.png b/docs/public/rabot-poll.png index 9b3670e2..3cfa56c6 100644 Binary files a/docs/public/rabot-poll.png and b/docs/public/rabot-poll.png differ diff --git a/docs/public/rabot-ragame.png b/docs/public/rabot-ragame.png deleted file mode 100644 index da1369e1..00000000 Binary files a/docs/public/rabot-ragame.png and /dev/null differ diff --git a/docs/public/rabot-rarch.png b/docs/public/rabot-rarch.png deleted file mode 100644 index e19819a8..00000000 Binary files a/docs/public/rabot-rarch.png and /dev/null differ diff --git a/docs/public/rabot-rule-2.png b/docs/public/rabot-rule-2.png new file mode 100644 index 00000000..024c4fcd Binary files /dev/null and b/docs/public/rabot-rule-2.png differ diff --git a/docs/public/rabot-rule.png b/docs/public/rabot-rule.png new file mode 100644 index 00000000..5795c805 Binary files /dev/null and b/docs/public/rabot-rule.png differ diff --git a/docs/public/rabot-rules.png b/docs/public/rabot-rules.png deleted file mode 100644 index 0bd78627..00000000 Binary files a/docs/public/rabot-rules.png and /dev/null differ diff --git a/docs/public/rabot-status.png b/docs/public/rabot-status.png new file mode 100644 index 00000000..d78e326f Binary files /dev/null and b/docs/public/rabot-status.png differ diff --git a/docs/public/rabot-tickets.png b/docs/public/rabot-tickets.png deleted file mode 100644 index 7bdb629a..00000000 Binary files a/docs/public/rabot-tickets.png and /dev/null differ diff --git a/docs/public/rabot-topic.png b/docs/public/rabot-topic.png new file mode 100644 index 00000000..4f131bbe Binary files /dev/null and b/docs/public/rabot-topic.png differ diff --git a/docs/public/rabot-tpoll-closed.png b/docs/public/rabot-tpoll-closed.png new file mode 100644 index 00000000..a4270ed8 Binary files /dev/null and b/docs/public/rabot-tpoll-closed.png differ diff --git a/docs/public/rabot-tpoll.png b/docs/public/rabot-tpoll.png index 61589fd6..5fdb0368 100644 Binary files a/docs/public/rabot-tpoll.png and b/docs/public/rabot-tpoll.png differ diff --git a/docs/public/rabot-translate.png b/docs/public/rabot-translate.png deleted file mode 100644 index 9bc2740f..00000000 Binary files a/docs/public/rabot-translate.png and /dev/null differ diff --git a/docs/public/rabot-translate1.png b/docs/public/rabot-translate1.png deleted file mode 100644 index e10cc23f..00000000 Binary files a/docs/public/rabot-translate1.png and /dev/null differ diff --git a/docs/public/rabot-urban.png b/docs/public/rabot-urban.png deleted file mode 100644 index 2b4776e6..00000000 Binary files a/docs/public/rabot-urban.png and /dev/null differ diff --git a/docs/public/rabot-vgmaps.png b/docs/public/rabot-vgmaps.png deleted file mode 100644 index 9c9a8e97..00000000 Binary files a/docs/public/rabot-vgmaps.png and /dev/null differ diff --git a/docs/public/rabot-whatgame.png b/docs/public/rabot-whatgame.png deleted file mode 100644 index f2e49525..00000000 Binary files a/docs/public/rabot-whatgame.png and /dev/null differ diff --git a/docs/public/rabot-whatgame1.png b/docs/public/rabot-whatgame1.png deleted file mode 100644 index db295494..00000000 Binary files a/docs/public/rabot-whatgame1.png and /dev/null differ diff --git a/docs/public/rabot-wikipedia.png b/docs/public/rabot-wikipedia.png deleted file mode 100644 index 9cc32ed4..00000000 Binary files a/docs/public/rabot-wikipedia.png and /dev/null differ diff --git a/docs/public/rabot-youtube.png b/docs/public/rabot-youtube.png deleted file mode 100644 index 07c66550..00000000 Binary files a/docs/public/rabot-youtube.png and /dev/null differ