ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Towny插件Hook集成指南:对接Vault经济与LuckPerms权限的完整方案

Towny插件Hook集成指南:对接Vault经济与LuckPerms权限的完整方案 Towny插件Hook集成指南对接Vault经济与LuckPerms权限的完整方案【免费下载链接】TownyTowny Advanced Minecraft plugin for Bukkit/Spigot.项目地址: https://gitcode.com/gh_mirrors/to/TownyTowny 是一款功能强大的 Minecraft Bukkit/Spigot 城镇管理插件支持玩家建立城镇、组建国家、圈地建设。它的核心玩法之一是通过内置的 Hook 机制与Vault 经济插件和LuckPerms 权限插件无缝对接让你的服务器经济系统与权限系统活起来。本指南面向新手带你看懂 Towny 插件如何自动检测并集成第三方插件只需几分钟即可完成对接。 Towny 的插件检测机制一切从启动开始Towny 在服务器启动时会自动扫描 plugins 文件夹中的第三方插件无需手动配置。这一逻辑集中在插件集成入口 PluginIntegrations.java 中权限源检测按优先级自动选择 LuckPerms → GroupManager → Vault → Bukkit 原生权限经济系统检测优先通过 Vault 或 Reserve 桥接你的经济插件如 EssentialsX附加插件检测PlaceholderAPI、TheNewChat、EliteMobs、Citizens2 等plugin.yml 中声明了softdepend: [Vault, Reserve, TheNewChat, PlaceholderAPI, GroupManager, LuckPerms, CoreProtect]这意味着这些插件是软依赖——装了就自动生效不装也完全不影响 Towny 运行。 启动后查看控制台日志Towny 会打印出检测到的权限源、经济系统和插件版本方便你确认集成是否成功。 对接 Vault 经济三步完成配置Towny 的经济系统由 TownyEconomyHandler.java 统一管理支持四种经济模式Vault、Reserve、VaultUnlocked 和 NONE。第一步安装 Vault 与经济插件在服务器上同时安装以下插件缺一不可Vault经济桥接器Towny 通过它调用经济插件一款具体经济插件如 EssentialsX Economy、CMI 等任何支持 Vault 的插件第二步确认配置开关在 Towny 的global.yml中检查经济开关对应配置节点定义见 ConfigNodes.javaeconomy.using_economy默认true启用 Towny 的全部经济功能。Towny 会优先尝试 Vault找不到再直接寻找支持的经济插件。如果两者都没有玩家将无法创建城镇或执行任何涉及金钱的操作。economy.use_async默认true异步执行经济查询减少服务器卡顿。第三步验证集成启动服务器后控制台会显示类似Economy: Vault vX.X的信息。Towny 内部通过 VaultEconomyProvider.java 获取 Vault 注册的 Economy 服务实现玩家、城镇、国家三级账户的存取款、税收等完整经济流程。集成成功后的效果功能说明城镇建设费圈地时从玩家账户自动扣除每日税收居民向城镇、城镇向国家自动缴纳城镇/国家金库独立的政府账户BankAccount罚款与死亡惩罚击杀、囚禁等事件的金钱结算 对接 LuckPerms 权限双重集成方案Towny 与 LuckPerms 的集成分为两个层面权限源替换和上下文Contexts注入。层面一自动替换为 LuckPerms 权限源当 Towny 检测到服务器安装了 LuckPerms 时会自动将权限源切换为 LuckPermsSource.java无需任何配置。它的作用包括向玩家发放/移除城镇与国家的权限节点来自 townyperms.yml读取 LuckPerms 中玩家和主分组的前缀/后缀prefix/suffix用于城镇列表、地图显示等在线玩家实时查询上下文离线玩家使用静态查询选项这意味着你在 LuckPerms 中设置的玩家前缀后缀会直接显示在 Towny 的界面里无需额外配置。层面二开启 Towny 上下文实现按城镇身份授权这是最强大也最容易被忽略的功能开启后Towny 会向 LuckPerms 注入一系列动态上下文让你可以根据玩家的城镇身份和实时位置精确授权。开启方法在global.yml中设置plugin.interfacing.luckperms.contexts默认false→ 改为true该开关的逻辑见 TownySettings.java 的isContextsEnabled()注册逻辑位于 LuckPermsContexts.java。可用的上下文清单上下文含义示例值towny:town玩家所属城镇城镇名称towny:nation玩家所属国家国家名称towny:resident是否拥有城镇true / falsetowny:nation_resident是否拥有国家true / falsetowny:mayor是否镇长true / falsetowny:king是否国王true / falsetowny:townrank玩家城镇军衔citizen、officer 等towny:nationrank玩家国家军衔同上towny:insidetown是否身处城镇领地true / falsetowny:insideowntown是否在自己的城镇true / falsetowny:insideownplot是否在自己的领地true / falsetowny:plot_type_at_player当前所处地块类型house、shop 等towny:istownconquered城镇是否被征服true / false实战示例只允许国王在本国境内使用末影水晶在 LuckPerms 中创建分组附加权限end.chest.use设置上下文条件towny:kingtrue且towny:insideownplotfalse这样权限会随玩家的身份和位置实时变化管理粒度远超传统的分组方案。⚙️ 常见问题排查Q1控制台提示 No compatible Economy plugins found说明没找到 Vault/Reserve 或可用经济插件。请安装 Vault 一款经济插件或在不使用经济的服务器上把economy.using_economy设为false。Q2为什么我的权限插件没有生效Towny 的权限源优先级为TownyPerms内置始终存在→ LuckPerms → GroupManager → Vault → Bukkit 原生。安装了 LuckPerms 就会自动优先使用它日志中会显示实际选用的权限源及版本。Q3Towny 前缀后缀不显示Towny 通过 Vault 的 Chat 接口VaultPermSource或 LuckPerms 直连读取前缀后缀。如果使用的是 Vault请确认服务器安装了 Vault 的 Chat 实现插件如 LuckPerms 本身即可作为实现且 Towny 日志中 Chat 字段已正确显示。Q4旧版本插件冲突Towny 启动时会自动检查常见冲突并输出警告例如旧版 PowerRanks低于 1.10.8会覆盖 Towny 的权限发放MyCommand 的默认/t别名会抢占/t命令。请按照日志提示升级或移除即可。 小结集成对象配置文件项默认状态效果Vault 经济economy.using_economy开启自动桥接经济插件实现税收、金库LuckPerms 权限源无需配置自动权限发放 前缀后缀读取LuckPerms 上下文plugin.interfacing.luckperms.contexts关闭13 种动态上下文按身份/位置授权Towny 的 Hook 集成设计非常零配置装好插件、打开开关重启服务器即可。掌握本文的三步 Vault 对接法和 LuckPerms 双层面集成你就能为服务器打造一套身份感拉满的城镇经济体系统。【免费下载链接】TownyTowny Advanced Minecraft plugin for Bukkit/Spigot.项目地址: https://gitcode.com/gh_mirrors/to/Towny创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表