PolyHopper

PolyHopper

A highly-customisable discord chat link mod for Quilt

by
304 Downloads
quiltsocialutility
Rent Server with this Mod

About this Mod

A highly-customisable discord chat link mod for Quilt.

Features

  • PluralKit support
  • Optional Webhook mode, allowing different players to be displayed as separate 'users' on discord
  • All formats are configurable, see the Configuration section below.
  • Markdown and SimpleTextFormat (look at placeholder API) support

Configuartion

There is a configuartion file located at config/polyhopper/config.toml.
A default config is provided below

Default Config
[bot]
	# The bot token.
	# default:
	token = ""
	# The channel to limit commands to and where messages are sent.
	# default:
	channelId = ""
	# The guild that the bot is to be used in.
	# default:
	guildId = ""
	# The format that discord messages use in-game
	# default: [PolyHopper] <{username}> {message}
	ingameFormat = "[PolyHopper] <{username}> {message}"
	# Messages that start with these won't be proxied into minecraft (<@466378653216014359> is PluralKit's ping)
	minecraftProxyBlacklist = ["pk;", "pk!", "<@466378653216014359>", "\\\\"]
	# The channel where whitelist are logged
	# default:
	whitelistChannelId = ""
	# Toggle whitelist command
	# default: false
	whitelistCommand = false
	# Toggle account linking.
	# default: false
	accountLinking = false
	# How to send messages, can be either:
	#   MESSAGE - Simple discord messages.
	#   WEBHOOK - Message via webhook with custom name and avatar.
	# options: MESSAGE, WEBHOOK
	# default: WEBHOOK
	messageMode = "WEBHOOK"
	# Announce deaths?
	# default: true
	announceDeaths = true
	# Announce advancements?
	# default: true
	announceAdvancements = true
	# Announce player join/leave?
	# default: true
	announcePlayerJoinLeave = true

[webhook]
	# The name used for webhook messages, can substitute in {username} or {displayName}
	# default: {displayName} @ PolyHopper
	nameFormat = "{displayName} @ PolyHopper"
	# The url for player webhook image, can substitute in {uuid} or {username}.
	# default: https://crafatar.com/renders/head/{uuid}
	playerAvatarUrl = "https://crafatar.com/renders/head/{uuid}"
	# The url for server webhook image, can substitute in {uuid} or {username}.
	# default: https://cdn.ecorous.org/blackhole.png
	serverAvatarUrl = "https://cdn.ecorous.org/blackhole.png"

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

FAQ

Q: How do I get token????

A: Read this guide.

Q: When I send a markdown message on Discord (bold, italic, underline, headers, etc) it looks weird with asterisks and stuff!

A: Markdown support is coming in a later version.

Q: Account Linking doesn't do anything!!!!

A: It's not implemented yet. Please wait patiently.

Available Versions

PolyHopper 0.2.0beta
MC 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2quilt
November 4, 2023
PolyHopper 0.1.0alpha
MC 1.20.1quilt
August 6, 2023

How to Install PolyHopper on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set quilt Loader

In the panel under "Egg", select the quilt loader and matching Minecraft version (1.20.2).

3

Install Mod

Open the mod browser in the dashboard and search for "PolyHopper". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

quilt

Minecraft Versions

1.20.2, 1.20.1, 1.20 (+3 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

PolyHopper server crashes on startup – what to do?

Most common cause: wrong quilt version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.2). You can switch loaders with one click in the panel.

Is PolyHopper compatible with quilt?

PolyHopper officially supports quilt for Minecraft 1.20.2, 1.20.1, 1.20. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with PolyHopper – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if PolyHopper consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install PolyHopper with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
Apache License 2.0
Server-side
Required

Supported Versions

1.20.21.20.11.201.19.41.19.31.19.2