vpinball：实践指南

作者：袖梨 2026-09-11

团队讨论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）