サーバーのカスタム絵文字をzipで一括保存し、そのzipから別サーバーまたは同一サーバーへ絵文字を一括追加する管理者向け機能です。
使い方
| 操作 |
形式 |
内容 |
| エクスポート |
/emoji_export |
このサーバーのカスタム絵文字をzip形式で保存します。 |
| インポート |
/emoji_import archive:<zipファイル> |
emoji_exportで保存したzip内の絵文字をこのサーバーへ追加します。 |
引数
| コマンド |
引数 |
説明 |
/emoji_export |
なし |
引数はありません。実行したサーバーのカスタム絵文字を対象にします。 |
/emoji_import |
archive |
必須。/emoji_export で保存したzipファイル、または対応形式の絵文字画像を含むzipファイルを添付します。 |
応答・返り値
/emoji_export は成功時、実行者本人だけにzipファイルを送信します。- zip内では静止画絵文字を
static/、アニメーション絵文字を animated/ に保存し、絵文字名やファイル名を記録した manifest.json も含めます。
/emoji_import は完了時に 追加 n 個 / スキップ n 個 / 失敗 n 個 の結果を実行者本人だけに表示します。- 絵文字が無い、スロットに空きが無い、zipが不正、権限不足などの場合はエラーメッセージを返します。
必要条件・権限
- どちらのコマンドもサーバー内でのみ使用できます。
- 実行者には管理者権限が必要です。
/emoji_export ではbotにメッセージ送信、ファイル添付の権限が必要です。/emoji_import ではbotに 絵文字とスタンプの管理 とメッセージ送信の権限が必要です。/emoji_import で追加できる数は、サーバーの絵文字スロットの空き数までです。
制限・仕様
- インポートzipは最大25MBです。
- zip内のファイル数は最大300件です。
- zip展開後の合計サイズは最大80MBです。
- 1つの絵文字画像は最大256KBです。
- 対応画像形式は
.png, .jpg, .jpeg, .gif です。
- zipはメモリ上で検査し、ディスクには展開しません。
- zip内の絶対パス、親ディレクトリ参照、不正な画像シグネチャは取り込み対象から除外します。
使用例
/emoji_export
/emoji_import archive:server_emojis.zip
エラー・注意点
- 同名の絵文字が既に存在する場合は、名前に連番を付けて重複を避けます。
- Discord側の絵文字上限や画像制限により、一部の絵文字が追加できない場合があります。
- エクスポート結果のzipがサーバーのアップロード上限を超える場合、Discordへ送信できません。
コメント