minecraft-namespaced-id

Minecraft 命名空间ID（Namespaced ID）定义如下： **定义（Definition）** 命名空间ID采用 `namespace:path` 格式，其中： - `namespace`（命名空间）：用于确保唯一性的范围，默认为 `minecraft`； - `path`（路径）：通常镜像资源包或数据包内的文件路径； - 整体以字符串形式表示，使用冒号 `:` 连接。 **合法字符（Legal Characters）** - **Java版**： - 命名空间和路径允许的字符：`0-9`、`a-z`、`_`、`-`、`.`； - 推荐使用 snake_case 命名风格； - `/` 在命名空间中非法，但在路径中允许作为目录分隔符； - 命名空间不能为 `..`。 - **基岩版（Bedrock）**： - 除 `/` 和 `:` 外，允许使用任意字符。 **字符串转换（String Conversion）** - ID → 字符串：格式为 `ns:path`； - 字符串 → ID 的约束条件： - 字符串中最多只能包含一个冒号 `:`； - 冒号前后两部分必须满足各自的合法字符规则； - 当存在冒号时，前半部分（命名空间）不能包含 `/` 或 `.`； - 当无冒号时，默认命名空间为 `minecraft`。 **使用场景（Usage）** - **Java版注册表内容（Registry Content）**：所有注册表对象（如方块、物品、实体等）均使用命名空间ID； - **Java版非注册表内容（Non-Registry Content）**： - 数据包：函数、结构模板、标签； - 资源包：装备模型、字体、烘焙模型、方块状态映射、物品模型定义、音效、着色器、后处理管线、纹理、路点样式； - 其他可修改内容：Boss栏、命令存储、属性修饰符、随机序列、自定义点击事件标识符等。 **实际文件路径（Actual File Paths）** 文件路径与命名空间ID的对应关系为： `<pack type>/<namespace>/<object type>/<name>.<extension>` ↔ ID `<namespace>:<name>` 例如：`data/mypack/functions/start.mcfunction` 对应 ID `mypack:start`。 **命名空间（Namespaces）** - `minecraft`：游戏自身使用的默认命名空间，未指定时自动使用； - 自定义命名空间（Custom namespaces）：每个项目或内容应使用独立的命名空间，以避免名称冲突； - 其他内置命名空间：如 `realms`、`brigadier` 等。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本