| title | layout | next | nexttitle | prev | prevtitle |
|---|---|---|---|---|---|
Section 3: Navigating Discord |
default |
4.html |
Section 4: Royalty |
2.html |
Section 2: Server Commands |
The Discord server is the communication hub for Wings of Fire: The New World. It's just as important as the Minecraft server itself. Both need to be in good condition, upkeep, and activity for the server to be enjoyable. Admins have full administrative permissions on the Discord server. Much of the content in this section is also included in mod training, so this may look familiar. However, there are some admin-specific permissions and processes which you should know.
{% include split.html contentleft="
Not unlike the plugins from Section 2, we use a variety of bots to add features and functionality to the Discord server. Each one will be individually addressed, but not all functions and features will be detailed. Generally, we should try to keep the number of bots to a minimum, but if you or another player has a great idea for a bot, ask the rest of the team!
" contentright="
- Tupperbox
- Chip
- Tickets
- Zira
- Circle
- PluralKit
- Dreamvisitor
- Buff Kinkajou
" %}
Tupperbox lets you have many different profiles ("Tuppers") which you can choose between easily with every message you send. The best way to manage Tupperbox (for both users and administrators) is through the dashboard.
Chip is a music bot that can play from various music streaming platforms. Here are some important commands to remember:
| Command | Description |
|---|---|
/clear [queue|filters] |
🛡️ Clear the queue or all applied filters. |
/duplicates |
🛡️ Removes duplicate tracks from the queue. |
/forceskip [track #] |
🛡️ Forcefully skip without starting a vote. |
/loop [disable|current|all] |
🛡️ Loop the current track, queue, or nothing. |
/move [track #] [destination #] |
🛡️ Move a track to a specific location in the queue. |
/np |
Show the currently playing track and its progress. |
/pause |
🛡️ Pause the player. |
/play [input] |
Play a track from a supported platform. |
/previous |
🛡️ Go back to the previously playing track. |
/queue [list|export] |
Show or export the current queue. |
/remove [track #] [track #] |
🛡️ Remove one or multiple tracks from the queue. |
/resume</code> |
🛡️ Resume the player. |
/search [input] |
Search for a track and pick the right option. |
/seek [min:sec] |
🛡️ Seek to a specific point in the track. |
/shuffle</code> |
🛡️ Shuffle the current queue. |
/skip |
Start a vote to skip to the next track. 50% of listeners must agree. |
/stop |
🛡️ Clears the queue and makes Chip leave the voice channel. |
/upload [file|queue] |
Upload a file or import a queue. |
Tickets is simple, customisable and powerful Discord ticket system complete with a web UI.
{ % include sidenote.html content="This section is incomplete and needs more content." % }
Zira is built first to be a reaction roles bot, but it also has powerful messaging tools.
| Command | Description |
| /channel <#channel> | 🛡️ Set the active channel that Zira will be adding reaction roles in. |
| /message send <content of message> | 🛡️ Send a message by Zira in the currently selected active channel. |
| /message set <Message ID> | 🛡️ Set a pre-existing message for Zira to use for reaction roles. |
| /embed builder | 🛡️ Start Zira's interactive embedded message creator. You can customise the preview embed using the provided buttons. |
| /embed json <JSON Code> | 🛡️ Use JSON code to build an embed with Zira. |
| /edit <Message ID> | 🛡️ Edit a Zira-created message (both regular and embedded). |
Circle is an all-in-one bot primarily used for moderation and logging on Wings of Fire: The New World. Circle's configuration can be accessed through the dashboard.
| Command | Description |
|---|---|
/ban |
🛡️ 📕 Ban a user from the server, with an optional time limit. |
/case |
🛡️ 📗 Lookup a modlog by its case number. |
/clean |
🛡️ 📒 📕 Clean up Circle's recent messages. |
/diagnose |
🛡️ 📗 Check if there are any issues with the bot or one of her plugins/commands. |
/editcase |
🛡️ 📗 Edit the duration or reason of a case. |
/kick |
🛡️ 📒 📕 Kick a user from the server. |
/lock |
🛡️ 📒 📕 Deny Send Messages permissions for the @everyone role in the mentioned channel. |
/locked |
🛡️ 📗 Get a list of temporary locked channels in your server. |
/members |
🛡️ 📗 View a list of users who have a role and don't have another, or get the membercount of the server. |
/moderations |
🛡️ 📗 Get a list of muted/temp-banned users and the time until they're unmuted/unbanned. |
/modlogs |
🛡️ 📗 Get a list of moderation actions taken against the mentioned user. |
/modstats |
🛡️ 📗 View stats for top moderators or for a specific moderator. This will update every 10 minutes. |
/mute |
🛡️ 📒 📕 Mute a user, with an optional time limit. |
/nick |
🛡️ 📗 📒 Change/clear the nickname of the bot or a user. |
/purge |
🛡️ 📕 Bulk delete a number of messages. |
/roles |
🛡️ 📗 List all roles in the server or that a user has, or search for specific roles. |
/softban |
🛡️ 📕 Softban a user. This will ban then immediately unban them to purge their messages. |
/unban |
🛡️ 📒 Unban a banned user from the server. |
/unlock |
🛡️ 📒 Allow Send Messages permissions for the @everyone role in the mentioned channel. |
/unmute |
🛡️ 📒 Unmute a muted user. |
/verifybypass |
🛡️ 📒 Allow a user to bypass verification. |
/void |
🛡️ 📒 Clear a users modlogs. |
/warn |
🛡️ 📒 Send a member an official warning DM with a case number. |
PluralKit is a bot designed for plural communities on Discord. It allows you to register systems, maintain system information, set up message proxying, log switches, and more.
| Command | Description |
|---|---|
pk;system [system] |
Shows information about a system. |
pk;system new [name] |
Creates a new system registered to your account. |
pk;system [system] rename [new name] |
Changes the name of your system. |
pk;system [system] servername [servername] |
Changes the name of your system in the current server. |
pk;system [system] description [description] |
Changes the description of your system. |
pk;system [system] avatar [avatar url|@mention|upload] |
Changes the avatar of your system. |
pk;system [system] serveravatar [avatar url|@mention|upload] |
Changes the avatar of your system in the current server. |
pk;system [system] banner [image url|upload] |
Changes your system's banner image. |
pk;system [system] color [color] |
Changes your system's color. |
pk;system [system] privacy |
Displays your system's current privacy settings. |
pk;system [system] privacy <subject> <public|private> |
Changes your systems privacy settings. |
pk;system [system] tag [tag] |
Changes the system tag of your system. |
pk;system [system] servertag [tag|-enable|-disable] |
Changes your system's tag in the current server, or disables it for the current server. |
pk;system [system] pronouns [pronouns] |
Changes the pronouns of your system. |
pk;system proxy [server id] [on|off] |
Toggles message proxying for a specific server. |
pk;system [system] delete |
Deletes your system. |
pk;system [system] fronter |
Shows the current fronter of a system. |
pk;system [system] fronthistory |
Shows the last 10 fronters of a system. |
pk;system [system] frontpercent [timeframe] |
Shows the aggregated front history of a system within a given time frame. |
pk;system [system] list |
Shows a paginated list of a system's members. |
pk;system [system] list -full |
Shows a paginated list of a system's members, with increased detail. |
pk;find <search term> |
Searches members by name. |
pk;system [system] find <search term> |
(same as above, but for a specific system) |
pk;system [system] random [-group] |
Shows the info card of a randomly selected member [or group] in a system. |
pk;system [system] id |
Prints a system's id. |
Dreamvisitor, created by Bog specifically for the server, has a variety of features. It serves as an all-in-one utility plugin and Discord bot. Below are some important commands. You can view them all on the Dreamvisitor wiki.
| Command | Description |
|---|---|
/activity <type> <activity> |
🛡️ 📗 Set the bot activity. This does not save through restarts! |
/alts <subcommand> |
🛡️ 📒 Manage the alt tracker. |
/broadcast <message> |
🛡️ 📗 Broadcast a message to the Minecraft server. |
/economy <subcommand> |
🛡️ 📒 Manage the Discord economy. |
/infractions <user> |
🛡️ 📗 Get the infractions of a user. |
/link <user> <username> |
🛡️ 📗 Link a Discord account to a Minecraft account. |
/panic |
🛡️ 📕 Kick all players from the server and set the player limit to 0. |
/resourcepackupdate |
🛡️ 📒 Update the resource pack hash to prompt clients to download the pack. |
/schedulerestart |
🛡️ 📗 Schedule a server restart when no players are online. |
/setgamechat <channel> |
🛡️ 📗 Set the channel that game chat occurs in. |
/setwhitelist <channel> |
🛡️ 📗 Set the channel that whitelists players. |
/toggleweb |
🛡️ 📒 Toggle the web whitelist system on or off. |
/unwhitelist <username> [ban?] |
🛡️ 📗 Remove a user from the whitelist. |
/user <user> |
🛡️ 📗 Get the details of a user. |
/warn <member> <value> <silent?> [reason] |
🛡️ 📒 Warn a member. |
Eye of Onyx adds the following commands to the Dreamvisitor bot for royalty management.
| Command | Description |
|---|---|
/royalty set <member> <position> |
🛡️ 📗 Sets the specified member to the specified position of their tribe. This will overwrite the specified position of their tribe. |
/royalty clear <tribe> <position> |
🛡️ 📗 Clears the entry at the specified location and updates the royalty board. This will cancel any challenge involving this player. |
/royalty swap <tribe> <pos1> <pos2> |
🛡️ 📗 Swap two positions on a tribe's royalty board. This will cancel any challenges involving these players. |
/royalty update |
🛡️ 📒 Reloads, recalculates, and updates the entire royalty board. It may take some time to completely apply permissions and roles. |
/eyeofonyx ban <user> |
🛡️ 📗 Adds a player to the royalty ban list. Banned players may not participate in royalty. |
/eyeofonyx unban <user> |
🛡️ 📗 Removes a player from the royalty ban list. |
/eyeofonyx freeze |
🛡️ 📕 Toggles whether the royalty board can change or not. In the frozen state, challenge initiation and royalty board movement are disabled. |
The whitelist functionality is built to handle whitelisting players completely automatically. There are a few things you should know about how exactly it works and what takes place when a player is whitelisted.
When a user on Discord sends a username in the whitelist channel, Dreamvisitor will first check if the username is legal. Minecraft usernames are alphanumeric (including underscores). If the message is not alphanumeric, Dreamvisitor will take no action. This also occurs if the provided username is not able to be found by the Mojang API.
If the username is valid, Dreamvisitor will first fetch the UUID of the username and add it to accountLink.txt, which tracks which Minecraft UUIDs are connected to which Discord Snowflake IDs. A new entry will be recorded every time unless the UUID has already been registered. If a Discord ID or UUID is relinked, the previous link will be removed. One Discord ID connects to one UUID.
Dreamvisitor will then check whether or not the account is already whitelisted. If they are not, they are added to the whitelist. Either way, the user will be directed to check the FAQ for the IP.
Dreamvisitor can record Discord alternate accounts. Alts are stored as Alt Families. Each has one parent or "main" account and any number of child or "alt" accounts, stored in alts.yml using Discord Snowflake IDs. You can link a child account to a parent account using the Discord command /alts link <parent> <child>. Note that if the child is already linked to a different parent, you must first unset it. If the parent is a child of another parent, you'll have to unset it first. When you link a child account to a parent account, the infractions of the child are transferred to the parent. This operation is cannot be undone.
You can get the alts of an account with the Discord command /alts get <user>. Whether the user you specified is a parent or child account, the alt family will be retrieved. Note that although Dreamvisitor stores all child accounts added, only users in the same guild will be listed. If a child account leaves, it will still be stored, but not listed. You can also remove child account from the embed.
Dreamvisitor can track infractions of Discord members.
Infractions have a value between 0 and 3 (inclusive). Infractions are recorded using the /warn <member> <value> <silent?> [reason] Discord command. The value plus the value of all previous infractions cannot exceed the ban point (three). If silent is True, the infraction will be recorded, but the member not notified. The reason will default to "No reason provided" if a reason is not provided.
If the user reaches the ban point after this infraction, Dreamvisitor will ask if you also want to ban the user. If the user has not been temp-banned before, Dreamvisitor will suggest a temp-ban of two weeks. Otherwise, you'll have the option to ban the user from only the Minecraft server or from both. Note that if you choose both, the user will be banned immediately and no warning will be sent. Alternatively, you can also choose to keep the note about the ban without the auto-ban, or you can choose to have Dreamvisitor not mention a ban in the warning at all.
If the infraction is not silent, Dreamvisitor will create a channel in the category defined by infractions-category-id in the configuration. The user will be added to the channel and the warning message will be sent. The user has the option to either mark it as dismissed (at which point the user will be removed, but the channel not deleted) or they can request help from a staff member, in which case Dreamvisitor will send a message that a staff member will assist. Dreamvisitor will send a reminder every 24 hours if there is no response to the warning.
The /infractions Discord command lists a user's infractions. It is also possible to expire an infraction or delete an infraction from this message. These actions cannot be undone. Infractions automatically expire after the time defined in infraction-expire-time-days from their creation.
Here is a quick overview of some important channels as an admin:
| Channel Name | Description |
|---|---|
| #about-staff | Contains information about staff roles and staff introductions. Please do send or update a message if you new to the team or are promoted! |
| #announcements | Announcements relating to major server — Minecraft or Discord — or general changes. |
| #bug-report | Bugs are posted by the players here. Report them to the appropriate staff member if the issue is specific to one. |
| #faq | Frequently asked questions. From time to time, this may need to be updated. |
| #log | System channel, logs actions. Visible to trial admins. |
| #polls | Polls — for fun or for research. Feel free to use this if you want to poll the players. |
| #questions | Where players can head to ask about questions about the server in specific. Helpers should, for the most part, be able to answer questions here. |
| #suggestions | Admins are the ones to confirm, deny, and resolve suggestions. Read them and respond to them promptly if you have an idea/response or can resolve it yourself. Don't be afraid to ask other staff for input, including Helpers and Moderators! |
| #tickets | Encourage players to make tickets if they have an issue. |
| #woftnw-socials | A channel dedicated to hosting links to other services under the WOFTNW umbrella. |
{% include sidenote.html content="This section is incomplete and needs more content." %}
Here is a quick overview of some of our roles:
| Role Name | Description |
|---|---|
| On Break Role | A cosmetic role that indicates that a staff member is on break from their responsibilities. |
| Bots | A role bestowed to bots for being good bots. This is a cosmetic role, as all bots have individual roles for permissions. |
| Admin-Designated Purple Heart | A cosmetic role for members that are exceptionally kind, dedicated, or otherwise stand out positively in the community. Keep an eye out for potential members and discuss with your fellow admins! |
| SB | A cosmetic role that indicates that the user is banned from the Minecraft server. |
| Issues Talk | A role that allows the user to access #issues-talk. This is being phased out in favor of tickets. |
| Member | This role allows access to the whole Discord server after completing the joining steps. |
| RB | A cosmetic role that indicates that the user is barred from participating in royalty. |
You can use Discord's event system to make it more convenient for members to find information and participate in an event. To create an event:
- Click on the Events button at the top of the channel list.
- In the pop-up menu, click Create Event.
- Choose a location for your event.
- Define the topic, date, and time. You can also add a description and cover image.
- Review your event and click create.
If your event is in a stage channel, you should know how a stage channel works. The stage channel plays background music while there are no speakers. When you attempt to join the stage, you are presented with three options:<
- Start the Stage - Pick a topic to start the conversation. This will begin an event.
- Create Event - Schedule a Stage for a future date. This will take you through the same process as above.
- Continue without starting - This will let you join the stage without starting an event.
If an event is scheduled, you will have the option to start that event.
A stage channel has two parts: the speakers and the audience. The speakers can be heard by everyone. The audience is unable to speak and can only listen to the speakers. As a Stage Moderator, you can freely switch between the stage and the audience. Stage Moderators are indicated by a badge that appears while a speaker.
Users who are not Stage Moderators cannot join the stage unless invited by a Stage Moderator. Users can indicate they desire to join the speakers, but they must be approved by a Stage Moderator. In either case, the user then must accept the invitation to finally join the speakers.
Stages support many features found in voice channels. Stages have built-in chats where all users can send messages. Speaker invitations also appear here for Stage Moderators. Screen sharing is supported by Stages and both speakers and the audience will always have this stream open. However, there can only be one stream at a time.
When your event is over, you can end the event instead of disconnecting to end the Discord event and disconnect all users from the stage.