P_Ilha

插件

· 作者 Mr_Haruki

P_Ilhas 是专为 Paper 1.21.3 服务器打造的本地岛屿系统,旨在通过单一插件提供虚空世界、私人维度、原生保护、进度管理、经济系统、宠物、排行榜以及生产管理等丰富功能。

0 本站下载 0 关注 更新于 3 个月前

最新 2.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

P_Ilhas 1.5.8 — 完整的 SkyBlock 岛屿系统

P_Ilhas 是一个专为 Paper 1.21.3 服务器设计的原生岛屿系统,旨在通过一个插件提供虚空世界、私有维度、原生保护、进度系统、经济系统、宠物系统、排行榜以及生产管理等功能。

兼容性与要求

项目 要求
服务端 Paper 1.21.3;其他 1.21.x 版本应在公开使用前进行验证。
Java Java 21。
数据库 嵌入式 SQLite 或 MySQL 8+。
结构图 (Schematics) 建议使用 WorldEdit 或 FastAsyncWorldEdit;提供紧急备用方案。
经济系统 Vault 为可选,用于通过服务器经济系统进行存取款。
占位符 PlaceholderAPI 为可选。
全息显示 DecentHolograms 为可选;使用 TextDisplay 作为备用方案。

插件功能

岛屿与虚空世界

原生岛屿网格,完全空白的主世界、下界和末地世界,原版生成保护,以及按维度划分的结构图支持。

内置结构图

包含 island.schem、island_nether.schem 和 island_the_end.schem;在可用时使用 WorldEdit 或 FAWE,并配备紧急备用方案。

安全的全重置

疏散玩家,阻止访问,重建所有三个维度,清除配置的状态,重新应用结构图,并在最终持久化完成后才解锁。

管理的末地与龙

延迟的龙刷新,可配置的龙名,可选的方块破坏防止,安全的传送门高度,以及侧向传送门的移除。

原生保护

无需 WorldGuard 即可实现保护,精确的建筑限制,访客控制,交互控制,流体控制,红石控制,生物控制,爆炸控制以及数十种标志位(flags)。

成员与角色

拥有者、共同拥有者、管理员、成员、合作者和访客角色,具备内部角色权限、邀请、转让和管理功能。

按岛屿划分的维度

可解锁的下界和末地,按需生成,按维度的家园和生物群系,安全传送,以及多维度重置。

高级宠物系统

每个岛屿 UUID 对应一只逻辑宠物,支持实体或头颅视觉效果,MinecraftHeads URL 支持,移动行为,跟随/停留模式,独立可见性,饥饿度,快乐值,自动喂食,等级,增益效果以及惩罚机制。

全息显示

可选的 DecentHolograms 集成,带有原生的 TextDisplay 备用方案。

任务

39 个默认任务,按职业组织,按类别进度,50% 进度通知及完成通知,奖励机制,以及防滥用计数。

升级

可配置的边境、成员数量、传送点和其他限制条件的升级,包含要求和菜单。

岛屿银行

持久的内部余额,存取款,利息,税收,历史记录,以及可选的 Vault 集成。

声誉与访问

正负类别投票,防滥用保护,公共岛屿,访问点数,以及邻近岛屿的发现功能。

排行榜与评分

针对等级、银行余额以及特定维度的主世界、下界和末地方块得分的金字塔式排行榜,支持可配置的方块价值。

边境与生物群系

可选的边境样式,WorldBorder 支持,可视化展示,以及仅限于岛屿区域的按维度生物群系。

传送点与合作

受升级限制的传送点,临时合作访问权限,以及访问控制。

数据持久化

支持带 WAL 模式的 SQLite 或带 HikariCP 的 MySQL,版本化的迁移脚本,脏数据自动保存,以及配置文件备份。

生产管理诊断

操作日志,故障恢复,本地错误报告,性能指标,诊断工具,以及无需外部遥测数据的 Beta 反馈。

语言与自定义

支持 PT-BR 和 EN-US,38 个可配置的菜单、消息、音效、结构图、边境、生物群系、升级、宠物和发电机,均通过 YAML 文件配置。

集成支持

PlaceholderAPI、Vault、WorldEdit、FastAsyncWorldEdit 和 DecentHolograms,具体取决于所需功能均为可选。

安装

  1. 完全停止服务器。
  2. 将 P_Ilhas-1.5.8.jar 放入 plugins 文件夹。
  3. 安装 WorldEdit 或 FAWE 以用于结构图粘贴,并安装任何您需要的可选集成插件。
  4. 启动服务器并等待 plugins/P_Ilhas 目录创建完成。
  5. 设置一个位于岛屿世界之外的安全重生点,使用命令 /ilhasadmin setresetspawn。
  6. 检查 config.yml、settings.yml、pets.yml、block-values.yml、菜单和语言文件。
  7. 重启服务器,并在测试环境中验证创建、维度、重置、宠物、银行、标志位和排行榜功能。

安全更新

备份 JAR 文件、plugins/P_Ilhas 文件夹、数据库和世界文件。仅替换 JAR 文件。更新程序会保留自定义值,添加缺失的键,并在迁移前创建备份。启动后,使用 /ilhasadmin diagnostico、/ilhasadmin metricas 和 /ilhasadmin operacoes 进行检查。

配置文件

文件 用途
config.yml 虚空世界、维度、重置、银行、结构图、生物群系、边境、升级、任务、保护、初始生物、龙和维护。
settings.yml 岛屿标志位、默认值、类别、图标和个别权限。
pets.yml 视觉效果、MinecraftHeads、移动、全息显示、食物、饥饿、快乐、进度、效果和宠物保护。
block-values.yml 每个方块的价值、按维度的乘数以及分数重算设置。
generators.yml 方块生成器和等级。
menus/*.yml 每个菜单的布局、槽位、图标、文本和操作。
idiomas/pt_br.yml 葡萄牙语消息。
idiomas/en_us.yml 英语消息。
missoes/<categoria>/*.yml 任务类别和单个任务。
schematics/islands/ 所有三个维度的结构图及其他岛屿模板。
pets-data.yml 持久化的宠物状态和视觉偏好。

内置结构图

文件 维度
island.schem 主世界
island_nether.schem 下界
island_the_end.schem 末地

重要系统

完全重置

重置可恢复标志、内部权限、升级、任务、传送点、访问设置、声望、宠物、银行、等级、经验值、边界、名称、图标、分数和方块记录。所有者、成员和维度解锁可通过配置保留。玩家将被疏散,且在完成前访问将保持封锁状态。

末地与龙

岛屿的末地(End)为虚空(VOID),使用其自身的高度生成逻辑,并在安全高度设有管理的主传送门。龙的生成可以延迟,并以所有者命名;可防止其破坏方块以及创建横向传送门。

方块计分

所有缺失的方块材料均添加到 block-values.yml 中,默认值为 1 分。数值以及主世界(Overworld)、下界(Nether)和末地(End)的倍数均可自定义。分数通过事件和增量重算进行更新。

岛屿宠物

每个岛屿都有一个由 UUID 标识的逻辑宠物。它可以是生物或头颅,支持 MinecraftHeads URL,具备跟随或停留、寻找食物、接受 affection(喜爱/互动)、升级以及应用增益或减益的功能。系统功能启用时,可针对特定玩家隐藏宠物的视觉效果。

银行与 Vault

内部银行无需 Vault 即可工作。启用集成后,存款和取款操作将使用服务器经济系统。收益、税收和历史记录均保持持久化。

全维度标志

标志适用于岛屿的主世界(Overworld)、下界(Nether)和末地(End)。昼夜、天气、飞行、水流、岩浆、红石等更改将在运行时应用。

内部岛屿角色

角色 用途
OWNER 完整的岛屿控制权及所有权转移。
CO_OWNER 低于所有者的高级管理权限。
MANAGER 根据内部角色权限进行运营管理。
MEMBER 普通成员访问权限。
COOP 可配置的临时访问权限。
VISITOR 受岛屿标志限制的访问权限。

内部角色操作包括建造、破坏、容器交互、红石、刷怪笼、生物伤害、邀请、踢出、升级、任务、银行、家园、传送点、设置、角色、重置、重命名、合作模式以及删除。

玩家命令

命令 用途
/ilha 打开主岛屿菜单。
/ilha criar [modelo] 创建岛屿或打开结构图选择器。
/ilha deletar 开始删除玩家的岛屿。
/ilha deletar confirmar 确认岛屿删除。
/ilha resetar 开始完全重置岛屿。
/ilha resetar confirmar [modelo] 确认重置,并可选选择另一个结构图。
/ilha home 传送到当前维度的岛屿家园。
/ilha sethome 在当前位置设置岛屿家园。
/ilha spawn 传送到配置的安全出生点。
/ilha visitar <jogador> 访问另一位玩家公开的岛屿。
/ilha visitas 打开公开岛屿访问列表。
/ilha sairvisita 离开当前访问并返回安全位置。
/ilha setvisit 设置公开访问位置。
/ilha delvisit 移除公开访问位置。
/ilha reputacao [jogador] 打开当前、拥有或选定的岛屿的声望界面。
/ilha vizinhas 按距离和方向显示附近的岛屿。
/ilha membros 打开成员和角色管理界面。
/ilha convidar <jogador> 邀请玩家加入岛屿。
/ilha aceitar 接受待处理的岛屿邀请。
/ilha recusar 拒绝待处理的岛屿邀请。
/ilha expulsar <jogador> 从岛屿中移除一名成员。
/ilha sair 离开当前岛屿;所有者必须先转移或删除岛屿。
/ilha cargo <jogador> <cargo> 更改成员角色。
/ilha transferir <jogador> 准备岛屿所有权转移。
/ilha transferir confirmar 确认所有权转移。
/ilha coop <jogador> 授予临时合作访问权限。
/ilha descoop <jogador> 移除临时合作访问权限。
/ilha coops 列出拥有合作访问权限的玩家。
/ilha missoes 打开岛屿任务分类和任务界面。
/ilha upgrades 打开升级菜单。
/ilha upgrade [id] 通过 ID 购买升级或打开菜单。
/ilha borda 显示当前岛屿边界。
/ilha borda selecionar <id> 选择已解锁的边界样式。
/ilha bordas 打开边界菜单。
/ilha banco 打开内部岛屿银行。
/ilha depositar <valor|all> 向岛屿银行存入资金。
/ilha sacar <valor|all> 从岛屿银行取出资金。
/ilha config 打开岛屿设置和标志。
/ilha top 打开金字塔式排行榜。
/ilha nivel 显示岛屿等级和经验值。
/ilha info 显示完整的岛屿摘要信息。
/ilha setwarp <nome> 创建或更新岛屿传送点。
/ilha delwarp <nome> 删除岛屿传送点。
/ilha warp <nome> 传送到岛屿传送点。
/ilha warps 打开传送点列表。
/ilha biomas 打开各维度的生物群系菜单。
/ilha dimensoes 打开维度菜单。
/ilha nether 传送到岛屿的下界。
/ilha end 传送到岛屿的末地。
/ilha mundo 返回岛屿的主世界。
/ilha pet 打开宠物菜单。
/ilha pet status 显示情绪、饥饿度、幸福感、等级和经验值。
/ilha pet seguir 使宠物跟随玩家。
/ilha pet ficar 使宠物停留在当前位置。
/ilha pet alternar 在跟随和停留之间切换。
/ilha pet chamar 将宠物召唤到玩家附近。
/ilha pet visual 仅对该玩家隐藏或显示宠物。
/ilha pet recriar 重新生成独特的宠物外观。
/ilha pet alimentos 显示接受的和喜爱的食物。
/ilha pet nome <nome> 更改宠物名称。
/ilha reportar <mensagem> 提交本地受控测试版的反馈。
/ilha afk 切换或检查 AFK(空闲)状态。
/ilha ajuda 显示命令帮助。

管理员命令

命令 权限 用途
/ilhasadmin reload pilhas.admin.reload 重新加载兼容的设置、菜单和服务。
/ilhasadmin criar <jogador> [modelo] pilhas.admin.create 为玩家创建一座岛屿。
/ilhasadmin deletar <jogador> pilhas.admin.delete 通过管理流程删除一座岛屿。
/ilhasadmin forcedelete <jogador> pilhas.admin.forcedelete 强制删除岛屿并记录操作日志。
/ilhasadmin resetar <jogador> [modelo] pilhas.admin.reset 完全重置玩家的岛屿。
/ilhasadmin setresetspawn pilhas.admin.setspawn 设置用于重置、虚空和恢复的安全重生点。
/ilhasadmin tp <jogador> pilhas.admin.tp 传送至某玩家的岛屿。
/ilhasadmin menu [jogador] pilhas.admin.menu 打开管理面板。
/ilhasadmin editar <jogador> pilhas.admin.menu 打开岛屿的管理编辑界面。
/ilhasadmin setlevel <jogador> <nível> pilhas.admin.level 设置岛屿等级。
/ilhasadmin addxp <jogador> <valor> pilhas.admin.xp 增加岛屿经验值。
/ilhasadmin removexp <jogador> <valor> pilhas.admin.xp 移除岛屿经验值。
/ilhasadmin setxp <jogador> <valor> pilhas.admin.xp 设置岛屿经验值。
/ilhasadmin setupgrade <jogador> <upgrade> <nível> pilhas.admin.upgrade 设置升级等级。
/ilhasadmin resetupgrade <jogador> <upgrade> pilhas.admin.upgrade 重置单个升级项。
/ilhasadmin resetupgrades <jogador> pilhas.admin.upgrade 重置所有升级项。
/ilhasadmin completarMissao <jogador> <missão> pilhas.admin.mission 为玩家完成一项任务。
/ilhasadmin resetarMissao <jogador> <missão> pilhas.admin.mission 重置单个任务。
/ilhasadmin progressoMissao <jogador> <missão> <valor> pilhas.admin.mission 设置任务进度。
/ilhasadmin resetarMissoes <jogador> pilhas.admin.mission 重置玩家和岛屿的所有任务。
/ilhasadmin setborda <jogador> <borda> pilhas.admin.border 选择一种边界样式。
/ilhasadmin setborder <jogador> <tamanho> pilhas.admin.border 设置边界大小。
/ilhasadmin setting <jogador> <flag> <true|false> pilhas.admin.settings 更改特定的岛屿标志(Flag)。
/ilhasadmin settings <jogador> pilhas.admin.settings 打开或列出岛屿标志(Flag)。
/ilhasadmin info <jogador> pilhas.admin.info 显示岛屿的管理信息。
/ilhasadmin top pilhas.admin.recalculate 刷新或检查排行榜。
/ilhasadmin debug pilhas.admin.debug 显示技术调试信息。
/ilhasadmin banco <jogador> <add|remove|set|historico> [valor] pilhas.admin.bank 管理岛屿银行余额和历史记录。
/ilhasadmin afk <jogador> pilhas.admin.debug 检查或管理空闲(AFK)状态。
/ilhasadmin nome <jogador> <nome> pilhas.admin.settings 重命名一座岛屿。
/ilhasadmin lock <jogador> pilhas.admin.lock 锁定一座岛屿。
/ilhasadmin unlock <jogador> pilhas.admin.lock 解锁一座岛屿。
/ilhasadmin resetlimit <jogador> [valor] pilhas.admin.resetlimit 更改或重置重置次数限制。
/ilhasadmin setvisit <jogador> pilhas.admin.tp 设置岛屿的访问点。
/ilhasadmin delvisit <jogador> pilhas.admin.tp 移除岛屿的访问点。
/ilhasadmin setcargo <jogador> <membro> <cargo> pilhas.admin.roles 更改成员的角色。
/ilhasadmin removemembro <jogador> <membro> pilhas.admin.members 管理上移除一名成员。
/ilhasadmin addmembro <jogador> <membro> [cargo] pilhas.admin.members 管理上添加一名成员。
/ilhasadmin transferir <jogador> <novo dono> pilhas.admin.transfer 管理上转移所有权。
/ilhasadmin schematic <jogador> <modelo> pilhas.admin.schematic 应用或更改结构图(Schematic)。
/ilhasadmin limpararea <jogador> pilhas.admin.area 清除已注册的岛屿区域。
/ilhasadmin warps <jogador> pilhas.admin.warps 列出岛屿的传送点(Warp)。
/ilhasadmin delwarp <jogador> <warp> pilhas.admin.warps 管理上删除一个传送点(Warp)。
/ilhasadmin biome <jogador> <dimensão> <bioma> pilhas.admin.biome 设置特定维度的生物群系。
/ilhasadmin applybiome <jogador> [dimensão] pilhas.admin.biome 将生物群系重新应用到岛屿区域。
/ilhasadmin unlockdimension <jogador> <nether|end> pilhas.admin.dimension 解锁一个维度。
/ilhasadmin lockdimension <jogador> <nether|end> pilhas.admin.dimension 锁定一个维度。
/ilhasadmin generatedimension <jogador> <nether|end> pilhas.admin.dimension 按需生成一个维度。
/ilhasadmin resetdimension <jogador> <nether|end> pilhas.admin.dimension 仅重置某个维度。
/ilhasadmin tpdimen <jogador> <mundo|nether|end> pilhas.admin.dimension 传送至岛屿的某个维度。
/ilhasadmin reputacao <jogador> <add|remove|reset> [valor] pilhas.admin.reputation 管理声望值。
/ilhasadmin diagnostico pilhas.admin.diagnostics 显示数据库、模式、集成、岛屿和错误信息。
/ilhasadmin metricas pilhas.admin.diagnostics 显示 TPS、MSPT、内存和内部计时器。
/ilhasadmin operacoes pilhas.admin.diagnostics 列出最近的关键操作。
/ilhasadmin feedback pilhas.admin.diagnostics 显示受控测试版的反馈记录。

玩家权限

权限 默认值 用途
pilhas.use Players 使用主命令和菜单。
pilhas.create Players 创建岛屿。
pilhas.delete Players 删除已拥有的岛屿。
pilhas.reset Players 重置已拥有的岛屿。
pilhas.home Players 使用岛屿家园。
pilhas.sethome Players 设置岛屿家园。
pilhas.spawn Players 使用安全出生点。
pilhas.visit Players 访问其他岛屿。
pilhas.reputation Players 查看声望。
pilhas.reputation.vote Players 对声望进行投票。
pilhas.reputation.bypass Operators 绕过投票限制。
pilhas.neighbors Players 查看附近岛屿。
pilhas.members Players 打开成员管理界面。
pilhas.invite Players 邀请玩家加入。
pilhas.kick Players 踢出成员。
pilhas.role Players 更改角色。
pilhas.transfer Players 转移所有权。
pilhas.missions Players 使用任务功能。
pilhas.upgrades Players 使用升级功能。
pilhas.border Players 使用边界功能。
pilhas.bank Players 使用岛屿银行。
pilhas.settings Players 打开岛屿设置。
pilhas.top Players 打开排行榜。
pilhas.warp Players 使用传送点。
pilhas.info Players 查看岛屿信息。
pilhas.coop Players 授予合作者访问权限。
pilhas.descoop Players 移除合作者访问权限。
pilhas.coops Players 列出合作者玩家。
pilhas.biome Players 打开生物群系选择。
pilhas.reset.unlimited Operators 绕过重置次数限制。
pilhas.pet Players 访问宠物系统。
pilhas.pet.control Players 控制跟随、停留和召唤。
pilhas.pet.feed Players 喂食和抚摸伙伴。
pilhas.pet.visual Players 单独隐藏或显示外观效果。
pilhas.pet.rename Players 重命名宠物。
pilhas.feedback Players 提交测试版反馈。

内容、生物群系、维度与绕过权限

权限 默认值 用途
pilhas.island.desert Operators 创建或使用沙漠岛屿类型。
pilhas.island.hard Operators 创建或使用困难岛屿类型。
pilhas.biome.forest Operators 使用森林生物群系。
pilhas.biome.desert Operators 使用沙漠生物群系。
pilhas.biome.snowy Operators 使用雪原生物群系。
pilhas.biome.jungle Operators 使用丛林生物群系。
pilhas.biome.cherry Operators 使用樱花生物群系。
pilhas.biome.nether_wastes Operators 使用下界荒地生物群系。
pilhas.biome.crimson Operators 使用绯红森林生物群系。
pilhas.biome.warped Operators 使用诡异森林生物群系。
pilhas.biome.end_highlands Operators 使用末地高地生物群系。
pilhas.biome.small_end Operators 使用小型末地岛生物群系。
pilhas.dimension.nether Operators 根据配置解锁或进入下界。
pilhas.dimension.end Operators 根据配置解锁或进入末地。
pilhas.border.red Operators 使用红色边界。
pilhas.border.gold Operators 使用金色边界。
pilhas.border.green Operators 使用绿色边界。
pilhas.border.purple Operators 使用紫色边界。
pilhas.bypass.protection Operators 绕过岛屿保护。
pilhas.bypass.border Denied 绕过物理岛屿限制;不会自动授予操作员。
pilhas.bypass.cooldown Operators 绕过常规冷却时间。
pilhas.antiexploit.bypass Operators 绕过反垃圾信息和双击冷却限制。

管理员权限

权限 默认值 用途
pilhas.admin Operators(管理员) 通用管理访问权限,并作为其他管理操作的回退权限。
pilhas.admin.reload Operators(管理员) 重新加载兼容的设置、菜单和服务。
pilhas.admin.create Operators(管理员) 为玩家创建一座岛屿。
pilhas.admin.delete Operators(管理员) 通过管理流程删除一座岛屿。
pilhas.admin.reset Operators(管理员) 完全重置玩家的岛屿。
pilhas.admin.tp Operators(管理员) 移除岛屿的传送点(visit point)。
pilhas.admin.setspawn Operators(管理员) 设置用于重置、虚空掉落和恢复的安全出生点。
pilhas.admin.level Operators(管理员) 设置岛屿等级。
pilhas.admin.xp Operators(管理员) 设置岛屿经验值。
pilhas.admin.upgrade Operators(管理员) 重置所有升级项。
pilhas.admin.mission Operators(管理员) 以管理方式管理任务。
pilhas.admin.border Operators(管理员) 设置边界大小。
pilhas.admin.bank Operators(管理员) 管理岛屿银行余额和历史记录。
pilhas.admin.menu Operators(管理员) 打开管理用岛屿编辑界面。
pilhas.admin.settings Operators(管理员) 重命名一座岛屿。
pilhas.admin.roles Operators(管理员) 更改成员的角色。
pilhas.admin.coop Operators(管理员) 以管理方式管理合作访问权限。
pilhas.admin.members Operators(管理员) 以管理方式添加成员。
pilhas.admin.transfer Operators(管理员) 以管理方式转移所有权。
pilhas.admin.warps Operators(管理员) 以管理方式删除一个传送点(warp)。
pilhas.admin.schematic Operators(管理员) 应用或更改预设结构(schematic)。
pilhas.admin.area Operators(管理员) 清除已注册的岛屿区域。
pilhas.admin.lock Operators(管理员) 解锁一座岛屿。
pilhas.admin.resetlimit Operators(管理员) 更改或重置重置次数限制。
pilhas.admin.info Operators(管理员) 显示岛屿的管理信息。
pilhas.admin.recalculate Operators(管理员) 刷新或检查排行榜。
pilhas.admin.debug Operators(管理员) 检查或管理闲置(AFK)状态。
pilhas.admin.forcedelete Operators(管理员) 强制删除岛屿并记录操作日志。
pilhas.admin.biome Operators(管理员) 将生物群系重新应用到岛屿区域。
pilhas.admin.reputation Operators(管理员) 管理声望。
pilhas.admin.dimension Operators(管理员) 传送到岛屿所在的维度。
pilhas.admin.diagnostics Operators(管理员) 显示受控测试版反馈记录。

岛屿标记(Island flags)

每个标记都需要上述列出的独立权限。拥有 pilhas.settings.flag.* 权限即可访问所有标记。Operator 状态不会自动授予 pilhas.bypass.border 权限。

ID 名称 分类 默认值 权限
always_day 始终白天 环境 禁用 pilhas.settings.flag.always_day
always_night 始终黑夜 环境 禁用 pilhas.settings.flag.always_night
clear_weather 清除天气 环境 禁用 pilhas.settings.flag.clear_weather
lock_weather 锁定天气 环境 禁用 pilhas.settings.flag.lock_weather
visitors 访客访问 访客 启用 pilhas.settings.flag.visitors
island_name 重命名岛屿 通用 启用 pilhas.settings.flag.island_name
welcome_message 欢迎消息 通用 启用 pilhas.settings.flag.welcome_message
public_island 公开岛屿 通用 启用 pilhas.settings.flag.public_island
container_access 访客容器访问权限 访客 禁用 pilhas.settings.flag.container_access
door_interact 门与陷阱门 访客 禁用 pilhas.settings.flag.door_interact
button_interact 按钮 访客 禁用 pilhas.settings.flag.button_interact
lever_interact 拉杆 访客 禁用 pilhas.settings.flag.lever_interact
pressure_plate 压力板 访客 禁用 pilhas.settings.flag.pressure_plate
visitor_pickup 访客拾取物品 访客 禁用 pilhas.settings.flag.visitor_pickup
visitor_drop 访客丢弃物品 访客 禁用 pilhas.settings.flag.visitor_drop
item_frame 物品展示框 访客 禁用 pilhas.settings.flag.item_frame
armor_stand 盔甲架 访客 禁用 pilhas.settings.flag.armor_stand
villager_interact 村民 访客 禁用 pilhas.settings.flag.villager_interact
crafting 工作台 保护 禁用 pilhas.settings.flag.crafting
furnace 熔炉 保护 禁用 pilhas.settings.flag.furnace
anvil 铁砧 保护 禁用 pilhas.settings.flag.anvil
enchanting 附魔台 保护 禁用 pilhas.settings.flag.enchanting
pvp PvP 安全 禁用 pilhas.settings.flag.pvp
explosions 爆炸 安全 禁用 pilhas.settings.flag.explosions
ender_pearl 末影珍珠 安全 禁用 pilhas.settings.flag.ender_pearl
chorus_fruit 紫颂果 安全 禁用 pilhas.settings.flag.chorus_fruit
fire_spread 火焰蔓延 安全 禁用 pilhas.settings.flag.fire_spread
lava_flow 岩浆流动 安全 禁用 pilhas.settings.flag.lava_flow
water_flow 水流 安全 禁用 pilhas.settings.flag.water_flow
redstone 红石 红石 启用 pilhas.settings.flag.redstone
pistons 活塞 红石 启用 pilhas.settings.flag.pistons
hoppers 漏斗 红石 禁用 pilhas.settings.flag.hoppers
dispensers 发射器 红石 禁用 pilhas.settings.flag.dispensers
droppers 投掷器 红石 禁用 pilhas.settings.flag.droppers
mob_spawn 生物生成 生物 启用 pilhas.settings.flag.mob_spawn
animal_spawn 动物生成 生物 启用 pilhas.settings.flag.animal_spawn
monster_spawn 怪物生成 生物 启用 pilhas.settings.flag.monster_spawn
crop_trample 作物踩踏 保护 禁用 pilhas.settings.flag.crop_trample
fly_on_island 岛屿飞行 通用 禁用 pilhas.settings.flag.fly_on_island
keep_inventory_on_island 在岛上保留物品栏 安全 禁用 pilhas.settings.flag.keep_inventory_on_island
block_visitor_commands 阻止访客使用命令 安全 启用 pilhas.settings.flag.block_visitor_commands
afk_kick_visitors 移除挂机访客 安全 禁用 pilhas.settings.flag.afk_kick_visitors
show_border_on_enter 进入时显示边界 通用 启用 pilhas.settings.flag.show_border_on_enter

占位符

需要 PlaceholderAPI。对于没有岛屿的玩家,大多数占位符返回空值;has_island 返回 false。

固定占位符

占位符 返回值
%pilhas_has_island% 玩家是否拥有岛屿。
%pilhas_island_name% 岛屿名称。
%pilhas_island_owner% 所有者名称。
%pilhas_island_level% 岛屿等级。
%pilhas_island_xp% 岛屿经验值。
%pilhas_island_status% 岛屿运行状态。
%pilhas_island_locked% 岛屿是否已锁定。
%pilhas_island_members% 成员数量。
%pilhas_island_member_limit% 成员上限。
%pilhas_island_border_size% 当前边界大小。
%pilhas_island_bank% 格式化后的岛屿银行余额。
%pilhas_bank_next_yield% 下次银行收益的时间戳。
%pilhas_bank_total_yield% 累计获得的总收益。
%pilhas_bank_total_tax% 累计支付的总税收。
%pilhas_bank_interest_rate% 当前利率。
%pilhas_island_rank_level% 在等级排行榜中的位置。
%pilhas_island_rank_bank% 在银行排行榜中的位置。
%pilhas_island_score_overworld% 主世界方块得分。
%pilhas_island_score_nether% 下界方块得分。
%pilhas_island_score_end% 末地方块得分。
%pilhas_island_score_total% 所有维度的综合得分。
%pilhas_border_selected% 选定的边界 ID。
%pilhas_biome% 当前维度中的生物群系。
%pilhas_biome_overworld% 主世界生物群系。
%pilhas_biome_nether% 下界生物群系。
%pilhas_biome_end% 末地生物群系。
%pilhas_dimension% 当前岛屿所在维度。
%pilhas_island_dimension% 当前岛屿维度的别名。
%pilhas_world% 当前世界名称。
%pilhas_nether_unlocked% 下界是否已解锁。
%pilhas_end_unlocked% 末地是否已解锁。
%pilhas_nether_generated% 下界是否已生成。
%pilhas_end_generated% 末地是否已生成。
%pilhas_warps% 传送点数量。
%pilhas_warp_limit% 传送点上限。
%pilhas_resets_used% 已使用的重置次数。
%pilhas_resets_limit% 重置次数上限。
%pilhas_resets_remaining% 剩余重置次数;-1 表示无限。
%pilhas_visit_enabled% 是否启用公共访问。
%pilhas_reputation_positive% 正面投票总数。
%pilhas_reputation_negative% 负面投票总数。
%pilhas_reputation_total% 投票总数。
%pilhas_reputation_score% 格式化后的声望分数。
%pilhas_reputation_approval% 支持率百分比。
%pilhas_reputation_label% 当前声望标签。
%pilhas_neighbors_count% 附近岛屿数量。
%pilhas_afk% 玩家是否处于 AFK(闲置)状态。
%pilhas_afk_time% AFK 时长(秒)。
%pilhas_pet_name% 宠物名称。
%pilhas_pet_mood% 宠物心情。
%pilhas_pet_mode% 跟随或停留模式。
%pilhas_pet_hunger% 饥饿值,范围 0 到 100。
%pilhas_pet_happiness% 幸福值,范围 0 到 100。
%pilhas_pet_hunger_bar% 可视化饥饿条。
%pilhas_pet_happiness_bar% 可视化幸福条。
%pilhas_pet_level% 宠物等级。
%pilhas_pet_experience% 宠物累计经验值。
%pilhas_pet_level_xp% 当前等级获得的经验值。
%pilhas_pet_level_required% 升级所需经验值。
%pilhas_pet_level_percent% 等级进度百分比。
%pilhas_pet_level_bar% 可视化等级进度条。
%pilhas_pet_foods_eaten% 喂食次数。
%pilhas_pet_pets_received% 抚摸次数。
%pilhas_pet_uuid% 唯一的逻辑宠物 UUID。

动态占位符

模式 返回值
%pilhas_reputation_category_<categoria>_positive% 某类别的正面投票数。
%pilhas_reputation_category_<categoria>_negative% 某类别的负面投票数。
%pilhas_reputation_category_<categoria>_total% 某类别的投票总数。
%pilhas_reputation_category_<categoria>_score% 格式化后的类别分数。
%pilhas_reputation_category_<categoria>_approval% 类别支持率百分比。
%pilhas_mission_completed_<id>% 任务是否已完成。
%pilhas_mission_progress_<id>% 当前任务进度。
%pilhas_mission_required_<id>% 所需数量。
%pilhas_mission_status_<id>% 状态:locked(锁定)、active(进行中)或 completed(已完成)。
%pilhas_mission_scope_<id>% 任务范围。
%pilhas_mission_percent_<id>% 进度百分比。
%pilhas_top_level_<posição>_<name|owner|value>% 等级排行榜条目。
%pilhas_top_bank_<posição>_<name|owner|value>% 银行排行榜条目。
%pilhas_top_blocks_overworld_<posição>_<name|owner|value>% 主世界方块排行榜条目。
%pilhas_top_blocks_nether_<posição>_<name|owner|value>% 下界方块排行榜条目。
%pilhas_top_blocks_end_<posição>_<name|owner|value>% 末地方块排行榜条目。
%pilhas_upgrade_level_<id>% 升级等级。
%pilhas_upgrade_<id>% 升级等级的别名。

对于排行榜,位置是一个数字,字段可以是 name(名称)、owner(所有者)或 value(数值)。任务占位符需要确切的任务 ID。升级占位符需要配置的升级 ID。

公共 API

其他插件可以将 P_Ilhas 声明为依赖项或软依赖项,并获取公共 API。Bukkit 操作必须在主线程上运行。宠物快照是不可变的,以防止直接修改内部状态。

方法 用途
getIslands() 加载岛屿的只读副本。
getIsland(UUID) 根据 UUID 获取岛屿。
getIslandByPlayer(UUID) 获取与玩家关联的岛屿。
getIslandAt(Location) 获取包含指定位置的岛屿。
hasIsland(UUID) 检查玩家是否与岛屿关联。
getReputation(UUID) 返回声望统计数据。
getPet(UUID) 返回不可变的 PetSnapshot。
teleportHome(Player) 使用插件验证将玩家传送回家。
invalidateCaches() 使插件的公共缓存失效。

数据库、迁移和恢复

该插件通过 HikariCP 支持本地 SQLite 和 MySQL。迁移操作具有版本控制且支持事务,记录在 schema_migrations 表中,并在失败时回滚。关键的创建、重置、删除、清理和粘贴操作会写入操作日志。如果服务器在操作过程中停止,下次启动时将检测中断状态。

诊断、指标与报告

路径 内容
reports/performance/performance-latest.yml TPS、MSPT、内存、计数器和计时器。
reports/errors/error-<id>.txt 带有 ID 的本地异常报告。
reports/config-updates/ 安全的配置更新报告。
backups/config/ 更改前的自动备份。

本插件无外部遥测功能。所有报告均保留在服务器上。在发布任何报告之前,请仔细审查。

安全与性能

  • 防止从菜单中移动或窃取物品。
  • 针对刷屏、双击和过度喂食宠物设置冷却时间。
  • 当岛屿为空时卸载宠物实体。
  • 每个 UUID 仅对应一个逻辑宠物,并清理旧的重复项。
  • 缓存排行榜并采用增量区块重新计数。
  • 仅对发生变化的岛屿进行自动保存。
  • 可配置的漏斗、刷怪笼、区块和任务限制。
  • 在支持的情况下使用临时写入和原子替换。
  • 在执行破坏性操作期间阻止玩家撤离和访问。

预发布检查清单

  • 将安全出生点设置在岛屿世界之外。
  • 测试在所有三个维度中的创建和重置功能。
  • 测试虚空死亡和安全重生。
  • 测试在没有附近岛屿方块的情况下龙和传送门的行为。
  • 测试水、岩浆、红石、访客和生物标志。
  • 测试生物和头颅宠物、单独可见性以及服务器重启。
  • 测试 Vault、PlaceholderAPI、WorldEdit 或 FAWE 以及 DecentHolograms 的协同工作。
  • 运行诊断、指标和操作检查。
  • 在启用公共重置和删除之前进行备份。

致谢

由 Pedro 为 Paper 1.21.3 开发。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源