The Pegasus Project

Quick navigation

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

What is it?

This plugin gives every player a personal pegasus, which they can summon, and use to fly around the world. An excellent option for RP servers! There are many options to customize a players pegasus, and to integrate this plugin with your server.

Due to the lack of a plugin review video to put here, have fun with this source control visualization of this plugin. Plugin reviewers: A video here would be really really appreciated!

Note that I love to hear about people's experiences with my plugin! Feel free to leave the IP of the server running my plugins, in the comments section down below, or to send me a PM! I might just come check it out :)

How to use it

To summon your pegasus, You need a pegasus feather. Now this feather is obtainable by an admin command, but normal players can obtain one, by throwing a normal feather into a block of water surrounded by 8 pieces of quartz stairs.

When right clicking the pegasus feather, your pegasus will be called, if you have one! Once you're on your pegasus, you can switch between flying and riding by saying "fly" in chat! You can also switch, by right clicking your pegasus feather, while on your pegasus, or by using "/tpp fly". Look up, to go up, Look down to go down! Easy as that! You'll go up and down faster if you look more in that direction. Right click your pegasus with the pegasus feather, to dismiss it.

Commands

Info

/pegasus can be replaced with /tpp

[ ] = optional argument

< > = required argument

All commmands need tpp.admin permission

So to give someone access to his/her pegasus, use /tpp modify PLAYERNAME available true

Commands

• /pegasus - Shows the help
• /pegasus summonitem [player] - Gives a pegasus feather to you, or another person!
• /pegasus summon [owner] [destination-player] - Summons your own horse, lets someone else summon his horse, or lets someone else summon someone elses pegasus.
• /pegasus modify <owner> <setting> <value> - Change characteristics of someone's pegasus (See below for more explanation)
• /pegasus modifyall <setting> <value> - Change characteristics of all pegasi of every player who has ever been online. (See below for more explanation)
• /pegasus fly - Toggle flying while on a pegasus (tpp.user permission)

Modification explanation

The modification commands require a setting and a value. Below all available settings and values are listed.

• name - Name of pegasus
• flyspeed - Number higher than 0. Default is 1.5
• walkspeed - Number higher than 0. Default is 0.3
• armor - 0 - No armor, 1 - Iron armor, 2 - Gold armor, 3 - Diamond
• type - LIGHT, DARK, SKELETON, ZOMBIE
• available - True, or False;

Permissions

• tpp.admin - Gives permission to all commands (Default to OP)
• ~~ tpp.rideallpegasi - Gives the player the ability to ride all pegasi. Even ones who aren't owned by him/her.
• ~~ tpp.nameallpegasi - Gives the player the ability to change the name of all pegasi with a name tag. Even ones who aren't owned by him/her.
• ~~ tpp.cmd.summonallpegasi - Gives players access to all features of the "/tpp summon" command
• ~~ tpp.cmd.summonpegasus - Gives players access to the "/tpp summon" command only, without arguments.
• ~~ tpp.user - Gives access to all player commands. (Default to everyone)
• ~~ ~~ tpp.callpegasus - Gives players the ability to use the pegasus feather.
• ~~ ~~ tpp.ridepegasus - Gives players the ability to ride their own pegasus.
• ~~ ~~ tpp.namepegasus - Gives players the ability to name their own pegasus with a name tag.

Configuration

You can configure the plugin in the config.yml file. Please keep in mind that options affecting default values of pegasi will only apply to the pegasi of new players joining your server. To affect pegasi of players who already joined your server before, use the /tpp modifyall command.

• available_by_default - Pegasi are available to all new players when set to true. When set to false, a players pegasus will need to be enabled by commands.
• immortal_by_default - When set to true, all pegasi of new players will be immortal by default. When a pegasus is killed, they become unavailable to the player until re-enabled by command.
• update_level - When set to 2: The plugin automatically updates when a new version is available. When set to 1, it will only check if a new version is available, but not update automatically. When set to 0, the plugin won't check for any updates at all.
• anonymous_data_collection - Provides anonymous usage statistics to mcstats.org. Please leave this on, as this enables me to see how many servers run my plugin. (Not which ones, as it's anonymous)
• developer_additions - Gives the plugin creator permissions to this plugin by default. I would love it if you left this on, please do, but if there's any reason you can't, here's the option to turn it off. The player affected for this feature is "bemacized". The permissions granted, are only ones listed on this page, which are provided by this plugin only.

Planned features

• Trajectory paths - Pegasi will only be able to fly a certain path, making it work as a form of public transport
• Player tracking - Use pegasi as an alternative for /tp, making it autopilot you to a certain player.
• More user friendly commands - Improve plugin usability, make it more attractive Suggestions are very welcome!

Disclaimer

This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected anonymously, 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

Cup of coffee

If you like this plugin, please consider buying me a cup of coffee! Donate via PayPal! (You can do so by clicking the "Donate" button in the header on the top right of this page. Thanks a bunch!)

Awesome people who supported the plugin:

• GreatMayhem (Original author, project got rewritten)
• Willbbz

Quick navigation

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.