“In modern Minecraft, players can reach the Nether instantly even on first login with just a water bucket and lava pool. Have you ever questioned this?”

🔒 Portal Lock

This mod prevents players from entering portals unless they have a required item.

✔ Supports Nether Portal
✔ Supports End Portal
✔ Fully configurable
✔ Server-friendly

---

🎮 How it works

Players must carry a specific item to enter:

• Nether Portal → configurable item
• End Portal → configurable item

If the item is missing:

• Entry is blocked
• A message is displayed
• A sound is played

---

⚙ Configuration

You can change:

• Required items
• Number of required items (e.g., 0 is also possible)
• Messages
• Sounds

---

🌍 Supported Languages

• English (en_us)
• Japanese (ja_jp)
• German (de_de)
• French (fr_fr)
• Spanish (es_es)
• Portuguese (pt_br)
• Italian (it_it)
• Korean (ko_kr)
• Chinese Simplified (zh_cn)
• Russian (ru_ru)

---

==============================

The following items can be configured in the config:

Portal Lock Configuration (Default settings)

==============================

Required item ID to enter the Nether.

nether_item: "minecraft:glowstone"

Required amount of the Nether item.

Set to 0 to require the item without consuming it.

nether_amount: 1

Optional custom Nether message.

Leave blank to use language files automatically.

By default, edit messages in config/portal-lock/lang/.json

If set here, this message overrides all language files.

Supports color codes:

&0-&9, &a-&f, &r

Supports placeholders:

%item%

%item_id%

For unsupported client locales outside the bundled 10 languages,you can also override the message here.

nether_message: ""

Show the denied Nether message in the action bar overlay.

If false, the message will be shown in the chat.

nether_overlay: true

Sound played when Nether entry succeeds.

nether_success_sound: "minecraft:entity.enderman.teleport"

Sound played when Nether entry is denied.

nether_fail_sound: "minecraft:block.anvil.place"

Enable or disable the End portal lock.

end_enabled: true

Required item ID to enter the End.

end_item: "minecraft:end_crystal"

Required amount of the End item.

Set to 0 to require the item without consuming it.

end_amount: 1

Optional custom End message.

Leave blank to use language files automatically.

By default, edit messages in config/portal-lock/lang/.json

If set here, this message overrides all language files.

Supports color codes:

&0-&9, &a-&f, &r

Supports placeholders:

%item%

%item_id%

For unsupported client locales outside the bundled 10 languages,you can also override the message here.

end_message: ""

Show the denied End message in the action bar overlay.

If false, the message will be shown in the chat.

end_overlay: true

Sound played when End entry succeeds.

end_success_sound: "minecraft:entity.enderman.teleport"

Sound played when End entry is denied.

end_fail_sound: "minecraft:block.anvil.place"

Volume for success and fail sounds.

volume: 1.0

Pitch for success and fail sounds.

pitch: 1.2

Language mode: auto or fixed.

language_mode: "auto"

Used only when language_mode is fixed. Example: en_us, ja_jp

fixed_language: "en_us"

Fallback language when the client locale is unsupported.

fallback_language: "en_us"