Contents
PCC Insurance玩家手册
目录
-
- 保险类型
-
- 玩家使用教程
-
- 指令与Tab补全
-
- 价格与优惠计算
-
- 数据库与可靠性
-
- 常见问题
1. 保险类型
| 类型 | 保护内容 | 默认主世界价格 |
|---|---|---|
| 基础保险 | 背包36格及快捷栏，不含 | 5000 |
| 盔甲和副手 | ||
| 装备保险 | 盔甲、当前主手和副手 | 3000 |
| 贵重物品保险 | 附魔、稀有材质、自定义名 | 3500 |
| 称、Lore、模型数据、 | ||
| ItemMeta/PDC物品 | ||
| 经验保险 | 保留死亡前整数等级，当前 | 2500 |
| 等级进度清零 |
类型
保护内容
掉落回收保险
默认主世界价格
将未保护的物品放入本人专
4500
属实体保险箱
高级保险
同时保护背包、装备和整数
9000
等级
每次购买获得一份额度。普通区域死亡消耗一份，高风险区域死亡需要并消耗两份。高风险区域只
有一份时不会部分消耗。
物品保险只选择一个产品，优先级为：
高级保险 > 基础保险 > 装备保险 > 贵重物品保险
高级保险已包含经验，不会重复消耗经验险。没有高级保险时，经验险可与一个物品险同时触发。
回收险只处理仍未保护的掉落；未被其他保险保护的剩余物品正常掉落。
同类保障同时存在维度专属与跨维度额度时，优先使用维度专属额度。保单默认有效7天，每种产
品与范围默认最多持有10份。
2. 玩家使用教程
执行/insurance打开保险商店：
-
- 点击一种保险产品。
-
- 选择具体世界或”跨维度”。
-
- 确认界面会列出基础价格、近期死亡数、倍率、新手优惠、续保优惠和最终价格。
-
- 点击绿色玻璃确认购买，余额不足或处于理赔冷却时不会扣款。
-
・ 当前保单：显示每份额度、范围、来源、实付金额和到期时间。
-
・ 理赔记录：最多显示最近100次保险触发记录。
-
・ 退保：点击具体有效额度并二次确认，返还实付金额的80%。
-
・ ActionBar：开启或关闭当前维度保险状态。
主菜单下方还可查看：
2.1 死亡与复活
死亡时插件会先保存理赔数据，再从掉落列表中移除受保护物品。复活后物品恢复到原栏位；栏位
被其他插件占用时，物品会掉落在复活点，避免覆盖。
复活后聊天栏显示触发的保险、消耗额度、保护数量、经验等级、赔付金额或保险箱坐标。没有触
发时会说明无适用保单、维度不匹配或高风险额度不足。
2.2 实体保险箱
回收险会在死亡点附近寻找有实体方块支撑的空气位置，并生成单箱或双箱：
-
・ 只有死亡玩家本人可以打开。
-
・ 保险箱不能被玩家破坏、爆炸、活塞或漏斗移动。
-
・ 默认存在30分钟，取空后立即移除。
-
・ 到期后箱子消失，剩余物品在原位置正常掉落并失去所有权保护。
-
・ 区块未加载时不会强制加载，到期处理会延迟至区块再次加载。
-
・ 找不到安全位置时不消耗回收险，物品保持正常掉落。
2.3 到期提醒与ActionBar
登录时，插件会汇总 24 小时内即将到期以及离线期间已经到期的保单。永久的管理员保单不参与
到期提醒。
ActionBar 采用事件驱动，只在切换世界、购买、退保、实际理赔、管理员修改、在线保单到期或
玩家主动开启显示时出现一次：
当前维度保险：已启用（3份/2种）
它只表示当前维度有可用额度，不会定时重复占用ActionBar，也不会周期性搜索当前结构。使用
/insurance actionbar可以为自己永久开关显示。
3. 指令与Tab补全
| 指令 | 用途 | 权限 |
|---|---|---|
| /insurance | 打开商店 | insurance.use |
| /insurance status | 查看当前保单 | insurance.use |
| /insurance cancel | 打开可退保保单 | insurance.use |
| /insurance logs | 查看理赔日志 | insurance.logs |
| /insurance actionbar | 开关状态栏 | insurance.use |
| /insurance admin < 玩家 > | 管理指定玩家 | insurance.admin.view |
| /insurance reload | 重载并校验配置 | insurance.reload |
| /insurance help | 显示可用帮助 无 |
别名/ins与/insurance相同。
所有子命令均支持Tab补全：补全会忽略大小写、排序、去重并按照发送者权限过滤。普通玩家看
不到 admin 或 reload；admin 的第二个参数会补全在线玩家及保险数据库中已知的离线玩家。控 制台仅补全可在控制台使用且有权限的命令。
3.1 权限默认值
| 权限 | 默认 |
|---|---|
| insurance.use | 所有玩家 |
| insurance.logs | 所有玩家 |
| insurance.admin.view | OP |
| insurance.admin.modify | OP |
| insurance.reload | OP |
4. 价格与优惠计算
默认统计最近7天全部死亡，无论是否触发保险。每次死亡增加10%，最高为基础价2倍。前三笔
成功购买半价；未理赔自然到期的产品会给下一份相同产品和范围一次九折资格。
计算顺序：
最终价格 = 基础价格 × 死亡倍率 × 续保折扣 × 新手折扣
例如主世界基础保险价格5000，最近死亡 2次、仍处于前三笔、没有续保优惠：
5000 × 1.2 × 0.5 = 3000
任何保单实际理赔后，15分钟内不能购买新额度，但已经持有的其他额度仍然有效。
5. 数据库与可靠性
SQLite使用WAL、外键和5秒忙等待。数据包括玩家设置、死亡计价历史、每份保单、续保资格、
理赔、待恢复物品、保险箱、待处理款项和管理员审计。
Vault 退款或赔付失败时不会静默丢失：款项进入 pending_money，插件每分钟重试。死亡时受保
物品会先写入 pending_restores，玩家复活或下次登录时恢复。理赔日志默认保留180天，计价 死亡历史保留7天。
不要手工编辑运行中的数据库。需要迁移数据时，关闭服务器后复制整个插件数据目录。
6. 常见问题
6.1 插件启动后立即禁用
检查是否安装Vault和一个经济插件，并确认控制台出现Vault Economy服务名称。只有Vault本
体、没有经济实现时仍然无法启动。
6.2 GUI中没有自己的世界
pricing.worlds的世界名与实际世界文件夹名不一致。使用服务器实际名称新增完整的六种价格，
然后重载。
6.3 余额足够却不能购买
检查是否处于理赔后的15分钟冷却、该产品和范围是否已达到10份上限，以及Vault 经济插件是
否正常。
6.4 高风险结构没有生效
确认 namespaced key 正确、结构已经生成，并且死亡所在区块处于加载状态。可增加
structure-padding-blocks，但插件不会为了识别结构强制加载新区块。
6.5 没有生成保险箱
死亡点搜索半径内必须存在空气方块，且下方为可支撑方块。找不到位置时物品正常掉落且不会扣
回收险。
6.6 配置重载失败
检查YAML缩进、材质名、七种产品价格是否齐全及数值是否非负。失败时当前运行配置不会被替
换，详细原因会写入控制台。
6.7 ActionBar覆盖其他插件
ActionBar 已经只在保险或世界状态变化时显示一次。玩家仍可执行 /insurance actionbar 将其
完全关闭。
PCC服务器・保险插件玩家手册