Extra Entity Features
关于
一款适用于 Minecraft 26.3 的客户端 Fabric 附加模组,扩展了 Entity Model Features (EMF) 和 Entity Texture Features (ETF) 的功能。它仅使用混入(mixins),且需要同时安装这两个模组。
功能
渲染面选择
选择立方体表面的渲染方式。你可以设置为外表面(outer)、内表面(inner)或两个表面都渲染(both)。
阴影控制
允许你开启或关闭方向性阴影(false/true),就像原版 Java 版方块/物品模型中的效果一样。
发光等级
为每个立方体设置 0 到 15 之间的最低光照等级,让你的自定义实体部件拥有独立的发光/亮度效果。
按面 UV 旋转
在 Blockbench 中为每个立方体面使用内置的 UV 旋转滑块。
广告牌效果
使 JEM 部件像钓鱼浮标一样面向相机。你可以设置为完全面向相机(all/true),或者仅绕垂直轴旋转以保持直立(y)。
设置界面
通过 EMF 或 ETF 的设置菜单访问,点击左上角的“Extra Entity Features”按钮即可进入(目前作为占位符界面)。
Blockbench 插件
包含一个 Blockbench 插件(extra_entity_features.js),可自动将倒置立方体(负尺寸)转换为具有内表面渲染的正尺寸立方体。
- 如果你希望我添加 EMF 和 ETF 所不具备的功能,请前往我的 Discord 服务器提出建议!
面向创作者的功能详解
面向创作者的 Blockbench 插件
extra_entity_features.jar/blockbench-plugin/extra_entity_features.js:在 Blockbench 中使用文件 > 插件 > 从文件加载插件。你可以在详情选项卡中看到模组功能的详细信息,如下所示:
render_faces
JEM 文件中每个立方体:
outer:立方体的外表面
inner:立方体的内表面
both:内外表面
当未写入 render_faces 时,不会记录任何日志,该立方体由正常的 EMF 进行渲染。Blockbench 插件会将倒置立方体(负尺寸,类似于 Java 版方块/物品模型中的轮廓立方体)写为正尺寸立方体,并附带 "render_faces": "inner"。
"boxes": [
{"coordinates": [-4, 18, -4, 8, 8, 8], "textureOffset": [0, 0]},
{"coordinates": [-4, 26, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "inner"},
{"coordinates": [-4, 34, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "both"}
]
shade
立方体上的 "shade": false 会移除方向性阴影,类似于 Java 版方块/物品模型中的 shade 属性。默认值为 true。它与 render_faces 和 light_emission 配合使用。
{"coordinates": [-4, 18, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "inner", "shade": false}
light_emission
每个立方体的最低光照等级,范围从 0 到 15,类似于方块模型中的 light_emission。
设置界面
打开 EMF 或 ETF 设置,然后点击左上角的 Extra Entity Features 按钮。该界面目前尚无可配置选项。
按面 UV 旋转
在 Blockbench 中为每个立方体面使用内置的 UV 旋转滑块。该插件为 OptiFine 实体格式启用了此功能。Blockbench 仅对具有按面 UV(而非整体 UV)的立方体显示此选项,且只有这些立方体才能拥有旋转的面。Blockbench 插件将非零的面旋转值保存为 JEM 立方体中的 uv_rotation,模组在渲染时应用相同的四分之一圈旋转。旋转值为 0、90、180 或 270 度。
{
"coordinates": [-4, 18, -4, 8, 8, 8],
"textureOffset": [0, 0],
"uv_rotation": {"north": 90, "up": 180}
}
方向键为 north、east、south、west、up 和 down。未在对象中指定的面保持其默认旋转角度。
billboard
JEM 部件上的 "billboard" 使其面向相机,如同钓鱼浮标:
"all"(或 true):完全面向相机
"y":仅绕垂直轴旋转并保持直立
{"part": "head", "id": "sprite", "billboard": "all", "boxes": [...]}
部件及其父级的旋转会被替换,子级部件保持相对于广告牌自身的旋转。部件的前面(north 面)面向相机。
盔甲架 is_hurt
is_hurt 和 hurt_time 同样适用于盔甲架,与其他实体一样持续 10 个刻。仅受击中的盔甲架会受到影响。
多纹理 (#1, #2)
OptiFine 模型仅支持单一纹理。当 JEM 包含多个纹理时,请在根 textures 对象中列出它们,并从部件中引用,例如 "texture": "#1",类似于 Java 版方块/物品模型:
{
"textureSize": [64, 64],
"textures": {"1": "body.png", "2": "armor.png"},
"models": [
{"part": "head", "id": "head", "boxes": [...], "texture": "#2"}
]
}
没有指定 texture 的部件会使用根 texture。仅含一个纹理的模型以普通 OptiFine 模型的格式编写。Blockbench 插件读写此格式。
第一人称手臂
第一人称手臂使用 JEM 分配给玩家模型的纹理(根纹理或部分纹理),与第三人称相同。如果 JEM 未分配任何纹理,则使用账户皮肤。
mcmeta 动画纹理
将 <texture>.png.mcmeta 放置在生物纹理(或其 _e.png 发光纹理)旁边。格式与原版动画相同:frametime、frames、interpolate、width、height。
- 纹理必须是所有帧的垂直条带。
- 当帧不是正方形时,添加一帧的
width 和 height,例如 "width": 64, "height": 32。
- 日志会为每个创建的动画打印
Animated texture ...,并在尺寸无法整除时发出警告。
注意事项
- 如果 EMF 在某个部分中丢弃了一个无效的方块,则该部分的
render_faces、light_emission 和 shade 将被跳过,并记录警告。
- ETF 的发光修补功能对动画纹理无效。
- 如果你没有为
_e.png 纹理提供自定义的 mcmeta,它们也将使用相同的 mcmeta 文件。
Extra Entity Features
About
A client-side Fabric addon for Minecraft 26.3 that extends Entity Model Features (EMF) and Entity Texture Features (ETF). It uses mixins only and requires both mods.
Features
Render Faces
Choose how cube surfaces are rendered. You can set it to the outside surface (outer), the inside surface (inner), or both surfaces (both).
Shading Controls
Allows you to turn directional shading on or off (false/true), just like in vanilla Java block/item models.
Light Emission
Sets a minimum light level from 0 to 15 per box, giving your custom entity parts their own glow/brightness.
Per-face UV rotation
Use Blockbench's built-in UV rotation slider on each cube face.
Billboard Effect
Makes JEM parts face the camera like a fishing bobber. You can set it to face the camera completely (all/true) or rotate only around the vertical axis to stay upright (y).
Settings Screen
Accessible via the EMF or ETF settings menu by clicking the Extra Entity Features button in the top left corner (currently serving as a placeholder screen).
Blockbench Plugin
Includes a Blockbench plugin (extra_entity_features.js) that automatically converts inverted cubes (negative size) into positive size boxes with inner render faces.
- If you want me to add anything that EMF and ETF don't have, come to my discord server for suggest!
Explained Features for Creators
Blockbench plugin for creators
extra_entity_features.jar/blockbench-plugin/extra_entity_features.js: in Blockbench use File > Plugins > Load Plugin from File. It contains mod features in details tab as you can see here:
render_faces
Per box in a JEM file:
outer: the outside surface of the cube
inner: the inside surface of the cube
both: outside and inside surfaces
When render_faces is not written, nothing is logged and the box is rendered by normal EMF. The Blockbench plugin writes inverted cubes (negative size, like outline cubes in Java block/item models) as a positive size box with "render_faces": "inner".
"boxes": [
{"coordinates": [-4, 18, -4, 8, 8, 8], "textureOffset": [0, 0]},
{"coordinates": [-4, 26, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "inner"},
{"coordinates": [-4, 34, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "both"}
]
shade
"shade": false on a box removes directional shading, like shade in Java block/item models. Default is true. It works next to render_faces and light_emission.
{"coordinates": [-4, 18, -4, 8, 8, 8], "textureOffset": [0, 0], "render_faces": "inner", "shade": false}
light_emission
Minimum light level from 0 to 15 per box, like light_emission in block models.
Settings screen
Open the EMF or ETF settings and press the Extra Entity Features button in the top left corner. The screen has no options yet.
Per-face UV rotation
Use Blockbench's built-in UV rotation slider on each cube face. The plugin enables it for the OptiFine entity format. Blockbench only shows it for cubes with per-face UV (not box UV), and only those cubes can have rotated faces. The Blockbench plugin saves non-zero face rotations in the JEM box as uv_rotation, and the mod applies the same quarter-turn rotation while rendering. Rotation values are 0, 90, 180, or 270 degrees.
{
"coordinates": [-4, 18, -4, 8, 8, 8],
"textureOffset": [0, 0],
"uv_rotation": {"north": 90, "up": 180}
}
The direction keys are north, east, south, west, up, and down. Faces omitted from the object keep their default rotation
billboard
"billboard" on a JEM part makes it face the camera, like a fishing bobber:
"all" (or true): faces the camera completely
"y": only turns around the vertical axis and stays upright
{"part": "head", "id": "sprite", "billboard": "all", "boxes": [...]}
The rotation of the part and of its parents is replaced, child parts keep their own rotation relative to the billboard. The front (north) side of the part faces the camera.
Armor stand is_hurt
is_hurt and hurt_time also work for armor stands, with the same 10 tick duration as other entities. Only the armor stand that was hit is affected.
Multiple textures (#1, #2)
OptiFine models only have one texture. When a JEM has several, list them in a root textures object and reference them from a part with "texture": "#1", like Java block/item models:
{
"textureSize": [64, 64],
"textures": {"1": "body.png", "2": "armor.png"},
"models": [
{"part": "head", "id": "head", "boxes": [...], "texture": "#2"}
]
}
A part without texture uses the root texture. Models with one texture are written like normal OptiFine models. The Blockbench plugin writes and reads this format.
First person arm
The first person arm uses the texture that the JEM assigns to the player model (root or part texture), the same as third person. If the JEM assigns none, the account skin is used.
mcmeta animated textures
Place <texture>.png.mcmeta next to a mob texture (or its _e.png emissive texture). The format is the same as vanilla animations: frametime, frames, interpolate, width, height.
- The texture must be a vertical strip of all frames.
- Add
width and height of one frame when frames are not square, for example "width": 64, "height": 32.
- The log prints
Animated texture ... for each animation that was created, and a warning when the size does not divide evenly.
Notes
- If EMF drops an invalid box in a part,
render_faces, light_emission and shade are skipped for that part and a warning is logged.
- ETF's emissive patching is skipped for animated textures.
_e.png textures are also using the same mcmeta if you not give them a custom one.
评论 0
登录后参与评分
还没有评论,来抢沙发吧