Non-Specific Odyssey
What it does
Non-Specific Odyssey is a random teleport plugin that always gives you good locations!
- never teleport into water or lava
- never teleport inside blocks or caves
- permissions based multi-world support
- configurable & permissions based multi-environment support
- configurable no-damage settings
- configurable cool down period
- teleport to biomes
How it works
Add the NonSpecificOdyssey.jar file to your server's plugins directory and start up the server. A config file will be created automatically with the default values.
Configuration
There are a few config options:
cooldown: [true|false]
Whether to use a cool down period between usage of the random teleport command (/rtp
)
cooldown_time: [seconds]
How long (in seconds) the cool down period is. Default: 120 seconds
no_damage: [true|false]
Whether the player takes no damage (invulnerability) after teleporting. Default: false
no_damage_time: [seconds]
How long (in seconds) the player takes no damage. Default: 20 seconds
max: [distance]
The maximum distance a player can teleport in any direction ie if set to 2048 the random co-ordinate will be between -2048 and +2048. Default: 1024
nether: [true|false]
Whether you can random teleport to the Nether. You can also restrict travel to the Nether using permissions. Default: false
end: [true|false]
Whether you can random teleport to the The End. You can also restrict travel to the The End using permissions. Default: false
initial_step: [number]
The number of blocks the biome search starts searching relative to the player's current location. Use larger values to start the search further away. Default: 0
<<code text>> step: [number]
The number of blocks the biome search uses. Smaller values are more accurate, larger values make the search faster. Default: 10
firstline: [text]
Sets the text that appears between the square brackets on the first line of a Non-Specific Odyssey sign. Default: 'Random TP'
Commands
There are three commands.
/randomteleport
- aliases: [rtp, nso]
- description: Teleport to a random destination
- usage:
/<command> [world]
[world]
is optional, when used with no arguments, it teleports you within the world you are currently in
/biome
- aliases: [rtpb, nsob]
- description: Teleport to a specific biome
- usage:
/<command> [biome|list] [world]
- using
/biome list
will show a list of valid biome names [world]
is optional, when used with no arguments, it teleports you to a biome within the world you are currently in
/nsoadmin
- description: Change config options
- usage:
/<command> [option]
OR/<command> [option] [amount]
- type the config
[option]
as it appears in the config.yml file - for options that are
true|false
just use/nsoadmin [option]
e.g./nsoadmin cooldown
- this toggles the setting - for the rest of the options specify a number for the
[amount]
e.g./nsoadmin max 1500
- type the config
Signs
You can use a sign as a trigger for random and biome teleports.
- Place a sign
- Between opening and closing square brackets type the text specified by
firstline
in the config file, for example: [Random TP] on the first line - You can put anything you like on line two
- To specify a world, type the world name on line three
- To specify a biome, type a biome name on line four
If an invalid world or biome type is specified those lines will be ignored.
Players must have the permission nonspecificodyssey.sign
to use signs, and nonspecificodyssey.admin
to make signs.
To remove a sign, you must be an Op, then just click the Non-Specific Odyssey sign while sneaking.
Permissions
Here they are:
nonspecificodyssey.use
Default: everyone - Allow player to use the random teleport command
nonspecificodyssey.use.[world]
Allow player random teleport in the specified world
nonspecificodyssey.sign
Default: op - Allow players to use Non-Specific Odyssey signs
nonspecificodyssey.end
Default: op - Allow player to random teleport to THE END
nonspecificodyssey.nether
Default: op - Allow player to random teleport to the NETHER
nonspecificodyssey.bypass
Default: op - Allow player to bypass the random teleport cool down
nonspecificodyssey.admin
Default: op - Allow player to change config options, and make Non-Specific Odyssey signs
nonspecificodyssey.*
Default: op - Parent permissions node that has the children:
- nonspecificodyssey.use
- nonspecificodyssey.nether
- nonspecificodyssey.end
- nonspecificodyssey.sign
nonspecificodyssey.biome.*
Default: op - Parent permissions node that has the children:
- nonspecificodyssey.biome.EXTREME_HILLS
- nonspecificodyssey.biome.SWAMPLAND
- nonspecificodyssey.biome.FOREST
- etc, etc
Change log
v1.4.1
- Added a config option for initial biome search step -
initial_step
- default is0
, so it searches from the player's current location. Set it to higher values to start searching further away. - Added
step
andinitial_step
to/nsoadmin
command
v1.4
- Added a [world] argument to the
/biome
command, usage:/biome [biome] [world]
- Added tab completion for biome types to the
/biome
command - Added Non-Specific Odyssey signs
v1.3
- Added a new command -
/biome [biome]
to teleport to the nearest occurrence of the biome type specified- Command aliases:
rtpb
andnsob
- You can list biome types with
/rtpb list
- Grant travel to all biomes with the permission:
nonspecificodyssey.biome.*
- default is OP - Restrict travel to specific biomes using permissions:
nonspecificodyssey.biome.[BIOME]
e.g.nonspecificodyssey.biome.EXTREME_HILLS
- Command aliases:
v1.2
- Built with Bukkit 1.5.2-R0.2
v1.1
- Add command to change config options
/nsoadmin [option] [amount]
- Added teleport sound
v1.0 Initial release
Source code
Metrics
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out
to true
Experiencing JVM crashes while using NSO w/ Spigot 1.7.2, does this crash report show anything in particular? http://pastebin.com/NEJRyDTG
@Nickbbeezy
Yep, could do, currently on holiday, but will take a look when I get back home.
Any chance of adding a world parameter to the biome command?
@KJ_Shipp
Spawning in the ground seems to be a recent bug that I can't reproduce on any of my test servers. You might want to try this version (not Bukkit approved) which has some minor changes that may help
@eccentricnz
Fixed that issue by giving perm: nonspecificodyssey.use.[name of world]
All players can now use. Now, I'm having players reporting they spawned in the ground. I'm using essentials and Group manager. Do they need the essentials.top node to keep that from happening?
@KJ_Shipp
The current build should be compatible, make sure users have the
nonspecificodyssey.use
permissionAny expected time frame for a 1.6.2 compatible build? My OP's can use /rtp but no other players.
Well for reference the server itself never drops below 20 tick ever. Now if we are talking about slow ping time, well, maybe. If you would like to stop on we can see if i can suffocate you? Conflicting plugins could only be essential and multiverse portals. I would really love to use this, And I have not removed it, as I said I have never suffocated, so I do nso and tp them to me, but what a pain. I will play around with it more today maybe. Either way i really do appreciate the time you have put into this and the skills it takes to do it. Thanks again.
@antichip
I can't reproduce this on any of my test servers, and I suspect that it is related to a plugin conflict of some sort or just some serious lag
it seems like everytime I have a new person use this, thet are burried, and of cource die and thus leave never to return, I have not had it happen to me, but it has happened much.
@eccentricnz
I removed all the perms relating to this plugin and followed your config and it works great now!
Thanks!
@MasDaddy
Here is my groups.yml
And the user.yml that I test with
These settings are working for me
@eccentricnz
Still no luck. I added:
- nonspecificodyssey.use - nonspecificodyssey.use.world
@MasDaddy
That's probably because I misspelt it in my post :( it should be:
@eccentricnz
I added:
nonspecificodyessey.use nonspecificodyessey.use.world (world is the name of the world)
to the default groups and they still cant use the command. I really love the plugin, but cant find a way to get my users to be able to take advantage of it.
Thanks for the help.
@MasDaddy
looks like group manager is a bit fussier than PermissionsBukkit, you will need to give the permission:
Where worldname1, worldname2 etc are the worlds where you want your uses to be allowed to random teleport
@eccentricnz
Thank you. I removed most of my plugins. Only left in Essentials, WorldEdit/WorldGaurd, GroupManager and NSO. Still having that issue.
Let me know if there is anything I can do to help you.
@MasDaddy
Will do some tests after work today and see if I can pinpoint your problem.
@eccentricnz
Im not using multiverse.
My core plugins include: essentials, factions, group manager, mcmmo, worldguard.
I have 2 worlds:
world world_nether
Thanks for getting back to me.
@MasDaddy
Do any other plugins control access to worlds? Such as multiverse? They will need permissions set for multiverse access as well I imagine.