DayZ Class-Selection

DayZ Class-Selection

This mod adds an Class-Selection Menu to the game, server-owners can customize the classes and the items available. (via JSON files) Each class can have many items to select from.

Features

• Players will receive a fully loaded and ready to shoot weapon.
• Players can choose from diffrent items in each class
• Players will respawn with the same class after death, but they can change it by pressing ","
• Players will be forced to select a class on first join
• Attachments already have batteries if needed
• Player will receive items from the GeneralItems.json regardless of their class
• Also each class can have many general items which the players receive
• Admins can define whitelist classes

________________________________________________________

Donations

If you want to donate me something for the work i put into this mod (80 hrs developing ~)

Important Updates:

03.08.2020 Fixed whiteList, added generalItems to each class, added container (e.g. FirstAidKit ...) support That will be the last update for a while, aside from bug fixes.

Added 2 options

  "overrideEquipCharacter": 1,
  "overrideStartingEquipSetup": 0,

which allow to disable the default override of StartingEquipSetup() EquipCharacter() added by this mod. Only use if you know what you are doing. Make sure GetClassSelection().GiveClassEquipment(m_player); only gets called once either by yourself or by default from this mod

________________________________________________________

Classes:

Make sure to use the -profiles startparameter for your server! (e.g. -profiles=configs)

Use the ClassDataExample.json as template and create your classes in the classes folder.

To give all players items regardless of their class use the GeneralItems.json in the ClassSelection folder.

Container

If you want to add items to a container use the cargo array!

{
            "name": "FirstAidKit",
            "cargo": [
                {
                    "name": "SalineBagIV",
                    "selected": 0,
                    "quantity": 0,
                    "attachments": [],
                    "cargo": [],
                    "magazines": []
                },
                {
                    "name": "Epinephrine",
                    "selected": 0,
                    "quantity": 0,
                    "attachments": [],
                    "cargo": [],
                    "magazines": []
                }
            ],
        }

Config:

Full example found here: https://github.com/d3xter-dev/dayz-class-selection/blob/master/Config.example.json

Disable kill on class select

To disable the instant kill add following to your Conifg.json file. [code] "giveWeaponsAfterDeath": 1, [/code]

Show menu only on respawn

To show the select menu only on respawn and let the user choose a new class each time add following to your Conifg.json file. [code]"showClassSelectOnRespawnOnly": 1,[/code]

Combination

If you modify the <player> node in __MISSION__\db\economy.xml to look like:

<player init="1" load="1" respawn="1" save="0"/>

You can achieve following:

• with showClassSelectOnRespawnOnly = 1 players will be forced to select the class each time they connect
• with showClassSelectOnRespawnOnly = 0 players will repsawn with the last class they chosen when they reconnect.

(Be sure to wipe the players.db if you try this otherwise it will always load the last saved player state)

Whitelist

To whitelist classes look in the Config.json -> whiteList

 "whiteList": {
        "SomeClassName": [
            "someSteamID64",
            "someSteamID64"
        ],
       "SomeOtherClassName": [
            "someSteamID64"
        ]
    }

Important!

(Following needed if you override the "EquipCharacter()" function in your CustomMission (init.c) or via. a modded MissionServer class.) Make sure that you call "GetClassSelection().GiveClassEquipment(m_player);" and don't clear player items after that call, for obvious reasons.

Mod Support

• ExpansionMod: add GetClassSelection().GiveClassEquipment(m_player); to the init.c StartingEquipSetup() function in @DayZ-Expansion\Missions\YOUR_MISSION\init.c (Crashes sometimes, idk if it's because of my mod)

Future-Development:

• Attachment selection Menu
• Clothing selection Menu

Please give me credits if you use / modify the sourcecode of my mod!

Also please consider making a mod for the mod, instead of repacking it!

You may report issues on github: https://github.com/d3xter-dev/dayz-class-selection