# 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//*.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 ` | 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 ` | Invites a player to the island. | | `/ilha aceitar` | Accepts the pending island invite. | | `/ilha recusar` | Declines the pending island invite. | | `/ilha expulsar ` | Removes a member from the island. | | `/ilha sair` | Leaves the current island; owners must transfer or delete first. | | `/ilha cargo ` | Changes a member role. | | `/ilha transferir ` | Prepares island ownership transfer. | | `/ilha transferir confirmar` | Confirms ownership transfer. | | `/ilha coop ` | Grants temporary coop access. | | `/ilha descoop ` | 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 ` | Selects an unlocked border style. | | `/ilha bordas` | Opens the border menu. | | `/ilha banco` | Opens the internal island bank. | | `/ilha depositar ` | Deposits money into the island bank. | | `/ilha sacar ` | 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 ` | Creates or updates an island warp. | | `/ilha delwarp ` | Deletes an island warp. | | `/ilha warp ` | 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 ` | Changes the pet name. | | `/ilha reportar ` | 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 [modelo]` | `pilhas.admin.create` | Creates an island for a player. | | `/ilhasadmin deletar ` | `pilhas.admin.delete` | Deletes an island through the administrative flow. | | `/ilhasadmin forcedelete ` | `pilhas.admin.forcedelete` | Forces island deletion with operation logging. | | `/ilhasadmin resetar [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 ` | `pilhas.admin.tp` | Teleports to a player island. | | `/ilhasadmin menu [jogador]` | `pilhas.admin.menu` | Opens the administrative panel. | | `/ilhasadmin editar ` | `pilhas.admin.menu` | Opens administrative island editing. | | `/ilhasadmin setlevel ` | `pilhas.admin.level` | Sets island level. | | `/ilhasadmin addxp ` | `pilhas.admin.xp` | Adds island experience. | | `/ilhasadmin removexp ` | `pilhas.admin.xp` | Removes island experience. | | `/ilhasadmin setxp ` | `pilhas.admin.xp` | Sets island experience. | | `/ilhasadmin setupgrade ` | `pilhas.admin.upgrade` | Sets an upgrade level. | | `/ilhasadmin resetupgrade ` | `pilhas.admin.upgrade` | Resets one upgrade. | | `/ilhasadmin resetupgrades ` | `pilhas.admin.upgrade` | Resets all upgrades. | | `/ilhasadmin completarMissao ` | `pilhas.admin.mission` | Completes a mission for a player. | | `/ilhasadmin resetarMissao ` | `pilhas.admin.mission` | Resets one mission. | | `/ilhasadmin progressoMissao ` | `pilhas.admin.mission` | Sets mission progress. | | `/ilhasadmin resetarMissoes ` | `pilhas.admin.mission` | Resets all player and island missions. | | `/ilhasadmin setborda ` | `pilhas.admin.border` | Selects a border style. | | `/ilhasadmin setborder ` | `pilhas.admin.border` | Sets border size. | | `/ilhasadmin setting ` | `pilhas.admin.settings` | Changes a specific island flag. | | `/ilhasadmin settings ` | `pilhas.admin.settings` | Opens or lists island flags. | | `/ilhasadmin info ` | `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 [valor]` | `pilhas.admin.bank` | Manages island bank balance and history. | | `/ilhasadmin afk ` | `pilhas.admin.debug` | Checks or manages AFK state. | | `/ilhasadmin nome ` | `pilhas.admin.settings` | Renames an island. | | `/ilhasadmin lock ` | `pilhas.admin.lock` | Locks an island. | | `/ilhasadmin unlock ` | `pilhas.admin.lock` | Unlocks an island. | | `/ilhasadmin resetlimit [valor]` | `pilhas.admin.resetlimit` | Changes or resets the reset limit. | | `/ilhasadmin setvisit ` | `pilhas.admin.tp` | Sets an island visit point. | | `/ilhasadmin delvisit ` | `pilhas.admin.tp` | Removes an island visit point. | | `/ilhasadmin setcargo ` | `pilhas.admin.roles` | Changes a member role. | | `/ilhasadmin removemembro ` | `pilhas.admin.members` | Administratively removes a member. | | `/ilhasadmin addmembro [cargo]` | `pilhas.admin.members` | Administratively adds a member. | | `/ilhasadmin transferir ` | `pilhas.admin.transfer` | Administratively transfers ownership. | | `/ilhasadmin schematic ` | `pilhas.admin.schematic` | Applies or changes a schematic. | | `/ilhasadmin limpararea ` | `pilhas.admin.area` | Clears the registered island area. | | `/ilhasadmin warps ` | `pilhas.admin.warps` | Lists island warps. | | `/ilhasadmin delwarp ` | `pilhas.admin.warps` | Administratively deletes a warp. | | `/ilhasadmin biome ` | `pilhas.admin.biome` | Sets a dimension biome. | | `/ilhasadmin applybiome [dimensão]` | `pilhas.admin.biome` | Reapplies the biome to the island area. | | `/ilhasadmin unlockdimension ` | `pilhas.admin.dimension` | Unlocks a dimension. | | `/ilhasadmin lockdimension ` | `pilhas.admin.dimension` | Locks a dimension. | | `/ilhasadmin generatedimension ` | `pilhas.admin.dimension` | Generates a dimension on demand. | | `/ilhasadmin resetdimension ` | `pilhas.admin.dimension` | Resets only one dimension. | | `/ilhasadmin tpdimen ` | `pilhas.admin.dimension` | Teleports to an island dimension. | | `/ilhasadmin reputacao [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__positive%` | Positive votes in a category. | | `%pilhas_reputation_category__negative%` | Negative votes in a category. | | `%pilhas_reputation_category__total%` | Total votes in a category. | | `%pilhas_reputation_category__score%` | Formatted category score. | | `%pilhas_reputation_category__approval%` | Category approval percentage. | | `%pilhas_mission_completed_%` | Whether the mission is completed. | | `%pilhas_mission_progress_%` | Current mission progress. | | `%pilhas_mission_required_%` | Required amount. | | `%pilhas_mission_status_%` | Status: locked, active, or completed. | | `%pilhas_mission_scope_%` | Mission scope. | | `%pilhas_mission_percent_%` | Progress percentage. | | `%pilhas_top_level__%` | Level ranking entry. | | `%pilhas_top_bank__%` | Bank ranking entry. | | `%pilhas_top_blocks_overworld__%` | Overworld block ranking entry. | | `%pilhas_top_blocks_nether__%` | Nether block ranking entry. | | `%pilhas_top_blocks_end__%` | End block ranking entry. | | `%pilhas_upgrade_level_%` | Upgrade level. | | `%pilhas_upgrade_%` | 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-.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.

P_Ilha

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details

is

pet

missions

top 10

end

ilhas

nether

upgrade