GhastMaster Documentation
Complete guide for configuration, permissions, and usage
Commands
/ghastmaster reload
Reloads the plugin configuration
Permission:
ghastmaster.reload
Default: op
/freeghast
Activates free mode for 30 seconds
Permission:
ghastmaster.free
Default: op
Usage: Right-click a Happy Ghast while in free mode to mark it as free
/ghastmaster unclaim
Activates unclaim mode for 30 seconds
Permission:
ghastmaster.unclaim
Default: true
Usage: Right-click your owned Happy Ghast to unclaim it
Admin Usage:
Permission:
ghastmaster.unclaim.admin
Default: op
Usage: Right-click any Happy Ghast to force unclaim it (requires confirmation)
Permissions
Permission |
Description |
Default |
ghastmaster.reload |
Reload plugin configuration |
op |
ghastmaster.harness.place |
Place harnesses on Happy Ghasts |
true |
ghastmaster.free |
Use free mode command |
op |
ghastmaster.unclaim |
Unclaim owned Happy Ghasts |
true |
ghastmaster.unclaim.admin |
Force unclaim any Happy Ghast |
op |
ghastmaster.bypass |
Bypass ownership restrictions |
op |
Configuration
config.yml Structure
Code (Text):
Config:
Prefix:
plugin-prefix: '&7[&6GhastMaster&7]&r '
Messages:
# Reload message
reloaded-config: '%PREFIX%&aConfiguration reloaded!'
# Ownership messages
unauthorized-access: '%PREFIX%&c✗ Access denied! This Happy Ghast belongs to &e%OWNER%&c.'
bypass-mount-success: '%PREFIX%&a✓ Bypassed ownership protection (belongs to &e%OWNER%&a).'
ghast-ownership-gained: '%PREFIX%&a✓ Happy Ghast successfully tamed! You are now the owner.'
# Free mode messages
free-mode-entered: '%PREFIX%&a✓ Free mode activated! Right-click a Happy Ghast to mark it as free.'
ghast-freed-success: '%PREFIX%&a✓ Happy Ghast marked as free! Anyone can now use it.'
# Unclaim messages
unclaim-mode-entered: '%PREFIX%&a✓ Unclaim mode activated! Right-click your Happy Ghast to unclaim it.'
ghast-unclaimed-success: '%PREFIX%&a✓ Happy Ghast unclaimed successfully!'
Settings:
# Speed settings (as percentages of base speed)
idle-happy-ghast-speed-percent: 100.0
1-passenger-happy-ghast-speed-percent: 150.0
2-passenger-happy-ghast-speed-percent: 130.0
3-passenger-happy-ghast-speed-percent: 120.0
4-passenger-happy-ghast-speed-percent: 115.0
# Speed level multipliers
speed-level-1-percent: 110.0
speed-level-2-percent: 120.0
speed-level-3-percent: 150.0
speed-level-4-percent: 200.0
boost-speed-percent: 500.0
# Duration settings (in seconds)
speed-level-1-duration: 30
speed-level-2-duration: 25
speed-level-3-duration: 20
speed-level-4-duration: 15
boost-duration: 5
boost-cooldown: 60
# Feature toggles
build-on-happy-ghast-enabled: true
ownership-system-enabled: true
bypass-system-enabled: true
speed-management-enabled: true
feeding-system-enabled: true
hud-system-enabled: true
particle-effects-enabled: true
# Control settings
any-passenger-can-feed: true
show-speed-hud: true
hud-update-interval-ticks: 20
# Ownership settings
ownership-knockback-strength: 1.5
Usage Guide
Claiming a Happy Ghast
- Obtain a harness item
- Right-click a Happy Ghast with the harness
- The ghast becomes yours - only you can be the primary rider
Creating Free Ghasts
- Use /freeghast to enter free mode
- Right-click any Happy Ghast within 30 seconds
- The ghast becomes free for everyone to use
- Free ghasts show heart particles
Unclaiming Ghasts
For Players:
- Use /ghastmaster unclaim
- Right-click your owned Happy Ghast within 30 seconds
- The ghast becomes unclaimed
For Admins:
- Use /ghastmaster unclaim admin
- Right-click any Happy Ghast
- Confirm the action when prompted (click the chat message)
- The ghast becomes unclaimed
Speed System
Feeding Items:
- Snowball: Increases speed level (1-4)
- Fire Charge: Activates boost mode
- Multiple snowballs stack speed levels
- Speed effects have duration timers
- Visual particles indicate current speed
Building on Ghasts
- Mount a Happy Ghast
- Hold the block you want to place
- Sneak (hold Shift) and right-click
- The block places on the ghast
Technical Details
Compatibility
- Minecraft Version: 1.21.6+
- Server: Spigot, Paper, or forks
- Java: 21 or higher
- Dependencies: None (standalone plugin)
Performance
- Lightweight persistent data storage
- Efficient event handling
- Minimal tick operations
- Optimized particle effects
Troubleshooting
Support
- Report issues or request support on Discord
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━