stewbeet.plugins.finalyze.dependencies
The finalyze.dependencies plugin manages datapack dependencies and load sequence.
It automatically detects official library usage by scanning all functions, downloads libraries
via beet's content-addressed cache, sets up Lantern Load integration, and generates
runtime version-checking mcfunctions with user-friendly clickable error messages.
Required: Project ID, version, name, and author in context
Required: stewbeet.plugins.datapack.loading must run before
Optional: Official libraries (auto-detected from function usage)
Optional: Custom load_dependencies in metadata (see configuration below)
Position: Must run after all user functions have been written (scans them for library usage)
Related: Integrates with Lantern Load system
Some Features Showcase
Creates a dependencies check function and later use it:
Errors in chat when loading if missing dependencies:
Source Code: stewbeet/plugins/finalyze/dependencies/__init__.py
What it does
- Auto-detect and download official libraries used in functions: no manual config required (only optional)
- Detect Bookshelf modules via
#bs.X:tag patterns and modrinth/smithed libs via namespace - Generate runtime scoreboard version checks for all dependencies
- Integrate with Lantern Load for correct dependency loading order
- Validate Minecraft version compatibility using
DataVersionfrommc_supports - Provide clickable in-game error messages linking to each missing library
- Wire
smart_ore_generationsignal function tags automatically
๐ Full Guide: docs/5_dependencies/ ๐
Configuration
Basic Example Configuration
pipeline:
- ...
- stewbeet.plugins.finalyze.dependencies # Must run after all functions are written
- ...
# Official libraries are auto-detected: no manual config required (only optional).
# Declare custom dependencies to auto-download and version-check at runtime:
meta:
stewbeet:
mc_supports: ["1.21.4", "1.21.5"] # Optional: minimum is used for DataVersion check
load_dependencies:
# Smithed API: latest MC-compatible version auto-fetched
"smithed.crafter":
name: "Smithed Crafter"
url: "https://wiki.smithed.dev/libraries/crafter/"
source: "smithed"
smithed_id: "crafter"
has_resource_pack: true # optional, default false
# Modrinth API: latest release for the current MC version auto-fetched
"itemio":
name: "ItemIO"
url: "https://github.com/edayot/ItemIO"
source: "modrinth"
modrinth_slug: "itemio"
# Static URL: version pinned, zip downloaded per MC version
"common_signals":
version: [0, 2, 0]
name: "Common Signals"
url: "https://github.com/Stoupy51/CommonSignals"
source: "static"
static_urls:
"((1, 21, 7), (0, 2, 0))": "https://github.com/Stoupy51/CommonSignals/releases/download/v0.2.0/CommonSignals_datapack.zip"Configuration Options
| Option | Type | Default | Description |
|---|---|---|---|
load_dependencies | object | {} | Custom dependencies to download and version-check at runtime |
mc_supports | list | [] | Supported MC versions; minimum determines the DataVersion compatibility check |
| Official library detection | automatic | Enabled | Scans all functions for known library namespaces and #bs.X: Bookshelf tags |
| Version checking | automatic | Enabled | Generates check_dependencies and valid_dependencies mcfunctions |
load_dependencies Entry Fields
| Field | Required | Description |
|---|---|---|
name | โ | Display name shown in runtime error messages |
url | โ | Clickable link shown when the dependency is missing |
source | โ | Download method: "smithed", "modrinth", or "static" |
smithed_id | Smithed only | Smithed pack ID used to query the API |
has_resource_pack | Smithed only | Also download the resource pack (default: false) |
modrinth_slug | Modrinth only | Modrinth project slug used to query the API |
static_urls | Static only | Maps "((mc_ver), (dep_ver))" keys to download URLs |
version | Static only | Resolved automatically from static_urls at build time |
Features
Automatic Library Detection
Scans all datapack functions during build:
- ๐ Detects Bookshelf module usage via
#bs.X:tag call patterns - ๐ฆ Identifies
furnace_nbt_recipes,common_signals,itemio,smithed.actionbar,realistic_explosionby namespace - ๐ท๏ธ Marks detected libraries as
is_used = Trueand triggers download viaget_lib_paths() - ๐ข Logs a debug summary of all newly found libraries
Lantern Load Integration
Sets up proper loading infrastructure:
- ๐ท๏ธ Wires
minecraft:load->#load:_private/load-> init / pre_load / load / post_load phases - ๐ Resets
load.statusscoreboard inload:_private/init - โ๏ธ Creates
#ns:load->[#ns:enumerate, #ns:resolve]chain - ๐ Prepends
#ns:dependenciestag listing#dep:loadfor every dependency (deduped)
Runtime Version Validation
Generates two mcfunctions that run at world load:
- ๐ข
check_dependencies: sets#dependency_error ns.dataflag by checking#dep.major/minor/patch load.statusscores; uses$bsprefix for Bookshelf modules - ๐ฎ
valid_dependencies: waits for a player entity, readsDataVersionto detect Minecraft version, compares against minimum frommc_supports - ๐ข On failure:
tellraw @agold clickable links to each missing library (name, version, URL) - โ
confirm_loadis only called when both#mcload_errorand#dependency_errorare 0
Smart Ore Generation Integration
Special automatic wiring for smart_ore_generation:
- ๐ Connects
calls/smart_ore_generation/generate_ores,denied_dimensions, andpost_generationfunctions to the correspondingsmart_ore_generation:v1/signals/function tags - ๐ฏ Only activates when
smart_ore_generationis detected as used
Next steps
- Configuring the build: where this plugin sits in the pipeline.
- All plugins: the rest of the pipeline, in the order it runs.
- Configuring the build: enabling, ordering and configuring plugins.