Skip to content

00. For Data‐Driven Folders

Sleys edited this page Jun 18, 2026 · 3 revisions

📦 Data-Driven Integration

SL Data-Driven can discover and load files packaged inside other mods. This mechanism is used by several systems to read JSON definitions and other resources directly from a mod's .jar.

Note SL Data-Driven is responsible for discovering and collecting files. The actual parsing and processing logic must be implemented by the system that consumes them.


💡 How It Works

📄 1. Declare the Dependency

Your mod must declare a dependency on sl_data_driven in its META-INF descriptor.

[[dependencies.your_modid]]
modId="sl_data_driven"
mandatory=true
versionRange="*"
ordering="AFTER"
side="BOTH"

📄 2. Create the Data-Driven Directory

Inside your mod resources, create the following directory:

data_driven/<your_mod_id>/

📁 3. Add Your Files

Place any files that should be discovered by SL Data-Driven inside this directory.

Example:

data_driven/
└── <your_mod_id>/
    ├── innate_skill_builder/simple_innate_skill/
    │                                └── skill.json
    └── weapon_builder/category/
                         └── category.json

📄 4. Automatic Discovery

During startup, SL Data-Driven:

  • Detects mods that declare a dependency on sl_data_driven
  • Scans the data_driven directory
  • Collects the files contained within it
  • Makes those files available to supported systems

🔄 Verifying Detection

A mod is considered valid for Data-Driven loading when:

  • The dependency on sl_data_driven is present
  • The mod contains a valid META-INF descriptor
  • The mod is loaded successfully by NeoForge/Forge

When these requirements are met, the mod namespace should appear in the Data-Driven registry list.

✔️ Valid Registration

image

❌ Invalid Registration

image

📄 Minimum Requirements

To be recognized as a valid Data-Driven provider, a mod must:

  • Include a valid META-INF descriptor
  • Use the lowcodefml mod loader
  • Declare a dependency on sl_data_driven

📊 Complete Example

modLoader="lowcodefml"
loaderVersion="[47,)"
license="All Rights Reserved"

[[mods]]
modId="your_modid"
displayName="Your Mod Name"
version="1.0"
authors="you"

[[dependencies.your_modid]]
modId="sl_data_driven"
mandatory=true
versionRange="*"
ordering="AFTER"
side="BOTH"

Clone this wiki locally