Current Issues

🐞 Known Issues

Below are currently known recurring issues and their recommended workarounds or fixes.

---

❗ TeleportTask Null

Error Message (console / logs):

You can't cancel TeleportTask because TeleportTask is null!

When does this happen?
Occurs occasionally when a player teleports to:

• A home (/home <name> or /home)
• The spawn (/spawn or equivalent alias)
• Shortly after a server (re)start or plugin reload

✅ Quick Fix

Simply restart your server. In most cases the scheduler context that manages delayed or cancellable teleports failed to initialize properly during the first load.

🧪 Why It Happens (Likely Causes)

• The internal teleport handler (task wrapper) was never created because initialization order was interrupted.
• A plugin reload (/reload) or hot-reload plugin manager skipped lifecycle hooks.
• Another plugin cancelled or interfered with scheduled tasks.
• Rare race condition between player join + immediate teleport command.

🛠 Recommended Steps Before Reporting

1. Restart the server cleanly (no /reload).
2. Avoid using /reload; do a full restart instead.
3. Check if the error still occurs with only HomePlugin + a permissions plugin.
4. Collect:
   • Server version (e.g. Paper 1.20.4 build ####)
   • HomePlugin version (JitPack tag / commit)
   • Java version (java -version)
   • List of major gameplay / teleport / region plugins
   • Exact command used and context (player just joined? in combat? etc.)

📨 Still Broken?

Open an issue:
https://github.com/fuzeblocks/HomePlugin/issues

Please include:

• Steps to reproduce (numbered)
• Expected vs actual result
• Full stack trace (if any)
• Config excerpts related to teleport / delays
• Whether Redis is enabled (if applicable)

---

🧾 Issue Reporting Guidelines

When opening an issue:

• One problem per issue (don’t bundle multiple unrelated bugs)
• Use a clear title (e.g. [BUG] TeleportTask null on /home after restart)
• Attach logs using a paste service (NOT screenshots when possible)
• Mention if this happens only under load / with many players

---

💬 Need Direct Help?

If the issue persists and you cannot isolate it, feel free to contact the maintainer or join the support channel (if available).

---

This document will be expanded as new issues are identified.
Found something else? Let us know!