https://github.com/dgw/sopel-unobot
Play UNO on IRC with the help of your Sopel bot!
https://github.com/dgw/sopel-unobot
game hacktoberfest irc irc-bot sopel sopel-modules sopel-plugin
Last synced: 2 months ago
JSON representation
Play UNO on IRC with the help of your Sopel bot!
- Host: GitHub
- URL: https://github.com/dgw/sopel-unobot
- Owner: dgw
- License: other
- Created: 2015-07-11T03:58:55.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2022-01-13T08:15:01.000Z (over 3 years ago)
- Last Synced: 2025-03-25T14:03:27.619Z (3 months ago)
- Topics: game, hacktoberfest, irc, irc-bot, sopel, sopel-modules, sopel-plugin
- Language: Python
- Homepage:
- Size: 173 KB
- Stars: 3
- Watchers: 3
- Forks: 3
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# sopel-UnoBot
Play UNO on IRC with the help of your Sopel bot!
## Origins
Original code from [http://tmarki.com/wp/2010/02/18/irc-uno-bot-for-phenny/][src-wayback] licensed under the
FreeBSD / BSD 2-clause license and copyright Tamás Márki.
Code has been archived as a gist by the original author: https://gist.github.com/tmarki/b4b185db7883a2f14a8580be2f5bff4b
The original code was itself a port of a mIRC script, probably the one found at http://hawkee.com/snippet/5301/
There is also an unobot.py version maintained within the @myano/jenni repo, but it is as different from this version
as this version is from the code it was built on. A few ideas from that repo may make their way into this one at some
point, but most of the development here up to now was done before discovering the other fork.
[src-wayback]: https://web.archive.org/web/20150923230822/http://tmarki.com/wp/2010/02/18/irc-uno-bot-for-phenny/ (Web Archive of source blog post)
## Changes
This fork includes (but is not limited to including) the following updates:
* Players can now leave a game in progress.
* Players can also be kicked from a game in progress by the owner or a bot admin if necessary.
* The bot saves the hands of players that leave a game in progress until that game is over, to prevent players with
large hands from simply doing a quit/join cycle to get back down to 7 cards.
* Added `unohelp` command for new players to learn the basics of gameplay and use of many UNO commands not included in
Sopel's `commands` list to keep from polluting it too much.
* Added `cards` command for players to have the bot send them their hand again in case they were in another channel
when their turn came and the notice was therefore sent to the wrong window.
* The module now supports a game in each channel, rather than being limited to playing UNO in only one channel.
* Games can be moved from channel to channel, as well, by the game owner or a bot admin, so as to allow a flourishing
discussion in a channel where UNO is being played to continue uninterrupted while the game moves elsewhere.
* The bot owner can query for a list of channels in which UNO games are running (useful as preparation for updates,
bot server maintenance, etc.).
* Score saving uses JSON objects instead of hardcoded format strings. While less compact, it is much more easily
understood by a human reader, and is easier for the bot owner to edit if corrections are needed.
* The "top 10" list has been renamed from `unotop10` to `unotop` and only displays five (5) entries to reduce spam to
the channel.
* Use new decorators from Phenny's successor, Sopel (formerly known as Willie).
— see #sopel @ freenode. This project was formerly known as willie-UnoBot and was renamed to match the bot upon being
updated to support the new version.
* Updated syntax to take advantage of new bot framework features.
* For example, the bot no longer fails to recognize `play` commands that contain extra whitespace between the arguments.
## Licensing
Parts of this project are covered by the Simplified BSD / FreeBSD / BSD 2-clause license. However, much of it has not
yet been declared licensed. See the LICENSE.md file for details.