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

Feature	Description
🚪 Instant Dimension Toggle	Open or close Nether/End with a single command
🛡️ Complete Access Control	Blocks both portal travel and teleportation
💾 Auto-Persistence	Settings automatically saved and restored
🎯 Zero Configuration	Works out of the box, no setup required
🔓 Bypass Permission	Staff can travel regardless of restrictions
📝 Tab Completion	Full command auto-completion support
🎨 Modern Chat Formatting	Beautiful gradient colors using Adventure API
⚡ Lightweight	Minimal resource usage, no dependencies

---

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	Description	Permission
/udc toggle nether	Opens/closes the Nether	udc.admin
/udc toggle end	Opens/closes The End	udc.admin
/udc status	Shows current dimension states	udc.admin

Command Aliases

• /dimensioncontroller
• /dimcontrol
• /dc

---

Permissions

Permission	Description	Default
udc.admin	Access to all UDC commands	OP
udc.bypass	Bypass dimension restrictions	OP
udc.*	Grants all UDC permissions	OP

---

What Gets Blocked

When a Dimension is Closed:

Access Method	Blocked?
✅ Nether Portal	Yes
✅ End Portal	Yes
✅ /tp command	Yes
✅ /teleport command	Yes
✅ Ender Pearls (cross-dimension)	Yes
✅ Chorus Fruit (cross-dimension)	Yes
✅ Other plugin teleports	Yes
✅ Command blocks	Yes

---

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

Specification	Value
Plugin Name	UltimateDimensionController
Version	1.0.0
Minecraft Version	1.21.1 - 1.21.x
Server Software	Paper (required)
Java Version	21+
API Used	Paper API, Kyori Adventure
File Size	~15 KB
Dependencies	None

---

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. 🌍🔥🐉**