NeoEssentials

NeoEssentials

NeoEssentials — это многофункциональный essentials-мод с настройкой через конфиги для серверов Minecraft NeoForge 1.21.1 - 1.21.11. Он добавляет более 50 команд, GUI-инструменты, продвинутое администрирование и веб-панель в реальном времени — всё управляется модульными JSON-конфигами и стандартизированной документацией.

🌟 Обзор

NeoEssentials приносит на серверы NeoForge базовое управление сервером, полезные утилиты для игроков и продвинутые админ-функции. Все возможности строго задокументированы и управляются через конфиги для надёжности и прозрачности.

Только для сервера: установка на клиент не требуется — работает с ванильными клиентами. Более 50 команд: охватывает все основные серверные функции, утилиты и модерацию. Современный интерфейс: GUI-команды, поддержка цветовых кодов и веб-панель.

✨ Основные системы и возможности

• Экономика: балансы игроков, платежи, киты и поддержка магазина.
• Чат и сообщения: личные сообщения, почта, игнор/socialspy, система AFK.
• Модерация: бан, кик, мут, тюрьма, vanish, заморозка, sudo, данные игроков.
• Телепортация: дома, варпы, спавн, запросы на телепорт, система возврата.
• Управление китами: настраиваемые наборы предметов с кулдаунами и предпросмотром.
• Веб-панель: мониторинг сервера в реальном времени, редактирование конфигов, API-эндпоинты.
• Система прав: LuckPerms, FTB Ranks и встроенная поддержка.
• Управление предметами: выдача предметов, ремонт, зачарование, clearinventory, powertool.
• Утилиты: никнеймы, MOTD, near, ping, depth, helpop, rules, suicide и т.д.
• API и система плейсхолдеров: интеграция с PlaceholderAPI, кастомные плейсхолдеры, REST API-эндпоинты.

📖 Документация

Начните с Home — полного хаба документации с настройкой через конфиги. Все основные системы задокументированы и стандартизированы в соответствии с кодовой базой и конфигами:

• EconomySystem
• ChatSystem
• ModerationSystem
• TeleportationSystem
• KitManagement
• WebDashboard
• PermissionSystem
• ItemManagement
• UtilitySystems
• APISystem
• AFKSystem

Подробности об API и системе плейсхолдеров смотри в APISystem, включая:

• Интеграцию с PlaceholderAPI для динамического текста
• Пользовательские и расширяющие плейсхолдеры
• Эндпоинты REST API веб-панели для статуса сервера, информации об игроках, логов, конфига, событий и статистики
• Права и параметры конфига для функций API

🚀 Быстрый старт

Установка

1. Скачай последний релиз
2. Помести JAR-файл в папку mods твоего сервера
3. Запусти сервер, чтобы создать файлы конфигурации в config/neoessentials/
4. Настрой права и функции по необходимости
5. Перезапусти сервер, чтобы применить изменения

Основные файлы конфигурации

config/neoessentials/
├── config.json           # Основные настройки конфигурации
├── permissions.json      # Настройка системы прав
├── language/            # Папка с языковыми файлами
├── shops.json           # Конфигурация системы магазинов
└── settings.json        # Дополнительные настройки мода

Быстрая настройка прав

Для пользователей LuckPerms:

/lp group admin permission set neoessentials.admin true
/lp group moderator permission set neoessentials.moderator true
/lp group default permission set neoessentials.player true

🎮 Справочник команд

Полные списки команд и параметры конфига смотри в Home и в документации отдельных систем выше.

🔧 Примеры конфигурации

Все функции управляются модульными JSON-файлами конфигурации. Подробности смотри в Home и в документации систем выше.

🔗 Интеграция API для моддеров

Полную документацию по API и PlaceholderAPI смотри в APISystem, включая:

• Регистрацию пользовательских плейсхолдеров
• Использование эндпоинтов REST API для данных сервера
• API экономики для интеграции модов

🔗 Интеграция и совместимость

• Поддерживаются LuckPerms и FTB Ranks
• Только серверная часть (клиентские моды не требуются)
• Поддержка ванильного клиента
• Оптимизированная производительность

🛠️ Разработка

Настройка IDE

Этот проект использует IntelliJ IDEA Community Edition с Gradle.

Инструкции по настройке:

1. Клонируй репозиторий
2. Открой проект в IntelliJ IDEA
3. Импортируй как проект Gradle
4. Дождись синхронизации Gradle и загрузки зависимостей
5. IDE настроена на автоматическую загрузку исходников и javadoc

Запуск мода:

• Используй конфигурации запуска Gradle, предоставляемые NeoForge ModDev
• runClient — тестирование в клиентском режиме
• runServer — тестирование в серверном режиме
• runData — генерация ресурсов данных

Сборка:

./gradlew build

Выходной JAR: build/libs/neoessentials-VERSION+build.XXX.jar

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

• Java 21 — целевая версия JDK
• Gradle — система сборки с автоинкрементом номеров сборок
• NeoForge ModDev 2.0.107 — современный плагин для разработки модов
• Parchment Mappings — улучшенные имена параметров и javadoc

🤝 Поддержка и сообщество

• Discord: Присоединяйся к нашему Discord-серверу для поддержки и общения с сообществом
• Баг-репорты: сообщай о проблемах и багах через GitHub или Discord
• Запросы функций: предлагай новые функции и улучшения
• Документация: смотри Home и документацию систем выше

📄 Лицензия

NeoEssentials распространяется под лицензией MIT. Подробности смотри в файле LICENSE.

🌟 Готов улучшить свой сервер? Скачай NeoEssentials и дай своим игрокам нужные инструменты!

Сделано с ❤️ для сообщества Minecraft