# “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
- 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/<language>.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/<language>.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"
