hytale-says/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

pnpm dev      # Run with hot-reload (development)
pnpm start    # Run production
pnpm lint     # ESLint check (npx eslint src/)

Architecture

Discord-to-Telegram message forwarder. Tracks messages from Discord servers and forwards them to Telegram topics.

src/
├── index.ts              # Entry point, initializes clients
├── env.ts                # Environment variables (DISCORD_TOKEN, TELEGRAM_BOT_TOKEN)
├── config.ts             # Loads config.json, validates server/role/channel structure
├── types.ts              # Shared TypeScript interfaces
├── discord/
│   ├── client.ts         # discord.js-selfbot-v13 client
│   └── handlers.ts       # messageCreate handler, channel/role matching
└── telegram/
    ├── client.ts         # wrappergram client
    └── sender.ts         # Message forwarding, media group handling

Flow: Discord messageCreate → match by channel or role → forward to Telegram topic with attachments

Matching Priority:

1. Channels checked first (if configured)
2. Roles checked second (highest priority role = first in config array)

Servers can have channels, roles, or both. Channel matches skip role display in Telegram message.

Config

• config.json - Server/channel/role/topic mappings (see config.json.example)
• .env - Tokens (see .env.example)

Code Style

• ESM with .js extensions in imports
• Node globals via explicit imports (import process from 'node:process')
• @antfu/eslint-config with 2-space indent, single quotes