2026-03-01 20:40:29 +00:00
2026-03-01 20:40:29 +00:00
2020-08-25 22:23:16 -07:00
2026-02-21 22:25:47 +00:00
2020-01-15 17:42:49 -08:00
2026-02-21 22:25:47 +00:00
2026-02-28 22:35:17 +00:00
2026-02-21 22:25:47 +00:00

PointsBot

Overview

PointsBot is a Reddit bot that monitors posts in a subreddit, awards points to users who solve problems, and updates their flair to reflect their achievement levels. When the original poster marks a comment as solved (e.g., by replying "!Solved"), the bot awards a point to the solver, tracks their progress, and notifies them with a reply comment. Points accumulate to unlock new levels, and progress is visually represented with stars and progress bars.

Features

  • Monitors subreddit posts for solutions
  • Awards points to users whose comments are marked as solved
  • Updates user flair based on their point level
  • Notifies users of their progress and next level
  • Prevents awarding points to moderators
  • Consolidates points into stars for easier progress tracking

Installation (Docker Compose)

Prerequisites

(Easy) Use a prebuilt image

  1. Create a docker-compose.yml file in your chosen directoy, with the following contents:
   services:
     pointsbot:
       image: slfhstd.uk/slfhstd/pointsbot:latest
       container_name: pointsbot
       volumes:
         - ./data:/root/.pointsbot
       restart: unless-stopped
  1. Configure the bot:

    • Pre-create the config file using the sample config.
  2. Start the bot:

    docker-compose up -d
    

(Advanced) Build your own image

  1. Clone this repository:

    git clone https://slfhstd.uk/slfhstd/PointsBot.git
    cd PointsBot
    
  2. Create a docker-compose.yml file in the project root with the following content:

    services:
      pointsbot:
        build: .
        container_name: pointsbot
        volumes:
          - ./data:/root/.pointsbot
        restart: unless-stopped
    
  3. Configure the bot:

    • Pre-create the config file using the sample config.
  4. Build and start the bot:

    docker-compose up --build -d
    

Usage

  • The bot will run in the background and monitor your subreddit.
  • Configuration and logs are stored in the .pointsbot directory.
  • To stop the bot:
    docker-compose down
    

License

MIT License. See LICENSE.md for details.

Credits

Original author: Collin U. Rapp (u/GlipGlorp7)

Description
A reddit bot to keep track of a user’s solves and update their flair accordingly.
Readme 148 KiB
Languages
Python 99.2%
Dockerfile 0.8%