Server configuration | Automation

Partner tracking

Record the partnerships your partner managers post, thank them and reward them with levels.


Note:

Set this up

Set this up on the dashboard under Community › Partner tracking.

Type / in Discord to find the slash version of a command. Prefix commands keep working until March 5, 2027. What is changing

Overview

Partner tracking keeps count of your server's partnerships. When a partner manager posts another server's invite in a partner channel, greed records the partnership, posts your thank-you message and can log it in a channel. Managers earn XP for every partnership and climb partner levels from 0 to 10, with roles at the levels you choose.

Each server is counted once. If you want, the same server can count again after a number of days.

Partner tracking is free.

Note:

This is about partnerships between your server and others. greed's own partner program, for servers that run greed, is something different.

Setting it up

  1. Choose the partner channel

    Run /partner setup with the channel where managers post partnerships, and optionally a log channel.

  2. Add your partner managers

    Run /partner managers add with a role, such as your Partner Manager role, or with a single member. Only managers' invites are counted.

  3. Write a thank-you message (optional)

    Run /partner message with your own message, or keep greed's default.

  4. Add level roles (optional)

    Run /partner roles add to give a role when a manager reaches a partner level.

You need the Manage Server permission to set it up. Every setting is also in /configure → Leveling → Partner tracking and on the dashboard.

How a partnership is counted

A message from a partner manager in a partner channel with a Discord invite in it. greed checks each invite, up to 3 per message, and records a partnership for each server it points to. The manager gets the XP, greed posts the thank-you message, logs the partnership and hands out any level roles they reached.

greed replies instead of counting when the invite is invalid or expired, when it is an invite to your own server, or when that server has already been counted. If greed can't check an invite right now, it says so and you can post it again a minute later. Invites from members who aren't managers are ignored.

By default each server is counted only once. Set a cooldown with /partner cooldown and the same server can be counted again once that many days have passed since its last partnership.

Every partnership gives the manager 10 XP by default, up to 1,000 with /partner xp. A manager's first partnership puts them at level 0, and each level needs more XP than the last: level 1 at 50 XP, level 2 at 150, level 3 at 300, and so on up to level 10 at 2,750.

With /partner cleanup on, greed deletes messages without an invite from anyone who isn't a manager in partner channels. Members with Manage Messages are never affected.

Commands

Setup and channels

/partner setup (channel) [log]
/partner channel add (channel)
/partner channel remove (channel)
/partner log (channel)

log sets the channel where each partnership is logged, or none to stop logging.

Managers

/partner managers add (role or member)
/partner managers remove (role or member)

Thank-you message

/partner message (script)

default goes back to greed's message and none turns it off. The message pings only the manager.

XP, cooldown and cleanup

/partner xp [amount]
/partner cooldown (days)
/partner cleanup (on|off)
  • xp: XP each partnership gives, 1 to 1,000. With no amount, shows the current value.
  • cooldown: days before the same server can be counted again, 0 to 365. 0 counts each server once.
  • cleanup: delete non-invite messages from non-managers in partner channels.

Level roles

/partner roles add (level) (role)
/partner roles remove (level)

Levels go from 0 to 10, one role per level. Adding a role needs Manage Roles as well. greed won't hand out roles with dangerous permissions, or roles above its own highest role. Removing a level role doesn't take it back from members who already have it.

Stats, leaderboard and history

/partner stats [member]
/partner leaderboard
/partner history [member]

stats shows a manager's partnerships, XP, level, rank and the XP to the next level. leaderboard ranks managers by XP, with the server's total. history lists logged partnerships with their entry numbers, for everyone or for one manager. Anyone can use these.

Remove and reset

/partner remove (entry)
/partner reset

remove deletes one logged partnership by its number from history and takes its XP back from the manager. Roles already given stay. reset deletes every partnership and all partner XP, after you confirm; settings are kept.

Settings and variables

/partner config
/partner variables

config shows every setting. variables lists what the thank-you message can use.

Tip:

Every command also works with the prefix, as ,partner or ,partnership. ,partner on its own shows the settings, and on the prefix ,partner channel, ,partner managers and ,partner roles on their own list what is set.

Warning:

,partner @user used to show someone's family. Family profiles are now ,spouse @user or ,family profile @user. See Marriage and family.

Variables

Use these in the thank-you message.

VariableDescription
{partner.mention} {partner.name} {partner.display_name} {partner.id} {partner.avatar}The partner manager, plus every other {user.*} variable as {partner.*}
{partner.partnerships}The manager's partnerships in this server
{partner.xp}The manager's partner XP
{partner.level}The manager's partner level
{partner.rank}The manager's place on the leaderboard
{partnered.name}The partnered server's name
{partnered.id}The partnered server's ID
{partnered.members}The partnered server's member count
{partnered.boosts}The partnered server's boosts
{partnered.icon}The partnered server's icon
{partnered.invite}The invite link that was posted
{partnership.count}Partnerships this server has logged

The usual {guild.*} and {channel.*} variables work too. greed's default message is:

Default
{partner.mention} thanks for partnering with **{partnered.name}**! That's partnership **#{partnership.count}** for this server.

Limits

FreeServer Premium
Partner channels210
Partner managers (roles and members together)1050

Permissions

  • Manage Server to change any setting, remove a partnership or reset. Adding a level role also needs Manage Roles.
  • Anyone can use stats, leaderboard, history and variables.
  • greed needs Send Messages in partner and log channels, Manage Messages for cleanup, and Manage Roles for level roles.