← Config Help

D7 Leveling System

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

A custom 1–50 leveling system for DayZ: earn XP from kills, surviving,
and actions; level up for item rewards; use XP Boosters; and extend it
with optional patches (D7 Skills System, BaseBuildingPlus, DNA Keycards,
Expansion Market, Expansion Quests).


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

  - D7_Core   (REQUIRED — the mod will stay disabled without it and
               without a valid license. Load it before D7_Leveling.)

  Add D7_Leveling to the MOD LIST (-mod), NOT as a server-side mod
  (-serverMod).


========================================================================
  2) INSTALLATION (main mod)
========================================================================

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

  2. Add them to your server startup line (Core first):
        -mod=@D7_Core;@D7_Leveling

  3. Copy each mod's .bikey into your server "keys" folder.

  4. Make sure your D7_Core license (set on the D7 website / by D7)
     includes "D7_Leveling", then start the server once. The mod
     auto-creates its config files (see section 6), then you can edit
     them and restart or use reload.txt (section 7).


========================================================================
  3) HOW PLAYERS USE IT
========================================================================

  - Open the level window with the  [ L ]  key (press again to close).
  - A progress bar HUD is shown at the bottom of the screen with the
    current rank icon and XP to the next level.
  - Players earn XP automatically from:
        * Killing infected / animals / players (headshots give bonus)
        * Staying alive (survival tick)
        * Performing actions
        * Any active patches (building, keycards, quests...)
  - Max level is 50.


========================================================================
  4) XP BOOSTERS
========================================================================

  Consumable items that multiply a player's XP gain for a duration.
  Give them via traders, loot, or level rewards using these classnames:

        D7_XPBooster_I     -> x2 XP for 1 hour
        D7_XPBooster_II    -> x2 XP for 2 hours
        D7_XPBooster_III   -> x2 XP for 3 hours

  A player consumes the booster (action on the item) to activate it.
  (D7_XPBooster_Base is the parent class only — do NOT spawn it.)

  The multiplier and durations are configurable in settings.json
  (BoostMultiplier, BoostHours1/2/3).


========================================================================
  5) CONFIG LOCATION
========================================================================

  All config files are created automatically under:

        <server profile>\D7\D7_Leveling\

  Files:
        settings.json        - XP rates, boosters, toggles       (sec. 6)
        levels.json          - per-level XP + rewards            (sec. 6)
        players\<id>.json    - each player's saved level/XP (auto)
        building_xp.json     - BBP patch                         (sec. 8)
        keycard_xp.json      - DNA Keycards patch                (sec. 8)
        market_levels.json   - Expansion Market patch            (sec. 8)
        quest_xp.json        - Expansion Quests patch            (sec. 8)


========================================================================
  6) settings.json  (main configuration)
========================================================================

  {
    "BaseXp": 1000.0,              // XP needed for level 1->2
    "StepXp": 250.0,              // extra XP added each following level
    "TickSeconds": 5.0,           // server tick interval (survive/boost)
    "AutoSaveEveryTicks": 12,     // save player data every N ticks
    "EnableLogs": 1,              // 1 = console logs, 0 = off

    "KillInfectedXp": 10.0,       // XP per infected kill
    "KillAnimalXp": 15.0,         // XP per animal kill
    "KillPlayerXp": 50.0,         // XP per player kill
    "SurviveXpPerTick": 5.0,      // XP per survival tick
    "ActionXp": 2.0,              // XP per action

    "GrantSkillPointsEnabled": 0, // 1 = give skill points on level up
    "SurviveXpEnabled": 1,        // 1 = enable survival XP
    "GlobalXpMultiplier": 1.0,    // multiplies ALL XP (e.g. 2.0 = double)
    "ShowXpGainFlash": 1,         // 1 = show +XP flash on screen

    "BoostMultiplier": 2.0,       // XP Booster multiplier
    "BoostHours1": 1.0,           // D7_XPBooster_I  duration (hours)
    "BoostHours2": 2.0,           // D7_XPBooster_II duration (hours)
    "BoostHours3": 3.0            // D7_XPBooster_III duration (hours)
  }


  levels.json  (XP per level + rewards)
  -------------------------------------
  A list of level entries. Each entry:

    {
      "Level": 2,               // the level this entry describes
      "XpToNext": 1250,         // XP required to reach the NEXT level
      "grantsSkillPoint": 0,    // skill points given (Needs D7 Skills Ststem ! )
      "Rewards": [              // items given when the player REACHES
        { "ClassName": "M4A1", "Amount": 1 },
        { "ClassName": "D7_XPBooster_II", "Amount": 1 }
      ]
    }

  IMPORTANT — rewards are given when a player LEVELS UP TO that level.
  Players START at level 1, so put rewards on level 2 and above.
  A reward placed on level 1 is never given and never shown.
  Use exact, valid classnames (case-sensitive).


========================================================================
  7) LIVE ADMIN (no restart needed)
========================================================================

  Create these files in  <server profile>\D7\D7_Leveling\ :

    reload.txt      - (empty file) reloads settings.json / levels.json
                      and all patch configs live. Deleted after applying.

    setlevel.txt    - set a player's level. One line per player:
                          <SteamID> <level>
                      example:
                          76561198000000000 25
                      Deleted after applying.

  You can also edit a player's players\<id>.json Level directly; the
  server polls and applies the change.


========================================================================
  8) OPTIONAL PATCHES
========================================================================

  Each patch is a SEPARATE, server-side addon. Install ONLY the ones
  whose required mod you already run.

  TO INSTALL A PATCH: place its (PBO) into your
        DayZServer\addons
  folder. It loads server-side — players do NOT need it and you do NOT
  add it to the -mod line. Each patch still requires @D7_Core and
  @D7_Leveling to be running.

  ----------------------------------------------------------------------
  @D7_Leveling_SkillBridge   (D7 Skills System)
  ----------------------------------------------------------------------
    Grants SKILL POINTS to the player when they LEVEL UP, feeding them
    straight into the D7 Skills System wallet.
      - Set "grantsSkillPoint" on each level entry in levels.json to the
        number of skill points that level should award (section 6).
      - Turn on "GrantSkillPointsEnabled": 1 in settings.json.
    No extra config file — it uses your existing levels.json.
    Requires : D7 Skills System (the D7_SKILLS mod)
    Note     : install this ONLY if you run the D7 Skills System mod.
               The reverse feature — LOCKING skill trees behind a level —
               is a separate "Leveling Gate" patch that ships with the
               D7 SKILLS package, not here.

  ----------------------------------------------------------------------
  @D7_Leveling_BBP        (BaseBuildingPlus)
  ----------------------------------------------------------------------
    Gives XP when a player builds/upgrades a BBP base part.
    Requires : BaseBuildingPlus
    Config   : building_xp.json
                 { "BuildXp": 50 }        // XP per build step

  ----------------------------------------------------------------------
  @D7_Leveling_DNAKeycards   (DNA Keycards)
  ----------------------------------------------------------------------
    Gives XP when a player returns/uses a DNA keycard lockout.
    Requires : DNA_Keycards_Objects_Lockouts
    Config   : keycard_xp.json
                 { "KeycardXp": 100 }     // XP per keycard

  ----------------------------------------------------------------------
  @D7_Leveling_ExpansionMarket   (Expansion Market)
  ----------------------------------------------------------------------
    Locks traders behind a required level (player is blocked from using
    a trader until they reach the level).
    Requires : DayZExpansion_Market_Scripts  (+ CF)
    Config   : market_levels.json
                 {
                   "Traders": [
                     { "Trader": "TraderDisplayName", "RequiredLevel": 10 }
                   ]
                 }
                 // "Trader" = the trader's DisplayName in Expansion.
                 // RequiredLevel 0 = no restriction.

  ----------------------------------------------------------------------
  @D7_Leveling_ExpansionQuests   (Expansion Quests)
  ----------------------------------------------------------------------
    Gives XP when a player completes an Expansion quest.
    Requires : DayZExpansion_Quests_Scripts  (+ CF)
    Config   : quest_xp.json
                 {
                   "Quests": [
                     { "QuestID": 1, "Xp": 500 }
                   ]
                 }
                 // QuestID = the Expansion quest ID. Add one entry
                 // per quest you want to reward.


========================================================================
  9) LICENSE
========================================================================

  D7_Leveling is protected by D7_Core. It only works on servers whose
  license includes "D7_Leveling". Without a valid license the mod loads
  but grants no XP, levels, or rewards.

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

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