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