NetherPortalFix FAQ
Basic Questions
Q: What problem does this plugin solve?
In vanilla Minecraft, when players teleport through nether portals, they may encounter the following issues:
- Returning from the Nether to the Overworld at the wrong portal
- Teleport position confusion when multiple portals are close together
- Original teleport relationships disrupted after building new portals
This plugin records player teleport history to ensure players always return to the correct portal.
Q: Which servers can use this?
| Server | Support Status | Notes |
|---|---|---|
| Luminol | ✅ Recommended | Fully supported |
| Leaves | ⚠️ Not needed | Has built-in fix feature |
| Other Luminol forks | ✅ Supported | Testing required |
Note
If you're using Leaves server, you don't need to install this plugin as Leaves already has built-in nether portal fix functionality.
Q: Will the plugin affect performance?
The plugin has minimal performance impact. It only records data when players use nether portals and doesn't continuously consume server resources.
Installation Issues
Q: Why isn't Mixin working?
Leavesclip disables Mixin by default. You need to add the JVM parameter to your server startup script:
-Dleavesclip.enable.mixin=trueComplete startup command example:
java -Xms4G -Xmx4G -Dleavesclip.enable.mixin=true -jar server.jar noguiQ: What if the plugin fails to load?
Please check the following:
- JDK Version - Ensure you're using JDK 21 or higher
- Server Compatibility - Ensure you're using Luminol or compatible server
- Mixin Parameter - Ensure startup command includes
-Dleavesclip.enable.mixin=true - Plugin Version - Ensure plugin version matches server version
If the issue persists, please submit an issue on GitHub Issues with complete error logs.
Usage Questions
Q: How long are teleport records saved?
By default, teleport records are saved for 3600 seconds (1 hour). You can modify the record-expire-time parameter in the configuration file to adjust the save duration.
# Teleport record expiry time (seconds)
record-expire-time: 3600Q: Do teleport records persist after server restart?
Yes, teleport records are persisted and remain valid after server restart.
Q: Does it support multi-world plugins?
The plugin primarily targets teleportation between the Overworld and Nether. Compatibility with additional worlds created by multi-world plugins may vary. If you encounter issues, please submit an Issue.
Other Questions
Q: How to get help?
- GitHub Issues - Submit bugs or feature requests
Q: How to contribute code?
Contributions via Issues or Pull Requests are welcome!
- Fork the repository
- Create a feature branch
- Commit your changes
- Submit a Pull Request