UltimateDimensionController

**

Description

UltimateDimensionController is a lightweight, modern administration plugin for Minecraft Paper servers (1.21.x) that gives server operators complete control over player access to the Nether and The End dimensions. With simple toggle commands, administrators can instantly open or close dimensions server-wide without any file editing or server restarts.

Built with a zero-configuration philosophy, the plugin works immediately upon installation with sensible defaults, while automatically persisting all changes across server restarts.

---

Key Features

---

Use Cases

1. Seasonal Event Control

Scenario: You want to open The End only during special server events.

 Before the event
/udc toggle end    → Closes The End

 Event begins
/udc toggle end    → Opens The End for dragon fight event

---

2. New Server Launch

Scenario: Your server just launched and you want players to establish themselves in the Overworld before accessing other dimensions.

 Week 1: Both dimensions closed
/udc toggle nether
/udc toggle end

 Week 2: Open Nether
/udc toggle nether

 Week 3: Open End for dragon fight
/udc toggle end

---

3. Maintenance Mode

Scenario: You need to perform maintenance on Nether world files.

 Close Nether for maintenance
/udc toggle nether

 Players see: "The Nether is currently closed."

 After maintenance
/udc toggle nether

---

4. Hardcore/Challenge Servers

Scenario: Running a challenge server where Nether access is a reward.

 Keep Nether closed by default
 Grant bypass permission to winners
/lp user <winner> permission set udc.bypass true

---

5. Roleplay Servers

Scenario: Story-driven server where dimensions unlock as the narrative progresses.

 Chapter 1: Overworld only
 Chapter 2: Nether portal discovered
/udc toggle nether

 Chapter 3: End portal activated
/udc toggle end

---

Commands Reference

Command Aliases

• /dimensioncontroller
• /dimcontrol
• /dc

---

Permissions

---

What Gets Blocked

When a Dimension is Closed:

---

Player Messages

When Nether is Closed:

[UDC] The Nether is currently closed.

When End is Closed:

[UDC] The End is currently closed.

Toggle Confirmations:

[UDC] The Nether has been OPENED.
[UDC] The Nether has been CLOSED.
[UDC] The End has been OPENED.
[UDC] The End has been CLOSED.

Status Display:

[UDC] Dimension Status:
  » Nether: OPEN
  » The End: CLOSED

---

Configuration

Default config.yml (Auto-generated)

dimensions:
  nether-enabled: true
  end-enabled: true

Note: You never need to edit this file manually. Use in-game commands instead.

---

Technical Specifications

---

Installation

1. Download UltimateDimensionController-1.0.0.jar
2. Place in /plugins/ folder
3. Start or restart server
4. Done! Use /udc status to verify

---

Compatibility

Compatible With:

• Paper 1.21.1+
• Folia (with minor adjustments)
• LuckPerms
• Multiverse-Core
• EssentialsX
• WorldGuard
• All teleportation plugins

Not Compatible With:

• Spigot (requires Paper API)
• Bukkit (requires Paper API)
• Minecraft versions below 1.21

---

Frequently Asked Questions

Q: Does this work with Multiverse?

A: Yes! It blocks access to any world with Nether or End environment type, including custom Multiverse worlds.

Q: Can I give specific players access when closed?

A: Yes! Grant them the udc.bypass permission.

Q: Does it affect mobs or entities?

A: No, only player access is controlled.

Q: Will settings reset on restart?

A: No, all settings persist in config.yml automatically.

Q: Can I use this with BungeeCord?

A: Yes, install on each individual server you want to control.

---

Changelog

Version 1.0.0

• Initial release
• Nether and End toggle commands
• Portal and teleport blocking
• Bypass permission system
• Auto-persistence
• Full tab completion
• MiniMessage colored output

---

UltimateDimensionController - Simple dimension control for modern Minecraft servers. **