Millida Rating 插件 ?
一款用于在 Millida Rating 监控系统中向投票者发放奖励的插件。?

支持版本:
Bukkit/Spigot/Paper 1.8 — 1.21 ?
功能:
- 奖励分发 ?
- 类似通行证(Battle Pass)的累积奖励系统 ?
- 支持 MySQL 和 SQLite 数据库 ?
- 与 DecentHolograms 集成 ?
- 与 PlaceholderAPI 集成 ?
安装 ⚙️
将插件放入 plugins 文件夹后,需要启动并停止服务器,因为出于安全原因,插件在未进行初步配置的情况下无法工作。对于首次启动,只需配置 server_id 即可。?
[!!!] 如果您不想为安装插件之前进行的投票发放奖励,请在插件首次启动前设置 rewards.enabled: false,并在服务器启动后执行命令 /rating admin clearrewards。?
为了在服务器运行时方便地进行配置,提供了命令 /rating admin reload,但强烈建议仅在测试期间使用此命令,而不要在已有玩家在线运行的服务器上使用。您可以仅向该命令添加 holograms 和 gui,以仅重新加载全息模块。?
还有用于测试插件设置的命令:/rating admin clear <nickname> 和 /rating admin vote <nickname>,分别用于清除玩家的进度和给予他们一次虚假投票。?
[!!!] 如果出现问题,出于安全原因,插件会立即关闭,以防止玩家丢失奖励或获得不应得的大量奖励。⚠️
权限 ?
millida.rating.command — 访问 /rating 命令本身。默认授予所有玩家。✅
millida.rating.command.rewards — 访问 /rewards 和 /rating rewards 命令。默认授予所有玩家。命令本身可以通过修改 config.yml 和 plugin.yml 来更改。✅
millida.rating.command.admin — 访问 /rating admin 命令。默认授予所有操作员。?
集成 ?
DecentHolograms
如果服务器上安装了 DecentHolograms 插件,服务器文件夹中会出现一个额外的配置文件 holograms.yml。默认情况下,全息图是禁用的,但可以通过此配置文件启用和配置它们。?
PlaceholderAPI
如果服务器上安装了 PlaceholderAPI 插件,以下占位符将自动注册:?
API ?
API 已经存在,但目前只能通过本地 Maven 仓库连接。为此,请克隆仓库并使用命令 gradle :api:publishToMavenLocal,之后即可导入:
<dependencies>
<dependency>
<groupId>ru.leonidm.millida</groupId>
<artifactId>millida-rating-api</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
用法 ⚙️
API 的主要入口点是 MillidaRatingApi 类,您可以从中获取 API 实例并访问所有必要的服务。
此外还有 Bukkit 事件:
RatingVoteEvent — 当 RatingRequester 发现新投票时触发 ?️
OfflinePlayerAwardedEvent — 当玩家收到属性为 online: false 的奖励时触发 ?
PlayerAwardedEvent — 当玩家收到属性为 online: true 的奖励时触发 ?
[!!!] 如果您想获取关于投票的信息,请使用存储哈希值的 RatingRequester 服务,而不是 RatingRequestService。
Millida Rating Plugin ?
A plugin for awarding voters on the Millida Rating monitoring system. ?

Supported Versions:
Bukkit/Spigot/Paper 1.8 — 1.21 ?
Features:
- Award distribution ?
- Cumulative reward system similar to battle passes ?
- Support for MySQL and SQLite databases ?
- Integration with DecentHolograms ?
- Integration with PlaceholderAPI ?
Installation ⚙️
After placing the plugin in the plugins folder, you need to start and stop the server, as the plugin does not work without preliminary configuration for security purposes. For the initial launch, just configure server_id. ?
[!!!] If you do not want to issue rewards for votes made before the plugin installation, set rewards.enabled: false before the first launch of the plugin and simply execute the command /rating admin clearrewards after starting the server. ?
For convenient configuration while the server is running, there is the command /rating admin reload, but it is highly recommended to use it exclusively during testing, not during an already running server with players. You can add only holograms and gui to this command to reload only the hologram module. ?
There are also commands for testing plugin settings: /rating admin clear <nickname> and /rating admin vote <nickname>, which clear a player's progress and give them one fake vote, respectively. ?
[!!!] If something goes wrong, the plugin immediately shuts down for security reasons to prevent players from losing their rewards or receiving an undeservedly large amount. ⚠️
Permissions ?
millida.rating.command — access to the /rating command itself. By default, granted to all players. ✅
millida.rating.command.rewards — access to the /rewards and /rating rewards commands. By default, granted to all players. The command itself can be changed by modifying config.yml and plugin.yml. ✅
millida.rating.command.admin — access to the /rating admin command. By default, granted to all operators. ?
Integrations ?
DecentHolograms
If the DecentHolograms plugin is installed on the server, an additional configuration file holograms.yml appears in the server folder. By default, holograms are disabled, but they can be enabled and configured through this configuration file. ?
PlaceholderAPI
If the PlaceholderAPI plugin is installed on the server, the following placeholders are automatically registered: ?
API ?
The API already exists, but for now, it can only be connected through a local Maven repository. To do this, clone the repository and use the command gradle :api:publishToMavenLocal, after which it can be imported:
<dependencies>
<dependency>
<groupId>ru.leonidm.millida</groupId>
<artifactId>millida-rating-api</artifactId>
<version>1.0.0</version>
</dependency>
</dependencies>
Usage ⚙️
The main entry point to the API is the MillidaRatingApi class, from which you can obtain an instance of the API and access all necessary services.
There are also Bukkit events:
RatingVoteEvent — triggered when RatingRequester finds a new vote ?️
OfflinePlayerAwardedEvent — triggered when a player receives a reward with the property online: false ?
PlayerAwardedEvent — triggered when a player receives a reward with the property online: true ?
[!!!] If you want to get information about votes, use the RatingRequester service, which stores hashed values, instead of RatingRequestService.
评论 0
登录后参与评分
还没有评论,来抢沙发吧