PlaceholderAPI, Vault, and External Menus

PlaceholderAPI expansion

When PlaceholderAPI is installed, AeroOneBlock registers its internal expansion; no separate eCloud download is required. Every identifier uses %aerooneblock_<key>%.

Island and player keys

• has_island, is_owner, island_id, island_index
• owner, owner_uuid, members, members_online, trusted, banned
• warp_public, language, deleting, recreate_remaining
• center_x, center_y, center_z, home coordinates, and managed world names

Tier and level keys

• breaks, player_breaks, stage, stage_name, stage_start, stage_end
• stage_current, stage_required, stage_remaining, stage_percent, stage_progress_bar
• next_stage, next_stage_name, next_stage_required, stage_blocks, stage_mobs, stage_crates
• level, island_level, level_points, level_calculating, rank

Upgrade keys

Summary keys include current_upgrades, total_upgrades, type counts, purchased levels, available levels, and remaining levels. Upgrade-specific keys cover current/next level, current/next effective value, cost, and every requirement category for border, members, hoppers, mobs, pistons, generator, generator_luck, mob_drops, and crop_drops.

Examples:

%aerooneblock_piston_limit_current%
%aerooneblock_piston_limit_next%
%aerooneblock_generator_tier%
%aerooneblock_generator_next_block_pool%
%aerooneblock_upgrade_hoppers_required_blocks_remaining%

Placeholder requests read immutable snapshots rather than scanning worlds or files. A value may therefore lag by one configured snapshot refresh interval.

Vault economy

Vault is a bridge, not an account balance provider. Any positive recreation or upgrade cost requires both Vault and a compatible economy plugin. Missing providers, insufficient balances, and failed withdrawals prevent the operation. Zero costs do not require Vault.

External menus

Built-in menus may be disabled globally or by page while commands remain active. A DeluxeMenus item can dispatch normal player commands:

left_click_commands:
  - '[player] ob home'
  - '[player] ob upgrade hoppers'

External dispatch does not bypass AeroOneBlock permission, ownership, island-state, or upgrade-requirement checks.