# “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"

“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"