blockmine 1.4.8 → 1.5.1

package/README.md

@@ -1,3 +1,4 @@
+
 <div align="center">
   <img src="./image/logo.png" alt="BlockMine Logo" width="150">
   <h1>BlockMine</h1>
@@ -13,7 +14,7 @@
   </p>
 </div>
 
-**BlockMine** — это open-source решение для централизованного управления и автоматизации ботов Minecraft. Запускайте ботов, управляйте ими в реальном времени через удобный веб-интерфейс, расширяйте их возможности с помощью плагинов и настраивайте всё под свои нужды.
+**BlockMine** — это open-source решение для централизованного управления и автоматизации ботов Minecraft. Запускайте ботов, управляйте ими в реальном времени, расширяйте их возможности с помощью плагинов и создавайте сложные сценарии поведения в визуальном редакторе.
 
 ---
 
@@ -42,6 +43,7 @@
 ## 🚀 Ключевые возможности
 
 *   **💻 Современный веб-интерфейс**: Адаптивная панель на React и Tailwind CSS для управления ботами, серверами и плагинами с любого устройства.
+*   **✨ Визуальный редактор логики (No-Code)**: Проектируйте поведение ботов с помощью интуитивного Drag-and-Drop интерфейса. Создавайте сложные команды и обработчики событий, не написав ни строчки кода.
 *   **🤖 Комплексное управление ботами**:
     *   Запуск, остановка и перезапуск ботов в один клик.
     *   Интерактивная консоль для каждого бота.
@@ -56,13 +58,10 @@
     *   Создавайте группы пользователей (`Admin`, `Member` и др.).
     *   Настраивайте детальные права доступа к каждой команде.
     *   Черный список для пользователей.
-*   **⚙️ Умная система команд**:
-    *   Декларативное создание команд с автоматическим парсингом и валидацией аргументов.
-    *   Автоматическая генерация сообщений об ошибках и подсказок по использованию.
 *   **🔄 Экспорт и импорт**:
-    *   Создавайте **полные резервные копии** ботов в один ZIP-архив, включая все плагины, их файлы и настройки.
-    *   Легко переносите ботов между разными установками BlockMine.
-    *   Настраивайте, какие именно данные экспортировать.
+    *   Создавайте **полные резервные копии** ботов в один ZIP-архив, включая все плагины и их настройки.
+    *   Делитесь отдельными командами и графами событий через экспорт в JSON.
+    *   Легко переносите ботов и их логику между разными установками BlockMine.
 *   **📦 Простая установка**: Запуск всей системы одной командой благодаря `npx`.
 
 ## ✨ Быстрый старт с `npx`
@@ -91,30 +90,38 @@
 
 Чтобы максимально эффективно использовать панель, важно понимать её ключевые компоненты.
 
+### 🎨 Визуальный редактор
+<p align="center">
+  <img src="./image/visualcommand.png" alt="Скриншот визуального редактора BlockMine" width="100%">
+</p>
+Это сердце No-Code автоматизации в BlockMine. Редактор позволяет вам создавать логику, перетаскивая и соединяя функциональные блоки (ноды).
+
+*   **Создание команд**: Спроектируйте полноценную команду с аргументами, проверками прав и сложной логикой, не прикасаясь к коду.
+*   **Обработка событий**: Создавайте графы, которые реагируют на игровые события (например, вход игрока, сообщение в чате, появление моба) и выполняют заданные действия.
+*   **Наглядность**: Весь поток выполнения виден на одном экране, что упрощает понимание и отладку логики.
+
 ### 🔌 Плагины
-Плагины — это основа функциональности вашего бота. Они добавляют новые команды, автоматизируют действия и интегрируются с другими системами.
+Плагины — это способ программного расширения функциональности. Они могут добавлять новые команды, новые ноды для визуального редактора или работать в фоновом режиме.
 
 *   **Магазин плагинов**: Встроенный браузер позволяет легко находить и устанавливать плагины в один клик.
 *   **Зависимости**: Система автоматически определит и предложит установить плагины, необходимые для работы выбранного вами.
-*   **Настройка**: Большинство плагинов можно настроить прямо в веб-интерфейсе, не редактируя файлы конфигурации вручную.
+*   **Настройка**: Большинство плагинов можно настроить прямо в веб-интерфейсе.
 
 ### ⚙️ Команды
-Каждый плагин может регистрировать в системе свои команды. BlockMine предоставляет мощный интерфейс для управления ими.
+Команды могут быть созданы двумя способами: **программно** через плагины или **визуально** в редакторе. Независимо от способа создания, все команды управляются централизованно.
 
 *   **Алиасы**: Назначайте командам короткие псевдонимы (например, `@p` для `@ping`).
-*   **Кулдауны**: Устанавливайте задержку между использованиями команды для предотвращения спама.
-*   **Включение/выключение**: Временно отключайте команды, не удаляя плагин.
-*   **Аргументы**: Панель автоматически обрабатывает аргументы команд, делая их использование предсказуемым.
+*   **Кулдауны**: Устанавливайте задержку между использованиями команды.
+*   **Включение/выключение**: Временно отключайте команды.
+*   **Аргументы**: Задавайте аргументы для ваших визуальных команд, которые будут доступны внутри графа.
 
 ### 🔐 Права и Группы (Permissions)
 Это гибкая система, позволяющая точно контролировать, кто и что может делать с вашим ботом.
 
-*   **Права (Permissions)**: Каждое действие (например, использование команды `@fly`) защищено правом (`user.fly`). Права обычно создаются плагинами.
-*   **Группы (Groups)**: Группы объединяют несколько прав. Например, группа `Member` может иметь право `member.say`, а группа `Admin` — право `admin.*` (доступ ко всем командам у admin.).
+*   **Права (Permissions)**: Каждое действие (например, использование команды `@fly`) защищено правом (`user.fly`). Права могут создаваться плагинами или в панели управления.
+*   **Группы (Groups)**: Группы объединяют несколько прав. Например, группа `Member` может иметь право `member.say`.
 *   **Пользователи**: Каждый игрок, взаимодействующий с ботом, становится пользователем в системе. Вы можете добавлять пользователей в разные группы, выдавая им соответствующие права.
 
-Эта система позволяет создавать сложные иерархии доступа, например: обычные игроки, участники клана, модераторы и администраторы, каждый со своим набором возможностей.
-
 ## 🧑‍💻 Для разработчиков и контрибьюторов
 
 Если вы хотите внести свой вклад в проект или запустить его в режиме разработки.
@@ -135,5 +142,5 @@ npm install
 npm run dev
 ```
 
-Панель управления доступна по адресу: http://localhost:5173 
-там на лету будет менятся страничка если изменяете. на 3001 базовая собранная только
+*   **Бэкенд** будет доступен на `http://localhost:3001`.
+*   **Фронтенд** с горячей перезагрузкой будет доступен на `http://localhost:5173`. Открывайте этот адрес для разработки.

package/backend/package.json

@@ -16,5 +16,10 @@
   "license": "ISC",
   "devDependencies": {
     "nodemon": "^3.1.2"
+  },
+  "dependencies": {
+    "express-validator": "^7.2.1",
+    "pino": "^9.7.0",
+    "pino-pretty": "^13.0.0"
   }
 }

package/backend/prisma/migrations/20250627144030_add_visual_editor_fields/migration.sql

@@ -0,0 +1,26 @@
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_Command" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "botId" INTEGER NOT NULL,
+    "name" TEXT NOT NULL,
+    "isEnabled" BOOLEAN NOT NULL DEFAULT true,
+    "cooldown" INTEGER NOT NULL DEFAULT 0,
+    "aliases" TEXT NOT NULL DEFAULT '[]',
+    "description" TEXT,
+    "owner" TEXT,
+    "permissionId" INTEGER,
+    "allowedChatTypes" TEXT NOT NULL DEFAULT '["chat", "private"]',
+    "isVisual" BOOLEAN NOT NULL DEFAULT false,
+    "argumentsJson" TEXT DEFAULT '[]',
+    "graphJson" TEXT DEFAULT 'null',
+    CONSTRAINT "Command_botId_fkey" FOREIGN KEY ("botId") REFERENCES "Bot" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
+    CONSTRAINT "Command_permissionId_fkey" FOREIGN KEY ("permissionId") REFERENCES "Permission" ("id") ON DELETE SET NULL ON UPDATE CASCADE
+);
+INSERT INTO "new_Command" ("aliases", "allowedChatTypes", "botId", "cooldown", "description", "id", "isEnabled", "name", "owner", "permissionId") SELECT "aliases", "allowedChatTypes", "botId", "cooldown", "description", "id", "isEnabled", "name", "owner", "permissionId" FROM "Command";
+DROP TABLE "Command";
+ALTER TABLE "new_Command" RENAME TO "Command";
+CREATE UNIQUE INDEX "Command_botId_name_key" ON "Command"("botId", "name");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/backend/prisma/migrations/20250628113254_add_event_graphs/migration.sql

@@ -0,0 +1,14 @@
+-- CreateTable
+CREATE TABLE "EventGraph" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "botId" INTEGER NOT NULL,
+    "eventType" TEXT NOT NULL,
+    "isEnabled" BOOLEAN NOT NULL DEFAULT true,
+    "graphJson" TEXT DEFAULT 'null',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "EventGraph_botId_fkey" FOREIGN KEY ("botId") REFERENCES "Bot" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EventGraph_botId_eventType_key" ON "EventGraph"("botId", "eventType");

package/backend/prisma/migrations/20250628122517_added_eventgraph_name/migration.sql

@@ -0,0 +1,26 @@
+/*
+  Warnings:
+
+  - Added the required column `name` to the `EventGraph` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_EventGraph" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "botId" INTEGER NOT NULL,
+    "name" TEXT NOT NULL,
+    "eventType" TEXT NOT NULL,
+    "isEnabled" BOOLEAN NOT NULL DEFAULT true,
+    "graphJson" TEXT DEFAULT 'null',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "EventGraph_botId_fkey" FOREIGN KEY ("botId") REFERENCES "Bot" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+INSERT INTO "new_EventGraph" ("botId", "createdAt", "eventType", "graphJson", "id", "isEnabled", "updatedAt", "name") SELECT "botId", "createdAt", "eventType", "graphJson", "id", "isEnabled", "updatedAt", "eventType" FROM "EventGraph";
+DROP TABLE "EventGraph";
+ALTER TABLE "new_EventGraph" RENAME TO "EventGraph";
+CREATE UNIQUE INDEX "EventGraph_botId_name_key" ON "EventGraph"("botId", "name");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;

package/backend/prisma/migrations/20250628122710_complex_events/migration.sql

@@ -0,0 +1,36 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `eventType` on the `EventGraph` table. All the data in the column will be lost.
+
+*/
+-- CreateTable
+CREATE TABLE "EventTrigger" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "graphId" INTEGER NOT NULL,
+    "eventType" TEXT NOT NULL,
+    CONSTRAINT "EventTrigger_graphId_fkey" FOREIGN KEY ("graphId") REFERENCES "EventGraph" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+
+-- RedefineTables
+PRAGMA defer_foreign_keys=ON;
+PRAGMA foreign_keys=OFF;
+CREATE TABLE "new_EventGraph" (
+    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+    "botId" INTEGER NOT NULL,
+    "name" TEXT NOT NULL,
+    "isEnabled" BOOLEAN NOT NULL DEFAULT true,
+    "graphJson" TEXT DEFAULT 'null',
+    "createdAt" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" DATETIME NOT NULL,
+    CONSTRAINT "EventGraph_botId_fkey" FOREIGN KEY ("botId") REFERENCES "Bot" ("id") ON DELETE CASCADE ON UPDATE CASCADE
+);
+INSERT INTO "new_EventGraph" ("botId", "createdAt", "graphJson", "id", "isEnabled", "name", "updatedAt") SELECT "botId", "createdAt", "graphJson", "id", "isEnabled", "name", "updatedAt" FROM "EventGraph";
+DROP TABLE "EventGraph";
+ALTER TABLE "new_EventGraph" RENAME TO "EventGraph";
+CREATE UNIQUE INDEX "EventGraph_botId_name_key" ON "EventGraph"("botId", "name");
+PRAGMA foreign_keys=ON;
+PRAGMA defer_foreign_keys=OFF;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EventTrigger_graphId_eventType_key" ON "EventTrigger"("graphId", "eventType");

package/backend/prisma/migrations/migration_lock.toml

@@ -1,3 +1,3 @@
-# Please do not edit this file manually
-# It should be added in your version-control system (i.e. Git)
+# Please do not edit this file manually
+# It should be added in your version-control system (i.e. Git)
 provider = "sqlite"

package/backend/prisma/schema.prisma

@@ -36,7 +36,8 @@ model Bot {
   users            User[]
   groups           Group[]
   permissions      Permission[]
-  commands         Command[] 
+  commands         Command[]
+  eventGraphs      EventGraph[]
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
@@ -64,22 +65,52 @@ model InstalledPlugin {
 }
 
 model Command {
-  id        Int     @id @default(autoincrement())
-  botId     Int
-  bot       Bot     @relation(fields: [botId], references: [id], onDelete: Cascade)
-  name      String
-  isEnabled Boolean @default(true)
-  cooldown  Int     @default(0)
-  aliases   String  @default("[]") // Храним как джсон строку
-  description String?
-  owner     String?
-  permissionId Int? 
-  permission   Permission? @relation(fields: [permissionId], references: [id], onDelete: SetNull)
-  allowedChatTypes String  @default("[\"chat\", \"private\"]") 
+  id               Int     @id @default(autoincrement())
+  botId            Int
+  bot              Bot     @relation(fields: [botId], references: [id], onDelete: Cascade)
+  name             String
+  isEnabled        Boolean @default(true)
+  cooldown         Int     @default(0)
+  aliases          String  @default("[]")
+  description      String?
+  owner            String?
+  permissionId     Int?
+  permission       Permission? @relation(fields: [permissionId], references: [id], onDelete: SetNull)
+  allowedChatTypes String  @default("[\"chat\", \"private\"]")
+
+  isVisual         Boolean @default(false)
+  argumentsJson    String? @default("[]")
+  graphJson        String? @default("null")
 
   @@unique([botId, name])
 }
 
+model EventGraph {
+  id          Int     @id @default(autoincrement())
+  botId       Int
+  bot         Bot     @relation(fields: [botId], references: [id], onDelete: Cascade)
+  name        String
+  isEnabled   Boolean @default(true)
+  graphJson   String? @default("null")
+  variables   String? @default("[]")
+
+  triggers    EventTrigger[]
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@unique([botId, name])
+}
+
+model EventTrigger {
+  id        Int      @id @default(autoincrement())
+  graphId   Int
+  graph     EventGraph @relation(fields: [graphId], references: [id], onDelete: Cascade)
+  eventType String   // e.g., "entitySpawn", "chat"
+
+  @@unique([graphId, eventType])
+}
+
 model User {
   id            Int       @id @default(autoincrement())
   username      String
@@ -163,7 +194,7 @@ model PanelUser {
 // Роли пользователей (Admin, Moderator, Viewer)
 model PanelRole {
   id          Int      @id @default(autoincrement())
-  name        String   @unique // Например, "Admin", "Moderator", "Viewer"
+  name        String   @unique 
   
   // Храним права как джсон строку.  SQLite не поддерживает массивы.
   // Пример: '["bot:create", "bot:delete", "user:manage"]'