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
Code (YAML):
spawn:
world
:
"world"
location:
x
: 100
y
: 64
z
: 200
welcome_message
:
"Welcome, player!"
Placeholders:
Code (Text):
%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
Code (Text):
{
"users": {
"1234": {
"name": "Pudding",
"score": 99
}
},
"settings": {
"motd_message": "Welcome!",
"features": ["a", "b", "c"]
}
}
Placeholders:
Code (Text):
%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
Code (YAML):
# 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"