Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

### Fixed
- `COMMANDS.md` now lists the exact messages `/fly` shows, including the permission-denied and console alerts, which the 1.0.0 entry below said it already did.
- `USER_GUIDE.md` and `COMMANDS.md` now say that the console alert is shown to any non-player sender, such as a command block, not only the server console.

## [1.0.0] - 2026-10-02

Expand Down
4 changes: 2 additions & 2 deletions COMMANDS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

| Command | Permission | Description |
|---------|------------|-------------|
| `/fly` | `FlyCommand.fly` | Toggles flight mode on or off for the executing player. Player-only; the console is rejected with an alert. Also available as `/flycommand:fly`, which reaches FlyCommand even if another plugin provides `/fly`. |
| `/fly` | `FlyCommand.fly` | Toggles flight mode on or off for the executing player. Player-only; the console and any other non-player sender, such as a command block, are rejected with an alert. Also available as `/flycommand:fly`, which reaches FlyCommand even if another plugin provides `/fly`. |

## `/fly` messages

Expand All @@ -11,4 +11,4 @@
| Player with `FlyCommand.fly`, flight was off | `Flight enabled.` | Flight is allowed. |
| Player with `FlyCommand.fly`, flight was on | `Flight disabled.` | Flight is disallowed. |
| Player without `FlyCommand.fly` | `Alert: Permission 'FlyCommand.fly' required.` | Flight is unchanged. |
| Server console | `Alert: Can't be used by console.` | Nothing else happens. |
| Server console, or any other non-player sender such as a command block | `Alert: Can't be used by console.` | Nothing else happens. |
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Thank you for your interest in contributing!
1. Fork the repository.
2. Create a feature branch from `main`: `git checkout -b feature/my-change`
3. Make your changes.
4. Run `mvn clean package`, which compiles the plugin and runs its tests; the [Build](.github/workflows/build.yml) workflow runs the same command on your pull request. If you change how `/fly` behaves, also follow the README's [manual validation steps](README.md#manual-validation-on-a-test-server) on a test server.
4. Run `mvn clean package`, which compiles the plugin and runs its tests; the [Build](.github/workflows/build.yml) workflow runs the same command on your pull request, then checks the plugin's Bukkit API use against every version in [`minecraft-versions.json`](minecraft-versions.json), which `mvn clean package` does not do. If you change how `/fly` behaves, also follow the README's [manual validation steps](README.md#manual-validation-on-a-test-server) on a test server.
5. Open a pull request against `main`.
6. Reference the related GitHub issue in your pull request description.

Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
FlyCommand is a Spigot plugin that lets permitted players toggle flight mode on and off with a single command. It adds one command, `/fly`, and nothing else — there is no configuration file and no persistent data.

## Supported Minecraft Versions
This plugin is supported on the Minecraft versions listed in [`minecraft-versions.json`](minecraft-versions.json): currently **1.19.4**, **1.21.11**, **26.2** and **26.3** (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and every build checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.
This plugin is supported on the Minecraft versions listed in [`minecraft-versions.json`](minecraft-versions.json): currently **1.19.4**, **1.21.11**, **26.2** and **26.3** (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and the [Build](.github/workflows/build.yml) workflow checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.

## Installation

Expand Down Expand Up @@ -48,7 +48,7 @@ Please open a bug report [here](https://github.com/Dans-Plugins/FlyCommand/issue

## Testing

`mvn clean package` compiles the plugin and runs its test suite. The suite checks the `plugin.yml` packed into the jar: that `main` names the plugin class, that the build filled in the version, and that the `Fly` command and the `FlyCommand.fly` permission are declared. It also runs the `/fly` handler against stand-in senders, checking the toggle and its confirmations (including when the command is typed as `/flycommand:fly`), the permission-denied alert, and the console alert. The [Build](.github/workflows/build.yml) workflow runs the same command on every push and pull request.
`mvn clean package` compiles the plugin and runs its test suite. The suite checks the `plugin.yml` packed into the jar: that `main` names the plugin class, that the build filled in the version, and that the `Fly` command and the `FlyCommand.fly` permission are declared. It also runs the `/fly` handler against stand-in senders, checking the toggle and its confirmations (including when the command is typed as `/flycommand:fly`), the permission-denied alert, and the console alert. The [Build](.github/workflows/build.yml) workflow runs the same command on every push to `main` and every pull request against it, then the Bukkit API check described under [Supported Minecraft Versions](#supported-minecraft-versions), which `mvn clean package` does not run.

The tests do not start a server, so the plugin loading and `/fly` being registered are still verified by hand on a Spigot or Paper server, as described under [Manual Validation](#manual-validation-on-a-test-server).

Expand All @@ -72,7 +72,7 @@ The jar is written to `target/FlyCommand-<version>.jar`. It is compiled for Java

### Releases

Every push to `main` that changes anything other than Markdown files or `LICENSE` republishes the rolling `dev` prerelease ([Dev Release](.github/workflows/dev-release.yml)). Stable releases are published from a verified `dev` build; a release published without a jar has one built and attached by [Release](.github/workflows/release.yml).
Every push to `main` that changes anything other than Markdown files or `LICENSE` republishes the rolling `dev` prerelease ([Dev Release](.github/workflows/dev-release.yml)); the workflow can also be run by hand, which republishes `dev` from whatever commit it is run on. Stable releases are published from a verified `dev` build; a release published without a jar has one built and attached by [Release](.github/workflows/release.yml).

### Manual Validation on a Test Server

Expand Down
2 changes: 1 addition & 1 deletion USER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Type `/fly` to toggle your flight on or off. The plugin will confirm the new sta

`/fly` can only be used by a player:

- Running it from the server console shows `Alert: Can't be used by console.` and does nothing else.
- Running it from the server console, or from anything else that is not a player, such as a command block, shows `Alert: Can't be used by console.` and does nothing else.
- Running it as a player without the `FlyCommand.fly` permission shows `Alert: Permission 'FlyCommand.fly' required.` and leaves flight unchanged.

## Permissions
Expand Down
Loading