forked from Ittai/ittai
1
0
Fork 0
ittai/README.md

102 lines
3.1 KiB
Markdown
Raw Normal View History

2022-04-25 18:23:38 -04:00
<p align="center">
<img src="./assets/png/dark/Background.png" alt="Ittai Logo made by Sylix#8103" width="2000">
2022-04-25 18:23:38 -04:00
</p>
2021-01-02 22:22:10 -05:00
2021-01-02 19:42:18 -05:00
<p align="center">
2021-01-02 19:43:03 -05:00
<i>
2022-02-06 19:48:57 -05:00
<strong>What the heck</strong>?! I only need to use <strong>one style</strong> for my plugin?<br>
<strong>Ittai</strong>?! I only need to use <strong>Ittai</strong> for my plugin?<br>
2022-02-06 19:56:53 -05:00
<i>Ittai is a plugin bundler for most Discord client mods, making your plugin cross-compatible with multiple client mods easy!</i>
2021-01-02 19:43:03 -05:00
</i>
</p>
2021-01-02 19:40:07 -05:00
2021-01-02 19:42:18 -05:00
<p align="center">
2022-02-06 19:48:57 -05:00
<a href="#features">Features</a> |
<a href="#installation">Installation</a> |
<a href="#how-to-build">How to Build</a>
2021-01-02 19:40:07 -05:00
</p>
2021-01-02 22:21:19 -05:00
<hr>
2021-01-02 19:40:07 -05:00
## Features
2021-01-09 00:03:14 -05:00
- Build even single-file BD plugins from multi-file projects.
- Write one codebase, run it anywhere.
2021-01-09 08:51:57 -05:00
- Hot rebuild your plugins.
2021-01-09 00:03:14 -05:00
- Use various flavors of JS to create your plugins.
2022-02-06 19:59:05 -05:00
- [x] [JSX and TSX support](https://reactjs.org/docs/introducing-jsx.html)
2022-07-04 14:05:30 -04:00
- [x] [TypeScript](https://www.typescriptlang.org/)
- [x] [ES6 Modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
2022-02-06 19:42:31 -05:00
- [x] [CoffeeScript](https://coffeescript.org/)
2021-01-09 00:03:14 -05:00
- I didn't forget about CSS!
- [x] Load your stylesheets easily.
- `import style from "./style.css";`
- [x] [SASS (SCSS)](https://sass-lang.com/)
- [x] [Stylus](https://stylus-lang.com/)
- [x] [LESS](http://lesscss.org/)
2022-02-06 20:00:47 -05:00
- Build to the most popular mods <sup><i>PRs adding more mod support accepted</i></sup>
2022-02-06 19:59:05 -05:00
- [x] [BetterDiscord](https://betterdiscord.app)
- [x] [Powercord](https://powercord.dev/) (v2)
- [x] [GooseMod](https://goosemod.com/)
2021-01-02 19:40:07 -05:00
## Installation
### Requirements
2021-01-09 00:03:14 -05:00
- [Git](https://git-scm.com/)
- [NodeJS](https://nodejs.org/)
2021-01-27 11:19:08 -05:00
- [pnpm](https://pnpm.js.org/) (optional)
2021-01-02 19:40:07 -05:00
### Installation Steps
2022-02-06 19:48:57 -05:00
#### From NPM
```bash
pnpm i -g @ittai/builder # this anywhere
pnpm i ittai # on your plugin's folder
```
2021-01-02 19:40:07 -05:00
2022-02-06 19:56:53 -05:00
#### From this repo <sup>**(Building Ittai for local development)**</sup>
2021-01-02 19:40:07 -05:00
```bash
2022-02-06 19:48:57 -05:00
git clone https://git.catvibers.me/Ittai/ittai
2022-02-06 19:42:31 -05:00
cd ittai
# linking the builder
cd builder
pnpm i
pnpm link --global
# linking the core
cd ..
cd core
2021-01-27 11:19:08 -05:00
pnpm i
2022-02-06 19:42:31 -05:00
pnpm link --global
```
2022-02-06 19:56:53 -05:00
Then, in your plugin's folder
2022-02-06 19:42:31 -05:00
```bash
pnpm link --global ittai
2021-01-02 19:40:07 -05:00
```
## How to Build
### Command Options
2021-01-09 08:51:57 -05:00
- `--plugin="path/to/your/plugin"`
2021-01-09 00:03:14 -05:00
- `--betterdiscord` (optional)
2021-01-09 08:51:57 -05:00
- Specify `="path/to/plugin/folder"` to copy the built file to the folder.
2021-01-09 00:03:14 -05:00
- Builds for BetterDiscord.
2021-01-09 08:51:57 -05:00
- `--powercordv2` (optional)
- Specify `="path/to/plugin/folder"` to copy the built files to the folder.
- Builds for Powercord v2.
- `--goosemod` (optional)
2021-01-09 08:51:57 -05:00
- Specify `="path/to/plugin/folder"` to copy the built files to the folder.
- Builds for GooseMod.
2021-01-09 08:51:57 -05:00
- `--watch` (optional)
- Will watch for changes in your plugin's unbuilt files and automatically run the command again for you.
2021-01-02 19:40:07 -05:00
### Build Command
2021-01-02 15:26:14 -05:00
This command will build your plugin for BetterDiscord, Powercord v2, and GooseMod, but will only copy it to BetterDiscord's plugins folder. It will also hot rebuild your plugin for you.
2021-01-09 08:51:57 -05:00
2021-01-02 15:26:14 -05:00
```bash
ittai --plugin="./test/plugin" --betterdiscord="/path/to/plugins/fgbd" --powercordv2="/path/to/plugins/fgbd" --goosemod-"/path/to/plugins/fgbd" --watch
2021-01-02 15:26:14 -05:00
```