Discord.js Embed字段值长度限制与角色列表截断策略

/**
 * 生成截断的角色列表字符串，以符合Discord Embed字段的长度限制。
 * 如果角色列表过长，将截断并在末尾添加“+N other roles”指示。
 * @param {Array<Role>} roles - Discord Role对象的数组。
 * @returns {string} 截断后的角色列表字符串。
 */
function generateTruncatedRoleList(roles) {
  // Discord Embed字段值的最大字符长度为1024。
  // 我们将MAX_CHARACTERS设置得略小于1024，
  // 以便为末尾的“+N other roles”留出空间。
  const MAX_CHARACTERS = 1000;
  // 用于连接角色名称的分隔符
  const SEPARATOR = ', ';

  let roleListParts = []; // 用于存储将要显示的角色部分
  let remainingRolesCount = 0; // 记录未显示的角色数量

  for (const role of roles) {
    // 尝试添加当前角色到列表
    roleListParts.push(role);

    // 检查当前拼接后的字符串长度是否超过限制
    if (roleListParts.join(SEPARATOR).length > MAX_CHARACTERS) {
      // 如果超过，则移除最后一个角色（因为它导致了超限）
      roleListParts.pop();
      // 计算剩余未显示的角色数量
      remainingRolesCount = roles.length - roleListParts.length;
      break; // 达到限制，停止添加
    }
  }

  // 如果有未显示的角色，则在列表末尾添加指示
  if (remainingRolesCount > 0) {
    roleListParts.push(
      `+${remainingRolesCount} other role${remainingRolesCount > 1 ? 's' : ''}`,
    );
  }

  // 返回最终拼接好的字符串
  return roleListParts.join(SEPARATOR);
}

const {
  SlashCommandBuilder,
  EmbedBuilder
} = require("discord.js");

// 引入上面定义的辅助函数
// 如果函数在同一文件，则无需require
// 如果在单独文件，例如 utils/roleHelper.js，则需要：
// const { generateTruncatedRoleList } = require('../utils/roleHelper');

// ... (generateTruncatedRoleList 函数代码放在这里或单独引入)

module.exports = {
  data: new SlashCommandBuilder()
    .setName("serverinfo")
    .setDescription("Provides information about the server.")
    .setDMPermission(false),

  async execute(client, interaction) {
    const { guild } = interaction;
    // 确保guild.roles已缓存，或使用fetch获取
    await guild.roles.fetch(); // 确保所有角色都已缓存

    const embed = new EmbedBuilder()
      .setColor('#2B2D31')
      .setTitle(`Server info - ${guild.name}`)
      .setFooter({text: `Server ID: ${guild.id} | Server Created: ${guild.createdAt.toDateString()}`})
      .setThumbnail(guild.iconURL({ size: 256 }))
      .setImage(guild.bannerURL({ size: 256 }))
      .addFields(
        { name: 'Owner', value: (await guild.fetchOwner()).user.tag, inline: true },
        {
          name: 'Text Channels',
          value: guild.channels.cache.filter((c) => c.type === 0).size.toString(),
          inline: true,
        },
        {
          name: 'Voice Channels',
          value: guild.channels.cache.filter((c) => c.type === 2).size.toString(),
          inline: true,
        },
        {
          name: 'Category Channels',
          value: guild.channels.cache.filter((c) => c.type === 4).size.toString(),
          inline: true,
        },
        { name: 'Members', value: guild.memberCount.toString(), inline: true },
        { name: 'Roles', value: guild.roles.cache.size.toString(), inline: true },
        {
          name: 'Role List',
          // 使用辅助函数处理角色列表
          value: generateTruncatedRoleList(guild.roles.cache.toJSON()),
        },
      );
    interaction.reply({ embeds: [embed] });
  },
};