AdventurePlugin
AdventurePlugin
AdventurePlugin is a plugin for bukkit that handles the creation and playing of adventure type maps. Adventure maps are lacking in SMP due to most adventure maps being only able to be played through one time before needing to reset the world. That is where this plugin comes in. This plugin adds two new features to make the creation and playing of adventure maps easier.
Adventure Team
The first new feature is the Adventure Team. An Adventure Team consists of a name, a leader and a variable number of teammates. Teams are used to create a group of players who want to play together on adventure maps. Only the leader is allowed to choose the adventure the team will play. Players are free to join and leave the team at any time but if it is during an adventure the player will be removed from the adventure upon leaving the team. A team must be created to join any adventure map.
Adventure
The second new feature is the Adventure. An Adventure consists of a name, and a single world that serves as a template. When a team joins an Adventure, the template is cloned to create a unique world specifically for the team to play on. When the team leaves the adventure it is unloaded and destroyed. This leaves the template world untouched and removes the need to reset adventure worlds with each play through. Inventories are also cleared upon entering an Adventure and restored when the player or team leaves.
Defining Adventures
Adventures in version 2.1.1+ are defined in separate zip files located in the "adventures" directory located in the plugins data folder. Each adventure must follow a specific file structure in order to be considered valid. This file structure is as follows
/ adventure.yaml maps/ (Zipped worlds)
Adventure.yaml is a yaml file that is used to describe the adventure. It's structure is as follows
# Name of the adventure name: "Example_Adventure" # [Required] worlds: # The world type that is used as the entry world # for this adventure. # Ex. # entry: "NETHER" # Will use the world with the type "NETHER" as the entry world for this adventure entry: "NORMAL" # [Required] # One or more of the following sections # Valid values for keys are "NORMAL", "NETHER", "END" NORMAL: # Name of the world. This is used to locate the world zip file in the maps directory. # Ex. # name: "world" # Will use the world found at "/maps/world.zip" name: "world" #[Required]
Savvy readers will notice that you can define multiple worlds as part of an adventure. You may be wondering does that mean multi-world adventures can be used. The answer is yes. Nether and end portals will correctly link to the correct worlds of the correct environment. This means a nether portal will link to the world that is specified of type NETHER and end portals will link to the world that is specified as type END. If a world is not defined with the correct type it will not allow the portal to be used.
The maps directory is where all of the required worlds must be zipped up and placed. They will be extracted when a team joins an adventure and loaded.
Commands
([] - Required, () optional)
Team Commands
- /adventure team create [team_name] - Creates a new group with the given name
- /adventure team join [team_name] - Joins the team with the given name
- /adventure team leave - Leaves the current team
- /adventure team list - Lists all current teams
- /adventure team info (team_name) - Gets info about the team with the given name or the team the player is in
Adventure Commands
- /adventure start [adventure_name] - Joins the Adventure with the given name. Only team leaders can use this command
- /adventure stop - Stops the current Adventure. Only team leaders can use this command
- /adventure list - Lists all available Adventures and the number of teams playing them
- /adventure info (adventure_name) - Gets info about the Adventure with the given name or the adventure the player is playing
Permissions
There are currently no permissions for this plugin
Example Config
# This world is the world that players will be teleported # to after they leave an adventure. # Defaults to "world" lobby-world: "world"
The only config option displayed in the example is "lobby-world". This option is used to define a world that players are moved to after leaving an Adventure.
Please post all issues or feature requests on the Github page for this plugin.
@smith_61
OS: MAC OSX 10.9
Java: 7u45
Craftbukkit: 1.6.4:2.0
@theapple641
What OS, Java, and Craftbukkit version are you using?
@smith_61
It Did Not work
Still same problem and i use the want from your link
The is my current file structure:
AdventurePlugin/
config.yml
adventures/
ExampleAdventure.zip
And this is what in my zip:
adventure.yaml
maps/
world_nether.zip
world.zip
@theapple641
Did you take the zip file from the link I posted and drop it into the adventures folder? When creating your own adventure zip you must zip up the files inside the folder but not the folder.
@smith_61
Log:
18:09:08 [INFO] [AdventurePlugin] Enabling AdventurePlugin v2.1.1
18:09:08 [SEVERE] [AdventurePlugin] Error reading in adventure from file: ExampleAdventure.zip Reason: ExampleAdventure.zip is missing required adventure.yaml
Now my server can read the file. But it keeps saying the one on top
I put adventure.yaml in the zip folder
@theapple641
@Peda1996
The adventure files must be zipped up. Just drop the zip in that folder and it will work.
@theapple641
same, problem appears in my files..
I try to do it your way but when i type /adventure list, the result is zero.
This is my file structure
/plugins/AdventurePlugin/
config.yml
adventures/
ExampleAdventure/
adventure.yaml
maps/
world_nether.zip
world.zip
Do i have to zip the ExampleAdventure Folder.
What is my problem
Please help
@theapple641
@Peda1996
https://dl.dropboxusercontent.com/u/19977649/AdventurePlugin/ExampleAdventure.zip
All zip files for adventures must go into the adventures subfolder of this plugins data folder. By default this would be the "/plugins/AdventurePlugin/adventures" folder.
@hackercore
The plugins config.yml file goes in the this plugins data folder. By default this would be the "/plugins/AdventurePlugin" folder. For adventure config.yaml file look at the example in the link given above.
For the freezing the server when starting a new adventure open a GitHub issue on the repo. Link given in the description. Please provide as much detail on what you are experiencing and how to reproduce.
An update for 1.7.2 will be uploaded once bukkit releases a beta build and I get time to look at it. Shouldn't be to long.
Can you make a example .zip file, that we know where to place the files etc? Would be nice
You should Make The Files Files Load Automatically I don't know where to place the files because you explanation up there is not clear. At lease make a full map of the files arrangements from the AdventurePlugin folder till there last folder.
--I don't know where to put the maps folder and the adventures and the config file and do i need to separate the the files of difference adventure map or use the samePlease Help Great Plugin Idea
@smith_61
Where do you put the config again? Oh yeah it freezes the server big time when you start another adventure!
@hackercore
The end goal is to have a lot more configuration options for adventures, hence why there is a new format for defining adventures. I need to clean up how I load the adventures first since it is a mess.
@dawid1280
I would rather not copy a current idea plus I have no idea how hypixel's server works. If you have any ideas that aren't just copy this work that is already done I'll be glad to consider them.
can u make this like hypixel's server? i would appreciate it and lots of people will like your plugin
Where do i put the config? Also are any command block commands isolated in that world? I would like to suggest a feature: make the adventure team creater get op commands while he and his team are playing the adventure Also add a feature in the adventure config so you can set the default gamemode for the adventure.
@tremor77
This was designed to be the main plugin installed on a server. You can run other plugins with it but I can't guarantee that they won't mess up play through of adventure. Ideally this would be one of several servers behind a proxy such as BungeeCord.
There are no permissions as of the current version (2.1.1) because I couldn't think of a good set of permissions to use for the current commands. I figured that the plugin can run without permissions currently because users are only teleported to temporary worlds so there is no permanent damage. If someone wants to come up with a good argument for permissions and a how the permissions should work, I will be more than happy to implement it.
I'm assuming this is designed for a standalone server and not to integrate into an existing one?
How is it that there are no permissions for the /adventure command? There should be at least an adventure.use
/Adventure reload???
@geekyservers
Depends on which map of his. Some of his maps require settings to be on that I don't turn on per adventure. Maybe in a future version. The best advice I can give you would be to try it out. I should start keeping a list of verified maps that work and have people post new ones they found that work.
@levisn1
That should be in the next version. Along with per adventure chat options.
@taltsr
I am not entirely sure what you mean by @a command. All commands that are in this plugin only affect either the player or the team but not the entire server. Unless the entire server is on one team.
awsome plugin! one question: if there are @a command, it will affect all players at the server or only on the players on the adventure map?