New Chunk Alerts

插件

· 作者 timnorthrop

一个 Paper 服务器插件,在玩家生成全新区块时通知他们!让玩家知道他们正在探索未开发且未被掠夺的领土,同时几乎不影响性能。

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

最新 1.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

新区块提醒

一个 Paper 服务器插件,当玩家生成全新区块时会向他们发出通知!让你的服务器上的玩家知道他们正在探索未charted(未开发)且未掠夺的领域。这是一个轻量级、非侵入式的插件,New Chunk Alerts 利用 Paper API 的 PlayerChunkLoadEvent 与 Bukkit 的 ChunkLoadEvent 相结合,以高性能检测和通知玩家新生成的区块。

New Chunk Alerts 演示截图

该插件最初是为了探索目的而编写的,但它也可以作为在启用 PvP 的服务器上寻找玩家的一种有趣方式!如果一名玩家在远离出生点的地方没有生成任何区块,很明显有人去过那里,并且可以通过观察 New Chunk Alerts 来追踪所谓的“区块痕迹”以找到敌人。

在新世界的最初几分钟里,每个人都会收到大量的新区块提醒!随着玩家建立基地和进行探索,新区块提醒的频率会降低,并且只会提醒你全新的地形!如果早期的提醒变得令人厌烦,玩家可以通过 /nca 命令为自己关闭它们。

要求

此插件使用了仅存在于 Paper API 中的类,因此使用的服务器软件必须是 Paper 或基于 Paper 的分支。New Chunk Alerts 目前官方支持适用于 Minecraft 版本 1.21.11 到 26.2 的稳定版 Paper 构建。

功能

  • 在一个区块生成后,只有第一个符合条件的、其客户端加载了该区块的玩家才会收到提醒。一旦为该区块发送了提醒,它将从通知映射中移除,防止对同一新生成区块的后续误报。
  • 不会对性能造成显著影响,特别是在小型到中型服务器上,因为下文详述的精心设计的解决方案。
  • 基于事件驱动:如果有大量静止或 AFK(挂机)玩家,或者位于预生成区块内的玩家,New Chunk Alerts 将简单地忽略他们!
  • 每个玩家只需运行 /nca 或 /newchunkalerts 即可切换区块提醒。

在不占用主服务器线程的情况下解决这个问题的过程比最初想象的更为复杂,因为 ChunkLoadEvent 的 getPlayersViewingChunk() 方法在生成时始终返回空列表,而 Paper 的 PlayerChunkLoadEvent 并未提供关于区块生成时间的任何信息。

为了按顺序跟踪生成的区块,并实现 O(1) 的查找和插入时间,在区块生成和玩家加载之间,使用由 HashMap 支持的 Deque 来跟踪区块。ChunkLoadEvent 监听器会将每个全新区块添加到 Deque 和 HashMap 中,而 PlayerChunkLoadEvent 监听器会在玩家启用了提醒且冷却时间已过时执行地图查找,如果存在则将其移除。相同的区块也会在下次清理时从队列中移除。

这使得插件能够在将区块发送给玩家客户端之前保留区块用于通知,而不必在每个 PlayerChunkLoadEvent 上执行 O(n) 操作。即使默认每 15 秒运行一次的清理操作也是 O(1) 操作的总和,这意味着总操作的时间由过期区块的数量决定。

不兼容项

  • 预生成的世界(使用诸如 Chunky 等插件):玩家仅会收到那些 ChunkLoadEvent 的 isNewChunk() 方法返回 true 的区块的通知,因此此插件不会通知玩家那些尚未访问但已被其他插件生成的区块。

配置

首次在你的服务器上运行插件时,会生成一个默认配置文件 (plugins/NewChunkAlerts/config.yml)。这是存储已禁用提醒的玩家列表的地方,但它还包含一些其他重要的变量,服务器所有者可以对其进行调整。这些变量的默认值应该适用于大多数服务器,但你可以根据自己的喜好随意调整它们。

chunk-queue-cleanup-cooldown-ms(默认相当于 15 秒):插件在重复清理区块队列之前等待的毫秒数。减少此值将使插件更频繁地检查过期的区块。

chunk-queue-entry-expiration-time-ms(默认相当于 3 分钟):在区块生成后,将其保留在队列中的毫秒数。将此数字设置得太小会导致插件在玩家有时间触发 PlayerChunkLoadEvent 并收到提醒之前就“忘记”了新区块。此配置选项的默认值对于大多数服务器来说应该没问题。然而,如果插件似乎不起作用,并且玩家在服务器上移动非常缓慢或渲染距离非常低,增加此数字并重启服务器可能会解决问题。

max-queued-chunks(默认 = 100,000):允许在队列中的最大区块数。一旦队列超过此大小,队列中最旧的区块将被移除,直到队列大小再次低于此值。如果你的服务器非常大且玩家未能正确接收提醒,请尝试增加此数字。

notification-cooldown-ms(默认相当于 1 分钟):插件在向同一玩家发送另一个通知之前必须等待的最小毫秒数。

其他项目

查看我在 Modrinth 或 CurseForge 上的其他项目:

modrinth.com/user/timnorthrop

curseforge.com/members/timnorthrop/projects

此插件中的代码均非 AI 生成。我的所有插件也是如此。如果我需要生成式 AI 来编写简单的 Minecraft 插件,我可能真的需要开始寻找新的工作了。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源