🛡️ TogglePvp 是一款轻量级插件，专为希望允许玩家自行选择是否参与 PVP 的服务器设计。它非常适合生存和空岛服务器。

🛡️ TogglePvp

⚙️ 工作原理

• 玩家需要通过 /pvp 命令启用他们的 PVP 状态，才能互相进行 PVP。

🏹 弓箭和药水

• 如果弓箭射中 PVP 关闭的玩家，箭矢会被直接删除，造成的伤害（包括火焰）也会被取消。
• 对于溅射药水，插件会取消被认为是“攻击性”的药水效果，例如虚弱、中毒或伤害。
• 插件只会移除 PVP 关闭玩家身上的药水效果。

🐾 驯服的动物

• 插件支持保护驯服的动物。
• 可以选择保护驯服的生物免受其他玩家及其驯服的狼的伤害（当主人关闭 PVP 或离线时）。

💥 爆炸、熔岩和火焰

• 插件同样支持处理爆炸、熔岩和火焰造成的伤害。

⌨️ 命令

• /pvp, togglepvp, pvptoggle, pvpt, tpvp
  • on, start - 激活你的 PVP
  • off, stop - 关闭你的 PVP
  • toggle, (无参数) - 切换你的 PVP 状态
• /togglePvpReload - 重载配置文件
• /togglePvpGetWorld - 获取你所在的世界名称

🔑 权限

注意：权限可在配置文件中进行配置。

• tau.togglepvp.use - 允许使用 /pvp 命令
• tau.togglepvp.flightbypass - 允许在战斗中飞行
• tau.togglepvp.reload - 允许使用 reload 和 getworld 命令

🌍 WorldGuard Flags

• togglepvp-force-pvp - 强制在该区域启用 PVP

🧰 PlaceholderAPI 占位符

• %togglepvp_state% - 玩家的 PVP 状态
• %togglepvp_remainingtime% - 玩家在战斗后可以更改 PVP 状态的剩余时间

⚙️ 配置

# TogglePvp By TauCubed <[email protected]>

# The permission players need to toggle pvp
Toggle Permission: 'tau.togglepvp.use'

# The permission players need to /togglepvpreload
Reload Permission: 'tau.togglepvp.reload'

# The delay before a player can toggle their pvp after entering combat
Delay: 10.0

# Should this plugin allow pvp by default?
Default Pvp State: false

# Only works on 1.14+
# Stores the pvp state in the player's NBT
Enable Persistent Pvp State: true

# Worlds where PVP is forcefully enabled.
Force PVP Enabled Worlds:
- 'pvp_world'
- 'Example_World'
- 'Another_Example_World'

# Commands that will run from console when someone turns on pvp
# %player% will be replaced with the players name
Pvp Enabled Commands: []

# Commands that will be blocked from execution while a players' combat timer is active
# All commands should be lowercase
Blocked Combat Commands: []
#  - "/somecommand"
#  - "/someothercommand"
#  - "/etcetc"

# What potion effects should be considered an attack?
# A full list of supported potions can be found Here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html
# Note: Don't include potion effects such as Instant Damage as that deals damage directly and will be ignored here.
Banned Potion Effects:
- 'POISON'
- 'WITHER'
- 'BLINDNESS'
- 'CONFUSION'
- 'HUNGER'
- 'SLOW'
- 'SLOW_DIGGING'
- 'UNLUCK'
- 'WEAKNESS'

# Should this plugin protect tamed animals when their owner has PVP disabled or is offline?
Protect Tameable Animals: true

# Should this plugin protect players with PVP disabled from unknown explosions?
# An explosion is unknown when the plugin cannot determine who caused it.
Protect From Unknown Explosions: false

# Should this plugin prevent players from placing fire/lava near players with pvp disabled?
Protect From Player Hazards: true

# Should attackers get knocked back when they attempt to PVP someone with PVP disabled?
Enable Knockback: true
# Set the knockback force
Knockback Force: 0.5F

############
# Messages #
############

# The message to be sent to the player when they try to run a blocked command while in combat
Blocked Combat Command Message: " &c>> &7This command is disabled during combat"

# The message to send to a player that attacks a tamed animal when the owner of that animal is offline
Animal Owner Offline: " &c>> &7You may not attack this Animal as it's owner is offline."

# What message should be sent to players when they toggle their pvp in a forcefully enabled world?
# NOTE: This does not prevent people from toggling. It simply serves as a warning message.
MSG In PVP Enabled World ON Pvp CMD: " &c>> &8&oWarning: &r&7pvp is forcefully enabled in this world."

# What message should be sent to players to instruct them on how to use this plugin?
MSG Usage:
- " &c>> &7Usage: /&bpvp &3on&7, &3enable&7, &3start&7/&3stop&7, &3disable&7, &3off"
- " &c>> &7Toggle Usage: /&bpvp"

# What message should be sent to players that attempt to toggle their pvp while in combat?
# You may use the placeholders %remainingtime%
MSG CombatTagged:
- " &c>> &7You cannot toggle your pvp while in &ccombat"
- " &c>> &7You must wait &b%remainingtime%&7 seconds before toggling again"

# What messages should be sent to players who attempt to set their pvp state to an existing state?
MSG Pvp is Already DISABLED: " &4>> &7Your pvp is already &cDisabled"
MSG Pvp is Already ENABLED: " &4>> &7Your pvp is already &aEnabled"

# What messages should be sent to players when their pvp state changes?
MSG Pvp DISABLED: " &8>> &7Your pvp has been &cDisabled"
MSG Pvp ENABLED: " &8>> &7Your pvp has been &aEnabled"

# Should messages be sent to attackers when they use non-melee attacks? (Bows, Potions, Explosives etc)
Send PVP Disabled Messages On Non-Melee: true

# The Message that will be sent to the attacker when either the attacker or the victim have PVP disabled
MSG Attack Blocked BASE: " &c>> &7You may not pvp &b%player% &7because"

# The message to send after the BASE message when both the attacker and the victim have PVP disabled.
MSG Attack Blocked Both Players Disabled: " &c>> &7both &byou &7and &b%player%&7 have pvp &cDisabled"
# The message to send after the BASE message when the attacker has PVP disabled.
MSG Attack Blocked You Disabled: " &c>> &7you have pvp &cDisabled"
# The message to send after the BASE message when the victim has PVP disabled.
MSG Attack Blocked Other Player Disabled: " &c>> &b%player%&7 has pvp &cDisabled"

# When set above 0 it will be used to limit how often attack blocked messages can be sent
Attack MSG Cooldown: 1.0

# State effects are effects that are applied to a player depending on their pvp state
State Effects:
  enabled: false
  # what colors should players glow depending on their pvp state
  # For a list of colors see: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/ChatColor.html
  # set to "" to disable glowing
  pvp glow color: "RED"
  pve glow color: ""
  # how should a players name be displayed in tab depending on their pvp state
  # use "" to disable
  pvp tab name: "&c%name%"
  pve tab name: ""

#Misc Advanced Messages

# miscellaneous messages
Misc:
  No Permission: " &4>> &7no permission"
  ConsoleIsNotPlayer: " &4>> &&Console is not a player."
  Reload: " &8>> &aTogglePvp &7reloading"
  Reloading: " &8>> &aTogglePvp &7reloaded"
  ConsoleCannotPvp: " &4>> &7Console can't toggle pvp."

# section for manipulating PAPI placeholders
placeholders:
  # the following two values are for the %togglepvp_state% placeholder
  pvp enabled: "Enabled"
  pvp disabled: "Disabled"

########################
# END of Configuration #
########################

# No Touchy
Config Version: 10

✨ 主要特性

• 允许玩家开启或关闭 PVP 状态。
• 防止在战斗中切换 PVP 状态。
• 支持多世界。
• 支持 WorldGuard。
• 禁止玩家在战斗中飞行。
• 禁止玩家在战斗中使用特定指令。
• 基于 PVP 状态的发光效果。
• 几乎所有内容都可自定义。
• 简单易用。
• 支持 PlaceholderAPI。

🔗 其他资源

如果您遇到问题，请不要在评论区提出。请给我发消息或在讨论区中提出。请记住：这个插件是免费的。我有一份工作，请记住这一点。