kashub

🎮 Kashub – внутриигровой скриптовый движок для Minecraft

Внутриигровой фреймворк для скриптинга и автоматизации со встроенным редактором в стиле VSCode Надоели повторяющиеся задачи? Хочешь автоматизировать фермерство, строительство или гринд? Kashub добавляет в Minecraft мощный скриптовый слой с красивым встроенным редактором кода, вдохновлённым VSCode.

⚡ Почему Kashub?

В отличие от других модов автоматизации, требующих внешних инструментов или сложной настройки, Kashub даёт тебе всё прямо в игре:

• Внешние редакторы не нужны – открывай редактор по клавише K
• Легко освоить – KHScript с синтаксисом, вдохновлённым Lua/JavaScript
• Красивый интерфейс – более 10 профессиональных тем редактора
• Проверено в мультиплеере – используется на реальных серверах в реальных ситуациях
• Открытый исходный код – лицензия MIT, полностью прозрачно

🔥 Ключевые возможности

Встроенный редактор кода

• Подсветка синтаксиса для KHScript
• Автодополнение (Ctrl+Space)
• Более 10 тем – Dracula, One Dark Pro, Tokyo Night, Cyberpunk и другие
• Поиск и браузер скриптов – быстро находи и управляй скриптами
• Поддержка горячих клавиш – запускай скрипты по хоткеям

Скриптовый движок

• Более 44 команд – движение, взаимодействие, базовая боевая логика, инвентарь, утилиты мира
• Система событий – реагируй на урон, тики, чат, смерти и многое другое
• Переменные и логика – 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, чтобы открыть редактор
   
4. Напиши свой первый скрипт:

// Auto-heal when low HP
onEvent onDamage {
  if ($PLAYER_HEALTH < 10) {
    eat golden_apple
    print "Emergency heal!"
  }
}

5. Нажми 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

⚠ Примечание о бете

Это БЕТА-релиз:

• Основные функции стабильны и пригодны к использованию
• Некоторые крайние случаи всё ещё возможны
• Отзывы и сообщения об ошибках очень приветствуются Пожалуйста, сообщай о проблемах в GitHub Issues.

🔗 Ссылки

• GitHub: https://github.com/KasperStudios/Kashub
• Документация: внутриигровая, через кнопку «Docs» (все команды перечислены)
• Discord: KasHub Community

📜 Лицензия

MIT License – не стесняйся форкать, вносить вклад и делать порты для других загрузчиков (с указанием авторства).

---

Сделано с ❤️ от KasperStudios
Внутриигровой скриптинг и автоматизация для продвинутых пользователей и владельцев серверов

Поддержка

Я разрабатываю KasHub самостоятельно в свободное время. Если этот мод сэкономил тебе время, снизил стресс или ты просто получаешь удовольствие от его использования, ты можешь поддержать автора, чтобы помочь выпустить больше обновлений и новых функций: Поддержать разработку: https://donatello.to/kasperenok Ты можешь сообщать об ошибках, делиться идеями и вносить разумные предложения по улучшению через GitHub Issues или на нашем Discord-сервере.