
GateKeeper Dimension
GateKeeper controls Nether and End access with configurable mob, mining, trading, playtime, world-age, and date requirements. Includes individual and global progression, an admin GUI, portal protections, and optional PlaceholderAPI support.
Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
GateKeeper
GateKeeper lets server administrators control when players can enter the Nether and The End. Build progression rules from mob kills, mined blocks and drops, villager trades, playtime, world age, inventory items, or a scheduled date and time.
Features
- Flexible requirements: Combine conditions with
ALL(every condition is required) orANY(one condition is enough). Nest groups to create rules such as “trade 50 times and either kill 500 hostile mobs or mine 2,000 stone blocks.” - Custom targets and amounts: Track any supported block, item, or mob—not just the examples in the menu. Add and edit rules in the admin menu or use its Custom command button to paste a command into chat, adjust it, and run it.
- Useful player and admin menus:
/gatekeeper progressshows players their goals, counts, and completion state./gatekeeper settingsopens paginated admin controls for presets, condition editing, language, progress modes, announcements, and portal protection. - Individual or server-wide progress: Track eligible goals per player, globally, or with both counters required. Nether and End counters can be separate or shared, and End progress can be held until the Nether is unlocked.
- Specific or grouped mobs: Count one mob, several selected types, any mob, or a configurable group such as
hostileorpeaceful. - Mining without pickup exploits:
blocks_minedcounts successful block breaks.items_minedcounts drops produced by mining; picking up or dropping an item does not add progress. - Optional PlaceholderAPI support: Expose access state and condition progress to scoreboards, menus, chat formatters, and other PlaceholderAPI-compatible plugins.
- Dimension protections: Configure protection for Nether portal creation, End Portal frames, portal travel, and Ender Pearl travel into locked dimensions.
- English and Russian messages: English is the default. Switch languages in the admin menu or customize the message files.
Quick start
- Install GateKeeper on a Paper server running Java 17. PlaceholderAPI is optional.
- Start the server and run
/gatekeeper settingsas an administrator. - Choose a preset or open a dimension's condition list and add your goals.
- Players can view their progress with
/gatekeeper progressor/gatekeeper status.
Settings are stored in plugins/GateKeeper/config.yml. English and Russian messages are in plugins/GateKeeper/messages.yml and plugins/GateKeeper/messages_ru.yml; edit them and run /gatekeeper reload to apply changes.
Add a custom condition in game
Open /gatekeeper settings, select Nether or The End, then open Conditions → Custom command. Click a chat suggestion to paste it into the command line, edit the target or amount, and press Enter. For example, to require mining 1,000 dirt blocks:
/gatekeeper condition add nether blocks_mined dirt_1000 1000 material=DIRT
To change an existing rule, open it and choose the custom command option. Editing a rule's target or amount keeps its saved counter when its tracking scope stays the same. Deleting a rule does not erase its stored counter; reset actions in the menu require confirmation.
Command format:
/gatekeeper condition add <dimension> <type> <id> <amount> [property=value ...]
/gatekeeper condition set <dimension> <id> <type> <amount> [property=value ...]
Examples:
/gatekeeper condition add nether mob_kills zombie_hunt 25 entity=ZOMBIE
/gatekeeper condition add nether mob_kills hostile_hunt 500 mob-group=hostile
/gatekeeper condition add nether mob_kills mixed_hunt 50 entities=ZOMBIE,SKELETON
/gatekeeper condition add nether blocks_mined dirt 1000 material=DIRT
/gatekeeper condition add nether items_mined diamonds 20 material=DIAMOND
/gatekeeper condition add nether villager_trades trades 50 scope=GLOBAL
/gatekeeper condition add nether calendar_date release 1 date=2030-01-01T00:00:00 timezone=Pacific/Honolulu
/gatekeeper condition set nether dirt blocks_mined 2000 material=DIRT
Valid dimensions are nether and the_end. Supported condition types are mob_kills, blocks_mined, items_mined, inventory_item, villager_trades, played_days, world_days, and calendar_date. Targets may be set with properties such as material=DIRT, entities=ZOMBIE,SKELETON, mob-group=hostile, or a configured block group=stone. parent=<group-id> adds a new rule to an existing nested group.
Configuration example
Add a conditions list under a dimension's unlock-conditions. The list replaces that dimension's legacy scalar requirements.
dimensions:
the_end:
unlock-conditions:
logic: ALL
conditions:
- id: zombie-hunt
type: mob_kills
entity: ZOMBIE
amount: 25
- id: skeleton-hunt
type: mob_kills
entity: SKELETON
amount: 10
- id: stone-mining
type: blocks_mined
group: stone
amount: 1000
- id: diamond-drops
type: items_mined
material: DIAMOND
amount: 20
- id: villager-trades
type: villager_trades
amount: 5
- id: playtime
type: played_days
amount: 20
- id: seasonal-release
type: calendar_date
date: "2030-01-01T00:00:00"
timezone: "America/Los_Angeles"
Use logic: ALL to require every entry or logic: ANY to allow any one entry. A type: group entry can contain its own logic and conditions for nested rules.
Condition types
mob_kills— kill a specific entity, any entity (entity: ANY), a list (entities: [ZOMBIE, SKELETON]), or a configured mob group.blocks_mined— break a specific block, one of several blocks, or a configured block group.items_mined— produce item drops by mining blocks; loose item pickups do not count.inventory_item— have one of the configured item materials in the inventory.villager_trades— complete trades with villagers or wandering traders.played_days— accumulate player playtime in 24,000-tick Minecraft days.world_days— wait for the primary normal world to reach the configured age in Minecraft days.calendar_date— wait until a local date and time.timezone: AUTOuses the server's timezone; an IANA zone such asAsia/OmskorAmerica/Los_Angelescan be specified.
Progress settings
settings.progress.mode sets the default for event-counted goals: AUTO follows settings.mode, INDIVIDUAL tracks each player, GLOBAL shares progress across the server, and BOTH requires both personal and global counters to reach the goal. A counted rule can override the default with scope: INDIVIDUAL, GLOBAL, or BOTH. Playtime, world age, inventory checks, and calendar dates use their natural player, world, or server context.
Set settings.progress.dimension-scope: SHARED to share counters for matching rule IDs between Nether and The End; DIMENSION keeps them separate. settings.progress.unlock-order: NETHER_THEN_END holds End counter progress until Nether access is unlocked; INDEPENDENT lets both dimensions progress separately. played_days is based on each player's playtime, world_days on the primary normal world, and calendar_date on the configured timezone.
Mob kills from spawners and other sources count normally. Artificial-spawn filtering is disabled.
Commands
| Command | Description |
|---|---|
/gatekeeper progress |
Open the player progression menu. |
/gatekeeper status [player] |
Check your access status or, with permission, another player's. |
/gatekeeper settings |
Open the admin settings menu. |
/gatekeeper condition add ... |
Add a custom condition. Requires gatekeeper.admin. |
/gatekeeper condition set ... |
Edit a condition by its ID. Requires gatekeeper.admin. |
/gatekeeper unlock <player> <dimension> |
Grant access; replace <dimension> with nether or the_end. |
/gatekeeper lock <player> <dimension> |
Revoke access; replace <dimension> with nether or the_end. |
/gatekeeper reload |
Reload configuration and messages. |
Aliases: /gk, /worldlock, and /wlock.
Permissions
| Permission | Purpose | Default |
|---|---|---|
gatekeeper.use |
Use the main command. | Everyone |
gatekeeper.admin |
Manage conditions and access, reload, and open settings. | Operators |
gatekeeper.status.others |
Check another player's status. | Operators |
gatekeeper.bypass.nether |
Bypass Nether restrictions. | Nobody |
gatekeeper.bypass.the_end |
Bypass The End restrictions. | Nobody |
gatekeeper.bypass.end |
Alias for gatekeeper.bypass.the_end. |
Nobody |
gatekeeper.bypass.* |
Bypass all GateKeeper dimension restrictions. | Nobody |
PlaceholderAPI
PlaceholderAPI is optional and must be installed separately. When it is present, GateKeeper registers placeholders that other PlaceholderAPI-compatible plugins can use:
%gatekeeper_mode%%gatekeeper_unlocked_nether%,%gatekeeper_unlocked_the_end%%gatekeeper_progress_nether%,%gatekeeper_progress_the_end%%gatekeeper_required_nether%,%gatekeeper_required_the_end%%gatekeeper_remaining_nether%,%gatekeeper_remaining_the_end%%gatekeeper_mob_nether%,%gatekeeper_mob_the_end%%gatekeeper_rule_nether_<rule-id>_progress%%gatekeeper_rule_nether_<rule-id>_required%%gatekeeper_rule_nether_<rule-id>_complete%
Replace <rule-id> with the condition's configured ID. End rule placeholders use the_end in place of nether. For example, test a placeholder with /papi parse me %gatekeeper_rule_nether_zombie-hunt_progress%.
Compatibility
GateKeeper is built for Paper and Java 17. PlaceholderAPI is optional. It is not bundled with the plugin.

