Key Features

• Speed Control - Configurable movement speeds in all directions, as well as boosting.
• Creative Feel - Natural movement that feels more like creative mode.
• Context Switching - Multiple config profiles allow for situational control styles.
• Precision Movement - Sharper movements, fixed rotation, maintained Y position.
• Custom Keybinds - Descend, Dismount, Toggle Profile, Open Config.
• Server Controls (optional) - Adjust size and reach, or disable roaming, mining penalty, and ambient sounds.

Default Flight Controls

These map to your default Minecraft movement controls to align with creative flight. Set within Minecraft Options... -> Controls... -> Key Binds.... Your bindings may differ to the default below.

Happy Ghast Control	Default Key	Minecraft Control
Forward	W	Walk Forward
Backward	S	Walk Backward
Left	A	Strafe Left
Right	D	Strafe Right
Ascend	Space	Jump
Descend	Left Shift	Sneak
Boost	Left Control Double-Tap W	Sprint Walk Forward (x2)
Dismount	Double-Tap Left Shift	Sneak (x2)

Client Settings

Set on the client, does not require the server-side mod. Use Mod Menu to customize settings in-game, or assign a custom keybind for Open Config to open the settings in-game.

Custom Key Binds

Flight controls align with regular creative flight by default, with dismount requiring to double-tap sneak. Descend key can be rebound to restore regular single-press sneak to dismount behaviour.

Key Bind	Default	Description
Descend	Unbound Uses Sneak unless otherwise disabled.	A custom keybind that can be assigned instead of Sneak to descend while riding a Happy Ghast. This can be assigned as an alternative to Sneak when using Sneak to dismount.
Dismount	Unbound Uses Double-Tap Sneak unless otherwise disabled.	A custom keybind that can be assigned instead of Sneak or Double-Tap Sneak to dismount while riding a Happy Ghast. This can be assigned as an alternative to Sneak when using Sneak to descend.
Toggle Profile	` (backtick)	Allows you to toggle between preset profiles while riding a Happy Ghast to switch between control sets. E.g. to toggle between a "Travel" profile adjusted for speed and ease of use, and a "Build" profile adjusted for smaller more precise movements.
Open Config	Unbound	Opens the client config screen from in-game. Saves having to use Mod Menu.

Profile Settings

Create one or more profiles to switch between different situations in real-time, for when you want speed and fluidity while traveling, or sharp precision while building.

Setting	Description	Default
Name	A friendly name for the profile. This is shown on screen when toggling between profiles.	Default
Master Speed	Sets a consistent speed for all Happy Ghast movements. This simply sets all other speed settings at once.	1.0 (100%)
Forward Speed	Sets the Happy Ghast speed while moving forward (W).	1.0 (100%)
Backward Speed	Sets the Happy Ghast speed while moving backward (S).	1.0 (100%)
Strafe Speed	Sets the Happy Ghast speed while moving sideways (A and D).	1.0 (100%)
Ascend Speed	Sets the Happy Ghast speed while ascending vertically (Space Bar).	1.0 (100%)
Descend Speed	Sets the Happy Ghast speed while descending vertically (Left Ctrl).	1.0 (100%)
Automatic Pitch	Adjusts the Happy Ghast vertical position automatically while moving forward based on whether the player is looking up or down. Turn OFF to maintain the Y position unless using the Ascend/Descend key.	true (ON)
Fixed Rotation	Fixes the Happy Ghast rotation to center around the player rider, allowing more precision while stationary and looking around. Turn OFF to restore the standard rotation centering around the Happy Ghast.	true (ON)
Smooth Glide	Sets whether movements are smooth or instant while riding Happy Ghasts. Turn OFF for more precise movement.	false (OFF)
Speed Boost Rate	Apply a speed boost multiplier when pressing the Sprint key while riding Happy Ghasts. Double-tapping forward also boosts based on the global Minecraft setting. Resulting speed must be within the server maximum.	2.0 (2x)
Descend Key	Select whether to use the Minecraft key bind for Sneak/Crouch to Descend while riding a Happy Ghast, or to only use the custom Descend key bind. If using Double-Tap to Dismount, this should use Custom Key Bind only.	SNEAK other option: CUSTOM_KEYBIND
Dismount Key	Select whether to require double tapping the Sneak/Crouch key to dismount while riding Happy Ghasts, or to apply the standard single tap Sneak/Crouch to dismount behaviour, or to only use the custom Dismount key bind.	DOUBLE_TAP_SNEAK other options: SNEAK CUSTOM_KEYBIND
Dismount Window	Time window in ticks where double-tapping the Sneak/Crouch key dismounts the Happy Ghast. Only applies when Dismount is set to Double-Tap.	5 (5 ticks)

Server Settings

Set on the server, does not require client-side mod. Min/Max Speed can be used to set speed limits on the client-side. If server-side mod is not installed, defaults align with standard Minecraft.

Setting	Description	Default
Disable Roaming	Makes all Happy Ghasts stop roaming while not being ridden. Only applies when wearing a Harness.	true (ON)
Disable Ambient Sound	Silences all Happy Ghast ambient sounds (does not affect hurt/death sounds).	true (ON)
Disable Mining Penalty	Allow players to break blocks at normal speeds while riding a Happy Ghast, rather than having the default 5x slowness applied for not being on the ground.	true (ON)
Reach	The multiplier applied to the distance players can reach blocks and entities while riding a Happy Ghast, where 1.0 is the standard reach.	1.0 (100% or 4.5 blocks)
Ghast Size	The size multiplier of all Happy Ghasts, where 1.0 is the standard size.	0.75 (75% or 3 blocks wide)
Default Speed	Sets the default speed while riding Happy Ghasts. This also applies the default speed for anyone not using the client-side mod. Additionally, roaming ghasts move slightly slower than normal too.	1.0 (100%)
Minimum Speed	Sets the minimum client speed settings allowed while riding Happy Ghasts. Overrides any client config that exceeds this.	0.0 (0%)
Maximum Speed	Sets the maximum client speed settings allowed while riding Happy Ghasts. Overrides any client config that exceeds this.	5.0 (500% or 5x as fast as standard)

Config File

The config file can be modified under config/ghastcontrols.json. The following JSON represents the default config. Additional profile objects can be added, and the currentProfile represents the currently selected profile. For servers, currentProfile and profiles are ignored.

Default Client Config

{
  "currentProfile": 1,
  "profiles": [
    {
      "name": "Default",
      "forwardSpeed": 1.0,
      "backwardSpeed": 1.0,
      "strafeSpeed": 1.0,
      "ascendSpeed": 1.0,
      "descendSpeed": 1.0,
      "boostRate": 2.0,
      "dynamicPitch": false,
      "fixedRotation": true,
      "smoothGlide": true,
      "descend": "SNEAK",
      "dismount": "DOUBLE_TAP_SNEAK",
      "dismountWindow": 5
    }
  ],
  "disableRoaming": true,
  "disableAmbientSound": true,
  "disableMiningPenalty": true,
  "reach": 1.0,
  "ghastSize": 0.75,
  "defaultSpeed": 1.0,
  "minSpeed": 0.0,
  "maxSpeed": 5.0
}

Default Server Config

{
  "disableRoaming": true,
  "disableAmbientSound": true,
  "disableMiningPenalty": true,
  "reach": 1.0,
  "ghastSize": 0.75,
  "defaultSpeed": 1.0,
  "minSpeed": 0.0,
  "maxSpeed": 5.0
}