Emoji Locker Setup

The Emoji Locker paid module enables server administrators to lock specific server custom emojis and stickers behind chosen Discord roles (e.g. Server Boosters, Donators, VIPs, or Staff).

Installation & Claiming

1. Purchase the Emoji Locker add-on on the Zero Development Store.
2. In the Zero Development Discord, claim the entitlement with /claim in 「🤖」commands.
3. Restart Medusa or place the folder into modules/emojilocker.
4. Medusa logs Emoji Locker ✔ Loaded! on boot.

How It Works

Discord's default permissions only allow servers to enable or disable external emojis globally. With Emoji Locker:

1. You designate which emojis or stickers are restricted, and assign the authorized roles required to send them.
2. Medusa monitors message streams in real time.
3. If an unauthorized member sends a message containing a locked emoji:
   • The message is deleted automatically.
   • Medusa can optionally send a temporary direct message explaining why the message was removed and which role grants access.
   • The infraction is logged to your moderation audit channel.

Locking an Emoji

You can lock emojis either through the web dashboard or using Discord commands:

Method A: Discord Slash Command

/emojilocker lock emoji::pepe_crown: role:@Server Booster

Method B: Web Dashboard

1. Open your Medusa Dashboard and navigate to the Emoji Locker tab.
2. Click Add Emoji Rule.
3. Pick the custom emoji from your server's emoji catalog.
4. Select one or more required Discord roles.
5. Click Save Changes.

Dashboard Configuration

In the Emoji Locker dashboard configuration view:

• Auto-Delete Infractions: When enabled, unauthorized messages are deleted immediately upon receipt.
• Direct Message Alert: Toggle whether users receive a direct message explaining why their message was filtered.
• Custom Warning Message: Customize the direct message content with placeholders ({user}, {emoji}, {role}).
• Staff Exemption: Discord roles or administrative ranks automatically exempt from emoji locks.
• Log Channel: Audit channel recording whenever locked emoji enforcement triggers.

Commands Reference