Перейти к содержимому
Mineforgian

LyttleAdmin

A powerful, lightweight staff management plugin with advanced moderation features!

Загрузки
205
Подписчики
0
Обновлён
24 августа 2025 г.
Лицензия
MIT

Опубликован 22 июня 2025 г.

Lyttle Admin

Paper Hangar Discord

A powerful, lightweight staff management plugin with advanced moderation features!

📚 Features⌨️ Commands🔑 Permissions📥 Installation⚙️ Configuration📱 Support

Divider

🌟 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

  1. Download the latest version from Hangar
  2. Place the .jar file in your server's plugins folder
  3. Restart your server
  4. Edit the configuration files to customize messages and settings
  5. Use /staff to 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

  1. Backup Reference: Contains original copies of all configuration files
  2. Reset Option: Use these to restore default settings
  3. Update Safety: Preserved during plugin updates
  4. Documentation: Shows all available options with comments

💡 Never modify files in the #defaults folder! They are automatically overwritten during server restarts.


💬 Support

🤝 Need Help?

Discord

🐛 Found a bug? Open an Issue
💡 Have a suggestion? Share your idea


📜 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

Divider

Ченджлог

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.yml and alpha.yml GitHub Actions workflows into a single unified workflow file, release-and-publish.yml, which now handles releases for both the main and alpha branches. 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.properties from 1.2.6 to 1.2.7.

Codebase Refactoring:

  • Replaced usage of the Config class with the new YamlConfig class in Configs.java, updating both instance variables and constructor usage accordingly.
  • Refactored action bar handling in StaffCommand.java to use the shared ActionBar utility class, removing the custom setActionBar method 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.yml and .github/workflows/alpha.yml with a single .github/workflows/release-and-publish.yml workflow. This new workflow handles both main and alpha branches, 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.6 to 1.2.7 in gradle.properties. (gradle.properties gradle.propertiesL2-R2)

Codebase Refactoring:

Config Handling:

Action Bar Handling:

  • Refactored the action bar logic in StaffCommand: replaced the custom setActionBar implementation with the shared ActionBar.setActionBar utility, removing duplicate code and centralizing action bar management. (src/main/java/com/lyttldev/lyttleadmin/commands/StaffCommand.java [1] [2] [3]
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 main branch instead of the beta branch for package publishing.

Version Updates:

  • Incremented the plugin version from 1.2.4 to 1.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 main branch instead of the beta branch for package publishing.

Version Updates:

  • Incremented the plugin version from 1.2.4 to 1.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 ActionsConfig to use camelCase (onEnable and onDisable) for consistency.
  • Removed unused imports and logging references in StaffCommand.java for cleaner code.

Action Bar Enhancements:

  • Added support for dynamic action bar messages in RoleAction with new actionBar property.
  • Replaced the old actionBar method in StaffCommand.java with a more flexible setActionBar method, allowing custom messages and clearing the action bar when needed.

Configuration Updates:

  • Updated default configuration files (config.yml and #defaults/config.yml) to include action_bar messages for admin and moderator roles.
  • Corrected role-related tags in configuration files to distinguish between admin and moderator actions.

Role Action Mapping:

  • Enhanced RolesConfigLoader to map action_bar property from configuration files to RoleAction objects.

Version Update:

  • Updated pluginVersion in gradle.properties from 1.2.3 to 1.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 pluginVersion to 1.2.3 and paperVersion to 1.21.8 in gradle.properties for compatibility with newer versions.
  • Default Configs: Added defaultGeneral configuration in Configs.java to support default values for general settings.

Role Management Refactoring:

  • Dynamic Role Actions: Replaced hardcoded role management methods (giveRole, removeRole, etc.) with a centralized runActions method 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 onStaffModeEnabled and onStaffModeDisabled logic to use the new runActions method, removing redundant methods like onStaffModeEnabledAdmin and onStaffModeEnabledModerator.
  • Utility Enhancements: Added RolesConfigLoader utility 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 pluginVersion to 1.2.3 and paperVersion to 1.21.8 in gradle.properties for compatibility with newer versions.
  • Default Configs: Added defaultGeneral configuration in Configs.java to support default values for general settings.

Role Management Refactoring:

  • Dynamic Role Actions: Replaced hardcoded role management methods (giveRole, removeRole, etc.) with a centralized runActions method 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 onStaffModeEnabled and onStaffModeDisabled logic to use the new runActions method, removing redundant methods like onStaffModeEnabledAdmin and onStaffModeEnabledModerator.
  • Utility Enhancements: Added RolesConfigLoader utility 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 main to beta. Added publishing steps for GitHub Packages, Hangar, and Modrinth.

Version Updates

  • Updated the plugin version from 1.2.1 to 1.2.2 and incremented the paperVersion from 1.21.5 to 1.21.6.

Command Improvements

  • Enhanced the /lyttleadmin command to dynamically fetch the plugin version using plugin.getDescription().getVersion and send messages using the plugin.message.sendMessageRaw method.

Miscellaneous

  • Removed the permission field from the staff command configuration.

Комментарии

Загружаем…