
LyttleAdmin
A powerful, lightweight staff management plugin with advanced moderation features!
- Загрузки
- 205
- Подписчики
- 0
- Обновлён
- 24 августа 2025 г.
- Лицензия
- MIT
Опубликован 22 июня 2025 г.
Lyttle Admin
✨ A powerful, lightweight staff management plugin with advanced moderation features! ✨
📚 Features • ⌨️ Commands • 🔑 Permissions • 📥 Installation • ⚙️ Configuration • 📱 Support

🌟 Features
🎯 Core Plugin Features
- Advanced Staff Mode System with reason tracking
- Inventory and location restoration capabilities
- Comprehensive staff action logging
- Player-focused moderation tools
- MiniMessage format support for all messages
🤌 Lyttle Certified
- Clean and efficient codebase
- No unnecessary features
- Full flexibility and configurability
- Open source and free to use (MIT License)
⌨️ Commands
💡
<required>[optional]
| Command | Permission | Description |
|---|---|---|
/staff |
admin.staff |
Toggle staff mode |
/staff --restore <date> <time> |
admin.restore |
Restore player data from backup |
🔑 Permissions
| Permission Node | Description | Default |
|---|---|---|
admin.* |
Grants all plugin permissions | ❌ |
admin.staff |
Access to staff mode | ❌ |
admin.restore |
Access to restore commands | ❌ |
📥 Installation
Quick Start
- Download the latest version from Hangar
- Place the
.jarfile in your server'spluginsfolder - Restart your server
- Edit the configuration files to customize messages and settings
- Use
/staffto begin using the plugin
📋 Requirements
- Java 21 or newer
- Paper 1.21.x+
- Minimum 20MB free disk space
📝 Configuration Files
🔧 config.yml
The main configuration file controlling plugin behavior and features.
💬 messages.yml
Customize all plugin messages. Supports MiniMessage formatting for advanced styling.
Example message customization:
prefix: "<dark_aqua><bold>Lyttle<aqua><bold>Admin<reset> <dark_gray>- <gray>"
staff_enabled: "<USER> <dark_red>enabled<gray> staff mode.\n Reason: <italic><blue><REASON>"
🔄 The #defaults Folder
The folder serves several important purposes: #defaults
- Backup Reference: Contains original copies of all configuration files
- Reset Option: Use these to restore default settings
- Update Safety: Preserved during plugin updates
- Documentation: Shows all available options with comments
💡 Never modify files in the #defaults folder! They are automatically overwritten during server restarts.
💬 Support
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🌟 Made with the lyttlest details in mind by Lyttle Development
If you enjoy this plugin, please consider:
⭐ Giving it a star on GitHub
💬 Sharing it with other server owners
🎁 Supporting development through Donations

Ченджлог
1.2.7Релиз1.21.8 · 24 августа 2025 г.
v1.2.7
This pull request makes several improvements to the project's build and release automation, as well as some internal refactoring and minor feature updates. The main theme is the consolidation and enhancement of CI/CD workflows, along with some codebase clean-up and dependency updates.
CI/CD Workflow Improvements:
- Consolidated the separate
main.ymlandalpha.ymlGitHub Actions workflows into a single unified workflow file,release-and-publish.yml, which now handles releases for both themainandalphabranches. This new workflow also adds steps to build artifacts, tag releases, and upload JAR files as GitHub releases. The old workflow files were removed. [1] [2] [3]
Dependency and Version Updates:
- Updated the plugin version in
gradle.propertiesfrom1.2.6to1.2.7.
Codebase Refactoring:
- Replaced usage of the
Configclass with the newYamlConfigclass inConfigs.java, updating both instance variables and constructor usage accordingly. - Refactored action bar handling in
StaffCommand.javato use the sharedActionBarutility class, removing the customsetActionBarmethod and its associated state. [1] [2] [3]
1.2.7-ALPHA.1Альфа1.21.8 · 24 августа 2025 г.
v1.2.7
This pull request consolidates and modernizes the CI/CD GitHub Actions workflows for publishing releases, and refactors some internal code to improve maintainability and consistency. The most significant changes include merging separate workflow files into a unified workflow, updating the plugin version, and refactoring configuration and action bar handling in the codebase.
CI/CD Workflow Consolidation and Improvements:
- Replaced the separate
.github/workflows/main.ymland.github/workflows/alpha.ymlwith a single.github/workflows/release-and-publish.ymlworkflow. This new workflow handles bothmainandalphabranches, automates version tagging, builds artifacts, and publishes to GitHub Releases, Hangar, and Modrinth, reducing duplication and simplifying maintenance. (.github/workflows/release-and-publish.yml [1] .github/workflows/main.yml [2] .github/workflows/alpha.yml [3]
Version Update:
- Updated the plugin version from
1.2.6to1.2.7ingradle.properties. (gradle.properties gradle.propertiesL2-R2)
Codebase Refactoring:
Config Handling:
- Refactored
Configsto useYamlConfiginstead ofConfigfor all configuration files, improving type consistency and clarity. (src/main/java/com/lyttldev/lyttleadmin/types/Configs.java src/main/java/com/lyttldev/lyttleadmin/types/Configs.javaL4-R27)
Action Bar Handling:
unspecifiedРелиз1.21.8 · 28 июля 2025 г.
v1.2.6
This pull request includes several changes across multiple files, focusing on workflow adjustments, version updates, dependency removal, and a minor code fix. Below is a categorized summary of the most important changes:
Workflow Adjustments:
- Removed the workflow for publishing packages on the beta branch. This includes steps for publishing to GitHub Packages, Hangar, and Modrinth.
- Updated the workflow to target the
mainbranch instead of thebetabranch for package publishing.
Version Updates:
- Incremented the plugin version from
1.2.4to1.2.6.
Dependency Removal:
- Removed the file containing version information and dependencies for Paper API, LuckPerms API, and SQLite JDBC.
Code Fix:
*Modified the runActions method to always enable the action bar when a message is set, replacing the dynamic enable parameter with a hardcoded true.
unspecified-ALPHA.14Альфа1.21.8 · 28 июля 2025 г.
v1.2.6
This pull request includes several changes across multiple files, focusing on workflow adjustments, version updates, dependency removal, and a minor code fix. Below is a categorized summary of the most important changes:
Workflow Adjustments:
- Removed the workflow for publishing packages on the beta branch. This includes steps for publishing to GitHub Packages, Hangar, and Modrinth.
- Updated the workflow to target the
mainbranch instead of thebetabranch for package publishing.
Version Updates:
- Incremented the plugin version from
1.2.4to1.2.6.
Dependency Removal:
- Removed the file containing version information and dependencies for Paper API, LuckPerms API, and SQLite JDBC.
Code Fix:
*Modified the runActions method to always enable the action bar when a message is set, replacing the dynamic enable parameter with a hardcoded true.
1.2.4-ALPHA.13Альфа1.21.8 · 26 июля 2025 г.
v1.2.4
This pull request introduces several updates to enhance role-based actions, improve code readability, and add new functionality for action bar messages. The changes include refactoring method and variable names, implementing dynamic action bar messages, and updating configuration files to support these enhancements.
Code Refactoring and Cleanup:
- Refactored method and variable names in
ActionsConfigto use camelCase (onEnableandonDisable) for consistency. - Removed unused imports and logging references in
StaffCommand.javafor cleaner code.
Action Bar Enhancements:
- Added support for dynamic action bar messages in
RoleActionwith newactionBarproperty. - Replaced the old
actionBarmethod inStaffCommand.javawith a more flexiblesetActionBarmethod, allowing custom messages and clearing the action bar when needed.
Configuration Updates:
- Updated default configuration files (
config.ymland#defaults/config.yml) to includeaction_barmessages for admin and moderator roles. - Corrected role-related tags in configuration files to distinguish between admin and moderator actions.
Role Action Mapping:
- Enhanced
RolesConfigLoaderto mapaction_barproperty from configuration files toRoleActionobjects.
Version Update:
- Updated
pluginVersioningradle.propertiesfrom1.2.3to1.2.4.
1.2.3Релиз1.21.8 · 24 июля 2025 г.
v1.2.3
This pull request introduces significant enhancements to the configuration and role management system in the LyttleAdmin plugin. The changes include updating the plugin version, refactoring the code to centralize role-related actions, and adding new configuration types for better flexibility and maintainability. Additionally, it removes hardcoded role management logic and replaces it with a dynamic configuration-driven approach.
Configuration Updates:
- Version Updates: Updated
pluginVersionto1.2.3andpaperVersionto1.21.8ingradle.propertiesfor compatibility with newer versions. - Default Configs: Added
defaultGeneralconfiguration inConfigs.javato support default values for general settings.
Role Management Refactoring:
- Dynamic Role Actions: Replaced hardcoded role management methods (
giveRole,removeRole, etc.) with a centralizedrunActionsmethod that dynamically handles role actions based on configurations. - Role Configuration System: Introduced new POJO classes (
RolesConfig,RoleConfig,ActionsConfig,RoleAction,RoleChange,BroadcastConfig) to encapsulate role-related settings and actions.
Code Simplification:
- Staff Mode Logic: Consolidated
onStaffModeEnabledandonStaffModeDisabledlogic to use the newrunActionsmethod, removing redundant methods likeonStaffModeEnabledAdminandonStaffModeEnabledModerator. - Utility Enhancements: Added
RolesConfigLoaderutility for converting configuration objects into POJOs.
Logging Improvements:
- Error Handling: Enhanced logging for errors during staff mode enable/disable actions to improve debugging.
These changes improve the scalability and maintainability of the plugin by leveraging configuration-driven logic and reducing hardcoded dependencies.
1.2.3-ALPHA.12Альфа1.21.8 · 23 июля 2025 г.
v1.2.3
This pull request introduces significant enhancements to the configuration and role management system in the LyttleAdmin plugin. The changes include updating the plugin version, refactoring the code to centralize role-related actions, and adding new configuration types for better flexibility and maintainability. Additionally, it removes hardcoded role management logic and replaces it with a dynamic configuration-driven approach.
Configuration Updates:
- Version Updates: Updated
pluginVersionto1.2.3andpaperVersionto1.21.8ingradle.propertiesfor compatibility with newer versions. - Default Configs: Added
defaultGeneralconfiguration inConfigs.javato support default values for general settings.
Role Management Refactoring:
- Dynamic Role Actions: Replaced hardcoded role management methods (
giveRole,removeRole, etc.) with a centralizedrunActionsmethod that dynamically handles role actions based on configurations. - Role Configuration System: Introduced new POJO classes (
RolesConfig,RoleConfig,ActionsConfig,RoleAction,RoleChange,BroadcastConfig) to encapsulate role-related settings and actions.
Code Simplification:
- Staff Mode Logic: Consolidated
onStaffModeEnabledandonStaffModeDisabledlogic to use the newrunActionsmethod, removing redundant methods likeonStaffModeEnabledAdminandonStaffModeEnabledModerator. - Utility Enhancements: Added
RolesConfigLoaderutility for converting configuration objects into POJOs.
Logging Improvements:
- Error Handling: Enhanced logging for errors during staff mode enable/disable actions to improve debugging.
These changes improve the scalability and maintainability of the plugin by leveraging configuration-driven logic and reducing hardcoded dependencies.
1.2.2-ALPHA.11Альфа1.21.6 · 23 июня 2025 г.
v1.2.2
This pull request updates the workflows for publishing packages, improves version handling, and refines command message functionality. The changes primarily focus on enhancing automation and user experience.
Workflow Updates
- Renamed the workflow to "Release & Publish Packages (Alpha Branch)" and added detailed comments for each step. Integrated publishing to GitHub Packages, Hangar, and Modrinth platforms.
- Renamed the workflow to "Release & Publish Packages (Beta Branch)" with similar updates as the Alpha workflow, including publishing to multiple platforms.
- Renamed the workflow to "Release & Publish Packages (Beta Branch)" and changed the branch trigger from
maintobeta. Added publishing steps for GitHub Packages, Hangar, and Modrinth.
Version Updates
- Updated the plugin version from
1.2.1to1.2.2and incremented thepaperVersionfrom1.21.5to1.21.6.
Command Improvements
- Enhanced the
/lyttleadmincommand to dynamically fetch the plugin version usingplugin.getDescription().getVersionand send messages using theplugin.message.sendMessageRawmethod.
Miscellaneous
- Removed the
permissionfield from thestaffcommand configuration.
Комментарии
Загружаем…