• 📂 Local File Loading Automatically scans and reads .json files from the plugins/PlaceholderAPI/json/ directory.
• ⚡ Smart Caching & Hot-Reload Caches JSON content in RAM for instant access. Automatically detects file changes on disk and reloads only when necessary. Zero performance impact.
• 🔍 Deep Nesting Support Full support for dot notation to access nested keys (e.g., messages.welcome.text).
• 🧠 Intelligent Matching Correctly distinguishes between similar filenames (e.g., shop.json vs shop_items.json).

To build this project, you need:

• JDK 21 or higher.
• Gradle (optional, wrapper is included).

Open your terminal in the project directory and run:

Windows (PowerShell/CMD):

.\gradlew build

Linux/macOS:

./gradlew build

The compiled file will be located at: build/libs/LocalJsonExpansion-1.x.x.jar

1. Stop your Minecraft server.
2. Navigate to plugins/PlaceholderAPI/expansions/.
3. Drop the JsonExpansion-1.x.x.jar file there.
4. Start the server.

The expansion looks for files in a specific folder. You must create it if it doesn't exist:

plugins/PlaceholderAPI/json/

The pattern is:

%json_<filename>_<path_to_key>%

File: plugins/PlaceholderAPI/json/holidays.json

{
  "first": "New Year",
  "second": "Christmas"
}

Placeholders:

• %json_holidays_first% → Returns: New Year
• %json_holidays_second% → Returns: Christmas

File: plugins/PlaceholderAPI/json/server.json

{
  "status": "online",
  "motd": {
    "line1": "Welcome to Paradise!",
    "maintenance": false
  }
}

Placeholders:

• %json_server_status% → Returns: online
• %json_server_motd.line1% → Returns: Welcome to Paradise!