RegionGUI
一个适用于 Spigot/Paper 服务器的综合区域管理插件,提供直观的基于 GUI 的界面来管理 WorldGuard 区域。
功能
- 区域浏览器 - 浏览所有区域,支持分页
- 区域管理 - 查看详细的区域信息,包括坐标、体积和成员数量
- 旗帜管理 - 轻松切换和配置 WorldGuard 旗帜,每页显示 45 个旗帜
- 成员管理 - 添加、移除和管理区域的成员角色
- 区域转让 - 将区域所有权转让给其他玩家
- 区域删除 - 带确认保护的删除区域
- 成员邀请 - 邀请玩家加入你的区域,支持自定义角色
- 搜索与筛选 - 按名称搜索区域和旗帜,并支持实时筛选
- 排序选项 - 按名称、成员或体积对区域进行排序;按 A-Z 或 Z-A 对旗帜排序
- 类别筛选 - 按类别筛选旗帜(保护、玩法、生物/火焰/爆炸、自然事件、移动)
- 角色系统 - 可定制的区域成员角色系统
- 分页 - 针对大量区域和旗帜的高效分页
- 移动端友好 GUI - 优化的 54 槽物品栏界面,导航清晰
安装
- 下载插件 JAR 文件
- 将其放入服务器的
plugins 文件夹中
- 确保已安装并启用 WorldGuard
- 重启服务器
- 配置文件将在
plugins/RegionGUI/ 中生成
命令
主要命令
| 命令 |
描述 |
权限 |
/region |
打开区域浏览器 GUI |
regiongui.use |
/region page <prev|next> |
在区域页面之间导航 |
regiongui.use |
/region search <query> |
按名称搜索区域 |
regiongui.use |
/region reload |
重新加载所有配置(仅限管理员) |
regiongui.admin |
管理命令
| 命令 |
描述 |
权限 |
/region manage <region> |
打开区域管理 GUI |
regiongui.manage |
/region flags <region> |
查看和编辑区域旗帜 |
regiongui.flags |
/region members <region> |
管理区域成员 |
regiongui.members |
/region transfer <region> <player> |
转让区域所有权 |
regiongui.transfer |
/region delete <region> |
删除区域 |
regiongui.delete |
成员命令
| 命令 |
描述 |
权限 |
/region invite <player> <region> |
邀请玩家加入你的区域 |
regiongui.invite |
/region accept <region> |
接受区域邀请 |
regiongui.use |
/region deny <region> |
拒绝区域邀请 |
regiongui.use |
权限
| 权限 |
描述 |
默认值 |
regiongui.use |
访问基本区域 GUI 功能 |
true |
regiongui.manage |
管理区域设置 |
true |
regiongui.flags |
编辑区域旗帜 |
true |
regiongui.members |
管理区域成员 |
true |
regiongui.transfer |
转让区域所有权 |
true |
regiongui.delete |
删除区域 |
true |
regiongui.invite |
邀请玩家加入区域 |
true |
regiongui.admin |
管理员命令(重新加载配置) |
op |
配置
主配置文件 (config.yml)
自定义颜色、消息、角色和旗帜类别:
# 区域颜色
colors:
owner: '#FFD700'
manager: '#87CEEB'
member: '#90EE90'
# 角色显示名称
roles:
owner:
displayName: 'Owner'
manager:
displayName: 'Manager'
member:
displayName: 'Member'
# 用于筛选的旗帜类别
flag-categories:
protection:
- deny-spawn
- creeper-explosion
- tnt
gameplay:
- pvp
- item-drop
- invincibility
# ... 更多类别
GUI 配置文件 (maingui.yml & manageflags.yml)
自定义物品栏 GUI 的外观和布局:
menu_title: '&8&lMy Regions'
size: 27
items:
previous_page_button:
material: ARROW
slot: 21
display_name: '&fPrevious Page'
search_button:
material: OAK_SIGN
slot: 22
display_name: '&aSearch'
next_page_button:
material: ARROW
slot: 23
display_name: '&fNext page'
消息文件 (messages.yml)
所有面向用户的消息均可自定义,并支持颜色:
region-selected: '&8Selected region: &e%region%'
flag-updated: '&8Successfully updated flag &e%flag% &8to &f%value%&8.'
member-added: '&8Added &e%player% &8as a &b%role% &8to region &e%region%&8.'
GUI 指南
区域浏览器(27 槽)
- 槽位 0-17:以物品形式显示你的区域
- 槽位 21:上一页按钮
- 槽位 22:当前搜索状态的搜索按钮
- 槽位 23:下一页按钮
旗帜管理(54 槽)
- 槽位 0-44:带有当前值和状态的区域旗帜
- 槽位 45:上一页按钮
- 槽位 46:返回管理器按钮
- 槽位 48:排序切换(A-Z / Z-A)
- 槽位 49:搜索按钮
- 槽位 50:筛选按钮(按类别)
- 槽位 53:下一页按钮
成员管理(54 槽)
- 槽位 0-8:顶部边框
- 槽位 9-44:带有其角色的区域成员
- 槽位 45:上一页按钮
- 槽位 46:搜索成员按钮
- 槽位 48:返回管理器按钮
- 槽位 49:添加成员按钮
- 槽位 53:下一页按钮
使用方法
查看你的区域
- 运行
/region 打开区域浏览器
- 使用上一页/下一页箭头浏览页面
- 点击某个区域以查看其详细信息
管理旗帜
- 选择一个区域并点击“管理旗帜”
- 使用筛选按钮查看特定的旗帜类别
- 使用排序按钮整理旗帜
- 左键单击旗帜以切换其状态
- 右键单击旗帜以清除它
添加成员
- 在区域管理器中,点击“管理成员”
- 点击翡翠色按钮以添加新成员
- 在聊天栏中输入玩家名称
- 为新成员选择角色
管理角色
- 在成员列表中,点击某位成员
- 左键单击可更改其角色
- 右键单击可将其从区域中移除
占位符
如果已安装 PlaceholderAPI,您可以使用以下占位符:
%regiongui_region_count% - 玩家拥有的区域数量
%regiongui_active_region% - 当前选中的区域名称
%regiongui_member_count% - 当前活动区域中的成员数量
支持与问题反馈
如果您遇到任何问题或有功能建议:
- 检查配置文件是否正确
- 确保 WorldGuard 已正确安装
- 查看服务器日志以查找错误信息
- 验证玩家权限设置是否正确
依赖项
- 必需:WorldGuard 7.0+
- 可选:PlaceholderAPI(用于支持占位符)
兼容性
- Spigot 1.16+
- Paper 1.16+
- 已在 Minecraft 1.20.4 版本上测试通过
许可证
本插件按原样提供。保留所有权利。
致谢
专为在 Spigot/Paper 服务器上高效管理 WorldGuard 区域而开发。
注意:此插件需要 WorldGuard 才能运行。在使用 RegionGUI 之前,请确保您的服务器已正确安装并配置了 WorldGuard。
RegionGUI
A comprehensive region management plugin for Spigot/Paper servers with an intuitive GUI-based interface for managing WorldGuard regions.
Features
- Region Browser - Browse all your regions with pagination support
- Region Management - View detailed region information including coordinates, volume, and member count
- Flag Management - Easily toggle and configure WorldGuard flags with 45 flags per page
- Member Management - Add, remove, and manage member roles for your regions
- Region Transfer - Transfer ownership of regions to other players
- Region Deletion - Delete regions with confirmation protection
- Member Invitations - Invite players to join your regions with customizable roles
- Search & Filter - Search regions and flags by name with real-time filtering
- Sorting Options - Sort regions by name, members, or volume; sort flags A-Z or Z-A
- Category Filtering - Filter flags by category (Protection, Gameplay, Mob/Fire/Explosion, Natural Events, Movement)
- Role System - Customizable role system for region members
- Pagination - Efficient pagination for large numbers of regions and flags
- Mobile Friendly GUI - Optimized 54-slot inventory interface with clear navigation
Installation
- Download the plugin JAR file
- Place it in your server's
plugins folder
- Ensure WorldGuard is installed and enabled
- Restart your server
- Configuration files will be generated in
plugins/RegionGUI/
Commands
Main Commands
| Command |
Description |
Permission |
/region |
Open the region browser GUI |
regiongui.use |
/region page <prev|next> |
Navigate between region pages |
regiongui.use |
/region search <query> |
Search for regions by name |
regiongui.use |
/region reload |
Reload all configurations (Admin only) |
regiongui.admin |
Management Commands
| Command |
Description |
Permission |
/region manage <region> |
Open region management GUI |
regiongui.manage |
/region flags <region> |
View and edit region flags |
regiongui.flags |
/region members <region> |
Manage region members |
regiongui.members |
/region transfer <region> <player> |
Transfer region ownership |
regiongui.transfer |
/region delete <region> |
Delete a region |
regiongui.delete |
Member Commands
| Command |
Description |
Permission |
/region invite <player> <region> |
Invite a player to your region |
regiongui.invite |
/region accept <region> |
Accept a region invitation |
regiongui.use |
/region deny <region> |
Decline a region invitation |
regiongui.use |
Permissions
| Permission |
Description |
Default |
regiongui.use |
Access basic region GUI features |
true |
regiongui.manage |
Manage region settings |
true |
regiongui.flags |
Edit region flags |
true |
regiongui.members |
Manage region members |
true |
regiongui.transfer |
Transfer region ownership |
true |
regiongui.delete |
Delete regions |
true |
regiongui.invite |
Invite players to regions |
true |
regiongui.admin |
Admin commands (reload configs) |
op |
Configuration
Main Configuration (config.yml)
Customize colors, messages, roles, and flag categories:
# Region colors
colors:
owner: '#FFD700'
manager: '#87CEEB'
member: '#90EE90'
# Role display names
roles:
owner:
displayName: 'Owner'
manager:
displayName: 'Manager'
member:
displayName: 'Member'
# Flag categories for filtering
flag-categories:
protection:
- deny-spawn
- creeper-explosion
- tnt
gameplay:
- pvp
- item-drop
- invincibility
# ... more categories
GUI Configuration (maingui.yml & manageflags.yml)
Customize the appearance and layout of inventory GUIs:
menu_title: '&8&lMy Regions'
size: 27
items:
previous_page_button:
material: ARROW
slot: 21
display_name: '&fPrevious Page'
search_button:
material: OAK_SIGN
slot: 22
display_name: '&aSearch'
next_page_button:
material: ARROW
slot: 23
display_name: '&fNext page'
Messages (messages.yml)
All user-facing messages are customizable with color support:
region-selected: '&8Selected region: &e%region%'
flag-updated: '&8Successfully updated flag &e%flag% &8to &f%value%&8.'
member-added: '&8Added &e%player% &8as a &b%role% &8to region &e%region%&8.'
GUI Walkthrough
Region Browser (27 slots)
- Slots 0-17: Your regions displayed as items
- Slot 21: Previous page button
- Slot 22: Search button with current search status
- Slot 23: Next page button
Flag Management (54 slots)
- Slots 0-44: Region flags with current values and states
- Slot 45: Previous page button
- Slot 46: Back to manager button
- Slot 48: Sort toggle (A-Z / Z-A)
- Slot 49: Search button
- Slot 50: Filter button (by category)
- Slot 53: Next page button
Member Management (54 slots)
- Slots 0-8: Top border
- Slots 9-44: Region members with their roles
- Slot 45: Previous page button
- Slot 46: Search members button
- Slot 48: Back to manager button
- Slot 49: Add member button
- Slot 53: Next page button
How to Use
Viewing Your Regions
- Run
/region to open the Region Browser
- Use the Previous/Next arrows to browse through pages
- Click on a region to view its details
Managing Flags
- Select a region and click "Manage Flags"
- Use the Filter button to view specific flag categories
- Use the Sort button to organize flags
- Left-click a flag to toggle its state
- Right-click a flag to clear it
Adding Members
- In the Region Manager, click "Manage Members"
- Click the Emerald button to add a new member
- Enter the player's name in chat
- Select the role for the new member
Managing Roles
- In the Members list, click on a member
- Left-click to change their role
- Right-click to remove them from the region
Placeholders
If PlaceholderAPI is installed, you can use these placeholders:
%regiongui_region_count% - Number of regions owned by player
%regiongui_active_region% - Currently selected region name
%regiongui_member_count% - Number of members in active region
Support & Reporting Issues
If you encounter any issues or have feature requests:
- Check the configuration files are correct
- Ensure WorldGuard is properly installed
- Check server logs for error messages
- Verify player permissions are set correctly
Dependencies
- Required: WorldGuard 7.0+
- Optional: PlaceholderAPI (for placeholder support)
Compatibility
- Spigot 1.16+
- Paper 1.16+
- Tested up to Minecraft 1.20.4
License
This plugin is provided as-is. All rights reserved.
Credits
Developed for efficient WorldGuard region management on Spigot/Paper servers.
Note: This plugin requires WorldGuard to function. Make sure WorldGuard is properly installed and configured on your server before using RegionGUI.
评论 0
登录后参与评分
还没有评论,来抢沙发吧