? Kashub – Minecraft 内置脚本引擎
带有内置 VSCode 风格编辑器的游戏内脚本与自动化框架
厌倦了重复性任务?想要自动化农场、建筑或刷怪?Kashub 为 Minecraft 添加了一个强大的脚本层,并配备了一个受 VSCode 启发的精美内置代码编辑器。
⚡ 为什么选择 Kashub?
与其他需要外部工具或复杂设置的自动化模组不同,Kashub 提供了一切在游戏内完成的功能:
- 无需外部编辑器 – 按
K即可打开编辑器 - 易于学习 – KHScript 拥有受 Lua/JavaScript 启发的语法
- 美观的 UI – 10+ 种专业编辑器主题
- 经多人服务器验证 – 已在真实服务器的实际场景中使用
- 开源 – MIT 许可证,完全透明
? 主要功能
内置代码编辑器
- KHScript 语法高亮
- 自动补全 (Ctrl+Space)
- 10+ 种主题 – Dracula、One Dark Pro、Tokyo Night、Cyberpunk 等
- 搜索与脚本浏览器 – 快速查找和管理脚本
- 快捷键支持 – 使用热键启动脚本
脚本引擎
- 44+ 条命令 – 移动、交互、基础战斗逻辑、物品栏、世界工具
- 事件系统 – 响应伤害、刻(ticks)、聊天、死亡等事件
- 变量与逻辑 –
if/else、for、while、简单的控制流 - 环境变量 – 例如
$PLAYER_HEALTH、$PLAYER_X、$PLAYER_Y、$PLAYER_Z
开发者工具
- 日志系统 – 跟踪脚本执行和调试输出
- 任务管理器 – 同时运行多个脚本
- 清晰的错误处理 – 提供有帮助的错误信息,而非静默失败
? 公平竞技与服务端控制
Kashub 旨在成为对服务端友好的模组:
- 计划中的服务端权威控制 (将在更新
v0.9.0-beta中推出):- 可覆盖客户端设置的服务端配置
- 能够在特定服务器上禁用编辑器
- 能够阻止在客户端上运行特定的命令/命名空间
- 客户端尊重服务端的决定,并不会尝试绕过它们
这让服务器管理员可以决定在他们的服务器上允许多少自动化行为(或者完全禁用),同时仍让玩家在单人模式或私人世界中享受 Kashub。
? 快速开始
- 安装 Fabric 1.21.1 和 Fabric API
- 将 Kashub 放入你的
mods文件夹 - 启动 Minecraft 并按
K打开编辑器

- 编写你的第一个脚本:
// Auto-heal when low HP
onEvent onDamage {
if ($PLAYER_HEALTH < 10) {
eat golden_apple
print "Emergency heal!"
}
}
- 按 F5 运行!
? 示例脚本
自动农场
// Tree farm automation
loop 100 {
lookAt nearest oak_log
mine
wait 500
}
自动战斗(PvE 风格)
// Auto-attack nearby mobs
onEvent onTick {
if (nearestEntity zombie < 5) {
attack entity zombie
}
}
智能挖矿
// Mine only diamond ore
scanner start diamond_ore
loop {
if ($SCANNER_FOUND) {
pathTo $SCANNER_X $SCANNER_Y $SCANNER_Z
mine
}
wait 1000
}
? 自定义

? 游戏内文档

? 技术细节
- 语言: KHScript(自定义脚本语言)
- 命令: 44+ 个内置自动化命令
- 加载器: Fabric 1.21.1
- 依赖项: Fabric API
- 许可证: MIT
⚠ Beta 通知
这是一个 BETA 版本:
- 核心功能稳定且可用
- 可能存在一些边缘情况
- 非常欢迎反馈和错误报告
请在 GitHub Issues 上报问题。
? 链接
- GitHub:
- 文档: 通过游戏内的“Docs”按钮获取(列出所有命令)
- Discord: KasHub Community
? 许可证
MIT 许可证 – 欢迎 Fork、贡献并为其他加载器构建移植版(请注明出处)。
由 KasperStudios 用 ❤️ 制作
面向高级用户和服务端管理员的游戏内脚本与自动化
支持
我利用业余时间独立开发 KasHub。如果这个模组为你节省了时间、减轻了压力,或者你只是单纯喜欢使用它,你可以支持作者以帮助带来更多更新和新功能:
支持开发:
你可以通过 GitHub Issues 或在我们的 Discord 服务器上报告错误、分享想法并提出合理的改进建议。
? Kashub – In‑Game Scripting Engine for Minecraft
In‑game scripting and automation framework with a built‑in VSCode‑style editor
Tired of repetitive tasks? Want to automate farming, building, or grinding? Kashub adds a powerful scripting layer to Minecraft with a beautiful built‑in code editor inspired by VSCode.
⚡ Why Kashub?
Unlike other automation mods that require external tools or complex setups, Kashub gives you everything in‑game:
- No external editors needed – Open the editor with
K - Easy to learn – KHScript with Lua/JavaScript‑inspired syntax
- Beautiful UI – 10+ professional editor themes
- Multiplayer‑proven – Used on real servers in real scenarios
- Open source – MIT License, fully transparent
? Key Features
Built‑in Code Editor
- Syntax highlighting for KHScript
- Auto‑completion (Ctrl+Space)
- 10+ themes – Dracula, One Dark Pro, Tokyo Night, Cyberpunk, and more
- Search & script browser – Find and manage scripts quickly
- Keybind support – Launch scripts with hotkeys
Scripting Engine
- 44+ commands – Movement, interaction, basic combat logic, inventory, world utilities
- Event system – React to damage, ticks, chat, deaths and more
- Variables & logic –
if/else,for,while, simple control flow - Environment variables – e.g.
$PLAYER_HEALTH,$PLAYER_X,$PLAYER_Y,$PLAYER_Z
Developer Tools
- Logging system – Track script execution and debug output
- Task manager – Run multiple scripts at the same time
- Clear error handling – Helpful error messages instead of silent failures
? Fair‑Play & Server Control
Kashub is designed to be server‑friendly:
- Planned server‑authoritative control (will be in update
v0.9.0-beta):- Server‑side config that can override client settings
- Ability to disable the editor on specific servers
- Ability to block specific commands / namespaces from running on the client
- The client respects server decisions and does not try to bypass them
This lets server owners decide how much automation is allowed on their server (or disable it entirely) while still letting players enjoy Kashub in singleplayer or private worlds.
? Quick Start
- Install Fabric 1.21.1 and Fabric API
- Drop Kashub into your
modsfolder - Launch Minecraft and press
Kto open the editor

- Write your first script:
// Auto-heal when low HP
onEvent onDamage {
if ($PLAYER_HEALTH < 10) {
eat golden_apple
print "Emergency heal!"
}
}
- Press F5 to run!
? Example Scripts
Auto‑Farm
// Tree farm automation
loop 100 {
lookAt nearest oak_log
mine
wait 500
}
Auto‑Combat (PvE‑style)
// Auto-attack nearby mobs
onEvent onTick {
if (nearestEntity zombie < 5) {
attack entity zombie
}
}
Smart Mining
// Mine only diamond ore
scanner start diamond_ore
loop {
if ($SCANNER_FOUND) {
pathTo $SCANNER_X $SCANNER_Y $SCANNER_Z
mine
}
wait 1000
}
? Customization

? In‑Game Docs

? Technical Details
- Language: KHScript (custom scripting language)
- Commands: 44+ built‑in automation commands
- Loader: Fabric 1.21.1
- Dependencies: Fabric API
- License: MIT
⚠ Beta Notice
This is a BETA release:
- Core features are stable and usable
- Some edge cases may still exist
- Feedback and bug reports are very welcome
Please report issues on GitHub Issues.
? Links
- GitHub:
- Documentation: In‑game via the “Docs” button (all commands listed)
- Discord: KasHub Community
? License
MIT License – feel free to fork, contribute, and build ports for other loaders (with proper credit).
Made with ❤️ by KasperStudios
In‑game scripting and automation for power users and server owners
Support
I develop KasHub on my own in my spare time. If this mod has saved you time, reduced your stress, or you simply enjoy using it, you can support the author to help bring more updates and new features:
Support development:
You can report bugs, share ideas, and make reasonable suggestions for improvement via GitHub Issues or on our Discord server.
下载 kashub
下载 kashub
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 kashub
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 kashub
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 kashub
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 kashub
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[v0.9.0-beta] - 2026-01-25
?️ 新功能
CrashGuard 命令
- 保护系统 - 新增
crashguard { }命令,用于保护代码免受崩溃和错误的影响- 异常处理(类似 try-catch)
- FPS 监控与节流
- 执行超时保护
- 内存使用监控
- 自动恢复
- 可配置选项
crashguard(timeout=5000)- 设置自定义超时时间(毫秒)crashguard(minFps=30)- 设置最低 FPS 阈值crashguard(timeout=10000, minFps=25)- 组合选项
- 使用场景
- 保护扫描操作免受崩溃影响
- 在繁重操作期间监控性能
- 通过超时防止无限循环
- 安全地进行实体交互
System 对象
- 新的全局对象 - 包含核心工具的
System对象System.print(message)- 输出到聊天栏和控制台System.log(message)- 仅输出到控制台(不显示在聊天栏)System.chat(message)- 发送聊天消息System.wait(ms)- 休眠指定毫秒数System.time()- 获取当前时间戳System.exit()- 停止脚本执行System.gc()- 请求垃圾回收System.memory()- 获取内存使用情况信息(已用、空闲、总计、最大)
- 迁移路径 - 旧版函数(
print、wait、chat)仍可用,但已被弃用 - 更好的组织方式 - 系统级功能现在统一归入一个对象中
? 文档
- CrashGuard 指南 - 包含示例和最佳实践的完整指南
- System 对象指南 - System 对象方法的完整文档
- 更新的 README - 在主文档中添加了新功能说明
- 示例脚本 - 演示 crashguard 和 System 对象的新测试脚本
? UI 改进
- 自动补全 - 代码补全中增加了 System 对象和 crashguard
- 代码片段 - 新增 crashguard 模式的代码片段
crashguard- 基础受保护块crashguard_timeout- 带超时的块crashguard_fps- 带 FPS 监控的块
? 开发者体验
- 更好的错误处理 - crashguard 内部的错误会被捕获并记录,而不会导致崩溃
- 性能监控 - 内置 FPS 和内存跟踪功能
- 更安全的脚本 - 鼓励对高风险操作使用 crashguard
? 脚本引擎 2.0(面向对象) ✅
目标: 通过使用面向对象语法现代化 KHScript,使其更强大且直观(类似于 JavaScript)。
核心功能
- 面向对象语法 - 使用
object.method()和object.propertyplayer.health替代$PLAYER_HEALTHplayer.jump()替代jumpscanner.scan()替代scanner scaninventory.count("diamond")替代inventory count diamond
- 系统对象 - 用于核心功能的新全局对象
System- 系统工具(print、log、wait、memory、time)player- 玩家状态与控制(位置、生命值、物品栏等)vision- 射线投射与实体锁定scanner- 方块与实体扫描inventory- 物品栏管理- 以及更多...
- 数据结构
- 列表字面量 - 支持
[1, 2, 3]语法 - 方括号访问 - 通过
list[0]访问列表/映射
- 列表字面量 - 支持
- 更好的表达式 - 所有命令的统一表达式引擎
UI 改进
- 基于图标的标签页 - 编辑器标签页现在使用紧凑图标(如
Map、Emerald)而非文本,节省屏幕空间。 - 现代化的 README - 更新文档风格以匹配 Modrinth。
- 许可证更新 - 项目现已采用 MIT License。
?️ 架构重构(第 1-5 阶段) ✅
目标: 从全局 ScriptInterpreter 单例迁移到每个脚本独立的 ScriptTask 架构,以实现更好的隔离性、线程安全性和可维护性。
第 1 阶段:新核心类 ✅
-
ScriptExecutionContext - 每个脚本的执行上下文 ?
- 每个脚本隔离的变量存储(不再有变量泄漏!)
- 每个脚本的功能定义
- 每个脚本的命令队列管理
- 每个脚本的事件注册跟踪
- 使用
ConcurrentHashMap和ConcurrentLinkedDeque实现线程安全 - 使用
$VAR替换进行变量处理 - 使用
ExpressionParser进行表达式求值 - 控制流的条件评估
- 与全局状态清晰分离
-
EnvironmentVariableProvider - 只读环境变量的单例 ?
- 从
ScriptInterpreter中提取环境变量逻辑 - 在所有脚本间共享(只读)
- 根据游戏状态进行全局更新
- 限制更新频率(每 50ms 最多一次)以提升性能
- 30+ 个环境变量,包括:
- 玩家:位置、生命值、饥饿度、经验值、速度、氧气供应
- 玩家状态:潜行、冲刺、游泳、飞行、骑乘、在地面上、在水中、在熔岩中、燃烧、死亡
- 世界:时间、白天、天气、难度、是否白天、是否夜晚、月相
- 游戏模式:模式、维度、单人/多人、服务器名称
- 手持物品:名称、数量、槽位
- 目标:方块、实体、距离
- 从
第 2 阶段:核心功能迁移 ✅
-
ScriptTask - 现在使用
ScriptExecutionContext?setVariable()现在委托给上下文processVariables()使用上下文进行变量替换evaluateCondition()使用上下文进行条件评估executeIncrement()使用上下文进行变量更新getVariables()从上下文返回变量stop()调用context.cleanup()进行正确清理- 添加
getContext()方法以直接访问上下文 - 保留旧版
variables映射以保持向后兼容(将在第 6 阶段移除)
-
变量系统 - 迁移到基于上下文的存储
- 所有变量操作现在都通过
ScriptExecutionContext进行 - 变量在每个脚本间隔离
- 脚本之间不再有变量泄漏
- 线程安全的并发访问
- 所有变量操作现在都通过
第 3 阶段:事件系统更新 ✅
-
EventManager - 现在支持事件所有权追踪 ?
- 新增
eventOwners映射表,用于追踪哪些脚本拥有哪些事件 - 新增
registerEventScript(eventName, scriptCode, ownerScriptName)重载方法 - 为每次事件执行创建临时的
ScriptExecutionContext - 事件变量相互隔离,不会泄漏到其他脚本中
clear()方法现在也会清除所有权追踪记录
- 新增
-
ScriptTask - 支持带所有权追踪的事件注册
- 在注册事件时传递脚本名称
- 事件能正确归属于其所属的脚本
- 日志记录中包含所有者信息,更加完善
-
事件隔离 - 事件现在在隔离的上下文中执行
- 每个事件都会创建一个临时的执行上下文
- 事件变量(
$event_*)不会在事件之间泄漏 - 通过 ScriptInterpreter 保持向后兼容性
集成更新
- KashubClient - 现在使用
EnvironmentVariableProvider- 每个刻调用
EnvironmentVariableProvider.getInstance().update() - 在处理事件/任务之前更新环境变量
- 通过限流更新提升性能
- v0.9.0: 在世界加载时自动初始化
ModpackScriptManager
- 每个刻调用
新架构的优势
- ✅ 更好的脚本隔离 - 变量不会在脚本之间泄漏
- ✅ 线程安全 - 并发脚本间无竞态条件
- ✅ 更易于测试 - 每个上下文都可以独立测试
- ✅ 代码更整洁 - 集中化的变量/条件逻辑
- ✅ 面向未来 - 已准备好支持多线程执行
? 服务器与整合包脚本 ✅
目标: 实现服务器端脚本执行和整合包级别的脚本功能。
整合包脚本系统
-
ModpackScriptManager - 管理服务器端/整合包脚本 ?
- 自动从
config/kashub/modpack_scripts/发现脚本 - 在世界加载时自动启动必要的整合包脚本
- 在服务器重启之间持久化存储数据
- 在世界卸载时自动清理
- 自动从
-
ModpackScript - 代表整合包级别的脚本 ?
- 包含必要脚本的标志位
- 基于优先级的执行顺序系统
- 与用户脚本隔离
-
GlobalEventHooks - 整合包脚本的全局事件钩子 ?
- 注册全局事件处理器
- 基于优先级的执行
- 跨会话持久化
- 整合包级别的事件管理
功能
- ✅ 服务器端执行 - 脚本在服务器/整合包上下文中运行
- ✅ 整合包脚本 - 适用于所有玩家的必要脚本
- ✅ 事件钩子 - 带有优先级的全局事件处理器
- ✅ 持久化数据 - 数据可保留至服务器重启后
- ✅ 自动初始化 - 系统在世界加载时自动启动
⚙️ 灵活配置 ✅
目标: 为管理员和整合包创作者提供灵活的配置选项。
配置系统
- Enhanced KashubConfig - 新的配置选项 ?
restrictedMode- 限制模组使用仅限整合包脚本allowEditorAccess- 控制编辑器访问权限allowDebuggerAccess- 控制调试器访问权限disabledCommands- 禁用的命令列表clientEnforcement- 在客户端强制执行设置
功能
- ✅ 功能开关 - 启用/禁用编辑器、调试器或特定命令
- ✅ 受限模式 - 将模组使用限制为仅限整合包脚本
- ✅ 自定义功能 - 配置独特的服务器机制
- ✅ 运行时配置 - 无需重启即可更改设置
- ✅ 命令黑名单 - 禁用特定命令
? 通用集成系统 ✅
目标: 通过反射和动态兼容性实现与任何模组的集成。
模组桥接系统
-
ModBridgeManager - 通用模组集成 ?
- 自动发现所有已加载的模组
- 基于反射的 API 调用
- 字段访问(获取/设置)
- 带参数的方法调用
- 模组存在性检测
-
TagManager - 物品/方块标签系统 ?
- 检查物品/方块是否具有特定标签
- 获取具有某标签的所有物品/方块
- 支持原版和模组标签
- 在脚本中启用模组兼容性
功能
- ✅ 模组桥接 API - 通过反射与任何模组集成
- ✅ 动态兼容性 - 脚本根据可用模组自适应
- ✅ 物品/方块标签 - 处理原版和模组的标签
- ✅ 模组检测 - 在使用功能前检查模组是否存在
- ✅ API 访问 - 调用模组方法并访问字段
- ✅ 安全集成 - 优雅地处理缺失模组的情况
? 玩家与网络交互 ✅
目标: 实现玩家权限、消息传递和网络交互。
玩家交互系统
- PlayerInteractionManager - 玩家管理 ?
- 支持通配符的权限系统
- 玩家数据存储
- 消息发送
- 当前玩家检测
新事件
- onPlayerJoin - 当玩家加入世界时触发 ?
- onPlayerLeave - 当玩家离开世界时触发 ?
功能
- ✅ 权限系统 - 控制谁可以运行脚本
- ✅ 玩家消息 - 向特定玩家发送消息
- ✅ 玩家数据存储 - 存储每位玩家的数据
- ✅ 加入/离开事件 - 对玩家连接做出反应
- ✅ 通配符权限 - 灵活的权限模式
? Discord 丰富状态显示(额外功能) ✅
目标: 自动在 Discord 中显示 Kashub 活动(类似 VSCode)。
Discord 集成
- DiscordRichPresence - 自动 Discord 丰富状态显示 ?
- 显示正在运行的脚本数量
- 显示当前世界/服务器名称
- 显示模组版本和会话持续时间
- 每 15 秒自动更新
- 始终启用(无需配置)
- 优雅处理未运行 Discord 的情况
功能
- ✅ 活动显示 - 显示正在运行的脚本和世界信息
- ✅ 全自动 - 像 VSCode 一样工作,无需设置
- ✅ 自动更新 - 每 15 秒更新一次
- ✅ 安全 - 优雅处理未运行 Discord 的情况
- ✅ 零配置 - 开箱即用
? 客户端配置强制执行 ✅
目标: 同步服务器配置与客户端,以确保行为一致。
配置同步系统
- ConfigSyncManager - 客户端配置强制执行 ?
- 加入时接收服务器配置
- 应用服务器限制
- 断开连接时重置为本地配置
- 对用户透明
功能
- ✅ 服务器覆盖 - 服务器配置优先于客户端配置
- ✅ 自动同步 - 玩家加入时自动同步
- ✅ 透明 - 自动运行,无需干预
- ✅ 安全 - 断开连接时重置为本地配置
? 说明
- 向后兼容 - 现有脚本无需更改即可正常工作
- v0.9.0 所有功能已完成 - 架构重构、服务器与整合包脚本、灵活配置、通用集成、玩家与网络交互、Discord Rich Presence(丰富状态显示)
- 下一步计划 (v1.0.0):
- 阶段 6:移除 ScriptInterpreter 单例模式(破坏性变更)
- 针对配置同步的客户端强制执行
- 完整的多玩家网络数据包处理
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧