Happy Ghast Platforms

Start building mid-air from anywhere with your trusty Happy Ghast. Building sky bases has never been easier.

Happy Ghast Platforms is a Paper plugin for Minecraft 1.21.6 to 26.2 that allows you to build directly on your Happy Ghast.

Tested to work for Paper on Minecraft 1.21.6 and 26.2. Report issues with my spaghetti code through the issue tracker on the plugin's GitHub repository.

How to use

1. Stand on a harnessed Happy Ghast.
2. Wait till it settles.
3. Build on it!

Or more specifically: put a harness on a Happy Ghast, drive (fly?) it somewhere, and dismount. While you are standing on it, vanilla functionality should lock it into place. When that happens you can now shift-click to place blocks right on your Happy Ghast's top and any of its side faces. Feel free to walk off the ghast, too! While you're building, the ghast will patiently wait for you to return.

Structures built on the Happy Ghast do NOT move with your Happy Ghast.

But doesn't that defeat the point?

No! This is for a mobile, temporary platform for starting your sky builds. Now you can build really high up without pillars.

Or, for my use case, making Skyblock a lot more fun: need ice? Fly your Happy Ghast right to the mountains (or where they used to be)! You can build new Skyblock islands now! Sky ports for your Happy Ghasts! No more bridges, no more pillars, no more eyesores.

Installation

1. Download this plugin from Github releases or Modrinth (soon:tm:).
2. Place the .jar in your server's plugins/ directory.
3. Start the server.
4. Done!

Configuration

Not many knobs to turn here, just some detection logic for when building should be allowed, as well as disabling the action bar feedback for server owners wanting something more immersive.

# Checks imposed by the plugin before a Happy Ghast can be built on
build-restrictions:
  # Tolerance for ghast's rotation as it settles (in degrees)
  ghast-direction-tolerance: 0.0
  # Tolerance for a player's distance from the Ghast's top surface to
  # determine if they are standing on the Ghast (in blocks)
  player-horizontal-tolerance: 0.3
  player-vertical-tolerance: 0.5

# Show a hint on the action bar on a failed build attempt
action-bar-hints: true

You can also restrict players from building against Happy Ghasts with happyghastplatforms.build. This permission allows anyone to build by default.

Command usage

This plugin does not use any commands.

How do I submit features for this plugin?

If you wrote the code for it, I'll happily accept a pull request if I feel like it doesn't bloat the scope of this plugin. Ensure that you use the pull request template.

By submitting a contribution to this repository, you agree that your contribution is licensed under the same license as this repository, as published in the LICENSE file.

License

Unless otherwise noted, all source code in this repository is licensed under the GNU Lesser General Public License v3.0 (SPDX: LGPL-3.0). Please view the LICENSE file for the terms you are afforded under the LGPL-3.0.