Permission Preflight

Permission Preflight previews whether block, container, entity, and item interactions are likely allowed before you attempt them.

It is a Forge quality-of-life utility built for multiplayer servers, protected areas, spawn regions, adventure-mode zones, and modded setups where it is not always clear whether something is broken, restricted, claimed, or simply unavailable.

---

What it helps with

Permission Preflight can help answer:

• Can I break this block?
• Can I place here?
• Can I open this chest?
• Can I interact with this block or entity?
• Is this a permission issue, claim issue, protection issue, or setup issue?

The mod displays a compact HUD overlay when it has useful information. It is informational only and does not bypass or grant permissions.

---

Supported actions

Permission Preflight can check:

• Break block
• Place block
• Use/interact with block
• Open container
• Interact with entity
• Attack entity
• Use item on block

---

Result types

Permission Preflight reports results as:

• Allowed — available checks found no restriction
• Denied — the action is likely blocked
• Partial — some part of the action may be possible, but the result is incomplete or mixed
• Unknown — no provider could verify the action

Unknown is a normal result. It means the mod did not have enough information to safely say Allowed or Denied.

---

HUD overlay

The overlay is designed to stay compact and out of the way.

By default:

• Denied results are shown
• Partial results are shown
• Allowed results are hidden unless enabled in config
• Unknown results are hidden in normal mode unless enabled or detailed mode is active

Detailed mode can show:

• Action being checked
• Provider name
• Confidence level
• Cache freshness
• Provider trace details

The overlay can be configured to appear above the hotbar or near the crosshair.

---

Chat warnings

When a player attempts an action that was predicted as denied, Permission Preflight can show a short chat warning.

Warnings are rate-limited to avoid spam.

Example:

Preflight: likely denied — cannot open containers here.

---

Providers

Permission Preflight 1.0.0 includes:

Vanilla provider

Checks common vanilla restrictions such as:

• Spectator mode
• Adventure/build restrictions
• World border
• Spawn protection
• Missing or unloaded target blocks
• Missing or dead target entities

Recent observation provider

Watches cancelled Forge interaction events and briefly remembers recent denied actions.

This can help identify restrictions from protection systems after a failed attempt, even without a direct claim-mod integration.

---

Claim mod support

Permission Preflight does not currently include direct API adapters for FTB Chunks, Open Parties and Claims, Flan, or other claim mods.

There are no hard dependencies on claim mods. Missing claim mods will not crash the game.

Claim-related denials may still appear after a cancelled interaction through the recent observation provider.

---

Commands

• /preflight here
  Checks your currently targeted block or entity.

• /preflight debug
  Toggles detailed provider output and detailed overlay mode.

• /preflight reload
  Reports config reload/live config behavior. Requires permission level 2.

---

Config

Config options include:

• enableOverlay
• overlayPosition
• showAllowed
• showUnknownInNormalMode
• showProviderInDetailedMode
• showConfidenceInDetailedMode
• useColorEmphasis
• compactOverlay
• maxReasonLength
• enableChatWarnings
• warningCooldownTicks
• requestRateLimitPerSecond
• cacheTtlTicks
• maxInteractionReachBlocks
• enableVanillaProvider
• enableObservationProvider
• enableClaimAdapters
• debugLogging

Default networking behavior:

• requestRateLimitPerSecond: 4
• cacheTtlTicks: 20

---

Multiplayer behavior

Permission Preflight is designed for multiplayer and dedicated servers.

• Server-side checks are authoritative
• Client overlay only displays server responses
• Clients send requests only when needed
• Server validates target reach
• Clients cannot query arbitrary distant chunks or claims
• Results are briefly cached
• Missing server support degrades gracefully

Recommended setup:

• Singleplayer: install on the client
• Dedicated server: install on the server
• Best multiplayer setup: install on both server and clients
• Server-only: commands and server checks work, but clients without the mod will not see the overlay
• Client-only on a server without the mod: no server-authoritative results are available

---

Important notes

Permission Preflight does not:

• Grant permissions
• Bypass protections
• Disable claims
• Override server rules
• Force interactions to succeed
• Block actions by itself

It only reports what its available checks can determine.

---

Known limitations

• Without direct claim-mod adapters, some claim permissions cannot be predicted before the first attempted action.
• Some modded blocks may not expose enough vanilla information to classify every interaction perfectly.
• High latency can briefly delay overlay updates.
• Attack-entity checks are more limited than block and container checks.
• Unknown results are expected when no provider can verify the action.

---

Version

• Minecraft: 1.20.1
• Loader: Forge
• Forge: 47.4.20
• Java: 17
• Mod version: 1.0.0
• Mod ID: permission_preflight
• License: MIT
• Creator: Iljas