Personalize System

1. Feature Brief

The Personalize plugin lets server administrators customize how the bot appears inside their server - independently of every other server it is in. Changes apply instantly without a restart; the bot updates its own nickname and server profile avatar the moment the command is run.

1. Per-server nickname - set a custom display name for the bot in your server, up to 32 characters, or remove it to restore the default
2. Server profile avatar - override the bot’s avatar with a server-specific image using any publicly accessible image URL
3. Live apply - both nickname and avatar changes are applied immediately to the bot’s server member profile on save
4. Persistent config - settings survive bot restarts and are re-applied automatically whenever the bot joins or rejoins the server
5. Profile viewer - inspect the currently saved nickname, avatar URL, and last-updated timestamp at any time
6. Full reset - wipe all personalization settings and restore the bot’s default nickname and global avatar in one action

Who can use this?

All /personalize subcommands require Manage Server permission. There is no separate manager role for this plugin.

---

2. Sub-Systems

Nickname

• Set with /personalize nickname name:<value> - applies immediately via Discord’s member edit API
• Maximum length is 32 characters, enforced at the command option level
• Leave name blank to remove the custom nickname and restore the bot’s default display name
• If the bot lacks the Change Nickname permission, the command fails with a clear error explaining the missing permission and role hierarchy requirements
• The saved nickname is re-applied automatically on bot restart or if the bot rejoins the server

Server Avatar

• Set with /personalize avatar url:<image_url> - applies Discord’s Server Profile feature, so the avatar is visible only in this server
• Accepted URL formats: direct image links ending in .jpg, .jpeg, .png, .gif, .webp, .bmp, or .svg, as well as URLs from Discord CDN, Imgur, and Gyazo
• URL must use http:// or https:// protocol; other protocols are rejected before any API call is made
• Leave url blank to reset the server avatar back to the bot’s global avatar
• If the image cannot be fetched or the format is unsupported, the URL is saved to the database and will be retried on the next bot restart - the error message explains this clearly
• Requires the Change Nickname permission (Discord uses the same permission gate for server profile edits)

Profile Viewer

Run /personalize profile at any time to see the current state without making changes.

Field	Description
Nickname	Saved nickname, or the bot’s live server nickname if none is configured
Avatar URL	Shows “Saved” if a URL is stored, otherwise “Not set”
Status	Active (config exists) or Not configured
Last Updated	Relative timestamp of the most recent change
Saved Avatar URL	Clickable link to the stored image URL, shown only when one is set

The embed thumbnail reflects the bot’s current server avatar. Response is ephemeral - only you can see it.

Reset

• /personalize reset completely clears the personalization configuration and resets both the nickname and server avatar immediately

---

3. Setup

No initial setup command is needed - simply run any /personalize subcommand and the bot creates or updates the config for your server on first use.

1. Set a nickname Optional - run /personalize nickname name:<your nickname>. The bot updates its display name instantly. Leave name blank to remove it.

2. Set a server avatar Optional - run /personalize avatar url:<image url>. Provide a direct link to a publicly accessible image. The bot applies it as its server profile avatar immediately.

3. Verify the result - run /personalize profile to confirm the saved nickname, avatar URL, and last-updated time.

4. Reset if needed - run /personalize reset to wipe all settings and restore defaults in one step.

Settings Reference

Setting	Command	Default
Nickname	/personalize nickname name:	None (bot default)
Server Avatar URL	/personalize avatar url:	None (global avatar)