# Fly Plugin — Simple flight for survival servers

Author: simolzimol
Project page: https://www.spigotmc.org/resources/fly.83164/

---

## Overview

Fly is a lightweight, reliable Minecraft plugin that restores creative-like flying in survival mode. It’s designed to be simple for players and server admins: toggle flight for yourself or others, and optionally adjust flight speed. The plugin focuses on minimalism, performance, and easy customization.

## Key Features

- Toggle flight for yourself: `/fly`
- Toggle flight for others: `/fly <player>`
- Adjustable flight speed: `/fly speed <1-10>` and `/fly <player> speed <1-10>`
- Fully configurable messages and prefix (color codes supported with `&`)
- Live configuration reload: `/flyreload` (no server restart required)
- Optional command and permission-denied logging for admins
- Small footprint and compatibility across many server versions

## Commands & Permissions

- `/fly` — Toggle your own flight. Permission: `fly.fly`
- `/fly <player>` — Toggle another player's flight. Permission: `other.fly`
- `/fly speed <1-10>` — Set your flight speed (1 = slow, 10 = fast). Permission: `fly.speed`
- `/fly <player> speed <1-10>` — Set another player's flight speed. Permissions: `other.fly` and `fly.speed`
- `/flyreload` — Reload plugin config. Permission: `fly.reload`

## Configuration & Customization

The plugin creates a `config.yml` on first run. Main options include:

- `settings.prefix` — message prefix (supports color codes)
- `settings.use_prefix` — enable/disable prefix
- `messages.*` — all messages for toggles, speed changes, errors, etc.
- `settings.log_commands` / `settings.log_permission_denied`

Placeholders supported in messages:
- `{player}` — target player name
- `{sender}` — command sender
- `{prefix}` — configured message prefix

Important upgrade note: when updating to a new major release, delete the old `config.yml` before restarting the server so new keys and defaults are applied cleanly.

## Compatibility

- Native support: Minecraft 1.15
- Tested on: 1.15 — 1.21
- Server types: Spigot, Paper, Bukkit

## Installation

1. Download the latest JAR.
2. Put the JAR into your server `plugins/` folder.
3. Start the server so the plugin can generate `config.yml`.
4. Edit `config.yml` to customize messages and settings.
5. Use `/flyreload` to apply config changes without restarting.

## Use Cases

- Give VIPs temporary flight privileges
- Enable staff to fly for moderation and world-building
- Add creative-like movement to private plots and minigames

## Support & Contact

If you need help or want to request features, contact me on Discord: `simolzimol` or via the Spigot resource page. I welcome bug reports, suggestions, and pull requests.

## License & Source

Include whichever license you prefer (MIT recommended for simple plugins). Link to the project page and, if you publish the source, a GitHub repository.

---

If you want, I can also produce a short set of screenshots and a short changelog section you can paste on the site, or a ready-made HTML snippet for your webpage.