Kaizen Portals

插件

· 作者 KaizenCore

1个传送门,多个随机出口!

0 本站下载 0 关注 更新于 1 年前

最新 1.0-SNAPSHOT · 1.21.11 · Paper / Purpur

一键开服(送7天)

Kaizen Portals

一款全面的 Minecraft 传送门插件,通过多重出口点、高级管理系统和丰富的自定义选项,彻底革新了交通方式。

? 功能特性

核心传送门系统

  • 多个出口点:创建拥有无限出口目的地的传送门
  • 智能出口选择:提供多种模式供玩家选择退出方式:
    • FIRST(首个):始终使用第一个出口点
    • RANDOM(随机):随机选择一个出口点
    • SEQUENTIAL(顺序):按顺序循环遍历出口点
    • NEAREST(最近):传送至最近的出口点
  • 视觉效果:为传送门和出口点提供精美的粒子特效
  • 音效反馈:为传送门的使用提供沉浸式的音频反馈

GUI 管理系统

  • 直观界面:通过用户友好的图形用户界面 (/portal) 管理所有传送门
  • 传送门权杖工具:用于轻松管理传送门的交互式权杖
    • 左击方块以选择出口位置
    • 右击传送门以添加选定的出口
    • 右击空气以创建新传送门
    • 提供视觉反馈及重复检测
  • 传送门列表可视化:浏览所有传送门并查看详细信息
  • 出口点管理器:支持分页功能,可针对每个传送门添加、移除和配置出口点

高级功能

? 套装系统

在使用传送门时向玩家分发物品:

  • 13 种预配置套装:
    • Starter Kit - 基础生存物品
    • Builder Kit - 建筑素材
    • Warrior Kit - 战斗装备
    • Archer Kit - 远程战斗装备
    • Miner Kit - 挖掘工具和火把
    • Farmer Kit - 农业物资
    • Explorer Kit - 导航工具
    • Redstone Kit - 红石元件
    • Enchanter Kit - 附魔材料
    • Alchemist Kit - 酿造原料
    • Nether Kit - 下界生存装备
    • End Kit - 末路之地维度装备
    • VIP Kit - 高级物品
  • 冷却系统:通过可配置的冷却时间防止套装滥用
  • 一次性套装:可选择仅能领取一次的套装

? 权限系统

  • 传送门限额:为每个权限组设置最大传送门数量
  • 世界限制:控制玩家可以在哪些世界中创建传送门
  • 使用权限:对传送门的使用进行细粒度控制
  • 默认组:
    • portal2exit.basic - 10 个传送门,主世界/下界访问权限
    • portal2exit.vip - 20 个传送门,所有维度
    • portal2exit.mvp - 50 个传送门,所有维度
    • portal2exit.admin - 无限传送门,所有世界

? 经济集成

  • 创建费用:向玩家收取创建传送门的费用
  • 使用费用:设置每次使用传送门的成本
  • 阶梯定价:随着额外传送门的增加提高价格
  • 退款系统:移除传送门时可获得部分退款
  • 所有者收益:传送门所有者可从他人使用该传送门中获得收益
  • Vault 支持:与 Vault 经济系统完全集成

? 激活要求

通过以下方式控制谁可以使用传送门:

  • 物品要求:需要特定物品才能激活传送门
  • 权限要求:通过权限限制传送门的使用
  • 套装要求:要求玩家已获得特定套装
  • 消耗性物品:可选择在使用时消耗所需物品

技术特性

  • 跨版本支持:兼容 Minecraft 1.12.2 - 1.21+
  • 性能优化:高效的粒子渲染和传送门检测
  • 数据持久化:自动保存和加载传送门数据
  • 安全检查:具有障碍检测的传送安全性
  • 自动保存:可配置的自动数据保存

? 安装

  1. 从发布页面下载最新的 portal2exit-1.0-SNAPSHOT.jar
  2. 将其放入服务器的 plugins 文件夹中
  3. 重启服务器
  4. 在 plugins/Portal2Exit/config.yml 中配置插件

依赖要求

  • Paper/Spigot/Bukkit 服务器 1.12.2 或更高版本
  • Java 8 或更高版本
  • 可选:Vault(用于经济功能)

? 命令

基本命令

  • /portal - 打开传送门管理 GUI
  • /portal create <name> - 在你所在的位置创建新传送门
  • /portal remove <name> - 移除现有传送门
  • /portal list - 列出你所有的传送门
  • /portal tp <name> - 传送到指定传送门
  • /portal wand - 获取传送门权杖工具

出口管理

  • /portal addexit <name> - 将当前位置添加为出口点
  • /portal setexit <name> - 将当前位置设为唯一出口
  • /portal removeexit <name> <index> - 移除特定的出口点
  • /portal setexitmode <name> <mode> - 设置出口选择模式

配置

  • /portal reload - 重新加载配置
  • /portal setcost <name> <amount> - 设置传送门使用费用
  • /portal setkit <name> <kit> - 设置使用传送门时给予的套装
  • /portal setrequiredkit <name> <kit> - 设置使用所需的套装

管理员命令

  • /portal setowner <name> <player> - 更改传送门所有者
  • /portal info <name> - 查看详细的传送门信息
  • /portal removeall - 移除所有传送门(仅限管理员)

? 权限

基本权限

  • portal2exit.use - 使用传送门
  • portal2exit.create - 创建传送门
  • portal2exit.remove - 移除自己的传送门
  • portal2exit.wand - 使用传送门权杖
  • portal2exit.gui - 访问传送门 GUI

高级权限

  • portal2exit.unlimited - 绕过传送门限额
  • portal2exit.free - 绕过经济费用
  • portal2exit.admin - 完整的管理员访问权限
  • portal2exit.remove.others - 移除其他玩家的传送门
  • portal2exit.bypass.cooldown - 绕过冷却时间
  • portal2exit.bypass.requirements - 绕过激活要求

套装权限

  • portal2exit.kit.<kitname> - 访问特定套装
  • portal2exit.kit.all - 访问所有套装

⚙️ 配置

基本设置

plugin:
  debug: false
  auto-save-interval: 5  # 分钟

portals:
  max-portals-per-player: 10
  cooldown: 3  # 秒
  sounds-enabled: true
  particles-enabled: true

传送门创建

creation:
  required-item: "minecraft:ender_eye"
  required-base-block: "minecraft:obsidian"
  consume-item: true

经济设置

economy:
  enabled: false
  creation-cost: 1000.0
  scaling-multiplier: 0.5
  default-usage-cost: 10.0
  removal-refund-percentage: 50

出口传送门默认值

exit-portals:
  default-exit-type: "spawn"  # 选项:spawn, bed, custom
  custom-exit:
    world: "world"
    x: 0
    y: 64
    z: 0

? 使用示例

使用传送门法杖(推荐)

  1. 获取法杖:/portal wand
  2. 选择出口位置:左击你想让玩家传送到的方块
  3. 创建/管理传送门:站在你希望放置传送门的位置 5 格范围内
  4. 手持法杖右键点击,将出口点添加到传送门中
  5. 重复步骤 2-4 以添加多个出口点
  6. 左击空气以查看当前选定的位置

创建枢纽传送门(命令方法)

  1. 站在你的枢纽位置
  2. 运行 /portal create hub
  3. 前往目的地
  4. 运行 /portal addexit hub
  5. 对多个目的地重复此操作

设置 VIP 区域

  1. 创建传送门:/portal create vip-lounge
  2. 设置权限:/portal setrequiredpermission vip-lounge portal2exit.vip
  3. 添加费用:/portal setcost vip-lounge 100
  4. 添加套件奖励:/portal setkit vip-lounge vip

构建地牢系统

  1. 创建入口:/portal create dungeon-entrance
  2. 在地牢的不同层级添加多个出口
  3. 设置模式:/portal setexitmode dungeon-entrance SEQUENTIAL
  4. 玩家按顺序通过各个层级

? 故障排除

传送门无法工作

  • 检查你是否拥有 portal2exit.use 权限
  • 验证是否满足激活要求
  • 确保冷却时间已过
  • 检查传送门是否有出口点

经济功能无法工作

  • 安装 Vault 插件
  • 安装一个经济插件(如 EssentialsX 等)
  • 在 config.yml 中启用经济功能
  • 检查控制台中的 Vault 错误信息

粒子效果未显示

  • 验证配置文件中是否启用了粒子效果
  • 检查客户端的粒子设置
  • 确保你在渲染距离内

? 性能建议

  1. 限制粒子效果:降低粒子密度以获得更好的性能
  2. 调整自动保存:对于大型服务器,增加保存间隔
  3. 传送门限制:设置合理的每位玩家传送门数量上限
  4. 冷却时间:使用冷却时间来防止滥用

? 版本历史

v1.0-SNAPSHOT (最新版本)

  • 传送门法杖修复:解决了阻止创建出口点的关键事件优先级问题
  • 增强法杖功能:
    • 支持左击空气以提供位置反馈
    • 带有用户反馈的重复出口检测
    • 改进了世界加载和跨世界出口的验证逻辑
  • 选择模式支持:修复了传送功能以正确支持 FIRST、RANDOM、SEQUENTIAL 和 NEAREST 模式
  • 代码质量:使用常量定义传送门检测半径,提高了可维护性
  • 核心传送门系统,支持无限出口
  • 交互式 GUI 管理界面
  • 套件分发系统,内置 13 个预配置套件
  • 基于权限的限制系统
  • 通过 Vault 集成经济功能
  • 跨版本支持(1.12.2 - 1.21+)
  • 修复 XSeries 依赖项的 bug
  • ConfigurationSection 处理改进

? 贡献指南

欢迎贡献!请随时在我们的 GitHub 仓库提交拉取请求或报告问题。

开发环境搭建

  1. 克隆仓库:git clone https://github.com/KaizenCore/portal2exit.git
  2. 在 IDE 中打开项目
  3. 运行 ./gradlew build 进行编译
  4. 在本地服务器上进行测试

? 许可证

本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

? 致谢

  • 开发者:KaizenCore Team
  • 贡献者:社区成员
  • 特别感谢:Paper/Spigot 开发团队

? 支持

? 未来计划

  • 具有互联系统的传送门网络
  • 自定义传送门方块和结构
  • 传送门所有权转移系统
  • 高级粒子自定义
  • 跨服务器传送门支持(BungeeCord)
  • 面向开发者的 API
  • 用于管理传送门的 Web 界面
  • 移动应用集成

KaizenPortals - 通过持续改进,提升你的 Minecraft 服务器交通系统!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源