chore(docs): Add a README, license the project
This commit is contained in:
47
README.md
Normal file
47
README.md
Normal file
@@ -0,0 +1,47 @@
|
||||
<h1 align="center">IEEEvents Bot</h1>
|
||||
<p align="center"><i>Made with :heart: by <a href="https://github.com/GreatGodApollo">@GreatGodApollo</a></i></p>
|
||||
|
||||
A Discord bot that mirrors events from an iCal file to Discord, and allows users to browse them
|
||||
|
||||
## Important Note
|
||||
The bot does not yet clone the events from iCal to Discord, rather it only currently implements a command to view the events. This is a limitation of using JDA 4.x instead of the newest JDA 5.x branch. Once JDA 5.x is stable, the bot will clone the events.
|
||||
|
||||
## Built With
|
||||
|
||||
- [sksamuel/hoplite](https://github.com/sksamuel/hoplite)
|
||||
- [ical4j/ical4j](https://github.com/ical4j/ical4j)
|
||||
- [DV8FromTheWorld/JDA](https://github.com/DV8FromTheWorld/JDA)
|
||||
- [Litote/kmongo](https://github.com/Litote/kmongo)
|
||||
- [junodevs/kriess](https://github.com/junodevs/kriess)
|
||||
- [qos-ch/logback](https://github.com/qos-ch/logback)
|
||||
- [square/okhttp](https://github.com/square/okhttp)
|
||||
- [ronmamo/reflections](https://github.com/ronmamo/reflections)
|
||||
- [snakeyaml/snakeyaml](https://github.com/snakeyaml/snakeyaml)
|
||||
|
||||
## Usage
|
||||
### Build it!
|
||||
I use the Gradle build system, so getting all the dependencies and building the jar should be as easy as:
|
||||
|
||||
`./gradlew clean shadowJar`
|
||||
|
||||
### Run it!
|
||||
On the first run of `$ java -jar build/lib/IEEEventsBot*.jar` it'll automatically copy an example config.yml for you. From there, change the values to be relevant for you. After you have it fully configured, run the bot again with `java -jar build/lib/IEEEventsBot*.jar` and invite the bot to your server!
|
||||
|
||||
### All together
|
||||
```bash
|
||||
# Build the .jar file
|
||||
$ ./gradlew clean shadowJar
|
||||
# Run the bot for the first time (will stop right away)
|
||||
# Will place a new config.yml in your directory - replace with your values
|
||||
$ java -jar build/lib/IEEEventsBot*.jar
|
||||
# Actually run the bot this time
|
||||
$ java -jar build/lib/IEEEventsBot*.jar
|
||||
```
|
||||
|
||||
## Licensing
|
||||
|
||||
This project is licensed under the [MIT License](https://choosealicense.com/licenses/mit/)
|
||||
|
||||
## Authors
|
||||
|
||||
* [Brett Bender](https://git.brettb.xyz/apollo/)
|
||||
Reference in New Issue
Block a user