D7 Feeds Discord Weebhooks

INSTRUCTIONS.txt
INSTRUCTIONS
========================================================================
  D7 FEED  —  Installation & Configuration Guide
========================================================================

A Discord webhook feed for DayZ. Sends a clean killfeed, join/leave
notifications, periodic server status, a kills leaderboard, and a level
leaderboard — all straight to your Discord channels. Fully configurable,
server-side, and license protected.


========================================================================
  1) REQUIREMENTS
========================================================================

  - D7_Core   (REQUIRED — the mod stays disabled without it and without a
               valid license.)

  D7 Feed is SERVER-SIDE — players do NOT need to download it.
  For the LEVEL leaderboard, you also need the D7 LEVELING SYSTEM mod
  (see section 5).


========================================================================
  2) INSTALLATION
========================================================================

  1. Copy the mod folders to your server root:
        @D7_Core
        @D7_Feed

  2. Add them to your server startup line:
        - @D7_Core goes in your MOD list:      -mod=@CF;@D7_Core;...
        - @D7_Feed is server-side, add it to:  -serverMod=@D7_Feed
        (You may also load @D7_Feed in -mod; players just don't need it.)

  3. Copy the mod's .bikey (in its "Keys" folder) into your server
     "keys" folder.

  4. D7 Feed needs a license to run — request one from D7, and make sure
     it includes "D7_Feed". Start the server once; the mod auto-creates
     its config (see section 4). The config is generated even before the
     license is active, so you can set it up in advance — but nothing is
     sent to Discord until the license is valid.


========================================================================
  3) WHAT IT SENDS
========================================================================

  - Killfeed          - a Discord embed for every player kill (weapon,
                        distance, hit zone, map location).
  - Join / Leave      - player connect/disconnect notifications.
  - Server Status     - a periodic server status message.
  - Kills Leaderboard - top killers, posted on a timer.
  - Level Leaderboard - top players by level (needs D7 Leveling, sec. 5).

  Player privacy: only in-game names are shown — no Steam64 IDs.

  STYLES & IMAGES: every message supports TWO looks — set "embedStyle"
  to 2 (clean modern) or 1 (classic emoji). You can also put your own
  thumbnail image on each message type, or turn images off. See sec. 4.


========================================================================
  4) CONFIG
========================================================================

  Created automatically on first server start at:

        <server profile>\D7\D7_Feed\Config.json

  (Other auto files in the same folder: Leaderboard.json, state.json —
   leave those alone.) Edit Config.json, then RESTART the server.

  {
    "webhookUrl": "https://discord.com/api/webhooks/XXXX/XXXX",
                                  // main webhook (killfeed / join-leave /
                                  //   status). REQUIRED.
    "serverName": "D7",           // shown in the messages
    "username": "D7 Feed",        // webhook display name
    "avatarUrl": "",              // webhook avatar image URL (optional)

    "embedStyle": 2,              // 2 = clean modern style, 1 = classic
                                  //   emoji style
    "showImages": 1,           // 1=on\2=off - show a thumbnail image on the embeds
    "imageKillfeed": "https://i.imgur.com/xxxx.png",     // killfeed +
                                                         //   join/leave
    "imageStatus": "https://i.imgur.com/xxxx.png",       // server status
    "imageLeaderboard": "https://i.imgur.com/xxxx.png",  // both boards

    "enableKillfeed": 1,
    "enableJoinLeave": 1,
    "enableServerStatus": 1,
    "enableHitDamage": 0,      // 1=on\2=off - also post non-lethal hits (spammy)

    "showDistance": 1,          // show kill distance
    "showWeapon": 1,            // show the weapon used
    "showHitZone": 1,           // headshot / body / limb
    "showMapLocation": 1,       // approximate map location
    "showSteamProfile": 0,     // keep false to protect privacy
    "simplifiedMessages": 0,   // 1 = compact text (no rich embed)

    "serverStatusInterval": 300,   // seconds between status posts

    "enableLeaderboard": 1,     // kills leaderboard
    "leaderboardWebhookUrl": "",   // empty = use the main webhookUrl
    "leaderboardInterval": 1800,   // seconds between posts
    "leaderboardTopCount": 10,     // how many players to list

    "enableLevelLeaderboard": 1,  // LEVEL leaderboard (needs D7 Leveling) 1=on\2=off
    "levelLeaderboardWebhookUrl": "",  // empty = use the main webhookUrl
    "levelLeaderboardInterval": 1800,
    "levelLeaderboardTopCount": 10
  }

  TIP: give the killfeed, the kills leaderboard, and the level
  leaderboard their own channels by setting a different webhook URL for
  each (the *WebhookUrl fields). Leave a field empty to fall back to the
  main webhookUrl.

  STYLE:  "embedStyle": 2 = clean modern layout, 1 = classic emoji
          layout. IMAGES: set imageKillfeed / imageStatus /
          imageLeaderboard to your own image URLs (shown on both styles),
          or set "showImages": "0" to turn them off.


========================================================================
  5) LEVEL LEADERBOARD  —  works ONLY with D7 Leveling
========================================================================

  The Level Leaderboard reads player level data written by the
  D7 LEVELING SYSTEM mod (from <server profile>\D7\D7_Leveling\). It is
  built to work with D7 Leveling ONLY — it will NOT read data from any
  other leveling mod.

  If you do NOT run D7 Leveling, set:
        "enableLevelLeaderboard": "0"
  otherwise the level leaderboard will have no data to post.


========================================================================
  6) DISCORD WEBHOOK SETUP
========================================================================

  1. In Discord: Server Settings -> Integrations -> Webhooks.
  2. New Webhook -> pick a channel -> Copy Webhook URL.
  3. Paste it into "webhookUrl" (and the *WebhookUrl fields if you want
     separate channels).


========================================================================
  7) LICENSE
========================================================================

  D7 Feed is protected by D7_Core. It only works on servers whose license
  includes "D7_Feed". Without a valid license the config is still created,
  but nothing is sent to Discord.

  Need a license or help? Contact D7 on Discord (see LICENSE.txt /
  SUPPORT.txt).

========================================================================
  (c) 2026 D7. All Rights Reserved.
========================================================================