市面上有一些插件可以实现升级排名,但我发现许多插件的问题在于无法按照我的需求运作。与其直接通过 API 挂钩权限插件,从而限制服务器管理员只能执行插件开发者预设的升级操作,本插件依赖于控制台命令来为玩家提升等级。当玩家执行 "/rankup" 时,系统会针对每个匹配的升级规则检查条件,并执行相应的命令。通过配置,你可以设置为提升玩家等级所需的命令,并执行额外任务,例如给予奖励、赋予有时效性的权限,或任何可以通过命令完成的操作(这是其他插件所不具备的功能)。本插件的主要目标是为你的角色扮演服务器提供一个排名系统,允许你根据角色扮演场景和服务器设置进行完美配置和自定义。我个人开发此插件是因为我希望拥有一个能与 PEX 阶梯良好配合的升级系统,而其他插件并不支持这一点。但由于本插件在设计上具有高度灵活性,你也可以实现这一功能,并支持多个阶梯。
功能
- 执行任意控制台命令以提升玩家等级
- 可执行命令批次,包含你权限插件及额外任务所需的任意数量命令
- 支持金钱、经验值、饥饿度和生命值作为要求。(如果你有想法,请在评论中建议更多——详见待办事项列表中的计划实现)
- 仅检查要求或扣除要求,且各项要求可单独配置(例如:可配置为检查玩家是否满血但扣除 $5000)
- 支持排名流及跨越排名树结构的正确实现(例如:玩家可以从一个排名晋升到另一个排名,或从多个起始排名晋升到一个主要排名)
- 允许同一玩家使用一次或多次升级功能
- 可选的全局或按等级设置的冷却时间,以控制玩家升级速度并防止滥用。
- 提供命令供玩家查看下次升级的目标及所需信息,如要求和描述
- 高度可定制的玩家体验
- 支持通过 TriggerCmd 按钮进行升级
- 兼容所有支持 Vault 的权限和经济插件
- 用途可高度自定义,不仅限于升级排名
依赖项
- Vault - 提供对权限插件的挂钩,并可选地支持经济插件。
- Vault 兼容的权限插件 - 与 Vault 配合使用是插件正常工作的必要条件。这用于内部权限(即命令权限),同时也用于获取玩家的当前等级。
- Vault 兼容的经济插件 - 如果将金钱用作升级要求则为必需。如果无法挂钩经济插件,所有金钱相关设置将被忽略。
工作原理
当玩家执行 /rankup 时,插件的工作方式是尝试在配置文件中查找匹配的等级;如果有多个匹配项,它们将按照匹配顺序依次执行。插件会检查每个升级等级的要求,并在需要时扣除相应要求,然后按照配置文件中的设定执行命令。目前插件支持金钱和经验值要求,但我乐意接受关于其他功能的建议,以便更好地适配你的角色扮演服务器。
命令
- /rankup - 检查玩家满足哪些升级要求,然后执行升级。
- /rankcheck - 显示执行 /rankup 时将尝试的所有升级及其要求
- /cmdrank reload - 从配置文件重新加载配置。
权限
- cmdrank.rankup - 可以执行升级命令以提升等级
- cmdrank.admin - 可以执行所有 /cmdrank 命令
- cmdrank.reload - 可以执行 /cmdrank reload
- cmdrank.bypass.cooldown - 绕过任何冷却限制
- cmdrank.bypass.disabled - 绕过任何已禁用的等级
- cmdrank.bypass.reranks - 绕过任何重排限制
配置
你可以在此处查看带有完整注释的配置文件版本,这应能帮助你开始配置。然而,如果你希望获得完整的配置教程,请点击此处。
待办事项
- 可定制的升级别名,以与其他用法兼容
- 实现 McMMO 技能作为要求
- 添加在线时长作为升级要求
- 添加管理员命令以对其他玩家触发升级
- 添加管理员命令以管理升级
- 基于统计的要求——放置方块数、击杀玩家数等
- 基于物品的要求——必须拥有特定物品才能升级
- 翻译成其他语言(如果你能提供帮助,请联系我)
- 开发者 API 以访问数据、发起升级,并接入你自己的要求
开发
当前的开发源代码可以在 GitHub 或 GIT:flungo 上找到(后者更新更及时)。你可以从我的 Jenkins 下载开发快照。
捐赠
捐赠完全自愿,但如果你愿意捐赠,我很乐意接受。我并不期望所有使用该插件的用户都进行捐赠,不过,如果你在服务器上使用我的插件(或其他任何开发者的插件),而你自己也从该服务器获得捐赠,那么你是否可以考虑将一部分爱心分享给那些为你服务器提供支持的插件开发者呢?我不期望那些不通过插件使用获利的人进行捐赠,但所有的捐赠都会受到欢迎,并有助于加快开发进度和完成功能请求。如果你想向我捐赠,可以使用下面的按钮:
There are a couple of plugins out there that do ranking up but the problem I have had with many is getting it to do what I want. Rather than using API hooks into permissions plugins directly which limits the server admin to doing just what the plugin developer wanted the plugin to do when ranking a player up, this plugin relys on console commands in order to rank the player up. When a player does "/rankup" a criteria is checked for each matching rankup rule and the associated commands are executed. With configuration, this would be set to be the commands required to "rankup" the player and perform additional tasks like give them bonuses, give them timed permissions or anything that can be done via a command (something other plugins don't give you). The main goal behind the plugin is to provide you with a ranking system for your role-play that allows you to configure and customise it perfectly for your role-play scenario as well as your server setup. Personally I made this so that I would have rankup system that worked well with PEX ladders which other plusing don't allow but due to the flexibility in the way this plugin is designed, you can do this as well as use it for multiple ladders.
Features
- Execute any console command(s) to rankup the player
- Execute batches of commands with as many commands as you need for your permissions plugin and additional tasks
- Supports money, experience, hunger and health as requirments. (Please suggest more in the comments if you have any ideas - see ToDo list for planned implementations)
- Can just check requirements or take requirements configurable per requirements (e.g. can be configured to check they have full health but take $5000)
- Supports rank streams and spanning rank trees with correct implementation (e.g. players can rank from one to another or players can rank from serveral starting ranks to one main rank)
- Allow rankups to be used 1 or many times by the same player
- Optional cooldown between rankups on a global or rank by rank level to control the pace that players can rankup and stop abuse.
- Command for players to check what thier next rankup will be and get information such as requirements and a description
- Highly customisable player experience
- Rankup from buttons using TriggerCmd
- Compatible with all Vault compatible Permissions and Economy
- Usage can be customised for much more than just ranking up
Depenancies
- Vault - Provides hooks to permissions and optionally economy plugins.
- Vault compatible Permissions - required with vault in order for the plugin to work. This is for internal permissions (i.e. command permissions) as well as being used to find out what rank(s) the player has.
- Vault compatible Economy - optional if money is to be used as a rank-up requirement. All money settings will be ignored if an economy plugin cannot be hooked into.
How it works
The way the plugin works when the player executes /rankup is by trying to find a rank that matches one in the config file, if multiple match they will be executed in the order that they are matched. The plugin checks the requirements for each rankup and takes the requirements where needed then will execute the commands as configured in the config file. Currently the plugin support monetary, and experience requirements but I am happy to take suggestions on what else you would like to see to make this fit into your role-playing server.
Commands
- /rankup - Checks which rankups the player meets the requirements for then executes.
- /rankcheck - Shows all rankups that will be attempted when /rankup is executed and their requirements
- /cmdrank reload - Reload the config from the config file.
Permissions
- cmdrank.rankup - can execute rankup command in order to be ranked up
- cmdrank.admin - can execute all /cmdrank commands
- cmdrank.reload - can execute /cmdrank reload
- cmdrank.bypass.cooldown - bypasses any cooldown restrictions
- cmdrank.bypass.disabled - bypasses any disabled ranks
- cmdrank.bypass.reranks - bypasses any rerank restrictions
Configuration
You can view a full commented version of the config file here which should allow you to get started with configuring however, if you would like a full configuration tutorial click here.
ToDo List
- Customisable rankup alias to make it fit with other usages
- Implement McMMO skills as requirements
- Add time online as a rankup requirement
- Add admin commands to invoke rankups on other players
- Add admin commands to manage rankups
- Stats based requirements - blocks placed, players killed, etc.
- Inventory based requirements - Must have specific items in inventory to rankup
- Translate into other langauges (if you can help with this, please contact me)
- Developer API to access data, initiate rankups, and plug in your own requirements
Development
The current development source code can be found on GitHub or on GIT:flungo (the latter being more likely to be up to date). You can download development snapshots from my Jenkins.
Donating
Making a donation is totally voluntary, however if you wish to donate I am happy to accept. I don't expect everyone using my plugin to donate however if your using my plugin (or any developer's plugins for that matter) on a server where you too receive donations then how about considering passing along some of that love to the people who make the plugins that make your server possible? I wouldn't expect people who don't make money from the use of the plugin to donate but all donations are appreciated and would help speed up development and get feature requests completed. If you would like to donate to me then you can use the button below:
评论 0
登录后参与评分
还没有评论,来抢沙发吧