A simple HTTP client and quick embed generator that allows for easy sending of embeds to Discord channels using webhooks. The code is lightweight and easy to implement, setup, and use.
As a future update I'm gonna have this available on some Maven repo somewhere so you can use it in Maven as a dependency. Not to mention I also need to implement an absolute tonne of Javadoc into the files. I made this ages ago, time it needed a little reviving.
Create files of the same name in your package and copy the respective code into them. Add your package at the top of the files. Import the files into your main code file. In the Discord channel you wish to use, create a new webhook and copy the URL.
Firstly, initialise a new webhook instance by doing:
Webhook w = new Webhook("webhook URL");Replace webhook URL with the acutal webhook URL you wish to use. This should already be in your clipboard.
Next, you want to create your embed. At the moment, the code is in it's basic stages, so you can only add a title, description, and colour to your embed.
To make your embed, you must do the following:
Embed e = new Embed();What you just did here is initialise a new embed class.
Now what you can do is use the functions to add titles, description, and colour to the embed individually. You must have either a title or a description present in your embed, or else it will not work. Colour is optional. However, you can do this all within the initialisation itself, by doing:
Embed e = new Embed("Example Title","Example Description","hex colour without #");The functions for the class can be found below. Also note that the default colour, if not defined, is #2A002A. Which is a dark purple colour.
Once you've created your embed, you need to send it by doing:
w.send(e);Now you should see your embed in the channel.
While you can do all this line by line as I've done above, you can do this all in 1 line or more. For example, if I had multiple events that all send a different embed to the same channel, you can do put this as a child of the parent of the listeners:
Webhook w = new Webhook("url");Then have the seperate embeds inside each event as:
w.send(new Embed("title","description"));Another case would be only having to send one embed in the program. Ever.
new Webhook("url").send(new Embed("title","description"));This is a quick and easy one line to sending an embed.
new Webhook( String <Webhook URL> )Creates a new Webhook instance. String parameter of Webhook URL is required.
Webhook.send( Embed );This sends the embed to the already defined webhook url
new Embed( String <title>, String <description>, String <colour> )This creates a new Embed instance. Either title or description, or both, must be defined at some point into the instance or the code will not work. Colour should be a hexadecimal colour without the hashtag (#)
new Embed( String <title> )Creates a new Embed instance with only title defined. Methods to add description and colour can be used also. The title can also be redefined using the setTitle method.
new Embed( String <title>, String <description> )Creates a new Embed Instance with both title and description defined. Method to add colour can be used also. The title and description can also be redefined using the setTitle and setDesc methods.
Embed.setTitle( String <title> )Sets the title of an already initialised Embed instance.
Embed.setDesc( String <description> )Sets the description of an already initialised Embed instance.
Embed.setColour( String <colour> )Sets the colour of an already initialised Embed instance. Format must not include hashtag (#) of hexadeciaml colour.
(JSONObject) Embed.rtrn()Returns the JSONObject class of the embed. .toJSONString() method is also available here to have webhook appplication/json content-type usable body.
The colour will only set if the hex has no hashtag (#) and is 6 characters long. Anything other than that, it's dark purple until you get it right.
First of all, I don't care. Second of all, you didn't set a title or description. Get on with it.
Get your URL right. It should be inside quotation marks to make it a string.
The likely hood is that the response code from Discord was error code 400. This indicates that the body that was sent was malformed and not valid. The 1. cause for something like that is non-String data types attempting to be used in the title or description of the body. Another reason would be using a function (void) inside the title or description. You can't do that, it needs to be seperate into a String data type variable.