Spicord 2.1.0-SNAPSHOT

Discord integration for BungeeCord & Spigot/Bukkit servers.

  1. Sheidy
    Native Minecraft Version:
    1.14
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    Source Code:
    https://github.com/OopsieWoopsie/Spicord
    [​IMG]
    What is Spicord?
    Spicord is an API/Framework that is used to integrate your Minecraft server with Discord, can be used on servers running BungeeCord or Bukkit/Spigot.
    Spicord allows developers to create Addons which can be compatible regardless of the server software you use.


    Support: Discord

    Features

    This is the list of the current features that Spicord has:
    • Multi-bot support
    • Custom commands support
      • Different command prefix for each bot!
    • Addon support
      • Integrated simple addons (for testing the plugin)!
      • Independent addons for each bot!
    • Integrated easy-to-use API
    • Embed messages support
    • Optimized code
    • Compatible with Spigot/Bukkit
    • Compatible with BungeeCord
    • Spicord is open-source!

    Implementation (FOR DEVELOPERS)

    1. Creating an Addon
    Code (Java):
    // Example Addon
    package test;

    import eu.mcdb.spicord.api.addon.SimpleAddon;
    import eu.mcdb.spicord.bot.DiscordBot;

    public class ExampleAddon extends SimpleAddon {

        public ExampleAddon() {
            super(
                "Example Addon", // Addon name
                "my_example_addon", // Addon key
                "OopsieWoopsie" // Addon author
            );
        }

        @Override
        public void onLoad(DiscordBot bot) {
            // You don't need to put a command like "!example" or "-example", because the command prefix is configured apart.
            bot.onCommand("example", example -> {
                example.getMessage().getChannel()
                    .sendMessage("Hello world!")
                    .queue();
            });
        }
    }

    2. Registering the Addon

    Code (Java):
    // Example using the BungeeCord plugin API, you can use the Bukkit API if you want ^^
    package test;

    import eu.mcdb.spicord.Spicord;
    import net.md_5.bungee.api.plugin.Plugin;

    public class ExamplePlugin extends Plugin {

        @Override
        public void onEnable() {
            Spicord.getInstance().getAddonManager().registerAddon(new ExampleAddon()); // Register the addon
        }
    }

    3. Add Spicord as a dependency
    Probably your plugin.yml or bungee.yml file looks like this:
    Code (YAML):
    name: ExamplePlugin
    author
    : OopsieWoopsie
    version
    : 1.0
    main
    : test.ExamplePlugin

    It needs to have the depends section (or depend if you are using Spigot), like this:
    Code (YAML):
    name: ExamplePlugin
    author
    : OopsieWoopsie
    version
    : 1.0
    main
    : test.ExamplePlugin
    depend
    : [Spicord] # Add this line for Spigot
    depends
    : [Spicord] # Add this line for BungeeCord

    4. Using the Addon on your bot
    Your config.yml looks like this:
    Code (YAML):
    bots:
      default
    :
        command-support
    : true
        command-prefix
    : "-"
        token
    : "YOUR BOT TOKEN HERE"
        enabled
    : false
        addons
    :
        - "spicord::info"
        - "spicord::plugins"
        - "spicord::players"
    • You need to change "YOUR BOT TOKEN HERE" with your bot token, if you don't know how to do that, you should look at this tutorial.
    • Then, change the enabled option value to true.
    • By default, your addons section looks like this:
    Code (YAML):
      addons:
       - "spicord::info"
       - "spicord::plugins"
       - "spicord::players"

    To enable your addon on that bot you need to add the addon key to that list. Example:
    Code (YAML):
       addons:
        - "spicord::info"
        - "spicord::plugins"
        - "spicord::players"
        - "my_example_addon" # this is the addon key used on the example

    Note: The values starting with "spicord::" are the integrated Spicord addons, and can be disabled by removing them from the addons section.
    • When you start your server, the bot will start and the addons will be loaded.
    • So, our bot prefix by default is -, if we send the message -example to a channel who the bot can read, this will happen:
      [​IMG]
    • Enjoy doing cool stuff ^^
    Integrated addons
    Spicord has 3 integrated addons, they are:
    • Server Information (command: info)
    • Player List (command: players)
    • Plugin List (command: plugins)
    And that's how the commands look in operation:
    [​IMG]

    [​IMG]

    [​IMG]

    Note: Spicord uses Java Discord API, also known as JDA, you should take a look at that!

    Plugins supporting Spicord:



    Report issues here: Spicord issues

Recent Reviews

  1. Maybehhh
    Maybehhh
    5/5,
    Version: 2.1.0-SNAPSHOT
    (Feedback from discord)
    I really like this plugin i'am not really good in developing but [̲̅W̲̅н̲̅y̲̅!̲̅]
    Helped me. Download Its very good plugin
  2. Zoiter7
    Zoiter7
    5/5,
    Version: 2.1.0-SNAPSHOT
    Excellent work :D Works without problems, very nice idea and API. I will use your API soon for create some plugin. This plugin needs more downloads, not fair :)
    1. Sheidy
      Author's Response
      Thank you very much for this awesome review!
      Have a nice day awesome person :D
  3. Siebrenvde
    Siebrenvde
    5/5,
    Version: 1.1.0-SNAPSHOT
    Works like a charm!
    It's easy to use once you get used to it.
    I've got this set up on my server and have nothing to complain about.
    1. Sheidy
      Author's Response
      Thank you for your review! I'm glad you like it! ^^
  4. TwerkRekt
    TwerkRekt
    5/5,
    Version: 1.1.0-SNAPSHOT
    nice plugin =)
    cant you add a litebans ban announcer? pleas :D
    thanks -----------------
    1. Sheidy
      Author's Response
      (LiteBans support is for BanAnnouncer, not for Spicord)

      Yes, I have done it `` (not released yet)
      Probably tomorrow I will release it + something great :x

      Thanks for the review! <3
  5. Shiade
    Shiade
    5/5,
    Version: 1.1.0-SNAPSHOT
    Wonderful plugin! This is exactly what I needed, besides that the dev is active and very helpful! :)
    1. Sheidy
      Author's Response
      Thank you for the review! Have a good night! ^^
  6. Hanch28
    Hanch28
    4/5,
    Version: 1.0.4-SNAPSHOT
    Tengo una duda, bajo que comando tengo que poner los codigos de java. No explica al 100% como se hace
    1. Sheidy
      Author's Response
      El plugin actualmente no tiene ningún comando, el tutorial con "los codigos de java" son para programadores, ya que básicamente este plugin es una "API" con ejemplos incluidos para facilitar el desarrollo de complementos/addons.
  7. HypeeDraggy
    HypeeDraggy
    5/5,
    Version: 1.0.4-SNAPSHOT
    IT's JUST INCREDIBLE! YOU CAN ACTUALLY CONNECT YOUR MINECRAFT SERVER WITH YOUR DISCORD!
    1. Sheidy
      Author's Response
      Thank you! <3
  8. iTzMajjiK
    iTzMajjiK
    5/5,
    Version: 1.0.0-SNAPSHOT
    Buen plugin, va de maravilla sin duda cumple con sus expectativas, recomendado 100%
  9. ELPUPAS2015
    ELPUPAS2015
    5/5,
    Version: 1.0.0-SNAPSHOT
    Awesome plugin, that's exactly what I need for my server, and it's also very easy to use, thank you very much :D
  10. SantiXxPro
    SantiXxPro
    5/5,
    Version: 1.0.0-SNAPSHOT
    Muy bueno, lo he probado y la verdad funciona genial lo recomiendo..

    50 caracteres
    1. Sheidy
      Author's Response
      Gracias por tu review <3