tscord
v2.0.2
Published
A fully-featured discord bot template written in Typescript, intended to provide a framework that's easy to use, extend and modify
Downloads
42
Maintainers
Readme
TSCord CLI
The official CLI for your TSCord project!
Installation
npm install -g tscord
Usage
tscord --help
Commands
Init
The easiest way to get started with TSCord is by using the init
command. It'll enable you to quickly start building a new TSCord application, with everything set up for you.
info For the moment, only the
bot
template can be init with the CLI.
tscord init bot <name>
Info
Display info about your TSCord project.
tscord info
Generate
You can generate every type of file needed in a TSCord bot application using the CLI in order to speed up your development process.
info The CLI auto-detects your current TSCord version and adapts the generated files to this version. Just keep in mind to update the CLI if you want to generate files for a brand new version prior to when you've installed the CLI.
First, run the command:
tscord generate
Then, choose the type of file you want and finally answer the extra questions depending on the file type.
You can also shortcut it by running:
tscord generate <type>
directly.
Extraction
At some point you'll probably need to customize the generation CLI in different ways, for example:
- edit the generated templates
- customize the logic behind the some generators
- add new generators and templates
It can be achieved by extracting it in your local project!
Simply run this command:
tscord generate --extract
and the source code will be copied in the root of your tscord project under the cli
folder.
This part of the CLI is using plop.js under the hood, so we highly recommend you to check their documentation so you can understand and customize efficiently the generators/templates for your unique needs!
Plugin
Plugins are hosted on the barthofu/tscord-plugins github repository. The CLI let you manage them in many ways!
note When we talk about plugin name, it is in fact their folder name which also acts as their unique identifier.
Install
Use the plugin install
command to install a plugin locally.
tscord plugin install <name>
Uninstall
Use the plugin uninstall
command to uninstall a plugin locally.
tscord plugin uninstall <name>
Update
Updating a plugin is done with the plugin update
command.
tscord plugin update <name>
Search
You can search for plugins and have info on them with the plugin search
command.
tscord plugin search <query>
Options:
-l, --limit <number>
limit the number of results (default: "10")-s, --short
speed up search command by not showing extra information on plugins
Info
The plugin info
command show you all the information about a plugin.
tscord plugin info <name>