VoxelVoyage (Legacy)
From The Voxel Box Wiki
(Redirected from VoxelVoyage)
 | |
| An official Bukkit plugin from the VoxelBox suite | |
|---|---|
| Lead Programmer: | przerwap |
| Documentation: | plusnine |
| Public Relations: | NeutronRocks |
| BukkitDev Link: | VoxelVoyage on BukkitDev |
| Tested Compatible With: | #1.0.1-R1 |
| Download: | Download VoxelVoyage 1.001 |
Przerwap and Ciscog33k run you through the basics of using VoxelVoyage!
Contents |
Overview
VoxelVoyage is the plugin that allows the creation of friendly dragons that players may ride along user-defined flight paths. If you've ever taken a flight path ride in an MMO styled game, you'll feel right at home playing with VoxelVoyage.
VoxelVoyage accomplishes its effects by creating custom entities to be created with their own special behavior patterns. These entities are then saved harmlessly in the server's chunks and will save, persisting between server reloads and restarts without the need to manage a complicated database.
Features
- Voyager paths may be recorded for Dragons and Blazes.
- Dragons fly extremely quickly and have smooth flight paths.
- Blazes are great for navigating small spaces and provide a change of pace from the dragons. Blazes can be made to fly, too!
- Making flight paths is fun and easy! A small set of commands and easy to understand in-game visual feedback make your paths easy to create and even up if new structures are placed in their paths.
- Because the rideable creatures are entities, they may exist and be recorded far above the normal building limit at y:128. Soar as high as you like!
Issues
- Note: If your server loads without the plugin loading successfully, your Voyage setups will expire. We will add a method to have a backup database of your Voyage paths in future versions of VoxelVoyage.
Future Updates / Todo
- Make trigger item configurable
- Make trigger item consumable (toggle)
- Make Pipe item configurable
Installing and Configuring VoxelVoyage
Place VoxelVoyage.jar into your server's plugins folder.
Players listed on the ops.txt file will have access to VoxelVoyage's commands.
All players will be able to ride Voyaging Dragons and Blazes provided they have access to the trigger item.
VoxelVoyage Commands
Password Lock System
- /voyage password - VoxelVoyage allows you to let players use its functions on-the-fly to create their own Voyages by use of a password-lock system. This command has three sub-commands:
- /voyage password [password] will allow a non-OP to use VoyelVoyage commands (until the server is restarted). There is no default password, so be sure to enter one.
- /voyage password will display the current password to an OP.
- /voyage password [new password] set a new password for VoxelVoyage.
Creating Voyagers
Voyagers are custom entities that are rideable and have reliable paths. There are two commands for creating Voyagers:
- /voyage create - Creates a new Voyaging VoxelDragon. This "parent" dragon will not fly itself, but create new VoxelDragons for players to ride.
- /voyage createblaze - Creates a Voyaging Blaze. The Blaze functions identically to the Dragon, but may be better at making sharp turns.
Setting up your Voyagers
- /voyage ctrl - Sets a nearby Voyager to alter its starting location by closely following the player. Toggle this command off by issuing it a second time, leaving your voyager where you'd like players to access them from. A Voyager's starting location may be edited while preserving the rest of the flight path.
- Note: You can adjust the Voyager's following distance to you by scrolling up and down with the mouse wheel.
- /voyage select - Selects a nearby Voyager and allows you to create, edit or delete flight paths.
Creating and editing Flight Paths
- /voyage add - Adds a new waypoint to your selected Voyager's movement path.
- Note: These flight paths are splined using Bezier curves, so consider adding a few extra points in for a sharp curve with your flight paths.
- Note: The ride will terminate at the final waypoint added, so make sure it's somewhere safe and not somewhere that will cause the player to fall to their death!
- Note: Your flight paths are not bound by the usual set of block-friendly coordinates. You can make your Voyagers fly as high above (or down below!) your world as you like.
- /voyage editPath - This command allows the waypoints for the selected Voyager to become visible as Crystals. While in editPath mode, you can right-click a crystal to drag it to a preferred spot, and then right-click again to release it, allowing you to touch up your flight paths as new structures are build near them.
- Note: Only waypoints visible within loaded chunks will become visible, so you may need to issue this command more than once when editing long flight paths.
- /voyage cleanpath - Removes the crystals symbolizing the selected Voyager's waypoints and allows you to start over with a brand new flight path.
- Note: This command removes only the visual crystals applied to your created path, the waypoints will still be there! To remove a path, you must kill the selected voyager and re-create it. (see below)
- /voyage demo - Toggles a preview mode for the selected Voyager by sending demo voyagers every 4 seconds along the waypoints to visualize the path taken.
- /voyage kill - Destroys the selected Voyager and its associated waypoints.
- Note: Voyagers are immune to many popular forms of entity removal. To protect your Voyagers and flight paths, the only way to get rid of a Voyager is through the use of this command.
Other Commands
- /voyage crystal - Creates a Crystal entity at the player's location. These can be used for decoration or special effects. Be careful where you place these, They cannot be removed *yet*.
- Pipe Smoking - A fun small easter egg included in this plugin is the ability to smoke a Pipe by right-clicking. (Item 351:15, in default-compatible packs, this is the cocoa beans)
Riding a Voyager
Stand near a Mother VoxelDragon (or blaze) and right-click with the Tealy Plushie (371 / Gold Nugget). This will create a pathed Voyager and mount you to it. When the Voyager reaches its final waypoint, your Voyager will despawn and release the player.
