关于 RegionClaim
你是否希望用户能够轻松认领自己的基地,并通过 WorldGuard 的保护标准确保其安全,同时你自己又能保留完全的控制权?是否厌倦了手动为用户创建预设区域以供认领?那么 RegionClaim 正是为你打造的插件!
RegionClaim 允许人们通过其自身非常用户友好的命令来创建区域。认领区域的大小、每个人可以创建的认领数量以及应用于这些区域的设置都高度可配置。你可以使用三种权限级别,并为每个级别设置不同的参数。在底层,它利用 WorldGuard 出色的 API,使区域受到极好的保护,并且几乎不会给服务器带来额外负担!
主要特性
极致的用户友好性
为了让不熟悉游戏的玩家也能轻松使用认领功能,我尽可能地将本插件设计得对用户友好。主命令包含多种帮助信息,以建设性的方式引导用户使用。它会针对输入错误的命令提供智能建议,提示可能的选项。此外,每个命令都支持完整的 Tab 自动补全,使得使用更加便捷!
高度可配置
我认为一个插件应当允许你配置其所有方面,以实现最大的灵活性。当然,你可以更改用户在不同权限级别下可以创建的认领数量及其大小。你还可以设置哪些 WorldGuard 标志将应用于用户的认领区域。自 2.2 版本起,我的插件还支持 Vault,因此可与市面上任何经济类插件配合使用。
作为附加福利,每条用户消息均可自定义,让你有机会将其更改为你所使用的语言!
性能
由于本插件基于 WorldGuard 的 API 来处理事件,它几乎不会给服务器增加额外负载!
稳定性
插件在启动时会验证其配置,以确保无效配置不会导致任何问题。如果发现任何错误,它会明确告知你需要修复的内容!
入门指南
安装
从 2.2.0 版本开始,本插件需要 Java 8 或更高版本。
从此页面顶部下载 jar 文件并将其放入你的 plugins 文件夹中。重新加载/重启服务器即可完成安装!请注意,本插件依赖于 WorldGuard,而 WorldGuard 又依赖于 WorldEdit,因此如果尚未安装,也需要安装这两个插件。
认领区域
首先,使用/claim setpos 两次设置你想要认领区域的边界。这将把你当时所站立的方块作为边界。然后执行 /claim create my_house (或其他名称)来创建一个受保护的认领区域。该区域会自动垂直扩展,意味着你脚下的地面和头顶的天空也都属于你的认领范围!你将无法创建重叠的认领区域(也无法在其他 WorldGuard 区域上进行认领)。
命令
- /claim help - 显示解释用法的帮助信息(未识别的命令也会显示此消息)
- /claim setpos - 将你当前站立的方块选为新认领区域的边界
- /claim create <region_name> - 创建一个新的认领区域,第二个参数为区域名称
- /claim remove <region_name> - 移除你提供的名称对应的认领区域(如果存在)
- /claim show <region_name> - 显示用户认领区域的坐标。还会使用粒子效果交互式地显示边界!
如果允许邀请用户所在权限级别的人员
- /claim invite <region_name> <player_name> - 邀请朋友加入你的认领区域,他们也将可以在那里建造!你仍然是该认领区域的所有者
- /claim uninvite <region_name> <player_name> - 从你的认领区域中移除之前邀请的人
所有这些命令在使用时若缺少正确的参数,都会显示自定义的帮助信息。
仅限管理员使用
此命令不会出现在 Tab 补全列表中,并且当然需要不同的权限。
- /claim resetconfig - 将 config.yml 文件重置为默认值。这将覆盖你自定义的配置文件,请谨慎使用。
权限
用户若要拥有领地(claim)功能,至少需要 claim.min 权限。为用户设置多个权限时,将赋予其最高级别权限对应的设置。括号内显示的是该权限的默认值。强烈建议使用权限管理插件来正确管理权限。
- claim.min (true) - 对应最低权限等级(在配置中称为“minimum”)
- claim.normal (op) - 对应中等权限等级(在配置中称为“normal”)
- claim.max (op) - 对应最高权限等级(在配置中称为“maximum”)
- claim.admin (op) - 允许重置配置文件
配置
该配置文件包含大量设置,允许你自定义许多方面。当然这是可选的,因为插件已提供了合理的默认值。如需了解某项设置的详细信息,请阅读配置文件中该项上方的注释,或提出问题(见下文)。
配置文件分为两个部分:
第一部分涉及领地相关的设置。与权限类似,它也包含三个权限等级,允许为每个等级设置不同的参数。目前你可以设置所有类型为 ALLOW 或 DENY 的 WorldGuard 标志。完整列表请参阅 此维基页面中标记为 “state” 的所有标志。无法识别的标志将被忽略,并在控制台中显示提示信息。
第二部分涉及在使用领地命令时向用户显示的消息。消息可以使用 § 符号的颜色代码,完整颜色列表请参考 此资源。部分消息支持传入参数,例如领地的名称或大小等。这通过将参数名放在花括号中实现,例如 ‘{region_name}’。具体哪些参数适用于哪些位置,已在对应消息上方的注释中说明。即使不包含参数也能正常工作,但消息对用户来说可能不够友好。
捐赠? :)
如果你非常喜欢这个插件,可以考虑通过 我的 PayPal 进行一次性捐赠。这将帮助我继续改进并扩展该插件的功能!
有问题、发现 Bug 或有功能建议?
欢迎在讨论页提出关于该插件的问题。如果你有改进该插件的想法,也请告诉我!
About RegionClaim
Do you want your users to easily claim their base and keep it safe with WorldGuards protection standard, while you retain full control? Tired of manually creating predefined regions for people to claim? Then RegionClaim is the plugin for you!
RegionClaim allows people to create regions through its own very user-friendly command. The claim size, the number of claims a person may create and which settings will be set on them is highly configurable. You can use three permission levels with different settings for each. Under the hood it uses WorldGuard’s amazing API, making the regions both very well protected and adding almost no extra weight to your server!
Key features
Extremely user friendly
To make claiming easy to use for inexperienced players, I made this plugin as user friendly as possible. The main command has many different help messages, guiding a user though its usage in a constructive manner. It gives clever suggestions for mistyped commands, hinting at possible options. On top of that every command has full tab autocompletion making it much easier to use!
Highly configurable
I really think that a plugin should allow you to configure all its aspect for maximum flexibility. Of course you can change how many claims users may make, and what size these can be for all three permission levels. You can also set which WorldGuard flags will be set on users claims. Since version 2.2 my plugin also has Vault support, so it works with any Economy plugin out there.
As a bonus every user message can be changed, optionally allowing you to change it to your language!
Performance
As this plugin is built upon WorldGuard’s API to handle events it adds almost no extra load to your server!
Stability
The plugin validates its configuration on launch to guarantee an invalid configuration won’t break anything. If it finds any errors it lets you know exactly what should be fixed!
Getting started
Installation
From version 2.2.0 onwards, this plugin requires Java 8 or higher.
Download the jar file from the top of this page and put it in your plugins folder. Reload/restart your server and you are done! Keep in mind that this plugin uses WorldGuard, which in turn uses WorldEdit, so these should be installed as well if not already present.
Claiming a region
First set the outer boundaries of the area you want to claim using /claim setpos twice. This will take the block you are standing on at that moment as the boundary. Then do /claim create my_house (or any other name of course) to create a protected region. This region will be vertically expanded automatically, meaning the ground below and sky above are also part of your claim! You won’t be able to create overlapping claims (and can’t claim over other WorldGuard regions).
Commands
- /claim help - Displays help message explaining usage (unrecognized commands will also show this message)
- /claim setpos - Selects the block you are standing on as a boundary for a new claim
- /claim create <region_name> - Creates a new claim with the second argument as the name
- /claim remove <region_name> - Removes your claim with the name provided (if it exists)
- /claim show <region_name> - Gives the coordinates of a user’s claim. Also displays the border interactively using particles!
If inviting is allowed for the user's permission level
- /claim invite <region_name> <player_name> - Invite a friend to your claim, who will then also be also to build there! You will still remain the owner of the claim
- /claim uninvite <region_name> <player_name> - Remove someone you had invited from your claim
All these commands show custom help messages when used without the correct arguments.
For administrators only
This command won’t appear in the tab completion and of course requires a different permission.
- /claim resetconfig - Reset the config.yml file to its default. This will overwrite your own configuration file and should be used with care.
Permissions
To able to claim, users need at least claim.min. Setting multiple permissions for a user will give them the settings for the highest given level. In brackets is the default setting for the permission. I highly suggest using a permission manager to handle permissions properly.
- claim.min (true) - corresponds to the lowest permission level (referred to as ‘minimum’ in configuration)
- claim.normal (op) - corresponds to medium permission level (referred to as ‘normal’ in configuration)
- claim.max (op) - corresponds to the highest permission level (referred to as ‘maximum’ in configuration)
- claim.admin (op) - Allows you to reset the configuration file
Configuration
The configuration has a lot of settings and allows you to customise many aspects. This is of course optional, as it has sensible defaults. For specific details about a setting please read the comments above each setting in the config file or ask a question (see below).
The configuration is split into two sections:
The first one deals with settings about claims. Just like the permissions it has three permission levels, allowing custom settings for each of them. As of now you can set all WorldGuard flags of the ALLOW or DENY type. To get a full list see all flags labeled ‘state’ on this wiki. Unrecognized flags will simply be ignored and a message will be shown in the console.
The second section is about the messages shown to a user when using the claim-command. The messages can use color-codes using the §-symbol, see this resource for a full list. Some messages allow for arguments to be passed in, such as a claim’s name or size for example. This is done by putting the name of the argument between curly braces, for example ‘{region_name}’. Which argument is applicable where is explained in the comment above the message. Not including the argument will work as well, but the message might be less helpful to users.
Donate? :)
If you really like this plugin, you could consider making a one time donation to my PayPal. This allows me to continue improving and expanding the functionality of this plugin!
Questions, bugs or feature suggestions?
Feel free to ask a question about the plugin in the discussion page. If you have an idea how this plugin could be improved let me know!
评论 0
登录后参与评分
还没有评论,来抢沙发吧