✦ D'Ar8c9l Community Bot ✦

Telegram-бот для комьюнити, модерации, рейтингов, профилей и атмосферы свободного интернета

---

⌞ О проекте ⌝

D'Ar8c9l Community Bot — это Telegram-бот для управления комьюнити, модерации, статистики, профилей, рейтингов, репутации, отношений, ролей и интерактивных меню.

Проект создан для сообщества D'Ar8c9l — пространства про Linux, кастомизацию, Arch Linux, open-source культуру и цифровую независимость.

Это не просто бот для чата. Это маленькая система управления сообществом, где есть активность, репутация, профили, роли, отношения, модерация и стиль.

---

---

✦ Возможности

🛡️ Модерация /ban — бан пользователя /mute — мут пользователя /kick — кик пользователя /warn — предупреждение временные наказания автоматический бан за 3 варна автоматическое снятие варнов через 30 дней	📊 Активность профили пользователей XP и уровни рейтинг активности лексикон пользователя статистика частых слов дата вступления в чат место в рейтинге
⭐ Репутация система репутации рейтинг репутации повышение репутации через ответы поддержка слов благодарности отображение места в топе	💬 Комьюнити браки усыновления роли пинг по ролям репорты приветствие новых участников меню с кнопками

---

⌞ Команды ⌝

Команда	Описание	Доступ
/start	Приветствие бота	Все
/help	Список помощи	Все
/commands	Открыть меню с кнопками	Все
/profile	Профиль пользователя	Все
/top	Рейтинг активности	Все
/toprep	Рейтинг репутации	Все
/report	Отправить репорт на пользователя	Все
/reports	Посмотреть репорты пользователя	Модераторы
/warn	Выдать предупреждение	Модераторы
/warns	Посмотреть предупреждения	Модераторы
/unwarn	Снять предупреждение	Модераторы
/ban	Забанить пользователя	Модераторы
/mute	Замутить пользователя	Модераторы
/kick	Кикнуть пользователя	Модераторы
/marry	Предложить брак	Все
/divorce	Развод	Все
/adopt	Усыновить пользователя	Все
/children	Список детей	Все
/parent	Посмотреть родителя	Все
/roles	Роли пользователя	Все

---

✦ Меню бота

Бот поддерживает удобную панель команд через /commands.

В меню есть разделы:

Правила чата
Отношения
Модерация
Помощь
Статистика и рейтинг
О проекте
Линки проекта
FAQ
Развлечения

Некоторые разделы уже работают, а некоторые оставлены как заготовки под будущий функционал.

---

⌞ Система уровней ⌝

Бот считает активность пользователя в чате.

1 символ = 1 XP

Уровень растёт по мягкой прогрессии:

100 XP  ≈ 2 уровень
1000 XP ≈ 10 уровень
2000 XP ≈ 20 уровень

В профиле отображается уровень, прогресс и место пользователя в рейтинге.

---

✦ Репутация

Репутацию можно повышать, отвечая на сообщение пользователя словами:

спасибо
спс
+реп
хорош
сяп
гуд
good
+
соглы
согласен

Репутация отображается в профиле и участвует в отдельном рейтинге.

---

⌞ Установка ⌝

Склонируй репозиторий:

git clone https://github.com/ArhinDRC/TelegramCommunityBot.git
cd TelegramCommunityBot

Создай локальный конфиг:

cp config.example.json config.json

Открой config.json и вставь токен от @BotFather:

{
  "BotToken": "PASTE_YOUR_BOT_TOKEN_HERE",
  "DatabasePath": "bot.db"
}

Установи зависимости и собери проект:

dotnet restore
dotnet build

Запусти бота:

dotnet run

---

✦ Важно для Telegram

Чтобы бот корректно работал в группе:

1. Добавь бота в чат.
2. Сделай его администратором.
3. Выдай права на бан, мут и удаление сообщений.
4. Отключи Privacy Mode у бота через @BotFather, если хочешь считать сообщения и XP.

---

⌞ Безопасность ⌝

Никогда не публикуй токен бота.

В репозиторий не должны попадать:

config.json
bot.db
*.db
*.sqlite
*.sqlite3
bin/
obj/

В GitHub должен быть только пример:

config.example.json

Если токен случайно попал в сеть — сразу перевыпусти его через @BotFather.

---

✦ Структура проекта

TelegramCommunityBot/
├── assets/
│   └── readme/
├── BotApi.cs
├── BotApp.cs
├── Database.cs
├── Leveling.cs
├── Models.cs
├── Program.cs
├── TextTools.cs
├── config.example.json
├── README.md
└── TelegramCommunityBot.csproj

---

⌞ Roadmap ⌝

• Улучшить визуальные карточки профиля
• Добавить полноценный FAQ
• Добавить развлечения
• Добавить систему достижений
• Добавить веб-панель администратора
• Добавить PostgreSQL
• Добавить Docker
• Добавить расширенную аналитику чата
• Добавить кастомные темы профиля

---

✦ Автор

ArhinDRC

---

✦ D'Ar8c9l — свобода, Linux, open-source и контроль над своей системой ✦