Skip to main content
The config.yml file is located in the plugin’s root folder (plugins/CoolCars/config.yml) and contains settings that affect the entire plugin.

​
Key System (keys)

This section defines how players access vehicles. You can create a GTA-style server where cars can be started without a key, or an RP-style server where a key is mandatory. 
keys:
  enabled: true                         # Enable the key system
  require-key-to-start-engine: true     # Is a key required to start
  allow-owner-start-without-key: true   # Owner can start without a key
  check-entire-inventory: true          # Search for key in the entire inventory
If check-entire-inventory is disabled, the player must hold the key in their main or off-hand to start the engine.

​
User Interface (Action Bar)

CoolCars displays important information (speed, fuel, status) directly above the player’s hotbar.

​
Speedometer Settings (ui.action-bar.car)

  • format: The string displayed to the player. Supports many placeholders.
  • update-ticks: Update frequency. 2 ticks is the ideal balance between smoothness and performance.
Available Placeholders:
  • {speed_kmh} — Speed in km/h.
  • {hp_bar} — Health bar.
  • {fuel_percent} — Fuel percentage.
  • {engine} — Engine status (On/Off).

​
Language Settings (language)

The plugin supports automatic player language detection.
  • global: If true, all players will see messages in the language specified in default.
  • use-player-locale: If true, the plugin will check the language selected in the player’s Minecraft client (EN, RU, etc.).

​
Database (database)

CoolCars saves data about car owners, their condition, and location.
  • type: sqlite (file) or mysql (for cross-server sync).
  • telemetry: If enabled, the plugin records event history (crashes, refueling) that can be viewed later.

​
Commands (commands)

You can restrict the use of certain administrative commands. For example, car-heal allows instantly repairing a car. You can allow or deny the use of this command from the server console in the config. 
commands:
  car-heal:
    enabled: true
    allow-console: true