GoNorth导出引擎深度解析:Scriban模板、占位符与Export Snippets原理揭秘
GoNorth导出引擎深度解析Scriban模板、占位符与Export Snippets原理揭秘【免费下载链接】GoNorthGoNorth is a story and content planning tool for RPGs and other open world games.项目地址: https://gitcode.com/gh_mirrors/go/GoNorthGoNorth是一款面向 RPG 与开放世界游戏的故事与内容规划工具而它最硬核的亮点之一就是内置的导出引擎你可以在 GoNorth 里设计 NPC、道具、对话、任务与状态机再通过Scriban 模板、占位符和 Export Snippets把规划好的内容一键转换为可直接使用的游戏脚本如 Lua。本文带你从零看懂这套导出引擎的工作原理 一图看懂导出引擎解决什么问题在传统的游戏开发流程中策划写策划案、程序写脚本两者之间靠人肉翻译。GoNorth 的导出引擎把这一环节自动化了输入你在界面上配置的对象数据NPC 属性、背包、技能、对话、日常行为等模板你或默认提供的Scriban 导出模板定义输出长什么样⚙️引擎占位符解析 数据收集器 函数渲染器输出结构完整、可运行的游戏脚本入口非常简洁整个导出行为都围绕 IObjectExporter 接口展开一次导出只需要两个参数模板ExportTemplate和对象数据ExportObjectData。️ 模板数据模型一切导出的起点每个导出模板对应一条数据库记录核心定义在 ExportTemplate.cs 中。理解这 4 个字段就理解了导出引擎的骨架字段作用TemplateType模板类型对象、对象 Snippet、Include、每日行为等决定哪些数据可用Code模板正文即 Scriban 模板代码RenderingEngine渲染引擎Legacy或ScribanExportSnippets模板上挂载的 Export Snippets 列表其中RenderingEngine是一个枚举定义在 ExportTemplateRenderingEngine.cs 中Legacy旧引擎基于占位符解析器的老式方案占位符由一组PlaceholderResolver逐个替换逻辑写死在 C# 代码里Scriban新引擎基于 Scriban 模板引擎的现代方案模板本身具备完整的条件、循环和函数能力灵活性大幅提升 旧模板默认使用 Legacy 引擎以保证向后兼容新模板建议直接使用 Scriban。 Scriban 渲染引擎内部占位符是如何被填上的核心实现位于 ScribanExportTemplatePlaceholderRenderingEngine.cs。一次导出的流程可以概括为 4 步解析模板Template.Parse把模板代码解析为 Scriban 模板并在保存时提前校验语法构建脚本对象遍历一组值收集器Value Collector把数据库中的对象数据注入到模板可用的数据上下文中渲染调用RenderAsync把模板 数据渲染为最终脚本文本错误收集所有异常统一汇入错误集合界面上可看到清晰的错误提示值收集器模板里每个变量从哪来引擎内置了十几个IScribanExportValueCollector实现目录Services/Export/Placeholder/ScribanRenderingEngine/ValueCollector/每个收集器负责一类数据NpcExportValueCollector→ 模板里的npc名称、属性、状态机ItemExportValueCollector→item道具数据InventoryValueCollector/ItemInventoryValueCollector→ 背包列表DialogValueCollector→dialog对话图与全部对话函数NpcStateMachineExportValueCollector→state_machine状态与迁移NpcDailyRoutineExportValueCollector→daily_routine日常行为ExportSnippetValueCollector→snippet/snippet_functionExport SnippetsLanguageKeyValueCollector→langkey多语言键值也就是说模板里的变量不是魔法而是这些收集器提前收集好并注册进 Scriban 的ScriptObject。管道函数把复杂数据一行变多行除了变量Scriban 模板还能使用内置的管道渲染函数实现位于Services/Export/Placeholder/ScribanRenderingEngine/RenderingFunctions/。以默认的 NPC 模板 ObjectNpc.lua 为例节选-- Inventory {{ inventory | inventory_list }} -- Skills {{ skills | skill_list }}| inventory_list会把背包数据渲染成多行、带缩进的游戏代码类似的函数还有attribute_list属性列表、skill_list、daily_routine_event_list、dialog_function、state_machine_function、indent_multiline多行缩进等。条件与循环Scriban 让模板会思考Scriban 引擎让模板拥有了真正的逻辑能力默认模板中随处可见{{~ if !inventory.empty? ~}} {{ inventory | inventory_list }} {{~ end ~}} {{~ if dialog ~}} {{~ for curFunction in dialog.all_functions ~}} {{ curFunction | dialog_function }} {{~ end ~}} {{~ end ~}}翻译过来就是如果这个 NPC 有背包就导出背包如果配置了对话就遍历导出所有对话函数。这种按需输出的能力Legacy 引擎是做不到的 默认模板库与 include 机制GoNorth 自带一套开箱即用的默认模板全部放在DefaultExportTemplates/目录下按用途组织Object/NPC、道具、技能、背包、状态函数等对象模板ObjectNpc.luaTale/对话系统的动作与条件模板TaleAction*.lua、TaleCondition*.lua近百个General/通用的条件比较与逻辑运算模板等于、包含、与/或/非……Language/语言文件ini导出模板配合include 机制模板可以像积木一样复用Scriban 模板中一行include Npc就能引入另一个模板的内容底层由 ScribanIncludeTemplateLoader.cs 负责从数据库加载。默认模板的加载则交给 CachedExportDefaultTemplateProvider.cs 做缓存管理。 Export Snippets 原理揭秘给对象挂上自定义脚本Export Snippets是 GoNorth 导出体系中最灵活的设计你可以给任意对象挂上一个独立的小脚本片段导出时它会自动生成一个带函数名的代码块嵌入到对象脚本中。两种 Snippet 写法一条渲染管线渲染逻辑集中在 ExportSnippetFunctionRenderer.cs它支持两种ScriptType类型说明Code代码型直接填写脚本文本原样包装成函数导出NodeGraph节点图型用可视化节点编排逻辑引擎调用INodeGraphParser解析节点图复用对话系统的步骤渲染器把节点翻译成脚本函数无论哪种写法最终都会产出一个ExportSnippetFunction函数名 函数体再交给默认模板 ObjectExportSnippetFunction.lua 输出function {{ snippet_function.function_name }}(this) {{ snippet_function.code | indent_multiline }} endSnippet 与对象互相感知Services/Export/ExportSnippets/目录下还有一组配套服务ExportSnippetFunctionNameGenerator.cs自动为 Snippet 生成不冲突的函数名ExportSnippetRelatedObjectNameResolver.cs解析 Snippet 引用的关联对象比如某段逻辑针对的 NPC 或道具ExportSnippetRelatedObjectUpdater.cs对象被导出时让相关 Snippet 自动同步 多语言导出langkey 占位符游戏文本需要多语言支持GoNorth 的方案是语言键Language Key模板中写{{ langkey npc.name }}而不是直接输出角色名字文本ScribanLanguageKeyGenerator.cs 负责为每个待导出文本生成唯一的语言键导出的 ini 语言文件由Language/LanguageFile.ini模板渲染LanguageKey数据模型定义在 LanguageKey.cs这样脚本里引用的是稳定的键值具体文案集中在语言文件中维护——本地化流程一目了然 快速上手三步写出你的第一个 Scriban 导出模板新建模板在导出模板管理页创建模板渲染引擎选择Scriban写模板代码从占位符面板查看当前模板类型可用的变量如npc、inventory、dialog与函数善用{{~ if ~}}、{{~ for ~}}控制输出选对象导出在对象详情页选择你的模板执行导出界面对照预览生成的脚本语法错误会在保存时由ValidateTemplate提前拦截 小贴士不确定语法直接把DefaultExportTemplates/Object/下的默认模板抄一份来改是最快的学习路径。✅ 总结组件一句话定位ExportTemplate导出行为的配置中心类型、代码、引擎、SnippetsScriban 引擎变量注入 条件循环 管道函数模板即逻辑值收集器把数据库对象翻译成模板变量Export Snippets对象级自定义脚本支持代码与节点图两种写法langkey文本与脚本解耦支撑多语言导出GoNorth 的导出引擎用模板 数据 渲染函数三层设计把策划内容与游戏脚本之间的手工鸿沟彻底填平。理解了占位符、Scriban 模板与 Export Snippets 这三块拼图你就掌握了它的核心 【免费下载链接】GoNorthGoNorth is a story and content planning tool for RPGs and other open world games.项目地址: https://gitcode.com/gh_mirrors/go/GoNorth创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

可视化建表+一键生成CRUD:QuickAdmin菜单驱动代码生成实战指南

可视化建表+一键生成CRUD:QuickAdmin菜单驱动代码生成实战指南

可视化建表一键生成CRUD:QuickAdmin菜单驱动代码生成实战指南 【免费下载链接】quickadmin Quick adminpanel builder package for Laravel 5 项目地址: https://gitcode.com/gh_mirrors/qu/quickadmin QuickAdmin 是一款 Laravel 5 后台面板构建包&#xff…

2026/10/24 7:36:47 阅读更多 →
Imagick跨平台部署实战:Linux、Windows、Docker与NixOS 6套环境搭建清单

Imagick跨平台部署实战:Linux、Windows、Docker与NixOS 6套环境搭建清单

Imagick跨平台部署实战:Linux、Windows、Docker与NixOS 6套环境搭建清单 【免费下载链接】imagick 🌈 The Imagick PHP extension 🌈 项目地址: https://gitcode.com/gh_mirrors/ima/imagick Imagick 是一款强大的 PHP 图像处理扩展&a…

2026/11/7 2:00:06 阅读更多 →
理解Alpha通道与颜色合成:TinyColor的onBackground与setAlpha完全指南

理解Alpha通道与颜色合成:TinyColor的onBackground与setAlpha完全指南

理解Alpha通道与颜色合成:TinyColor的onBackground与setAlpha完全指南 【免费下载链接】tinycolor 🎨 Color manipulation and conversion 项目地址: https://gitcode.com/gh_mirrors/tin/tinycolor 🎨 TinyColor 是一款轻量好用的 Ja…

2026/10/25 10:38:17 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻