P_Ilhas 1.5.8 — Complete SkyBlock Island System

P_Ilhas is a native island system for Paper 1.21.3 servers, designed to provide VOID worlds, private dimensions, native protection, progression, economy, pets, rankings, and production administration in one plugin.

Compatibility and requirements

Item	Requirement
Server	Paper 1.21.3; other 1.21.x versions should be validated before public use.
Java	Java 21.
Database	Embedded SQLite or MySQL 8+.
Schematics	WorldEdit or FastAsyncWorldEdit recommended; an emergency fallback is available.
Economy	Vault is optional for deposits and withdrawals through the server economy.
Placeholders	PlaceholderAPI is optional.
Holograms	DecentHolograms is optional; TextDisplay is used as fallback.

What the plugin provides

Islands and VOID worlds

Native island grid, fully empty Overworld, Nether, and End worlds, vanilla-generation protection, and per-dimension schematics.

Bundled schematics

Includes island.schem, island_nether.schem, and island_the_end.schem; uses WorldEdit or FAWE when available with an emergency fallback.

Safe full reset

Evacuates players, blocks access, recreates all three dimensions, clears configured state, reapplies schematics, and unlocks only after final persistence.

Managed End and dragon

Delayed dragon spawn, configurable name, optional block-damage prevention, safe main portal height, and lateral gateway removal.

Native protection

Protection without WorldGuard, exact building limits, visitor controls, interactions, fluids, redstone, mobs, explosions, and dozens of flags.

Members and roles

Owner, co-owner, manager, member, coop, and visitor roles with internal role permissions, invites, transfers, and administration.

Per-island dimensions

Unlockable Nether and End, on-demand generation, per-dimension homes and biomes, safe teleportation, and multidimensional reset.

Advanced pet system

One logical pet per island UUID, mob or skull visuals, MinecraftHeads URL support, movement, follow/stay, individual visibility, hunger, happiness, auto-feeding, levels, buffs, and penalties.

Holograms

Optional DecentHolograms hook with native TextDisplay fallback.

Missions

39 default missions organized by professions, per-category progression, 50% and completion notifications, rewards, and anti-abuse counting.

Upgrades

Configurable upgrades for border, members, warps, and other limits with requirements and menus.

Island bank

Persistent internal balance, deposits, withdrawals, interest, taxes, history, and optional Vault integration.

Reputation and visits

Positive or negative category voting, abuse protection, public islands, visit points, and nearby-island discovery.

Rankings and scoring

Pyramid rankings for level, bank, and dimension-specific Overworld, Nether, and End block scores with configurable block values.

Borders and biomes

Selectable borders, WorldBorder support, visualization, and per-dimension biomes limited to the island area.

Warps and coop

Upgrade-limited warps, temporary coop access, and access controls.

Persistence

SQLite with WAL or MySQL with HikariCP, versioned migrations, dirty autosave, and configuration backups.

Production diagnostics

Operation journal, failure recovery, local error reports, performance metrics, diagnostics, and beta feedback without external telemetry.

Languages and customization

PT-BR and EN-US, 38 configurable menus, messages, sounds, schematics, borders, biomes, upgrades, pets, and generators in YAML.

Integrations

PlaceholderAPI, Vault, WorldEdit, FastAsyncWorldEdit, and DecentHolograms, all optional depending on the feature.

Installation

1. Fully stop the server.
2. Place P_Ilhas-1.5.8.jar in the plugins folder.
3. Install WorldEdit or FAWE for schematic pasting, plus any optional integrations you need.
4. Start the server and wait for plugins/P_Ilhas to be created.
5. Set a safe spawn outside island worlds with /ilhasadmin setresetspawn.
6. Review config.yml, settings.yml, pets.yml, block-values.yml, menus, and languages.
7. Restart and validate creation, dimensions, reset, pet, bank, flags, and rankings in staging.

Safe update

Back up the JAR, plugins/P_Ilhas folder, database, and worlds. Replace only the JAR. The updater preserves customized values, adds missing keys, and creates backups before migrations. After startup, use /ilhasadmin diagnostico, /ilhasadmin metricas, and /ilhasadmin operacoes.

Configuration files

File	Purpose
config.yml	VOID worlds, dimensions, reset, bank, schematics, biomes, borders, upgrades, tasks, protection, starting mob, dragon, and maintenance.
settings.yml	Island flags, defaults, categories, icons, and individual permissions.
pets.yml	Visuals, MinecraftHeads, movement, hologram, foods, hunger, happiness, progression, effects, and pet protection.
block-values.yml	Value of each block, per-dimension multipliers, and score recount settings.
generators.yml	Block generators and levels.
menus/*.yml	Layouts, slots, icons, text, and actions for every menu.
idiomas/pt_br.yml	Portuguese messages.
idiomas/en_us.yml	English messages.
missoes/<categoria>/*.yml	Mission categories and individual missions.
schematics/islands/	Schematics for all three dimensions and additional island templates.
pets-data.yml	Persistent pet state and visual preferences.

Bundled schematics

File	Dimension
island.schem	Overworld
island_nether.schem	Nether
island_the_end.schem	End

Important systems

Full reset

Reset can restore flags, internal permissions, upgrades, missions, warps, visit settings, reputation, pet, bank, level, experience, border, name, icon, scores, and block records. Owner, members, and dimension unlocks can be preserved by configuration. Players are evacuated and access remains blocked until completion.

End and dragon

The island End is VOID, uses its own generation height, and has a managed main portal at a safe height. Dragon spawn can be delayed, named with the owner, prevented from breaking blocks, and prevented from creating lateral gateways.

Block scoring

All missing block materials are added to block-values.yml with 1 point by default. Values and Overworld, Nether, and End multipliers can be customized. Scores update through events and incremental recounts.

Island pet

Each island has one logical pet identified by UUID. It can be a mob or head, accept MinecraftHeads URLs, follow or stay, search for food, receive affection, level up, and apply bonuses or penalties. The visual can be hidden per player without disabling the system.

Bank and Vault

The internal bank works without Vault. When integration is enabled, deposits and withdrawals use the server economy. Yield, taxes, and history remain persistent.

Flags in all dimensions

Flags apply to the island Overworld, Nether, and End. Day, weather, flight, water, lava, redstone, and other changes are applied at runtime.

Internal island roles

Role	Purpose
OWNER	Full island control and ownership transfer.
CO_OWNER	Advanced management below the owner.
MANAGER	Operational management according to internal role permissions.
MEMBER	Regular member access.
COOP	Configurable temporary access.
VISITOR	Access limited by island flags.

Internal role actions include building, breaking, containers, interaction, redstone, spawners, mob damage, invites, kicks, upgrades, missions, bank, home, warps, settings, roles, reset, renaming, coop, and deletion.

Player commands

Command	Purpose
/ilha	Opens the main island menu.
/ilha criar [modelo]	Creates an island or opens the schematic selector.
/ilha deletar	Starts deletion of the player island.
/ilha deletar confirmar	Confirms island deletion.
/ilha resetar	Starts a full island reset.
/ilha resetar confirmar [modelo]	Confirms the reset and optionally selects another schematic.
/ilha home	Teleports to the island home in the current dimension.
/ilha sethome	Sets the island home at the current location.
/ilha spawn	Teleports to the configured safe spawn.
/ilha visitar <jogador>	Visits another player public island.
/ilha visitas	Opens the public island visit list.
/ilha sairvisita	Leaves the current visit and returns to a safe location.
/ilha setvisit	Sets the public visit location.
/ilha delvisit	Removes the public visit location.
/ilha reputacao [jogador]	Opens reputation for the current, owned, or selected island.
/ilha vizinhas	Shows nearby islands by distance and direction.
/ilha membros	Opens member and role management.
/ilha convidar <jogador>	Invites a player to the island.
/ilha aceitar	Accepts the pending island invite.
/ilha recusar	Declines the pending island invite.
/ilha expulsar <jogador>	Removes a member from the island.
/ilha sair	Leaves the current island; owners must transfer or delete first.
/ilha cargo <jogador> <cargo>	Changes a member role.
/ilha transferir <jogador>	Prepares island ownership transfer.
/ilha transferir confirmar	Confirms ownership transfer.
/ilha coop <jogador>	Grants temporary coop access.
/ilha descoop <jogador>	Removes temporary coop access.
/ilha coops	Lists players with coop access.
/ilha missoes	Opens island mission categories and missions.
/ilha upgrades	Opens the upgrades menu.
/ilha upgrade [id]	Buys an upgrade by ID or opens the menu.
/ilha borda	Shows the current island border.
/ilha borda selecionar <id>	Selects an unlocked border style.
/ilha bordas	Opens the border menu.
/ilha banco	Opens the internal island bank.
/ilha depositar <valor|all>	Deposits money into the island bank.
/ilha sacar <valor|all>	Withdraws money from the island bank.
/ilha config	Opens island settings and flags.
/ilha top	Opens pyramid-style rankings.
/ilha nivel	Shows island level and experience.
/ilha info	Shows a full island summary.
/ilha setwarp <nome>	Creates or updates an island warp.
/ilha delwarp <nome>	Deletes an island warp.
/ilha warp <nome>	Teleports to an island warp.
/ilha warps	Opens the warp list.
/ilha biomas	Opens the per-dimension biome menu.
/ilha dimensoes	Opens the dimensions menu.
/ilha nether	Teleports to the island Nether.
/ilha end	Teleports to the island End.
/ilha mundo	Returns to the island Overworld.
/ilha pet	Opens the pet menu.
/ilha pet status	Shows mood, hunger, happiness, level, and experience.
/ilha pet seguir	Makes the pet follow the player.
/ilha pet ficar	Makes the pet stay at its current position.
/ilha pet alternar	Toggles between follow and stay.
/ilha pet chamar	Calls the pet near the player.
/ilha pet visual	Hides or shows the pet only for that player.
/ilha pet recriar	Recreates the unique pet visual.
/ilha pet alimentos	Shows accepted and favorite foods.
/ilha pet nome <nome>	Changes the pet name.
/ilha reportar <mensagem>	Submits local controlled-beta feedback.
/ilha afk	Toggles or checks AFK status.
/ilha ajuda	Shows command help.

Administrative commands

Command	Permission	Purpose
/ilhasadmin reload	pilhas.admin.reload	Reloads compatible settings, menus, and services.
/ilhasadmin criar <jogador> [modelo]	pilhas.admin.create	Creates an island for a player.
/ilhasadmin deletar <jogador>	pilhas.admin.delete	Deletes an island through the administrative flow.
/ilhasadmin forcedelete <jogador>	pilhas.admin.forcedelete	Forces island deletion with operation logging.
/ilhasadmin resetar <jogador> [modelo]	pilhas.admin.reset	Fully resets a player island.
/ilhasadmin setresetspawn	pilhas.admin.setspawn	Sets the safe spawn used for reset, void, and recovery.
/ilhasadmin tp <jogador>	pilhas.admin.tp	Teleports to a player island.
/ilhasadmin menu [jogador]	pilhas.admin.menu	Opens the administrative panel.
/ilhasadmin editar <jogador>	pilhas.admin.menu	Opens administrative island editing.
/ilhasadmin setlevel <jogador> <nível>	pilhas.admin.level	Sets island level.
/ilhasadmin addxp <jogador> <valor>	pilhas.admin.xp	Adds island experience.
/ilhasadmin removexp <jogador> <valor>	pilhas.admin.xp	Removes island experience.
/ilhasadmin setxp <jogador> <valor>	pilhas.admin.xp	Sets island experience.
/ilhasadmin setupgrade <jogador> <upgrade> <nível>	pilhas.admin.upgrade	Sets an upgrade level.
/ilhasadmin resetupgrade <jogador> <upgrade>	pilhas.admin.upgrade	Resets one upgrade.
/ilhasadmin resetupgrades <jogador>	pilhas.admin.upgrade	Resets all upgrades.
/ilhasadmin completarMissao <jogador> <missão>	pilhas.admin.mission	Completes a mission for a player.
/ilhasadmin resetarMissao <jogador> <missão>	pilhas.admin.mission	Resets one mission.
/ilhasadmin progressoMissao <jogador> <missão> <valor>	pilhas.admin.mission	Sets mission progress.
/ilhasadmin resetarMissoes <jogador>	pilhas.admin.mission	Resets all player and island missions.
/ilhasadmin setborda <jogador> <borda>	pilhas.admin.border	Selects a border style.
/ilhasadmin setborder <jogador> <tamanho>	pilhas.admin.border	Sets border size.
/ilhasadmin setting <jogador> <flag> <true|false>	pilhas.admin.settings	Changes a specific island flag.
/ilhasadmin settings <jogador>	pilhas.admin.settings	Opens or lists island flags.
/ilhasadmin info <jogador>	pilhas.admin.info	Shows administrative island information.
/ilhasadmin top	pilhas.admin.recalculate	Refreshes or checks rankings.
/ilhasadmin debug	pilhas.admin.debug	Shows technical debug information.
/ilhasadmin banco <jogador> <add|remove|set|historico> [valor]	pilhas.admin.bank	Manages island bank balance and history.
/ilhasadmin afk <jogador>	pilhas.admin.debug	Checks or manages AFK state.
/ilhasadmin nome <jogador> <nome>	pilhas.admin.settings	Renames an island.
/ilhasadmin lock <jogador>	pilhas.admin.lock	Locks an island.
/ilhasadmin unlock <jogador>	pilhas.admin.lock	Unlocks an island.
/ilhasadmin resetlimit <jogador> [valor]	pilhas.admin.resetlimit	Changes or resets the reset limit.
/ilhasadmin setvisit <jogador>	pilhas.admin.tp	Sets an island visit point.
/ilhasadmin delvisit <jogador>	pilhas.admin.tp	Removes an island visit point.
/ilhasadmin setcargo <jogador> <membro> <cargo>	pilhas.admin.roles	Changes a member role.
/ilhasadmin removemembro <jogador> <membro>	pilhas.admin.members	Administratively removes a member.
/ilhasadmin addmembro <jogador> <membro> [cargo]	pilhas.admin.members	Administratively adds a member.
/ilhasadmin transferir <jogador> <novo dono>	pilhas.admin.transfer	Administratively transfers ownership.
/ilhasadmin schematic <jogador> <modelo>	pilhas.admin.schematic	Applies or changes a schematic.
/ilhasadmin limpararea <jogador>	pilhas.admin.area	Clears the registered island area.
/ilhasadmin warps <jogador>	pilhas.admin.warps	Lists island warps.
/ilhasadmin delwarp <jogador> <warp>	pilhas.admin.warps	Administratively deletes a warp.
/ilhasadmin biome <jogador> <dimensão> <bioma>	pilhas.admin.biome	Sets a dimension biome.
/ilhasadmin applybiome <jogador> [dimensão]	pilhas.admin.biome	Reapplies the biome to the island area.
/ilhasadmin unlockdimension <jogador> <nether|end>	pilhas.admin.dimension	Unlocks a dimension.
/ilhasadmin lockdimension <jogador> <nether|end>	pilhas.admin.dimension	Locks a dimension.
/ilhasadmin generatedimension <jogador> <nether|end>	pilhas.admin.dimension	Generates a dimension on demand.
/ilhasadmin resetdimension <jogador> <nether|end>	pilhas.admin.dimension	Resets only one dimension.
/ilhasadmin tpdimen <jogador> <mundo|nether|end>	pilhas.admin.dimension	Teleports to an island dimension.
/ilhasadmin reputacao <jogador> <add|remove|reset> [valor]	pilhas.admin.reputation	Manages reputation.
/ilhasadmin diagnostico	pilhas.admin.diagnostics	Shows database, schema, integrations, islands, and errors.
/ilhasadmin metricas	pilhas.admin.diagnostics	Shows TPS, MSPT, memory, and internal timers.
/ilhasadmin operacoes	pilhas.admin.diagnostics	Lists recent critical operations.
/ilhasadmin feedback	pilhas.admin.diagnostics	Shows controlled-beta feedback records.

Player permissions

Permission	Default	Purpose
pilhas.use	Players	Use the main command and menu.
pilhas.create	Players	Create an island.
pilhas.delete	Players	Delete the owned island.
pilhas.reset	Players	Reset the owned island.
pilhas.home	Players	Use island home.
pilhas.sethome	Players	Set island home.
pilhas.spawn	Players	Use the safe spawn.
pilhas.visit	Players	Visit islands.
pilhas.reputation	Players	View reputation.
pilhas.reputation.vote	Players	Vote on reputation.
pilhas.reputation.bypass	Operators	Bypass voting limits.
pilhas.neighbors	Players	View nearby islands.
pilhas.members	Players	Open member management.
pilhas.invite	Players	Invite players.
pilhas.kick	Players	Kick members.
pilhas.role	Players	Change roles.
pilhas.transfer	Players	Transfer ownership.
pilhas.missions	Players	Use missions.
pilhas.upgrades	Players	Use upgrades.
pilhas.border	Players	Use borders.
pilhas.bank	Players	Use the island bank.
pilhas.settings	Players	Open island settings.
pilhas.top	Players	Open rankings.
pilhas.warp	Players	Use warps.
pilhas.info	Players	View island information.
pilhas.coop	Players	Grant coop access.
pilhas.descoop	Players	Remove coop access.
pilhas.coops	Players	List coop players.
pilhas.biome	Players	Open biomes.
pilhas.reset.unlimited	Operators	Bypass reset limits.
pilhas.pet	Players	Access the pet system.
pilhas.pet.control	Players	Control follow, stay, and call.
pilhas.pet.feed	Players	Feed and pet the companion.
pilhas.pet.visual	Players	Individually hide or show the visual.
pilhas.pet.rename	Players	Rename the pet.
pilhas.feedback	Players	Submit beta feedback.

Content, biome, dimension, and bypass permissions

Permission	Default	Purpose
pilhas.island.desert	Operators	Create or use the Desert island type.
pilhas.island.hard	Operators	Create or use the Hard island type.
pilhas.biome.forest	Operators	Use the Forest biome.
pilhas.biome.desert	Operators	Use the Desert biome.
pilhas.biome.snowy	Operators	Use the Snowy biome.
pilhas.biome.jungle	Operators	Use the Jungle biome.
pilhas.biome.cherry	Operators	Use the Cherry biome.
pilhas.biome.nether_wastes	Operators	Use the Nether Wastes biome.
pilhas.biome.crimson	Operators	Use the Crimson Forest biome.
pilhas.biome.warped	Operators	Use the Warped Forest biome.
pilhas.biome.end_highlands	Operators	Use the End Highlands biome.
pilhas.biome.small_end	Operators	Use the Small End Islands biome.
pilhas.dimension.nether	Operators	Unlock or access the Nether according to configuration.
pilhas.dimension.end	Operators	Unlock or access the End according to configuration.
pilhas.border.red	Operators	Use the red border.
pilhas.border.gold	Operators	Use the gold border.
pilhas.border.green	Operators	Use the green border.
pilhas.border.purple	Operators	Use the purple border.
pilhas.bypass.protection	Operators	Bypass island protection.
pilhas.bypass.border	Denied	Bypass the physical island limit; not automatically granted to operators.
pilhas.bypass.cooldown	Operators	Bypass regular cooldowns.
pilhas.antiexploit.bypass	Operators	Bypass anti-spam and double-click cooldowns.

Administrative permissions

Permission	Default	Purpose
pilhas.admin	Operators	General administrative access and fallback for administrative actions.
pilhas.admin.reload	Operators	Reloads compatible settings, menus, and services.
pilhas.admin.create	Operators	Creates an island for a player.
pilhas.admin.delete	Operators	Deletes an island through the administrative flow.
pilhas.admin.reset	Operators	Fully resets a player island.
pilhas.admin.tp	Operators	Removes an island visit point.
pilhas.admin.setspawn	Operators	Sets the safe spawn used for reset, void, and recovery.
pilhas.admin.level	Operators	Sets island level.
pilhas.admin.xp	Operators	Sets island experience.
pilhas.admin.upgrade	Operators	Resets all upgrades.
pilhas.admin.mission	Operators	Administratively manage missions.
pilhas.admin.border	Operators	Sets border size.
pilhas.admin.bank	Operators	Manages island bank balance and history.
pilhas.admin.menu	Operators	Opens administrative island editing.
pilhas.admin.settings	Operators	Renames an island.
pilhas.admin.roles	Operators	Changes a member role.
pilhas.admin.coop	Operators	Administratively manage coop access.
pilhas.admin.members	Operators	Administratively adds a member.
pilhas.admin.transfer	Operators	Administratively transfers ownership.
pilhas.admin.warps	Operators	Administratively deletes a warp.
pilhas.admin.schematic	Operators	Applies or changes a schematic.
pilhas.admin.area	Operators	Clears the registered island area.
pilhas.admin.lock	Operators	Unlocks an island.
pilhas.admin.resetlimit	Operators	Changes or resets the reset limit.
pilhas.admin.info	Operators	Shows administrative island information.
pilhas.admin.recalculate	Operators	Refreshes or checks rankings.
pilhas.admin.debug	Operators	Checks or manages AFK state.
pilhas.admin.forcedelete	Operators	Forces island deletion with operation logging.
pilhas.admin.biome	Operators	Reapplies the biome to the island area.
pilhas.admin.reputation	Operators	Manages reputation.
pilhas.admin.dimension	Operators	Teleports to an island dimension.
pilhas.admin.diagnostics	Operators	Shows controlled-beta feedback records.

Island flags

Each flag requires the listed individual permission. pilhas.settings.flag.* grants access to every flag. Operator status does not automatically grant pilhas.bypass.border.

ID	Name	Category	Default	Permission
always_day	Always day	Environment	Disabled	pilhas.settings.flag.always_day
always_night	Always night	Environment	Disabled	pilhas.settings.flag.always_night
clear_weather	Clear weather	Environment	Disabled	pilhas.settings.flag.clear_weather
lock_weather	Lock weather	Environment	Disabled	pilhas.settings.flag.lock_weather
visitors	Public visits	Visitors	Enabled	pilhas.settings.flag.visitors
island_name	Rename island	General	Enabled	pilhas.settings.flag.island_name
welcome_message	Welcome message	General	Enabled	pilhas.settings.flag.welcome_message
public_island	Public island	General	Enabled	pilhas.settings.flag.public_island
container_access	Visitor container access	Visitors	Disabled	pilhas.settings.flag.container_access
door_interact	Doors and trapdoors	Visitors	Disabled	pilhas.settings.flag.door_interact
button_interact	Buttons	Visitors	Disabled	pilhas.settings.flag.button_interact
lever_interact	Levers	Visitors	Disabled	pilhas.settings.flag.lever_interact
pressure_plate	Pressure plates	Visitors	Disabled	pilhas.settings.flag.pressure_plate
visitor_pickup	Visitor item pickup	Visitors	Disabled	pilhas.settings.flag.visitor_pickup
visitor_drop	Visitor item drop	Visitors	Disabled	pilhas.settings.flag.visitor_drop
item_frame	Item frames	Visitors	Disabled	pilhas.settings.flag.item_frame
armor_stand	Armor stands	Visitors	Disabled	pilhas.settings.flag.armor_stand
villager_interact	Villagers	Visitors	Disabled	pilhas.settings.flag.villager_interact
crafting	Crafting tables	Protection	Disabled	pilhas.settings.flag.crafting
furnace	Furnaces	Protection	Disabled	pilhas.settings.flag.furnace
anvil	Anvils	Protection	Disabled	pilhas.settings.flag.anvil
enchanting	Enchanting tables	Protection	Disabled	pilhas.settings.flag.enchanting
pvp	PvP	Security	Disabled	pilhas.settings.flag.pvp
explosions	Explosions	Security	Disabled	pilhas.settings.flag.explosions
ender_pearl	Ender pearls	Security	Disabled	pilhas.settings.flag.ender_pearl
chorus_fruit	Chorus fruit	Security	Disabled	pilhas.settings.flag.chorus_fruit
fire_spread	Fire spread	Security	Disabled	pilhas.settings.flag.fire_spread
lava_flow	Lava flow	Security	Disabled	pilhas.settings.flag.lava_flow
water_flow	Water flow	Security	Disabled	pilhas.settings.flag.water_flow
redstone	Redstone	Redstone	Enabled	pilhas.settings.flag.redstone
pistons	Pistons	Redstone	Enabled	pilhas.settings.flag.pistons
hoppers	Hoppers	Redstone	Disabled	pilhas.settings.flag.hoppers
dispensers	Dispensers	Redstone	Disabled	pilhas.settings.flag.dispensers
droppers	Droppers	Redstone	Disabled	pilhas.settings.flag.droppers
mob_spawn	Mob spawning	Mobs	Enabled	pilhas.settings.flag.mob_spawn
animal_spawn	Animal spawning	Mobs	Enabled	pilhas.settings.flag.animal_spawn
monster_spawn	Monster spawning	Mobs	Enabled	pilhas.settings.flag.monster_spawn
crop_trample	Crop trampling	Protection	Disabled	pilhas.settings.flag.crop_trample
fly_on_island	Island flight	General	Disabled	pilhas.settings.flag.fly_on_island
keep_inventory_on_island	Keep inventory on island	Security	Disabled	pilhas.settings.flag.keep_inventory_on_island
block_visitor_commands	Block visitor commands	Security	Enabled	pilhas.settings.flag.block_visitor_commands
afk_kick_visitors	Remove AFK visitors	Security	Disabled	pilhas.settings.flag.afk_kick_visitors
show_border_on_enter	Show border on entry	General	Enabled	pilhas.settings.flag.show_border_on_enter

Placeholders

Requires PlaceholderAPI. For players without an island, most placeholders return an empty value; has_island returns false.

Fixed placeholders

Placeholder	Returns
%pilhas_has_island%	Whether the player has an island.
%pilhas_island_name%	Island name.
%pilhas_island_owner%	Owner name.
%pilhas_island_level%	Island level.
%pilhas_island_xp%	Island experience.
%pilhas_island_status%	Island operation status.
%pilhas_island_locked%	Whether the island is locked.
%pilhas_island_members%	Member count.
%pilhas_island_member_limit%	Member limit.
%pilhas_island_border_size%	Current border size.
%pilhas_island_bank%	Formatted island bank balance.
%pilhas_bank_next_yield%	Next bank yield timestamp.
%pilhas_bank_total_yield%	Total yield received.
%pilhas_bank_total_tax%	Total tax paid.
%pilhas_bank_interest_rate%	Current interest rate.
%pilhas_island_rank_level%	Position in level ranking.
%pilhas_island_rank_bank%	Position in bank ranking.
%pilhas_island_score_overworld%	Overworld block score.
%pilhas_island_score_nether%	Nether block score.
%pilhas_island_score_end%	End block score.
%pilhas_island_score_total%	Combined score across all dimensions.
%pilhas_border_selected%	Selected border ID.
%pilhas_biome%	Biome in the current dimension.
%pilhas_biome_overworld%	Overworld biome.
%pilhas_biome_nether%	Nether biome.
%pilhas_biome_end%	End biome.
%pilhas_dimension%	Current island dimension.
%pilhas_island_dimension%	Alias for current island dimension.
%pilhas_world%	Current world name.
%pilhas_nether_unlocked%	Whether Nether is unlocked.
%pilhas_end_unlocked%	Whether End is unlocked.
%pilhas_nether_generated%	Whether Nether has been generated.
%pilhas_end_generated%	Whether End has been generated.
%pilhas_warps%	Warp count.
%pilhas_warp_limit%	Warp limit.
%pilhas_resets_used%	Used reset count.
%pilhas_resets_limit%	Reset limit.
%pilhas_resets_remaining%	Remaining resets; -1 means unlimited.
%pilhas_visit_enabled%	Whether public visiting is enabled.
%pilhas_reputation_positive%	Total positive votes.
%pilhas_reputation_negative%	Total negative votes.
%pilhas_reputation_total%	Total vote count.
%pilhas_reputation_score%	Formatted reputation score.
%pilhas_reputation_approval%	Approval percentage.
%pilhas_reputation_label%	Current reputation label.
%pilhas_neighbors_count%	Nearby island count.
%pilhas_afk%	Whether the player is AFK.
%pilhas_afk_time%	AFK time in seconds.
%pilhas_pet_name%	Pet name.
%pilhas_pet_mood%	Pet mood.
%pilhas_pet_mode%	Follow or stay mode.
%pilhas_pet_hunger%	Hunger from 0 to 100.
%pilhas_pet_happiness%	Happiness from 0 to 100.
%pilhas_pet_hunger_bar%	Visual hunger bar.
%pilhas_pet_happiness_bar%	Visual happiness bar.
%pilhas_pet_level%	Pet level.
%pilhas_pet_experience%	Total pet experience.
%pilhas_pet_level_xp%	XP earned in current level.
%pilhas_pet_level_required%	XP required for next level.
%pilhas_pet_level_percent%	Level progress percentage.
%pilhas_pet_level_bar%	Visual level progress bar.
%pilhas_pet_foods_eaten%	Foods eaten count.
%pilhas_pet_pets_received%	Petting count.
%pilhas_pet_uuid%	Unique logical pet UUID.

Dynamic placeholders

Pattern	Returns
%pilhas_reputation_category_<categoria>_positive%	Positive votes in a category.
%pilhas_reputation_category_<categoria>_negative%	Negative votes in a category.
%pilhas_reputation_category_<categoria>_total%	Total votes in a category.
%pilhas_reputation_category_<categoria>_score%	Formatted category score.
%pilhas_reputation_category_<categoria>_approval%	Category approval percentage.
%pilhas_mission_completed_<id>%	Whether the mission is completed.
%pilhas_mission_progress_<id>%	Current mission progress.
%pilhas_mission_required_<id>%	Required amount.
%pilhas_mission_status_<id>%	Status: locked, active, or completed.
%pilhas_mission_scope_<id>%	Mission scope.
%pilhas_mission_percent_<id>%	Progress percentage.
%pilhas_top_level_<posição>_<name|owner|value>%	Level ranking entry.
%pilhas_top_bank_<posição>_<name|owner|value>%	Bank ranking entry.
%pilhas_top_blocks_overworld_<posição>_<name|owner|value>%	Overworld block ranking entry.
%pilhas_top_blocks_nether_<posição>_<name|owner|value>%	Nether block ranking entry.
%pilhas_top_blocks_end_<posição>_<name|owner|value>%	End block ranking entry.
%pilhas_upgrade_level_<id>%	Upgrade level.
%pilhas_upgrade_<id>%	Alias for upgrade level.

For rankings, position is a number and the field may be name, owner, or value. Mission placeholders require the exact mission ID. Upgrade placeholders require the configured upgrade ID.

Public API

Other plugins may declare P_Ilhas as a dependency or soft dependency and obtain the public API. Bukkit operations must run on the main thread. The pet snapshot is immutable to prevent direct internal-state modification.

Method	Purpose
getIslands()	Read-only copy of loaded islands.
getIsland(UUID)	Gets an island by UUID.
getIslandByPlayer(UUID)	Gets the island linked to a player.
getIslandAt(Location)	Gets the island containing a location.
hasIsland(UUID)	Checks whether a player is linked to an island.
getReputation(UUID)	Returns reputation statistics.
getPet(UUID)	Returns an immutable PetSnapshot.
teleportHome(Player)	Teleports a player home using plugin validation.
invalidateCaches()	Invalidates public plugin caches.

Database, migrations, and recovery

The plugin supports local SQLite and MySQL through HikariCP. Migrations are versioned and transactional, recorded in schema_migrations, and rolled back on failure. Critical creation, reset, deletion, clearing, and pasting operations are written to an operation journal. If the server stops during an operation, the interrupted state is detected on the next startup.

Diagnostics, metrics, and reports

Path	Contents
reports/performance/performance-latest.yml	TPS, MSPT, memory, counters, and timers.
reports/errors/error-<id>.txt	Local exception reports with an ID.
reports/config-updates/	Safe configuration update reports.
backups/config/	Automatic backups before changes.

There is no external telemetry. Reports remain on the server. Review any report before publishing it.

Security and performance

• Protection against moving or stealing items from menus.
• Cooldowns against spam, double clicks, and excessive pet feeding.
• Pet entities unload when the island is empty.
• One logical pet per UUID with old duplicate cleanup.
• Cached rankings and incremental block recounting.
• Autosave only for changed islands.
• Configurable limits for hoppers, spawners, chunks, and tasks.
• Temporary writes and atomic replacement when supported.
• Player evacuation and access blocking during destructive operations.

Pre-release checklist

• [ ] Set the safe spawn outside island worlds.
• [ ] Test creation and reset across all three dimensions.
• [ ] Test void death and safe respawn.
• [ ] Test dragon and portal behavior without nearby island blocks.
• [ ] Test water, lava, redstone, visitor, and mob flags.
• [ ] Test mob and skull pets, individual visibility, and server restart.
• [ ] Test Vault, PlaceholderAPI, WorldEdit or FAWE, and DecentHolograms together.
• [ ] Run diagnostics, metrics, and operation checks.
• [ ] Back up before enabling public resets and deletions.

Credits

Developed by Pedro for Paper 1.21.3.