NationDex logo

Nationdex

Community extras for Project Nationdex 2026

Loading extras…

Example structure

Below are templates illustrating how to organize your commands inside your repository.

1. Repository hierarchy

  • Fork this repo
  • Check src folder
  • Check commands folder:
    • For slash commands: use slash commands folder
    • For prefix commands: use cmds folder
  • Create a file in your desired folder.

2. Example prefix command structure

Example ping command (prefix) structure inside your file (e.g. ping.ts):

import { BaseCommand } from '@tryforge/forgescript';

export default new BaseCommand({
  name: 'ping',
  type: 'messageCreate',
  code: `hi $ping ms` // ur exact forgescript code, not this btw
});

3. Example slash command structure

Example ping command (slash) structure inside your file (e.g. ping.ts):

import { ApplicationCommand } from '@tryforge/forgescript';
import { ApplicationCommandType, ApplicationIntegrationType } from 'discord.js';

export default new ApplicationCommand({
  data: {
    type: ApplicationCommandType.ChatInput,
    name: 'ping',
    integration_types: [
      ApplicationIntegrationType.GuildInstall
    ],
  },
  code: `hi $ping ms` // ur exact forgescript code, not this btw
})

Submit an extra

Submit your package to the index by following these steps.

1. Create a repository

Add your ForgeScript code file:

  • Create folder src (if not already)
  • Inside src, create folder cmds (if not already)
  • Inside cmds, create folder (slash or prefix - depends)
  • Inside folder, add your ForgeScript code file (example: ping.ts) [add your file name & code]
  • main.ts is not needed

2. Create package.json

Example structure:

{
  "name": "your-repo-name", //change it to ur repo name
  "version": "1.0.0",
  "description": "An example of a ForgeScript community extra for Project Nationdex 2026.", //change it to ur description
  "license": "MIT", //change it to ur license
  "author": "your-username" //change it to ur username
}

3. Fork this index repository and add your entry

Fork this index repo and edit data/extras.json in your fork to add your entry:

{
  "extras": [
    // ... alr entries will be made just add "," next line, then this:
    {
      "id": "ur-extra-id", //change it to ur extra id
      "repo": "https://github.com/yourusername/your-repo-name", //change it to ur repo url
      "branch": "main" //change it to ur branch
    }
  ]
}

4. Open a pull request

Check if it is good to go! Then go for pull request and submit.