Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dpeta/randomencounter

A simple bot for IRC/Pesterchum servers to serve the same functionality as the original randomEncounter bot.
https://github.com/dpeta/randomencounter

homestuck irc irc-bot pesterchum

Last synced: about 1 month ago
JSON representation

A simple bot for IRC/Pesterchum servers to serve the same functionality as the original randomEncounter bot.

Awesome Lists containing this project

README

        

# Pesterchum Random Encounters Bot
Random encounters for Pesterchum, now with asyncio :3c

Requires at least Python ``3.10``.

The Pesterchum client can only do random encounters if this bot or an equivalent bot is present on the connected IRC server.

Run with ``python3 randomEncounter.py`` or simply ``./randomEncounter``.

Run once to generate config/token file, hostname only needs to be included when using SSL.

## Protocol
- Responds to ``NOTICE !`` with ``NOTICE !=randomUser`` , the notice is what Pesterchum uses to do random encounters. (Pesterchum user clicked "Random Encounter" )
- Responds to ``NOTICE -`` with ``NOTICE -=k``, the sender is excluded from further random encounters. (User turned off random encounters.)
- Responds to ``NOTICE +`` with ``NOTICE +=k``, the sender is removed from the exclude list if present. (User turned on random encounters.)
- Responds to ``NOTICE ~`` with ``NOTICE ~=k``, the sender is excluded from further random encounters. (User is AFK.)
- Responds to ``NOTICE +`` with ``NOTICE +=k``, the sender is removed from the idle exclude list if present. (User is no longer AFK.)
- Responds to all incoming ``PRIVMSG`` with a random user.
- Responds to ``PRIVMSG #pesterchum GETMOOD randomEncounter`` with ``PRIVMSG #pesterchum MOOD >18``.