ctjs

# NOTE This project is a fork from the original mod, for the original github you can head over to https://github.com/ChatTriggers/ctjs <div style="text-align:center;"> <p> <a href="https://chattriggers.com"> <img src="https://chattriggers.com/assets/images/logo-final.png" width="546" alt="ChatTriggers.js" /> </a> </p> <p> <a href="https://discord.gg/chattriggers"> <img src="https://discordapp.com/api/guilds/119493402902528000/embed.png" alt="Discord" /> </a> <a href="https://github.com/Synnerz/ctjs/releases"> <img src="https://img.shields.io/github/v/release/Synnerz/ctjs.svg?include_prereleases" alt="Releases" /> </a> <a href="https://github.com/Synnerz/ctjs/actions/workflows/build.yml"> <img src="https://github.com/Synnerz/ctjs/actions/workflows/build.yml/badge.svg" alt="Build Status" /> </a> </p> </div> 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 (https://github.com/ChatTriggers/ctjs/wiki/Dynamic-Mixins)! CT is currently written for Fabric 1.21.x. See (https://github.com/ChatTriggers/ChatTriggers) 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? ```js 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? ```js register('command', () => { ChatLib.command('command1'); ChatLib.command('command2'); ChatLib.command('command3'); }).setName('commandgroup'); ``` Or even something silly like a calculator command ```js 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, (https://fabricmc.net/wiki/install) for one of the supported versions, then head over to our (https://github.com/Synnerz/ctjs/releases) 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 (https://www.chattriggers.com/modules). ### 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. 1. Create a new directory with the name of your module 1. Inside the directory, create a file called `metadata.json`, and inside of that, put the following text: ```json { "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!_ 1. 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 (https://chattriggers.com/slate/#introduction). * Some things on the Slate may be outdated, we are working on improving this ### Documentation - (https://chattriggers.com/slate/#introduction), a guided tutorial that covers the basics - (https://chattriggers.com/javadocs/), a technical reference for all public APIs in the mod - (docs/MIGRATION.md), a guide for upgrading modules from CT 2.X to 3.0 - (CONTRIBUTING.md) (TODO)