Detailed Documentation & Guide v2.5.0

1. Database Requirements
To ensure the script works correctly, the following conditions must be met:
* Same Database Server: The PlotSquared database and your player data source (CMI or LuckPerms) must be located on the same MySQL/MariaDB server.
* LuckPerms Setup: If you choose LuckPerms, it must be configured to use a MySQL/MariaDB storage (standard H2 local storage is not accessible via web).
* External Access: If your webserver is not the same as your DB server, ensure Port 3306 is open and your DB user has remote access permissions.

2. The Web-Installer (install.php)
Version 2.5.0 introduces a user-friendly installer that creates your config.inc.php automatically.
* Permissions: Make sure your web directory is writable (CHMOD 755 or 777 during the installation process).
* Configuration: Simply follow the on-screen instructions to link your databases and select your preferred language.
* Security: IMPORTANT: Delete the install.php file immediately after a successful installation to prevent unauthorized configuration changes.

3. Customizing Languages
Adding your own language is very simple:
1. Navigate to the /lang folder.
2. Copy en.php and rename it (e.g., it.php for italian).
3. Translate the strings within the array.
You can also use the AI. Simply enter the content and request the output as code in the new language.
4. Select your language code during the installation process or update it manually in your config.inc.php.

4. Troubleshooting (FAQ)
* Problem: "Database Connection Refused"
* Solution: Double-check your credentials and ensure your webserver's IP is whitelisted in your MySQL firewall.
* Problem: "Player names not showing (LuckPerms)"
* Solution: Ensure you selected the correct table prefix in the installer (usually luckperms_).
* Problem: "Mojang API Error"
* Solution: Your webserver must allow outgoing connections to api.mojang.com to resolve player names.

5. Developer Note
This project is open-source. If you find any bugs or want to suggest features, please visit our GitHub repository.

____________________________________________________________
Detaillierte Dokumentation & Hilfe V2.5.0

1. Datenbank-Voraussetzungen
Damit das Skript funktioniert, müssen folgende Bedingungen erfüllt sein:
* Gleicher Server: Die PlotSquared-Datenbank und die Namens-Datenbank (CMI oder LuckPerms) müssen auf demselben MySQL/MariaDB-Server liegen.
* LuckPerms: Wenn du LuckPerms nutzt, muss LuckPerms so eingestellt sein, dass es eine MySQL/MariaDB-Datenbank nutzt (kein H2/Lokal-Speicher).
2. Der Installer (install.php)
Der Installer erstellt automatisch die Datei config.inc.php.
* Berechtigungen: Stelle sicher, dass der Webserver Schreibrechte im Ordner hat (CHMOD 755 oder 777 während der Installation).
* Sicherheit: Der Installer ist nach der ersten Ausführung gesperrt, solange die config.inc.php existiert. Dennoch wird dringend empfohlen, die Datei install.php nach der Einrichtung zu löschen.
3. Sprachdateien anpassen
Du möchtest eine eigene Sprache hinzufügen?
1. Gehe in den Ordner /lang.
2. Kopiere die en.php und nenne sie z.B. fr.php.
3. Übersetze die Begriffe im Array.
4. Ändere den Sprachcode im Installer oder manuell in der config.inc.php. 4. Fehlerbehebung (FAQ)
* Problem: "Datenbankverbindung abgelehnt" (Database Connection Refused)
* Lösung: Überprüfe deine Zugangsdaten und stelle sicher, dass die IP deines Webservers in der MySQL-Firewall auf der Whitelist steht.
* Problem: "Spielernamen werden nicht angezeigt (LuckPerms)"
* Lösung: Stelle sicher, dass du im Installer das richtige Tabellen-Präfix ausgewählt hast (normalerweise luckperms_).
* Problem: "Mojang API Fehler"
* Lösung: Dein Webserver muss ausgehende Verbindungen zu api.mojang.com zulassen, um Spielernamen auflösen zu können.

5. Entwickler-Hinweis
Dieses Projekt ist Open-Source. Wenn du Fehler findest oder neue Funktionen vorschlagen möchtest, besuche bitte unser GitHub-Repository.