Woalk Datafixer
Woalk Datafixer 是一款 Fabric 模组,旨在处理加载 Minecraft 世界时缺失或已更改的方块、物品和生物群系。
它允许使用 CSV 映射表对注册表条目进行无缝重映射,并为注册表中完全缺失的物品提供回退方案。
本模组专为长期运行的模组化多人服务器设计,这些服务器在升级到新的 Minecraft 版本时,
需要将旧模组替换为新模组(通常具有不同的命名空间或物品名称),
并且需要保留世界数据。
功能特性
- DataFixer 映射:在加载世界期间,利用标准 Minecraft DataFixer 系统自动将旧的方块、物品和生物群系 ID 替换为新的 ID。
- 回退物品:任何仍未被映射表覆盖且仍然缺失的物品将被替换为一个特殊的“未知”物品 (
wdf:unknown),而不是直接丢失,这有助于保留背包内容和世界状态。
- CSV 配置:通过简单的 CSV 文件即可轻松配置。
兼容性
- Minecraft 版本:26.2 (Fabric)
- 依赖项:
对于多人服务器,该模组需要在客户端和服务端均安装,
以确保回退物品能够正确注册。
配置
该模组从你的 Minecraft 实例中的 config/datafixer/ 目录读取映射表。你可以创建以下文件:
block_mapping.csv
item_mapping.csv
biome_mapping.csv
CSV 格式
CSV 文件应为简单的两列表格,且不带表头。每一行代表一个映射关系:
old_namespace:old_path,new_namespace:new_path
示例 (block_mapping.csv):
immersive_weathering:rooted_grass_block,minecraft:grass_block
croptopia:cinnamon_log,minecraft:jungle_log
byg:yellow_birch_leaves,minecraft:birch_leaves
注意:方块映射表也用于重映射对应的 BlockItems。
许可证
本项目基于 GNU GPLv3 许可协议开源。
Woalk Datafixer
Woalk Datafixer is a Fabric mod designed to handle missing or changed blocks, items, and biomes when loading Minecraft worlds.
It allows for seamless remapping of registry entries using CSV mapping tables and provides a fallback for items that are completely missing from the registries.
This mod is designed for long-running modded multiplayer servers that,
when updating to a new Minecraft version,
have to swap out old mods with newer ones, often having other namespaces or item names,
and need to preserve world data.
Features
- DataFixer Mapping: Automatically replaces old block, item, and biome IDs with new ones during world loading using the standard Minecraft DataFixer system.
- Fallback Item: Any items that are still missing and not covered by the mapping tables are replaced with a special "Unknown" item (
wdf:unknown) instead of being lost, helping to preserve inventories and world state.
- CSV Configuration: Easy to configure using simple CSV files.
Compatibility
- Minecraft Version: 26.2 (Fabric)
- Dependencies:
For multiplayer servers, the mod needs to be installed on both client and server,
to ensure that the fallback item is properly registered.
Configuration
The mod reads mapping tables from the config/datafixer/ directory in your Minecraft instance. You can create the following files:
block_mapping.csv
item_mapping.csv
biome_mapping.csv
CSV Format
The CSV files should be simple two-column tables without headers. Each row represents a mapping:
old_namespace:old_path,new_namespace:new_path
Example (block_mapping.csv):
immersive_weathering:rooted_grass_block,minecraft:grass_block
croptopia:cinnamon_log,minecraft:jungle_log
byg:yellow_birch_leaves,minecraft:birch_leaves
Note: The block mapping table is also used to remap the corresponding BlockItems.
License
This project is licensed under GNU GPLv3.
评论 0
登录后参与评分
还没有评论,来抢沙发吧