VitalVials

插件

· 作者 b4n9z

一个简单的插件,允许你使用生命值购买效果。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.7 · Bukkit / Paper

一键开服(送7天)

VitalVials 插件

VitalVials 是一款独特的 Minecraft 插件,允许玩家使用生命值购买和管理游戏内效果。通过完全可自定义的配置,服务器管理员可以在风险与回报之间取得平衡,玩家必须仔细权衡强大效果的代价与其自身生命力之间的关系。

功能特性

  • 基于生命值的经济系统:玩家消耗最大生命值/生命值点数以换取强大的效果
  • 完全可配置:自定义每个效果的各个方面、成本和机制
  • 动态计分板:实时追踪当前生效的效果及其剩余持续时间
  • 玩家专属设置:每位玩家均可自定义自己的计分板显示
  • 冷却系统:通过可配置的冷却时间防止效果滥用
  • 退款系统:支持退还已购买的效果(可按单个效果单独配置)

安装步骤

  1. 从 发布页面 下载最新版本的 VitalVials
  2. 将 VitalVials.jar 文件放入服务器的 plugins/ 目录中
  3. 重启服务器
  4. 在 plugins/VitalVials/config.yml、plugins/VitalVials/effects.yml 和 plugins/VitalVials/activation.yml 中按喜好配置插件
  5. 使用 /vv reload 命令应用更改,无需重启服务器

指令

主指令

  • /vv 或 /vitalvials - VitalVials 的主指令

子指令

  • /vv reload - 重载插件配置
  • /vv shop - 打开效果商店
  • /vv buyEffect <effect> - 直接购买指定效果
  • /vv viewStatus - 查看你当前激活的效果状态
  • /vv scoreboard <on/off/editShort> - 开启、关闭或自定义你的计分板
  • /vv refundEffect <effect> - 退还指定效果
  • /vv removeData <player/allPlayer> - 删除玩家数据

权限说明

权限名称 描述 默认值
vv.admin 拥有所有指令的完整访问权限 op
vv.reload 允许重载插件配置 op
vv.shop 访问效果商店 op
vv.buyEffect 允许购买效果 op
vv.viewstatus 查看自身效果状态 op
vv.scoreboard 访问计分板自定义功能 op
vv.refundEffect 退还已购买的效果 op
vv.removedata 删除玩家数据 op

配置说明

VitalVials 高度可配置,主要通过 config.yml、effects.yml 和 activation.yml 三个文件进行设置。以下是主要配置部分:

主配置文件

点击展开 配置文件(config.yml)允许你自定义插件的多个方面:
effects: effects.yml # 包含效果列表的 effects.yml 文件路径
activation: activation.yml # 激活设置
maxHP: # 最大生命值上限
  enabled: true # 启用/禁用最大生命值上限。启用后,玩家在尝试退还效果时无法获得额外生命值,因此玩家的生命值不会超过你设定的上限
  value: 20 # 最大生命值(生命点数)
minHP: 2 # 最低生命值限制:当玩家生命值等于或低于此数值时,将不允许购买效果
scoreboard: # 记分板设置
  defaultShowScoreboard: true # 默认在右侧显示记分板(如果授予权限,每个玩家可以自行使用命令关闭)
  periodUpdate: 10 # 更新记分板的间隔时间(以秒为单位)
permissionsAllPlayer:
  reload: false # 允许所有玩家使用重载命令
  shop: true # 允许所有玩家使用商店命令
  buyEffect: true # 允许所有玩家使用购买效果命令
  viewStatus: true # 允许所有玩家使用查看状态命令
  scoreboard: true # 允许所有玩家使用记分板命令
  refundEffect: true # 允许所有玩家使用退还效果命令
  removeData: false # 允许所有玩家使用删除数据命令

效果配置

每个效果都可以通过以下选项进行配置:

  • enabled:启用/禁用该效果

  • name:商店中显示的效果名称

  • effect:要赋予的效果名称(默认),如果不确定其含义,请勿更改

  • lore:商店中显示的效果描述信息

  • maxLevel:效果的最大等级/增幅器级别

  • particles:是否在获得效果时显示粒子特效

  • saveEffectData:是否将效果数据保存到玩家数据中

  • priceType: 购买效果时使用的价格类型(使用玩家最大生命值购买选择 MAX_HEALTH,使用当前生命值购买选择 HEALTH)

  • refundPercentage: 购买效果后可退还的生命值百分比(基于 1 级效果计算,设置为 -1 可禁用退款功能)

  • autoActivate: 购买后是否自动激活该效果;若为 false,则需在激活配置中手动设置

数组部分([<等级 1>, <等级 2>, 等]):

  • durationPerUpgrade: 每次升级的持续时间(秒),-1 表示无限(以秒为单位)

  • cooldownPerUpgrade: 每次升级的冷却时间(秒)

  • costPerUpgrade: 每次升级激活所需的生命值消耗(生命值点数)

激活配置

每个物品都可以使用以下选项进行配置:

  • rightClick: 右键点击你配置的物品时,对你自己生效的效果
  • leftClick: 左键点击你配置的物品时,对你自己生效的效果
  • YouAreHittingEnemy: 当你用你配置的物品攻击敌人时,对敌人生效的效果
  • enemyHitYou: 当敌人用你配置的物品击中你时,对敌人生效的效果

效果自定义

效果在插件文件夹的 effects.yml 中定义。示例:

点击展开 配置文件(effects.yml)允许你自定义插件中的所有效果:
speed: # 效果部分的键,你可以将其更改为你想要的任何内容,你也可以在另一个键上使用相同的效果但具有不同的激活配置
  enabled: true # 启用/禁用该效果
  name: "§bSpeed" # 效果的名称
  effect: "SPEED" # 要赋予的效果名称(默认),如果你不知道它是什么,请不要更改
  lore: "Get more speed" # 效果的描述(仅供信息参考)
  maxLevel: 2 # 升级效果时的最大增强等级/级别
  particles: false # 获取效果时是否启用粒子效果
  saveEffectData: true # 将效果数据保存到玩家数据中(如果为“false”,则只有在“autoActivate”为真时才能激活效果,并且只能使用一次,玩家无法对其进行升级)

priceType: MAX_HEALTH # 购买效果时的价格类型(MAX_HEALTH 表示使用玩家的最大生命值购买,HEALTH 表示使用玩家的当前生命值购买) refundPercentage: 50 # 购买效果后可退还的生命值百分比(基于一级效果计算)(设为 -1 以禁用退款) autoActivate: true # 自动激活效果;若为 true,则在购买后自动激活该效果

如果为 false,则需要在激活配置中设置它

#=====[数组部分]=====

[<首次升级等级>, <第二次升级等级>, ...]

durationPerUpgrade: [-1, -1] # 每次升级的效果持续时间,-1 表示无限(单位为秒) cooldownPerUpgrade: [0, 0] # 每次使用效果时的冷却时间(单位为秒)

costPerUpgrade: [10, 18] # 每次升级购买效果时的消耗(生命值)

</details>

## 激活自定义

你可以通过编辑 `activation.yml` 文件来自定义插件中效果的激活方式。
<details>
<summary>点击展开</summary>
配置文件(activation.yml)允许你自定义插件中效果的激活方式:

```yaml
ALL_ITEMS: # 使用所有物品或无物品时激活到你自身的效果
  rightClick: [] # 使用所有物品或无物品右键点击时激活到你自身的效果
  leftClick: [] # 使用所有物品或无物品左键点击时激活到你自身的效果
  YouAreHittingEnemy: [] # 使用所有物品或无物品击中敌人时激活到你自身的效果
  enemyHitYou: [poison, wither, darkness] # 被敌人使用所有物品或无物品击中时激活到你自身的效果
SWORD: # 物品名称(所有类型的剑)
  rightClick: [resistance] # 使用该物品右键点击时激活到你自身的效果
  leftClick: [] # 使用该物品左键点击时激活到你自身的效果
  YouAreHittingEnemy: [nausea, weakness, weaving, oozing, infested] # 使用该物品击中敌人时激活到你自身的效果
  enemyHitYou: [slowness, mining_fatigue] # 被敌人使用该物品击中时激活到你自身的效果

记分板

记分板可以通过 /vv scoreboard 切换显示,并支持以下自定义选项:

  • 切换可见性
  • 更改效果的显示顺序

支持

如需支持,请在 GitHub 上提交问题。

许可证

本项目采用 MIT 许可证进行授权 - 详情请参阅 LICENSE 文件。

由 b4n9z 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源