原创 【XMSanity·San值】(理智系统) 1.0.1

核心功能​

• 可拖拽的圆形San值图标UI
• 根据San值百分比动态显示不同图标（100%/70%/40%/10%）
• 实时显示当前/最大San值
• 支持自定义图标大小、文字大小和颜色

• 默认上限：100（可配置）
• 权限加成：为不同权限组设置不同的San值上限
• 等级加成：
• 服务器等级（VipLogo插件）
• BOSS等级（XMBossLV插件）
• 每N级提升一次上限，每次提升固定数值

• 增加/扣除自定义特效（配置自定义）
  • 默认使用音效
  • 支持留空禁用特效
• 增加/扣除时脉冲效果（配置开启）
  • 
• 增加扣除时动态文字（默认）
  • 

• 玩家重生后自动恢复San值（按百分比）
• 可配置仅在San值为0时恢复
• 或配置为任何情况下重生都恢复
• 设置为0禁用此功能

San值扣除机制​

• 黑夜（不在领地柜授权范围）
• 黑暗（不在领地柜授权范围并且无手持/头戴光源）
• 雨天（不在领地柜授权范围）
• 低温（温度低于设定值）
• 深水（水深超过设定值）
• 地下（地下深度超过设定值）
• 尸体（半径3米有其他玩家死亡）
• 动物攻击
• 低San值玩家靠近（San值低于10%的玩家）
• 腐烂食物
• 纪念碑（可指定特定纪念碑）
  • JSON:

    "纪念碑 - 指定纪念碑": [
      "Launch Site",        // 发射场（完整名称）
      "Military Tunnel",    // 军事隧道
      "Dome",              // 圆顶
      "Airfield",          // 飞机场
      "Power Plant",       // 发电厂
      "Water Treatment",   // 水处理厂
      "Train Yard",        // 火车站
      "Sewer Branch"       // 下水道
    ],

• 事件（DWAbyss深渊、RaidableBases、AbandonedBases）
• 其他插件调用

San值增加机制​

• 篝火附近（半径3米）
• 安全区
• 自然恢复（可设置权限）
• 关系组队（XMRelationship插件）
• 穿戴特定皮肤服装
• 攻击特定实体（可配置增加/扣除，支持冷却，需填写完整预制名）
• 攻击指定名称npc
• 指定食物
• 被其他玩家“安抚”
• 其他插件调用

San值影响系统​

减益效果（理智值过低）​

• 屏幕效果（配置可自定义）
  • 流血效果：assets/content/ui/overlay_bleeding.png
  • 中毒效果：assets/content/ui/overlay_poisoned.png
  • 冰冻效果：assets/content/ui/overlay_freezing.png
  • 催眠效果：assets/content/ui/hypnotized.png
• 恐怖图像显示（配置定义图像链接）
• 音乐影响（配置音乐链接）
• 自动发送聊天消息
• 属性扣除（血量/水量/饥饿/全部）
• 随机丢失物品
  • 模式1：只扣材料和组件
  • 模式2：只扣工具和武器
  • 模式3：只扣服装
  • 模式4：背包随机扣除（含主背包、腰带、衣服）
  • 每次扣除指定数量的物品种类
  • 显示扣除的物品名称和数量
• 禁用聊天指令
  • San值低于阈值时禁止使用指定指令
  • 支持完全匹配和前缀匹配（如禁用/kit会同时禁用/kit vip）
  • 可设置冷却时间，避免频繁提示
• 权限自动管理
  • San值 ≥ 阈值：自动给予权限列表中的所有权限
  • San值 < 阈值：自动撤销权限列表中的所有权限
  • 实时监控San值变化，动态调整权限
  • 给予/撤销权限时发送提示（避免重复提示）
  • 玩家下线自动清理状态记录
• 引来暗影黑豹
• 执行控制台指令
  • san值低于百分比时
  • 自定义控制台指令列表
  • 支持随机/全部执行列表
  • 支持执行后的冷却设置
• 其他插件调用

增益效果（理智值过高）​

• 属性恢复（血量/水量/饥饿/全部）
• 安抚功能（按住右键恢复他人San值）
• 获得幸运值（几率）
• 体力恢复
• 成为魔王
• 执行控制台指令
  • san值高于百分比时
  • 自定义控制台指令列表
  • 支持随机/全部执行列表
  • 支持执行后的冷却设置
• 其他插件调用

魔王模式​

• San值持续为0达到设定时间后，有几率成为魔王
• 魔王特权：
  • 可配置无敌状态
  • 可配置无法拾取物品
  • AI无视（炮塔/动物/NPC/武直/坦克）
  • 自动加入魔王权限组
  • 其他玩家靠近魔王扣除San值
  • 屏幕左下角显示红色骷髅图标（正方形）
• 全服通知玩家成为魔王
• 魔王排行榜（成为魔王次数）
• 数据持久化：
  • 魔王状态自动保存到数据文件（XMSanity_DemonData.json）
  • 玩家离线/插件卸载后重新上线，如果魔王时间未到，会自动恢复魔王状态
  • 自动恢复权限组和UI图标显示
  • 确保魔王状态不会因服务器重启而丢失
• 离线时间暂停：
  • 正常成为魔王的玩家，如果配置使用持续时间，玩家离线后不会扣除剩余时间
  • 玩家重新上线后才继续计时，确保玩家不会因离线而错过魔王状态
  • 强制设置的魔王同样适用此机制
• 

暗影黑豹​

• 启用开关：可通过配置启用/禁用黑豹召唤功能
• 自动召唤：San值低于设定百分比时自动召唤黑豹
• 黑豹特性：
  • 可设置黑豹血量
  • 可设置召唤冷却时间（默认600秒）
  • 可设置1分钟自动删除
  • 可设置只允许召唤者造成伤害
  • 召唤时提示玩家
• 击杀奖励：
  • San值奖励
  • 物品奖励（支持几率）
  • 指令奖励（支持几率）
• 击杀排行榜：记录击杀数并提供排行榜奖励
• 免疫权限：拥有免疫权限的玩家不会召唤黑豹

全局系统功能​

食物系统​

• 支持配置特定食物影响San值
• 腐烂食物自动扣除San值
• 食物效果：
  • 可设置增加/扣除San值
  • 可设置立即生效或每3秒生效
  • 可设置食物消化冷却时间

实体San值系统​

• 为指定实体设置san值上限，攻击与被攻击时san值会波动
  • 实体预制名：必须填写完整的prefab路径（精确匹配）
  • 攻击效果：
    • true = 攻击实体增加San值（如油桶，路牌，摆放物等）
    • false = 攻击实体扣除San值（如破坏建筑，坦克武直等）
  • 执行间隔秒：
    • 设置为0时无冷却，每次攻击都触发
    • 大于0时启用冷却，避免频繁触发
  • 影响san值数：每次触发增加/扣除的San值数量

NPCsan值系统​

• 为指定名称的NPC设置san值上限，攻击和被攻击时san值波动
  • 可设置攻击指定名称的NPC时触发
  • 为NPC设置它的默认san值
    • 玩家san值低于npcsan值时，npc攻击玩家几率为自身按伤害百分比吸血（增加npc血量）
    • 玩家san值高于npcsan值时，攻击npc几率触发暴击伤害
  • 攻击npc可灵活设置为玩家扣除san值，或增加san值

区域San值系统​

• 为指定区域设置san值增加/减少速度
• 配置区域san值变化的检测间隔

全服广播系统​

• 成为魔王的全服播报
• 死于san值导致的扣血播报
• 死于暗影黑豹的播报
• 节日上线播报

节日倍率系统​

• 自动节日：可配置特定日期的节日活动
  • 节日期间San值扣除/增加倍率调整
  • 支持每月特定日期+时间段触发
• 强制节日：管理员可手动开启/关闭节日
  • 使用 xmsanityfestivalon <节日名称> 开启
  • 使用 xmsanityfestivaloff 关闭
  • 强制节日不受日期和时间限制
  • 开启/关闭时全服广播通知
• 强制节日优先级高于自动节日

权限免疫系统​

• 支持为不同权限组设置免疫：
  • 免疫黑夜
  • 免疫黑暗
  • 免疫雨天
  • 免疫温度
  • 免疫深水
  • 免疫地下
  • 免疫尸体
  • 免疫动物
  • 免疫玩家
  • 免疫腐烂食物
  • 免疫纪念碑
  • 免疫事件
  • 免疫魔王

UI界面​

• 输入/san或点击图标进入主UI
• 详细的san值加/减，增益/减益分页介绍
  • 根据配置显示完整的san值系统加减，增益
  • 根据配置显示图表包括食物/服装/npc的详细san值影响介绍
  • 配置文件可自定义加减，增益四个页面的自定义项目，以便其他插件调用服主可自定义玩法说明
• 排行榜界面，显示周榜/月榜数据
  • 周排行榜和月排行榜
    • 周榜默认每周日晚九点开放领取，每周一凌晨零点重置（或手动控制台指令重置）
    • 月榜默认每月30号全天开放领取，不会自动重置，需要手动控制台指令重置
  • 支持物品奖励和指令奖励，支持前N名奖励配置
  • 点击标题奖励按钮可查看排行榜奖励列表
  • 排名基于：
    • 魔王成为次数（如启用）
    • 暗影黑豹击杀数（如启用）
    • 两者都启用优先按黑豹击杀数排名
• 暗影黑豹详情，掉落物品列表。
  • 召唤条件，血量等根据配置显示介绍
  • 掉落物品可视化物品列表，指令列表（特殊物品）
• 魔王详情页，增益效果说明