Overview Fluxer allows communities to create custom emojis and stickers, enabling unique and personalized expression. These custom assets can be used in messages, reactions, and across the platform.
Custom Emojis Animated and static emojis unique to your community
Custom Stickers Larger expressive images for rich communication
Global Usage Premium feature to use expressions across all communities
Bulk Import Import multiple expressions at once
Custom Emojis Custom emojis are community-specific reaction images that can be static (PNG) or animated (GIF).
Creating Emojis import { EmojiService } from '@fluxer/api/src/guild/services/content/EmojiService' ; const emoji = await emojiService . createEmoji ({ user , guildId , name: 'partyblob' , image: 'data:image/png;base64,iVBORw0KGg...' // Base64-encoded image }, 'Added custom emoji for celebrations' ); // Response: // { // id: "123456789", // name: "partyblob", // animated: false, // available: true // }
Emoji Limits Emoji slots are based on guild features:
Standard Guilds
MORE_EMOJI Feature
UNLIMITED_EMOJI Feature
50 static emojis50 animated emojisTotal: 100 emoji slots
// Check current usage const emojis = await guildRepository . listEmojis ( guildId ); const staticCount = emojis . filter ( e => ! e . isAnimated ). length ; const animatedCount = emojis . filter ( e => e . isAnimated ). length ; console . log ( `Using ${ staticCount } /50 static, ${ animatedCount } /50 animated` );
100 static emojis100 animated emojisTotal: 200 emoji slots
if ( guild . features . includes ( GuildFeatures . MORE_EMOJI )) { // Elevated limits apply }
Unlimited static emojisUnlimited animated emojis if ( guild . features . includes ( GuildFeatures . UNLIMITED_EMOJI )) { // No limits on emoji creation }
Image Requirements PNG (static) or GIF (animated)
Recommended: 128x128 pixels (square)
Automatically detected from file format (GIF = animated)
Using Custom Emojis In Messages
In Reactions
External Emoji (Premium)
// Use in message content with :name: syntax const message = await messageSendService . sendMessage ({ user , channelId , data: { content: 'Check out this emoji :partyblob:' }, requestCache });
Managing Emojis // Rename an emoji const updated = await emojiService . updateEmoji ({ userId , guildId , emojiId , name: 'superpartyblob' }, 'Renamed emoji' );
// Delete an emoji await emojiService . deleteEmoji ({ userId , guildId , emojiId , purge: false // Set true to purge from CDN immediately }, 'Removed unused emoji' );
Setting purge: true requires the EXPRESSION_PURGE_ALLOWED guild feature and immediately removes the asset from CDN.
// Get all emojis for a guild const emojis = await emojiService . getEmojis ({ userId , guildId , requestCache }); // Response includes creator information emojis . forEach ( emoji => { console . log ( ` ${ emoji . name } created by ${ emoji . user . username } ` ); });
Custom Stickers Stickers are larger expressive images that can be sent as standalone messages.
Creating Stickers Single Sticker
Bulk Import
import { StickerService } from '@fluxer/api/src/guild/services/content/StickerService' ; const sticker = await stickerService . createSticker ({ user , guildId , name: 'Happy Face' , description: 'A very happy face!' , tags: [ 'happy' , 'smile' , 'joy' ], image: 'data:image/png;base64,iVBORw0KGg...' }, 'Added happy sticker' );
Sticker Limits 5 stickers per guildconst stickers = await guildRepository . listStickers ( guildId ); if ( stickers . length >= 5 ) { throw new MaxGuildStickersStaticError ( 5 ); }
100 stickers per guildif ( guild . features . includes ( GuildFeatures . MORE_STICKERS )) { // Can create up to 100 stickers }
Unlimited stickersif ( guild . features . includes ( GuildFeatures . UNLIMITED_STICKERS )) { // No limit on sticker creation }
Sticker Requirements PNG (static) or APNG/Lottie (animated)
Maximum 512 KB per sticker
Recommended: 320x320 pixels
2-30 characters, descriptive name
Optional description up to 100 characters
1-5 searchable tags for discovery
Using Stickers // Send a message with a sticker const message = await messageSendService . sendMessage ({ user , channelId , data: { sticker_ids: [ stickerId ], content: 'Optional message with sticker' }, requestCache }); // Stickers are rendered as large images in the message
Managing Stickers // Update sticker metadata const updated = await stickerService . updateSticker ({ userId , guildId , stickerId , name: 'Super Happy Face' , description: 'An extremely happy face!' , tags: [ 'happy' , 'smile' , 'joy' , 'ecstatic' ] }, 'Updated sticker details' );
Permissions Expression management requires specific permissions:
Required to create custom emojis and stickers
Required to edit or delete emojis/stickers
Required to use custom emojis from other guilds in this guild
Permission Checks // Check if user can create expressions await contentHelpers . checkCreateExpressionsPermission ({ userId , guildId }); // Check if user can modify (requires permission OR be the creator) await contentHelpers . checkModifyExpressionPermission ({ userId , guildId , creatorId: emoji . creatorId });
Audit Logging All expression operations are logged for moderation:
Logged when custom emoji is created { action : AuditLogActionType . EMOJI_CREATE , target_id : emojiId , user_id : creatorId , changes : [{ key: 'name' , new_value: 'partyblob' }] }
Logged when emoji is renamed
Logged when emoji is removed
STICKER_CREATE / UPDATE / DELETE
Similar logging for sticker operations
Gateway Events Expression changes are synchronized in real-time:
// GUILD_EMOJIS_UPDATE event { "t" : "GUILD_EMOJIS_UPDATE" , "d" : { "guild_id" : "123456789" , "emojis" : [ { "id" : "987654321" , "name" : "partyblob" , "animated" : false , "available" : true } ] } } // GUILD_STICKERS_UPDATE event { "t" : "GUILD_STICKERS_UPDATE" , "d" : { "guild_id" : "123456789" , "stickers" : [ ... ] } }
Best Practices
Optimize Image Sizes
Compress images before uploading to stay under size limits. Use tools like ImageOptim or TinyPNG.
Use Descriptive Names
Name emojis clearly so members can easily find and use them: :partyblob: not :pb1:
Organize with Categories
For guilds with many emojis, create a consistent naming scheme: :cat_happy:, :cat_sad:, :dog_happy:
Tag Stickers Effectively
Use relevant, searchable tags so members can find the right sticker quickly
Monitor Usage
Track which expressions are popular and remove unused ones to free up slots
Respect Copyright
Only upload original content or images you have permission to use
Expression Asset Storage Expressions are stored on Fluxer’s CDN:
// Emoji CDN URLs const emojiUrl = `https://cdn.fluxer.com/emojis/ ${ emojiId } . ${ animated ? 'gif' : 'png' } ` ; // Sticker CDN URLs const stickerUrl = `https://cdn.fluxer.com/stickers/ ${ stickerId } .png` ; // Assets are automatically uploaded when created await avatarService . uploadEmoji ({ prefix: 'emojis' , emojiId , imageBuffer , contentType: 'image/png' });
Expression assets are cached globally on the CDN for fast delivery. Purging (purge: true) removes them immediately but requires special guild features.
Troubleshooting
Check file size (256 KB for emojis, 512 KB for stickers)
Verify image format (PNG or GIF)
Ensure image is valid and not corrupted
Check that you haven’t reached your emoji/sticker limit
Verify you have USE_EXTERNAL_EMOJIS permission in the target guild
Check if you have global expressions enabled (premium feature)
Ensure the emoji still exists in its source guild
Expression Doesn't Appear
Clear client cache and reload
Verify the expression wasn’t deleted
Check that available is true
Ensure you’re looking in the correct guild
Communities Learn about guild features and limits
Messaging Use expressions in messages and reactions
Media & Embeds Understand media handling
API Reference Complete API documentation
