https://github.com/gravendev/dj4h
https://github.com/gravendev/dj4h
Last synced: about 7 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/gravendev/dj4h
- Owner: GravenDev
- License: gpl-3.0
- Created: 2025-07-16T15:24:28.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2026-06-13T15:53:28.000Z (2 days ago)
- Last Synced: 2026-06-13T17:24:07.592Z (2 days ago)
- Language: Python
- Size: 411 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
DJ4H
This project is under the GNU GPL v3 license
#
`DJ4H`
All the projects in the AsyncCommunityDiscord organisation are used by the discord server
discord.gg/graven both by the moderators and the members.
Most of the contributors are part of the staff but the members are also allowed to contribute.
---
## Global information
| Global information | |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Description | DJ4H is a Discord bot designed to enhance server engagement. It includes features for tracking activity engagement, providing a dynamic and interactive experience for communities. |
| Collaborators | 
[Gamingdy](https://github.com/Gamingdy), 
[Lindwen](https://github.com/Lindwen), 
[Loïc R](https://github.com/Lramelot), 
[GabHas](https://github.com/TheRealGabHas) |
| Version | 1.0.0 |
---
## State
---
## About The Project
DJ4H is a Discord bot designed for the "4-hour Game" on the Async - Community server (formerly Graven - Développement).
Its primary purpose is to automate point counting.
Although designed for the Async - Community server, the bot can be used on other servers and can run on multiple servers
simultaneously.
DJ4H implements a competitive timing game called "The 4h Game". Players compete by sending messages in a designated
channel after a configurable delay period has passed since the last message.
## Features
- Automatic point counting
- Leaderboard image generation
- Player point management (set/view scores)
## Commands
Required command parameters are shown in brackets (`[required]`) while optional parameters are in parentheses (
`(optional)`).
### Configuration (Admin only)
| Command | Description |
| --- | --- |
| `/config [channel] [delay]` | Sets the game channel and the required delay to score a point. Time prefixes: `s` (seconds), `m` (minutes), `h` (hours), `d` (days). |
| `/set [member] [score]` | Sets a member's score to the specified value. |
| `/dump_log` | Retrieves the bot's log file. |
### Player
| Command | Description |
| --- | --- |
| `/leaderboard` | Displays an image with the top 10 players. |
| `/score` | Shows your own score. |
## Installation
### Prerequisites
- Python 3.9+
- Poetry (for dependency management)
### Steps
1. Clone the repository:
```bash
git clone https://github.com/AsyncCommunityDiscord/DJ4H.git
cd DJ4H
```
2. Install dependencies with Poetry:
```bash
poetry install
```
## Configuration
Create a `.env` file in the project root with the following variables:
```env
BOT_TOKEN=your_discord_bot_token
DEBUG_GUILD_ID=your_dev_server_id # Optional
DATABASE_PATH=dj4h.db # Optional, defaults to dj4h.db
```
- `BOT_TOKEN`: Your Discord bot token (required).
- `DEBUG_GUILD_ID`: Discord server ID for development (optional).
- `DATABASE_PATH`: Path to the SQLite database file (optional).
## Usage
### Development Mode
```bash
# Run the bot
poetry run python main.py
```
### Production Mode with Docker
```bash
# Build and run with Docker Compose
docker-compose -f compose-prod.yml up -d
```
### Development Mode with Docker
```bash
# Build and run with Docker Compose
docker-compose up -d
```
## Development
### Code Formatting
```bash
# Format code with Black
poetry run black .
```
### Project Structure
```
DJ4H/
├── main.py # Entry point
├── config.py # Configuration and logging
├── commands/ # Discord commands
│ ├── cogs/game.py # /leaderboard and /score commands
�� └── handler/events.py # Main game logic
├── utils/
│ ├── database/ # Database layer
│ │ ├── connection.py # SQLite connection
│ │ ├── schema.py # Data models
│ │ └── dao/ # Data Access Objects
│ └── image_generator.py # Image generation for leaderboard
└── docker/ # Docker configuration
```
## Database
The bot uses SQLite with three main tables:
- `guilds`: Server configuration (channel, delay).
- `users`: User scores per server.
- `messages`: Message tracking for game logic.
## Support
To report bugs or request features, please create an issue on the GitHub repository.