ContentStudio

English

Content Studio gives pack authors and server administrators in-game editors for recipes, loot tables, villager trades, and item tooltips. Searchable item selection, NBT editing, previews, and persistent rules help manage content directly inside a world.

Installation and access

Install Content Studio and its required dependencies on the client and server for multiplayer editing. Press F6, the default KineticCore configuration-center key, and open the relevant Content Studio page. Editor data requests and changes are checked on the server and require permission level 2.

Recipe creation and removal

• Choose ingredients from items or item tags, and set the output stack and count.
• Input NBT can be ignored, matched as a required subset, or matched exactly. Output NBT retention is a separate setting.
• Search by name, ID, @modid, or #tag; inventory and equipment views help select existing stacks.
• Browse saved additions in the preview, reopen a recipe for editing, or mark it for deletion.
• Unresolved items appear as barrier placeholders. Replace invalid slots before saving.

The removal manager targets individual recipe IDs or broader rules based on output item, mod ID, item tag, or recipe type. Selecting an output lists its recipes, making it possible to remove one acquisition path while retaining another.

A recipe affected by a broad rule must first be released from that rule before being managed individually. External viewer entries without a confirmed server recipe ID are preview-only. JEI actions can open all recipes for an item or the selected recipe when JEI is available.

Save timing: recipe additions and edits are written to the bundle first. Closing the complete recipe-editing session requests a server datapack reload to apply pending changes. The removal screen also offers a save/apply action. Wait for the server result before checking crafting behavior.

Entity, block, and container loot

Open the appropriate loot editor and select an entity, block, or container loot table. Changes affect subsequent loot generation for that table.

• Inspect and edit pools and entries, including item stacks and generated item NBT.
• Adjust pool roll ranges and luck-based bonus rolls.
• Edit entry weights, counts, chances, and supported drop conditions; entity-specific controls apply to entity death loot.
• Apply an entry or pool edit to the working table, then use Save on the main editor to persist it.
• Restore a table to its underlying resource definition by clearing the Content Studio override.

Container tools also provide global additions, global removal rules, and a table exclusion list. Removal rules match an item ID, the same item with any NBT, a required NBT subset, or exact NBT. Excluded tables receive neither global additions nor global removals.

The server validates saved table data and updates the affected runtime loot tables. These changes do not replace items already generated inside an opened chest.

Villager and wandering-trader trades

Manage trades by profession and level. Wandering traders have common and rare groups. A group can add trades, replace a level, replace all levels, or disable a level, with a configurable number of weighted offers to select.

Custom offers support two payment stacks and one result, including NBT. Controls include maximum/current uses, villager experience, player experience rewards, price multiplier, demand, special price, restocking, and selection weight. Default offers can be disabled or reweighted without rebuilding the profession.

Saving applies changes live to standard trade pools. Optional late-override mode reapplies rules after villager or wandering-trader trade refresh, helping control trades dynamically appended during that refresh.

The module also provides villager follow items and AI check/pathfinding intervals. The default interval is 100 ticks; setting it to 1 restores the original frequency. Trade-update protection preserves the minimal updates needed for trade level-up timers when AI is reduced.

Tooltip authoring

The tooltip editor saves rules to config/kineticcore/contentstudio_tooltips.json. Rules are keyed by item ID and append text or replace a specified line; line 0 is the item name. Conditions are always, Shift only, Alt only, or Shift+Alt. Text-color controls are included.

Content Studio renders the rules directly on clients. The server sends them when a player joins and after an editor save or /kt reload, so saved changes apply immediately to connected players. These rules do not contain an NBT matching condition. Existing KubeJS tooltip scripts are neither imported nor modified; remove an old tooltipadd.js yourself if KubeJS still runs it and duplicates the new tooltips.

Files and application behavior

Paths are relative to the game/server instance running the editor's server side.

These paths belong to the instance, rather than separate editor files in each world. Include the relevant files when distributing a pack, and retain a copy before replacing a set of rules.

Practical workflow

1. Enter a world with administrator permission and open the editor through F6.
2. Start with one recipe, loot table, or profession and make a small change.
3. Save using that editor's workflow; leave the complete recipe interface to apply pending recipe additions.
4. Verify by crafting, generating fresh loot, or checking refreshed trades.
5. For tooltips, save a rule and inspect that item's tooltip on a connected client.

简体中文

Content Studio 面向整合包作者与服务器管理员，提供配方、战利品表、村民交易和物品提示的游戏内编辑器。通过物品搜索、NBT 编辑、预览与持久化规则，可以直接在世界中制作和调整内容。

安装与入口

多人游戏中，在客户端和服务端安装 Content Studio 及必需前置。按 F6 打开 KineticCore 配置中心，再进入对应页面。F6 是默认按键；编辑器的数据请求与修改由服务端校验，需要 2 级管理权限。

新增与移除配方

• 可选择具体物品或物品标签作为材料，并设置输出物品与数量。
• 输入 NBT 支持不匹配、包含所需 NBT 的弱匹配、完全一致的强匹配；输出是否保留 NBT 单独设置。
• 搜索支持名称、ID、@模组ID 和 #标签，也可从背包或装备中选择已有物品。
• 在新增配方预览中查看、重新编辑配方，或标记删除。
• 无法解析的物品以屏障占位显示；保存前需要修复错误槽位。

移除管理器既能按具体配方 ID 操作，也能按输出物品、模组 ID、物品标签、配方类型批量移除。选中产物后可查看多条配方，从而只关闭其中一种获取方式。

如果配方受批量规则影响，需要先撤销对应规则，再按 ID 单独管理。没有可确认服务端配方 ID 的外部展示配方仅供预览。安装并就绪的 JEI 可用于打开物品全部配方或选中的单条配方。

保存时机：新增和修改首先写入配方数据文件；退出整个配方编辑流程后，才请求服务端数据包重载，统一应用待处理修改。移除页面另有保存应用操作。检查合成结果前，应等待服务端处理完成。

实体、方块与容器战利品

进入对应战利品编辑器，选择实体、方块或容器战利品表。修改影响该表之后生成的掉落内容。

• 查看和编辑掉落池、条目、物品及生成物品携带的 NBT。
• 调整掉落池抽取次数范围与基于幸运值的额外抽取次数。
• 编辑权重、数量、概率和支持的掉落条件；实体专用条件用于实体死亡掉落。
• 在条目或掉落池子页面点击应用后，还需要回到主编辑器保存。
• 清除 Content Studio 覆盖，可恢复底层资源中的原始战利品表定义。

容器编辑器额外提供全局追加、全局移除和战利品表排除名单。移除规则可按物品 ID、同物品携带任意 NBT、包含指定 NBT、完全一致 NBT 匹配。排除名单中的表不会接受全局追加或全局移除。

服务端校验保存内容后会更新相关运行时战利品表，不会替换已经开箱并生成的现有物品。

村民与流浪商人交易

按职业和等级管理村民交易，流浪商人则区分普通与稀有交易组。每组可追加、替换当前等级、替换全部等级或禁用等级，并设置按权重抽取的交易数量。

自定义交易支持两种买入物品和一种卖出物品，各槽位可携带 NBT。可设置最大/当前使用次数、村民经验、玩家经验奖励、价格倍率、需求值、特殊价格、是否补货和抽取权重。对于默认交易，可单独禁用或调整权重，无需重建整个职业。

保存后实时更新标准交易池。可选的“交易后覆盖”模式会在村民或流浪商人刷新交易结束后再应用规则，用于处理其他模组在刷新过程中动态追加的交易。

该模块还提供村民诱导跟随物品和 AI 检测、寻路间隔设置。默认间隔为 100 Tick，设为 1 可恢复原版频率。交易升级保护会在减少 AI 更新时保留交易升级计时所需的最低限度更新。

物品提示编辑

Tooltip 编辑器把规则保存到 config/kineticcore/contentstudio_tooltips.json。规则按物品 ID 保存，可追加文本或替换指定行，其中第 0 行为物品名称。显示条件包括始终显示、仅 Shift、仅 Alt、Shift+Alt，并提供文字颜色编辑。

Content Studio 客户端直接渲染规则。玩家加入时、编辑器保存后以及执行 /kt reload 后，服务端会同步规则，已连接玩家无需重进世界即可看到修改。规则不包含 NBT 匹配条件。旧 KubeJS 提示脚本不会迁移或修改；若仍通过 KubeJS 运行旧 tooltipadd.js，请自行移除，以免提示重复。

文件位置与生效方式

下列路径相对于承担编辑器服务端逻辑的游戏或服务器实例。

这些配置属于游戏实例，不是分别保存在每个世界目录中的编辑器文件。分发整合包时应携带所需文件，替换整套规则前可保留一份副本。

建议操作流程

1. 以具备管理权限的玩家进入世界，通过 F6 打开编辑器。
2. 先针对一个配方、一张战利品表或一个职业进行小范围修改。
3. 按当前编辑器流程保存；新增配方还需退出完整配方界面，应用待处理修改。
4. 通过实际合成、新生成的掉落或刷新后的交易检查结果。
5. 保存 Tooltip 规则后，直接在已连接的客户端检查对应物品的提示。