手册:制作附加包

From Minecraft基岩版开发Wiki

此页面为附加包教程的索引页面,你可以在此学习关于附加包制作的入门指导及进阶教程。

导读[edit]

本教程对于初学者建议按从上往下的顺序阅读。“开始之前”、“包的构建”、“运行、调试与导出”和“本地化”四个条目讲解了制作附加包的基本所需,在了解了相关内容后也可根据实际情况选择对应条目阅读。

本教程中使用了一些基本例子来讲解部分附加包的功能,例如自定义食物、武器、可旋转方块、农作物等。在对附加包制作方法比较掌握后可以根据需要查阅对应例子,初学者可选择其一作为自己尝试制作附加包的对象。

教程的部分内容属于测试版内容,要使用相关附加包功能请使用对应游戏版本。

文件架构[edit]

这里列出了资源包行为包的基本架构,在制作附加包时需根据这个基本架构来建立文件关系。

资源包[edit]

  •  RP:顶级文件夹,建议名称中带有“RP”或“RES”字样
    •  pack_icon.png:资源包图标
    •  bug_pack_icon.png:错误包图标
    •  biomes_client.json:生物群系定义文件
    •  blocks.json:方块定义文件
    •  contents.json:内容文件
    •  items_offsets_client.json:物品渲染偏移客户端定义文件
    •  loading_messages.json:加载提示信息文本文件
    •  manifest.json:清单文件
    •  sounds.json:声音定义文件
    •  splashes.json:闪烁标语文本文件
    •  animation_controllers:客户端动画控制器
      •  example.animation_controller.json
    •  animations:客户端动画
      •  example.animation.json
    •  attachables:附着物
      •  example.attachable.json
    •  entity
      •  example.entity.json:实体客户端定义文件
    •  fogs
      •  example.fog.json:迷雾定义文件
    •  font:字体
    •  items
      •  example.item.json:物品客户端定义文件
    •  materials:材质
      •  example.material
      •  example.json
    •  models:模型
      •  entity
        •  example.geo.json
      •  blocks
        •  example.geo.json
    •  particles:粒子
      •  example.particle.json
    •  render_controllers:渲染控制器
      •  example.render_controller.json
    •  shaders:着色器
      •  glsl
        •  example.fragment
        •  example.vertex
        •  example.h
      •  hlsl
        •  example.fragment.hlsl
        •  example.geometry.hlsl
        •  example.vertex.hlsl
    •  sounds:声音
      •  example.ogg:音频文件
      •  music_definitions.json:音乐定义文件
      •  sound_definitions.json:音效定义文件
    •  texts:本地化文本
      •  languages.json:语言定义文件
      •  language_names.json:语言名称定义文件
      •  ……
    •  textures:纹理
      •  blocks:方块纹理
        •  example.png
      •  colormap:地图群系渲染颜色
        •  birch.png
        •  evergreen.png
        •  ……
      •  entity:实体纹理
        •  example.entity.png
      •  environment:环境纹理
        •  clouds.png:云贴图
        •  destroy_stage_0.png:方块破坏进度贴图
        •  ……
      •  gui:图形界面
        •  achievements
        •  new_gui
        •  ……
      •  items:物品纹理
        •  example.png
      •  map:地图(手持)纹理
        •  map_background.png:地图背景贴图
        •  map_icons.png:地图图标贴图
        •  player_icon_background.png
      •  misc:杂项
        •  enchanted_item_glint.png:附魔光效贴图
        •  missing_texture.png:纹理丢失贴图
        •  pumpkinblur.png:南瓜头(装备时)阴影贴图
      •  models:盔甲模型
        •  armor
          •  chain_1.png
          •  chain_2.png
          •  ……
      •  painting:画
        •  kz.png
      •  particle:粒子
        •  campfire_smoke.png
        •  particles.png
        •  example.png
      •  persona_thumbnails:人物角色
        •  alex_hair_thumbnail_0.png
        •  alex_pants_thumbnail_0.png
        •  ……
      •  ui:UI(用户界面)
        •  sidebar_icons
        •  subcategory_icons
        •  5stars_empty.png
        •  ……
      •  flame_atlas.png:(实体着火时)火焰粒子贴图
      •  forcefield_atlas.png
      •  flipbook_textures.json:翻书动画定义文件
      •  item_texture.json:物品纹理定义文件
      •  terrain_texture.json:方块纹理定义文件
      •  textures_list.json:纹理清单文件
    •  ui:UI
      •  realmsPlus_sections
      •  settings_sections
      •  _global_variables.json:全局变量
      •  _ui_defs.json:UI定义文件
      •  ……

行为包[edit]

  •  BP:顶级文件夹,建议名称中带有“BP”、“BEH”或“DAT”字样
    •  animation_controllers:服务端动画控制器
      •  example.ac.json
    •  animations:服务端动画
      •  example.animation.json
    •  biomes:生物群系
      •  example.biome.json
    •  blocks:方块
      •  example.block.json
    •  entities:实体服务端定义
      •  example.entity.json
    •  feature_rules
      •  example.feature.json:地物
      •  example.rule.json:地物规则
    •  functions:函数
      •  example.mcfunction
      •  tick.json
    •  items:物品服务端定义
      •  example.item.json
    •  loot_tables:战利品表
      •  example.loot.json
    •  manifest.json:清单文件
    •  pack_icon.png:行为包图标
    •  recipes:配方
      •  example.recipe.json
    •  scripts:脚本
      •  client:客户端脚本
        •  example.js
      •  server:服务端脚本
        •  example.js
    •  spawn_rules:实体生成规则
      •  example.spawn.json
    •  structures:结构
      •  example.mcstructure
    •  texts:行为包语言文件
      •  zh_CN.lang
      •  languages.json
    •  trading:交易表
      •  economy_trades
        •  example.trade.json
      •  example.trade.json

目录[edit]

基础[edit]

主要内容[注 1][edit]

示例[edit]

物品

方块

实体

附着物

地物


  1. 粗体字部分由于内容较少,请直接参考开发信息页面。

参见[edit]