modify_emoji
Change custom emoji names and permissions in Discord servers to manage accessibility and organization.
Instructions
Modify a custom emoji in a server
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guildId | Yes | The ID of the server (guild) | |
| emojiId | Yes | The ID of the emoji to modify | |
| name | No | New name for the emoji | |
| roles | No | Role IDs that can use this emoji | |
| reason | No | Reason for modifying the emoji |
Implementation Reference
- src/tools/emoji-tools.ts:113-150 (registration)Full tool registration for 'modify_emoji' including name, description, input schema with Zod validation, and the handler function that modifies the emoji using Discord.js API.server.tool( 'modify_emoji', 'Modify a custom emoji in a server', { guildId: z.string().describe('The ID of the server (guild)'), emojiId: z.string().describe('The ID of the emoji to modify'), name: z.string().optional().describe('New name for the emoji'), roles: z.array(z.string()).optional().describe('Role IDs that can use this emoji'), reason: z.string().optional().describe('Reason for modifying the emoji'), }, async ({ guildId, emojiId, name, roles, reason }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const emoji = await guild.emojis.fetch(emojiId); const editData: { name?: string; roles?: string[]; reason?: string } = {}; if (name) editData.name = name; if (roles) editData.roles = roles; if (reason) editData.reason = reason; const updated = await emoji.edit(editData); return { id: updated.id, name: updated.name, roles: updated.roles.cache.map((r) => ({ id: r.id, name: r.name })), message: 'Emoji updated successfully', }; }); if (!result.success) { return { content: [{ type: 'text', text: result.error }], isError: true }; } return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] }; } );
- src/index.ts:60-60 (registration)Top-level registration call that invokes registerEmojiTools(server), which registers the modify_emoji tool among others.registerEmojiTools(server);
- src/tools/emoji-tools.ts:123-149 (handler)The core handler function for the modify_emoji tool. It fetches the guild and emoji, constructs edit data from parameters, calls emoji.edit(), handles errors with withErrorHandling, and returns formatted response.async ({ guildId, emojiId, name, roles, reason }) => { const result = await withErrorHandling(async () => { const client = await getDiscordClient(); const guild = await client.guilds.fetch(guildId); const emoji = await guild.emojis.fetch(emojiId); const editData: { name?: string; roles?: string[]; reason?: string } = {}; if (name) editData.name = name; if (roles) editData.roles = roles; if (reason) editData.reason = reason; const updated = await emoji.edit(editData); return { id: updated.id, name: updated.name, roles: updated.roles.cache.map((r) => ({ id: r.id, name: r.name })), message: 'Emoji updated successfully', }; }); if (!result.success) { return { content: [{ type: 'text', text: result.error }], isError: true }; } return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] }; }
- src/tools/emoji-tools.ts:116-122 (schema)Input schema using Zod for validating parameters: guildId (required), emojiId (required), optional name, roles array, reason.{ guildId: z.string().describe('The ID of the server (guild)'), emojiId: z.string().describe('The ID of the emoji to modify'), name: z.string().optional().describe('New name for the emoji'), roles: z.array(z.string()).optional().describe('Role IDs that can use this emoji'), reason: z.string().optional().describe('Reason for modifying the emoji'), },