Nether View ≤1.16 - Nether View 透视传送门

💡Nether View

Nether View 是一款能让玩家透过下界传送门预览另一侧世界的插件。在真正踏入下界之前，你就能提前一窥门后的景象，做好准备。

⭐核心特性

• 透过任意（原版尺寸）下界传送门预览其链接的目的地世界。
• 传送门动画效果支持所有标准尺寸，只要两端传送门大小相同且框架完全由黑曜石构成（包括四个角落）。
• V3.0 新增：支持类似 Multiverse 的自定义传送门，同样具备预览效果。
• 使用 Optifine 可使传送门动画更加流畅，强烈推荐搭配使用。

> 注意：传送门动画仅在第一人称视角下生效。第三人称视角（按 F5）由客户端控制，插件无法检测。

🔧安装与设置

• 将插件 JAR 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 若需指定生效世界或世界使用自定义名称，请编辑配置文件中的世界列表（见下文），然后执行 /netherview reload。
• 新建传送门后，先进入一次，让插件记录其目的地信息。退出传送门后，预览效果便会加载。

遇到问题？

如果遇到问题或疑似漏洞，请尝试执行 /netherview debugmessages true。这将启用游戏内的调试信息，帮助你理解插件行为，也有助于开发者定位和修复问题。

🎮配置说明

配置文件为 YAML 格式，主要选项如下

# 触发传送门动画效果的玩家距离范围
portal-display-range: 16
# 透过传送门可见的另一侧世界的距离（单位：方块）
portal-projection-distance: 4
# 可显示动画的传送门最大尺寸（更大尺寸可能导致卡顿）
max-portal-size: 5
# 是否隐藏玩家世界中位于传送门后的实体
hide-entities-behind-portals: true
# 是否在传送门中显示另一侧世界的实体（仅当上一项为 true 时生效）
show-entities-inside-portals: true
# 向玩家发送实体移动更新数据包的间隔（单位：游戏刻，默认 3，设为 1 则非常流畅）
entity-update-ticks: 3
# 当两个传送门无法链接时，是否向玩家显示警告信息
warning-messages: true
# 是否在控制台输出更详细的事件和错误调试信息
debug-messages: false

# 下界传送门预览相关设置
nether-portal-viewing:
  # Spigot 会在使用下界传送门时翻转玩家视角。如果使用其他服务端分支，可设为 false
  flip-portals-by-default: true
  # 预览时是否隐藏传送门的紫色粒子层
  hide-portal-blocks: true
  # 首次链接两个传送门时，是否取消生存模式玩家的传送（用于建立链接）
  cancel-teleport-when-linking-portals: true
  # 是否启用瞬间传送
  instant-teleport: true
  # 启用传送门预览的世界列表。使用 "*"（带引号）表示所有世界
  whitelisted-worlds:
    - world
    - world_nether
  # 禁用传送门预览的世界列表（优先级高于白名单）
  blacklisted-worlds:
    - null

# 自定义传送门相关设置
custom-portal-viewing:
  # 允许创建和使用自定义传送门的世界列表。使用 "*"（带引号）表示所有世界
  whitelisted-worlds:
    - "*"
  # 禁用自定义传送门的世界列表（优先级高于白名单）
  blacklisted-worlds:
    - null
  # 为不同世界类型设置自定义传送门的边框方块
  overworld-border: white_terracotta
  nether-border: red_concrete
  end-border: black_concrete

✨开发者 API

以下示例展示了如何将 Nether View 作为库引入，并从你的插件中获取信息：

import me.gorgeousone.netherview.NetherViewPlugin;
import me.gorgeousone.netherview.portal.Portal;

NetherViewPlugin netherView = (NetherViewPlugin) Bukkit.getPluginManager().getPlugin("NetherView");
Portal closestPortal = netherView.getPortalHandler().getClosestPortal(player.getLocation(), true);
Set<Portal> overWorldPortals = netherView.getPortalHandler().getPortals(overworld);
boolean canSeePortals = netherView.getViewHandler().hasPortalViewEnabled(player);
boolean isViewingAPortal = netherView.getViewHandler().hasViewSession(player);
Portal viewedPortal = netherView.getViewHandler().getViewSession(player).getViewedPortal();

🔧命令列表

• /nv reload – 重载插件配置。
• /nv listportals <world> – 在聊天栏列出指定世界的所有传送门。
• /nv portalinfo – 显示距离你最近的传送门的详细信息。
• /nv debugmessages <true/false> – 启用或禁用调试信息。
• /nv warningmessages <true/false> – 启用或禁用传送门链接失败警告。
• /nv flipportal – 翻转你正在查看的下界传送门的两侧显示面。
• /toggleportalview – 为你个人切换传送门预览功能的开关。
• /nv wand – 获取用于选择自定义传送门区域的工具（传送门法杖）。
• /nv createportal <portal name> – 使用法杖选定的区域创建一个自定义传送门。
• /nv link <from portal> <to portal> – 将一个自定义传送门链接到另一个，使其能够传送并投影。
• /nv unlink <portal> – 移除指定传送门的链接。
• /nv deleteportal – 删除一个自定义传送门。

✨权限节点

• netherview.viewportals – 允许透过传送门预览世界并使用 /toggleportalview 命令。
• netherview.linkportals – 允许链接传送门以创建投影。
• netherview.config – 允许使用配置相关命令，如重载或切换信息显示。
• netherview.info – 允许使用获取传送门信息的命令。
• netherview.flipportal – 允许使用 /nv flipportal 命令。
• netherview.wand – 允许使用 /nv wand 命令获取传送门法杖。
• netherview.customportals – 允许使用传送门法杖创建自定义传送门及相关所有命令。

❓依赖与兼容性

• 必需依赖：ProtocolLib。

-   若运行于 1.16 版本，请使用其最新的开发构建版。

• 与 Optifine 搭配使用可获得更流畅的动画体验。

🔧开发计划

• ~~使实体在传送门中可见~~ ✓
• ~~添加可预览的自定义传送门~~ ✓
• 为实体预览功能添加更多动画效果

如果你喜欢这个插件，别忘了留下评论！也欢迎通过捐赠支持开发者。

需要支持？请加入 Discord 服务器。