卡舒布

卡舒布

用于Minecraft自动化的强大游戏内脚本引擎。VSCode风格编辑器、40+高级命令、主题、调试工具和多任务处理——非常适合自动化农场、实用工具和服务器端工作流程。

游戏机制

🎮 Kashub – Minecraft 游戏内脚本引擎

内置 VSCode 风格编辑器的游戏内脚本与自动化框架

厌倦了重复性任务?想要自动化 farming、建造或刷怪?Kashub 为 Minecraft 添加了一个强大的脚本层,并配有受 VSCode 启发的精美内置代码编辑器。

⚡ 为什么选择 Kashub?

与其他需要外部工具或复杂设置的自动化模组不同,Kashub 让你一切尽在游戏内:

  • 无需外部编辑器 – 按 K 打开编辑器
  • 易于学习 – KHScript 采用受 Lua/JavaScript 启发的语法
  • 精美界面 – 10+ 种专业编辑器主题
  • 多人游戏验证 – 已在真实服务器、真实场景中使用
  • 开源 – MIT 许可证,完全透明

🔥 主要特性

内置代码编辑器

  • 语法高亮 支持 KHScript
  • 自动补全(Ctrl+Space)
  • 10+ 种主题 – Dracula、One Dark Pro、Tokyo Night、Cyberpunk 等
  • 搜索与脚本浏览器 – 快速查找和管理脚本
  • 按键绑定支持 – 使用快捷键启动脚本

脚本引擎

  • 44+ 条命令 – 移动、交互、基础战斗逻辑、物品栏、世界工具
  • 事件系统 – 响应受伤、tick、聊天、死亡等事件
  • 变量与逻辑 – if/else、for、while、简单控制流
  • 环境变量 – 例如 $PLAYER_HEALTH、$PLAYER_X、$PLAYER_Y、$PLAYER_Z

开发者工具

  • 日志系统 – 追踪脚本执行和调试输出
  • 任务管理器 – 同时运行多个脚本
  • 清晰的错误处理 – 提供有用的错误信息,而非静默失败

🛡 公平游戏与服务器控制

Kashub 的设计目标是对服务器友好:

  • 计划中的服务器权威控制 (将在 v0.9.0-beta 更新中推出):
    • 服务端配置可覆盖客户端设置
    • 能够在特定服务器上禁用编辑器
    • 能够阻止特定命令 / 命名空间在客户端运行
  • 客户端会尊重服务器决定,不会尝试绕过它们

这让服务器所有者能够决定其服务器上允许多少自动化(或完全禁用),同时仍让玩家在单人游戏或私人世界中享受 Kashub。

📚 快速开始

  1. 安装 Fabric 1.21.1 和 Fabric API
  2. 将 Kashub 放入你的 mods 文件夹
  3. 启动 Minecraft 并按 K 打开编辑器

脚本编辑器

  1. 编写你的第一个脚本:
// Auto-heal when low HP
onEvent onDamage {
  if ($PLAYER_HEALTH < 10) {
    eat golden_apple
    print "Emergency heal!"
  }
}
  1. 按 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 上报告问题。

🔗 链接

📜 许可证

MIT 许可证 – 欢迎 fork、贡献,并为其他加载器构建移植版本(请注明出处)。


由 KasperStudios 用 ❤️ 制作 面向高级用户和服务器所有者的游戏内脚本与自动化

支持

我利用业余时间独自开发 KasHub。如果这个模组为你节省了时间、减轻了压力,或者你只是喜欢使用它,你可以支持作者,帮助带来更多更新和新功能:

支持开发: https://donatello.to/kasperenok

你可以通过 GitHub Issues 或我们的 Discord 服务器报告错误、分享想法,并提出合理的改进建议。