Publicar o teu Plugin

O repositório oficial de mods/plugins do Sponge, Ore, é um projeto gratuito e de código aberto onde qualquer um pode publicar o seu plugin ou mod Sponge.

Empacotar o teu Plugin

O Ore requer que todos os projetos sejam empacotados com um ficheiro de descrição mcmod.info na raíz do ficheiro JAR. Este ficheiro é utilizado para retirar, automaticamente, alguns detalhes do teu projeto para facilitar o processo de upload. O Ore rejeitará o teu plugin se não tiver este ficheiro no JAR. Felizmente, a SpongeAPI tem uma funcionalidade que cria este ficheiro automaticamente, durante a compilação, utilizando a anotação @Plugin que provavelmente já existe na classe main do teu plugin.

Nota

Para mais informação sobre como criar e compilar um plugin, vê Classe Main de um Plugin

Para referência, eis um exemplo do ficheiro 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]"
        ]
    }
]

No mínimo, cada projeto no Ore deve ter os campos modid, name e, version completos.

Enviar o teu Plugin

Once your plugin’s JAR file is packaged with an mcmod.info descriptor file in the top-level, it is ready for uploading! To create a project on Ore, you must have an active Sponge account. Hitting the «Sign up» button in the top-right corner will take you to the appropriate page to create one. If you already have an account, just hit the «Log in» button in the top-right corner to log into Ore.

Assim que tiveres sessão iniciada, navega para o teu avatar e seleciona a opção «New» no menu que aparece, ou carrega simplesmente na tecla «C».

Durante o processo de envio, o Ore pede primeiro o ficheiro principal de envio, e logo depois a tua assinatura separada.

Configurar o teu projeto no Ore

Depois de enviares o teu plugin, ser-te-hão apresentadas algumas opções para configurares o teu projeto ao teu gosto. Não te preocupes, todas essas definições podem, mais tarde, ser alterada no painel de definições. Depois de configurares o teu projeto, poderás convidar outros utilizadores do Sponge para serem uma parte dele. Qualquer utilizador que esteja registado nos fóruns pode ser convidado para i, projeto, mesmo que nunca tenham iniciado sessão no Ore. Assim que o projeto é criado, esses utilizadores convidados receberão uma notificação e poderão aceitar ou rejeitar o teu convite. Os membros de um projeto não serão visíveis para o público até que aceitem o respetivo convite.

Neste momento, há três grupos que podes atribuir aos membros do teu projeto: «Desenvolvedor», «Editor» e «Suporte». O utilizador que criou o projeto terá o grupo «Dono», e tem acesso ilimitado ao projeto. Eis uma breve explicação do que cada grupo pode fazer no projeto.

Proprietário

Cada projeto tem um e só um proprietário. Este papel não é transferível (para já), e é o único grupo que pode dar cargos a outros membros.

Desenvolvedores

Os desenvolvedores podem criar/editar release channels, páginas e criar/editar versões.

Editor

Os editores podem editar páginas.

Suporte

Os membros do suporte não podem fazer nada. Esta é meramente uma forma de mostrar que estes membros fazem parte do projeto.

Escrever Documentação para o teu Projeto com as Pages

O Ore oferece a criação de páginas para documentares o teu plugin. Por predefinição, o Ore cria-te uma página “Home” quando crias um novo Projeto. Para adicionares novas páginas, podes carregar no “+” na barra das páginas, na parte direita do screen; fazê-lo abrirá um pop-up onde podes escolher um nome e a página-pai (adicionar uma página na página Home não é possível). Se escolheres a opção “<None>”, a página será uma página de raiz, à qual poderás adicionar páginas-filhas. Se escolheres adiconá-la a outra página, esta só será mostrada quando a página-pai por expandida. Podes escrever as tuas páginas em CommonMark.

Linkar Páginas

Se tiveres a seguinte árvore de estrutura nas tuas páginas:

  • Página inicial

  • Commands
    • User

    • Admin

  • Setup
    • Config

    • Permissions

E tu queres adicionar um link à Home Page que aponte para a página Config, que pertence a Setup. Para isso, podes usar WikiLinks. Para adicionares um WikiLink, usa o formato [[Link]]. Ou seja, na Home Page podes escrever [[Setup/Config]] e isto será convertido num link que é garantido funcionar.

Nota

Também podes especificar um título para o link e separá-lo com o símbolo Pipe, de modo que [[Title|Link]] será um link com o título Title.

Nota

Os WikiLinks só são suportados no Ore, por isso, se os usares na Home-page, eles não serão corretamente mostrados nos fóruns. Ainda assim, recomendamos que uses WikiLinks em vez de links normais por forma a garantires que a tua wiki continua a funcionar no futuro.

Estados de Projetos

Quando crias um novo projeto, aparecerá um banner a indicar-te que o projeto está no estado “new”. Este estado serve para indicar aos utilizadores e administradores que ainda estás a trabalhar na configuração do teu projeto. Se já acabaste de documentar o teu plugin para que fique de acordo com as diretrizes, clica no botão “publish” para completares o processo. No entanto, se não publicares manualmente o teu projeto, ele será automaticamente publicado 24 horas após a sua criação.

Precisa de alterações

A staff do Ore pode esconder o teu projeto e pedir modificações; as alterações em questão estarão listadas no banner. Este estado esconderá o teu projeto do público; se já terminaste, podes enviar o teu projeto para aprovação.

Precisa de aprovação

Neste estado, o teu projeto ainda está escondido do público enquanto se espera que um membro do staff reveja e valide as alterações que foram solicitadas. Por favor, sê paciente, os membros da staff podem estar ocupados com outras tarefas. Se o projeto for aprovado, tonar-se-á imediatamente visível novamente. Por favor, certifica-te de que realmente corriges os pontos que exigem mudanças.