ctjs

ПРИМЕЧАНИЕ

Этот проект — форк оригинального мода, оригинальный github можно найти по адресу https://github.com/ChatTriggers/ctjs

ChatTriggers (CT) — это фреймворк для Minecraft, который позволяет писать скрипты на JavaScript в реальном времени и модифицировать клиент. Мы предоставляем библиотеки, обёртки, объекты и многое другое, чтобы сделать вашу жизнь моддера максимально простой. Даже если мы не поддерживаем что-то нужное вам, вы всё равно можете получить доступ к любым Java-классам и нативным полям/методам.

С CT вы получаете всю мощь среды для моддинга вместе с преимуществами простого в использовании языка и возможностью перезагружать скрипты без перезапуска игры. CT также предоставляет способ определять свои собственные миксины!

Сейчас CT написан для Fabric 1.21.x. Устаревшую версию для Forge 1.8.9 смотрите в этом репозитории.

Примеры

Хотите скрыть надоедливое сообщение сервера, которое видите при каждом входе в мир?

register('chat', event => {
    cancel(event);
}).setCriteria("Check out our store at www.some-mc-server.com for 50% off!");

А как насчёт автоматизации серии обычных команд в одну?

register('command', () => {
    ChatLib.command('command1');
    ChatLib.command('command2');
    ChatLib.command('command3');
}).setName('commandgroup');

Или даже чего-нибудь забавного вроде команды-калькулятора

register('command', (...args) => {
    // Evaluate all args the user gives us...
    const result = new Function('return ' + args.join(' '))();

    // ...and show the result is a nice green color
    ChatLib.chat(`&aResult: ${result}`);
}).command('calc');

С системой register в CT вы можете слушать пользовательские события, которые мы генерируем, и реагировать на них. Например, мы генерируем события при смене мира, клике по GUI, ударе по блоку, наведении на предмет с просмотром его подсказки и многом другом! Вы даже можете предоставлять свои события, чтобы другие авторы модулей могли их использовать.

С чего начать

Для начала скачайте и установите Fabric для одной из поддерживаемых версий, затем перейдите на нашу страницу релизов и скачайте последнюю версию. Мод устанавливается как любой другой мод — просто перетащите его в папку mods. После установки вы можете импортировать модули прямо в игре, введя `/ct import , где ` — имя модуля. Просмотреть доступные модули можно на нашем сайте.

Написание модулей

Если на сайте вы не нашли модулей, которые делают именно то, что вам нужно (а это вполне вероятно), придётся написать свой! Вот шаги, которые стоит предпринять:

1. Перейдите в папку .minecraft/config/ChatTriggers/modules. Если не знаете, где она находится, можно выполнить /ct files, и нужная директория откроется автоматически.
2. Создайте новую папку с именем вашего модуля

3. Внутри папки создайте файл metadata.json и поместите в него следующий текст:

   {
       "name": "<module name>",
       "entry": "index.js"
   }

   Это означает, что при первом запуске нашего модуля CT выполнит файл index.js

_Учтите, что `` должен точно совпадать с названием вашей папки!_

1. Создайте файл index.js и напишите в нём код. Что именно вы напишете, зависит от того, что вы хотите, чтобы делал CT. Чтобы узнать больше о доступных API, загляните в Slate.

   • Некоторые вещи в Slate могут быть устаревшими, мы работаем над улучшением этого

Документация

• Slate — пошаговое руководство, охватывающее основы
• Javadocs — технический справочник по всем публичным API в моде
• MIGRATION.md — руководство по обновлению модулей с CT 2.X до 3.0
• CONTRIBUTING.md (TODO)