Bedrock Wiki
  • QQ
  • 原站
新手入门指南
  • Guide
    • 1. 简介
      指南
    • 2. 附加组件详解
    • 3. 软件与准备工作
    • 4. 项目设置
    • 5. 创建自定义物品
    • 6. 创建自定义实体
    • 7. Blockbench:建模、贴图与动画制作
    • 8. 添加战利品表、生成规则与合成配方
  • Extra
    • a. 理解JSON
    • b. 下载示例包
    • c. 故障排除
      帮助
    • d. 高级清单文件指南
    • e. 格式版本
    • f. Android 项目设置
JSON UI
  • General
    • JSON UI 入门指南
      指南
    • 最佳实践
      指南
  • Tutorials
    • Aseprite 动画
    • 保留标题文本
      中级
    • 修改服务器表单
      中级
    • 字符串与数字转换
      中级
    • 按钮与开关
      新手
    • 添加HUD界面元素
      新手
  • Documentation
    • JSON UI 文档
Meta
  • Style Guide
  • 使用JSON模式(Schemas)
  • 实用链接
  • 版本控制
  • 附加包性能优化
  • Q&A
    • GameTest 问答集 2021/08/06
    • 世界生成问答 2024/11/15
    • 延迟渲染技术预览问答 2024/02/23
    • 方块与物品问答 2024/08/30
    • 脚本与编辑器问答 2023/09/22
NBT
  • General
    • .mcstructure
  • Tutorials
    • 扩展结构限制
      简单
    • 教育版中的实验功能
      简单
  • NBT in Depth
    • NBT 库列表
      专家
    • NBT读取示例
      专家
    • 关于NBT(命名二进制标签)
      专家
世界生成
  • General
    • 世界生成入门
      指南
      实验性
    • 特性类型
      实验性
    • 生物群系
      指南
      实验性
  • Tutorials
    • 特征(Feature)的方块条件
      实验性
    • 生成地表区块
      实验性
    • 生成自定义矿石
      实验性
    • 生成自定义结构
      实验性
    • 高度图噪声地形
      实验性
  • Documentation
    • 生物群系标签
动画控制器
  • 动画控制器入门指南
    指南
  • 实体命令
    中级
  • AFK检测器
  • 将Molang变量转换为计分板数值
  • 死亡指令
  • 重生指令
命令
  • General
    • 命令方块入门指南
    • 函数
    • NBT 命令
    • 坐标系
    • 方块状态
    • 理解目标选择器
    • 记分板操作
  • Commands
    • Execute
      简单
    • Playanimation
    • 伤害
    • 播放音效
  • On Event Systems
    • 玩家首次加入时
    • On Player Join
    • 玩家离开时触发
    • 玩家死亡事件
    • 玩家重生事件系统
    • 首次加载世界时
  • Scoreboard Systems
    • 实体计数器
    • 计分板计时器
    • 比较与获取分数
  • Techniques
    • 执行逻辑门
    • MBE - Max的方块实体
    • FMBE - 创建显示实体的新方法
    • 视线检测
    • 移动状态检测
    • 轨道摄像机
  • Useful Creations
    • 多人位置重排系统
      函数
    • 自定义合成台
      简单
实体
  • General
    • Intro to Entities BP
      指南
      新手
    • 实体资源包入门
      指南
      新手
    • 实体问题排查指南
      帮助
    • NPC对话系统
      中级
    • 实体事件
      新手
    • 实体属性
    • 渲染控制器
      新手
    • 生成规则
  • Tutorials
    • 任意坐标系间的坐标转换(世界、实体、骨骼)
      中级
    • 创建船只
      中级
    • 实体手持物品
      中级
    • 实体攻击机制
      中级
    • 实体睡眠机制
      中级
    • 实体碰撞体
      中级
    • 实体移动
    • 实体计时器
      中级
    • 无敌实体
      新手
    • 村庄机制实现指南
    • 检测其他实体
      中级
    • 生成已驯服的实体
      脚本
      中级
    • 视线检测实体
      中级
    • 禁用队友伤害
      中级
    • 范围效果云入门指南
      中级
    • 虚拟实体
      新手
    • 飞行实体控制
      中级
  • Documentation
    • Vanilla Usage Spawn Rules
    • 原版使用组件
    • 抛射物
    • 虚拟组件
    • 运行时标识符
    • 非生物实体运行时标识符
战利品、配方与交易
  • General
    • 交易行为
  • Documentation
    • 战利品表
    • 交易表
    • 合成配方
    • 物品函数
  • Tutorials
    • 随机化结构战利品
      简单
文档
  • Shared Constructs
  • Molang 查询详解
  • Vanilla Materials
    专家
  • 声音定义
  • 文件类型
  • 材质配置文件说明
    专家
  • 菜单分类
  • 资源包文件夹结构
  • 雾效ID
  • 高级Molang指南
方块
  • General
    • 方块入门指南
      指南
      新手
    • 方块组件
    • Block Tags
    • 方块状态
    • Block Traits
    • 方块排列组合
    • 方块事件
      脚本
    • 方块事件迁移指南
      帮助
    • 方块物品化
      中级
    • 方块问题排查指南
      帮助
  • Visuals
    • 方块剔除
      中级
    • 方块模型
      指南
      新手
      简单
    • 方块着色
      简单
    • 方块纹理动画
      中级
    • 方块纹理变体
      中级
  • Tutorials
    • Precise Interaction
      专家
      脚本
    • Precise Rotation
      专家
      脚本
    • 伪方块
      中级
    • 可旋转方块
    • 应用持续效果
      简单
      脚本
    • 矿石战利品表
      简单
      脚本
    • 规避状态值限制
      专家
  • Vanilla Re-Creations
    • 自定义作物
      中级
      脚本
    • 自定义活板门
      中级
      脚本
    • 自定义玻璃
      新手
      简单
      已弃用
    • 自定义釉面陶瓦
      简单
  • Documentation
    • 原版方块模型
      新手
    • 方块形状
    • 方块格式历史
    • 方块音效
服务器
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet 协议
    • RakNet 协议
概念
  • contents.json
  • Molang
    中级
  • Rawtext
  • textures_list.json
  • 命名空间
  • 子包
  • 文本与本地化
  • 着色器
  • 纹理图集
    中级
  • 表情符号与特殊字符
  • 覆盖资源
    中级
  • 音效
    中级
物品
  • General
    • 物品入门指南
      指南
      新手
    • 物品组件
    • 物品标签
    • 物品事件
      脚本
    • Item Event Migration
      帮助
    • 物品问题排查指南
      帮助
  • Tutorials
    • Custom Pottery Sherds
    • 可投掷物品
      中级
    • 生成物品
      中级
    • 自定义武器
      简单
    • 自定义盔甲
    • 自定义食物
      简单
      脚本
    • 通过装备物品执行命令
      实验性
      中级
    • 高分辨率物品
  • Documentation
    • 附魔
    • Numerical Item IDs
    • Vanilla Usage Components
    • 原版物品标识符
      已弃用
    • 可附着物
      新手
    • 物品格式历史记录
视觉效果
  • General
    • 实体视觉效果简介
      指南
    • 基岩版建模指南
    • 动画中的特效
    • 基于数学的动画
      中级
    • 材质
      专家
    • 材质创作
      专家
    • 皮肤包制作指南
    • 自定义死亡动画
      中级
  • Tutorials
    • Glowing Entity Texture
    • 受伤动画
      中级
    • 实体纹理动画
      中级
    • 栓绳位置调整
      简单
    • 玩家几何模型
      新手
    • 移除实体阴影
      中级
    • 重绘生成蛋纹理
      新手
  • Ideas
    • 结构展示技巧
粒子效果
  • General
    • 粒子效果入门
      指南
  • Tutorials
    • 禁用粒子效果
      新手
  • Documentation
    • 原版粒子效果
脚本编写
  • General
    • 脚本编程入门
    • 什么是Script API?
    • API 模块
  • Tutorials
    • GameTests
      实验性
    • 简易聊天命令
      实验性
    • 脚本核心功能
    • 脚本表单
      实验性
    • 脚本请求API
      实验性
    • 阻止方块放置
  • Documentation
    • JavaScript 问题排查指南
    • Script Resources
    • Script Watchdog
      实验性
    • TypeScript
    • 引擎环境
虚拟现实
  • General
    • 启用VR模式
      指南
    • 配置资源包
      专家
  • Tutorials
    • 编辑你的第一个模型
      专家

版本控制

版本控制
  • Git
  • GitHub
  • 词汇测验
  • 设置Git
    • 结构
    • 创建Git仓库
    • 链接现有的RP和BP
    • 额外文件
    • 使用VCS工作

版本控制是通过迭代方式备份代码的概念,使您能够根据需要回滚到特定版本。最基本的版本控制可以通过每天(或每个版本)将您的附加组件打包为.zip并上传到Google Drive(或本地保存)来实现。这并非不合理,但它存在三个显著问题,而专业的版本控制系统(VCS)可以解决:

  • 难以比较不同版本
  • 难以实际回滚到旧版本
  • 对团队协作毫无帮助

本教程将介绍一个名为git的工具基础知识,以及一个名为GitHub的免费在线Git存储服务。任何人都可以学习,但如果您处于团队环境中或经常因忘记备份而丢失工作,您将获得最大收益。

本教程不会直接教授git或GitHub的使用,因为外部知识来源更适合这一目的。重点将放在学习基础知识后如何为Minecraft配置这些工具。

Git ​

git是一个安装在您本地机器上的工具,允许您对文件进行版本控制。您可以用简短的消息(例如“修复了驯服后龙无法飞行的问题”)提交文件更改,查看完整的变更列表,并快速跳转到特定更改。

Git功能极其强大,是所有大型编程项目的实际标准工具。对于Minecraft工作来说,最大的缺点是它非常复杂。学习时请保持耐心。

要全面了解git,您应该遵循以下git教程。

GitHub ​

GitHub是您Git项目(仓库)的在线托管版本。这使得多人可以同时在同一项目上协作。这对于地图制作非常有帮助。通过托管在GitHub上,您还可以(可选地)将代码公开,比以往更容易与世界分享您的附加组件。

要全面了解如何使用GitHub,您应该遵循这个GitHub教程。

词汇测验 ​

如果您已经学到这一步,希望您已经拥有一个GitHub账户并对git有初步了解。以下术语将在本教程中使用。如果您不了解它们,请自行搜索:

  • repository(仓库)
  • branch(分支)
  • commit(提交)
  • github
  • git

设置Git ​

这里假设您要将一个现有项目添加到Git中。如果是从头开始,步骤类似。

结构 ​

将git用于附加组件的主要问题是,git通常通过封装和管理单个文件夹来工作。当然,在基岩版附加组件中,资源分布在两个文件夹中:BP和RP。为了解决这个问题,我们将把仓库完全放在com.mojang文件夹之外,然后使用Windows的junction来“复制”这些文件夹。

将项目放在单独的位置有许多优势:

  • 可以按需包含其他文件,如配置文件、工具、笔记、.bb文件等
  • 可以将RP和BP合并到一个仓库中
  • 所有项目都可以在一个简单的位置轻松查看,而不是深埋在com.mojang中

创建Git仓库 ​

为您的项目选择一个方便的位置。我将其放在C:/sirlich/projects。新建一个以地图名称命名的文件夹。我们将使用wiki作为示例项目的名称。

右键单击该文件夹,选择"Open git Bash"。如果未显示此选项,您可以从开始菜单打开git bash并导航到项目文件夹。如果尚未安装git bash,现在应该安装。

输入:git init。这将在您的项目中创建一个空白仓库。

链接现有的RP和BP ​

下一步是让仓库识别您的RP和BP文件夹。我们将使用Windows的符号链接“junction”。创建junction后,我们实际上是在文件系统中创建了一个“虫洞”,使文件看起来同时存在于两个位置。删除/编辑/添加文件的操作会完美复制。

输入:mklink /J wiki_RP "C:/path/to/RP/in/com/mojang" 输入:mklink /J wiki_BP "C:/path/to/BP/in/com/mojang"

完成后,您应该在项目文件夹中看到wiki_RP和wiki_BP,其中包含所有资源和现有文件等。

您现在可以按照上述教程将此仓库推送到github。

额外文件 ​

由于我们基于符号链接创建了仓库,因此可以在项目文件夹中添加任何内容,而无需担心破坏com.mojang文件夹。我喜欢跟踪.bb文件、封面艺术文件(如.kra等)。

您还可以添加笔记、视频文件或任何其他想要跟踪的内容。

使用VCS工作 ​

使用版本控制系统时需要注意的主要事项:

  • 开始工作前务必拉取最新版本
  • 经常提交并推送
  • 停止工作前务必推送
  • 如果文件严重损坏,您可以随时重置到最后一个可用版本。如果经常提交/推送,希望这不会太久远。
  • 务必,我是说务必,编写良好的提交消息。当您需要回滚时,这至关重要。

贡献者

编辑 版本控制

Bedrock Wiki by Bedrock OSS ,Translate by 8aka-Team

"Minecraft"是Mojang AB的注册商标。

Bedrock OSS、Bedrock Wiki以及 bedrock.dev 与Microsoft及Mojang AB不存在任何隶属关系。

  • 隐私政策
  • 加入QQ社区
  • 参与贡献指南
  • 访问代码仓库