DS-Ads

插件

· 作者 VyrByte

为 Bungee、Spigot 和 Velocity 创建、管理和发送高级公告给您的玩家。

0 本站下载 0 关注 更新于 1 个月前

最新 9.1.0 · 26.3 · Bukkit / BungeeCord

一键开服(送7天)

你的信息。你的玩家。你的服务器。

聊天 · 标题 · Boss 栏 · 动作栏

DS-Ads 为你的社区提供了一个清晰的场所,让成员听到重要的内容:规则、活动、有用的提醒以及他们加入时的欢迎语。配置每条公告一次,选择其显示方式,并在单个服务器或代理网络中推送。

DS-Ads 9.1.0 · Minecraft 1.13–26.3 Spigot / Paper · BungeeCord · Velocity · 一个通用 JAR

01 / 让你的信息被看到

动作栏中的安静提醒。全屏显示的欢迎语。可点击的聊天消息。启用适合当前场景的格式,或在同一条广告中组合多种格式。

  • 聊天。 编写带有可点击 URL 和悬停文本的多行公告。当你希望布局更刻意时,可以对单行进行居中处理。

  • 标题与副标题。 在屏幕上显示主标题和第二行文字,并配置淡入、停留和淡出的时间。

  • Boss 栏。 将消息保持在屏幕顶部。设置其颜色、样式和持续时间。

  • 动作栏。 在快捷栏上方显示紧凑的消息,而不会填满聊天窗口。

查看 DS-Ads 的实际效果

使用早期版本录制;当前界面和配置可能有所不同。

02 / 正确的信息。准时送达。

  • 自动轮换。 选择冷却时间并在 YAML 中添加命名广告。每个周期随机选择一条可用的广告;多条可用广告可避免立即重复。

  • 有意的欢迎。 在配置的加入延迟后发送专用的欢迎广告。在代理网络上,它在首次连接服务器后运行,并且不会在每次服务器切换时重复。

  • 针对每条广告的受众。 要求接收者拥有权限,并根据 Spigot/Paper 上的世界或 BungeeCord/Velocity 上的服务器进行过滤。留空这些字段以包含所有人。

  • 工作人员控制。 重新加载设置,启用或禁用自动推送,并向单个玩家或其符合条件的受众发送配置好的公告。

格式化、占位符 & 音效
  • MiniMessage。 使用命名颜色、HEX 颜色、渐变和文本样式。旧版客户端会显示最近的旧版颜色;完整 RGB 需要 Minecraft 1.16+。

  • 交互式聊天。 为聊天行添加可点击的 URL 和悬停文本。用 <center>...</center> 包裹聊天行以在所有支持的平台上居中显示。

  • PlaceholderAPI。 在 Spigot/Paper 上是可选的。安装你使用的占位符对应的扩展;它们适用于所有广告文本字段。DS-Ads 不提供自己的占位符扩展。

  • 音效。 Spigot/Paper 聊天公告可以播放 Bukkit 音效名称或资源键。空的 Sound 值将禁用音频。代理不播放这些通知音效。

03 / 从服务器到网络

相同的通用 JAR 包含了服务器和代理实现。选择公告运行的位置,并使用为该平台生成的设置。

  • Spigot / Paper: Minecraft 1.13–26.3。使用你的服务器所需的 Java 版本。未声明对 Folia 的支持。

  • BungeeCord / Velocity: 在同一 JAR 文件中放入代理插件文件夹,并通过你的代理权限管理器授予工作人员权限。Velocity 需要 Java 17 或更高版本,或者你安装的代理所需的更高 Java 版本。

  • PlaceholderAPI: 在 Spigot/Paper 上是可选的。该插件无需它即可工作;仅当你的消息使用其占位符时才安装它。没有代理 PlaceholderAPI 集成。

  • 网络设置: 在代理上运行 DS-Ads 以进行网络公告,或在单个服务器上运行以进行本地公告。除非你希望重复推送,否则避免在两个级别都配置相同的自动消息。

04 / 随时准备就绪

可读的 YAML 文件、少量命令集以及无需重启即可更改的设置。

安装与配置

  1. 将 DS-Ads-9.1.0.jar 放入所选服务器或代理的 plugins 文件夹,然后启动它。

  2. 打开插件数据文件夹中生成的 Settings.yml。编辑 Ads-Configuration 下的命名广告和单独的 Welcome-Ad。

  3. 选择格式、时间和接收者。在代理上使用 Servers;在 Spigot/Paper 上使用 Worlds。仅当你的服务器消息使用它们时才安装 PlaceholderAPI 及其所需扩展。

  4. 运行 /ads reload,然后使用 /ads send Ad-Rules YourPlayerName 预览广告。仅授予工作人员所需的命令权限。

命令 — 完整参考

Command: /ads · Alias: /dsads · All commands can also be run from the console.

/ads reload

Permission: ads.reload Reload Settings.yml. Invalid YAML keeps the previous working configuration.

/ads enable

Permission: ads.manage Enable automatic announcements and the welcome ad; save the enabled state.

/ads disable

Permission: ads.manage Stop automatic announcements and welcome messages; hide active boss bars and save the disabled state.

/ads send <ad> <player>

Permission: ads.send Force a configured ad to one online player. This bypasses recipient/location filters and the automatic enabled switch.

/ads send <ad> *

Permission: ads.send Send a configured ad to eligible online players, respecting its permission and location filters.

使用 Ads-Configuration 中配置的名称。命令补全会提示允许的子命令、广告名称和在线玩家。直接发送给某位玩家是一种管理员预览/强制发送;即使自动投递已禁用,它仍可运行。

权限 — 管理员与接收者

ads.send — 手动发送公告。 配置键: Permissions.Send

ads.manage — 启用/禁用自动投递;启用时接收更新通知。 配置键: Permissions.Manage

ads.reload — 重新加载配置。 配置键: Permissions.Reload

在 Spigot/Paper 上,这些默认的管理员节点会授予操作员(operators)。在代理服务器(proxies)上,请使用你的权限管理器进行分配。控制台拥有权限。请在 Permissions 中更改命令节点;若配置的命令节点为空,则回退到其默认值。

广告内部的 Permission 控制谁可以接收该广告。它可以是你选择的任何节点,例如 community.announcements.events。空的接收者权限意味着所有人都能接收。这并不会授予对 /ads 命令的访问权限。

配置 — 示例与时间参考

将此示例合并到你生成的 Settings.yml 中。它展示了一条欢迎聊天消息和一个命名的轮换广告。示例 URL 仅为占位符;请替换为你自己的服务器规则页面链接。

# 将这些部分合并到生成的 Settings.yml 中。
# 保留生成的 Plugin-Version 和 Config-Version 值。
Plugin-Configuration:
  Enabled: true
  Disable-Join-Leave-Messages: false
  Debug: false
  Update-Checker: true

Permissions:
  Send: "ads.send"
  Manage: "ads.manage"
  Reload: "ads.reload"

Welcome-Ad:
  Enabled: true
  Delay-Seconds: 1
  Content:
    Chat:
      Enabled: true
      Sound: ""
      Lines:
        - "<center><gold>Welcome!</gold> <gray>Enjoy your stay.</gray>"

Ads-Configuration:
  Cooldown: 120
  Ad-Rules:
    Worlds: []
    Permission: ""
    Chat:
      Enabled: true
      Sound: ""
      Lines:
        - "<center><gold>Build together. Play fair.</gold>"
        - "<gray><click:open_url:https://example.com/rules><hover:show_text:'<gray>Open the rules'>Read the server rules</hover></click></gray>"
    Boss-Bar:
      Enabled: true
      Message: "<gold>Build together. Play fair.</gold>"
      Color: "WHITE"
      Style: "PROGRESS"
      Duration-Seconds: 8
    Action-Bar:
      Enabled: true
      Message: "<gray>Your next adventure starts here.</gray>"
    Title:
      Enabled: false
      Title: "<gold>Welcome!</gold>"
      Subtitle: "<gray>Enjoy your stay.</gray>"
      Fade-In: 10
      Stay: 60
      Fade-Out: 20
  • 冷却时间。 Ads-Configuration.Cooldown 单位为秒(默认 120;最小值 5)。第一条自动广告需要等待完整的冷却时间。

  • 选择机制。 每个周期随机选择一条可用的广告。当有多条可用广告时,不会立即再次选中上一条广告。

  • 欢迎延迟。 Welcome-Ad.Delay-Seconds 单位为秒,限制在 0–60 之间。在代理服务器上,欢迎广告仅在首次连接服务器时运行,而非每次切换服务器时。

  • 接收者。 每条周期性广告都可以要求特定的 Permission。空值表示允许所有玩家。这与管理员命令权限是分开的。

  • 位置过滤。 在 Spigot/Paper 上使用 Worlds,在 BungeeCord/Velocity 上使用 Servers。空列表表示允许所有位置。这些过滤器适用于周期性广告和手动广播。

  • 标题计时。 Fade-In、Stay 和 Fade-Out 使用刻(ticks)为单位(20 刻 = 1 秒)。Boss-Bar.Duration-Seconds 使用秒为单位,最小值为 1。

  • Boss 栏设置。 颜色:PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE。样式:PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20。

  • 代理配置。 将 Worlds 替换为 Servers,并省略 Sound 和 Disable-Join-Leave-Messages。代理服务器上未集成 PlaceholderAPI。

  • 广告名称。 使用 Ads-Configuration 下的名称,例如 Ad-Rules。Welcome-Ad 单独配置,不能通过 /ads send 选择。

更新与安全重载

版本 9.1 就地更新了受支持的 9.0.x 配置文件,保留了数值、广告内容和注释。旧文件保存在 old-configs/ 目录下。请保持生成的版本字段不变。

如果重载时发现无效的 YAML,DS-Ads 会报告错误并保持上一个正常工作的配置。如果启动时的配置无效,公告将保持非活动状态,直到你修复它并运行 /ads reload。没有启用任何投递格式的广告将被跳过并附带警告。

/ads enable 和 /ads disable 会保存启用状态。禁用后会停止轮换和欢迎消息,并清除活跃的 Boss 栏。经过授权的管理员仍可使用直接手动发送功能。

文档与支持

需要帮助完成首次公告或配置更改吗?文档和社区就在身边。

合作伙伴

Teramont 是我们的托管合作伙伴。使用代码 Byte 可获得首月 15% 折扣。

© 2026 FruitForge Studios

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源