Criando um Addon

Software necessário: editor de texto, Chrome.
Se possível, desabilite a extensão Scratch Addons que você baixou da loja antes de continuar para evitar problemas.

If you plan to submit the addon you are developing as a pull request to our GitHub repository, please read our contributing guidelines first.

In case there is no existing GitHub issue in that repository related to your new addon idea, please create one. However, if there is already an issue related to your feature idea, we suggest that you leave a comment on it stating your intention to develop the addon. This will enable other contributors to provide feedback on whether the addon could be accepted, or if further discussion is required.

However, if you are creating an addon for personal use, you may proceed with this guide.

Passo 1: Leia sobre os básicos de um addon

Leia aquele artigo para se familiarizar com a terminologia.

Step 2: Fork/clone the repo

Follow these instructions to download the source code locally.

Passo 3: Carregue a extensão no Chrome

Note: Chrome is recommended for working on addons. Nevertheless, addons are expected to work on Firefox and Edge.
Now that you have the extension in your filesystem, go to chrome://extensions and toggle “developer mode”.
Click “load unpacked”, then select the folder where Scratch Addons is located. If you’re having issues with this, make sure to be selecting the folder where manifest.json is located.
That’s it, you loaded the extension! It should look similar to this:

Note: you can safely ignore it says “errors”. That’s just a warning for an unrecognized manifest key that’s required by Firefox.

Passo 4: Seu addon é sobre o quê?

Agora chegou a parte divertida!
O que o seu addon vai fazer? Pense em um ID descritivo para o seu addon (sem espaços ou caracteres especiais, exceto hifens).
Entendeu?

Passo 5: Crie a pasta do seu addon

Usando um explorador de arquivos, vá para a pasta do Scratch Addons no seu computador. Abra a pasta addons.
Então, crie uma nova pasta com o nome do ID do seu novo addon super épico.

Passo 6: Adicione um manifest pro addon

O manifest do addon diz ao Scratch Addons como o seu addon funciona. Pra evitar dor de cabeça no futuro, tente deixar as informações todas certas desde o início.
Nessa pasta que você criou, crie um arquivo addon.json.
Essa é uma base que você pode usar para começar a produzir, lembre-se de mudá-la no futuro:

{
  "name": "Nome do meu addon epicamente épico",
  "description": "Olá mundo! Seria uma boa ideia trocar esse texto por uma descrição de verdade.",
  "tags": ["community"],
  "enabledByDefault": false
}

Para mais informações sobre o que você pode colocar nesse manifest, veja este artigo.

Passo 7: Diga ao Scratch Addons qual o ID do seu addon

O Scratch Addons não consegue achar novas pastas sozinho, então você precisa adicionar o nome da pasta a um arquivo especial.
Vá para scratchAddonsFolder/addons/addons.json e adicione o ID do seu addon à lista.

Passo 8: Olá mundo

Por enquanto seu addon não faz nada, então é uma boa hora para checar se tudo que fizemos até agora funcionou.
Vá para chrome://extensions e recarregue o Scratch Addons clicando no símbolo de recarregar em seu painel. Agora, clique com o botão direito no ícone do Scratch Addons e clique em “opções”.
Seu addon vai aparecer na lista! Quando você achá-lo, ative-o, e mude quaisquer opções que você tiver.

Passo 9: A parte legal, o código!

Antes de continuar, leia o artigo da wiki linkado no passo 1.

Agora chegou a melhor parte: crie seus próprios arquivos JS ou CSS!
Dica: depois de mudar qualquer coisa no seu addon, lembre-se de recarregar a extensão do Scratch Addons assim como no passo 8.

Dependendo do que você quer que o seu addon faça, você deve ler essas páginas da wiki:

Passo 10: Deixe seu addon customizável

Se você quiser, pode deixar o seu addon customizável!
Usuários do seu addon poderão mudar configurações, digitar números, e mais!
Para começar, veja como declarar opções no manifest do addon. Então, vá para a documentação do addon.settings para aprender como acessar as opções do usuário em userscripts.

Passo 11: Antes de publicar o seu addon

Agora que o seu addon funciona, vamos checar se podemos adicioná-lo à biblioteca de addons.
Cheque o manifest do seu addon para ver se está bom, mais informações aqui. Preste atenção no nome, descrição e tags do seu addon. Lembre-se de deixar "enabledByDefault" marcado como false ou de só removê-lo.

Veja se o seu addon não causa problemas em outros addons.
Veja se o seu código é inteligível; é melhor ter comentários desnecessários do que nenhum.

Passo 12: Mande um pull request!

Follow the steps on our contributing guidelines. Simply put, fork the repo if you haven’t already, commit your new addon and send a PR!
Keep in mind we might request you to make some changes, however, we will probably accept your addon as long as it’s minimally suitable.