plugin.json

{
  "name": "adb-plugin-server-logs",
  "displayName": "Server Logs",
  "version": "1.3.0",
  "description": "Comprehensive server logging plugin for tracking member changes, message edits/deletes, moderation actions, voice events, channel changes, and server boosts.",
  "author": "DeadIndian",
  "main": "index.js",
  "requiresRestart": false,
  "manifestVersion": 2,
  "process": {
    "model": "persistent",
    "maxExecutionMs": 15000,
    "memoryMb": 256,
    "persistentReason": "Runs un-isolated (system:raw-client) to fetch audit logs (fetchAuditLogs), read message content and member caches, and inspect voice/channel state on every event — discord.js audit-log and cache APIs are outside the sandboxed RPC surface."
  },
  "capabilities": {
    "system": ["raw-client"],
    "storage": ["own-collection"],
    "discord": ["SendMessages", "EmbedLinks", "ViewAuditLog", "ManageMessages"],
    "hooks": ["subscribe"]
  },
  "permissions": {
    "system": ["raw-client"],
    "storage": ["own-collection"],
    "discord": ["SendMessages", "EmbedLinks", "ViewAuditLog", "ManageMessages"],
    "hooks": ["subscribe"],
    "network": { "outbound": [] },
    "filesystem": { "read": [], "write": [] },
    "childProcess": false,
    "nativeAddons": false
  },
  "declaredDependencies": [{ "package": "node-cron", "version": "^3.0.3" }],
  "discordPermissions": ["SendMessages", "EmbedLinks", "ViewAuditLog"],
  "engines": {
    "core": ">=2.0.0",
    "plugins": { "administration": ">=2.0.0" }
  },
  "settings": {
    "commandPermissions": true,
    "schema": [
      { "key": "enabled", "type": "boolean", "label": "Enable server logs", "default": true },
      { "key": "membersChannelId", "type": "channel", "label": "Member events log channel" },
      { "key": "messagesChannelId", "type": "channel", "label": "Message events log channel" },
      { "key": "moderationChannelId", "type": "channel", "label": "Moderation log channel" },
      { "key": "voiceChannelId", "type": "channel", "label": "Voice events log channel" },
      { "key": "channelsChannelId", "type": "channel", "label": "Channel events log channel" },
      { "key": "boostsChannelId", "type": "channel", "label": "Boost events log channel" },
      { "key": "retentionDays", "type": "number", "label": "Message cache retention (days)" }
    ]
  },
  "dashboard": {
    "permissions": [
      { "key": "view", "label": "View", "description": "See logging configuration." },
      { "key": "configure", "label": "Configure", "description": "Set log channels, categories, and retention." },
      { "key": "view-logs", "label": "View logs", "description": "Read the stored/cached message log history." }
    ]
  },
  "webUi": {
    "memberPages": [
      {
        "path": "/me/activity",
        "label": "My Activity Log",
        "icon": "ScrollText",
        "source": { "model": "memberEvent", "scope": "member", "sort": { "createdAt": -1 }, "limit": 100 },
        "view": {
          "type": "table",
          "columns": [
            { "field": "category", "label": "Type" },
            { "field": "description", "label": "Event" },
            { "field": "createdAt", "label": "When" }
          ],
          "empty": "No logged activity about you in this server."
        }
      }
    ]
  },
  "configSchema": {
    "type": "object",
    "properties": {
      "enabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable this plugin for the server"
      },
      "membersChannelId": { "type": "string", "default": null, "description": "Channel ID for member join/leave/update logs" },
      "messagesChannelId": { "type": "string", "default": null, "description": "Channel ID for message edit/delete logs" },
      "moderationChannelId": { "type": "string", "default": null, "description": "Channel ID for moderation/role logs" },
      "voiceChannelId": { "type": "string", "default": null, "description": "Channel ID for voice state logs" },
      "channelsChannelId": { "type": "string", "default": null, "description": "Channel ID for channel create/update/delete logs" },
      "boostsChannelId": { "type": "string", "default": null, "description": "Channel ID for server boost logs" },
      "retentionDays": { "type": "number", "default": 30, "minimum": 1, "maximum": 365, "description": "Days to keep cached messages for edit/delete logging" }
    }
  }
}