Data We Collect

Ammonite collects only the minimum data necessary:

  • User IDs — to track economy, levels, warnings, and permissions.
  • Guild IDs — to store per-server configuration and settings.
  • Message Content — processed in real-time for commands, proxy tag matching, global chat, prefix commands, and auto-moderation. Not stored persistently unless part of a moderation action.
  • Moderation Records — warning reasons, ban/mute durations, moderator IDs, timestamps.
  • Economy Data — wallet and bank balances, transaction history.
  • Leveling Data — XP totals, level progress, leaderboard rankings.
  • Proxy Data — proxy member names, display names, tags, and avatar URLs (all user-provided).
  • Role Persistence Data — role IDs stored for users who leave so roles can be reassigned on rejoin.
  • Suspicious Account Records — user IDs flagged by automated detection, with notes.

How Data Is Stored

All data is stored locally on the bot host machine as JSON files in the data/ directory. Cached in memory using ConcurrentHashMaps and periodically written to disk.

Key GuaranteesData is never shared with third parties, never sold or used for advertising. No data is sent to external services beyond Discord's own API. No analytics or telemetry.

Data Retention

  • Economy and leveling data is kept as long as the bot is active in the server.
  • Moderation records are kept indefinitely for server admin reference.
  • Proxy data is kept until the user manually deletes it or uses /deletedata.
  • Role persistence data expires after the server-configured period.
  • Server configuration data is retained even if the bot is removed. Server owners may request deletion by contacting the bot owner.

Your Rights

  • View your data — economy balances, levels, warnings, and proxy members are all visible through bot commands.
  • Request deletion using /deletedata. This permanently removes your economy data, leveling progress, warnings, moderation logs, suspicious account records, and all proxy members/groups.
  • Opt out of features — ask a server admin to adjust your permissions (e.g., deny globalchat.use).
Server AdministratorsCan request bulk data deletion by removing the bot and contacting the bot owner directly.

Privileged Gateway Intents

  • Guild Members (GUILD_MEMBERS) — required for role persistence, suspicious account detection, welcome messages, and member cache for moderation.
  • Message Content (MESSAGE_CONTENT) — required for proxy tag matching, prefix command parsing, global chat forwarding, and auto-moderation filtering.
  • Presence (GUILD_PRESENCES) — required for suspicious account detection (analyzing account age and presence patterns).

Non-privileged intents used: GUILD_MESSAGES, GUILD_MESSAGE_REACTIONS, DIRECT_MESSAGES.

Global Chat & Webhooks

The Global Chat feature relays messages between linked channels via Discord webhooks. Relayed messages have a [GC] prefix. Messages are rate-limited and content-capped. Message content is forwarded in real-time and not stored after relay.

Proxy System & Webhooks

The Proxy system sends messages via webhooks using user-configured display names and avatars. Servers can enable a [proxied] indicator. All proxy data can be deleted at any time by the user.

Contact

  • Use /deletedata to erase your personal data at any time.
  • Contact the bot owner through the support server or Discord DM.
  • Server owners can contact the bot owner for server-level data requests.