Skip to content

00202210/ChatToWebhook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ChatToWebhook

ChatToWebhook is a lightweight Roblox server-side utility that captures TextChatService messages and forwards them to any webhook endpoint in rate-limit-safe batches.

It is designed to be:

  • πŸ”Ή Webhook-agnostic (Discord, Slack, custom APIs, etc.)
  • πŸ”Ή Server-only & event-driven
  • πŸ”Ή Safe for live games (batching + throttling)
  • πŸ”Ή Easy to drop into existing projects

✨ Features

  • βœ… Listens to Roblox TextChatService
  • πŸ“¦ Batches messages to avoid webhook rate limits
  • ⏱️ Configurable batch size & flush interval
  • πŸ”’ Sanitization & validation hooks
  • 🌐 Works with any webhook
  • 🧩 Modular design (Config / Types / Externalize)

πŸ“¦ What This Is (and Isn’t)

βœ… This is

  • A text chat β†’ webhook logger
  • A backend/monitoring tool
  • Useful for moderation logs, analytics, staff tools, archives

❌ This is not

  • A generic event system
  • A bidirectional chat bridge
  • A Discord bot

🧱 Architecture Overview


TextChatService
↓
Message Capture
↓
Queue / Batch Buffer
↓
Webhook POST (HttpService)

Messages are queued and flushed either:

  • when the batch reaches a size limit, or
  • after a fixed time interval

This keeps webhook usage efficient and rate-limit friendly.


βš™οΈ Installation

  1. Clone or download the repository
  2. Place the ChatToWebhook folder into:

ServerScriptService

  1. Configure your webhook URL and batching settings
  2. Run the game β€” messages will begin logging automatically

πŸ› οΈ Configuration

All configuration lives in the Config module.

Typical options include:

  • WEBHOOK_URL
  • BATCH_INTERVAL
  • MAX_CHARACTERS (per webhook payload)
  • Optional filters or validation rules

Exact fields may vary β€” see Config.lua for details.


πŸ§ͺ Example Use Cases

  • πŸ“œ Chat moderation logs
  • πŸ“Š External chat analytics
  • πŸ› οΈ Staff dashboards
  • πŸ” Debugging player reports
  • πŸ“‘ Internal tooling pipelines

πŸš€ Performance Notes

  • Entirely event-driven
  • No per-frame logic
  • Network I/O dominates runtime cost

Safe to run in production servers.

About

A lightweight Roblox server utility that batches TextChatService messages and forwards them to any webhook endpoint.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages