FAQ — ModernHDV
Frequently asked questions and quick solutions.
Installation & Startup
The plugin does not start after installation. What should I check first?
Check the server console first. ModernHDV shows a clear message if a dependency is missing (Vault, economy) or if loading failed. Fix the cause, then fully restart the server.
Does ModernHDV work immediately after installation?
Yes, with the default configuration the plugin starts in single-server mode with local storage. The goal is to allow a quick first test without prior technical setup.
Should I use `/reload` for quick testing?
It is not recommended. For a first startup or after a major change, prefer a full restart to avoid partially reloaded states.
Economy & Vault
Why is Vault required?
ModernHDV uses Vault as the integration layer to communicate with compatible economy plugins. This keeps it compatible with different solutions without depending on a single economy plugin.
Does ModernHDV manage player money by itself?
No. ModernHDV relies on your economy plugin through Vault. Make sure a compatible economy is active on the server before testing sales and purchases.
On a network, why can balances become inconsistent?
The auction house can be synchronized between servers, but player balances must also be shared/synchronized by your economy solution. Without that, transactions can become inconsistent from one server to another.
Configuration
Do I need to edit `config.yml` to get started?
No. The plugin is usable with its default configuration. The Configuration page serves as a reference to adapt its behavior to your infrastructure (single-server, network, storage, Pro options).
SQLite or MySQL: which one should I choose?
For a single server, SQLite is suitable and simple. MySQL is intended for advanced use cases and multi-server networks, and requires the Pro version plus correct database configuration.
What should I do if the MySQL connection fails?
Check the credentials, host, port, database name, and SSL settings. If your provider enforces strict SSL, adjust the plugin SSL configuration to match your environment.
Customization
Can everything be customized without the Pro version?
The Free version allows customization through YAML files (interface, categories, text). The Pro version adds faster in-game editing through GUI Admin without removing YAML compatibility.
Which files are involved in customization?
Mainly items-gui.yml, items-categories.yml, and the lang/*.yml files. They cover the interface, categories, and the text shown to players.
My changes do not appear immediately. Why?
Depending on what you edit, a reload or restart may be required. In the Pro version, some hot-reload operations are available to speed up testing.
Pro Version
What does the Pro version mainly add?
The Pro version adds advanced administration features (GUI Admin, hot reload), automatic upgrade tools, and network capabilities (MySQL, SQLite ↔ MySQL transfer, multi-server) for more complex infrastructures.
Is multi-server mode available in Free?
No. Multi-server mode and MySQL support are Pro features. They are designed for networks that want to share one global auction house across multiple servers.
Can I keep using YAML files in Pro?
Yes. The Pro version adds in-game tools but keeps YAML editing compatibility, which lets you retain an existing administration workflow if you want.
Can Pro migrate my existing Free setup?
Yes. Since 1.2.0, the Pro version includes an automatic Free → Pro migration flow for the main plugin files, plus storage transfer tools between SQLite and MySQL when required.
Help
If your issue persists, contact MCMinelab support.