开发者

添加依赖引用

repositories {
    maven("https://jitpack.io")
}
dependencies {
    compileOnly("com.github.MrXiaoM:SweetMail:$VERSION")
}

1
2
3
4
5
6

插件事件详见 top.mrxiaom.sweetmail.events (opens new window)

# 熟悉主要包名

top.mrxiaom.sweetmail

attachments 内置附件类型
commands 插件命令
config 插件配置，包括界面配置
database 插件数据库调用逻辑
depend 插件依赖/联动插件逻辑
func 插件功能模块
utils 工具

# 使用接口发送系统邮件

import top.mrxiaom.sweetmail.IMail;
// 使用示例
void foo() {
    IMail.Status status = IMail.api()
            .createSystemMail("系统消息")
            .setIcon("BOOK") // 设置图标，详见源码注释
            .setTitle("邮件标题")
            .addContent("邮件正文内容", "列表中每个元素代表每页。换行依旧用\n")
            .addAttachments( // 添加附件
                AttachmentItem.build(new ItemStack(Material.DIAMOND))
            )
            .send();
    if (status.ok()) {
        info("邮件发送成功");
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 注册自定义附件类型

请参考 AttachmentItem#register (opens new window)，位于这个类的最后一个方法。

对于需要在附件添加非常多的物品，建议另外注册一个附件类型，而不是使用插件自带的物品附件。

# 设置书本实现

替换草稿界面、收件箱界面、发件箱界面的打开成书逻辑。

void foo() {
    SweetMail.getInstance().setBookImpl(new DefaultBook()/*替换成你自己的实现*/);
}

1
2
3

# 构建插件

请使用 java 21 执行以下命令即可构建。别担心，构建产物的目标版本是 java 8。

./gradlew clean build

构建的插件会出现在 build/libs 目录。

上次更新: 2025/05/03, 21:58:24

← PAPI变量简介→