MyPortals (deprecated)
ATTENTION: THIS PLUGIN IS NOW DEPRECATED IN FAVOR OF "WORLD PORTALS"
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
Features
- works most like nether portals
- portal shape customizable by server admin, default looks like
an altara 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 -> https://github.com/atesin/myportals
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
next version (v15) will have improved help pages .. stay tuned and get ready for update your lang-EN.yml files
i started to write the code but i am busy with personal stuff right now
AT_HE, thanks for a quick answer! I have already updated my srv to craftbukkit 1.7.10 R0.1, and uses latest plugin v14.179.
Plugin is successfully starting with the server, allows to set up and portals, and to name it.. commands like: info, list - also works.
I'll wait for a new version! Thanks again =_))))
@angelo27582
currently craftbukkit v1.7.10 are not supported .... anyway please tell me what version of myportals are you using, i will do my best but i don't guarantee it works flawlessly
what myportals version are you using? .. i recommend you to use latest version .. see the "Download latest version" and "Update" titles in description page
Unfortunatly, it does not work for me. I have created two portals, named it and tried to set destinations to each other. On any command like: /portal dest owner:portalName /portal dest portalName. In my case command looks like this: /portal dest angelo:first (or second) it tells: portal name not found, try with 'owner:portalName'
I'm using server v.1.7.10, may be plugin does not support it? Or, please tell me, what I'm doing wrong?
HI,
i got some Troubble with this plugin. I created a Portal, linked it to another Portal, went through without problems and than i wanted to create another portal. The Console always say "The block you are looking is not a Portal base".. I already fixed the config.yml but that doesn't fix the problem. Could you help me with that `?
Fixed it, forgot to set it on Fire :D
i found a teleporting bug in v12 .. so i corrected and uploaded v13 .. read the "Download latest version" title above
please report me the bugs you encounter with a brief description and versions used, to get a faster debugging
sorry for the inconvenience
@Reharn
sadly i remember when you upload some file atm it doesn't allow to choose a cb version above 179r1 ..
i prefer to release for beta or stable cb versions, but mp v12.179 should work .. stay tuned (subscribe)
Any chance this will be updated for 1.7.10?
i am proud of finishing v12 ..
it has many features .. now default portal shape changed to more similar to nether portals (see new shots on description) .. so i STRONGLY RECOMMEND to backup and delete your configs (can also rename or move) so the plugin can regenerate the NEW CONFIGURATION FILES, that you can later edit manually .. but WARNING, if you just change the portal shape on your config.yml file current portals won't be properly recognized
for that reason a very useful new feature for admins is "rebuild portals" that came from v11, which you can change the shape structure of all portals of your server with a single command .. please read THIS PAGE to get more info
before i wrote this plugin i had an idea of what i liked to do, and these ideas guided me to the way of the plugin you can enjoy now ... MyPortals v12 are the closest approach to these ideas, MyPortals are in a continuous improvement process, but thanks to v12 now that process slowed down a little and if you regen your config files now you won't worry about that a long time i hope
thanks
"Unsupported major.minor version 51.0"
did you read the description ?.. myportals only supports java7+ because java6 represents about 3% of servers
please read the documentation, do some test, write problem description and request help kindly, instead of just puking your logs on the project page
(user deleted his posts)
EDIT: fixed in v10
there is a bug with craftbukkit 1.7.9
maybe due some change in new cb, when you place fire over off redlamp waiting it will turn on and stay .. it flashes and turns off again at once
i tested a workaround .. in the meanwhile i look for a better solution, you can place any other block over the lamp, for example 50.05 (top placed coal torch)
GOOD NEWS
i uploaded version 9, this version adds support to CUSTOM WORLDS .. and important changes in config file format so be careful and read the documentation before install
you can get more info and a download link by reading the main description page above
It is working now, i had to set the server name to default ones, the problem was the custom names.. thx for your help!
@ZWatchdog
yes please try to restore to default world names for now and check, i am working on it
lemme answer those points:
-They are all named i double checked multiple times; -I'm testing the portals as Admin, and im the only owner -I don't use multiworlds
The thing is they lose their identity... and i dunno whats wrong.. i was reading through the comments and noticed you said the names in the "allowedWorlds" cant be custom made.. Mines are like this:
allowedWorlds: - Minecraft Server PvE - Minecraft Server PvE_nether - Minecraft Server PvE_the_end
do i have to set the name to world? and change my server name aswel?
@ZWatchdog
could be some things that make your active portals don't work, check them:
Thx for the fast answer, so here it goes:
-Yes it saves the portal info in the data.yml, and when i turn on the server and go "/portal list" it shows that i own the portals, but when i use them they dont work.
-The only info i get in my (re)load is "[MyPortals] Loading MyPortals v7" nothing else
-Im using your MyPortals v7.172 and my cb is CB 1.7.2-R0.3
@ZWatchdog
- did you confirm when you create a portal, it really saves in data.yml?
- if it saves, did you confirm portals loads at plugin (re)load?
- tell me how to reproduce the problem to debug, including your cb and myportals versions
Hello there, im using your mod in a friendly private server. All runs fine exept 1 thing, everytime i turn off the server and then turn it on, all the portal structures became unvalid, they become normal block and when i try to /portal info it just says im not looking to a valid block.
Any ideas?
it works beautifully my friend :) thank you very much :)