剧情管理器

剧情管理器

便于创建和管理地块的模组

实用

Hytale 地皮管理插件

一个为 Hytale 服务器设计的综合性地皮管理系统，允许玩家在指定的地皮世界中认领可自定义的地皮，并提供完整的配置支持。

功能特性

  • 完全可配置的网格系统 - 自定义地皮大小、道路宽度、单元格大小和世界偏移
  • 多地皮世界支持 - 为不同地皮系统配置不同的世界
  • 自定义出生点 - 为每个地皮设置独立的出生点，并支持偏移量调整
  • 高级成员管理 - 添加/移除好友，并附带详细的权限控制
  • 精细的旗帜系统 - 利用区域管理器的完整旗帜系统来控制地皮权限
  • 可扩展的地皮上限 - 可配置每位玩家的地皮上限，并支持基于权限的覆盖
  • 自动区域创建 - 与区域管理器集成，实现无缝的保护设置
  • 详细地皮信息 - 显示所有权、边界和配置信息
  • 自定义数据存储 - 存储地皮特有数据，如出生点和自定义设置

依赖项

必需： 区域管理器插件 - 本插件需要区域管理器插件作为依赖，以实现区域管理功能。

配置

该插件现在提供包含以下选项的全面配置文件：

通用设置

  • WorldName - 地皮世界的名称（默认："Plots"）
  • PlotSize - 每个地皮的大小（以方块为单位）（默认：51）
  • RoadWidth - 地皮之间道路的宽度（默认：5）
  • CellSize - 单元格总大小（地皮 + 道路）（默认：56）
  • OffSet - 地皮网格对齐的世界偏移量（默认：3）
  • PlotHeight - 地皮的高度限制（默认：256）
  • DefaultSpawnHeight - 出生点的默认 Y 坐标（默认：126）

权限设置

  • DefaultMaxPlots - 每位玩家的默认最大地皮数（默认：1）
  • MaxPlotsForVip - VIP 玩家的最大地皮数（默认：5）

区域设置

  • RegionPriority - 地皮区域的默认优先级（默认：10）
  • AllowPvP - 默认是否允许 PvP（默认：false）
  • AllowBuildByDefault - 默认建造权限（默认：true）
  • AllowBreakByDefault - 默认破坏权限（默认：true）
  • AllowInteractByDefault - 默认交互权限（默认：true）

消息设置

  • PluginPrefix - 消息中的插件前缀（默认："PlotManager"）
  • PrefixColor - 插件前缀的颜色（默认："YELLOW"）

出生点设置

  • SpawnOffsetX - 出生点的 X 偏移量（默认：0.5）
  • SpawnOffsetZ - 出生点的 Z 偏移量（默认：0.5）
  • UseCenterSpawn - 是否使用地皮中心作为默认出生点（默认：true）

命令

主命令

  • /plot 或 /plots - 主地皮命令（需要 razorplay.plotmanagerplugin.plot.use 权限）

子命令

认领地皮

  • /plot claim - 认领你当前位置的地皮（需要 razorplay.plotmanagerplugin.plot.claim 权限）
    • 自动创建一个受保护的区域
    • 检查是否为道路位置
    • 验证地皮是否可用
    • 强制执行可配置的地皮数量上限

地皮信息

  • /plot info - 查看你所在地皮的信息（需要 razorplay.plotmanagerplugin.plot.info 权限）
    • 显示所有者和成员
    • 展示地皮边界
    • 显示区域旗帜
    • 展示自定义地皮数据

地皮列表

  • /plot list - 列出你所有认领的地皮（需要 razorplay.plotmanagerplugin.plot.list 权限）
    • 显示玩家拥有的所有地皮
    • 展示地皮名称和网格坐标
    • 指示地皮位置信息

地皮管理

  • /plot delete - 删除你所在地皮（需要 razorplay.plotmanagerplugin.plot.delete 权限）
    • 移除区域保护
    • 仅地皮所有者或管理员可操作
    • 清除所有地皮数据

成员管理

  • /plot member <add/remove> <player> - 管理地皮成员（需要 razorplay.plotmanagerplugin.plot.member 权限）
    • 添加好友到你的地皮：/plot member add PlayerName
    • 移除成员：/plot member remove PlayerName
    • 成员将获得地皮中的已配置权限
    • 支持 UUID 或玩家名称

地皮设置

  • /plot setting <flag> <value> - 更改地皮设置（需要 razorplay.plotmanagerplugin.plot.settings 权限）
    • 使用完整的旗帜系统修改区域旗帜（例如：player.entry，action.build，interact.chest）
    • 支持所有区域管理器旗帜
    • 示例：/plot setting player.entry true
    • 示例：/plot setting action.build false

传送

  • /plot home [plot] - 传送到你的地皮出生点（需要 razorplay.plotmanagerplugin.plot.home 权限）
    • 传送到第一个地皮：/plot home
    • 传送到指定地皮：/plot home PlotName 或 /plot home plot_X_Z
    • 如果设置了自定义出生点则使用，否则使用带有配置偏移量的地皮中心
  • /plot spawn <set/reset> - 设置或重置地皮出生点（需要 razorplay.plotmanagerplugin.plot.spawn 权限）
    • 设置出生点至当前位置：/plot spawn set
    • 重置为带有偏移量的地皮中心：/plot spawn reset

权限

玩家权限

  • razorplay.plotmanagerplugin.plot.use - 访问地皮命令
  • razorplay.plotmanagerplugin.plot.claim - 认领新地皮
  • razorplay.plotmanagerplugin.plot.info - 查看地皮信息
  • razorplay.plotmanagerplugin.plot.list - 列出自有地皮
  • razorplay.plotmanagerplugin.plot.delete - 删除自有地皮
  • razorplay.plotmanagerplugin.plot.member - 管理地皮成员
  • razorplay.plotmanagerplugin.plot.settings - 更改地皮设置
  • razorplay.plotmanagerplugin.plot.spawn - 设置地皮出生点
  • razorplay.plotmanagerplugin.plot.home - 传送到地皮家园

地皮上限权限

  • razorplay.plotmanagerplugin.plot.plots.1 - 允许拥有 1 块地皮（默认）
  • razorplay.plotmanagerplugin.plot.plots.2 - 允许拥有 2 块地皮
  • razorplay.plotmanagerplugin.plot.plots.3 - 允许拥有 3 块地皮
  • razorplay.plotmanagerplugin.plot.plots.4 - 允许拥有 4 块地皮
  • razorplay.plotmanagerplugin.plot.plots.5 - 允许拥有 5 块地皮
  • razorplay.plotmanagerplugin.plot.plots.6 - 允许拥有 6 块地皮
  • razorplay.plotmanagerplugin.plot.plots.7 - 允许拥有 7 块地皮
  • razorplay.plotmanagerplugin.plot.plots.8 - 允许拥有 8 块地皮
  • razorplay.plotmanagerplugin.plot.plots.9 - 允许拥有 9 块地皮
  • razorplay.plotmanagerplugin.plot.plots.10 - 允许拥有 10 块地皮
  • razorplay.plotmanagerplugin.plot.plots.unlimited - 无限制地皮

与区域管理器权限的集成

  • 继承所有区域管理器旗帜权限（每个旗帜的修改/绕过权限）
  • 支持用于管理访问的 region.admin
  • 使用 owners-modify-flags 和 members-use-global-flags 地皮设置
  • 与用于成员管理的 members-can-invite 旗帜集成

地皮世界的世界配置

本插件包含使用 Hytale Gen2 世界生成器生成地皮世界所需的全部数据。在配置文件中配置你的地皮世界名称（默认："Plots"）。

示例世界配置：

"WorldGen": {
    "Type": "HytaleGenerator",
    "WorldStructure": "PlotGrid",
    "PlayerSpawn": {
        "X": 0.5,
        "Y": 126.0,
        "Z": 0.5
    }
}

地皮保护功能

  • 所有者：对其地皮拥有完全控制权（可通过 owners-modify-flags 配置）
  • 成员：拥有建造/破坏/交互权限（每个旗帜可配置）
  • 非成员：无修改权限
  • 道路保护：自动保护道路区域
  • PvP 控制：可通过 player.pvp 旗帜配置
  • 进入控制：可通过 player.entry 旗帜配置

高级地皮功能

  • 网格坐标系统：自动计算地皮边界
  • 相邻地皮检测：检测相邻地皮的工具
  • 道路检测：内置的道路检测和保护
  • 自定义数据存储：可扩展的数据存储，用于地皮增强
  • 缓存系统：性能优化的地皮坐标缓存
  • 自动加载：服务器启动时自动加载地皮

技术细节

区域命名规则

地皮会自动以 plot_X_Z 格式命名，其中 X 和 Z 是网格坐标。

数据存储

  • 地皮边界存储在区域数据中
  • 自定义出生点存储在 PlotCustomData 中
  • 成员列表由区域管理器管理
  • 配置存储在配置文件中
  • 所有数据在服务器重启后持久化

API 集成

本插件与区域管理器 API 集成，用于：

  • 通过 RegionBuilder 创建和删除区域
  • 通过区域 API 进行成员管理
  • 使用全面的旗帜系统进行旗帜配置
  • 存储地皮特定信息的自定义数据
  • 重叠保护的优先级系统

性能特性

  • 坐标缓存：缓存地皮坐标以实现快速查找
  • 基于区块的索引：优化空间查询
  • 线程安全操作：适用于多人游戏环境
  • 高效加载：批量加载已有地皮
  • 低开销：与区域管理器的轻量级集成

安装与设置

  1. 首先安装区域管理器插件
  2. 将地皮管理器 JAR 文件放入 mods 文件夹
  3. 在配置中设置地皮世界名称和设置
  4. 重启服务器
  5. 生成或准备你的地皮世界
  6. 使用 /plot claim 开始认领地皮

版本信息

  • 需要 Hytale 服务器 API
  • 兼容区域管理器 2.0+
  • 完全支持区域管理器的旗帜权限系统

支持

遇到问题或疑问：

  1. 确保已安装并运行区域管理器
  2. 确认你位于已配置的地皮世界中
  3. 使用正确的旗帜语法检查权限
  4. 检查配置文件中的配置值
  5. 查看服务器日志以获取详细的错误信息