Nodejs Join4join Example

Join4Join - Open-Source Discord Bot

A clean, ready-to-fork Join4Join bot built on the official Join4Join API. Run your own bot, grow Discord servers for free - and earn developer rewards every time your users farm.

Every user your bot creates is automatically affiliated to your API key. You earn +0.10 coins each time one of them farms a server, plus +10 coins for every new user who signs up through your affiliate link. Passive income. 🚀

Website • API Docs • Support

HOST THE BOT FOR FREE: bot-hosting.net

✨ Features

• 10 slash commands - help, invite, balance, daily, farm, info, check, buy, pay, stats
• Multi-language 🇬🇧 🇫🇷 🇹🇷 - every user sees the bot in their own Discord language, automatically
• Intuitive UX - /pay @user amount and /buy with inline options, no clunky forms
• Interactive farming - one-click Join buttons, Claim and Refresh
• Robust - timeouts, deferred replies (no more "This interaction failed"), clean error embeds
• Easy to fork - tidy structure, commented code, zero boilerplate to add a command

💰 Developer rewards

Running your own Join4Join bot pays you back. Every user your bot creates is automatically affiliated to your API key (their account is linked to you the first time they appear in any API call), and you earn coins from what they do:

💡 The +10 signup bonus is credited when someone registers on the website via your affiliate link (grab it from your dashboard), so don't hesitate to share it in your bot. The +0.10 per farm is fully automatic for every user your bot creates.

Track your earnings anytime with /stats.

📦 Requirements

• Node.js v18 or higher
• A Discord bot (how to create one)
• A Join4Join API key → get it here

🚀 Installation

# 1. Clone the repository
git clone https://github.com/join4join/nodejs-join4join-example.git
cd nodejs-join4join-example

# 2. Install dependencies
npm install

# 3. Configure your bot
cp .env.example .env      # then open .env and fill it in

# 4. Start the bot
npm start

That's it - your Join4Join bot is live! 🎉

Configuration (.env)

During development, set GUILD_ID so slash commands appear instantly. In production, leave it empty to register commands globally (can take up to 1h).

🧭 Commands

/stats shows your affiliation revenue (you earn 0.10 coins each time one of your users farms). It's restricted to the Discord IDs listed in OWNER in your .env, so leave that empty and it stays private to nobody but you.

🗂️ Project structure

├── index.js               # Entry point: creates the client, loads everything
├── config.js              # Reads & validates your .env
└── src/
    ├── api/               # Join4Join API layer
    │   ├── request.js     # fetch wrapper (auth header, timeout, JSON)
    │   └── join4join.js   # typed methods: getUser, farm, buy, pay, daily...
    ├── commands/          # One file per slash command
    ├── events/            # ready.js + interactionCreate.js (the router)
    ├── i18n/              # Translations
    │   ├── index.js       # t(locale, key, vars) + locale resolution
    │   └── locales/       # en.js · fr.js · tr.js
    ├── loaders/           # loadCommands · loadEvents · deployCommands
    └── utils/             # embeds.js (branding) · logger.js

➕ Add your own command

Create src/commands/ping.js:

const { build } = require("../utils/embeds");

module.exports = {
    name: "ping",
    descriptionKey: "commands.ping", // add this key to src/i18n/locales/*.js
    dmPermission: true,

    async execute(interaction, ctx) {
        const embed = build(ctx, { title: "Ping", description: "🏓 Pong!" });
        await interaction.reply({ embeds: [embed] });
    },
};

Add ping: "Check the bot latency." under commands in each locale file, then restart. The command loads and registers itself - no wiring needed.

Each command receives a ctx object:

☁️ Free hosting

You can host this bot for free on bot-hosting.net.

🆘 Support

Need help? Join the Join4Join support server.

📄 License

MIT © Join4Join