PolyHopper - Discord Chat Link Mod for Quilt

PolyHopper is a multifunctional Minecraft mod that establishes two-way communication between the game chat and Discord server. The mod stands out for its customizable configuration and extensive personalization capabilities.

Key Features

• Compatibility with PluralKit for system operations
• Webhook mode allowing different players to be displayed as separate users in Discord
• Fully customizable message formats through configuration files
• Support for Markdown and SimpleTextFormat (using placeholder API)

Configuration

The configuration file is located at config/polyhopper/config.toml. The following default configuration is provided:

[bot]
# Bot token
# default value:
token = ""
# Channel ID for command restrictions and message sending
# default value:
channelId = ""
# Guild ID where the bot will be used
# default value:
guildId = ""
# Discord message format ingame
# default: [PolyHopper] <{username}> {message}
ingameFormat = "[PolyHopper] <{username}> {message}"
# Messages starting with these won't be proxied to Minecraft
minecraftProxyBlacklist = ["pk;", "pk!", "<@466378653216014359>", "\\\\"]
# Channel for whitelist logging
# default value:
whitelistChannelId = ""
# Enable whitelist command
# default: false
whitelistCommand = false
# Account linking
# default: false
accountLinking = false
# Message sending method, can be:
#   MESSAGE - Simple Discord messages
#   WEBHOOK - Messages via webhook with custom names and avatars
# options: MESSAGE, WEBHOOK
# default: WEBHOOK
messageMode = "WEBHOOK"
# Announce deaths?
# default: true
announceDeaths = true
# Announce achievements?
# default: true
announceAdvancements = true
# Announce player join/leave?
# default: true
announcePlayerJoinLeave = true

[webhook]
# Name format for webhook messages, can use {username} or {displayName}
# default: {displayName} @ PolyHopper
nameFormat = "{displayName} @ PolyHopper"
# URL for player webhook image, can use {uuid} or {username}
# default: https://crafatar.com/renders/head/{uuid}
playerAvatarUrl = "https://crafatar.com/renders/head/{uuid}"
# URL for server webhook image, can use {uuid} or {username}
# default: https://cdn.ecorous.org/blackhole.png
serverAvatarUrl = "https://cdn.ecorous.org/blackhole.png"

[message]
# Format for player messages, can use {username}, {displayName} or {text}
# default: <{displayName}> {text}
messageFormat = "<{displayName}> {text}"

Frequently Asked Questions:

Q: How to get token? A: Study the Discord bot setup guide.

Q: Markdown messages in Discord display incorrectly! A: Markdown support will be added in future versions.

Q: Account linking doesn't work! A: This feature is not yet implemented, please await updates.