FAQ

Questions?!!

What is XPlayersTokens?

XPlayersTokens is a lightweight, high-performance token system for Paper/Spigot servers (1.21.x, Java 17+). It provides token balance management, multi-database support (SQLite / MySQL / PostgreSQL), multi-language messages, an external API for other plugins, PlaceholderAPI support, and admin tools (top, add/set/remove/reset, maintenance mode).

How do I install the plugin?

Need a database!

• Drop XPlayersTokens.jar into your server plugins/ folder.

• Start the server once to generate default config.yml and lang/ files.

• Edit config.yml to configure your database and options.

• Restart (or reload) the server.

The plugin can’t connect to my database — what should I check?

• Verify host, port, database name, username and password in config.yml.

• Ensure the database user has correct privileges (CONNECT, SELECT, INSERT, UPDATE).

• Check that the DB server accepts remote connections (bind-address / firewall).

• Confirm correct DB type setting (mysql/postgres/sqlite).

• Look at server console for the connection error stack trace — it usually shows the underlying JDBC error.

Example MySQL JDBC snippet in config:

database:
  type: mysql
  host: "127.0.0.1"
  port: 3306
  database: "minecraft"
  username: "user"
  password: "pass"
  options: "?useSSL=false&serverTimezone=UTC" //ADD THIS LINE

Language files are missing or partially overwritten. How to restore?

• If files were deleted, stop the server, remove plugins/XPlayersTokens/lang/, then start the server to regenerate bundled language files.

• If you want to update only when the bundled language evolves, use the plugin’s language versioning (the plugin backs up old files and replaces only when the bundled lang-version is newer).

• To preserve custom changes, edit your files under plugins/XPlayersTokens/lang/ rather than the resource files.