expand_less TCN
Icon Teyvat Collective Network

Global Chat

link What is it?

Global chat is a system that connects channels across the TCN and allow users to chat with each other through it. There are three network-wide channels:

  • TCN - Public "general" channel which can be made accessible to all server members.
  • lounge - Staff general chat which can be made accessible to anyone who can access your server's staff chat.
  • office - Staff business channel which can be made accessible to your staff.

link Setup

link Adding the bot

First, invite the bot to your server using this link.

link Permissions

You need to ensure the bot has all of the following permissions in all global channels that you want to use:

  • View Channel: to be able to relay messages
  • Read Message History: to be able to fetch older messages for relaying deletion
  • Manage Webhooks: to be able to create a webhook / find your webhook for incoming messages
  • Manage Messages: to be able to cross-delete messages that were deleted elsewhere

Because of the possibility of spam or abusive content, if you do not allow the bot to delete messages, it will stop sending them as well.

warning

Emoji from non-TCN servers will not work by default due to changes in Discord's bot webhook permissions. To fix this, just create a webhook manually in the channel. You do not need to do anything else.

link Connecting

info

Your global channels cannot be used for anything else. All messages sent to the channel are relayed.

Once your channel permissions are set up, use /connect and select the appropraite global channel. If you see any channels not mentioned above, do not connect to it unless you were given permission to. Global chat may be used by servers for things like event channels, so don't disrupt their channels.

info

To test that the channel works, send a message from your side and check another server. If it doesn't show up, View Channel is missing.

Then, send a message from the other side and check that it appears in your channel. If not, Manage Webhooks is missing.

Finally, delete the message from the other side and check that it disappears on your side. If not, Manage Messages is missing.

For staff channels, if you are not staff elsewhere, you may use the global channels in the TCN Hub to test.

link Disconnecting

To disconnect, use /disconnect and the global channel will immediately stop relaying messages both ways.

link Moderation

link Deleting Messages

When a message or any copy of it is deleted, all copies of it and the original are deleted. If this isn't working, make sure the bot has View Channel, Read Message History, and Manage Messages in all of your global channels.

If purging didn't work, you can use /purge with the message URL to make the bot try again.

link Banning

Use /ban to ban a user from global chat. This makes the bot stop relaying messages from that user in the current global channel across all servers. You must have Ban Members but no hierarchy check is performed. Use of this command is logged, so use it responsibly.

Note that the ban is per-channel, so make sure you run it in the right channel. You should not be using this in the staff channels unless a staff member is causing serious disruption that must be immediately stopped; instead, reach out to the server's admins/owner and/or an observer.

To get the ID of the author of a message, right click the message and select Apps > user or run /user with the message URL (the URL of any copy of the message will work).

To unban a user, just use /unban.

link Panic Mode

report

This command alerts all observers and can only be undone by an observer. Misuse of this command may result in loss of global chat privileges or other consequences. If you think it might be needed, don't be afraid to use it; we will discuss it with you if we think it was unnecessary, but don't play with it or use it for "testing" purposes.

If there is a raid or network-wide incident going on in global chat, you can use /panic to completely shut down the global channel. It will cease to relay messages from any server.

link For Observers

  • /globals list - show a list of existing global channels
  • /globals remove - delete a global channel (do not do this on channels unless it is agreed upon or it was a temporary channel that is no longer needed)
  • /globals add - create a new global channel with a name (required) and log channel (optional)
    • the log channel is where edits, deletions, bans/unbans, and connections/disconnections are logged
    • this command will not connect any channels, so you will need to connect the channel using /connect
  • /globals logchannel - change the log channel of a global channel

link Other Commands

  • /faq - Show some information about the bot. If someone asks what global chat is or why everyone is a bot (fairly common), use this with the public: true option to show the info page.
  • /help - Show one of three help pages:
    • mods - Information relevant to moderators such as how to ban/unban users and /panic.
    • admins - Information for server admins such as how to connect/disconnect channels.
    • execs - Information for observers such as how to create/delete global channels and /unpanic.
  • /nickname - Set your global nickname. Normally, your display name (nickname, or if none, username) will be shown to other servers. If you set this, it will override your display name in all global channels from all servers.
  • /ping - If you think the bot is unresponsive, use this command to check its ping (response time).
  • /rules - Show the global chat rules. Individual server rules still apply and moderation may be done by individual server staff, but a baseline set of rules exists. Use public: true to show it publicly in the channel (it is relayed to other servers).
  • /user - Call this with a message link to get the ID of the author of the original message. You can also right-click the message and select Apps > user but this sometimes doesn't work due to Discord issues.