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+
- 性能优化:高效的粒子渲染和传送门检测
- 数据持久化:自动保存和加载传送门数据
- 安全检查:具有障碍检测的传送安全性
- 自动保存:可配置的自动数据保存
? 安装
- 从发布页面下载最新的
portal2exit-1.0-SNAPSHOT.jar - 将其放入服务器的
plugins文件夹中 - 重启服务器
- 在
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
? 使用示例
使用传送门法杖(推荐)
- 获取法杖:
/portal wand - 选择出口位置:左击你想让玩家传送到的方块
- 创建/管理传送门:站在你希望放置传送门的位置 5 格范围内
- 手持法杖右键点击,将出口点添加到传送门中
- 重复步骤 2-4 以添加多个出口点
- 左击空气以查看当前选定的位置
创建枢纽传送门(命令方法)
- 站在你的枢纽位置
- 运行
/portal create hub - 前往目的地
- 运行
/portal addexit hub - 对多个目的地重复此操作
设置 VIP 区域
- 创建传送门:
/portal create vip-lounge - 设置权限:
/portal setrequiredpermission vip-lounge portal2exit.vip - 添加费用:
/portal setcost vip-lounge 100 - 添加套件奖励:
/portal setkit vip-lounge vip
构建地牢系统
- 创建入口:
/portal create dungeon-entrance - 在地牢的不同层级添加多个出口
- 设置模式:
/portal setexitmode dungeon-entrance SEQUENTIAL - 玩家按顺序通过各个层级
? 故障排除
传送门无法工作
- 检查你是否拥有
portal2exit.use权限 - 验证是否满足激活要求
- 确保冷却时间已过
- 检查传送门是否有出口点
经济功能无法工作
- 安装 Vault 插件
- 安装一个经济插件(如 EssentialsX 等)
- 在 config.yml 中启用经济功能
- 检查控制台中的 Vault 错误信息
粒子效果未显示
- 验证配置文件中是否启用了粒子效果
- 检查客户端的粒子设置
- 确保你在渲染距离内
? 性能建议
- 限制粒子效果:降低粒子密度以获得更好的性能
- 调整自动保存:对于大型服务器,增加保存间隔
- 传送门限制:设置合理的每位玩家传送门数量上限
- 冷却时间:使用冷却时间来防止滥用
? 版本历史
v1.0-SNAPSHOT (最新版本)
- 传送门法杖修复:解决了阻止创建出口点的关键事件优先级问题
- 增强法杖功能:
- 支持左击空气以提供位置反馈
- 带有用户反馈的重复出口检测
- 改进了世界加载和跨世界出口的验证逻辑
- 选择模式支持:修复了传送功能以正确支持 FIRST、RANDOM、SEQUENTIAL 和 NEAREST 模式
- 代码质量:使用常量定义传送门检测半径,提高了可维护性
- 核心传送门系统,支持无限出口
- 交互式 GUI 管理界面
- 套件分发系统,内置 13 个预配置套件
- 基于权限的限制系统
- 通过 Vault 集成经济功能
- 跨版本支持(1.12.2 - 1.21+)
- 修复 XSeries 依赖项的 bug
- ConfigurationSection 处理改进
? 贡献指南
欢迎贡献!请随时在我们的 GitHub 仓库提交拉取请求或报告问题。
开发环境搭建
- 克隆仓库:
git clone https://github.com/KaizenCore/portal2exit.git - 在 IDE 中打开项目
- 运行
./gradlew build进行编译 - 在本地服务器上进行测试
? 许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 致谢
- 开发者:KaizenCore Team
- 贡献者:社区成员
- 特别感谢:Paper/Spigot 开发团队
? 支持
- 问题反馈:GitHub Issues
- Discord:加入我们的服务器
- Wiki:文档
? 未来计划
- 具有互联系统的传送门网络
- 自定义传送门方块和结构
- 传送门所有权转移系统
- 高级粒子自定义
- 跨服务器传送门支持(BungeeCord)
- 面向开发者的 API
- 用于管理传送门的 Web 界面
- 移动应用集成
KaizenPortals - 通过持续改进,提升你的 Minecraft 服务器交通系统!
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
28
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧