Skip to content

Commit ff56b4f

Browse files
move config section to wiki
1 parent c3500d4 commit ff56b4f

File tree

3 files changed

+6
-290
lines changed

3 files changed

+6
-290
lines changed

.gitmodules

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
[submodule "docs"]
2+
path = docs
3+
url = https://github.com/fooooooooooooooo/VelocityDiscord.wiki

README.md

Lines changed: 2 additions & 290 deletions
Original file line numberDiff line numberDiff line change
@@ -47,294 +47,6 @@ Chat from all servers gets bridged with a discord channel
4747
2. Install the [YepTwo](https://github.com/unilock/YepTwo) backend mod/plugin on each of your backend servers that you want to
4848
receive advancements/deaths from
4949

50-
## Configuration
50+
### Configuration
5151

52-
Default config generated on startup:
53-
54-
```toml
55-
# Don't change this
56-
config_version = "2.0"
57-
58-
# Comma separated list of server names to exclude from the bridge (defined under [servers] inside your velocity.toml)
59-
# e.g., exclude_servers = ["lobby", "survival"]
60-
exclude_servers = []
61-
excluded_servers_receive_messages = false
62-
63-
# How often to ping all servers to check for online status (seconds)
64-
# Excluded servers will not be pinged
65-
# Use a value of 0 to disable
66-
ping_interval = 30
67-
68-
# Server display names
69-
# If a server is not found in this list, the server name (from velocity.toml) will be used instead
70-
[server_names]
71-
# lobby = "Lobby"
72-
73-
[discord]
74-
# Bot token from https://discordapp.com/developers/applications/
75-
# Not server overridable
76-
token = "TOKEN"
77-
# Default channel ID to send Minecraft chat messages to
78-
channel = "000000000000000000"
79-
80-
# Show messages from bots in Minecraft chat
81-
show_bot_messages = false
82-
# Show clickable links for attachments in Minecraft chat
83-
show_attachments_ingame = true
84-
85-
# Activity text of the bot to show in Discord
86-
# Placeholders available: {amount}
87-
# Can be disabled with "" or false
88-
# Not server overridable
89-
activity_text = "with {amount} players online"
90-
91-
# Enable mentioning Discord users from Minecraft chat
92-
enable_mentions = true
93-
# Enable @everyone and @here pings from Minecraft chat
94-
enable_everyone_and_here = false
95-
96-
# Interval (in minutes) for updating the channel topic
97-
# Use a value of 0 to disable
98-
# Not server overridable
99-
update_channel_topic_interval = 0
100-
101-
# Channel topic config (if enabled)
102-
[discord.channel_topic]
103-
# Template for the channel topic
104-
# Placeholders available:
105-
# {players} - Total number of players online
106-
# {player_list} - List of players (format is defined below)
107-
# {servers} - Number of servers
108-
# {server_list} - List of server names
109-
# {hostname} - Server hostname
110-
# {port} - Server port
111-
# {motd} - Message of the Day (MOTD)
112-
# {query_port} - Query port
113-
# {max_players} - Maximum number of players
114-
# {plugins} - Number of plugins
115-
# {plugin_list} - List of plugin names
116-
# {version} - Server version
117-
# {software} - Software name
118-
# {average_ping} - Average ping of all players
119-
# {uptime} - Server uptime in hours and minutes
120-
# {server[SERVERNAME]} - Dynamic placeholder for each server's name and status (e.g., {server[MyServer]}, {server[AnotherServer]}, {server[Lobby]}, etc.)
121-
format = """{players}/{max_players}
122-
{player_list}
123-
{hostname}:{port}
124-
Uptime: {uptime}"""
125-
126-
# Template for server[SERVERNAME] placeholder in the channel topic
127-
# Placeholders available: {name}, {players}, {max_players}, {motd}, {version}, {protocol}
128-
server = "{name}: {players}/{max_players}"
129-
130-
# Template for server[SERVERNAME] placeholder in the channel topic when the server is offline
131-
# Placeholders available: {name}
132-
server_offline = "{name}: Offline"
133-
134-
# Can be disabled with "" or false to hide the list completely when no players are online
135-
player_list_no_players_header = "No players online"
136-
137-
# Can be disabled with "" or false to hide the header and only show the player list
138-
player_list_header = "Players: "
139-
140-
# Placeholders available: {username}, {ping}
141-
player_list_player = "{username}"
142-
143-
# Separator between players in the list, \n can be used for new line
144-
player_list_separator = ", "
145-
146-
# Maximum number of players to show in the topic
147-
# Set to 0 to show all players
148-
player_list_max_count = 10
149-
150-
[discord.webhook]
151-
# Full webhook URL to send chat messages to
152-
webhook_url = ""
153-
# Full URL of an avatar service to get the player's avatar from
154-
# Placeholders available: {uuid}, {username}
155-
avatar_url = "https://visage.surgeplay.com/face/96/{uuid}"
156-
157-
# The format of the webhook's username
158-
# Placeholders available: {username}, {server}
159-
webhook_username = "{username}"
160-
161-
# Minecraft > Discord message formats
162-
# Uses the same formatting as the Discord client (a subset of markdown)
163-
#
164-
# Messages can be disabled by setting format to empty string ("") or false
165-
#
166-
# type can be one of the following:
167-
# "text" - Normal text only message with the associated x_message format
168-
# "embed" - Discord embed with the associated x_message format as the description field
169-
# Default for all is "text"
170-
#
171-
# embed_color is the color of the embed, in #RRGGBB format
172-
[discord.chat.message]
173-
# Placeholders available: {username}, {prefix}, {server}, {message}
174-
# Can be disabled with "" or false
175-
format = "{username}: {message}"
176-
177-
# for user messages, the following types can be used
178-
# "text" - Normal text only message with the above
179-
#
180-
# "webhook" - Use a Discord webhook to have the bot use the player's username and avatar when sending messages
181-
# Requires a webhook URL to be set below
182-
# Ignores the above message format, and just sends the message as the content of the webhook
183-
#
184-
# "embed" - Discord embed with the above format as the description field
185-
type = "text"
186-
# Can be disabled with "" or false
187-
embed_color = ""
188-
# Channel override for this message type, set to "" or false or remove to use the default channel
189-
# Can be applied to all message types
190-
# channel = "000000000000000000"
191-
192-
[discord.chat.join]
193-
# Placeholders available: {username}, {prefix}, {server}
194-
# Can be disabled with "" or false
195-
format = "**{username} joined the game**"
196-
type = "text"
197-
# Can be disabled with "" or false
198-
embed_color = "#40bf4f"
199-
200-
[discord.chat.leave]
201-
# Placeholders available: {username}, {prefix}, {server}
202-
# Can be disabled with "" or false
203-
format = "**{username} left the game**"
204-
type = "text"
205-
# Can be disabled with "" or false
206-
embed_color = "#bf4040"
207-
208-
[discord.chat.disconnect]
209-
# Possible different format for timeouts or other terminating connections
210-
# Placeholders available: {username}, {prefix}
211-
# Can be disabled with "" or false
212-
format = "**{username} disconnected**"
213-
type = "text"
214-
# Can be disabled with "" or false
215-
embed_color = "#bf4040"
216-
217-
[discord.chat.server_switch]
218-
# Placeholders available: {username}, {prefix}, {current}, {previous}
219-
# Can be disabled with "" or false
220-
format = "**{username} moved to {current} from {previous}**"
221-
type = "text"
222-
# Can be disabled with "" or false
223-
embed_color = "#40bf4f"
224-
225-
[discord.chat.death]
226-
# Placeholders available: {username}, {death_message}
227-
# death_message includes the username just as it is shown ingame
228-
# Can be disabled with "" or false
229-
format = "**{death_message}**"
230-
type = "text"
231-
# Can be disabled with "" or false
232-
embed_color = "#bf4040"
233-
234-
[discord.chat.advancement]
235-
# Placeholders available: {username}, {advancement_title}, {advancement_description}
236-
# Can be disabled with "" or false
237-
format = "**{username} has made the advancement __{advancement_title}__**\n_{advancement_description}_"
238-
type = "text"
239-
# Can be disabled with "" or false
240-
embed_color = "#40bf4f"
241-
242-
# Not server overridable
243-
[discord.chat.proxy_start]
244-
# Can be disabled with "" or false
245-
format = "**Proxy started**"
246-
type = "text"
247-
# Can be disabled with "" or false
248-
embed_color = "#40bf4f"
249-
250-
# Not server overridable
251-
[discord.chat.proxy_stop]
252-
# Can be disabled with "" or false
253-
format = "**Proxy stopped**"
254-
type = "text"
255-
# Can be disabled with "" or false
256-
embed_color = "#bf4040"
257-
258-
[discord.chat.server_start]
259-
# Placeholders available: {server}
260-
# Can be disabled with "" or false
261-
format = "**{server} has started**"
262-
type = "text"
263-
# Can be disabled with "" or false
264-
embed_color = "#40bf4f"
265-
266-
[discord.chat.server_stop]
267-
# Placeholders available: {server}
268-
# Can be disabled with "" or false
269-
format = "**{server} has stopped**"
270-
type = "text"
271-
# Can be disabled with "" or false
272-
embed_color = "#bf4040"
273-
274-
[discord.commands.list]
275-
# Not server overridable
276-
enabled = true
277-
278-
# Ephemeral messages are only visible to the user who sent the command
279-
# Not server overridable
280-
ephemeral = true
281-
282-
# Placeholders available: {server_name}, {online_players}, {max_players}
283-
server_format = "[{server_name} {online_players}/{max_players}]"
284-
285-
# Placeholders available: {username}
286-
player_format = "- {username}"
287-
288-
# Can be disabled with "" or false
289-
no_players = "No players online"
290-
291-
# Can be disabled with "" or false
292-
server_offline = "Server offline"
293-
# Not server overridable
294-
codeblock_lang = "asciidoc"
295-
296-
# Discord > Minecraft message formats
297-
# Uses XML-like formatting with https://docs.advntr.dev/minimessage/format.html
298-
[minecraft]
299-
# Ingame command for plugin
300-
# Not server overridable
301-
# e.g., /discord, /discord reload, /discord topic preview
302-
plugin_command = "discord"
303-
304-
# Placeholders available: {discord}
305-
discord_chunk = "<dark_gray>[<{discord_color}>Discord<dark_gray>]<reset>"
306-
307-
# Placeholders available: {role_color}, {display_name}, {username}, {nickname}
308-
# <insert> tag allows you to shift right-click the username to insert @{username} in the chat
309-
username_chunk = "<{role_color}><insert:@{username}><hover:show_text:{display_name}>{nickname}</hover></insert><reset>"
310-
311-
# Placeholders available: {discord_chunk}, {username_chunk}, {attachments}, {message}
312-
message = "{discord_chunk} {role_prefix} {username_chunk}<dark_gray>: <reset>{message} {attachments}"
313-
314-
# Placeholders available: {url}, {attachment_color}
315-
attachments = "<dark_gray><click:open_url:{url}>[<{attachment_color}>Attachment<dark_gray>]</click><reset>"
316-
317-
# Placeholders available: {url}, {link_color}
318-
# Can be disabled with "" or false
319-
links = "<click:open_url:\"{url}\"><hover:show_text:\"Click to open {url}\"><dark_gray>[</dark_gray><{link_color}>Link<dark_gray>]</hover></click>"
320-
321-
# Colors for the <{discord_color}>, <{attachment_color}> and <{link_color}> tags
322-
discord_color = "#7289da"
323-
attachment_color = "#4abdff"
324-
link_color = "#4abdff"
325-
326-
# Role prefix configuration
327-
# Format: "role_id" = "prefix format using MiniMessage"
328-
[minecraft.role_prefixes]
329-
# "123456789" = "<dark_gray>[</dark_gray><red><b>OWNER</b></red><dark_gray>]</dark_gray>"
330-
# "987654321" = "<dark_gray>[</dark_gray><blue>ADMIN</blue><dark_gray>]</dark_gray>"
331-
# "456789123" = "<dark_gray>[</dark_gray><green>MOD</green><dark_gray>]</dark_gray>"
332-
# "789123456" = "<dark_gray>[</dark_gray><aqua>HELPER</aqua><dark_gray>]</dark_gray>"
333-
334-
# Override config for specific servers
335-
# Any config option under [discord] or [minecraft] can be overridden (other than options labelled not server overridable)
336-
# Format: [override.(velocity.toml server name).discord] or [override.(velocity.toml server name).minecraft]
337-
# Example:
338-
# [override.lobby.discord]
339-
# channel = "000000000000000000"
340-
```
52+
The config file is generated at `plugins/discord/config.toml`. See [here](wiki/Configuration) for the default config

docs

Submodule docs added at 7984a2e

0 commit comments

Comments
 (0)