vpinball：实践指南

团队讨论vpinball时，我会先把用途说清楚：Visual Pinball 弹球模拟器项目，支持桌台编辑、脚本逻辑和物理模拟。把它放到日常自动化流程中，最容易暴露的是输入边界、依赖和失败处理如果不清楚就很难稳定复用，不能只看演示是否顺利。我建议用一项范围明确的真实任务完成最小试跑，重点记录配置时间、输出质量、异常信息和维护痕迹，再与现有方案比较。对愿意先做小范围验证并复查原始文档的团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

视觉弹球

开源弹球桌编辑器和模拟器。

该项目由 Randy Davis 发起，于 2010 年开源，并由 Visual Pinball 开发团队继续开发。这是官方存储库。

特点

• 模拟弹球桌物理并使用 DirectX、OpenGL 或 bgfx 渲染桌子
• 用于（重新）创建任何类型的弹球桌的简单编辑器
• 实时编辑渲染视口中的大部分内容
• 表格逻辑（和游戏规则）可以通过 Visual Basic 脚本控制
• 来自约 100 家制造商的超过 1050 台 real/unique 弹球机，以及超过 550 台使用 Visual Pinball X 编辑器制作的 rebuilt/designed 原创作品（如果算上所有已发布的表格，包括 MODs 和不同变体，则数量超过 3000 台），如果包括其先前版本 (Visual Pinball 9.X)，则数量甚至更多
• 通过 PinMAME 模拟真正的弹球机可以通过 Visual Basic 脚本 (Visual PinMAME) 或通过 libPinMAME-API/plugin
• 支持可配置的摄像机视图（e.g。以允许在虚拟弹球柜中正确显示）
• 支持 Tablet/Touch 输入、手柄或专用弹球控制器
• 支持 Stereo3D 输出
• 通过 BAM 支持头部跟踪
• 支持VR/XR HMD渲染（包括PUP、B2S后玻璃和DMD输出支持）
• 支持 WCG/HDR 渲染（目前仅通过 BGFX (D3D11/12) 构建）
• 支持 Windows (x86)、Linux（x86/Arm，包括 RaspberryPi 和 RK3588）、macOS、iOS/tvOS、Android（后者版本也可通过相应的应用商店免费获得）
• 插件系统到drive/fuel各种显示器（DMD，后玻璃等），添加custom/dynamically-changed内容（PUP，血清等），直接输出框架（DOF），传感器等等（WIP）

下载

所有版本均可在 版本页面 上获取。

文档

目前文档很少。检查 文档 目录以获取各种指南和参考。

目前正在开发 非官方 wiki。欢迎社区贡献、建议和帮助，以改进所有用户的资源。

如何建造

构建指令可在 make 目录 README 中找到。

参与

在开通PRs之前，请仔细阅读我们的贡献规则。