Abyss
Abyss is a flexible portal system designed for players. In Abyss, a portal is a square pool of water, no smaller than two by two blocks, and no shallower than two blocks deep. Portals are linked together into networks, and travel between them is optionally limited by distance. Portals can go to other worlds, and minecarts can make use of portals.
Traveling through a portal is easy. Just jump in, and you'll be instantly ejected out of the first available destination. Momentum is preserved through portals, and minecarts will be placed on rails when at all possible.
Trailer
There are also a few older videos. If anyone would like to make a tutorial video, please contact me. I'd do it myself, but between the day job and working on features for Abyss, I'm rather busy at the moment.
Portal Features
Easy Configuration
The majority of portal configuration is performed by manipulating a set of item frames within the body of the portal, as detailed below.
Networks
Every portal in Abyss is placed on a network based on a two-part key consisting of an item and a color, making for thousands of possible networks. Damage values of items are taken into account as well, making it possible to use unique items like specific maps as keys. The network frames are always the top, center item frames of a portal.
To set an item as the network item, right click the network item frame with the item in your hand. Doing so will not consume the item. Left clicking the network item frame will reset the portal to the default network. Repeatedly left clicking the network item frame will destroy a portal. To change the portal's color, left or right click on the color item frame to cycle through the available colors.
The Human Head item creates a special, player-specific network for the owner of the portal and is the default network item, giving players a secure network of portals straight away. Of course, if this isn't desirable for your server, you can simply change the default item to something else in the configuration.
IDs and Destinations
At times, you might want to connect a portal to a specific destination, ensuring that it goes to that destination and only that destination. To that end, portals may be assigned an ID consisting of two colors, making for 288 possible IDs per network when you include IDs that leave one of the color slots empty.
Use the two item frames to the left of the network key to set a portal's ID and the two item frames to the right to set a portal's destination. Left and right click the frames to cycle through the available colors.
Modifiers
Every portal has a number of item frames devoted to Portal Modifiers, positioned below the network key frames. Modifiers are special items that add behavior to portals, both when a player is exiting from a portal and when a player is arriving at a portal. For example, using a Dispenser as a modifier will fetch items from a chest and dispense them to players, storage minecarts, and other things with storage passing through a portal. Using a pressure plate for a modifier will toggle a lever momentarily after something arrives, making it easy to start redstone contraptions when a portal is used.
A list of all the possible modifiers and other information is available at the page about Portal Modifiers.
Covers
Leaving an unguarded portal into the heart of your base open at all hours is, of course, quite silly if you're in a bad neighborhood. To that end, portals may be temporarily closed by building a protective cover over the surface of the portal. Any block within two blocks above the surface of a portal will prevent that portal from being used, in either direction, making it simple to protect yourself from invaders, or to control the flow of entities through your portal systems.
Commands
Commands in Abyss can be performed either as a normal command, or through the use of a Portal Wand. Portal Wands are unique items that can have limited uses, and that use separate permissions from the normal commands. This makes the wands ideal for use by players. A Portal Wand's configuration is stored as a combination of a custom name and item lore, making it possible to create villagers that sell such wands. When checking for a wand's custom name, Abyss requires that a color code be present in the string to ensure that a player didn't craft the item themselves using an anvil.
To create a Portal Wand, use the command: /abwand <uses> [command] <arguments>
A list of sub-commands may be found on the Commands page.
Permissions
Permission | Default | Description |
---|---|---|
abyss.use | Everyone | Allows the player to travel through and manipulate portals. |
abyss.moderate | Ops | Allows the player to manipulate portals created by other players. |
abyss.bypass_protection | Ops | Allows the player to bypass portal block protection by sneaking. Useful for modifying frames without having to destroy and recreate the portal. |
abyss.modifers.<material> | Everyone | Allows the player to use a portal modifier of the material in question. |
abyss.detail.uuid | Ops | Allows the player to see portal UUIDs with the Information command. |
abyss.detail.distance | Ops | Allows the player to see exact distances between portals. |
abyss.detail.location | Ops | Allows the player to see the precise root locations of portals. |
abyss.command.base | Ops | Gives access to the root /abyss command used to perform all sub-commands. |
abyss.command.<command> | Ops | Allows the player to use the Abyss command in question. |
abyss.wand.<command> | Everyone | Allows the player to use a Portal Wand to perform the command in question. |
Updates
As of v4, Abyss includes automatic update functionality. If you wish to disable it, set auto-update to false in your configuration file. Alternatively, you may set auto-update to check to have it merely inform you of available updates.
Statistics
As of v7, Abyss submits usage statistics to MCStats.
Source Code
The source code for Abyss is available on GitHub at https://github.com/stendec/Abyss.
Can you please update it to 1.9.4? I would like to use it in newer minecraft [Edit] If you can
@Teklor
If you are using 1.8, this won't work. This was originally built for 1.4.7, and anything after that is a "good luck."
Alright, so I just started hosting a minecraft server and am having trouble getting Abyss to work.
/abwand create gave me a wand like it was supposed to.
I build a 2x2 hole and added 8 buckets of water to fill it exactly like in the video...but when i right click it with the wand nothing happens. If i click something outside the hole it says invalid portal location.
Am i doing something wrong....or did i miss something?
how do you make it so items go in you invertory
is it possible to make a nether portal like shaped portal
the portals wont connect to other worlds
does this work for 1.7.2? when do you think there will be an update.
also, can i make a portal, per say, bigger than a 2x2x2? like a 31x31x2 circle? because i am thinking of having this at the bottom of a spleef arena
Do You Guys Need a Ticket Manager and I can create a couple tutorials
im a noob how do you connect them from world to world??
Ok so maybe I am a complete noob at this but I can't seem to get this to work? I have a server from servermine.com, it's a FTB Unleashed server, I have added this plugin to my server and cannot get any of the portals to work. I can't even get the /abwand create command to work?? please someone help me, and tell me what I am doing wrong???
I am trying to override the range but keep receiving a invaild range error. What is the maximum I can set this to? Is it a number or something else?
So a question to @stendec365 -
First off, I want to say I love this plugin. But In my new server spawn, players will jump into a hole that brings them down a good 75 blocks. Obviously, with velocity and all that, they'll go flying into the air (although you can always put a cover over it, or just change the velocity). But my question is that if they were to, say, go back through that portal, they'd be stuck in the bottom of the 75-block hole. Is there a way to make a portal go one way (or, in other words, to "disable" one end)?
"At times, you might want to connect a portal to a specific destination, ensuring that it goes to that destination and only that destination. To that end, portals may be assigned an ID consisting of two colors, making for 288 possible IDs per network when you include IDs that leave one of the color slots empty."
- From 'IDs and Destinations'
I'm not sure exactly if that will work in my case, but it might (if so, it sounds a bit confusing). Is there a chance you can explain how I can make a one-way portal? Thanks in advance!
@sloten
Well it depends how the world was made;
If it was made using Multiverse or some other world-generating plugin, there should be a command (e.g: /mv tp <world>) that will get you there. If you only have, say, a world and its nether and end worlds with it, youd need to either create a portal (nether portal or end portal) to get there first. Or, if you have Essentials, you can just use /world
nm i got it but if you want to create a warp to another world, how do you get to that world to place the portal?
hi i need help, i love the plugin but where is the magic wand to create the portal?
@Matt19901
I jumped onto your server briefly, though I didn't manage to catch you to speak. The one portal I could find and use worked fine for me, though I did notice a potential issue. When you only have two blocks of clearance above where a player appears, they can get stuck. Not all the time, but it can happen occasionally.
The biggest issue is when teleporting into a chunk that isn't loaded. First, the server has to load it. Then, the client has to wait for the server to send that chunk. This would be less of an issue, but player movement is handled on the client and the client makes you fall slowly if it doesn't have chunk data for its location. When you jump directly down into the portal, you don't get stuck because you end up in a water block after a bit of falling.
I used to have the problem of getting stuck in the floor with every portal plugin on every server, until I switched to a better ISP.
For now, I have a few ideas on how to fix the problem. If you want, send me a private message at some point and I'll send you a development build of the plugin to see if it helps.
(Disclaimer: Such a build wouldn't be checked by the administrators of dev.bukkit.org, and isn't guaranteed to be safe. I'm not saying that I'd personally give someone a problem plugin, but you should be sure that you trust someone if you're going to be taking arbitrary executables from them. Development builds may have features that are only partially complete, and undocumented changes from the most recently released official build.)
It seems to work perfectly if i have both portals on the ground
Hey when i use the portals and i run into them it works but it seem to teleports me and my players in the block a bit and glitches me could this be because my portals are in structures in the sky or something?
If i jump directly into the portal this does not happen. If you can check out my server @ 192.157.233.131 the portals are right in the room next to where you spawn and let me know what you think is causing it.
@der_Kernschatten
There aren't any tutorials, sorry. However, I'd be happy to provide any help you need... by describing use cases or popping onto a server to demonstrate things. Whatever works.
You should be able to get it using an economy plugin thanks to Vault easily enough. The emerald block modifier works the same as the bottle o' exp, but for currency rather than experience points.
There isn't really a way to make portals require items at this point. That's coming in my next update (whenever that happens), and uses a Hopper modifier.
@stendec365
Haha... assuming something is working the way it is supposed to. That is a good one. ;)
Okay, that makes sense. The xp-levels works, it's just a bit more than I'd want to charge... and half levels doesn't work, only integers.
Are there any tutorials? I worked for a couple hours to get to the point of being able to determine that XP didn't work. I don't want to do that again. I want to try charging using an economy... maybe money... maybe in the form of emeralds, but the documentation I am finding isn't enough without a couple hours of individual work.