MSPChoosePVP 是一款 Minecraft 插件,允许玩家选择自己偏好的游戏风格:PVE 或 PVP。它专为希望将和平型玩家与战斗型玩家区分开来,同时保持选择过程简单、直观且可配置的服务器而设计。
当玩家加入服务器时,插件可以自动打开一个 GUI,让玩家在 PVE 和 PVP 之间进行选择。PVE 模式保护玩家免受不必要的战斗干扰,而 PVP 模式则允许玩家与其他玩家进行战斗互动。该插件支持在保存选择前进行确认,如果玩家未做选择就关闭菜单,会自动重新打开菜单,并且为尚未选择模式的玩家提供保护。
该插件包含一个管理员设置 GUI,服务器工作人员无需手动编辑文件即可管理插件行为。管理员可以在这里启用或禁用 PVE/PVP 选择、切换选择前的保护状态、管理粒子效果、声音、特效、确认行为、菜单重开功能、标题/聊天通知、玩家通知,并直接从菜单中更改插件语言,无需重启服务器。
MSPChoosePVP 使用数据库存储来持久化玩家的选择,支持 SQLite 和 MySQL。玩家的选择会被保存,管理员可以查看、修改或重置这些选择。该插件还包含统计信息,显示有多少玩家选择了 PVE 或 PVP。
该插件支持 PlaceholderAPI,并提供了一系列占位符,可用于记分板、标签列表、聊天插件、全息图、菜单以及其他兼容的插件。它已翻译成多种语言,并允许玩家在游戏内设置菜单中切换当前使用的语言。
命令
/pvp
显示 PVE/PVP 命令帮助及可用的子命令。
/pvp status <nick>
检查某玩家已保存的模式。
/pvp change <nick> <PVE|PVP>
将玩家的选定模式更改为 PVE 或 PVP。
/pvp reset <nick>
重置玩家的已保存选择。如果玩家在线,可以再次为其打开选择菜单。
/pvp stats
显示选择统计信息,包括选择 PVE 的玩家数量、选择 PVP 的玩家数量以及拥有已保存选择的玩家总数。
/pvp settings
打开管理员设置菜单。
功能
- 基于 GUI 的 PVE/PVP 选择
- 保存选择前可选的确认步骤
- 加入服务器时可选自动打开菜单
- 如果玩家未做选择就关闭菜单,可选自动重新打开菜单
- 如果选择无法保存到数据库,可选重试重新打开菜单
- 玩家在未选择模式前受到保护
- 用于插件配置的管理员 GUI
- 用于管理在线玩家的管理员 GUI
- 可从 GUI 更改玩家的模式
- 可从 GUI 重置玩家的选择
- 可从 GUI 更改玩家的粒子动画样式
- 选择统计信息
- 可配置的粒子效果
- 可配置的粒子动画
- 可配置的声音
- 可配置的 PVE/PVP 特效
- 独立的 PVP 特效声音选项
- 独立的 PVP 选择声音选项
- 支持 SQLite 和 MySQL
- 支持 PlaceholderAPI
- 运行时切换语言,无需重启服务器
- 已翻译成多种语言
- 可配置标题、聊天消息、GUI 名称、物品描述(lore)、材质、格子位置及菜单布局
- 可配置 PlaceholderAPI 符号和颜色
- 模式变更和重置时的管理员通知
- 管理员操作后,可选关闭目标玩家当前的 GUI
- 可选绕过所需模式选择权限
PlaceholderAPI
PlaceholderAPI 支持是可选的。如果服务器上安装了 PlaceholderAPI,MSPChoosePVP 会自动注册其占位符。
%pvptype%
显示使用该占位符的玩家所对应的 PVP 类型符号。
结果取决于玩家已保存的选择:
- PVE — 使用配置的 PVE 符号和颜色
- PVP — 使用配置的 PVP 符号和颜色
- 无选择 — 使用配置的“无选择”值
%pvptype_<player>%
显示其他玩家的 PVP 类型符号。
示例:
%pvptype_Steve%
目标玩家可以是在线或离线状态。如果玩家未知或没有已保存的选择,则显示“无选择”的值。
PlaceholderAPI 配置
PlaceholderAPI 的输出可以在 config.yml 中进行配置:
placeholder:
no-choice: "#808080❓"
pve:
symbol: "?"
color: "#FFD447"
pvp:
symbol: "?"
color: "#FF3333"
内部消息与 GUI 占位符
这些占位符用于插件消息、GUI 标题、物品名称、物品描述(lore)以及语言文件中。
通用占位符
{player} — 玩家名称
{type} — 玩家选定的模式
{choice} — 确认菜单中当前选定的选项
{state} — 当前设置的状态
{state_color} — 当前设置状态所使用的颜色
{value} — 已更改设置的新的值
{setting} — 被更改的设置名称
统计占位符
{pve} — 选择 PVE 的玩家数量
{pvp} — 选择 PVP 的玩家数量
{total} — 拥有已保存选择的玩家总数
GUI 分页占位符
{page} — 当前页码
{pages} — 总页数
粒子占位符
语言占位符
{language} — 当前语言的显示名称
{language_code} — 当前语言代码
存储
MSPChoosePVP 可以使用以下数据库存储玩家的选择:
这确保了玩家的选择在服务器重启后得以保留。
管理员设置菜单
管理员设置菜单允许服务器工作人员在游戏内直接管理插件。通过此 GUI,管理员可以直接控制插件的主要行为,而无需为每次更改手动编辑配置文件。
可用设置包括:
- 启用或禁用 PVE 选择
- 启用或禁用 PVP 选择
- 启用或禁用选择前的保护机制
- 启用或禁用所需选择的权限绕过
- 启用或禁用管理员更改模式时向玩家发送通知
- 启用或禁用管理员重置选择时向玩家发送通知
- 启用或禁用在管理员操作后关闭目标玩家的当前 GUI
- 启用或禁用选择粒子效果
- 更改粒子动画样式
- 无需重启即可更改插件语言
- 启用或禁用 GUI 音效
- 启用或禁用 PVE 特效
- 启用或禁用 PVP 特效
- 启用或禁用 PVP 特效音效
- 启用或禁用独立的 PVP 选择音效
- 打开选择菜单设置
- 打开在线玩家管理界面
- 刷新选择统计数据
选择菜单设置
选择菜单的行为也可以通过设置 GUI 进行管理。
可用选项包括:
- 玩家加入时自动打开选择菜单
- 选择 PVE 或 PVP 后需要确认
- 如果玩家未进行选择就关闭菜单,则重新打开
- 成功选择后显示标题
- 成功选择后发送聊天消息
- 如果选择无法保存到数据库,则重新打开菜单
玩家管理
管理员可以直接从 GUI 管理在线玩家。
可用的玩家操作包括:
- 查看玩家的当前模式
- 将玩家的模式设置为 PVE
- 将玩家的模式设置为 PVP
- 重置玩家的选择
- 更改玩家的粒子动画样式
- 如果玩家在线,则在重置后重新打开选择菜单
配置
大多数插件行为都可以进行配置,包括:
- 默认语言
- 数据库类型
- GUI 大小
- GUI 槽位
- GUI 材质
- 自定义模型数据
- PVE/PVP 可用性
- 加入菜单行为
- 确认行为
- 选择前的保护
- 所需选择的绕过行为
- 管理员通知
- 管理员操作后关闭目标 GUI
- 音效
- 粒子效果
- 粒子动画
- 特效
- 标题
- 聊天消息
- 语言文件
- PlaceholderAPI 符号和颜色
权限
该插件使用权限来控制对命令、管理操作以及可选的绕过行为的访问。
mspchoosepvp.command
允许访问基础 /pvp 命令。
mspchoosepvp.admin
允许访问管理命令和设置菜单。
mspchoosepvp.bypass
如果在插件设置中启用了绕过权限支持,则允许玩家绕过所需的模式选择。
用例
MSPChoosePVP 适用于以下场景:
- 生存服务器
- SMP 服务器
- 角色扮演服务器
- 阵营服务器
- 混合 PVE/PVP 服务器
- 希望让玩家决定是进行和平玩法还是开放战斗的服务器
- 希望保护新手或和平玩家免受不必要冲突的服务器
- 希望管理员通过 GUI 菜单管理 PVE/PVP 选择的服务器
MSPChoosePVP 提供了一种简洁且可配置的方式,让玩家选择自己的游玩方式,同时赋予服务器工作人员对行为、存储、视觉效果、特效、音效、本地化、PlaceholderAPI 输出和玩家管理的完全控制权。
MSPChoosePVP is a Minecraft plugin that lets players choose their preferred play style: PVE or PVP. It is designed for servers that want to separate peaceful players from combat-focused players while keeping the selection process simple, visual, and configurable.
When a player joins the server, the plugin can automatically open a GUI where they choose between PVE and PVP. PVE mode protects players from unwanted combat, while PVP mode allows combat interactions with other players. The plugin supports confirmation before saving the choice, automatic reopening of the menu if the player closes it without choosing, and protection for players who have not selected a mode yet.
The plugin includes an admin settings GUI where server staff can manage plugin behavior without editing files manually. Administrators can enable or disable PVE/PVP selection, toggle protection before choice, manage particles, sounds, effects, confirmation behavior, menu reopening, title/chat notifications, player notifications, and change the plugin language directly from the menu without restarting the server.
MSPChoosePVP supports persistent player choices using database storage, including SQLite and MySQL. Player selections are saved and can be checked, changed, or reset by administrators. The plugin also includes statistics for how many players selected PVE or PVP.
The plugin supports PlaceholderAPI and provides placeholders that can be used in scoreboards, tab lists, chat plugins, holograms, menus, and other compatible plugins. It is translated into many languages and allows switching the active language from the in-game settings menu.
Commands
/pvp
Shows the PVE/PVP command help and available subcommands.
/pvp status <nick>
Checks the saved mode of a player.
/pvp change <nick> <PVE|PVP>
Changes a player's selected mode to PVE or PVP.
/pvp reset <nick>
Resets a player's saved choice. If the player is online, the choice menu can be opened for them again.
/pvp stats
Shows selection statistics, including the number of PVE players, PVP players, and total players with a saved choice.
/pvp settings
Opens the admin settings menu.
Features
- GUI-based PVE/PVP selection
- Optional confirmation before saving a choice
- Optional automatic menu opening on join
- Optional menu reopening if the player closes it without choosing
- Optional retry menu reopening if the choice could not be saved to the database
- Protection before a player selects a mode
- Admin GUI for plugin configuration
- Player management GUI for online players
- Ability to change a player's mode from the GUI
- Ability to reset a player's choice from the GUI
- Ability to change a player's particle animation style
- Selection statistics
- Configurable particles
- Configurable particle animations
- Configurable sounds
- Configurable PVE/PVP effects
- Separate PVP effect sound option
- Separate PVP choice sound option
- SQLite and MySQL support
- PlaceholderAPI support
- Runtime language switching without server restart
- Translated into many languages
- Configurable titles, chat messages, GUI names, lore, materials, slots, and menu layout
- Configurable PlaceholderAPI symbols and colors
- Admin notifications for mode changes and resets
- Optional closing of the target player's current GUI after admin actions
- Optional bypass permission for required mode choice
PlaceholderAPI
PlaceholderAPI support is optional. If PlaceholderAPI is installed on the server, MSPChoosePVP automatically registers its placeholders.
%pvptype%
Shows the PVP type symbol of the player using the placeholder.
Result depends on the player's saved choice:
- PVE — uses the configured PVE symbol and color
- PVP — uses the configured PVP symbol and color
- No choice — uses the configured no-choice value
%pvptype_<player>%
Shows the PVP type symbol of another player.
Example:
%pvptype_Steve%
The target player can be online or offline. If the player is unknown or has no saved choice, the no-choice value is shown.
PlaceholderAPI configuration
The PlaceholderAPI output can be configured in config.yml:
placeholder:
no-choice: "#808080❓"
pve:
symbol: "?"
color: "#FFD447"
pvp:
symbol: "?"
color: "#FF3333"
Internal message and GUI placeholders
These placeholders are used inside plugin messages, GUI titles, item names, item lore, and language files.
General placeholders
{player} — Player name
{type} — Player's selected mode
{choice} — Current selected choice in the confirmation menu
{state} — Current setting state
{state_color} — Color used for the current setting state
{value} — New value of a changed setting
{setting} — Name of the changed setting
Statistics placeholders
{pve} — Number of players who selected PVE
{pvp} — Number of players who selected PVP
{total} — Total number of players with a saved choice
GUI pagination placeholders
{page} — Current page number
{pages} — Total number of pages
Particle placeholders
{animation} — Current particle animation name
Language placeholders
{language} — Display name of the current language
{language_code} — Current language code
Storage
MSPChoosePVP can store player choices using:
This allows player selections to persist after server restarts.
Admin settings menu
The admin settings menu allows server staff to manage the plugin directly in-game. From this GUI, administrators can control the main behavior of the plugin without manually editing configuration files for every change.
Available settings include:
- Enable or disable PVE selection
- Enable or disable PVP selection
- Enable or disable protection before choice
- Enable or disable required choice bypass permission
- Enable or disable player notifications when an admin changes their mode
- Enable or disable player notifications when an admin resets their choice
- Enable or disable closing the target player's current GUI after admin actions
- Enable or disable choice particles
- Change particle animation style
- Change plugin language without restart
- Enable or disable GUI sounds
- Enable or disable PVE effects
- Enable or disable PVP effects
- Enable or disable PVP effect sound
- Enable or disable separate PVP choice sound
- Open choice menu settings
- Open online player management
- Refresh selection statistics
Choice menu settings
The choice menu behavior can also be managed from the settings GUI.
Available options include:
- Automatically open the choice menu when a player joins
- Require confirmation after choosing PVE or PVP
- Reopen the menu if the player closes it without choosing
- Show a title after a successful choice
- Send a chat message after a successful choice
- Reopen the menu if the choice could not be saved to the database
Player management
Administrators can manage online players directly from the GUI.
Available player actions include:
- View the player's current mode
- Set the player's mode to PVE
- Set the player's mode to PVP
- Reset the player's choice
- Change the player's particle animation style
- Open the choice menu again after reset if the player is online
Configuration
Most plugin behavior can be configured, including:
- Default language
- Database type
- GUI size
- GUI slots
- GUI materials
- Custom model data
- PVE/PVP availability
- Join menu behavior
- Confirmation behavior
- Protection before choice
- Required choice bypass behavior
- Admin notifications
- Closing target GUI after admin actions
- Sounds
- Particles
- Particle animations
- Effects
- Titles
- Chat messages
- Language files
- PlaceholderAPI symbols and colors
Permissions
The plugin uses permissions to control access to commands, administrative actions, and optional bypass behavior.
mspchoosepvp.command
Allows access to the base /pvp command.
mspchoosepvp.admin
Allows access to administrative commands and the settings menu.
mspchoosepvp.bypass
Allows a player to bypass the required mode choice if bypass permission support is enabled in the plugin settings.
Use cases
MSPChoosePVP is useful for:
- Survival servers
- SMP servers
- Roleplay servers
- Faction servers
- Mixed PVE/PVP servers
- Servers where players should decide whether they want peaceful gameplay or open combat
- Servers that want to protect new or peaceful players from unwanted fights
- Servers that want administrators to manage PVE/PVP choices through GUI menus
MSPChoosePVP provides a clean and configurable way to let players choose how they want to play while giving server staff full control over behavior, storage, visuals, effects, sounds, localization, PlaceholderAPI output, and player management.
评论 0
登录后参与评分
还没有评论,来抢沙发吧