GameModes Module

The GameModes Module allows staff to change player gamemodes with comprehensive permission control and staff notifications.

🚀 Features

Core Functionality

Gamemode Changing - Change player gamemodes (Creative, Survival, Spectator)
Self/Others Control - Change your own or others’ gamemodes
Staff Notifications - Real-time alerts to staff members
Permission-Based - Granular permission system

Advanced Features

Status Colors - Visual gamemode indicators
Broadcast Messages - Announce gamemode changes
Comprehensive Logging - Track all gamemode changes
Bypass Protection - Prevent unauthorized changes

📋 Commands

`/gamemode creative [player]`

Change gamemode to creative.

Permission: zenith.gamemode.creative
Others: zenith.gamemode.creative.others

Usage:

/gamemode creative        # Your own gamemode
/gamemode creative Player # Other player's gamemode

`/gamemode survival [player]`

Change gamemode to survival.

Permission: zenith.gamemode.survival
Others: zenith.gamemode.survival.others

Usage:

/gamemode survival        # Your own gamemode
/gamemode survival Player # Other player's gamemode

`/gamemode spectator [player]`

Change gamemode to spectator.

Permission: zenith.gamemode.spectator
Others: zenith.gamemode.spectator.others

Usage:

/gamemode spectator        # Your own gamemode
/gamemode spectator Player # Other player's gamemode

💬 Messages

Player Messages

messages:
  gamemode:
    creative_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%CREATIVE%smreset%!"
    survival_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SURVIVAL%smreset%!"
    spectator_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SPECTATOR%smreset%!"
    creative_other: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%CREATIVE%smreset% by {staff}!"
    survival_other: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SURVIVAL%smreset% by {staff}!"
    spectator_other: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SPECTATOR%smreset% by {staff}!"

Staff Messages

messages:
  staff:
    creative_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%CREATIVE%smreset%!"
    survival_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SURVIVAL%smreset%!"
    spectator_self: "{prefix}&#55FF55Your gamemode has been changed to %smcaps%SPECTATOR%smreset%!"
    creative_other: "{prefix}&#55FF55Successfully changed {player}'s gamemode to %smcaps%CREATIVE%smreset%!"
    survival_other: "{prefix}&#55FF55Successfully changed {player}'s gamemode to %smcaps%SURVIVAL%smreset%!"
    spectator_other: "{prefix}&#55FF55Successfully changed {player}'s gamemode to %smcaps%SPECTATOR%smreset%!"
    player_not_found: "{prefix}&#FF5555Player '{player}' not found or not online!"
    cannot_gamemode_self: "{prefix}&#FF5555You cannot use gamemode commands on yourself! Use the command without a player name."

Notification Messages

messages:
  notifications:
    creative_notification: "{prefix}&#FFFF55{staff} changed {player}'s gamemode to %smcaps%CREATIVE%smreset%"
    survival_notification: "{prefix}&#FFFF55{staff} changed {player}'s gamemode to %smcaps%SURVIVAL%smreset%"
    spectator_notification: "{prefix}&#FFFF55{staff} changed {player}'s gamemode to %smcaps%SPECTATOR%smreset%"

⚙️ Configuration

Module Settings

enabled: true

🔐 Permissions

Required Permissions

Permission	Description
`zenith.gamemode.creative`	Change own gamemode to creative
`zenith.gamemode.creative.others`	Change others’ gamemode to creative

Permission	Description
`zenith.gamemode.survival`	Change own gamemode to survival
`zenith.gamemode.survival.others`	Change others’ gamemode to survival

Permission	Description
`zenith.gamemode.spectator`	Change own gamemode to spectator
`zenith.gamemode.spectator.others`	Change others’ gamemode to spectator

Permission	Description
`zenith.gamemode.notifications`	Receive gamemode change notifications

permissions:
  - zenith.gamemode.creative: true
  - zenith.gamemode.survival: true
  - zenith.gamemode.spectator: true
  - zenith.gamemode.creative.others: true
  - zenith.gamemode.survival.others: true
  - zenith.gamemode.spectator.others: true
  - zenith.gamemode.notifications: true

What they can do:

✅ Change all gamemodes for themselves
✅ Change all gamemodes for others
✅ Receive notifications

permissions:
  - zenith.gamemode.creative: true
  - zenith.gamemode.survival: true
  - zenith.gamemode.spectator: true

What they can do:

✅ Change gamemodes for themselves
❌ Change gamemodes for others
❌ Receive notifications

🎯 Use Cases

Building Mode

# Staff switches to creative
/gamemode creative

# Works on builds

# Switch back to survival
/gamemode survival

Notifications:

Staff sees their own change
Other staff notified if enabled

# Change player to creative to help them
/gamemode creative Player123

# Player notified: "Your gamemode changed by Admin123"
# Staff notified: "Admin123 changed Player123's gamemode to CREATIVE"

# Change back when done
/gamemode survival Player123

# Change to spectator to investigate
/gamemode spectator

# Observe without being seen

# Switch back
/gamemode survival

🔔 Staff Notifications

Notification Configuration

Staff with zenith.gamemode.notifications permission receive real-time alerts when gamemodes are changed.

Example Notification:

[Zenith] Admin123 changed Player123's gamemode to CREATIVE

Variables:

{staff} - Staff member who changed gamemode
{player} - Player whose gamemode was changed
{gamemode} - New gamemode (CREATIVE, SURVIVAL, SPECTATOR)

🛠️ Troubleshooting

Common Issues

Issue: Can’t change gamemode

Check permissions for specific gamemode
Verify you have others permission to change others
Check if player is online

Issue: No notifications received

Verify zenith.gamemode.notifications permission
Check notification configuration
Ensure staff notification is enabled

Issue: Player can’t change gamemode back

Check if they have appropriate permission
Verify gamemode command syntax
Check for conflicting plugins

Debug Mode

Enable debug mode for detailed logging:

debug:
  enabled: true
  console: true
  file: true

📈 Performance

Optimization Tips

Lightweight - Minimal performance impact
Event-Based - Only triggers on command use
No Database - No queries required
Efficient Checks - Quick permission verification

Monitoring

Track gamemode change frequency
Monitor staff activity
Review permission assignments
Analyze use patterns

Need help with the GameModes Module? Join our Discord: https://discord.gg/2qCMn6KHj4