FlyCraft

# FlyCraft - Official Documentation ## Overview FlyCraft is a lightweight and powerful flight management plugin for Minecraft servers. It allows players to toggle flight mode, adjust flight speed, and integrate with Discord for remote management. With built-in metrics, update checking, and LuckPerms integration, it provides a complete flight control solution for your server. --- ## 1. Core Features - **Toggle Flight Mode** – Enable or disable flight for players - **Configurable Flight Duration** – Set limits on flight time - **Customizable Cooldown System** – Prevents excessive flight toggling - **Adjustable Fly Speed** – Speed levels from 1 (slowest) to 10 (fastest) - **Group-Based Permissions** – Group system with LuckPerms integration - Automatic group detection - Group-specific settings - Inherited permissions support - **Speed Restrictions** – Set maximum allowed speed per group - **Welcome Messages** – Display a message to new players - **Full Discord Integration** – Manage flights via Discord commands - **Update Checker** – Automatic version checking - **Discord Notifications** – Real-time flight activity tracking - **Multi-Language Support** – Dedicated language files in `lang/` folder - **Next-Gen Config Engine** – Comment-preserving automated updates and migrations - **LuckPerms Integration** – Seamless group-based permission management - **Folia Support** – Full support for Folia and modern server architectures --- ## 2. Commands ### 2.1 In-Game Commands | Command | Description | Permission | Aliases | | ------------------ | ------------------------------- | ------------------- | ------------------ | | `/fly ` | Toggle flying mode | `flycraft.use` | `flymode` | | `/flyspeed <1-10>` | Adjust flying speed | `flycraft.flyspeed` | N/A | | `/flycraftreload` | Reload the plugin configuration | `flycraft.reload` | `fcr`, `flyreload` | **Notes:** - Using `/fly ` requires additional `flycraft.others` permission - `/flyspeed` requires both `flycraft.flyspeed` and appropriate `flycraft.maxflyspeed.<1-10>` permission - Fly speed is adjustable from **1 (slowest) to 10 (fastest)** - Players can only set speeds up to their maximum allowed speed permission ### 2.2 Discord Commands | Command | Description | Requirements | | --------------------------- | ---------------------------------------- | -------------------------------- | | `!startfly <player>` | Enables flight for the specified player | Requires configured Discord role | | `!stopfly <player>` | Disables flight for the specified player | Requires configured Discord role | | `!flyspeed <player> <1-10>` | Sets the player’s flight speed | Requires configured Discord role | --- ## 3. Permissions ### 3.1 Basic Permissions | Permission | Description | Default | | ------------------- | ---------------------------------------- | ------- | | `flycraft.use` | Allows toggling flight mode | `op` | | `flycraft.flyspeed` | Allows changing flight speed | `op` | | `flycraft.flytime` | Allows using flight time commands | `op` | | `flycraft.reload` | Allows reloading the configuration | `op` | | `flycraft.others` | Allows managing flight for other players | `op` | ### 3.2 Speed Control Permissions | Permission | Description | Default | | ------------------------- | --------------------------------- | ------- | | `flycraft.maxflyspeed.1` | Allows setting fly speed up to 1 | `op` | | `flycraft.maxflyspeed.2` | Allows setting fly speed up to 2 | `op` | | `flycraft.maxflyspeed.3` | Allows setting fly speed up to 3 | `op` | | `flycraft.maxflyspeed.4` | Allows setting fly speed up to 4 | `op` | | `flycraft.maxflyspeed.5` | Allows setting fly speed up to 5 | `op` | | `flycraft.maxflyspeed.6` | Allows setting fly speed up to 6 | `op` | | `flycraft.maxflyspeed.7` | Allows setting fly speed up to 7 | `op` | | `flycraft.maxflyspeed.8` | Allows setting fly speed up to 8 | `op` | | `flycraft.maxflyspeed.9` | Allows setting fly speed up to 9 | `op` | | `flycraft.maxflyspeed.10` | Allows setting fly speed up to 10 | `op` | ### 3.3 Permission Groups | Permission | Description | Includes | | ------------ | ------------------------------- | ---------------------------- | | `flycraft.*` | Grants all FlyCraft permissions | All permissions listed above | --- ## 4. Permission Systems ### 4.1 Basic Permissions (All Permission Plugins) If you're using any permission plugin other than LuckPerms (like PermissionsEx, GroupManager, etc.), use these basic permissions to control access: - `flycraft.use` - Allow flight - `flycraft