企业官网建设流程全解析

• 低代码
• 代码生成
• 桌面应用
• 游戏开发

僵尸村民（Zombie Villager）在被转化后，仍会保留其原有的村民职业身份与外观特征——包括代表该职业的纹理。在 MCreator 的村民职业（Villager Profession）元素中，僵尸化的职业纹理（Zombified Profession Texture）就是为这一形态专门指定的贴图资源。本文将结合 MCreator 仓库中村民职业元素的源码实现与生成器模板，完整讲解该字段的含义、界面操作、资源路径规则、底层生成逻辑以及常见的排查要点，帮助 Mod 开发者正确配置并理解其背后原理。

字段含义：什么是"僵尸化的职业纹理"

在原文档（plugins/mcreator-localization/help/de_DE/villagerprofession/zombified_profession_texture.md）中，该字段仅有一句核心定义（默认英文版见 default 语言目录下的同名文档）：

拥有该职业的僵尸村民所展现的纹理。

这句话包含两层关键信息：

1. 作用对象是"僵尸村民"：游戏中普通村民（Villager）与僵尸村民（Zombie Villager）拥有两套独立的外观体系。当村民被僵尸感染后，其模型与贴图都会切换到僵尸化形态，但职业属性（如铁匠、图书管理员等）仍然保留。
2. 纹理与"职业"绑定：同一僵尸村民形态下，不同职业通过各自独立的职业纹理进行视觉区分。因此一个自定义职业需要同时提供普通职业纹理（profession_texture，见 profession_texture.md）和僵尸化职业纹理（zombified_profession_texture）两张贴图。

在 MCreator 的 30 个语言目录中，该字段均有对应的本地化文案（例如中文为"僵尸村民的职业纹理"，见 texts_zh_CN.properties 中的elementgui.villager_profession.zombified_profession_texture键），这也从侧面说明它是村民职业元素中的一个独立、标配的配置项。

界面中的位置与操作方式

该字段在 MCreator 的"村民职业"元素编辑界面中，位于属性（Properties）页面的职业纹理下拉框正下方。从界面实现源码 VillagerProfessionGUI.java 可以看到，属性面板按照 6 行 2 列的网格布局依次排列：

其中，两个纹理字段都由TextureComboBox实现，并统一限定为实体纹理类型（TextureType.ENTITY）（见 TextureType.java 中的ENTITY枚举值）。该下拉框只列出工作区中已经导入、且归类为"实体（Entity）"类型的 PNG 图片，你无法在该字段中直接选择方块贴图或粒子贴图。

操作步骤归纳如下：

1. 在 MCreator 工作区中创建或打开一个"村民职业（Villager Profession）"元素；
2. 进入"属性（Properties）"页面；
3. 先通过工作区资源导入功能，将一张面向僵尸村民模型的 PNG 纹理导入为"实体"类型贴图；
4. 在"僵尸化的职业纹理"下拉框中选择这张贴图；
5. 保存并生成 Mod 代码。

注意，该字段是一个必填项：源码中通过.requireValue("elementgui.villager_profession.profession_needs_zombified_texture")（见 VillagerProfessionGUI.java）将其加入必填校验，并纳入page1group验证组（第 111 行）。也就是说，如果该字段为空，MCreator 会阻止元素保存/生成，并提示需要提供僵尸化职业纹理。

数据模型与纹理引用机制

在元素数据模型 VillagerProfession.java 中，该字段被建模为：

@TextureReference(TextureType.ENTITY) public String zombifiedProfessionTextureFile;

它与普通职业纹理professionTextureFile是两个完全独立的字符串字段，各自保存一张实体纹理文件的名称。@TextureReference(TextureType.ENTITY)注解的作用是让 MCreator 在保存、清理、重命名工作区资源时，能够识别并追踪该字段引用的纹理文件——例如当你重命名或删除某张实体贴图时，MCreator 会根据注解更新或校验引用关系，避免生成后出现路径失效。

同时，在界面与数据模型之间还存在一条完整的双向映射链：

• 打开元素：openInEditingMode()中调用zombifiedProfessionTextureFile.setTextureFromTextureName(profession.zombifiedProfessionTextureFile)（VillagerProfessionGUI.java），把已保存的纹理名回填到下拉框；
• 保存元素：getElementFromGUI()中调用profession.zombifiedProfessionTextureFile = zombifiedProfessionTextureFile.getTextureName()（VillagerProfessionGUI.java），把用户在界面上选择的纹理名写回数据模型。

生成阶段：贴图被复制到哪个路径

真正揭示该字段底层语义的是**元素生成收尾阶段（finalizeModElementGeneration）**的实现（见 VillagerProfession.java）。MCreator 在生成自定义村民职业时，会把工作区中的源贴图复制到生成项目对应 Minecraft 资源的约定目录下：

• 普通职业纹理：复制到textures/entity/villager/profession/<注册名>.png；
• 僵尸化职业纹理：复制到textures/entity/zombie_villager/profession/<注册名>.png。

从源码结构看，这两条路径对应了原版 Minecraft 的资源布局：原版村民职业贴图位于textures/entity/villager/profession/，僵尸村民职业贴图则位于textures/entity/zombie_villager/profession/。正是因为最终要写入这个与模型绑定的固定目录，MCreator 才要求该字段必须是"实体"类型的纹理资源，并以其注册名（Registry Name）命名输出文件。

值得注意的是，两张贴图的输出文件名都统一使用职业元素的注册名，而非用户在工作区中的任意文件名。这意味着：

• 即使你给工作区贴图取名为my_zombie_tex，生成后仍会以职业注册名（例如my_profession）重命名输出；
• 如果你的自定义职业想被其他 Mod 或资源包覆盖纹理，直接覆盖entity/zombie_villager/profession/目录下同名文件即可。

与"帽子"参数（Hat）的联动关系

在配置僵尸化职业纹理时，还需要理解它与"帽子（Hat）"参数的联动。MCreator 会为职业纹理生成对应的.mcmeta元数据文件，控制职业帽子（Profession Hat）在原版村民类型帽（Type Hat）之上的可见性，其模板见 profession_hat.mcmeta.ftl：

{ "villager": { "hat": "${data.hat?lower_case}" } }

hat字段可选值为None、Partial、Full（由@LimitedOptions注解限定，见 VillagerProfession.java），其语义与可见性关系在 hat.md 中有完整表格。虽然帽子元数据文件只针对村民职业纹理生成，但由于同一职业的普通与僵尸化纹理在模型结构上是一致的（都使用村民/僵尸村民的标准头身模型），你在绘制僵尸化职业纹理时，应保持与普通职业纹理一致的帽子区域绘制，否则会出现"普通村民有帽子、僵尸村民帽子和头部贴图错位"的视觉不一致问题。

代码生成链路：职业如何注册并被赋予纹理

为了更完整地理解该字段在整个生成流程中的位置，可以顺带梳理村民职业的注册链路。生成器会为工作区中所有村民职业生成注册类，对应模板为 villagerprofessions.java.ftl，由定义文件 villagerprofession.definition.yaml 中的global_templates配置触发。该模板会：

1. 使用DeferredRegister<net.minecraft.world.entity.npc.VillagerProfession>注册每个自定义职业（第 45-54 行）；
2. 为职业绑定工作方块对应的PoiType（兴趣点类型，第 56-82 行）；
3. 将职业与音效事件关联。

而纹理本身并不经过 Java 代码注册——它是通过资源目录约定被 Minecraft 自动加载的：只要贴图位于entity/zombie_villager/profession/<注册名>.png，且职业注册名与文件名一致，游戏便会自动为僵尸村民形态应用该纹理。这正是"僵尸化的职业纹理"字段的全部技术实质：选择一张实体纹理，并让 MCreator 在生成时把它放到僵尸村民职业贴图的标准资源目录中。

常见问题与排查建议

结合界面校验与生成逻辑，配置该字段时容易遇到以下情况：

小结：zombified_profession_texture（僵尸化的职业纹理）是 MCreator 村民职业元素中的一个必填实体纹理字段，它指定"拥有该职业的僵尸村民"所呈现的外观贴图。其核心工作机制是：界面中选择实体贴图 → 数据模型以zombifiedProfessionTextureFile保存引用 → 生成阶段复制到entity/zombie_villager/profession/<注册名>.png→ 由 Minecraft 依据资源目录约定自动加载。理解这条链路后，你就能准确配置自定义职业的僵尸村民形态，并排查相关贴图加载问题。

• 低代码
• 代码生成
• 桌面应用
• 游戏开发