Files
SCOPENET-MC/docs/discord-and-email.md
T

3.4 KiB

Discord messages, live embeds and emails

Announcements (Admin panel → Discord → Announcements)

Three messages are posted by the panel's webhook (Settings → Discord → webhook): Achievement unlocked, New player and New guild. Each one is fully editable, with a live preview built the way Discord will show it:

  • Message text above the box (mentions such as <@&roleid> work there), title and link, description, colour, a small picture on the right, a big picture at the bottom, author and footer (with icons), the time, and any number of side-by-side or full-width fields.
  • The sender's name and picture.
  • Placeholders such as {player}, {avatar}, {achievement}, {achievement_description}, {xp}, {level}, {rank_title}, {guild_line} (achievements), {members_total} (new players), {guild}, {leader}, {members}, {claims} (guilds) and {server_name}, {time} everywhere. Click a placeholder to insert it where you are typing. Unknown ones stay as typed so mistakes are easy to spot.
  • Player names are cleaned so they can't ping anyone or break the formatting.

Switch each message on or off, and press Save & send a sample to see it in your channel.

Live embeds (Discord → Live embeds)

Four boards that the panel posts once and then edits in place, so the channel never fills up:

Embed Shows Rows are set by
Server status Every server: online, players, TPS, version the line template
Active guilds Top guilds with level, members, land and leader rows shown
Player leaderboard Top players by playtime, level, kills or blocks ranked by, rows shown
Richest players Top balances of one server economy economy of, rows shown

Every embed has the same editor as the announcements, plus a line for each row (for example {rank}. **{player}** — {value}) that fills {rows} in the description, an update interval (1 minute to 1 hour), and an optional own webhook so each board can live in its own channel. If someone deletes the message, the next update posts a fresh one; Post as new message forces it.

Emails (Admin panel → Emails)

Set up the sender and Resend key under Settings → Connections first. Then:

  1. Write a template: subject and message with placeholders ({player}, {level}, {rank_title}, {guild}, {brand}, {panel_url}…). Simple formatting turns into a branded HTML email in your launcher colours: # Heading, **bold**, - list, [link](https://…), [button: Label](https://…).
  2. Check the live preview, and send a test to yourself.
  3. Send to everyone with an email, a group, or chosen players. The panel shows how many will receive it first, sends them one by one in the background, and keeps a log with failures and their reasons.

Every email has an unsubscribe link; players who use it are skipped by later emails. Mark a message as an account notice to reach everyone regardless, without the unsubscribe link: use that only for things about their account.

Live map on the landing page

In Landing page, add a Live map section. Choose the server (or leave it at the first server with a map), the height, and what visitors may see: guild land and places are on by default, live player positions are off (they let strangers find players). Visitors can pan and zoom the same map your players see in the launcher; removing the section closes the public map again.