Add README and Gemfile
This commit is contained in:
parent
574cc2d77d
commit
cd00a6a150
2 changed files with 70 additions and 0 deletions
5
Gemfile
Normal file
5
Gemfile
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
# frozen_string_literal: true
|
||||||
|
|
||||||
|
source 'https://rubygems.org'
|
||||||
|
gem 'matrix_sdk', '~> 2.0'
|
||||||
|
gem 'faraday', '~> 1.0'
|
65
README.md
Normal file
65
README.md
Normal file
|
@ -0,0 +1,65 @@
|
||||||
|
# Chronicle
|
||||||
|
|
||||||
|
Chronicle is a multi-purpose chat bot.
|
||||||
|
|
||||||
|
It currently supports Matrix, but has ambitions of supporting Discord in the
|
||||||
|
future.
|
||||||
|
|
||||||
|
Chronicle is still heavily work-in-progress, and the hobby of an occasionally
|
||||||
|
productive fellow.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Ping (returns Pong!; good for testing connectivity)
|
||||||
|
- Dice Roller (`!roll 2d4` -> `Roll: 2d4 ([2, 1]) ==> 3`)
|
||||||
|
- Ad-hoc simple custom commands (`!addcommand hello Hey there!` --> `!hello` -->
|
||||||
|
`Hey there!`)
|
||||||
|
- More to come!
|
||||||
|
|
||||||
|
## Planned Features
|
||||||
|
|
||||||
|
- [ ] 8-ball (`!8ball Will I win the lottery?` --> `Try again later`)
|
||||||
|
- [ ] Simple calculator (`!calc 8 + (9-10)` --> `Calc: 8 + (9 - 10) ==> 7`)
|
||||||
|
- [ ] Simple games (Blackjack, High/Low)
|
||||||
|
- [ ] A "mystery" game (Kind of like _Clue!_ or _Noir Syndrome_)
|
||||||
|
- [ ] A "progress quest" like game (time-based character auto-progression)
|
||||||
|
- [ ] Expanded custom commands (allow for commands with arguments)
|
||||||
|
- [ ] Enabling of add-on features (ie., everything mentioned above) per room
|
||||||
|
- [ ] Establish/restrict command permissions per user/role per room.
|
||||||
|
- [ ] Change the command prefix (from default `!` to whatever you'd like!)
|
||||||
|
- [ ] Run in a Docker container!
|
||||||
|
|
||||||
|
# Development
|
||||||
|
|
||||||
|
You can run your own instance of Chronicle with a few steps:
|
||||||
|
|
||||||
|
1. Fork the repository, and clone it locally
|
||||||
|
2. Setup a bot user in Matrix, and get it's "Access Token" (or use your own).
|
||||||
|
3. Export the access token to CHRONICLE_ACCESS_TOKEN for ease of use
|
||||||
|
4. Run `bundle update` to install dependencies.
|
||||||
|
5. Run `bundle exec chronicle -d <your-homeserver-address-here>
|
||||||
|
<access-token-here>`
|
||||||
|
6. Invite the bot user to a room, and `!ping` to make sure it's working!
|
||||||
|
|
||||||
|
# Contribute
|
||||||
|
|
||||||
|
If you are interested in contributing to Chronicle, first let me say thanks!
|
||||||
|
Next, please follow these steps:
|
||||||
|
|
||||||
|
1. Fork the repository, and perform any changes you'd like.
|
||||||
|
2. Submit a pull request, explaining the changes.
|
||||||
|
3. Work with me to get those changes merged.
|
||||||
|
|
||||||
|
Chronicle is a hobby project, and as such I may not be immediately responsive to
|
||||||
|
any requests. Please do not be discouraged! I will try to address any issues or
|
||||||
|
pull requests in a reasonable time.
|
||||||
|
|
||||||
|
# Issues
|
||||||
|
|
||||||
|
If you find something amiss with Chronicle, please submit an issue! I will try
|
||||||
|
to address it in a reasonable time.
|
||||||
|
|
||||||
|
# Contact
|
||||||
|
|
||||||
|
If you're interested in discussing Chronicle, you can speak with me on Matrix!
|
||||||
|
I'm [Vagabond](https://matrix.to/#/@vagabondazulien:exp.farm).
|
Loading…
Reference in a new issue