v13-all-bots 

Note: This repository is a collection of Discord bots (Discord.js v13 based) and related server assets. The original repo contains a Turkish README. This English README is a complete, detailed, and Ubuntu-focused guide for developers who want to install, configure, and run the bots.

---

Table of Contents

1. Project Overview
2. File & Folder Structure
3. Prerequisites
4. Ubuntu Installation Guide
5. Configuration
6. Running the Bots
7. Development & Structure Notes
8. Troubleshooting
9. Security & Ethics
10. Contributing
11. License & Credits

---

Project Overview

This repository collects multiple Discord bots written with Discord.js v13. The project is designed to be run in a server environment (preferred OS: Ubuntu 22.04 or higher) with a local MongoDB instance. Each bot resides under the /Server directory, while shared configurations and global modules are stored under /Global.

The main configuration file for system-wide settings is located here:

/Global/Settings/system.json

This file defines critical values for the bots such as:

• Database connection details
• API tokens
• Prefixes and default values
• Other global configuration parameters

---

File & Folder Structure

v13-all-bots/
│
├── Global/                # Shared settings and utilities
│   └── Settings/
│       └── system.json    # Main configuration file
│
├── Server/                # Contains the actual bot implementations
│   ├── Bot1/
│   ├── Bot2/
│   └── ...
│
├── Assets/                # Static files, images, or emoji packs
├── ecosystem.config.js    # PM2 process manager configuration
├── package.json           # Node.js dependencies and scripts
├── package-lock.json
└── LICENSE

---

Prerequisites

Before installing, ensure the following:

• Ubuntu 22.04 LTS or higher (recommended)
• Node.js (LTS version, 17.x or 20.x)
• npm (comes with Node.js)
• Git
• MongoDB (local server instance, required)
• PM2 (for production process management)

---

Ubuntu Installation Guide

Follow these steps on a fresh Ubuntu 22.04+ server:

1. Update and install system dependencies

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

2. Install Node.js & npm

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Verify installation:

node -v
npm -v

3. Install MongoDB (local instance)

sudo apt install -y mongodb
sudo systemctl enable mongodb
sudo systemctl start mongodb

Verify MongoDB is running:

sudo systemctl status mongodb

4. Install PM2 (optional, for production)

sudo npm install -g pm2

5. Clone the repository

git clone https://github.com/acarfx/v13-all-bots.git
cd v13-all-bots

6. Install project dependencies

npm install

---

Configuration

The main configuration is stored in:

/Global/Settings/system.json

Open this file and fill in values such as:

{
  "SERVER": {
    "ID": "Sunucu ID (Server ID)",
    "Name": "",
    "Install": false
  },
  "PACKAGE": {
    "Type": "FULL",
    "Name": "Ruby VIP+",
    "Desc": "Bu paket tüm özellikleri ve tüm sistemleri kapsamaktadır.",
    "Status": true,
    "Price": 1000,
    "StartAt": 1664856195288,
    "LastPayment": 1666581165742,
    "Payments": [
      {
        "Id": 1,
        "Price": 1000,
        "Type": "FULL",
        "Date": 1664856195288,
        "Payment": "BAŞLANGIÇ"
      }
    ]
  },
  "TOKENS": {
    "Statistics": "",
    "Voucher":"",
    "SYNC": "",
    "CONTROLLER": "",
    "SECURITY": {
      "MAIN": "",
      "SEC_ONE": "",
      "SEC_TWO": "",
      "DISTS": []
    },
    "WELCOME": {
      "Active": false,
      "WELCOMES": [],
      "WELCOME_CHANNELS": []
    }
  },
  "botSettings": {
    "Prefixs": [
      ".",
      "+",
      "!",
      "/",
      "-",
      "?",
      "="
    ]
  },
  "Webclient": {
    "clientID": "994580677670477915",
    "secret": "I-k7cVzwuMIGNnHyhC4nrL3TBk1n_tnQ",
    "callbackURL": "http://91.151.83.169:4939/callback"
  },
  "botStatus": {
    "Status": "dnd",
    "Name": "xd ⚚ Creatéd by ΛCΛR"
  },
  "Database": {
    "Active": true,
    "MongoURL": "mongodb://127.0.0.1/ictimsarabisiktimarabi"
  }
}

⚠️ Always keep your tokens and database credentials secret.

If .env support exists in the codebase, you may also place secrets in a .env file.

---

Running the Bots

Development mode

node Server/index.js

or if defined in package.json:

npm run dev

Production mode with PM2

Using the provided ecosystem.config.js:

pm2 start ecosystem.config.js
pm2 save

Check status:

pm2 list

Logs:

pm2 logs

---

Development & Structure Notes

• `` contains the bots (likely modular commands and event systems).
• `` provides shared configuration and helpers.
• system.json is the single source of truth for configuration.
• MongoDB is required locally; no cloud setup is enforced but you may adapt.
• Uses Discord.js v13 — consider upgrading to v14 for future development.

---

Troubleshooting

• Bot not starting? Check that system.json contains the correct DISCORD_TOKEN.
• MongoDB connection error? Ensure MongoDB is running locally and MONGO_URI is correct.
• Missing dependencies? Run npm install again.
• High RAM usage? Limit the number of bots running simultaneously or optimize event handling.

---

Security & Ethics

• Keep your Discord bot tokens secret.
• Never commit real tokens to GitHub.
• Use these bots responsibly; do not engage in spam, abuse, or TOS-violating behavior.

---

Contributing

1. Fork this repository
2. Create a feature branch
3. Commit your changes clearly
4. Open a Pull Request

---

License & Credits

• License: MIT — see LICENSE
• Author: acarfx
• Repository: v13-all-bots

---

✅ You are now ready to run and manage the bots on Ubuntu 22.04+ with a local MongoDB instance.