Empire-Plugin-Registry

Starkiller's plugin marketplace is backed by plugin registries. In particular, it defaults to this repository as the primary registry.

To submit a plugin, open a PR updating registry.yaml with the new plugin.

To add new versions of a plugin, open a PR updating the versions list in the plugin's entry.

ref must point to an immutable git commit, not a branch or tag.

Example:

  - name: Example Plugin
    homepage_url: https://github.com/bc-security/example-plugin
    source_url: https://github.com/bc-security/example-plugin
    authors:
      - name: John Doe
        handle: "@johndoe"
        link: "https://github.com/johndoe"
    description: |
      A sample Empire plugin that demonstrates the plugin architecture.
      Includes example stagers, listeners, and modules to help developers
      get started with plugin development.
    versions:
      - name: '1.0.0'
        git_url: https://github.com/BC-SECURITY/example-plugin
        ref: 'abcdefg1234567'

Hosting your own registry

You can host your own plugin registry by creating a repository with a registry.yaml file. The schema for this file is documented in here

To add your custom registry, add it to the plugin_registries block in Empire's config.yaml.