Home / guguzea / mc-ai-coding-assistant-tool · GitHub

04-entity Cursor ruleA

04-entity from guguzea/mc-ai-coding-assistant-tool is a Cursor rule: instructions the Cursor agent follows in that repo.

Install it, pinned

mdr add guguzea/mc-ai-coding-assistant-tool/bedrock/.cursor/rules/04-entity.mdc@git:20260904.bac959a

Pins git:20260904.bac959a in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: Cursor rule
Repository: guguzea/mc-ai-coding-assistant-tool
Path: bedrock/.cursor/rules/04-entity.mdc
Versions recorded: 3
Latest version: git:20260904.bac959a, committed Sep 4, 2026
First version recorded: Aug 13, 2026
Size: 1,876 bytes
Repository stars: 135
License: a license file GitHub does not identify

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 04 — 实体成对

client_entity（RP）与 `minecraft:entity`（BP）identifier 必须一致。不要用 Java EntityType / DeferredRegister。

## Decision Flow

```
→ 新建实体 → 先读 stable/entity-behavior-intro
→ 填组件 → 只使用 stable/entity-components 列出的组件名；表外禁止臆造
→ RP 外观/动画 → stable/resource-pack；Molang 查询见 06
→ identifier 必须 namespace:name，RP/BP 相同
```

## 已核实约束

- identifier 形如 `namespace:name`，RP `client_entity` 与 BP `minecraft:entity` **同一字符串**。依据 `stable/entity-behavior-intro`：Add-On 自定义实体须用**自定义唯一 namespace**（该页 identifier 说明），`minecraft:` 只用于引用内置行为、自定义行为必须换另一个 namespace；示例值 `sample:example`。**允许字符集 / 是否强制小写 / 长度上限未核实**（本地基岩语料无此表述），禁止臆造字符表。
- 实体 JSON 顶层**自带** `format_version`，与 manifest 的 `format_version`（01）**不是一回事**。Learn `stable/entity-behavior-intro` 同页两个示例给出 `"1.19.20"` 与 `"1.19.0"`，且该页没有任何一句规定该填什么；「`format_version` should be the latest」在 Learn 属 **custom-block（方块页）**，对实体只是类推。**本档具体取值 = 未核实**；社区 wiki 主张的 `1.26.10` 在本地语料与现存抓包中 0 命中，禁止写成事实。
- 组件表：`search_bedrock_docs` id `stable/entity-components`。表里没有的名字禁止输出。
- 生成骨架文本可用 `generate_bp_entity`（只吐 JSON，不写盘）。写盘前仍须对照该组件表。
- 脚本里操控实体用 `@minecraft/server` 的 `Entity`（见 07），不是 Fabric `EntityType`。

## 文档
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add guguzea/mc-ai-coding-assistant-tool/bedrock/.cursor/rules/04-entity.mdc@sha256:1e0b894dd53703f6

The line at the top of this page pins the label git:20260904.bac959a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_mbenfnen4pbynhln.svg)](https://markdownregistry.com/a/art_mbenfnen4pbynhln)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Aug 13, 2026 and Sep 4, 2026, about one every 11 days. Its first recorded version is graded B and its latest A.

version	committed	commit	size	audit
git:20260904.bac959a latest	2026-09-04	bac959a	1,876 B	A	view · diff
git:20260814.76af98c	2026-08-14	76af98c	998 B	A	view · diff
git:20260813.c8addfe	2026-08-13	c8addfe	149 B	B	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (1876 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

guguzea/mc-ai-coding-assistant-tool · 135 stars · license a license file GitHub does not identify · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mbenfnen4pbynhln
GET https://markdownregistry.com/api/v1/resolve?ref=guguzea/mc-ai-coding-assistant-tool/bedrock/.cursor/rules/04-entity.mdc
GET https://markdownregistry.com/api/v1/blob/1e0b894dd53703f6c0a16a5b5dcffbeb921f6a1521c9018e73900ea4baba2833

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: Cursor rules vs AGENTS.md · which agent file does what.

More from guguzea/mc-ai-coding-assistant-tool

AGENTS.md AGENTS.md file

guguzea/mc-ai-coding-assistant-tool · AGENTS.md

git:20261105.a32e7f9 · audit A · 135 stars

mc-addon-manifest SKILL.md skill

guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-addon-manifest/SKILL.md · 基岩 manifest.json。触发词：format_version、min_engine_version、modules、capabilities、uuid

git:20260814.76af98c · audit A · 135 stars

mc-addon-setup SKILL.md skill

guguzea/mc-ai-coding-assistant-tool · bedrock/.agents/skills/mc-addon-setup/SKILL.md · 基岩 Add-On 工程结构。触发词：com.mojang、development_behavior_packs、RP/BP、Add-On 从零