Skip to content
/ ctjs Public
forked from ChatTriggers/ctjs

An in-progress rewrite of the ChatTriggers mod for Fabric 1.20

License

Notifications You must be signed in to change notification settings

kerollosy/ctjs

This branch is 4 commits ahead of, 10 commits behind ChatTriggers/ctjs:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3a03277 · May 30, 2024
Mar 4, 2024
Apr 10, 2024
May 30, 2024
Apr 10, 2024
Mar 11, 2024
May 30, 2024
Feb 13, 2024
Jan 18, 2024
Jan 26, 2024
Mar 11, 2024
Mar 4, 2024
Jan 18, 2024
Jan 18, 2024
May 4, 2023
Feb 13, 2024

Repository files navigation

ChatTriggers (CT) is a framework for Minecraft that enables live scripting and client modification using JavaScript. We provide libraries, wrappers, objects, and more to make your life as a modder as easy as possible. Even if we don't support something you need, you can still access any Java classes and native fields/methods.

With CT, you have all the power of a modding environment with the benefit of an easy-to-use language and the ability to reload your scripts without restarting the game. CT also provides a way to define your own Mixins!

CT is currently written for Fabric 1.19. See this repo for the deprecated Forge 1.8.9 version.

Examples

Want to hide an annoying server message that you see every time you join a world?

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

How about automating a series of common commands into one?

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

Or even something silly like a calculator command

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');

With CT's register system, you can listen to custom events that we emit and react to them. For example, we emit events when you switch worlds, click on a GUI, hit a block, hover over an item and see its tooltip, and much more! You can even provide custom events for other module authors to use.

Getting Started

To begin, download and install Fabric for one of the supported versions, then head over to our releases page and download the latest version. The mod is installed like any mod; just drag it into your mods folder. Once installed, you can import modules in-game by typing /ct import <moduleName>, where <moduleName> is the name of the module. You can browse the available modules on our website.

Writing Modules

If you can't find any modules on the website that do exactly what you want, which is quite likely, you'll have you write your own! Here are the steps you'll want to take:

  1. Navigate to the .minecraft/config/ChatTriggers/modules folder. If you don't know where this is, you can also execute /ct files, which will open the correct directory automatically.

  2. Create a new directory with the name of your module

  3. Inside the directory, create a file called metadata.json, and inside of that, put the following text:

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

    This means that when our module first runs, CT will run the index.js file

    Note that <module name> must match the name of your folder exactly!

  4. Create the index.js file, and put some code in there. What exactly you write will depend on what you want CT to do. To learn more about the available APIs, take a look at the Slate.

    • Some things on the Slate may be outdated, we are working on improving this

Documentation

About

An in-progress rewrite of the ChatTriggers mod for Fabric 1.20

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 85.0%
  • JavaScript 7.9%
  • Java 7.1%