# QuickAdmin - TBone Admin Tools

A lightweight Minecraft plugin providing essential admin commands for server management.

## Features

- `/heal <player>` - Restore a player's health to full and extinguish fire
- `/feed <player>` - Restore a player's hunger and saturation to maximum
- `/fly <player>` - Toggle flight mode for a player
- `/vanish <player>` - Toggle invisibility for staff members
- `/qa pro` - View QuickAdmin Pro upgrade features menu

### Additional Features

- **Command Logging**: All command usage is logged to the console for admin monitoring
- Successful executions: `"<sender> used /<command> on <target>"`
- Permission failures: `"<player> attempted /<command> without permission"`
- **Thread Safety**: Concurrent command execution supported via ConcurrentHashMap
- **Permission System**: Fine-grained control with wildcard support
- **Pro Features Preview**: Showcase premium features to drive upgrades

## Permissions

All commands require OP by default, or you can assign specific permissions:

- `quickadmin.*` - Grants access to all commands
- `quickadmin.heal` - Allow healing players
- `quickadmin.feed` - Allow feeding players
- `quickadmin.fly` - Allow toggling flight
- `quickadmin.vanish` - Allow toggling vanish mode
- `quickadmin.use` - Allow using `/qa` command

## Configuration

The plugin creates a `config.yml` file in the `plugins/QuickAdmin/` folder on first run.

### Config Options

```yaml
# Feature toggles
show-pro-upgrade: true # Display the Pro features upgrade menu via /qa command
```

- **show-pro-upgrade** (default: `true`)
- When `true`: `/qa` and `/qa pro` display the Pro features upgrade menu
- When `false`: `/qa` shows a basic message, `/qa pro` shows a disabled message
- Perfect for servers that don't want to promote the Pro version

## Building

This plugin uses Maven. To build:

```bash
mvn clean package
```

The compiled JAR will be in `target/QuickAdmin-1.0.jar`

## Installation

1. Build the plugin or download the JAR
2. Place `QuickAdmin-1.0.jar` in your server's `plugins/` folder
3. Restart your server
4. Use the commands with `/heal`, `/feed`, `/fly`, or `/vanish`

## Requirements

- Minecraft 1.21+
- Paper or Spigot server
- Java 21+

## Version Compatibility
QuickAdmin is tested on:
- Paper 1.20.1 (baseline)
- Paper 1.21.4 (latest)

To avoid “Outdated server/client” messages:
1. Match your Minecraft launcher version to your server’s version.
2. Use a stable Paper build (not mixed snapshots).
3. Place QuickAdmin-1.0.0.jar in plugins/ and start the server.

## Author

TBone
A lightweight Minecraft Paper plugin providing essential admin commands like heal, feed, fly, and vanish. Perfect for small servers and staff tools.