PAPI - ConfigEase

ConfigEase is a PlaceholderAPI expansion that allows you to read YAML or JSON configuration files from other plugins using placeholders.
*Please place this plugin in the plugins folder when installing.

%<identifier>_<pluginName>_<configFile>_<path...>%

• <identifier>: yamlConfig or jsonConfig
• <pluginName>: The folder name under /plugins, where the config file is located
• <configFile>: The file name (e.g. config.yml or data.json)
• <path>: The key path inside the config file, using . as level separator

YAML Example

File: plugins/Essentials/config.yml

spawn:
  world: "world"
  location:
    x: 100
    y: 64
    z: 200
welcome_message: "Welcome, player!"

Placeholders:

%yamlConfig_Essentials_config.yml_spawn.world% → world
%yamlConfig_essentials_config.yml_spawn.location.x% → 100
%yamlConfig_essentials_config.yml_welcome_message% → Welcome, player!

JSON Example

File: plugins/test/data.json

{
  "users": {
    "1234": {
      "name": "Pudding",
      "score": 99
    }
  },
  "settings": {
    "motd_message": "Welcome!",
    "features": ["a", "b", "c"]
  }
}

Placeholders:

%jsonConfig_test_data.json_users.1234.name% → Pudding
%jsonConfig_test_data.json_settings.motd_message% → Welcome!
%jsonConfig_test_data.json_settings.features.1% → b

Config

# Default root directory where plugin config files are located
default_path: "plugins"

# Error messages shown when placeholder evaluation fails
messages:
  invalid_format: "Invalid Format"
  file_not_found: "File Not Found"
  no_key: "No Key"
  error: "Error"