FVTT 基础教程——DND系统文本增强器指南——嵌入

最新发布：2026-05-20 首次发布：2026-05-19

Foundry 提供了一个内容增强器，允许在日志页面或物品/角色的描述中嵌入文档。DnD5e 系统以几种有用的方式扩展了此功能。

标准嵌入用法

核心嵌入系统使用 @Embed 增强器格式调用。可以通过将文档拖入编辑器窗口来轻松嵌入文档，从而创建一个文档链接（例如 @UUID[...]{Name}），然后将 @UUID 部分替换为 @Embed（名称也不是必需的，但保留它也无妨）。

@Embed[Compendium.dnd5e.rules.JournalEntry.w7eitkpD7QQTB6j0.JournalEntryPage.0b8N4FymGGfbZGpJ]

默认情况下，嵌入将包含标题和指向文档的引用链接。大多数情况下，两者都会显示文档名称，如果不需要这种重复，可以使用 caption=false 禁用标题。另一方面，如果不需要引用链接，可以使用 cite=false 禁用它。两者可以同时使用以同时禁用这两项。

嵌入还可以使用 inline 选项，该选项会同时禁用标题和引用，并移除嵌入周围的一些额外标记，从而可能允许将其插入段落中间（但这取决于嵌入的内容）。

// 禁用标题或引用
@Embed[Compendium.dnd5e.rules.JournalEntry.w7eitkpD7QQTB6j0.JournalEntryPage.0b8N4FymGGfbZGpJ caption=false]
@Embed[Compendium.dnd5e.rules.JournalEntry.w7eitkpD7QQTB6j0.JournalEntryPage.0b8N4FymGGfbZGpJ cite=false]
@Embed[Compendium.dnd5e.rules.JournalEntry.w7eitkpD7QQTB6j0.JournalEntryPage.0b8N4FymGGfbZGpJ caption=false cite=false]

// 内联显示
@Embed[Compendium.dnd5e.rules.JournalEntry.w7eitkpD7QQTB6j0.JournalEntryPage.0b8N4FymGGfbZGpJ inline]

角色与物品

对角色使用标准嵌入格式将嵌入其公开传记，对物品使用标准嵌入格式将显示其标准描述，除非物品未鉴定且玩家不是GM用户，在这种情况下将改为嵌入未鉴定描述。

// 角色嵌入
@Embed[Compendium.dnd5e.heroes.Actor.kfzBL0q1Y7LgGs2x]

// 物品嵌入
@Embed[Compendium.dnd5e.classfeatures.Item.s0Cc2zcX0JzIgam5]

随机表

核心 Foundry 支持嵌入随机表，它们将显示为一个标准的 HTML 表格，左侧为掷骰结果，右侧为对应的结果项。可以使用 rollable 选项在表格标题添加一个按钮，以便直接从表格进行掷骰。

默认情况下，表格的描述会显示在表格下方。如果你希望将标题显示在表格上方，可以使用 caption-top 类。

// 标准表格
@Embed[Compendium.dnd5e.tables.RollTable.LHEts1oDaDwcehuj]

// 可随机表格
@Embed[Compendium.dnd5e.tables.RollTable.LHEts1oDaDwcehuj rollable]

// 标题在顶部
@Embed[Compendium.dnd5e.tables.RollTable.LHEts1oDaDwcehuj classes="caption-top"]

法术列表

法术日志页面包含一些额外的嵌入选项，允许设置分组模式并将其显示为表格。

默认情况下，法术列表将使用页面上设置的任何默认分组模式显示，但可以使用 grouping 选项以不同的模式显示。它接受 none（无分组）、alphabetical（按首字母分组）、level（按法术等级分组）和 school（按法术学派分组）。

法术列表还可以使用 table 选项以表格格式显示。这将左侧显示分组类别，右侧显示该类别中的法术列表。

// 设置分组模式
@Embed[Compendium.dnd-players-handbook.content.JournalEntry.phbSpells0000000.JournalEntryPage.5HnIk6HsrSxkvkz5 grouping=none]
@Embed[Compendium.dnd-players-handbook.content.JournalEntry.phbSpells0000000.JournalEntryPage.5HnIk6HsrSxkvkz5 grouping=alphabetical]
@Embed[Compendium.dnd-players-handbook.content.JournalEntry.phbSpells0000000.JournalEntryPage.5HnIk6HsrSxkvkz5 grouping=level]
@Embed[Compendium.dnd-players-handbook.content.JournalEntry.phbSpells0000000.JournalEntryPage.5HnIk6HsrSxkvkz5 grouping=school]

// 显示为表格
@Embed[Compendium.dnd-players-handbook.content.JournalEntry.phbSpells0000000.JournalEntryPage.5HnIk6HsrSxkvkz5 table]