UltimateVirus - 终极病毒插件

UltimateVirus 是一款为 Minecraft 服务器设计的趣味插件，它模拟了病毒传播的机制。玩家可能被随机感染，健康值会大幅降低，并出现粒子效果和负面状态。通过制作和使用“抗病毒面具”与“疫苗”，玩家可以保护自己或治愈病毒，为生存玩法增添了策略与紧张感。

💡核心特性

• 动态感染系统：病毒会周期性地尝试感染随机在线玩家，感染几率可配置。
• 防护与治疗：玩家可以制作或获得“抗病毒面具”来抵御感染，或使用“疫苗”来治愈病毒。
• 自定义感染生物：特定生物有几率被感染，攻击玩家时会损坏其面具。
• proximity 传播：靠近已感染玩家会增加被感染的几率。
• 状态提示：提供丰富的 PlaceholderAPI 占位符、标题、副标题和聊天信息来反馈感染状态和事件。
• 高度可配置：几乎所有的消息、物品、几率、配方和规则都可以通过配置文件调整。

🎮命令与权限

插件主要功能通过物品交互实现，管理命令通常内置于插件中（如给予物品）。具体命令请参考插件发布页或使用 /plugins 查看。相关权限节点可能包括：

• ultimatevirus.give.mask - 允许给予抗病毒面具。
• ultimatevirus.give.vaxin - 允许给予疫苗。
• ultimatevirus.bypass - 可能允许绕过感染（如果配置支持）。

🔧配置文件详解

主要设置通过 config.yml 和 lang.yml 文件管理。

config.yml 主要设置

基础设置

• MinOnlinePlayers: 开始病毒传播所需的最小在线玩家数。
• InfectionSpreadDelay: 病毒尝试感染随机玩家的间隔时间（秒）。
• InfectionPercentage: 玩家感染病毒的基础几率（0-100）。
• OnlinePointsAddition: 玩家每次成功避免感染后增加的“在线点数”，此点数会累加到下次感染几率中，感染后清零。
• InfectOnlyOnSurvivalGamemode: 是否只感染生存模式玩家。
• InfectOpPlayers: 是否感染 OP 玩家。
• RemoveVirusOnPlayerDeath: 感染玩家死亡后是否清除病毒。
• DisabledWorlds: 病毒不会传播的世界列表。

物品设置

• MaskDisplayName / MaskLore: 抗病毒面具的显示名称和描述。
• VaxinDisplayName / VaxinLore: 疫苗的显示名称和描述。
• EnableMaskRecipe / EnableVaxinRecipe: 是否启用合成配方。
• MaskDmgOnVirusSave: 面具成功抵御一次病毒时消耗的耐久度。
• MaskLowHpWarnings: 面具耐久低于此值时开始发送警告（面具最大耐久为55）。

感染效果设置

• MaximumHealthWhenInfected: 感染后玩家的最大生命值（2点生命值 = 1颗心）。
• ParticlesWhenInfected: 感染时是否显示粒子效果。
• InfectionParticleType: 感染时显示的粒子类型（例如 SLIME）。
• EnablePotionEffectsWhenInfected: 是否启用药水效果。
• PotionEffectsWhenInfected: 感染时获得的药水效果列表，格式为 效果类型#等级#触发几率。
• PotionEffectsDuration: 药水效果持续时间（秒）。

自定义感染生物

• EnableMobInfection: 是否启用生物感染。
• MobTypes: 可被感染的生物类型列表（例如 ZOMBIE）。
• MobInfectionSpreadChance: 生物生成时被感染的几率（%）。
• CustomMobName: 被感染生物的自定义名称，可使用 %mob_type% 占位符。
• MaskDmgOnInfectedMobHit: 被感染生物击中时，玩家面具损失的耐久度。

占位符输出设置

用于配置 PlaceholderAPI 占位符的返回值。

• ultimatevirus_isInfected:
• ReturnMsgWhenTrue: 当玩家感染时返回的文本（例如 "yes"）。
• ReturnMsgWhenFalse: 当玩家健康时返回的文本（例如 "no"）。
• ultimatevirus_infectedTitle:
• ReturnMsgWhenTrue: 当玩家感染时返回的标题（例如 "Infected"）。
• ReturnMsgWhenFalse: 当玩家健康时返回的标题（例如 "Healthy"）。

自定义合成配方

在 custom-craftings 部分可以定义面具和疫苗的合成表。pattern 定义合成格布局（X 代表空气），ingredients 定义材料映射，格式为 字母:物品类型:数量。

lang.yml 消息设置

此文件包含所有插件发送的提示信息，支持颜色代码和占位符。主要消息包括：

• TitleOnInfection / SubtitleOnInfection: 被感染时显示的标题和副标题。
• TitleOnLowMaskHealth / SubtitleOnLowMaskHealth: 面具耐久低时的警告标题和副标题。
• MsgOnGiveMask / MsgOnGiveVaxin: 获得面具或疫苗时的提示。
• MsgOnRecover: 治愈病毒时的提示。
• MsgCheckVirus / MsgCheckVirusOthers: 检查自己或他人感染状态的信息。
• BroadcastOnPlayerInfection / BroadcastOnPlayerCure: 玩家感染或治愈时的全服广播。

✨可用占位符

插件提供以下 PlaceholderAPI 占位符：

• %ultimatevirus_totalInfected% - 返回当前被感染的玩家总数。
• %ultimatevirus_isInfected% - 返回玩家是否被感染（返回值在 config.yml 中自定义）。
• %ultimatevirus_infectedTitle% - 返回玩家的感染状态标题（返回值在 config.yml 中自定义）。

❓注意事项与依赖

• 必要前置：本插件需要 PlaceholderAPI 才能正常使用其占位符功能。
• 版本兼容：设置粒子效果 (InfectionParticleType) 和药水效果 (PotionEffectsWhenInfected) 时，请确保所选类型与你的服务器版本兼容。
• 配置生效：修改合成配方 (custom-craftings) 后，必须重启服务器才能使更改生效。修改其他大部分配置后，使用插件重载命令（如 /uv reload 或 /plugman reload ultimatevirus）即可生效，但建议在测试环境操作。
• 调试模式：配置文件中的 Debug 选项建议保持为 false，除非你明确知道其作用。