• 注册后才能下载/购买插件！快来注册吧，注册即可免费下载 精翻插件 ！【点我注册】
  • RustSB.COM向广大野生Rust插件作者发出入驻邀请！详情请见[原创作者条约]
【XMSanity·San值】(理智系统)

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

概述 配置文件 指令 权限 API 更新 (3) 历史 讨论 (3)

🔌 API接口​

其他插件调用示例​

C#: 
// 获取玩家San值
object GetPlayerSanity(string userID)

//获取玩家最大San值
object GetPlayerMaxSanity(string userID)

// 设置玩家San值
void SetPlayerSanity(string userID, float amount)

// 增加玩家San值
void AddPlayerSanity(string userID, float amount)

// 减少玩家San值
void RemovePlayerSanity(string userID, float amount)

// 检查玩家San值是否低于指定值
bool IsPlayerSanityLow(string userID, float threshold)

// 检查玩家San值是否高于指定值
bool IsPlayerSanityHigh(string userID, float threshold)

HOOK​

OnPlayerSanityIncrease​

玩家San值增加时触发（包括通过API增加）
C#: 
void OnPlayerSanityIncrease(BasePlayer player, float amount, float oldSan, float newSan, string reason)
参数说明：
  • player - 玩家对象
  • amount - 增加的数量（实际增加值，已考虑上限限制）
  • oldSan - 增加前的San值
  • newSan - 增加后的San值
  • reason - 增加原因（如"篝火"、"安全区"等）

OnPlayerSanityDecrease​

玩家San值减少时触发（包括通过API减少）
C#: 
void OnPlayerSanityDecrease(BasePlayer player, float amount, float oldSan, float newSan, string reason)
参数说明：
  • player - 玩家对象
  • amount - 减少的数量（实际减少值的绝对值，已考虑下限限制）
  • oldSan - 减少前的San值
  • newSan - 减少后的San值
  • reason - 减少原因（如"黑夜"、"雨天"等）

OnPlayerBecomeDemon​

玩家成为魔王时触发（包括自动触发和强制设置）
C#: 
void OnPlayerBecomeDemon(BasePlayer player, bool isForced, float duration)
参数说明：
  • player - 玩家对象
  • isForced - 是否通过指令强制设置（true=强制，false=自动触发）
  • duration - 魔王持续时间（秒），0表示永久

OnPlayerLoseDemon​

玩家失去魔王状态时触发
C#: 
void OnPlayerLoseDemon(BasePlayer player, bool wasForced)
参数说明：
  • player - 玩家对象
  • wasForced - 是否是强制设置的魔王（true=强制，false=自动触发）

OnFestivalStart​

节日开始时触发（包括自动触发和强制开启）
C#: 
void OnFestivalStart(string festivalName, bool isForced, float multiplier)
参数说明：
  • festivalName - 节日名称
  • isForced - 是否通过指令强制开启（true=强制，false=自动触发）
  • multiplier - San值倍率

OnFestivalEnd​

节日结束时触发（包括自动结束和强制关闭）
C#: 
void OnFestivalEnd(string festivalName, bool isForced)
参数说明：
  • festivalName - 节日名称
  • isForced - 是否通过指令强制关闭（true=强制，false=自动结束）
顶部 底部