FAQ / Troubleshooting
FAQ & troubleshooting
Common buyer questions and a diagnostic checklist for WujaDev support.
Questions
Do I need MythicMobs / ItemsAdder / ModelEngine?
No. WujaRift is standalone. MythicMobs is an optional soft hook (v1.1) if you want mythic: mob types — see the MythicMobs docs page.
Does it work on Folia?
Yes, the project is Folia-ready. Always test on your exact Folia build before production.
Are Vault / PAPI required?
No. Soft hooks only. Without them the plugin works; without Vault there are no economy rewards, without PAPI no placeholders.
How often do rifts start?
You set that in config.yml (auto-events.interval-seconds / cron / chance, cooldown) and weight in events/*.yml.
How much does the plugin cost?
Sales positioning: about $19.99 USD / ~79 PLN (one-time).
Troubleshooting
| Symptom | What to check |
|---|---|
| Plugin won't enable | Paper 1.21+, Java 21+, console errors, corrupted JAR |
| Reload breaks config | YAML validation (indentation), restore backup, restart instead of reload |
| Rift won't auto-start | scheduler.enabled / rules, or legacy auto-events; min-players; world blacklist; cooldown; max concurrent; /rift scheduler status |
| No / too few mobs | WorldGuard / protection, spawn rules, clear-lag, Y min/max in config |
| Lag during event | Lower mob amounts in presets, particles, concurrent rifts |
| Empty placeholders | Is PAPI installed, did expansion register, parse with /papi parse |
| Vault doesn't pay | Economy provider + Vault, hooks.vault, rewards vault table |
| Relic doesn't work | ID in relics.yml, charges, cooldown, conflict with another item plugin |
What to collect for a ticket
- Paper/Purpur/Folia version + Java
- WujaRift version
- Plugin list (or at least protection / clearlag / economy)
- Log fragment with the error
- YAML snippet (no secrets) — event or config
Do not paste full files with tokens / database passwords into a public Discord. Cut only the needed sections.