FastCMD

Обзор [RUS]

FastCMD 1.0.0 - это первая версия мощного плагина виртуальных командных блоков для серверов Minecraft Spigot. Данный релиз предоставляет полнофункциональное решение для управления командными блоками через чат с расширенными возможностями и поддержкой нескольких языков.

Новые возможности

Основной функционал

• Система виртуальных командных блоков: Полная реализация Обычных, Цепных и Циклических командных блоков
• Управление задачами: Интеграция с Bukkit scheduler с корректной обработкой и очисткой задач
• Сохранение данных: Система хранения на основе YAML с автоматическим сохранением и загрузкой
• Цепочки команд: Возможность связывать командные блоки для последовательного выполнения

Современный синтаксис команд

• Аргументы с флагами: Новый синтаксис формата --flag:значение для более чистой структуры
• Команды в обратных кавычках: Команды указываются в `команда` для лучшего парсинга
• Обратная совместимость: Поддержка старого позиционного синтаксиса
• Поддержка многословных команд: Корректная обработка команд с пробелами

Пользовательский опыт

• Мультиязычность: Полная локализация на английском и русском с UTF-8 кодировкой
• Умное автодополнение: Контекстно-зависимое автодополнение для всех команд и параметров
• Смена языка на лету: Возможность смены языка без перезагрузки сервера
• Совместимость с Windows CMD: Корректное отображение UTF-8 в командной строке Windows

Система прав

• Детальные права: Отдельные права для каждой команды и функции
• Разумные настройки по умолчанию: Операторы сервера получают права автоматически
• Безопасность: Все команды требуют соответствующих прав

Технические характеристики

Системные требования

• Версия Minecraft: 1.16.5 (Spigot/Paper)
• Версия Java: Java 8 или выше
• Тип сервера: Spigot, Paper или совместимые форки

Архитектура

• Структура пакетов: Четкая организация в пакете com.bin.fastcmd
• Менеджеры: Отдельные менеджеры для конфигурации, хранения данных, локализации и задач
• Модели данных: Продуманные модели данных с поддержкой сериализации
• Утилиты: Переиспользуемые утилиты для парсинга аргументов и управления задачами

Производительность

• Легковесность: ~33KB размер с минимальным использованием памяти
• Эффективное планирование: Оптимизированное управление задачами Bukkit
• Быстрое хранение: YAML-хранилище с кэшированием в памяти
• Умное дополнение: Ленивая загрузка автодополнения с фильтрацией

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

Улучшенная команда создания

/fcmd create `say Привет мир` --name:приветствие --type:Normal --delay:20
/fcmd create `broadcast Рестарт сервера через 5 минут` --type:Repeating --delay:6000 --disable:30000

Гибкие команды запуска/остановки

/fcmd run --name:приветствие
/fcmd stop --name:приветствие
/fcmd run приветствие (обратная совместимость)

Мощная команда изменения

/fcmd change --name:приветствие `say Добро пожаловать!` --type:Chain --delay:0

Файлы конфигурации

Основной конфиг (config.yml)

• Выбор языка с возможностью смены без перезагрузки
• Включение/выключение автодополнения
• Значения задержек по умолчанию и лимиты
• Предустановки временных параметров

Система хранения (storage.yml)

• Автоматическое сохранение командных блоков
• Управление состоянием во время работы
• Чистый формат сериализации

Локализация

• en.yml: Полная английская локализация с цветовыми кодами
• ru.yml: Полный русский перевод с поддержкой UTF-8
• Расширяемый формат для добавления новых языков

Известные ограничения

• Командные блоки только виртуальные (без физического размещения)
• Установлены максимальные лимиты для задержек
• По умолчанию требуются права оператора
• Однопоточное выполнение команд (согласно правилам главного потока Bukkit)

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

Совместимость версий

• Тестировалось на: Minecraft 1.16.5 Spigot
• Ожидается работа: Minecraft 1.16.5 - 1.20.x
• Может работать: Более ранние версии 1.16.x (не тестировалось)

Совместимость платформ

• Spigot: Полная поддержка (основная цель)
• Paper: Полная поддержка (рекомендуется)
• CraftBukkit: Базовая поддержка (ограниченное тестирование)
• Другие форки: Зависит от реализации Bukkit API

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

Версия 1.0.0 закладывает основу для будущих улучшений:

• Дополнительные типы командных блоков
• Графический интерфейс управления
• Функции импорта/экспорта
• Расширенные возможности скриптинга
• Инструменты мониторинга производительности

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

1. Поместите JAR-файл в папку plugins
2. Перезапустите сервер (reload не рекомендуется при первой установке)
3. Проверьте консоль на предмет успешной загрузки
4. Конфигурационные файлы создадутся автоматически
5. Все функции сразу доступны при наличии прав

Этот первый релиз представляет собой результат месяцев разработки и тестирования, предлагая стабильное и многофункциональное решение виртуальных командных блоков для серверов Minecraft.

Overview [ENG]

FastCMD 1.0.0 is the initial release of this powerful virtual command block plugin for Minecraft Spigot servers. This version provides a complete foundation for managing command blocks through chat commands with advanced features and multilingual support.

New Features

Core Functionality

• Virtual Command Block System: Complete implementation of Normal, Chain, and Repeating command block types
• Advanced Task Management: Bukkit scheduler integration with proper task handling and cleanup
• Persistent Storage: YAML-based storage system with automatic saving and loading
• Command Chaining: Ability to connect command blocks for sequential execution

Modern Command Syntax

• Flag-Based Arguments: New syntax using --flag:value format for cleaner command structure
• Backtick Commands: Commands specified in backticks (`command`) for better parsing
• Backward Compatibility: Full support for old positional argument syntax
• Multi-word Command Support: Proper handling of commands with spaces

User Experience

• Multilingual Support: Complete English and Russian localization with UTF-8 encoding
• Smart Tab Completion: Context-aware auto-completion for all commands and parameters
• Flexible Language Switching: Runtime language switching without server restart
• Windows CMD Compatibility: Proper UTF-8 encoding for Windows command prompt display

Permission System

• Granular Permissions: Individual permissions for each command and feature
• Operator Defaults: Sensible default permissions for server operators
• Security-First Design: All commands require appropriate permissions

Technical Specifications

System Requirements

• Minecraft Version: 1.16.5 (Spigot/Paper)
• Java Version: Java 8 or higher
• Server Type: Spigot, Paper, or compatible forks

Architecture

• Package Structure: Clean com.bin.fastcmd package organization
• Manager Pattern: Separate managers for configuration, storage, localization, and tasks
• Model-Based Design: Proper data models with serialization support
• Utility Classes: Reusable utilities for argument parsing and task management

Performance Characteristics

• Lightweight: ~33KB compiled size with minimal memory footprint
• Efficient Scheduling: Optimized Bukkit task management with proper cleanup
• Fast Storage: YAML-based storage with in-memory caching
• Smart Completion: Lazy-loaded tab completion with filtering

Command Reference

Enhanced Create Command

/fcmd create `say Hello World` --name:greeting --type:Normal --delay:20
/fcmd create `broadcast Server restart in 5 minutes` --type:Repeating --delay:6000 --disable:30000

Flexible Run/Stop Commands

/fcmd run --name:greeting
/fcmd stop --name:greeting
/fcmd run greeting (backward compatible)

Powerful Change Command

/fcmd change --name:greeting `say Welcome!` --type:Chain --delay:0

Configuration Files

Main Configuration (config.yml)

• Language selection with runtime switching
• Tab completion toggle
• Default timing values and limits
• Common delay and disable time presets

Storage System (storage.yml)

• Automatic command block persistence
• Runtime state management
• Clean serialization format

Localization Files

• en.yml: Complete English localization with color codes
• ru.yml: Full Russian translation with UTF-8 support
• Extensible format for additional languages

Known Limitations

• Command blocks are virtual only (no physical block placement)
• Maximum limits enforced for delays and disable times
• Requires operator permissions by default
• Single-threaded command execution (follows Bukkit main thread rules)

Compatibility Notes

Version Compatibility

• Tested On: Minecraft 1.16.5 Spigot
• Expected To Work: Minecraft 1.16.5 through 1.20.x
• May Work: Earlier 1.16.x versions (untested)

Platform Compatibility

• Spigot: Full support (primary target)
• Paper: Full support (recommended)
• CraftBukkit: Basic support (limited testing)
• Other Forks: Compatibility depends on Bukkit API implementation

Future Development

Version 1.0.0 establishes a solid foundation for future enhancements including:

• Additional command block types
• GUI management interface
• Import/export functionality
• Advanced scripting capabilities
• Performance monitoring tools

Installation Notes

1. Drop the JAR file into your plugins folder
2. Restart the server (reload not recommended for initial setup)
3. Check console for successful loading
4. Default configuration files will be created automatically
5. All features are immediately available with proper permissions

This initial release represents months of development and testing to provide a stable, feature-rich virtual command block solution for Minecraft servers.