NSUK-Kaleidoscope_Crop_Addons

Kaleidoscope: Crop Addons

Kaleidoscope: Crop Addons

Let the hired farmers in the New:Sim-U-Kraft farm box grow Kaleidoscope-series (森罗物语) crops that can be planted on farmland.

Introduction ·
Features ·
Dependencies ·
Installation ·
Usage ·
Extending ·
Building

Introduction
After hired farmers open the farm box, besides vanilla wheat, carrots, potatoes, and beets, they can also select any loaded Kaleidoscope (森罗) crops. The workflow is identical to vanilla wheat: dig irrigation channels, till the soil, sow seeds, use bone meal to accelerate growth, harvest, and replant.
When only this addon and NSUK are installed, the farm box still shows only vanilla crops, and the game launches normally. Once the corresponding Kaleidoscope mods are installed, their crops appear grouped by source in the selection interface.
Sister mod: NSUK: Delight Crop Addons (Farmer’s Delight series). The two addons can be installed together.
Item
Content
Mod ID
kaleidoscopecropaddons
Game Version
Minecraft 1.21.1
Loader
NeoForge 21.1.x (developed with 21.1.248)
Required
New:Sim-U-Kraft (simukraft)
Languages
Simplified Chinese / English
License
GNU GPL 3.0
Authors
XiaoLiang小亮 & 安沐尘
Artifact
KaleidoscopeCropAddons-1.0.0-neoforge-1.21.1.jar
Features

• Farm box crop list grouped by Kaleidoscope mod, with Chinese/English search support
• Farmers take seeds from the chest next to the farm box and work using the wheat workflow
• Mod menu lets you toggle each Kaleidoscope source on/off, and manually add custom crops
• Datapack JSON suffices to integrate other Kaleidoscope mods without touching Java
• With auto-discovery enabled, scans loaded mods for “seed item → CropBlock on farmland” combinations
• Orchard strawberry ships with a loot table override so farm box harvests drop strawberries normally
• Soft compatibility with FTB Ultimine: will not steal crop harvesting from this mod’s own directory
  Dependencies
  Required
• Minecraft 1.21.1
• NeoForge 21.1.x
• New:Sim-U-Kraft (simukraft)
  Optional
  Crops only appear when installed. Unloaded mods have their entire JSON skipped, which does not affect launch.
  Mod
  Mod ID
  Farmland Crops
  Kaleidoscope: Cookery
  kaleidoscope_cookery
  Tomato, Chili, Lettuce
  Kaleidoscope Kitchen: National Flavors
  kaleidoscope_chinesefood
  Eggplant
  Kaleidoscope: Grilling
  kaleidoscope_grilling
  Rapeseed, Onion, Sweet Potato, Fish Mint (Houttuynia)
  Kaleidoscope: Dimensional Wine Cellar
  kaleidoscope_dim_wine
  Hops
  Kaleidoscope: Twilight
  kaleidoscope_twilight
  Fern Shoots
  Kaleidoscope: Orchard
  kaleidoscope_orchard
  Strawberry
  Crop definitions are under src/main/resources/data/kaleidoscopecropaddons/kaleidoscope_crops/, one JSON per Kaleidoscope mod.
  Installation

1. Install Minecraft 1.21.1 and NeoForge 21.1.x.
2. Place New:Sim-U-Kraft and this mod’s jar into the mods folder.
3. Add the Kaleidoscope mods from the table above as needed.
4. Artifact filename: KaleidoscopeCropAddons-<version>-neoforge-1.21.1.jar.
   Usage
5. Place an NSUK Farm Box and hire a farmer.
6. Place a chest directly adjacent to the farm box and put the corresponding seeds inside.
7. Open the farm box → Select Crop. Kaleidoscope crops are grouped by mod; use the search box to filter by Chinese or English.
8. Select the farmland area, then start the job.
   In-game mod menu (Mods → Kaleidoscope: Crop Addons → Config) lets you:

• Toggle a Kaleidoscope source on/off
• Disable auto-discovery
• Add custom crops (enter a seed item ID; it appears under the “Other” group in the farm box)
  Coverage
  Farmers handle crops that can be planted on vanilla farmland and harvested in place when mature. As long as the seed can be planted on farmland, the farmer will till, sow, bone-meal, harvest, and replant just like vanilla wheat.
  Not Yet Covered
  These plants cannot be worked through the farm box’s farmland workflow:
• Rice (paddy)
• Grapes (trellis)
• Ender Mint (end stone)
• Soul Chili / Poisonous Berry (soul sand)
• Echo Crops (sculk catalyst)
  If these mods later add true CropBlock farmland seeds, enabling auto-discovery will surface them automatically.
  Adding Crops for Other Kaleidoscope Mods
  Recommended: just add a datapack JSON, no Java changes needed.
  Place under a resource pack or datapack:
  data/kaleidoscopecropaddons/kaleidoscope_crops/<mod id>.json
  Example:
  {
  “mod”: “kaleidoscope_cookery”,
  “prefix”: “kc”,
  “label”: “source.kaleidoscopecropaddons.kaleidoscope_cookery”,
  “discover”: false,
  “crops”: [
  {
  “id”: “tomato”,
  “seed”: “kaleidoscope_cookery:tomato_seed”,
  “plant”: “kaleidoscope_cookery:tomato_crop”
  }
  ]
  }
  JSON Field Reference
  Field
  Meaning
  mod
  Kaleidoscope mod id; the whole file is skipped if not loaded
  prefix
  Short prefix. Farm box network crop id is at most 32 chars; directory id is prefix_id
  discover
  Scan this namespace for “seed item → CropBlock”
  seed
  The seed item the farmer consumes from the chest
  plant
  The placed block; if omitted, uses the seed’s BlockItem target block
  harvest_blocks
  Additional blocks treated as part of this crop
  layout
  full for full coverage, stem for spaced (melons/gourds)
  produce
  The fruiting block for vine crops
  waterlog
  Write waterlogged=true when planting
  allow_non_crop_block
  Allow non-CropBlock (must still be plantable on farmland)
  Java registration entry: com.xiaolianganmuchen.kaleidoscopecropaddons.api.DelightCropApi.
  Building
  Environment:
• JDK 21
• Place the New:Sim-U-Kraft and LDLib2 / Taffy / Yoga jars into libs/ (these files are not distributed with the repo)
  gradlew.bat build
  The artifact is located at build/libs/KaleidoscopeCropAddons-<version>-neoforge-1.21.1.jar.
  Source Structure
  src/main/java/…/kaleidoscopecropaddons/
  ├── api/ Registration API for other mods
  ├── client/ Scrollable grouped crop selection UI, mod settings UI
  ├── compat/ Soft compatibility with other mods
  ├── config/ Per-source / per-crop toggles, custom crop storage
  ├── crop/ Crop catalog, parsing, discovery, harvest logic
  ├── mixin/ Hooks into NSUK farm enum, save data, job loop
  └── nsuk/ Farm box extra-field access
  NSUK’s FarmCrop is an enum with no official extension point. This mod sets a CropContext when the farmer processes a farm box, then redirects FarmCrop’s seed / block / maturity checks to the catalog definitions. Vanilla crops are unaffected.
  License
  This mod is released under the GNU GPL 3.0, consistent with New:Sim-U-Kraft.

森罗物语：作物附属

Kaleidoscope: Crop Addons

让 New:Sim-U-Kraft 农田盒里的雇佣农民，种植森罗物语系列能种在耕地上的作物。

简介 ·
功能 ·
依赖 ·
安装 ·
使用 ·
扩展 ·
构建

简介
雇佣农民打开农田盒之后，除了原版小麦、胡萝卜、马铃薯、甜菜，还可以选择已经加载的森罗作物。作业流程与原版小麦相同：挖水槽、耕地、播种、骨粉催熟、收割、补种。
只装本附属和 NSUK 时，农田盒仍只有原版作物，游戏可以正常启动。对应森罗模组装上后，作物会按来源分组出现在选择界面。
姊妹模组：NSUK：乐事作物附属（农夫乐事系列）。两份附属可以一起装。
项目
内容
模组 ID
kaleidoscopecropaddons
游戏版本
Minecraft 1.21.1
加载器
NeoForge 21.1.x（开发时使用 21.1.248）
必装
New:Sim-U-Kraft（simukraft）
语言
简体中文 / English
协议
GNU GPL 3.0
作者
XiaoLiang小亮 & 安沐尘
产物
KaleidoscopeCropAddons-1.0.0-neoforge-1.21.1.jar
功能

• 农田盒作物列表按森罗模组分组，支持中英文搜索
• 农民从农田盒旁边的箱子取种子，按小麦流程作业
• 模组菜单里可以开关每个森罗来源，也可以手动新增自定义作物
• 数据包 JSON 即可接入其它森罗模组，不必改 Java
• 开启自动发现后，会扫描已加载模组里「种子 → 耕地 CropBlock」的组合
• 果园草莓带一份战利品表覆盖，农田盒收割能正常掉草莓
• 对 FTB Ultimine 做了软兼容：不会抢本模组目录里的作物收割
  依赖
  必装
• Minecraft 1.21.1
• NeoForge 21.1.x
• New:Sim-U-Kraft（simukraft）
  选装
  装了才会出现对应作物。未加载的模组整份 JSON 会被跳过，不影响启动。
  模组
  Mod ID
  耕地作物
  森罗物语：厨房
  kaleidoscope_cookery
  番茄、辣椒、生菜
  森罗厨房：国味
  kaleidoscope_chinesefood
  茄子
  森罗：炙烤
  kaleidoscope_grilling
  油菜、洋葱、红薯、折耳根
  森罗物语：次元酒窖
  kaleidoscope_dim_wine
  啤酒花
  森罗物语：暮色
  kaleidoscope_twilight
  蕨菜
  森罗物语：果园
  kaleidoscope_orchard
  草莓
  作物定义在 src/main/resources/data/kaleidoscopecropaddons/kaleidoscope_crops/ 下，一份 JSON 对应一个森罗模组。
  安装

1. 安装 Minecraft 1.21.1 与 NeoForge 21.1.x。
2. 把 New:Sim-U-Kraft 和本模组 jar 放进 mods 文件夹。
3. 按需放入上表中的森罗模组。
4. 产物文件名：KaleidoscopeCropAddons-<版本>-neoforge-1.21.1.jar。
   使用
5. 放置 NSUK 农田盒，雇佣农民。
6. 在农田盒旁边紧贴一个箱子，放入对应种子。
7. 打开农田盒 → 选择作物。森罗作物按模组分组，可用搜索框按中文或英文过滤。
8. 框选农田区域后开始作业。
   游戏内模组菜单（Mods → 森罗物语：作物附属 → Config）可以：

• 开关某个森罗来源
• 关闭自动发现
• 新增自定义作物（填写种子物品 ID，会出现在农田盒的「其他」分组）
  收录范围
  农民会处理能种在原版耕地上、成熟后在原位收获的作物。只要种子能种在耕地上，农民就会像原版小麦一样翻地、播种、骨粉、收割并补种。
  暂不收录
  这些植物无法按农田盒的耕地流程作业：
• 水稻（水田）
• 葡萄（藤架）
• 末影薄荷（末地石）
• 灵魂辣椒 / 迷毒果（灵魂沙土）
• 回响作物（幽匿催发体）
  若这些模组以后加入真正的 CropBlock 耕地种子，开启自动发现后会自己出现。
  为其它森罗模组添加作物
  推荐只加一份数据包 JSON，不必改 Java。
  放到资源包或数据包的：
  data/kaleidoscopecropaddons/kaleidoscope_crops/<模组id>.json
  示例：
  {
  “mod”: “kaleidoscope_cookery”,
  “prefix”: “kc”,
  “label”: “source.kaleidoscopecropaddons.kaleidoscope_cookery”,
  “discover”: false,
  “crops”: [
  {
  “id”: “tomato”,
  “seed”: “kaleidoscope_cookery:tomato_seed”,
  “plant”: “kaleidoscope_cookery:tomato_crop”
  }
  ]
  }
  JSON 字段说明
  字段
  含义
  mod
  森罗模组 id，未加载则整份文件跳过
  prefix
  短前缀。农田盒网络包作物 id 最长 32 字符，目录 id 为 prefix_id
  discover
  扫描该命名空间下「种子物品 → CropBlock」
  seed
  农民从箱子消耗的种子
  plant
  种下的方块；省略时用种子 BlockItem 对应方块
  harvest_blocks
  额外视为本作物的方块
  layout
  full 满铺，stem 隔格（瓜类）
  produce
  藤蔓作物的结果方块
  waterlog
  种植时写入 waterlogged=true
  allow_non_crop_block
  允许非 CropBlock（仍需能种在耕地）
  Java 注册入口：com.xiaolianganmuchen.kaleidoscopecropaddons.api.DelightCropApi。
  构建
  环境：
• JDK 21
• 把 New:Sim-U-Kraft 以及 LDLib2 / Taffy / Yoga 的 jar 放到 libs/（这些文件不随仓库分发）
  gradlew.bat build
  产物位于 build/libs/KaleidoscopeCropAddons-<版本>-neoforge-1.21.1.jar。
  源码结构
  src/main/java/…/kaleidoscopecropaddons/
  ├── api/ 给其它模组的注册 API
  ├── client/ 分组可滚动作物选择界面、模组设置界面
  ├── compat/ 与其它模组的软兼容
  ├── config/ 按来源 / 作物开关、自定义作物存档
  ├── crop/ 作物目录、解析、发现、收获逻辑
  ├── mixin/ 接到 NSUK 农田枚举、存档、作业循环
  └── nsuk/ 农田盒附加字段访问
  NSUK 的 FarmCrop 是枚举，没有官方扩展点。本模组在农民处理某个农田盒时设置 CropContext，再把 FarmCrop 的种子 / 方块 / 成熟判定转到目录里的定义。原版作物不受影响。
  许可
  本模组以 GNU GPL 3.0 发布，与 New:Sim-U-Kraft 保持一致。