Skip to content

README.md

Latest commit

 

History

History
179 lines (124 loc) · 9.47 KB

README.md

File metadata and controls

179 lines (124 loc) · 9.47 KB

OpenComputers Terminal

Комплексная система мониторинга для сервера Minecraft HiTech 1.12.2, обеспечивающая отслеживание критически важных систем через интерфейс OpenComputers.

Интерфейс мониторинга

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

Система предоставляет четыре ключевых модуля мониторинга:

  • 👥 Мониторинг игроков - Отслеживание входа/выхода заданных игроков на сервер
  • ⚡ AE2 процессоры - Контроль заполнения и выполнения ЦП создания из Applied Energistics 2
  • 🔌 Flux Network - Слежение за состоянием энергетической сети Flux Network
  • ⚛️ Кастомные реакторы - Мониторинг реакторов из мода Void Studio
  • ⚛️ Отключение кастомных реакторов - Отключение реакторов из мода Void Studio, при нехватки низкотемпературного хладогента в МЭ сети

📋 Требования

Аппаратное обеспечение (Серверная стойка)

Обязательные компоненты:

  • Видеокарта (3-ий уровень) - 1 шт
  • Центральный процессор (ЦП) (3-ий уровень) - 1 шт
  • Память (Уровень 3.5) - от 1 шт
  • Компонентная шина (3-ий уровень) - 3 шт ⚠️ обязательно
  • Интернет карта - 1 шт

Внешние компоненты

  • Монитор 3-его уровня - количество по желанию
  • МЭ контроллер (Applied Energistics 2)
  • Флакс контроллер (Flux Networks)
  • Чат бокс (OpenComputers)

Программные зависимости

  • Minecraft: 1.12.2
  • OpenComputers (любая совместимая версия для 1.12.2)
  • Applied Energistics 2 (опционально)
  • Flux Networks (опционально)
  • Void Studio (только для сервера MCSkill HiTech)

📝 Примечание: Благодаря системе проверки интерфейсов, отсутствие определенных модов не критично - соответствующие разделы мониторинга просто не будут отображаться.

🛠️ Установка

Автоматическая установка

  1. Загрузите установщик:
wget -f https://raw.githubusercontent.com/Awl-S/Monitoring-Ala/refs/heads/main/monitoringInstaller.lua monitoringInstaller.lua
  1. Запустите установщик:
monitoringInstaller.lua
  1. Запустите основную программу:
main.lua

Ручное управление администраторами

Для добавления администраторов при первом запуски, и без запуска основной программы используйте скрипт admin.lua:

# Добавить администратора
admin.lua add giver345

# Добавить администратора с кастомными сообщениями
admin.lua add player123 "Суперадмин зашёл" "Суперадмин ушёл"

# Удалить администратора
admin.lua remove oldplayer

# Показать всех администраторов
admin.lua list

# Показать справку
admin.lua help

Команды чата

Используйте чат бокс для управления системой:

@add <ник>                    # Добавить игрока в мониторинг
@remove <ник>                 # Удалить игрока из мониторинга  
@greeting <ник> <текст>       # Установить приветствие для игрока
@farewell <ник> <текст>       # Установить прощание для игрока
@help                         # Показать все доступные команды
@sleep                        # Перезагрузить компьютер
@clearR                       # Очистить кэш реакторов
@clearE                       # Очистить кэш энергии

Использование команд

Первоначальная настройка

  1. Подключите все необходимые компоненты к серверной стойке
  2. Установите мониторы в удобном для просмотра месте
  3. Запустите систему командой main.lua
  4. Используйте команды чата для добавления игроков и настройки уведомлений

📊 Интерфейс

Система отображает информацию в реальном времени по четырем основным блокам:

  • Энерго-сеть: Текущее состояние энергетической системы (Flux Network)
  • Игроки: Статус отслеживаемых игроков (онлайн/оффлайн)
  • Реакторы: Детальная информация о состоянии всех реакторов
  • МЭ Процессы создания: Мониторинг процессоров Applied Energistics 2

Особенности мониторинга реакторов

  • Автоматическое отключение при недостатке низкотемпературного хладагента
  • Уведомления о взрывах - система автоматически определяет пропавшие реакторы
  • Детальная статистика по каждому реактору (температура, энергия, тип)
  • Защитные механизмы - предотвращение перегрева

🌐 Совместимость

Поддерживаемые серверы:

🔧 Конфигурация

Система автоматически создает файлы конфигурации в папке /home/data/:

  • playersData.txt - данные игроков и их сообщения
  • energyInfo.txt - информация о максимальной энергии Flux Network
  • reactorInfo.txt - данные о количестве реакторов
  • fluidDropInfo.txt - настройки минимального количества хладагента

🔮 Планы развития

  • Модульная архитектура: Разделение на отдельные библиотеки (реакторы, игроки, МЭ система, Flux сеть)
  • Расширяемость: Возможность замены модов (например, реакторы IC2 вместо Void Studio)
  • Многоязычность: Поддержка английского и других языков
  • Универсальность: Адаптация для других серверов и модпаков
  • Веб-интерфейс: Возможность мониторинга через браузер

🚨 Безопасность

  • Система разрешений: Только администраторы могут выполнять команды
  • Защита от спама: Ограничения на частоту обновлений
  • Автоматическое восстановление: Система продолжает работу при ошибках отдельных модулей

🤝 Вклад в проект

Проект активно развивается и приветствует участие сообщества. Если у вас есть предложения по улучшению или вы нашли баги, создавайте Issues или Pull Request'ы.

Как внести вклад:

  1. Fork репозитория
  2. Создайте ветку для новой функции (git checkout -b feature/amazing-feature)
  3. Закоммитьте изменения (git commit -m 'Add amazing feature')
  4. Push в ветку (git push origin feature/amazing-feature)
  5. Откройте Pull Request

📝 Лицензия

SPDX-License-Identifier: AGPL-3.0-only

Copyright (c) 2023-2025 Stawlie

📞 Контакты и поддержка

Автор: Stawlie
GitHub: github.com/Awl-S/Monitoring-Ala
Telegram: @rar2000q
Форум McSkill: Обсуждение проекта

⭐ Если проект оказался полезным, поставьте звездочку на GitHub!