Gate Keep

Gate Keep provides server administrators with powerful tools for managing dimension access. The modification allows both complete blocking of specific worlds and setting up timed restrictions that automatically lift at specified dates and times.

Key Features

• Complete Dimension Blocking: Restrict access to any dimensions of your choice
• Flexible Time-Based Restrictions: Schedule automatic dimension openings at specific dates and times
• Customized Messages: Configure notification texts that players see when attempting to enter restricted dimensions
• Automatic Broadcasts: Server-wide announcements when time-based dimensional restrictions are lifted

Configuration Settings

Gate Keep's configuration file uses JSON format and is located at config/gatekeep.json. The file is created automatically upon first mod loading. In case of incorrect behavior, it's recommended to check the configuration and if necessary delete the file for regeneration.

Available Configuration Parameters

{
  "disabledDimensions": [
    "minecraft:the_end"
  ],
  "announce": true,
  "restrictedDimensionMessage": "&c%dimension% dimension is restricted",
  "timedDimensionRestrictedMessage": "&eRestricted till &6%time%",
  "unrestrictedAnnouncementMessage": "&a%dimension% dimension is now open!",
  "timeRestrictions": {
    "minecraft:the_end": {
      "enabled": true,
      "timeZone": "UTC",
      "unlockDateTime": "2024-12-31T23:59:59"
    }
  }
}

Parameter Explanations

• disabledDimensions: List of completely blocked dimensions
• announce: Whether to send announcements when time-based restrictions lift
• restrictedDimensionMessage: Message displayed when attempting to access a blocked dimension
• timedDimensionRestrictedMessage: Message shown for temporarily restricted dimensions
• unrestrictedAnnouncementMessage: Announcement text for dimension openings
• timeRestrictions: Settings for time-based dimensional restrictions
  • enabled: Whether the time restriction is active
  • timeZone: Time zone for unlock time (uses standard time zone IDs)
  • unlockDateTime: Date and time of restriction removal (in ISO format)

Message Formatting

Messages support Minecraft color codes using the & character:

• &0 through &9, &a through &f: Colors
• &k: Random characters
• &l: Bold text
• &m: Strikethrough text
• &n: Underlined text
• &o: Italic
• &r: Formatting reset

Message texts can use variables:

• %dimension%: Replaced with dimension name
• %time%: Replaced with unlock time (for temporarily restricted dimensions)

Configuration Examples

Basic End Blocking

{
  "disabledDimensions": ["minecraft:the_end"],
  "announce": true,
  "timeRestrictions": {}
}

Timed Nether Restriction

{
  "disabledDimensions": [],
  "announce": true,
  "timeRestrictions": {
    "minecraft:the_nether": {
      "enabled": true,
      "timeZone": "America/New_York",
      "unlockDateTime": "2024-06-01T12:00:00"
    }
  }
}

Combined Restrictions

{
  "disabledDimensions": ["minecraft:the_end"],
  "announce": true,
  "timeRestrictions": {
    "minecraft:the_nether": {
      "enabled": true,
      "timeZone": "UTC",
      "unlockDateTime": "2024-05-15T18:00:00"
    },
    "twilightforest:twilight_forest": {
      "enabled": true,
      "timeZone": "UTC",
      "unlockDateTime": "2024-07-22T15:06:20"
    }
  }
}

How It Works

When a player or entity attempts to change dimensions (including through commands or other game mechanics that use internal dimensional travel systems), the mod checks for restrictions on the target dimension. If the dimension is in the disabledDimensions list or has an active time restriction (unlock time not reached), access is denied. Operators with permission level 4 bypass all restrictions in creative mode. Checks for lifting time-based restrictions run in the background to minimize performance impact, with optional notifications sent to all online players.

Compatibility

Gate Keep is compatible with most modded dimensions and inter-dimensional travel methods.