搬运一批Bedrock wiki内容，完善翻译

2025-03-20 00:13:44 +08:00
parent ead7392a76
commit 4896c1a4f2
163 changed files with 33930 additions and 1464 deletions
--- a/docs/wiki/visuals/animated-entity-texture.md
+++ b/docs/wiki/visuals/animated-entity-texture.md
@@ -0,0 +1,123 @@
+---
+title: Entity Texture Animations
+mentions:
+    - MedicalJewel105
+    - IlkinQafarov
+    - TheItsNameless
+    - SmokeyStack
+tags:
+    - intermediate
+category:
+    - Tutorials
+---
+
+## Whats on this page?
+
+From this page you will learn how to make an animated texture for an entity. Animated, like a flipbook texture for blocks.
+
+## Source
+
+This page is based on content by [AgentMindStorm](https://www.youtube.com/channel/UC-ljddYkFdTQl-MVEaVvbuQ).
+
+<YouTubeEmbed
+    id="F6e-w1rCEi4"
+/>
+
+## Textures
+
+First let's draw some new texture frames for our entity. In this tutorial it will be a cow, which is looking around.
+
+<WikiImage
+	src="/assets/images/visuals/animated-entity-texture/cow.png"
+	alt="cow"
+	pixelated="false"
+	width=180
+/>
+
+We need to place our textures vertically, like for blocks in flipbook textures.
+In this case we have 4 frames.
+
+## Materials
+
+We will need to modify materials in this guide. However due to render dragon materials became outdated, so **use it at your own risk**.
+
+To use animated texture, we need to change the entity material to one, that has `USE_UV_ANIM` property.
+Let's simply add a new material:
+
+<CodeHeader>RP/materials/entity.material</CodeHeader>
+
+```json
+{
+    "materials":{
+        "version":"1.0.0",
+        "custom_animated:entity":{
+            "+defines":[
+                "USE_UV_ANIM"
+            ]
+        }
+    }
+}
+```
+
+Or you can add this to existing ones, check default material file.
+
+<CodeHeader></CodeHeader>
+
+```json
+"+defines":[
+    "USE_UV_ANIM"
+]
+```
+
+<BButton
+    link="/assets/packs/visuals/animated-entity-texture/entity.material" download
+    color=default
+>Download default entity.material file</BButton>
+
+:::warning
+It is not that easy for every entity!
+Some entities have multiple materials and if you want to make its texture animated, you will need to add this property to all materials of this entity.
+:::
+
+## Client Entity File
+
+Before we go next, we need to define a new material in our client entity file.
+
+<CodeHeader>RP/entity/cow.json#description</CodeHeader>
+
+```json
+"materials": {
+	"default": "custom_animated"
+}
+```
+
+## Render Controllers
+
+After that all, we need to edit a render controller.
+
+Here we will add `uv_anim` component with offset and scale properties:
+
+<CodeHeader>RP/render_controllers/cow.render_controllers.json#controller.render.cow</CodeHeader>
+
+```json
+"uv_anim": {
+    "offset": [ 0.0, "math.mod(math.floor(q.life_time * frames_per_second),frame_count) / frame_count" ],
+    "scale": [ 1.0, "1 / frame_count" ]
+}
+```
+
+Where `frames_per_second` is a count of frames you want to change in one second and `frame_count` is a total frame count.
+This formula calculates the offset and the size of the texture depending on life time.
+
+## Testing
+
+Now, it is time to test your creation!
+
+![](/assets/images/visuals/animated-entity-texture/result.gif)
+
+## Download Example
+
+<BButton
+    link="https://github.com/Bedrock-OSS/wiki-addon/releases/download/download/animated_entity_texture.mcpack"
+    color=blue
+>Download</BButton>