Treeplacer Sapling Override Generator (#878)

Author: OutrightWings

public/mcdoc/treeplacer.mcdoc

@@ -0,0 +1,49 @@
+
+dispatch minecraft:resource[treeplacer:sapling_overrides] to struct TreeplacerSaplingOverrides {
+	/// Should this override other datapack's files of the same name. False will merge them. Default to false
+	replace: boolean,
+	/// Dictionary of keys (biome or block ids) to their features.
+	/// Tags do not work yet.
+	/// Biomes apply the rule when the sapling is inside them. 
+	/// Blocks apply whenever that sapling is on them.
+	/// Order of rule application: Block > Biome > All_Biomes > Vanilla
+	values: SaplingEntries
+}
+struct SaplingEntries {
+	[Key]: (#[id=feature]string | FeatureEntry | [FeatureEntry]),
+}
+
+type Key = (
+    string |
+    "treeplacer:all_biomes"
+)
+
+struct FeatureEntry {
+	/// Configured feature id
+    feature: #[id=feature]string,
+	/// (optional) Only useful in a list context to weight the random selection 
+    weight?: int,
+	/// (optional) Vanilla weirdness used in terrain gen. w > 0 is true. 
+	/// Useful for basic regions as weirdness swaps along rivers
+    weird?: boolean,
+	/// (optional) Restrict rule to world positions 
+	x?: HeightRange,
+	/// (optional) Restrict rule to world positions 
+    y?: HeightRange,
+	/// (optional) Restrict rule to world positions 
+	z?: HeightRange,
+	/// (optional) Block ids the sapling must be on for the rule to apply to.
+	/// Redundant for global block keys, use with biome keys
+    block?: [BlockPredicate],
+}
+
+struct HeightRange {
+	/// (optional) Inclusive 
+    min?: int,
+	/// (optional) Inclusive 
+    max?: int,
+}
+
+struct BlockPredicate {
+    id: #[id=block]string,
+}

src/config.json

@@ -1121,6 +1121,15 @@
       "dependency": "starexpress",
       "wiki": "https://github.com/AussieBox/StarryExpress/wiki/The-Guidebook",
       "minVersion": "1.21.1"
+    },
+    {
+      "id": "treeplacer:sapling_overrides",
+      "url": "treeplacer/sapling_overrides",
+      "path": "sapling_overrides/minecraft",
+      "tags": ["partners"],
+      "dependency": "treeplacer",
+      "minVersion": "1.20.1",
+      "wiki": "https://github.com/OutrightWings/treeplacer_mod/wiki"
     }
   ],
   "legacyGuides": [

src/locales/en.json

@@ -164,6 +164,7 @@
   "generator.pixelmon:pokedex_region": "Region",
   "generator.starexpress:guidebook_entry": "Guidebook Entry",
   "generator.trade_set": "Trade Set",
+  "generator.treeplacer:sapling_overrides": "Sapling Overrides",
   "generator.trial_spawner": "Trial Spawner",
   "generator.trim_material": "Trim Material",
   "generator.trim_pattern": "Trim Pattern",
@@ -240,6 +241,7 @@
   "partner.sky_aesthetics": "Sky Aesthetics",
   "partner.starexpress": "Starry Express",
   "partner.thermoo": "Thermoo",
+  "partner.treeplacer": "Treeplacer",
   "partner.pixelmon": "Pixelmon",
   "presets": "Presets",
   "presets.no_results": "No presets",