CodeZero is a Discord bot developed in JavaScript, utilizing the discord.js client library along with a lightweight web server for GitHub OAuth authentication. This enables certain commands, such as retrieving commit and pull request data.
-
HTTP Port: Required for GitHub OAuth, configured via
http-config.portin./http-config.json. -
MongoDB: Used for storing user and bot-related data, including:
- XP statistics
- Message count statistics
- Command usage data
- Flags
| Command | Status | Known Bugs | |
|---|---|---|---|
| 1 | /open-contributer |
Finished | None |
| 2 | /links |
Finished | None |
| 3 | /contributor |
Finished | None |
| 4 | /rank or /rank @user +uptodate15 |
Finished | None |
| 5 | /leaderboard or /leaderboard limit: 1-20 |
Finished | None |
| 6 | CodeZero Application Channel Threads |
Finished | None |
| 7 | /stats or /stats @user + uptodate15 |
Finished | None |
| 8 | /logs show or /logs list |
Finished | None |
| 9 | /debug for debugging |
Finished | None |
| 10 | /git display charts of Git activity |
1/2 Finished | None |
| 11 | /mydata return your current MongoDb entry |
Finished | None |
| 12 | /settings change discord server settings |
Missing Func. | None |
| Function | Status | Known Bugs | |
|---|---|---|---|
| 1 | Stats and Xp from sent messages | Finished | None |
| 2 | Voice Stats | Finished | None |
| 3 | Event prereminder | Finished | None |
| 4 | Channel Auto Slowmo | Finished | None |
| 5 | Git rank + Chart everyday | Finished | None |
| 6 | Invite Tracker | Finished | None |
We currently provide 3 languages
- german.json
- english.json
- lolcat.json (custom version)
Made by using the inbuild web editor...
Run it via npm run editor then visit http://localhost:3000 via a browser
Note: If a german key for translation is missing, the bot will fallback to english
The bot collects and processes certain statistics, as visible in the source code:
- Message Statistics: Number of messages, words, and characters sent.
- Voice Statistics: Join/leave events, channel switches, and total voice time.
For /open-contributer, OAuth URLs are not stored. This means authentication is required each time the command is executed.
Real Example:
{
"id": "380808844093292555",
"rawxp": 1921,
"stats": {
"messages": {
"words": 4939,
"chars": 25152,
"count": 1071
},
"voice": {
"joins": 131,
"switchs": 21,
"time": 169602
},
"invites": {
"total": 0,
"real": 0,
"usersInvited": [
{
"id": "703586032578199641",
"time": {
"$numberLong": "1765912177218"
}
}
]
}
},
"commandstats": {
"debug": {
"command": 85,
"button": 22,
"selectmenu": 15
},
"leaderboard": {
"command": 25
},
"stats": {
"command": 81
},
"logs": {
"command": 35,
"button": 98
},
"logs list": {
"selectmenu": 25
},
"links": {
"command": 2
},
"open-contributor": {
"command": 12
},
"mydata": {
"command": 13
},
"git": {
"autocomplete": 257,
"command": 129
},
"logs show": {
"button": 8
},
"ticket": {
"command": 7,
"button": 13
},
"_application": {
"button": 19
},
"rank": {
"command": 92
},
"settings": {
"command": 35,
"selectmenu": 60,
"button": 16
},
"contributor": {
"command": 1
}
},
"flags": {
"invitesGiftReceived": false
}
}Last MongoDB structure update: 20.12.2025
Tip: You can mention a Discord user by their ID using <@user_id>.
This repository mirrors the live bot but excludes sensitive or unnecessary files:
node_modules/– Not included (use npm install to generate).server.env / .env– Contains private configuration and tokens.unused-temp.js– Unused code snippets, kept for reference.a-workon/– Work-in-progress features..gitignore– Specifies ignored files.
💡 If you need a setup template, feel free to contact me on Discord: [DC: nixkuchen].
Currently, no official documentation is available. However, you can explore the bot’s functionality yourself or contact [DC: nixkuchen] for guidance.
Files located in ./_app/* are for Discord server setup (e.g., images).
The bot is fully functional with the following package versions:
"@discordjs/voice": "^0.18.0" // [20.12.2025]
"chartjs-node-canvas": "^5.0.0" // [20.12.2025]
"discord-simpletable": "^1.1.6" // [20.12.2025]
"discord.js": "^14.25.1" // [20.12.2025]
"dotenv": "^17.2.3" // [20.12.2025]
"libsodium-wrappers": "^0.7.15" // [20.12.2025]
"mongo": "^0.1.0" // [20.12.2025]
"node-fetch": "^2.6.12" // [20.12.2025] (@latest 3.3.2)
"node-schedule": "^2.1.1" // [20.12.2025]
"puppeteer": "^23.11.1" // [20.12.2025] (@latest 24.34.0) - is currently not used and already outdatedTips:
- Run
npm outdatedto check which packages can be updated - Run
npm update <package-name>to update a single package
or use the build in script
- npm run outdated
wip– Work in progress.todo– Task that needs to be completed.readme– README updates.naming– Renaming constants, variables, or text.v/version– Version updates in package.json.
- uptodate15: This means the message will be updated when changes occur up to 15 more minutes after the interaction execution.
Software is always evolving, and CodeZero is no exception. Here’s why code may sometimes appear incomplete or unpolished:
- Rapid Development: The goal is to ensure functionality first.
- Changing Requirements: Features are frequently adjusted to meet new needs.
- Ongoing Refinements: Code is continuously improved for efficiency and maintainability.
- Organized Messiness: While some sections may seem unstructured, they function correctly. Any outstanding issues are documented in TODO (index.js).
- Fast-Paced Changes: In the early stages, speed often takes priority over perfection.
Since CodeZero is actively in development, expect ongoing improvements and changes.
0.0.1– Minor bug fixes or small functional improvements.0.1.0– Command modifications or updates that impact functionality.1.0.0– Major changes affecting class structures and breaking compatibility.
💡 This system has been in use since 10.07.2024, but earlier commits may not follow it consistently.
- 📱 Mobile UI Bug: Tables, charts and Progress Bar's do not display correctly on mobile devices, but there are currently no plans to fix it soon, and it may remain unresolved indefinitely (Reported: 01.01.2025).