发布你的插件

作为 Sponge 的正式插件及 Mod 仓库,Ore 是一个免费的开源项目,任何人都可以在 Ore 上发布自己的 Sponge 插件或者 Forge MOD。

打包你的插件

Ore 要求任何项目的 JAR 压缩包都要封装一个位于根目录的用作描述符的 mcmod.info 文件。此文件用于自动推断一些有关项目的重要细节,使上传过程更容易。如果没有这个文件, Ore 将拒绝您的插件。幸运的是, SpongeAPI 有一个内置注解处理器,在编译时自动创建这个文件,使用你可能已经在插件的主类中的 @Plugin 注解中提供的描述。

备注

有关创建和编译你的第一个插件的详细信息,请参阅 插件的主类

这里是一个示例 mcmod.info 文件,以供参考︰

[
    {
        "modid": "my-plugin",
        "name": "MyPlugin",
        "version": "1.0.0",
        "description": "My first plugin!",
        "url": "https://spongepowered.org",
        "authorList": [
            "windy",
            "Zidane",
            "gabizou"
        ],
        "requiredMods": [
            "[email protected]",
            "[email protected]",
            "[email protected]"
        ],
        "dependencies": [
            "[email protected]",
            "[email protected]",
            "[email protected]"
        ]
    }
]

最后,每个 Ore 项目 必须modidname 、以及 version 三个字段。

上传你的插件

当你在插件的根目录添加了“mcmod.info”说明文件并且打包之后,便可以上传了。你必须拥有一个有效的Sponge账户才能在Ore上创建项目。如果没有账户,可以使用右上角的注册(Sign Up)按钮进行注册。如果你已经拥有Ore账号,点击登录(Log in)按钮来登录到Ore。

登录后,把鼠标移动到您的头像,在下拉菜单中点击 “New” (新建)选项,或按下C键。

上传时,新建向导会先要求上传主要文件,然后要求上传公钥。

在 Ore 上设置你的项目

在上传完插件后,你便可以按你的想法来对项目进行管理。不要担心,所有设定都可以随时在设置面板中修改。在建立你的项目之后,你可以邀请其他 Sponge 用户成为你项目的成员,即使他们从来没有登录过 Ore 也可以。在项目创建完成后,你邀请的用户将会收到通知,他们可选择接受或拒绝你的邀请。项目成员在接受邀请前对外不可见。

目前你可以将项目成员分成三组:开发者 (Developer) 、编辑者 (Editor) 、以及技术支持 (Support) 。创建项目的用户将自动成为所有者 (Owner) ,其访问该项目时不受任何限制。下面是对各个分组的功能的简介。

所有者

一个项目只可能有一个所有者,目前不可转让,且是唯一一位拥有指派项目中其他成员权限的人。

开发者

开发人员可以创建/编辑释放渠道、 页面和创建编辑版本。

编辑者

编辑者可编辑页面。

技术支持

技术支持无任何实质权限,仅用于标记项目成员。

使用 Pages 来托管你的项目文档

你可以利用 Ore 提供的 Pages 功能来为你的项目提供文档。在你新建项目之初,默认会为你生成一个 ‘Home’ 页面(即主页)。点击 Pages 界面右边的工具条上的 ‘+’ 图标即可新增页面;点击后会弹出一个窗口要求你指定页面名称和上一级页面(但不能在 Home 页的基础上新增页面)。如果你选择了 ‘<None>’,新的页面将会成为根页面,你可以随后在这个页面的基础上追加子页面。如果你指定了上一级页面,这个页面将只会在这个展开时显示。文档的撰写可以使用 CommonMark

页面之间的链接

如果你的页面有这样的树形结构:

  • Home

  • 命令
    • 用户(User)

    • Admin

  • 部署工作环境
    • Config

    • 权限

同时你想在你的主页中提供一个直达 Setup 页面下的 Config 页面的链接,你可以使用 WikiLinks 功能来做到这一点。WikiLink 的格式是这样的:[[Link]],也就是说,只要这样写:[[Setup/Config]],就会生成直达 Setup 页面下的 Config 页面的链接了。

备注

你还可以为链接提供自定义标题,标题与链接之间用管道符号(|)分开,即形如 [[Title|Link]],这样产生的链接就会显示为“title”。

备注

WikiLinks 只在 Ore 中有效,所以如果你在你的 Pages 主页中使用了 WikiLinks,在论坛里这些链接是无法正确显示的。尽管如此,我们仍然建议使用 WikiLinks 而不是普通链接,这样可以保证你的 Wiki 页面在未来能正常工作。

项目状态

在新建项目后,你会发现一个告知你项目处在“new”状态的状态条。这个状态用于告知用户和管理员:你还没有完全配置好你的项目。如果你已完成了插件的文档,并已确认所有内容均符合指南,点击“publish”按钮以完成配置过程。但是,如果你不手动点击发布的话,你的项目会在创建 24 小时后自动发布。

需要更改(Needs Changes)

Ore 的工作人员可以隐藏你的项目并要求更改,要求更改的内容会在状态条中列出。这个状态下,其他人不能看到你的项目。更改完成后,你可以发送审核请求。

需要审核(Needs Approval)

在这个状态下,你的项目仍然不对外界可见,工作人员会复查并确认所有要求的更改是否都已达到要求。这个时候请务必耐心等待,因为工作人员通常还身兼数职,不一定有时间。通过审核的项目会自动对外界可见。请务必确保你覆盖到了所有要求更改的点。