如何在 Hikari 中创建角色并将其添加到公会?

How do I create a role and add it to guild in Hikari?

所以基本上我正在尝试创建一个角色并将其添加到 Hikari 中的公会。我一直在谷歌搜索和查看文档,但我似乎找不到任何可以添加角色的东西,如果这不可能,是否有任何解决方法?

您要查找的文档位于 here

hikari.GatewayBot 有一个用于对 Discord 进行 api 调用的休息客户端 - 这是机器人的 rest 属性。

在此代码块中,机器人每次在线时被邀请加入新公会时,都会使用其余客户端创建一个名为 new-role-name 的角色。

import os
import hikari


bot = hikari.GatewayBot(os.environ["TOKEN"])

@bot.listen()
async def on_guild_join(event: hikari.GuildJoinEvent) -> None:
    await bot.rest.create_role(event.guild_id, name="new-role-name")


if __name__ == "__main__":
    bot.run()

请记住,如果机器人在它刚加入的公会中没有 MANAGE_ROLES 权限,此代码将引发 ForbiddenError.