SimpleThirst

插件

· 作者 geturplugins

在你的服务器中添加口渴机制,喝水以确保你不会渴死。

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

最新 2.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

** ? SimpleThirst - 完整插件文档


? 概述

SimpleThirst 是一款轻量级、高度可定制的生存插件,为你的 Minecraft 服务器添加了逼真的口渴系统。玩家必须通过饮用干净或脏水来管理水分摄入,否则将遭受伤害和负面效果等后果。该插件提供三种不同的视觉显示模式、世界特定控制功能,并在服务器重启后完全保留数据。

版本: 1.0.0
API: Paper/Spigot 1.21+
依赖项: 无
大小: ~25KB


✨ 主要特性

? 核心机制

  • 动态口渴系统 (0-100 刻度)

    • 随时间自动消耗(间隔可配置)
    • 冲刺惩罚:冲刺时口渴值下降速度加倍
    • 死亡惩罚:口渴值归零会导致受伤 + 恶心效果
  • 两种水源

    • ? 干净水:喝药水瓶/牛奶桶 (+40 口渴值,无风险)
    • ? 脏水:潜行 + 右键点击水方块 (+15 口渴值,30% 几率中毒/饥饿)

?️ 三种显示模式

模式 位置 样式 适用场景
BOSSBAR 屏幕顶部 蓝色进度条 与 ActionBar 类插件配合使用
ACTIONBAR 快捷栏上方 Thirst: [████░░░░░░] 40% 居中 HUD 显示
HUNGER_ALIGN 饥饿值上方 85 ? (右对齐) 模拟原版 UI

? 世界管理

  • 三种过滤模式:
    • DISABLED - 在所有世界中生效(默认)
    • WHITELIST - 仅在指定世界中启用
    • BLACKLIST - 在指定世界中禁用
  • 进入禁用世界时自动隐藏显示
  • 跨越世界边界时发送智能通知

? 数据持久化

  • 使用 PersistentDataContainer (PDC) 存储玩家数据
  • 经历服务器重启、崩溃和重载后数据依然存在
  • 无需外部数据库
  • 插件更新不会导致数据丢失

⚙️ 性能优化

  • 异步任务处理
  • 单文件插件(无冗余代码)
  • 资源占用极小
  • 基于事件驱动架构(无轮询)

? 使用场景

?️ 生存服务器 为硬核生存玩法增加额外难度。玩家必须在探索期间规划水源,并为长途旅行携带饮用水。

? 角色扮演服务器 增强中世纪/奇幻 RP 服务器的真实感。水成为一种珍贵资源,鼓励玩家互动(售卖饮料、水井位置等)。

? 挑战服务器 创建自定义挑战:

  • 水源有限的沙漠生存
  • 结合口渴与健康双重消耗的超硬核模式
  • 需要不断寻找水源的游牧玩法

? 冒险地图 围绕寻找干净水源或净化方法设计任务线。整合自定义资源包以获得沉浸式体验。

?️ 多世界服务器 仅在特定世界中启用口渴机制:

  • 在生存世界启用,在创造/大厅世界禁用
  • 仅在自定义挑战世界启用
  • 在小游戏竞技场禁用

? 命令

命令 描述 权限 用法
/thirst check 查看你当前的口渴值 simplethirst.use 仅限玩家
/thirst set <player> <0-100> 设置目标玩家的口渴值 simplethirst.admin 控制台/管理员
/thirst reload 重新加载配置 simplethirst.admin 控制台/管理员

命令示例

/thirst check
→ "Your thirst: 73%"

/thirst set Notch 100
→ "Set Notch's thirst to 100"

/thirst reload
→ "SimpleThirst config reloaded!"

? 权限

simplethirst.use
  Description: 检查自己的口渴值
  Default: true (所有玩家)

simplethirst.admin
  Description: 设置他人的口渴值 & 重新加载配置
  Default: op (仅限操作员)

? PlaceholderAPI 集成

%simplethirst_thirst% → 75 %simplethirst_thirst_formatted% → &a75% %simplethirst_percentage% → 75% %simplethirst_status% → Hydrated %simplethirst_bar% → [||||||| ] %simplethirst_color% → &a (颜色代码)


⚙️ 配置指南

完整 config.yml 详解

 ═══════════════════════════════════════════════════
 DEPLETION SETTINGS (消耗设置)
 ═══════════════════════════════════════════════════
depletion-interval: 60
 口渴值减少的频率(秒)
 默认值:60(每分钟)
 推荐值:30-120 以保持平衡的游戏体验

 ═══════════════════════════════════════════════════
 DISPLAY SETTINGS (显示设置)
 ═══════════════════════════════════════════════════
display-mode: BOSSBAR
 选项:
   BOSSBAR       → 屏幕顶部的蓝色条(不与 ActionBar 类插件冲突)
   ACTIONBAR     → 快捷栏上方的居中文本
   HUNGER_ALIGN  → 饥饿值气泡上方的右对齐文本(使用带有间距的 ActionBar)

 ⚠️ 警告:ACTIONBAR 和 HUNGER_ALIGN 会与其他 ActionBar 类插件发生冲突!

 ═══════════════════════════════════════════════════
 WATER RESTORATION (水源恢复)
 ═══════════════════════════════════════════════════
clean-water-restore: 40
 饮水恢复的量:
   - 水瓶
   - 药水(任意类型)
   - 牛奶桶

dirty-water-restore: 15
 从水方块饮水恢复的量
 (空手潜行 + 右键点击水源)

dirty-water-debuff-chance: 0.30
 饮用脏水时获得中毒或饥饿效果的几率(0.0 - 1.0)
 0.30 = 30% 几率

 ═══════════════════════════════════════════════════
 DAMAGE SETTINGS (伤害设置)
 ═══════════════════════════════════════════════════
damage-amount: 1.0
 口渴值为 0 时造成的伤害量
 1.0 = 0.5 颗心

damage-interval: 5
 造成伤害的频率(秒)
 同时施加恶心效果

 ═══════════════════════════════════════════════════
 WORLD FILTER (世界过滤)
 ═══════════════════════════════════════════════════
world-filter-mode: DISABLED
 选项:
   DISABLED   → 在所有世界中生效(默认)
   WHITELIST  → 仅在下文列出的世界中生效
   BLACKLIST  → 除下文列出的世界外,在其他所有世界中生效

world-list:
  - world_nether
  - world_the_end
   在此添加世界名称(区分大小写!)
   使用 /worlds 或检查服务器文件夹以获取确切名称

? 配置示例

示例 1:极限模式沙漠服务器

depletion-interval: 30         口渴值下降更快
display-mode: HUNGER_ALIGN     沉浸式 UI
clean-water-restore: 30        恢复量减少
dirty-water-restore: 10        饮用脏水有风险
dirty-water-debuff-chance: 0.50   50% 几率生病
damage-amount: 2.0             造成 1 颗心的伤害
world-filter-mode: WHITELIST
world-list:
  - desert_world

示例 2:休闲生存服务器

depletion-interval: 120        消耗较慢
display-mode: BOSSBAR          非侵入式显示
clean-water-restore: 50        大量恢复
dirty-water-restore: 20        仍然可行
dirty-water-debuff-chance: 0.20   风险较低
damage-amount: 0.5             0.25 颗心
world-filter-mode: BLACKLIST
world-list:
  - creative
  - lobby
  - minigames

示例 3:角色扮演服务器

depletion-interval: 90
display-mode: ACTIONBAR
clean-water-restore: 40
dirty-water-restore: 15
dirty-water-debuff-chance: 0.40   为了真实感提高风险
damage-amount: 1.0
world-filter-mode: WHITELIST
world-list:
  - kingdoms
  - wilderness
  - trade_city

? 工作原理(技术层面)

数据流

玩家加入 → PDC 检查 → 如果是新玩家则初始化口渴值 (100)
     ↓
定时任务(每 X 秒执行一次)
     ├─ 检查是否在疾跑 → -2 口渴值
     └─ 正常移动 → -1 口渴值
     ↓
更新显示(BossBar/ActionBar/HungerAlign)
     ↓
如果口渴值 = 0 → 造成伤害 + 反胃效果(每 5 秒一次)

事件触发

PlayerItemConsumeEvent(玩家物品使用事件)
   └─ 检测到药水/牛奶 → +40 口渴值

PlayerInteractEvent(玩家交互事件)
   └─ 潜行 + 右键点击水源 + 空手
       ├─ +15 口渴值
       └─ 30% 几率 → 获得中毒/饥饿效果

PlayerChangedWorldEvent(玩家切换世界事件)
   └─ 检查世界过滤器 → 显示/隐藏界面

PlayerJoinEvent(玩家加入事件)
   └─ 从 PDC 加载口渴值 → 显示界面

显示渲染

BOSSBAR 模式:

BossBar.bossBar(
    "Thirst: 75%",      // 标题
    0.75f,              // 进度 (75%)
    Color.BLUE,         // 颜色
    Overlay.PROGRESS    // 样式
)

ACTIONBAR 模式:

&bThirst: &3[|||||||   ] &f70%
         ↑
    根据口渴百分比填充的条数

HUNGER_ALIGN 模式:

"                                         85 ?"
 ↑                                        ↑
 向右推的 45 个空格            口渴值 + 图标

? 兼容性

✅ 兼容

  • Paper 1.21+(推荐)
  • Spigot 1.21+(支持)
  • Purpur 1.21+(支持)
  • 大多数生存插件(Essentials、WorldGuard 等)
  • 经济类插件(用于自定义售水系统)
  • 自定义资源包

⚠️ 潜在冲突

插件类型 冲突情况 解决方案
其他 ActionBar 插件 如果两者都使用 ActionBar,会导致显示闪烁 将 SimpleThirst 设置为 BOSSBAR 模式
自定义口渴插件 机制重复 选择其中一个插件
冒险/生存套件 可能内置了口渴系统 禁用其口渴模块

? 推荐插件组合

组合 1:BossBar + ActionBar 组合

SimpleThirst → display-mode: BOSSBAR
UltimateHealthDisplay → display-mode: ACTIONBAR

组合 2:极简风格

SimpleThirst → display-mode: HUNGER_ALIGN
(不使用其他 HUD 插件)

组合 3:完整生存套件

SimpleThirst → display-mode: BOSSBAR
EssentialsX → 用于 /heal 豁免
WorldGuard → 保护出生点的水源
Vault → 链接经济系统以进行水的交易

? 性能指标

指标 数值
文件大小 ~25KB(单个类)
内存占用 <1MB(100 名玩家时)
CPU 影响 可忽略不计(~0.01%,在现代硬件上)
TPS 影响 无(异步任务)
事件处理器 4 个(已优化,条件触发)
数据库 无(使用 PDC)

? 安装

逐步指南

  1. 下载 SimpleThirst.jar 文件

  2. 上传 到服务器的 plugins/ 文件夹

    server/
    ├── plugins/
    │   └── SimpleThirst.jar  ← 放置于此
    ├── world/
    └── spigot.yml
    
  3. 重启 服务器(不要使用 /reload)

  4. 配置(可选)

    编辑:plugins/SimpleThirst/config.yml
    
  5. 重载配置(如果进行了更改)

    /thirst reload
    
  6. 在游戏中测试

    /thirst check
    

? 玩家指南

如何保持水分充足

方法 1:清水(最安全)

  • 酿造水瓶(玻璃瓶 + 水源)
  • 喝药水(任意类型)
  • 喝牛奶桶
  • 恢复: 40 口渴值

方法 2:脏水(有风险)

  1. 站在水源方块附近(河流、海洋、湖泊)
  2. 按住 SHIFT(潜行)
  3. 用 空手 右键点击 水面
  4. 恢复: 15 口渴值
  5. 风险: 30% 几率获得中毒或饥饿效果

视觉指示器

BossBar 模式:

[████████░░░░░░░░░░] Thirst: 40%

ActionBar 模式:

Thirst: [████░░░░░░] 40%

Hunger-Aligned 模式:

                                         40 ?
(出现在右侧,饥饿气泡上方)

警告信号

  • 低于 30% - 开始寻找水源
  • 低于 10% - 紧急!立即寻找水源
  • 0% - 正在受到伤害,视野模糊(反胃)

❓ 常见问题

Q:死亡后口渴值会保留吗? A: 是的!口渴值保存在玩家数据中,并在死亡、注销和服务器重启后得以保留。


Q:我可以在某些世界中禁用口渴吗? A: 可以!使用世界过滤系统:

world-filter-mode: BLACKLIST
world-list:
  - creative_world
  - minigames

Q:我可以将其与其他健康显示插件一起使用吗? A: 可以!将 SimpleThirst 设置为 BOSSBAR,并将你的健康插件设置为 ACTIONBAR(反之亦然)。


Q:如何让口渴值消耗得更快? A: 降低 depletion-interval 的值:

depletion-interval: 30   每 30 秒而不是 60 秒

问:此插件是否兼容模组添加的自定义水体方块? 答: 仅当该模组使用 Bukkit 的 Material.WATER 类型时才有效。大多数模组使用的是自定义方块,因此无法兼容。


问:我能否让口渴值在沙漠中消耗得更快? 答: 当前版本不支持。这需要实现生物群系检测功能。建议将此作为新特性提交请求!


问:如果我喝下可疑的炖肉会发生什么? 答: 它被视为药水,因此会恢复 40 点口渴值(SimpleThirst 不会产生负面效果)。


?️ 故障排除

问题:界面未显示 解决方案:

  1. 检查 config.yml 中的显示模式
  2. 确认你处于已启用的世界中(执行 /thirst check)
  3. 重载配置:/thirst reload
  4. 重启服务器

问题:操作栏闪烁 原因: 多个插件同时使用 ActionBar
解决方案: 将其中一个插件设置为 BOSSBAR 模式


问题:重启后口渴值重置为 100 原因: PDC 数据未保存(API 版本不匹配)
解决方案: 确保你使用的是 Paper/Spigot 1.21+


问题:脏水功能无效 检查清单:

  • 你是否正在 潜行?
  • 是否为 水源方块(非流动水)?
  • 你的 手是否空着?
  • 你是否处于 已启用的世界 中?

? 致谢与许可

开发者: geturplugins
API: Kyori Adventure (Paper)
许可协议: ARR 灵感来源: 《饥荒》、《方舟:生存进化》等游戏中的真实生存机制


? 支持与链接

  • 更新: 查看新版本
  • Discord: geturplugins

⭐ 最终总结

SimpleThirst 通过引入逼真的补水系统,改变了 Minecraft 的生存体验,具备以下特点:

✅ 智能机制(冲刺惩罚、饮用脏水风险)
✅ 3 种显示模式(适配任何服务器风格)
✅ 世界过滤(按世界控制)
✅ 零依赖(即插即用)
✅ 持久化数据(进度永不丢失)
✅ 轻量级(<1MB 内存占用,0% TPS 影响)

非常适合寻求深度游戏体验而不希望增加复杂性的生存、角色扮演和挑战类服务器。


版本: 1.1.0 | 最后更新: 2024 | 用心 ❤️ 制作,服务于 Minecraft 社区**

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源