LogoArcartX Doc

说明与安装

Ritual 的用途、运行条件与首次安装

说明与安装

Ritual 提供自然周签到。服主可分别设置周一至周日及七日全勤奖励,多组奖励按设定顺序逐周轮换。

Ritual 为 ArcartX 高级会员专属插件。 Ritual 与 SystemMail 分别需要有效授权。

核心能力

能力说明
自然周签到按配置时区在每周一 00:00 开始新周期
七日奖励为周一至周日分别配置物品、货币和命令奖励
全勤奖励玩家在周日且七天全部签到后领取一次
奖励轮换多组启用方案按管理界面顺序在全服统一逐周轮换
游戏内编辑创建奖励组,编辑邮件、附件和轮换顺序

运行条件

  • Java 17;
  • Paper 1.18.2+;
  • Blink 1.3.14 运行环境;
  • ArcartX 2.5.36.8+;
  • SystemMail 1.0.0+;

安装步骤

安装依赖与插件

停止服务器,将 Ritual JAR 放入 plugins/,并确认 ArcartX 与 SystemMail 已经安装。

填写许可证

首次启动会生成 plugins/Ritual/license.yml,未填写时 Ritual 不会启动业务:

licenseId: 你的许可证ID
licenseKey: "你的许可证密钥"

填写 Ritual 的有效授权凭据,再完整重启服务器。

检查生成文件

授权成功后,确认以下文件已经生成:

plugins/Ritual/
├─ license.yml
├─ config.yml
├─ database.yml
├─ language.yml
└─ ui/
   └─ signin.yml

调整奖励并检查界面

执行 /ritual gui 打开管理界面,检查默认生成的三组奖励。正式开放前,请调整每日奖励、全勤奖励和奖励组顺序。

最后用 /ritual open 检查玩家界面。签到、奖励、状态和关闭图标应正常显示;如果图标缺失,检查客户端资源包路径。

玩家界面只显示奖励内容,不显示奖励组 ID、管理名称或轮换位置。

On this page