Discord Bot Embed：用 EmbedBuilder 打造結構化訊息

import { EmbedBuilder } from "discord.js";

const embed = new EmbedBuilder()
  .setColor("#5865F2")
  .setTitle("這是標題")
  .setDescription("這是說明文字，支援 **粗體**、*斜體*、`code`。");
 
await interaction.reply({ embeds: [embed] });

.setColor("#5865F2")          // hex 字串
.setColor(0x5865f2)           // 數字格式
.setColor("Blurple")          // Discord 內建顏色名稱
.setColor("Random")           // 隨機顏色

.setAuthor({
  name: "Discord Bot",
  iconURL: "https://example.com/avatar.png",   // 左側小圓圖（選填）
  url: "https://example.com",                  // 點擊名稱可跳轉（選填）
})

.setTitle("查詢結果")
.setURL("https://example.com/result")   // 讓標題變成超連結（選填）

.setDescription("支援 Discord Markdown：\n**粗體** *斜體* ~~刪除線~~ `程式碼`\n[超連結](https://example.com)")

.addFields(
  { name: "欄位一", value: "內容", inline: true },
  { name: "欄位二", value: "內容", inline: true },
  { name: "欄位三", value: "內容", inline: true },
  { name: "換行欄位", value: "這個欄位獨佔一整排", inline: false },
)

.setThumbnail("https://example.com/thumb.png")

.setImage("https://example.com/banner.png")

.setFooter({
  text: "資料來源：XXX",
  iconURL: "https://example.com/icon.png",   // 選填
})
.setTimestamp()            // 目前時間
.setTimestamp(new Date())  // 指定時間

import { Client, GatewayIntentBits, EmbedBuilder } from "discord.js";
import "dotenv/config";
 
const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMembers],
});
 
// ── 指令定義 ──────────────────────────────────────────────────────
const COMMANDS = [
  {
    name: "user",
    description: "查詢使用者資料",
    options: [
      {
        name: "target",
        type: 6,          // USER
        description: "要查詢的使用者",
        required: true,
      },
    ],
  },
];
 
// ── ready：連線後註冊指令 ─────────────────────────────────────────
client.once("ready", async () => {
  console.log(`Bot 已上線：${client.user.tag}`);
  const guild = client.guilds.cache.first();
  await guild.commands.set(COMMANDS);
});
 
// ── interactionCreate ────────────────────────────────────────────
client.on("interactionCreate", async (interaction) => {
  if (!interaction.isChatInputCommand()) return;
 
  if (interaction.commandName === "user") {
    await handleUser(interaction);
  }
});
 
// ── /user handler ────────────────────────────────────────────────
async function handleUser(interaction) {
  const target = interaction.options.getUser("target");
  const member = interaction.guild?.members.cache.get(target.id);
 
  const embed = new EmbedBuilder()
    .setColor("#5865F2")
    .setAuthor({
      name: target.username,
      iconURL: target.displayAvatarURL(),
    })
    .setTitle("使用者資料")
    .setThumbnail(target.displayAvatarURL({ size: 256 }))
    .addFields(
      { name: "ID",       value: target.id,  inline: true },
      {
        name: "帳號建立於",
        value: `<t:${Math.floor(target.createdTimestamp / 1000)}:D>`,
        inline: true,
      },
      {
        name: "加入伺服器",
        value: member
          ? `<t:${Math.floor(member.joinedTimestamp / 1000)}:D>`
          : "未知",
        inline: true,
      },
      {
        name: "身份組",
        value: member?.roles.cache.map((r) => r.toString()).join(" ") || "無",
        inline: false,
      }
    )
    .setFooter({ text: `由 ${interaction.user.username} 查詢` })
    .setTimestamp();
 
  await interaction.reply({ embeds: [embed] });
}
 
client.login(process.env.BOT_TOKEN);

// 成功
const successEmbed = new EmbedBuilder()
  .setColor("#57F287")  // Discord 綠色
  .setTitle("✅ 操作成功")
  .setDescription(successMessage);
 
// 錯誤
const errorEmbed = new EmbedBuilder()
  .setColor("#ED4245")  // Discord 紅色
  .setTitle("❌ 發生錯誤")
  .setDescription(errorMessage)
  .setFooter({ text: "請稍後再試，或聯絡管理員" });
 
// 警告
const warnEmbed = new EmbedBuilder()
  .setColor("#FEE75C")  // Discord 黃色
  .setTitle("⚠️ 注意")
  .setDescription(warnMessage);

import { EmbedBuilder } from "discord.js";
 
export const successEmbed = (msg) =>
  new EmbedBuilder().setColor("#57F287").setTitle("✅ 操作成功").setDescription(msg);
 
export const errorEmbed = (msg) =>
  new EmbedBuilder().setColor("#ED4245").setTitle("❌ 發生錯誤").setDescription(msg);
 
export const warnEmbed = (msg) =>
  new EmbedBuilder().setColor("#FEE75C").setTitle("⚠️ 注意").setDescription(msg);