ClaimFly
PluginGPL-3.0-only

ClaimFly

Allows players to fly in their GriefPrevention claims.

51
Downloads
1
Followers
1 months ago
Updated
📦
4
Versions

📖About ClaimFly

ClaimFly Reloaded

A lightweight Paper plugin that allows players to fly inside GriefPrevention claims only, while keeping flight disabled everywhere else.

ClaimFly Reloaded is designed for survival servers that want convenient claim-based flight without giving players unrestricted creative-style flying.


Where does flight work?

Location Allowed
Your own claim ✅ Yes
Trusted player claim + permission ✅ Yes
Trusted player claim without permission ❌ No
Unclaimed land ❌ No
Admin claims + permission ✅ Yes

Players leaving allowed claims automatically lose managed flight.


Commands

Player

Command Permission Description
/claimfly claimfly.command Toggle claim flight
/cfly claimfly.command Alias for /claimfly
/claimfly boundary claimfly.commands.boundary.toggle Toggle claim boundary particles
/claimfly boundary <distance> claimfly.commands.boundary.set Set boundary particle distance

Admin

Command Permission Description
/claimfly reload claimfly.commands.admin Reload plugin config
/claimfly checkinterval <ticks> claimfly.commands.admin Change flight check interval
/claimfly version claimfly.commands.admin Show installed version
Permissions
Permission Default Description
claimfly.* OP Grants all ClaimFly permissions
claimfly.use false Allow claim-based flight
claimfly.command false Use /claimfly
claimfly.commands.admin false Admin commands
claimfly.commands.boundary.toggle false Toggle boundary particles
claimfly.commands.boundary.set false Change boundary distance
claimfly.claims.others false Fly in trusted player claims
claimfly.claims.admin false Fly in admin claims

Features

  • Flight inside owned claims
  • Optional flight in trusted player claims
  • Optional admin claim flight
  • Automatic flight disable outside allowed claims
  • Claim boundary particle visualization
  • Configurable messages and cooldowns
  • YAML or SQLite storage
  • Optional bStats metrics
  • Lightweight survival-friendly design
  • Supports GriefPrevention trust systems

Requirements

Requirement Version
Server Software Paper 1.21.11+
Java Java 21+
Dependencies GriefPrevention + Vault

Both GriefPrevention and Vault are required.


Installation

  1. Install GriefPrevention.
  2. Install Vault.
  3. Place ClaimFlyReloaded.jar into /plugins.
  4. Start or restart the server.
  5. Edit generated files in plugins/ClaimFly/.
  6. Configure permissions.
  7. Done.

Plugin Files

ClaimFly Reloaded generates:

Path Purpose
config.yml Main settings and storage
lang.yml Editable plugin messages
players.db SQLite player data (optional)
players/ YAML player data when using local storage
Configuration

Default config:

check-interval: 5
flight-toggle-cooldown: 10
storage: "sqlite"
enable-metrics: true

boundary:
  show-distance: 10
  show-by-default: true

Messages:

message:
  flight-toggle-on: "&aFlight enabled."
  flight-toggle-off: "&cFlight disabled."
  cannot-fly-outside-claims: "&cYou cannot fly outside claims."

Storage options:

storage: sqlite

or

storage: yaml
Important Behavior

ClaimFly Reloaded intentionally removes managed flight when players leave an allowed claim.

This prevents:

  • Keeping allowFlight outside claims
  • Flying through wilderness
  • Bypassing normal survival movement
  • Unintended protection from fall damage

ClaimFly does not grant unrestricted flight.

For flight inside another player's claim, both are required:

claimfly.claims.others

AND

GriefPrevention access trust.

Permission alone is not enough.


Important Notes

  • ClaimFly only manages flight inside allowed claims.
  • Unclaimed land never grants flight.
  • Access trust alone does not allow flight.
  • SQLite and YAML storage are supported.
  • Flight checks run on configurable intervals.
  • Boundary particles may be disabled by players.

Support

Found a bug or have a suggestion?

Open an issue with:

  • Server version
  • ClaimFly version
  • Console errors
  • Relevant config settings

Authors

  • HBOJ

Sponsored By

  • AsteroidMC

License

  • GPL-3.0