SMP PVP MODE

# SMP PVP MODE PVP Mod 是一个为 Minecraft SMP 服务器设计的竞技场地 PVP 模组。该模组通过自动化场地管理、装备发放和战斗规则，为服务器管理员提供了完整的竞技场解决方案。 ### 场地管理 模组支持两种场地模式： **生成模式 (Generate)** 自动生成临时竞技场地，战斗结束后自动清理，不污染主世界。场地结构固定为三层：基岩层(Y=317)、草方块层(Y=318)、光源层(Y=319)，可配置场地尺寸和生成坐标范围。玩家传送位置在光源层上方(Y=319)。 **传送模式 (TP)** 使用预先建造的竞技场，通过配置传送点实现玩家快速传送。支持多场地并发，自动检测场地占用状态，避免冲突。 ### 装备系统 战斗前自动保存玩家原有装备、生命值和饥饿值，战斗期间发放临时装备，战斗结束后恢复原状态。 支持配置的装备类型： - **hotbar** - 快捷栏（9个格子） - **inventory** - 背包（27个格子） - **armor** - 盔甲（头盔、胸甲、护腿、靴子） - **offhand** - 副手（手持盾牌等） 所有装备都支持附魔配置。 ### 生命饥饿值恢复 传送至竞技场后可自动回满生命值和饥饿值，战斗结束后恢复传送前的状态。此功能可在配置中开启或关闭。 ### 安全机制 - 战斗期间禁止丢弃装备，防止刷物资 - 世界边界限制，防止玩家逃跑 - 玩家数据持久化到磁盘，支持服务器重启后恢复 ### 玩家体验 - 纯服务端运行，玩家无需安装客户端模组 - 聊天按钮交互，操作便捷 - 同意决斗后进入旁观模式，倒计时期间禁止移动 - 倒计时结束自动切换到战斗模式，可正常移动和攻击 - 夜视效果，确保场地可见 ## 内置玩法 ### 经典剑斗 (classic) - **显示名称**: 经典剑斗 - **描述**: 高版本剑斗PVP - **场地模式**: 生成模式 - **装备**: 钻石剑、铁剑（锋利1）、钻石盔甲全套 - **游戏模式**: 冒险模式 - **夜视效果**: 开启 - **倒计时**: 5秒 - **回满生命**: 开启 ## 配置说明 ### 配置文件位置 ``` 服务器根目录/config/pvpmod-config.json ``` ### 配置结构 每个玩法独立配置，包含以下核心部分： ```json { "玩法ID": { "display-name": "显示名称", "description": "玩法描述", "arena-mode": "场地模式", "game-mode": "游戏模式", "equipment": { ... }, "countdown-seconds": 5, "give-night-vision": true, "refill-health-hunger": true } } ``` ### 中文配置字段支持 从 v1.0.2 开始，配置文件支持中文字段名，中英文可以混用。以下是支持的中文别名： | 中文字段 | 英文字段 | 说明 | |---------|---------|------| | 显示名称 | display-name | 玩法显示名称 | | 描述 | description | 玩法描述 | | 场地模式 | arena-mode | 场地模式（tp/generate） | | 游戏模式 | game-mode | 游戏模式 | | 夜视效果 | give-night-vision | 是否开启夜视效果 | | 倒计时 | countdown-seconds | 倒计时秒数 | | 回满生命 | refill-health-hunger | 是否回满生命和饥饿 | | 装备 | equipment | 装备配置 | | 快捷栏 | hotbar | 快捷栏（9个格子） | | 背包 | inventory | 背包（27个格子） | | 盔甲 | armor | 盔甲配置 | | 副手 | offhand | 副手物品 | | 头盔 | helmet | 头盔 | | 胸甲 | chestplate | 胸甲 | | 护腿 | leggings | 护腿 | | 靴子 | boots | 靴子 | | 生成配置 | generate-config | 生成模式配置 | | 传送配置 | tp-config | 传送模式配置 | | 传送点 | spawn-points | 传送点列表 | | 尺寸 | size | 场地尺寸 | | 最小坐标 | min-coordinate | 最小生成坐标 | | 最大坐标 | max-coordinate | 最大生成坐标 | | 物品 | item | 物品ID | | 数量 | count | 物品数量 | | 附魔 | enchantments | 附魔配置 | | 世界边界 | world-border | 世界边界配置 | | 中心X | center-x | 世界边界中心X | | 中心Z | center-z | 世界边界中心Z | **注意**：物品ID（如 `diamond_sword`、`iron_sword`）、附魔ID（如 `sharpness`、`protection`）和游戏模式值（如 `adventure`、`survival`）必须使用英文。 **中文配置示例**： ```json { "chinese-example": { "显示名称": "中文配置演示", "描述": "使用中文配置字段的示例玩法", "场地模式": "generate", "生成配置": { "尺寸": 32, "最小坐标": 1000, "最大坐标": 5000 }, "装备": { "快捷栏": { "0": { "物品": "iron_sword", "数量": 1, "附魔": { "sharpness": 3 } } }, "盔甲": { "头盔": { "物品": "iron_helmet" }, "胸甲": { "物品": "iron_chestplate" } }, "副手": { "物品": "shield", "数量": 1 } }, "游戏模式": "adventure", "夜视效果": true, "倒计时": 3, "回满生命": true } } ``` ### 场地模式配置 **生成模式** ```json "arena-mode": "generate", "generate-config": { "size": 64, "min-coordinate": 1000, "max-coordinate": 5000 } ``` 参数说明： - `size`: 场地尺寸，例如64表示64x64的场地 - `min-coordinate`: 场地生成的最小坐标 - `max-coordinate`: 场地生成的最大坐标 **传送模式** ```json "arena-mode": "tp", "tp-config": { "spawn-points": } ``` 参数说明： - `spawn-points`: 传送点列表，每个传送点包含两个玩家的位置 - `player1`: 挑战者的传送位置 - `player2`: 目标玩家的传送位置 可选配置世界边界： ```json "world-border": { "center-x": 125, "center-z": 100, "size": 64 } ``` ### 装备配置 装备配置包含四个部分：`hotbar`（快捷栏）、`inventory`（背包）、`armor`（盔甲）、`offhand`（副手）。 每个物品可以是简单字符串格式或详细对象格式。 **简单格式（仅物品名）**: ```json "helmet": "diamond_helmet" ``` **详细格式（带数量和附魔）**: ```json "0": { "item": "diamond_sword", "count": 1, "enchantments": { "sharpness": 5, "knockback": 2 } } ``` 完整装备配置示例： ```json "equipment": { "hotbar": { "0": { "item": "diamond_sword", "count": 1, "enchantments": { "sharpness": 5 } }, "1": { "item": "bow", "count": 1, "enchantments": { "power": 5, "flame": 1, "infinity": 1 } }, "8": { "item": "arrow", "count": 64 } }, "inventory": { "0": { "item": "golden_apple", "count": 64 }, "1": { "item": "golden_apple", "count": 64 } }, "armor": { "helmet": { "item": "diamond_helmet", "enchantments": { "protection": 4, "unbreaking": 3 } }, "chestplate": "diamond_chestplate", "leggings": "diamond_leggings", "boots": "diamond_boots" }, "offhand": { "item": "shield", "count": 1, "enchantments": { "unbreaking": 3 } } } ``` ### 生命饥饿值恢复配置 ```json "refill-health-hunger": true ``` 参数说明： - `true`: 传送至竞技场后自动回满生命值和饥饿值，战斗结束后恢复原状态 - `false`: 保持玩家原有生命值和饥饿值不变 ### 游戏模式配置 ```json "game-mode": "adventure" ``` 可用值： - `survival`: 生存模式 - `creative`: 创造模式 - `adventure`: 冒险模式（推荐，不能破坏方块） - `spectator`: 旁观模式