[MD]
# 跑酷生成器使用文档
## 项目简介
[/MD]
[MD] 这个项目来源于我最初的一个简单需要：我想有一种长期简单的跑酷来给我放松。然而事实上我并没有找到良好的选择，所以做了这个跑酷生成器。 **跑酷生成器**专门为MCBE设计，它能够动态生成跑酷，并且有非常多的特殊性质。 ## 主要特性 [/MD]
[MD] ### 1. **多种主题选择** - **经典跑酷**：传统石质赛道 - **冰船竞速**：宽阔的冰面赛道，适合船只滑行 - **海洋冒险**：水下主题赛道 - **下界挑战**：充满岩浆的下界风格 - **末地维度**：末地主题 ### 2. **动态难度系统** - 随距离增加自动提升难度 - 可自定义初始难度 - 随机生成的跳跃缺口和陷阱 ### 3. **智能生成机制** - 预加载前方赛道，避免卡顿 - 自动检测并绕过障碍物 - 根据玩家前进距离动态扩展 [/MD]
[MD] ### 4. **完整的游戏系统** - 检查点系统（踩特殊方块保存进度） - 生命值系统（默认3条命） - 坠落检测和重生机制 ## 如何开始 首先你需要先从附件页下载文件，然后把它导入到MC中。导入之后新建一个世界，打开作弊和实验性选项中的Beta API(测试版API)，然后就可以使用命令来启动它了。 ### 基础命令 ``` /runner:run [主题] [难度] ``` 这是全称，日常使用时可以直接使用`/run`来代替。 ### 示例： 1. **启动经典跑酷**： ``` /run classic 0 ``` 2. **启动下界挑战**： ``` /run nether 5 ``` ## 详细参数说明 ### 必需参数 - **无**：直接使用 `/runner:run` 将使用默认设置 ### 可选参数 | 参数 | 类型 | 说明 | 默认值 | 示例 | |------|------|------|--------|------| | `theme` | 字符串 | 赛道主题 | `classic` | `iceboat`, `ocean` | | `difficulty` | 数字 | 初始难度系数 | `0` | `3.5` | | `width` | 整数 | 赛道宽度（方块数） | 主题默认 | `9` | | `lives` | 整数 | 玩家生命值 | `3` | `5` | | `enableGaps` | 布尔值 | 是否生成跳跃缺口 | `true` | `false` | | `enableDecorations` | 布尔值 | 是否生成装饰 | `true` | `false` | | `increaseDifficulty` | 布尔值 | 是否随距离增加难度 | `true` | `false` | ## 原理介绍 在启动之后，它会根据你的视角开始创建一段跑道，该跑道利用`runJob`构建，避免了性能问题，但注意请把模拟距离拉的比视距要大一点，否则可能会看到未加载的区域。 在跑的过程中，它会读取预定义的配置文件，这些文件可以直接修改`main.js`同时还有一些特定常量，旁边均有注释，如果您技术力较高可以手动配置自己的主题和调整常量。 ```javascript // ==================== 常量定义 ==================== const PRE_GENERATE_LENGTH = 80; // 预生成长度 const DIFFICULTY_INCREASE_INTERVAL = 50; // 难度增加间隔 const DIFFICULT_INCREASE_COEFFICIENT = 0.04; // 难度增加系数 const MAX_GAP_WIDTH = 4; // 最大缺口宽度 const DEFAULT_MAX_LIVES = 3; // 默认最大生命值 const DEATH_THRESHOLD = 6; // 死亡阈值（坠落高度） const MAX_BLOCK_RETRY = 100; // 最大方块重试次数 ``` ## 常见问题 **Q:** 该项目开源吗？项目地址在哪？以何种形式开源？ **A:** 该项目开源，是一个实验性项目，最初只是为了个人使用，同时测试AI性能。也就是说这个项目中大部分代码是AI写的，我只做检查和修改部分特定bug。由于是AI写的和个人使用，所以我并没有打算把它发布到GitHub上，项目地址即是此处，开源文件是MIT。可供自由修改。 **Q:** 用什么AI写的？怎样的提示词？ **A:** 这个项目经过了许多不同AI的分别迭代，所以没有具体的提示词。 **Q:** 使用前还需要干些什么？ **A:** 你只要懂基本的简单命令并且拥有OP权限，基本上都可以快速使用它。如果你需要非OP权限也可以使用的版本，附件中也有提供，但请注意，这两个版本不能同时安装。 **Q:** 有哪些主题可供挑选？ **A:** `classic`, `iceboat`, `ocean`, `nether`, `end` **Q:** 支持多人游玩吗？ **A:** 其实是处于半支持状态，每个人可以单独玩自己的`/run`，但不可以参加到别人的跑步中去，并且也没有经过完全测试。所以也不建议在服务器中使用。 **Q:** 如何结束游戏？ **A:** 使用`/reload`重载所有脚本，就会使所有人的游戏都关闭。或者跳下去自杀多次，耗尽命也会导致游戏结束。 **Q:** 支持版本？ **A:** `26.x`以上均可正常运行，理论上`1.21`以上就可运行，但不提供支持(未经测试)。 [/MD]
MIT License
Copyright (c) 2026 TickPoints
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
[MD] 这个项目来源于我最初的一个简单需要：我想有一种长期简单的跑酷来给我放松。然而事实上我并没有找到良好的选择，所以做了这个跑酷生成器。 **跑酷生成器**专门为MCBE设计，它能够动态生成跑酷，并且有非常多的特殊性质。 ## 主要特性 [/MD]
[MD] ### 1. **多种主题选择** - **经典跑酷**：传统石质赛道 - **冰船竞速**：宽阔的冰面赛道，适合船只滑行 - **海洋冒险**：水下主题赛道 - **下界挑战**：充满岩浆的下界风格 - **末地维度**：末地主题 ### 2. **动态难度系统** - 随距离增加自动提升难度 - 可自定义初始难度 - 随机生成的跳跃缺口和陷阱 ### 3. **智能生成机制** - 预加载前方赛道，避免卡顿 - 自动检测并绕过障碍物 - 根据玩家前进距离动态扩展 [/MD]
[MD] ### 4. **完整的游戏系统** - 检查点系统（踩特殊方块保存进度） - 生命值系统（默认3条命） - 坠落检测和重生机制 ## 如何开始 首先你需要先从附件页下载文件，然后把它导入到MC中。导入之后新建一个世界，打开作弊和实验性选项中的Beta API(测试版API)，然后就可以使用命令来启动它了。 ### 基础命令 ``` /runner:run [主题] [难度] ``` 这是全称，日常使用时可以直接使用`/run`来代替。 ### 示例： 1. **启动经典跑酷**： ``` /run classic 0 ``` 2. **启动下界挑战**： ``` /run nether 5 ``` ## 详细参数说明 ### 必需参数 - **无**：直接使用 `/runner:run` 将使用默认设置 ### 可选参数 | 参数 | 类型 | 说明 | 默认值 | 示例 | |------|------|------|--------|------| | `theme` | 字符串 | 赛道主题 | `classic` | `iceboat`, `ocean` | | `difficulty` | 数字 | 初始难度系数 | `0` | `3.5` | | `width` | 整数 | 赛道宽度（方块数） | 主题默认 | `9` | | `lives` | 整数 | 玩家生命值 | `3` | `5` | | `enableGaps` | 布尔值 | 是否生成跳跃缺口 | `true` | `false` | | `enableDecorations` | 布尔值 | 是否生成装饰 | `true` | `false` | | `increaseDifficulty` | 布尔值 | 是否随距离增加难度 | `true` | `false` | ## 原理介绍 在启动之后，它会根据你的视角开始创建一段跑道，该跑道利用`runJob`构建，避免了性能问题，但注意请把模拟距离拉的比视距要大一点，否则可能会看到未加载的区域。 在跑的过程中，它会读取预定义的配置文件，这些文件可以直接修改`main.js`同时还有一些特定常量，旁边均有注释，如果您技术力较高可以手动配置自己的主题和调整常量。 ```javascript // ==================== 常量定义 ==================== const PRE_GENERATE_LENGTH = 80; // 预生成长度 const DIFFICULTY_INCREASE_INTERVAL = 50; // 难度增加间隔 const DIFFICULT_INCREASE_COEFFICIENT = 0.04; // 难度增加系数 const MAX_GAP_WIDTH = 4; // 最大缺口宽度 const DEFAULT_MAX_LIVES = 3; // 默认最大生命值 const DEATH_THRESHOLD = 6; // 死亡阈值（坠落高度） const MAX_BLOCK_RETRY = 100; // 最大方块重试次数 ``` ## 常见问题 **Q:** 该项目开源吗？项目地址在哪？以何种形式开源？ **A:** 该项目开源，是一个实验性项目，最初只是为了个人使用，同时测试AI性能。也就是说这个项目中大部分代码是AI写的，我只做检查和修改部分特定bug。由于是AI写的和个人使用，所以我并没有打算把它发布到GitHub上，项目地址即是此处，开源文件是MIT。可供自由修改。 **Q:** 用什么AI写的？怎样的提示词？ **A:** 这个项目经过了许多不同AI的分别迭代，所以没有具体的提示词。 **Q:** 使用前还需要干些什么？ **A:** 你只要懂基本的简单命令并且拥有OP权限，基本上都可以快速使用它。如果你需要非OP权限也可以使用的版本，附件中也有提供，但请注意，这两个版本不能同时安装。 **Q:** 有哪些主题可供挑选？ **A:** `classic`, `iceboat`, `ocean`, `nether`, `end` **Q:** 支持多人游玩吗？ **A:** 其实是处于半支持状态，每个人可以单独玩自己的`/run`，但不可以参加到别人的跑步中去，并且也没有经过完全测试。所以也不建议在服务器中使用。 **Q:** 如何结束游戏？ **A:** 使用`/reload`重载所有脚本，就会使所有人的游戏都关闭。或者跳下去自杀多次，耗尽命也会导致游戏结束。 **Q:** 支持版本？ **A:** `26.x`以上均可正常运行，理论上`1.21`以上就可运行，但不提供支持(未经测试)。 [/MD]
MIT License
Copyright (c) 2026 TickPoints
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
