chore(docs): Add a README, license the project
This commit is contained in:
21
LICENSE
Normal file
21
LICENSE
Normal file
@@ -0,0 +1,21 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2022 Brett Bender
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
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