原创 工具 世界管理 游戏模式 YiyunDominionFlags - 为Dominion提供更多flag权限 | 支持folia | 轻量化运行 v1.0.0

[MD] # YiyunDominionFlags [](https://bstats.org/plugin/bukkit/YiyunDominionFlags/29373) [](https://www.minecraft.net/) [](https://papermc.io/) [](https://github.com/PaperMC/Folia) **YiyunDominionFlags** 是一个 [Dominion](https://github.com/LunaDeerMC/Dominion) 领地插件的扩展，为领地系统添加了更多实用的环境 Flag 功能。 --- ## 📖 插件介绍 ### 什么是 YiyunDominionFlags？ YiyunDominionFlags 是专为 Dominion 领地插件设计的扩展插件，它扩展了更多Flag。 有什么想要的 Flag 功能？欢迎联系QQ：2919089965 ### 为什么选择 YiyunDominionFlags？ - **轻量级设计** - 静默运行，不输出冗余日志，对服务器性能影响极小 - **智能优化** - 当所有 Flag 被禁用时自动跳过处理，节省服务器资源 - **完美兼容** - 与 Dominion 本体无缝集成，使用相同的权限系统 - **灵活配置** - 每个 Flag 都可以单独启用/禁用，并设置默认值 --- ## 📋 功能特性 ### 环境 Flag 详解 | Flag | 名称 | 功能描述 | 默认状态 | |------|------|----------|----------| | `saturation_restore` | 饱食度恢复 | 在领地内自动恢复玩家的饱食度和饥饿值 | 关闭 | | `fast_move` | 移动加速 | 在领地内增加玩家的移动速度 | 关闭 | | `health_regen` | 生命恢复 | 在领地内自动恢复玩家的生命值 | 关闭 | | `no_fall_damage` | 无摔落伤害 | 在领地内不会受到摔落伤害 | 关闭 | | `allow_fly` | 允许飞行 | 精细控制领地内的飞行权限 | 开启 | ### 各 Flag 详细说明 #### 🍖 饱食度恢复 (saturation_restore) 在领地内自动恢复玩家的饱食度和饥饿值，让玩家可以长时间在领地内活动而不用担心饥饿问题。 **恢复机制：** - 饱食度：每秒恢复 0.5 点（可配置） - 饥饿值：每 5 秒恢复 1 点 #### ⚡ 移动加速 (fast_move) 在领地内提升玩家的移动速度，让大型领地的移动更加便捷。 **加速机制：** - 步行速度：基础速度 + 0.15（可配置） - 飞行速度：基础速度 + 0.075（步行加速的一半） #### ❤️ 生命恢复 (health_regen) 在领地内自动恢复玩家的生命值，创建安全的休息区域。 **恢复机制：** - 每秒恢复 0.5 点生命值（可配置） - 只在生命值未满时生效 #### 🪶 无摔落伤害 (no_fall_damage) 在领地内完全免疫摔落伤害，适合高空建筑或跑酷地图。 #### 🪽 允许飞行 (allow_fly) 提供了比 Dominion 本体更精细的飞行控制。 **三种工作模式：** 1. **Flag 启用且为 `true`** - 领地主人可以飞行 - 拥有 FLY 权限的成员可以飞行 - 拥有 FLY 权限的访客可以飞行 - **没有 FLY 权限的人无法飞行** 2. **Flag 启用且为 `false`** - **禁止所有人在领地内飞行** - 包括领地主人、OP 玩家（创造/旁观模式除外） - 适用于完全禁止飞行的区域 3. **Flag 被服务器禁用** - 完全交给 Dominion 本体处理 - 领地主人和有 FLY 权限的人可以飞行 --- ## 📦 安装要求 ### 必需依赖 | 依赖项 | 最低版本 | 说明 | |--------|----------|------| | Paper/Folia | 1.20.1 | 服务器核心（支持 Paper系列分支） | | Dominion | 4.7.0 | 领地插件本体 | | Java | 21 | 运行环境 | --- ## 🔧 安装方法 ### 全新安装 1. **下载插件** - 从发布页面下载最新的 `YiyunDominionFlags.jar` 2. **安装插件** ```bash # 将 JAR 文件放入 plugins 文件夹 cp YiyunDominionFlags.jar /path/to/server/plugins/ ``` 3. **重启服务器** ```bash # 重启服务器以加载插件 /restart ``` 4. **验证安装** - 查看控制台输出，确认插件已启用 - 使用 `/plugins` 命令查看插件列表 --- ## ⚙️ 配置文件 ### 配置文件位置 ``` plugins/ ├── YiyunDominionFlags/ │ └── config.yml └── YiyunDominionFlags.jar ``` ### 完整配置示例 ```yaml # ============================================ # YiyunDominionFlags 配置文件 # ============================================ # 饱食度恢复设置 saturation: # 每次恢复的饱食度数值 (0.0 - 20.0) restore_rate: 0.5 # 最大饱食度 (通常保持 20.0) max_amount: 20.0 # 生命恢复设置 health: # 每次恢复的生命值 (0.0 - 玩家最大生命值) regen_rate: 0.5 # 移动加速设置 movement: # 移动速度提升值 (0.0 - 1.0) # 0.15 表示提升 15% 的移动速度 speed_boost: 0.15 # Flag 启用设置 flags: # 饱食度恢复 Flag saturation_restore: enabled: true # 是否注册此 Flag default: false # 新建领地的默认状态 # 移动加速 Flag fast_move: enabled: true default: false # 生命恢复 Flag health_regen: enabled: true default: false # 无摔落伤害 Flag no_fall_damage: enabled: true default: false # 允许飞行 Flag allow_fly: enabled: true default: true ``` ### 配置项说明 #### `enabled` 选项 - `true` - 注册此 Flag，玩家可以在领地中设置 - `false` - 不注册此 Flag，完全禁用该功能 #### `default` 选项 - 新建领地时该 Flag 的默认状态 - 已有领地不受影响 --- ## 🎮 使用方法 ### 命令使用 所有 Flag 都通过 Dominion 的命令系统管理（当然你也可以在dominion的CUI中设置）： ``` # 设置领地 Flag /dominion flag set <领地名称> <flag名称> <true/false> # 查看领地 Flag /dominion flag list <领地名称> # 查看 Flag 帮助 /dominion flag help ``` ### 使用示例 ```bash # 在 spawn 领地启用饱食度恢复 /dominion flag set spawn saturation_restore true # 在 shop 领地启用生命恢复 /dominion flag set shop health_regen true # 在 pvp 领地禁用飞行 /dominion flag set pvp allow_fly false # 在 parkour 领地启用无摔落伤害 /dominion flag set parkour no_fall_damage true # 在大厅启用移动加速 /dominion flag set lobby fast_move true ``` ### CUI 界面设置 Dominion 提供 CUI 界面管理 Flag： 1. 输入 `/dom` 打开主菜单 2. 选择"管理领地" 3. 选择要管理的领地 4. 点击对应的 Flag 进行切换 --- ## 📊 统计数据 本插件使用 [bStats](https://bstats.org/) 收集匿名统计数据，帮助开发者了解插件的使用情况。 ### 查看统计数据  ## 🐛 故障排除 ### 常见问题 #### Q: 插件无法加载 **A:** 检查以下事项： - Dominion 版本在4.7.0+ - Java 版本是否为 21 或更高 - 服务器核心是否为 Paper 1.20.1+ #### Q: Flag 设置后不生效 **A:** - 确认 Flag 在配置文件中已启用 (`enabled: true`) - 检查玩家是否有相应的权限 - 尝试重新进入领地 #### Q: 饱食度/生命恢复速度太慢 **A:** - 修改 `config.yml` 中的 `restore_rate` 和 `regen_rate` 值 - 重启服务器生效 ### 调试模式 如需查看插件运行日志，可以在控制台查看。插件会在以下情况输出日志： - 插件启用/禁用 - Flag 注册失败 - bStats 初始化失败 --- ## 🐛 问题反馈 如果你遇到任何问题或有功能建议，欢迎通过以下方式联系： ### 联系方式 - **QQ**: 2919089965 - **QQ交流群**: 1093090518 (禁广，可以在群内反馈问题，或者想要什么新的功能可以在群内提出) --- ## 🙏 致谢 - [Dominion](https://github.com/ColdeZhang/Dominion) - 优秀的领地管理插件 - [bStats](https://bstats.org/) - 提供统计数据服务，帮助开发者改进插件 --- **作者**: CHL_chun **QQ**: 2919089965 - **QQ交流群**: 1093090518 (禁广，可以在群内反馈问题，或者想要什么新的功能可以在群内提出) [/MD]