这是我的第一个插件,但现在我编写了一个更简单、优化更好、轻量、快速且易于使用的插件,名为 World Portals。试试看吧,我相信你会喜欢它的。
建造通往任何地方的传送门!
当距离变得遥远且你需要走很多路时,Minecraft 有时可能会变得无聊。
新版本 17,请注意服务器管理员
由于新增了外观美观且始终发光的海晶灯,不再需要尝试复杂的红石灯照明方案,这使得我们可以移除 NMS 方法和版本特定的编译……然而,要享受全新的“干净”传送门,你需要重新构建它……请参阅 v17 下载页面的“已知注意事项”部分。
描述
MyPortals 是一个个人传送插件,其工作方式类似于下界传送门。你可以建造一个可配置的传送门结构,并使用物品激活它,然后设置目的地、隐私等级,用于快速旅行……如果传送门被破坏,它将失效。
传送门的结构形状、材料、允许传送的世界、跨世界传送门以及本地化设置均可由服务器管理员进行配置。
注意:自 8 版本起文件格式变更
8 版本更新了配置文件。如果您是从 8 以下版本升级,请阅读“更新”部分。
视频
(已过时,葡萄牙语)感谢 AbsintoJPl... 由于时间较久,您可以在此查看 MyPortals 的实际运行效果。请注意,您无需进入配置界面,只需准星对准基座方块即可看到其更新后的形状。请阅读本页面以获取更新信息。
<h3>功能特性</h3>
- 运作方式最接近下界传送门
- 传送门形状可由服务器管理员自定义,默认外观为
祭坛 小型下界传送门(自 v12 起)
- 使用准星瞄准中央“基座”方块即可轻松选中
- 在基座上放置“充能”物品即可激活传送门(默认为火,类似下界传送门)
- 破坏结构即可停用传送门(类似下界传送门)
- 激活传送门的玩家即为所有者,之后也可将其“转让”给他人
- 提供命令用于设置传送门名称、目的地、隐私权限和所有者(转让)
- 4 种隐私级别:公开、锁定、隐藏和私密
- 支持本地化,但目前仅包含英文(欢迎贡献?……我的英语不太好,我是智利人)
- 在相同位置重建传送门并保留链接(例如:用于传送门重新定向)
- 兼容 Java 6(版本 4 新增功能)
- 可配置传送消耗的經驗值(版本 5 新增功能)
基本使用方法
- 建造服务器所使用的结构形状,默认形状如图所示(不要用水!)
- 将“充能”物品(默认为打火石+燧石)放置在基座上,然后你的传送门将被激活(默认外观如图所示)
- 注视传送门基座并使用 "/portal name myPortalName" 为其命名
- 注视传送门基座并使用 "/portal dest myPreviousPortal" 设置目的地
- 进入传送门并在基座上站立 4 秒即可传送到其目的地
- 在 4 秒结束前离开传送门以取消传送
- 可选操作:注视基座并设置隐私等级、将传送门交给他人、查看/编辑其属性或销毁它
传送门示例
你可以在“Images”标签页中看到一些传送门结构形状的示例。
基本命令参考
大多数命令都有额外的参数,在游戏中获取更详细的帮助(自 v17 起别名为 "/p")
- /portal :显示第一页帮助信息,你可以通过 /portal 2、/portal 3 等查看后续页面
- /portal list :显示我自己、其他玩家或所有传送门的简要列表
- /portal info :显示你所注视的传送门基座的详细信息
- /portal name portalName :将你正在注视的传送门基座命名为 portalName
- /portal dest destPortal :设置目标传送门;你可以使用冒号分隔指定所有者(otherPlayer:hisPortal)
- /portal (public, lock, hide, private) :设置传送门的隐私级别,详见下文
- /portal give otherPlayer :将你正在注视的传送门交给在线玩家 otherPlayer;该传送门必须为公开状态且属于你
- portal rebuild:控制台命令,读取 config.yml 中的形状配置并重建所有世界中的传送门
隐私设置
- 传送门所有者:所有者可以对其自己的传送门进行任何操作,包括传送和使用“give”命令将其交给他人
- 公开(public):如果你发现一个公开的传送门且你不是所有者,你也可以几乎对其进行任何操作,但不能使用“give”命令
- 锁定(lock):与上述相同,你可以使用该传送门,但不能通过任何命令修改它
- 隐藏(hide):与上述相同,但该传送门不会出现在“list”和“info”命令的列表中
- 私有(private):与上述相同,但如果你不是所有者,你将无法被传送;适合放置在私密地点使用
下载最新版本
你可以在“Files”标签页中下载当前可用的版本,但是……
v12 是迄今为止功能最强大、特性最丰富的版本,但很抱歉,它存在一个传送错误。
我刚刚上传了为 CB 179 编译的 v14 版本,它带来了与 v12 相同的功能,但修复了错误并进行了增强,请阅读文件更新日志.. 请等待审核通过后,点击“Files”标签并在下载页面查看更新日志... 但是...
... 但与此同时,您可以直接在此处 HERE 下载 ... 之前的版本在配置文件方面带来了更新,因此我强烈建议您阅读 THIS 和 THIS 文档。
您可能希望在 “Subsciptions” 标签中订阅以获取更新通知。
安装
需要 JAVA 7 或更高版本
只需下载 MyPortals.jar 文件,将其放入您的 plugins 文件夹并执行 “reload” 服务器命令(或重启),插件将自动创建插件文件夹和默认配置文件。
更新
不同版本引入了不同的功能和不同的配置值,请阅读文件页面中的最新更新日志...
要更新,取决于您当前拥有的版本,但一般流程是...
- 停止 Bukkit 服务以避免文件修改/锁定问题
- 备份并删除(或移动、重命名)您的配置文件
- 下载并覆盖 MyPortals.jar 文件
- 启动并停止以使插件重新生成文件
- 通过手动编辑文件,将您的配置从备份迁移到新文件
- 启动服务器
- 在传送门形状更改时执行 “portal rebuild” 控制台命令
常见问题解答
我尝试激活我的传送门但它没有反应
- 您处于无法激活传送门的维度中,请联系管理员
- 您建造的传送门结构形状不符合要求,请联系管理员
- 可能是某些错误,请告诉我您的 Craftbukkit 和 MyPortals 版本、配置文件以及复现步骤
我进入传送门,播放了传送效果但没有任何事情发生
- 您的经验值不足以进行传送,击杀一些生物再试一次
- 您尝试传送的传送门是私有的
- 源传送门还没有目的地,请使用 "/portal dest myDestPortal" 为其指定一个
- 某些错误,请发送您的版本、配置文件和复现步骤给我
如何禁用传送门?
当我安装并加载插件时,控制台中出现带有 “unsupported minor major version” 消息的异常
当我列出我的传送门时显示空白行
- 您有未命名的传送门,请立即为它们命名,否则可能会丢失。大多数命令都需要传送门有名称
源代码
我正在尝试使用 Eclipse 和 GitHub,我正在学习这个,非常令人困惑 .. 无论如何源代码在这里 ->
this(西班牙语),this 和 this 页面帮了我很多
待办事项
如果您喜欢这个插件并且有一些 Java/Bukkit 知识,我希望您能帮助我实现这些功能
- 取消水桶抓取水,也许通过找到放置 “流动水” 的方法或取消水桶事件
- 当玩家激活传送门时自动提示传送门名称
- 可自定义的命令/别名在 config.yml 中
- 鼠标悬停目的地工具提示
- dynmap 支持
- 传送门粒子效果
- 任何您喜欢的想法
贡献
这是我的第一个插件,我希望以一种有趣的方式学习 Java,通过编写一个 Bukkit 插件 .. 我受到了 TravelPortals 的启发,但在传送门选择/传送/隐私机制上做一些改变和一些添加 .. 如果您想从 TravelPortals 迁移,您可以阅读 this page
由于我一个人做这个插件... 最简单、有用和最快速的方法是向我报告您遇到的错误,并附带简要描述和使用版本。
另一种帮助方式是提供翻译并发送给我 .. 或者如果您有任何建议,请在此处发布您的想法,欢迎任何形式的帮助
感谢
- jacklink01 和他很棒的 “LampControl” 插件,教会了我如何开启传送门
- cppchriscpp 和他伟大的 “TravelPortals” 插件唤醒了我对插件开发的兴趣
- 任何以某种方式为此插件、其他插件或 bukkit 本身做出贡献的人,毕竟我们是一个社区 :)
智利制造
自豪的智利产品

This is my first plugin but now i wrote a more simple, optimized, light, fast and easy plugin called World Portals. Give it a try, i am sure you will like it
Build portals to anywhere!
When distances becomes large and you have to walk a lot, Minecraft can turn sometimes boring.
New version 17, attention server admins
Thanks to the addition of new sea lanterns that looks good and are always lighted, there is no more need to try complicated lighted redstone lamps, this allowed to remove nms methods and version specific compilations... however to enjoy new "clean" portals you need to rebuild it... read "known caveats" section at v17 download page
Description
MyPortals is a personal teleporting plugin that is intended to work similar to nether portals, in which you can build a portal like structure (configurable) and activate it with an item, then you can set a destination, privacy levels, and use it for fast travelling... if portal breaks it will deactivate.
portal structure shapes, materials, worlds that accepts portals, inter-worlds portals, and localization can be configured by the server admin.
Attention with changes in file format since version 8
Version 8 brings updates in config files, if you are updating from below version 8 please read the "update" title.
Video
(OUTDATED, in portuguese) thanks to AbsintoJPl... since a bit old you can see MyPortals in action, note you don't need enter to configure portal just look at base with crosshair and has an updated shape, read this page to update info
<h3>Features</h3>
- works most like nether portals
- portal shape customizable by server admin, default looks like
an altar a small nether portal (since v12)
- easily selected by looking the central "base" block with your crosshair
- activate portal by placing "charge" item on the base (default=fire, like nether portals)
- deactivate portal by breaking structure (like nether portals)
- player that activate is the owner, also you can "give" it later
- commands to set portal name, destination, privacy and owner (give)
- 4 privacy levels: public, locked, hidden and private
- localization support, but currently only comes with english (any contribution? .. my english are not the best, i am chilean)
- rebuild portal in same location and preserve links (i.e.: for portal reorientation)
- java6 aware (new in version 4)
- configurable experience points for teleport cost (new in version 5)
Basic usage
- build the structure shape your server use, default shown in picture (no water!)
- place the "charge" item (default: fire, with flint and steel) over the base, then your portal will activate (default look shown in picture)
- look at portal base and name it with "/portal name myPortalName"
- look at portal base and set destination with "/portal dest myPreviousPortal"
- enter the portal and stand on the base for 4 seconds to teleport to its destination
- exit the portal before 4 seconds to cancel teleporting
- optionally look at base and set privacy levels, give your portal to someone, view/edit its properties or destroy
Portal examples
you can see some portal structure shape examples in "Images" tab.
Basic command reference
most commands have additional parameters, get more detailed help in game (alias "/p" since v17)
- /portal : displays you the first help page, you can see the next with /portal 2, /portal 3, etc.
- /portal list : displays a briefing of my own portals, or other player, or all
- /portal info : displays detailed information about the portal base you are looking
- /portal name portalName : gives the portal base you are looking the name of portalName
- /portal dest destPortal: sets the destination portal, you can specify the owner separated with a colon (otherPlayer:hisPortal)
- /portal (public, lock, hide, private) : sets the privacy level of your portal, see below
- /portal give otherPlayer : gives the portal you are looking to online player otherPlayer, the portal must be public and yours
- portal rebuild: console command that reads shape in config.yml and rebuild all worlds portals
Privacy settings
- the owner of the portal : the owner can do anything he wish with his own portals, including get teleported and "give" it
- public : if you find a public portal and you are not the owner you also can do almost anything with it, except use the "give" command
- lock : same as above, you can use the portal except modify it with any command
- hide : same as above except the portal won't be listed with "list" and "info" commands
- private : same as above except the portal won't bring you teleported if you are not the owner, useful for placing on private places
Download latest version
you can download currently available releases on "Files" tab, but...
v12 is the most advanced and rich featured version until now, but sorry because it had a teleportation bug
i just uploaded version 14 compiled for cb 179, it brings same features from v12 but with fixed bugs and enhancements, READ FILE CHANGELOG.. please wait until it gets approved, then click on "Files" tab and see changelog in download page... but...
... but in the meanwhile you can download it directly HERE ... past versions brought updates in config files, so i strongly recommend to read THIS and THIS documentation.
you may want to be informed about updates by subscribing in "Subsciptions" tab.
Installation
REQUIRES JAVA 7 OR HIGHER
to install just download MyPortals.jar file, place it on your plugins folder and execute a "reload" server command (or restart), the plugin will create plugin folder and default config files automatically.
Update
different versions introduces different features and different config values, please read the last changelog at files page...
to update, it depends on what version you have now, but the general process is...
- stop the bukkit service to avoid file modification/lock issues
- backup and delete (or move, or rename) your config files
- download and overwrite MyPortals.jar file
- start and stop so the plugin regenerate files
- migrate your configs from the backups to new files, by editing your files manually
- start the server
- on portal shape changes do "portal rebuild" console command
Q&A
i try to activate my portal but it doesn't
- you are in a world where you can't activate portals, ask your admin
- the portal structure shape you built doesn't match with needed, ask your admin
- maybe some bug, tell me your Craftbukkit and MyPortals versions, config files and steps to reproduce
i enter on my portal, it plays the warp effect but nothing happens
- you don't have enough xp points to get teleported, kill some mob and try again
- the portal you are trying to teleport is private
- the source portal don't have a destination yet, give some with "/portal dest myDestPortal"
- some bug, send me your versions, config files and steps to reproduce
how do i deactivate a portal?
- just break it, like nether portals
when i install and load the plugin i get exceptions on console with the message "unsupported minor major version"
- update java to version 7+
when i list my portals it shows blank lines
- you have unnamed portals, give them a name at once or you could lose it. Most commands need the portals had a name
Source code
i am trying to use eclipse with github, i am learning this, is very confusing .. anyway the source code is here ->
this (spanish), this and this page helped me a lot
ToDo
If you like this plugin and have some Java/Bukkit knowledge, i would like you help me implementing this features
- cancelling bucket water grabbing, maybe by finding a way to place "flowing water" or by cancelling bucket events
- prompt portal name automatically when player activate a portal
- customizable command/alias in config.yml
- mouse hover destination tooltip
- dynmap support
- portal particles effect
- some idea you like
Contribute
this is my first plugin, i wished to learning java in a fun way, by writing a Bukkit plugin .. i inspired on TravelPortals, but with some changes in portal selection/teleport/privacy mechanics and a few additions .. if you want to migrate from TravelPortals you could read this page
as i am alone doing this plugin... the most easy, useful and fast way to help is to report me the bugs you encounter with a brief description and versions used.
another good way to help is to do translations and send it to me .. or if you have some suggestion please post your ideas here, all kind of help are welcome
Thanks
- jacklink01 and his awesome "LampControl" plugin that teach me how to turn on portals
- cppchriscpp and his great "TravelPortals" plugin that woke me up the plugin development interest
- anyone that contributes in some way with this plugin, or other plugins, or bukkit itself, after all we are a community :)
Made in Chile
Producto orgullosamente chileno

评论 0
登录后参与评分
还没有评论,来抢沙发吧