MysticalVillager

插件

· 作者 mysticalcraft-ancientvipers

MysticalVillager 是一款适用于 Paper 服务器的全面村民管理插件。它会追踪服务器上的每一次治愈、击杀和繁殖行为,同时提供防滥用保护、可配置奖励以及无需登录的实时 Web 仪表盘。

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

最新 1.0.1 · 1.21.11 · Paper

一键开服(送7天)

MysticalVillager

追踪、奖励并保护你服务器中的村民生态

功能 • 安装 • 命令 • 网页仪表盘 • API


概述

MysticalVillager 是一款面向 Paper 服务器的全面村民管理插件。它追踪服务器上每一次治愈、击杀和繁殖行为,并提供反滥用保护、可配置的奖励系统以及无需登录的实时网页仪表盘。

无论你是运营小型 SMP 还是大型网络,MysticalVillager 都能为你提供监控和奖励积极村民互动行为的工具,同时检测并防止滥用行为。


功能

追踪与统计

追踪每位玩家治愈、击杀和繁殖的村民数量。插件会维护连胜记录、个人最佳成绩以及整个服务器的全局统计数据。所有数据在重启后持久保存,可通过命令、PlaceholderAPI 或网页仪表盘访问。

奖励系统

奖励玩家治愈僵尸村民的行为,奖励形式包括金钱、经验值、物品或自定义命令。每种奖励类型都有独立的概率设置,冷却时间机制可防止刷取治愈奖励。系统通过 Vault 集成实现经济支持。

反滥用检测

评分系统分析玩家行为以检测可疑活动。它能捕捉快速治愈、反复针对同一村民的行为,并根据集中度和繁殖模式识别村民农场。当检测到滥用行为时,将阻止奖励发放并通知工作人员。

跨插件保护

自动拦截来自 Citizens NPC、MythicMobs 及其他类似插件生成的虚假村民。这可以防止玩家利用生成的生物来骗取奖励。

冷却保护

当玩家在冷却期间尝试治愈时,物品不会被浪费:

  • 金苹果在被阻止时会保留在背包中
  • 如果玩家在冷却期间将虚弱药水扔向僵尸村民附近,药水会被退回
  • 通过标题消息显示剩余冷却时间的视觉反馈

击杀惩罚

可选的玩家击杀村民时损失经验值。可配置等级惩罚,并在屏幕上显示羞耻提示消息。

标题消息

治愈、击杀和繁殖事件对应的屏幕标题(title)和副标题(subtitle)。文本完全可配置,支持颜色代码。可按事件类型启用或禁用。

网页仪表盘

公共网页界面展示实时统计数据:

  • 全局及按玩家划分的统计
  • 可按类型(治愈/击杀/繁殖)和时间段筛选的排行榜
  • 带有详细统计模态框的玩家搜索功能
  • 显示治愈模式的每周活动图表
  • 小时分布图
  • 带有玩家头像的最新活动流
  • 完全响应式设计,适配移动设备

仪表盘通过服务器发送事件(Server-Sent Events)自动更新,无需刷新页面。

Discord 集成

通过 Webhook 将事件发送到 Discord。支持治愈通知、滥用警报、农场检测警告和利用阻止提醒,并提供丰富的嵌入消息和玩家信息。

多语言

内置英语、荷兰语(Nederlands)、德语(Deutsch)、西班牙语(Español)和葡萄牙语(Português)。所有消息均可通过语言文件自定义。

PlaceholderAPI 支持

提供 15+ 个占位符,可用于记分板、全息图、标签页列表等。


要求

软件 版本
Paper(或其分支如 Purpur) 1.21.x
Java 21+

可选集成:

  • PlaceholderAPI
  • Vault(用于金钱奖励)

安装

  1. 从 Modrinth 或 GitHub Releases 下载
  2. 将 JAR 文件放入 plugins/ 文件夹
  3. 重启服务器
  4. 编辑 plugins/MysticalVillager/config.yml
  5. 使用 /mysticalvillager reload 应用更改

命令

命令 描述 权限
/mysticalvillager help 显示帮助 -
/mysticalvillager stats [player] 查看统计信息 mysticalvillager.stats
/mysticalvillager leaderboard 查看排行榜 mysticalvillager.leaderboard
/mysticalvillager reload 重载配置 mysticalvillager.reload
/mysticalvillager debug [player] 调试信息 mysticalvillager.debug

别名: /villagers, /mvillager, /mystvillager

故意避免使用 /mv 以防止与 Multiverse 冲突。


权限

权限 描述 默认值
mysticalvillager.admin 完整管理员访问权限 op
mysticalvillager.stats 查看自己的统计信息 true
mysticalvillager.stats.others 查看他人的统计信息 op
mysticalvillager.leaderboard 查看排行榜 true
mysticalvillager.reload 重载配置 op
mysticalvillager.staffalerts 接收滥用警报 op
mysticalvillager.bypass.cooldown 绕过治愈冷却 false
mysticalvillager.bypass.antidupe 绕过防重复检测 false

网页仪表盘

访问地址为 http://your-server-ip:25574(端口可配置)

仪表盘采用深色主题和玻璃拟态设计。它显示:

  • 实时统计计数器
  • 带有过滤选项的排行榜
  • 玩家搜索功能
  • 活动图表(每周 + 每小时分布)
  • 最近的治愈事件动态
  • 配置好的奖励概率

速率限制可防止垃圾信息。如果超出限制,将显示友好的倒计时页面。


PlaceholderAPI

占位符 描述
%mysticalvillager_cured% 玩家的治愈数
%mysticalvillager_killed% 玩家的击杀数
%mysticalvillager_bred% 玩家的繁殖数
%mysticalvillager_streak% 当前连胜
%mysticalvillager_best_streak% 最佳连胜
%mysticalvillager_global_cured% 服务器总治愈数
%mysticalvillager_global_killed% 服务器总击杀数
%mysticalvillager_global_bred% 服务器总繁殖数
%mysticalvillager_top_curer% #1 治愈者名称
%mysticalvillager_leaderboard_<n>_name% 第 N 名的名称
%mysticalvillager_leaderboard_<n>_count% 第 N 名的数值

Discord Webhooks

discord:
  enabled: true
  webhookUrl: "https://discord.com/api/webhooks/..."
  serverName: "My Server"
  events:
    cure: true
    abuseDetected: true
    farmDetected: true
    exploitBlocked: true

API

REST 端点

端点 方法 描述
/api/stats/global GET 全局统计
/api/stats/player/{uuid} GET 玩家统计
/api/players/search?q=name GET 按名称搜索玩家
/api/leaderboard?type=CURED&period=ALL GET 排行榜
/api/activity/week GET 每周活动数据
/api/activity/hour GET 每小时分布
/api/events/recent?limit=10 GET 最近的事件
/api/rewards GET 已配置的奖励
/api/events/stream GET SSE 事件流

服务端推送事件 (SSE)

连接到 /api/events/stream 以获取实时更新:

  • connected - 初始连接已建立
  • stats_update - 统计数据发生变化
  • cure - 新的治愈事件
  • heartbeat - 心跳保持(每 30 秒一次)

数据库

支持 SQLite(默认)、MySQL 和 MariaDB。所有操作均为异步,并通过 HikariCP 进行连接池管理。

database:
  type: sqlite  # 或 mysql, mariadb
  
  # MySQL/MariaDB 设置
  host: localhost
  port: 3306
  database: mysticalvillager
  username: root
  password: ""

配置亮点

奖励
rewards:
  enabled: true
  chance: 100
  items:
    money:
      enabled: true
      chance: 80
      amount: 500
      command: "eco give %player% %amount%"
    experience:
      enabled: true
      chance: 50
      amount: 100
      command: "xp give %player% %amount%"
反滥用
antiAbuse:
  enabled: true
  threshold: 50
  scoring:
    fastCure: 5
    repeatedVillagerUuid: 10
    farmDetected: 15
标题消息
titles:
  cure:
    enabled: true
    title: "&a&l村民被治愈!"
    subtitle: "&7+500 金币"
  kill:
    enabled: true  
    title: "&c&l村民被击杀"
    subtitle: "&7-2 XP 等级"

性能

  • 异步数据库操作
  • 激进缓存,具有可配置的 TTL
  • 不阻塞主线程
  • 高效的实体扫描
  • HikariCP 连接池

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源