** ? 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) |
? 安装
逐步指南
-
下载 SimpleThirst.jar 文件
-
上传 到服务器的 plugins/ 文件夹
server/
├── plugins/
│ └── SimpleThirst.jar ← 放置于此
├── world/
└── spigot.yml
-
重启 服务器(不要使用 /reload)
-
配置(可选)
编辑:plugins/SimpleThirst/config.yml
-
重载配置(如果进行了更改)
/thirst reload
-
在游戏中测试
/thirst check
? 玩家指南
如何保持水分充足
方法 1:清水(最安全)
- 酿造水瓶(玻璃瓶 + 水源)
- 喝药水(任意类型)
- 喝牛奶桶
- 恢复: 40 口渴值
方法 2:脏水(有风险)
- 站在水源方块附近(河流、海洋、湖泊)
- 按住 SHIFT(潜行)
- 用 空手 右键点击 水面
- 恢复: 15 口渴值
- 风险: 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 不会产生负面效果)。
?️ 故障排除
问题:界面未显示
解决方案:
- 检查
config.yml 中的显示模式
- 确认你处于已启用的世界中(执行
/thirst check)
- 重载配置:
/thirst reload
- 重启服务器
问题:操作栏闪烁
原因: 多个插件同时使用 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 社区**
** ? SimpleThirst - Complete Plugin Documentation
? Overview
SimpleThirst is a lightweight, highly customizable survival plugin that adds a realistic thirst system to your Minecraft server. Players must manage their hydration levels by drinking clean or dirty water sources, or they will suffer consequences including damage and debuffs. The plugin features three distinct visual display modes, world-specific control, and full data persistence across server restarts.
Version: 1.0.0
API: Paper/Spigot 1.21+
Dependencies: None
Size: ~25KB
✨ Key Features
? Core Mechanics
?️ Three Display Modes
| Mode |
Location |
Style |
Best For |
| BOSSBAR |
Top of screen |
Blue progress bar |
Combining with ActionBar plugins |
| ACTIONBAR |
Above hotbar |
Thirst: [████░░░░░░] 40% |
Centered HUD display |
| HUNGER_ALIGN |
Above hunger bar |
85 ? (right-aligned) |
Mimicking vanilla UI |
? World Management
- Three Filter Modes:
DISABLED - Works in all worlds (default)
WHITELIST - Only enabled in specified worlds
BLACKLIST - Disabled in specified worlds
- Auto-Hide Display when entering disabled worlds
- Smart Notifications when crossing world boundaries
? Data Persistence
- Uses PersistentDataContainer (PDC) for player data
- Survives server restarts, crashes, and reloads
- No external database required
- No data loss on plugin updates
⚙️ Performance Optimized
- Asynchronous task processing
- Single-file plugin (no bloat)
- Minimal resource footprint
- Event-driven architecture (no polling)
? Use Cases
?️ Survival Servers
Add an extra layer of difficulty to hardcore survival gameplay. Players must plan water sources during exploration and carry drinks for long journeys.
? Roleplay Servers
Enhance realism for medieval/fantasy RP servers. Water becomes a valuable resource, encouraging player interaction (selling drinks, water well locations).
? Challenge Servers
Create custom challenges:
- Desert survival with limited water sources
- Ultra-hardcore mode with thirst + health depletion
- Nomadic gameplay requiring constant water search
? Adventure Maps
Design quest lines around finding clean water sources or purification methods. Integrate with custom resource packs for immersive experiences.
?️ Multi-World Servers
Enable thirst only in specific worlds:
- Enable in survival worlds, disable in creative/lobby
- Enable in custom challenge worlds only
- Disable in minigame arenas
? Commands
| Command |
Description |
Permission |
Usage |
/thirst check |
View your current thirst level |
simplethirst.use |
Player only |
/thirst set <player> <0-100> |
Set target player's thirst |
simplethirst.admin |
Console/Ops |
/thirst reload |
Reload configuration |
simplethirst.admin |
Console/Ops |
Command Examples
/thirst check
→ "Your thirst: 73%"
/thirst set Notch 100
→ "Set Notch's thirst to 100"
/thirst reload
→ "SimpleThirst config reloaded!"
? Permissions
simplethirst.use
Description: Check own thirst level
Default: true (all players)
simplethirst.admin
Description: Set thirst for others & reload config
Default: op (operators only)
? PlaceholderAPI Integration
%simplethirst_thirst% → 75
%simplethirst_thirst_formatted% → &a75%
%simplethirst_percentage% → 75%
%simplethirst_status% → Hydrated
%simplethirst_bar% → [||||||| ]
%simplethirst_color% → &a (color code)
⚙️ Configuration Guide
Full config.yml Breakdown
═══════════════════════════════════════════════════
DEPLETION SETTINGS
═══════════════════════════════════════════════════
depletion-interval: 60
How often thirst decreases (in seconds)
Default: 60 (every minute)
Recommended: 30-120 for balanced gameplay
═══════════════════════════════════════════════════
DISPLAY SETTINGS
═══════════════════════════════════════════════════
display-mode: BOSSBAR
Options:
BOSSBAR → Blue bar at screen top (doesn't conflict with ActionBar plugins)
ACTIONBAR → Centered text above hotbar
HUNGER_ALIGN → Right-aligned above hunger bubbles (uses ActionBar with spacing)
⚠️ WARNING: ACTIONBAR and HUNGER_ALIGN will conflict with other ActionBar plugins!
═══════════════════════════════════════════════════
WATER RESTORATION
═══════════════════════════════════════════════════
clean-water-restore: 40
Amount restored by drinking:
- Water Bottles
- Potions (any type)
- Milk Buckets
dirty-water-restore: 15
Amount restored by drinking from water blocks
(Sneak + Right-click with empty hand on water source)
dirty-water-debuff-chance: 0.30
Chance (0.0 - 1.0) to get Poison or Hunger when drinking dirty water
0.30 = 30% chance
═══════════════════════════════════════════════════
DAMAGE SETTINGS
═══════════════════════════════════════════════════
damage-amount: 1.0
Damage dealt when thirst = 0
1.0 = 0.5 hearts
damage-interval: 5
How often damage is dealt (in seconds)
Also applies Nausea effect
═══════════════════════════════════════════════════
WORLD FILTER
═══════════════════════════════════════════════════
world-filter-mode: DISABLED
Options:
DISABLED → Works in all worlds (default)
WHITELIST → ONLY works in worlds listed below
BLACKLIST → Works in all worlds EXCEPT those listed below
world-list:
- world_nether
- world_the_end
Add world names here (case-sensitive!)
Use /worlds or check server folder for exact names
? Configuration Examples
Example 1: Hardcore Desert Server
depletion-interval: 30 Thirst drops faster
display-mode: HUNGER_ALIGN Immersive UI
clean-water-restore: 30 Reduced healing
dirty-water-restore: 10 Risky to drink dirty water
dirty-water-debuff-chance: 0.50 50% chance of sickness
damage-amount: 2.0 1 full heart damage
world-filter-mode: WHITELIST
world-list:
- desert_world
Example 2: Casual Survival Server
depletion-interval: 120 Slower depletion
display-mode: BOSSBAR Non-intrusive
clean-water-restore: 50 Generous healing
dirty-water-restore: 20 Still viable
dirty-water-debuff-chance: 0.20 Lower risk
damage-amount: 0.5 0.25 hearts
world-filter-mode: BLACKLIST
world-list:
- creative
- lobby
- minigames
Example 3: Roleplay Server
depletion-interval: 90
display-mode: ACTIONBAR
clean-water-restore: 40
dirty-water-restore: 15
dirty-water-debuff-chance: 0.40 Higher risk for realism
damage-amount: 1.0
world-filter-mode: WHITELIST
world-list:
- kingdoms
- wilderness
- trade_city
? How It Works (Technical)
Data Flow
Player Join → PDC Check → Initialize Thirst (100) if new
↓
Timer Task (Every X seconds)
├─ Check if sprinting → -2 thirst
└─ Normal movement → -1 thirst
↓
Update Display (BossBar/ActionBar/HungerAlign)
↓
If Thirst = 0 → Damage + Nausea (every 5s)
Event Triggers
PlayerItemConsumeEvent
└─ Potion/Milk detected → +40 thirst
PlayerInteractEvent
└─ Sneak + Right-click water + Empty hand
├─ +15 thirst
└─ 30% chance → Poison/Hunger effect
PlayerChangedWorldEvent
└─ Check world filter → Show/hide display
PlayerJoinEvent
└─ Load thirst from PDC → Show display
Display Rendering
BOSSBAR Mode:
BossBar.bossBar(
"Thirst: 75%", // Title
0.75f, // Progress (75%)
Color.BLUE, // Color
Overlay.PROGRESS // Style
)
ACTIONBAR Mode:
&bThirst: &3[||||||| ] &f70%
↑
Filled bars based on thirst %
HUNGER_ALIGN Mode:
" 85 ?"
↑ ↑
45 spaces to push right Thirst value + icon
? Compatibility
✅ Compatible With
- Paper 1.21+ (Recommended)
- Spigot 1.21+ (Supported)
- Purpur 1.21+ (Supported)
- Most survival plugins (Essentials, WorldGuard, etc.)
- Economy plugins (for custom water selling systems)
- Custom resource packs
⚠️ Potential Conflicts
| Plugin Type |
Conflict |
Solution |
| Other ActionBar plugins |
Flickering displays if both use ActionBar |
Set SimpleThirst to BOSSBAR mode |
| Custom thirst plugins |
Duplicate mechanics |
Choose one plugin |
| Adventure/Survival suites |
May have built-in thirst |
Disable their thirst module |
? Recommended Plugin Combos
Setup 1: BossBar + ActionBar Combo
SimpleThirst → display-mode: BOSSBAR
UltimateHealthDisplay → display-mode: ACTIONBAR
Setup 2: Clean Minimalist
SimpleThirst → display-mode: HUNGER_ALIGN
(No other HUD plugins)
Setup 3: Full Survival Suite
SimpleThirst → display-mode: BOSSBAR
EssentialsX → For /heal bypass
WorldGuard → Protect water sources in spawn
Vault → Link to economy for water trading
? Performance Metrics
| Metric |
Value |
| File Size |
~25KB (single class) |
| RAM Usage |
<1MB (100 players) |
| CPU Impact |
Negligible (~0.01% on modern hardware) |
| TPS Impact |
None (async tasks) |
| Event Handlers |
4 (optimized, conditional) |
| Database |
None (uses PDC) |
? Installation
Step-by-Step Guide
-
Download the SimpleThirst.jar file
-
Upload to your server's plugins/ folder
server/
├── plugins/
│ └── SimpleThirst.jar ← Place here
├── world/
└── spigot.yml
-
Restart your server (not /reload)
-
Configure (optional)
Edit: plugins/SimpleThirst/config.yml
-
Reload config (if changed)
/thirst reload
-
Test in-game
/thirst check
? Player Guide
How to Stay Hydrated
Method 1: Clean Water (Safest)
- Craft Water Bottles (glass bottle + water source)
- Drink potions (any type)
- Drink Milk Buckets
- Restores: 40 thirst
Method 2: Dirty Water (Risky)
- Stand near a water source block (river, ocean, lake)
- Hold SHIFT (sneak)
- Right-click the water with an empty hand
- Restores: 15 thirst
- Risk: 30% chance of Poison or Hunger
Visual Indicators
BossBar Mode:
[████████░░░░░░░░░░] Thirst: 40%
ActionBar Mode:
Thirst: [████░░░░░░] 40%
Hunger-Aligned Mode:
40 ?
(Appears to the right, above hunger bubbles)
Warning Signs
- Below 30% - Start looking for water
- Below 10% - Urgent! Find water immediately
- 0% - Taking damage, vision blurry (Nausea)
❓ Frequently Asked Questions
Q: Does thirst persist after death?
A: Yes! Thirst is saved to your player data and survives death, logout, and server restarts.
Q: Can I disable thirst in certain worlds?
A: Yes! Use the world filter system:
world-filter-mode: BLACKLIST
world-list:
- creative_world
- minigames
Q: Can I use this with other health display plugins?
A: Yes! Set SimpleThirst to BOSSBAR and your health plugin to ACTIONBAR (or vice versa).
Q: How do I make thirst deplete faster?
A: Lower the depletion-interval:
depletion-interval: 30 Every 30 seconds instead of 60
Q: Does this work with custom water blocks from mods?
A: Only if the mod uses Bukkit's Material.WATER type. Most mods use custom blocks, which won't work.
Q: Can I make thirst deplete faster in deserts?
A: Not in the current version. This would require biome detection. Consider requesting this as a feature!
Q: What happens if I drink a suspicious stew?
A: It counts as a potion, so it restores 40 thirst (no negative effects from SimpleThirst).
?️ Troubleshooting
Issue: Display not showing
Solutions:
- Check your display mode in
config.yml
- Verify you're in an enabled world (
/thirst check)
- Reload config:
/thirst reload
- Restart server
Issue: Flickering ActionBar
Cause: Multiple plugins using ActionBar
Solution: Set one plugin to BOSSBAR mode
Issue: Thirst resets to 100 on restart
Cause: PDC not saving (wrong API version)
Solution: Ensure you're using Paper/Spigot 1.21+
Issue: Dirty water not working
Checklist:
- Are you sneaking?
- Is it a water source block (not flowing)?
- Is your hand empty?
- Are you in an enabled world?
? Credits & License
Developer: geturplugins
API: Kyori Adventure (Paper)
License: ARR
Inspired by: Realistic survival mechanics from games like Don't Starve, ARK
? Support & Links
- Updates: Check for new versions
- Discord: geturplugins
⭐ Final Summary
SimpleThirst transforms Minecraft survival by adding a realistic hydration system with:
✅ Smart mechanics (sprint penalty, dirty water risk)
✅ 3 display modes (fits any server aesthetic)
✅ World filtering (per-world control)
✅ Zero dependencies (plug-and-play)
✅ Persistent data (never lose progress)
✅ Lightweight (<1MB RAM, 0% TPS impact)
Perfect for survival, roleplay, and challenge servers seeking deeper gameplay without complexity.
Version: 1.1.0 | Last Updated: 2024 | Made with ❤️ for the Minecraft community**
评论 0
登录后参与评分
还没有评论,来抢沙发吧