# EndPortal Plugin - User Guide ## 📖 About the Plugin **EndPortal** - a plugin for managing access to The End dimension. Allows you to enable/disable the portal, schedule automatic opening/closing, and display portal status to players. **Version:** 2.0.0 | **Minecraft:** 1.21+ | **Platform:** Paper, Spigot, Purpur, Folia ## 📋 Admin Commands **Main command:** `/endportal` (aliases: `/ep`, `/portal`) **Permission:** `endportal.admin` (OP only by default) | Command | Description | |---------|-------------| | `/endportal on` | Enable the portal | | `/endportal off` | Disable the portal | | `/endportal toggle` | Toggle portal state | | `/endportal status` | Show status and schedule | | `/endportal schedule-open <date> <time>` | Schedule opening | | `/endportal schedule-close <date> <time>` | Schedule closing | | `/endportal cancel` | Cancel all scheduled events | | `/endportal reload` | Reload configuration | | `/endportal help` | Show help | ### Command Examples: ``` /endportal on /endportal schedule-open 31.12.2025 20:00 /endportal schedule-close 01.01.2026 06:00 /endportal cancel ``` --- ## 👥 Player Commands **Main command:** `/endcount` (aliases: `/ec`, `/counter`) **Permission:** `endcount.use` (everyone by default) | Command | Description | |---------|-------------| | `/endcount` | Toggle counter | | `/endcount on` | Enable counter | | `/endcount off` | Disable counter | | `/endcount status` | Show portal status | | `/endcount help` | Show help | --- ## 📅 Date and Time Format **Format:** `dd.MM.yyyy HH:mm` **Correct examples:** ``` 31.12.2025 23:59 ✅ 01.01.2026 00:00 ✅ 15.06.2025 18:30 ✅ ``` **Incorrect examples:** ``` 31.12.2025 23.59 ❌ (dot instead of colon) 33.12.2025 19:22 ❌ (December 33rd doesn't exist) 31-12-2025 23:59 ❌ (dashes instead of dots) ``` **Important:** - Use **dots** in date: `31.12.2025` - Use **colon** in time: `20:00` - Time in 24-hour format - Date and time must be in the future **Examples:** ```yaml message: "&c&lWARNING!" message: "&6[&cEndPortal&6] &fMessage" ``` --- ## 🔧 Placeholders | Placeholder | Description | Example | |-------------|-------------|---------| | `{status}` | Portal status | `Open`, `Closed` | | `{time}` | Time until event | `2h 30m 15s` | | `{datetime}` | Date and time | `31.12.2025 20:00` | | `{minutes}` | Minutes until event | `5` | --- ## 🔑 Permissions | Permission | Description | Default | |------------|-------------|---------| | `endportal.admin` | All admin commands | OP | | `endcount.use` | Counter commands | Everyone | **Setup (LuckPerms):** ``` /lp group admin permission set endportal.admin true ``` --- ## 💡 Usage Examples ### Holiday Event ``` /endportal off /endportal schedule-open 31.12.2025 20:00 /endportal schedule-close 01.01.2026 06:00 ``` ### Weekly Access (weekends) ``` /endportal schedule-open 27.12.2025 18:00 /endportal schedule-close 29.12.2025 23:59 ``` ### Maintenance ``` /endportal off # After completion: /endportal on ``` --- ## ❓ Common Issues **Portal works even though it's disabled** - Check `block-teleportation: true` in config.yml - Use `/endportal reload` **Error "Invalid data/time format"** - Check format: `31.12.2025 20:00` (colon!) - Day must exist (not 33.12) - Time must be in the future **Counter not displaying** - Use `/endcount on` - Check `endcount.use` permission **Scheduled event didn't execute** - Check that time was in the future - Check server logs - Use `/endportal status`