Update
Introduction
Hunger Actions is the not so creative name for this wonderful (in my biased opinion) plugin. All of its features are described bellow.
The plugin was (in its most raw form) requested by UltraFaceGuy at: http://forums.bukkit.org/threads/mech-fun-commandless-hunger-based-flight-formatted.87109/
Additional features were recommended by: DaemonDuck (with UltraFaceGuy) at: http://forums.bukkit.org/threads/tiresome-jumping-and-dangerous-waters.85944/
Flight
This plugin allowing flying in creative mode... at a cost. While flying, the player's hunger will decrease at a configurable rate. Once it hits a certain, configurable hunger level, the player will lose his or her ability to fly and fall to the ground.
To prevent infinite flying, a configurable cap is set to the amount of food that can be eaten in a single flight.
Dangerous waters
Any swimmer knows that manually traveling through the high seas is tough, tiring work. Therefor, it only makes sense that swimming should consume one's food cache. When a player swims, his hunger is decreased at a configurable level. When it goes below a configurable level, the player [drowns, dies, bleeds, gets yelled at by flying monkeys].
Of course, no one eats steak while swimming, so a server's admins may determine if players may eat while in water.
Commands / Permissions
This is a list of all commands and permissions that applies to all types of movement.
Base Command
| Command | Permissions Node | Description | ||
|---|---|---|---|---|
| /HungerActions | HungerActions.BaseCommand | Give this permission to any admin that will be working with hunger-decreasing actions |
Generic Commands
These commands apply to all current movement types.
Roots
The following will be signified by "ROOT"
Root Command = /HungerActions <movement type>
Root Permission = HungerActions.<movement type>
Commands
The following are all the commands that are supported by all currently existing forms of movement.
| Command | Permissions Node | Description | ||
|---|---|---|---|---|
| ROOT config | ROOT.config | Base command for configuration |
Configuration Commands
All commands that look at or modify the configuration file.
Root command / permission will be signified by "ROOT"
Root Command = /HungerActions <Movement Type> Config
Root Permission = HungerActions.<Movement Type>.Config
Accessed variable = "VAR"
Commands
| Command | Permission | Description | ||
|---|---|---|---|---|
| ROOT get <VAR> | ROOT.get.VAR | Gets the config variable | ||
| ROOT set <VAR> | ROOT.set.VAR | Sets the config variable |
Generic Config Variables
| Variable | Purpose | Allowed Values | Notes | ||
|---|---|---|---|---|---|
| Enabled | Is this feature enabled? | TRUE or FALSE | None | ||
| Degrade | The amount of hunger removed per second | Any number (decimals allowed) | Set to 0 to allow flying without hunger degrade. Set negative to restore hunger while flying. | ||
| MinimumHunger | The minimum amount of hunger allowed to perform an action | Any whole number | Set to 9999 to allow infinite flying |
Flight
The player may fly at the cost of their hunger. When they run out, they fall.
Permissions
| Ability | Permissions Node | Description | ||
|---|---|---|---|---|
| Flying | HungerActions.Flight.fly | Allow the player to fly at the cost of food |
Dangerous Waters
The player may swim, but when he runs out of proper hunger, he will drown.
Permissions
| Ability | Permissions Node | Description | ||
|---|---|---|---|---|
| Degrade Immunity | HungerActions.Swimming.immune.degrade | Allows the player to become immune from hunger loss | ||
Comments