本页目录

Love Live! 学园偶像祭 演唱会模拟器(Live Simulator: 2)

livesim2_async · DarkEnergyProcessor/livesim2_async

Live Simulator: 2(DEPLS2)是用 Lua 编写的《Love Live! 学园偶像祭》演唱会(打歌)模拟器,支持多种谱面格式:SIF 谱面、Custom Beatmap Festival 工程文件夹、MIDI(含专用 MIDI)、SIFTrain 原版与扩展谱面,以及自有的二进制谱面...

音乐节奏 LÖVE2D Lua 音频系统 UI 系统 中级
★ Stars 103 Forks 12 License Zlib 更新 2026-09-30

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:LÖVE2D 暂无中文教程标记 未标记站长实测
依赖十余个 GitHub 上的外部 Lua 库,国内拉取可能较慢,建议配置镜像或代理;FFmpeg 4.x 为可选依赖,需要注意版本与位数匹配;v4.0 要求 64 位操作系统。具体安装步骤请以 docs/How_To_Setup.md 为准,其余环境细节待核验。

中文项目介绍

Live Simulator: 2(社区常缩写为 DEPLS2)是一个用 Lua 编写的《Love Live! 学园偶像祭》(LL!SIF)演唱会(Live Show / 打歌)模拟器。按 README 的说法,它目前是一个 LL!SIF 的演唱会模拟器,核心目标是把原作中的打歌环节单独拆出来复现:读取不同来源的谱面,在模拟器里播放,让玩家在没有原版客户端的场合也能练习、回顾或欣赏谱面。

与很多只支持单一谱面格式的音游模拟器不同,这个项目的重点之一在于谱面格式的兼容层——它同时接受自家格式、原作格式以及若干第三方工具产出的格式,并在内部做统一转换。项目仓库的 topics 标注了 llsif、love2d、lovelive、lua、luajit、school-idol-festival、sukufesu-simulator 等关键词,可以看出其技术栈定位在 Lua/LuaJIT 与 LÖVE 生态。

技术架构分析

技术要点

项目本身以 Lua 编写,仓库 topics 中出现 luajit,说明其目标运行环境包含 LuaJIT 加速。它并非从零造轮子,而是组合了一批 Lua 生态的通用库:

  • Luaoop:提供面向对象/类机制,用于组织模拟器内部的模块。
  • Yohane Playground Flash Abstraction:作者自家的抽象层库,与 LÖVE 生态相关。
  • tween.lua 与 hump.timer:分别负责补间插值和计时器,是音游里驱动动画与节拍时序的常用工具。
  • JSON.lua、lua-tinyyaml、lua-nbt:分别覆盖 JSON、YAML、NBT 三种数据格式,正好对应谱面/工程文件/新格式谱面的解析需求。
  • Lily:图形/着色器方向的库。
  • LS2X:Live Simulator 2 家族的配套库。
  • i18n、md5.lua、utf8_validator.lua:国际化、哈希与 UTF-8 校验等基础设施。

此外,如果运行环境里存在 FFmpeg 4.x,模拟器会自动加以利用(属于“可用则用”的可选依赖,而非硬性要求)。

从致谢名单可以看出项目在国际化上投入不小:README 中提到的翻译贡献覆盖简体中文、繁体中文、日语、波兰语、斯洛伐克语、意大利语、西班牙语、俄语、泰语等。

构建与运行

README 给出两条关键信息:

  1. v4.0 版本要求 64 位操作系统——这是硬性前提。
  2. 具体的安装与运行步骤不在主 README 中展开,而是写在 docs/How_To_Setup.md 里,需要按该文档准备运行环境与外部库。

由于项目依赖十余个外部 Lua 库,且这些库大多托管在 GitHub 上,首次搭建时应先阅读安装文档,把依赖逐个就位后再启动;如果系统里能找到 FFmpeg 4.x,可额外获得其带来的可选能力。

补充说明

支持的谱面格式

README 明确列出了以下几类谱面来源:

  • Live Simulator: 2 二进制谱面:对应 Live Simulator: 2 v1.x / v2.0 时代的谱面格式。
  • Live Simulator: 2 “Over the Rainbow” NBT 谱面:对应 v4.0 引入的新谱面格式,以 NBT(Minecraft 风格的命名二进制标签)形式存储。
  • SIF 谱面:原作《学园偶像祭》的谱面格式,也是整个模拟器内部的“通用中间格式”——所有其他格式的谱面最终都会被转换为 SIF 格式再进入播放流程。
  • Custom Beatmap Festival 工程文件夹:可直接读取 CBF 的工程目录,而不需要先导出成单一文件。
  • MIDI 与专用 MIDI:既支持普通 MIDI 文件,也支持为模拟器量身定制的 MIDI。
  • SIFTrain 谱面:原始版本与“扩展”版本都被支持。

把 SIF 谱面作为内部统一表示是一个清晰的设计取舍:判定逻辑、音符渲染、时间轴推进等只需实现一遍,新增一种格式的工作量就退化为“写一个解析器 + 转成 SIF 谱面”。

学习建议

这个仓库适合作为“多格式输入 + 统一中间表示”的案例来读:建议先从 SIF 谱面这一内部格式的解析与数据结构入手,再看每种外部格式的转换入口,体会格式适配层如何被隔离在主流程之外。

其次是 Lua 工程化实践:十余个外部依赖如何组织、可选依赖(FFmpeg)如何做“有则用、无则跳过”的降级处理、i18n 词典如何接入 UI,都是可以直接借鉴的写法。对音游感兴趣的读者,还可以重点观察计时器与补间库如何配合音频时间轴驱动音符下落与判定。

开源许可证与版权说明

许可证标识:Zlib。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目