Examples zh CN

English

示例

GuideNH 已经在 wiki/resourcepack/ 中内置了一份运行时示例指南。本页将重要示例文件与它们所展示的功能对应起来。

核心示例页面

运行时文件	展示内容
.../_zh_cn/index.md	frontmatter、item ids、配方、物品/方块图片、命令链接、tooltip、场景、注解、ImportStructureLib、RemoveBlocks、BlockAnnotationTemplate、首页推荐示例
.../_zh_cn/markdown.md	普通 Markdown 功能、表格，以及 recommend: 0 示例
.../_en_us/rendering.md	块级渲染和布局行为
.../_en_us/structure.md	<Structure> 用法与坐标格式
.../_en_us/japanese.md	导航子页面示例
.../_zh_cn/navigation-guide.md	导航、链接和高优先级推荐示例
wiki/resourcepack/assets/gregtech/guidenh/_zh_cn/index.md	第二个命名空间示例，用于展示跨指南链接和同名页面隔离

资源示例

运行时文件	用途
wiki/resourcepack/assets/guidenh/guidenh/_en_us/test1.png	页面私有图片示例
wiki/resourcepack/assets/guidenh/guidenh/assets/example_structure.snbt	供 <ImportStructure> 和 <RemoveBlocks> 使用的共享根结构资源

示例片段

Frontmatter + Navigation

item_ids:
  - guidenh:guide
navigation:
  title: Root
  icon_texture: test1.png
  recommend: 3

首页推荐

navigation:
  title: Markdown Basics
  parent: index.md
  recommend: 0

navigation:
  title: Navigation & Index
  parent: index.md
  recommend: 5

相对图片

![Test Image](test1.png)

带命名空间的指南链接

[同命名空间](guide.md)
[同命名空间根路径](/guide.md)
[其他命名空间](gregtech:guide.md)
[其他命名空间根路径](gregtech:/guide.md)

根路径结构资源

<ImportStructure src="/assets/example_structure.snbt" />

StructureLib 场景导入

<GameScene width="384" height="256" zoom={4} interactive={true}>
  <ImportStructureLib controller="gregtech:gt.blockmachines:1000">
    <Tier value="4" />
    <Channel name="hatch" value="1" />
    <Facing value="north" />
    <Rotation value="normal" />
    <Flip value="none" />
    <GregTechActiveController />
    <GregTechPlaceHatches />
  </ImportStructureLib>
</GameScene>

子标签会设置 StructureLib 场景默认值，点击 reset view 时会恢复这些默认值。

导入结构后的清理

<GameScene width="384" height="256" zoom={4} interactive={true}>
  <ImportStructure src="/assets/example_structure.snbt" />
  <RemoveBlocks id="minecraft:glowstone" />
</GameScene>

场景注解 Tooltip

<DiamondAnnotation pos="0.5 2.2 0.5" color="#FFD24C">
  ### Activated Beacon
  <RecipeFor id="minecraft:furnace" />
</DiamondAnnotation>

配方过滤

<RecipesFor id="minecraft:redstone_torch" input="minecraft:stick&minecraft:redstone" limit="1" />

什么时候该用哪个示例

• 若你在验证解析器基础能力，先看 markdown.md
• 若你要一起测试混合运行时特性，包括 StructureLib tooltip、舱口高亮和清理逻辑，用 index.md
• 若你只需要静态方块布局预览，用 structure.md
• 若你需要可复用的导入结构资源，用 example_structure.snbt

推荐学习顺序

1. 快速开始
2. 指南页面格式
3. 标签参考
4. 游戏场景
5. 注解
6. 配方