CZ Underground Bases 2.0

Welcome to CZ Basements!

Do you get use out of my mods? They take a lot of work to make, if you do please consider donating at ko-fi.com/BigWaterSurvivor to help me fund future updates and projects!

Please remmeber to give the mod a good rating if you like it, the ratings help spread the mod to more server owners.

This mod unlocks personal, passcode protected basements in 2 sizes for your DayZ Server!

Players will be able to enter their own basements, or enter another players basement if they know the passcode.

Features

- Player can use a keycard to create a basement - Other players can enter another basement if they know the PIN Code set by owner. - Players can delete, rename or change PIN on basement at any time - Admins can delete any basement at any time (player teleported to ground on re-log if they were inside.) - Admin can control what options are available with and without a keycard.

Improvements in version 2.0:

- This is a massive update to the original basements and is re-built from the ground up! - There is a new manage basements UI menu re-written from the old version. - Players will now be teleported safely to the last spot they entered the basement if the basement is deleted when they are offline due to inactivity. - Players will no longer die if they jump whilst exiting a basement - Brand new large basement model with a seperate keycard to unlock it. - Basement codes can now be 4 or 6 digits instead of been forced into 4 digit passcodes. - Player databases now track player entry location in server, instead of been teleported to same place regardless of entry location. - Better client to server & server to client communications. - Option to force player to require a keycard to enter or manage a basement. - Option to damage keycard by a configurable amount when it is used. - Custom UI when approaching door to exit basement. - GUI notification will show if a player tries to use a ruined keycard to enter a bsement (if require keycard option is on in config)

Installation:

1. Subscribe to the mod. 2. Copy the mod folder from your workshop directory to your server. 3. Copy the key to your server. 4. Add mod to your servers batch file. 5. Launch the game to generate config files. 6. Modify settings to your likings and reboot the server.

Known Issues

No current known issues, if you find any, please report them in Discord.

Configuration

Learn how to configure this mod with these tutorial videos: https://www.youtube.com/watch?v=DpqGeUOVI8A https://www.youtube.com/watch?v=qCRkO944zOo&t=1s

Note: This mod requires config changes to work, it is not plug & play - although it is simple to setup.

This mod will generate a config file under the servers profile folder (profiles/CZ Mods/CZ Underground Bases 2.0)

You can place the basement entrances using either the config file with coordinates, or you can place them with the DayZ Editor.

*Important* - You may need to change the rules for object placement in CFGGameplay file to place items inside the bunker, without these changes it may only allow you to drop objects instead of place them.

JSON Settings - BasementSettings.json

basementCenterAreaPosition - You may need to change the 2nd value which is the height of the basement to match server requirements (1000-5000)

basementCenterAreaRadius - there is generally no need to change this.

basementCleanupAfterInactiveDays - this controls how long a player will keep basement if they never enter it in days.

smallBasementClassName - this is the class name for the item that unlocks small basements, most users will leave this as it is.

largeBasementClassName - this is the class name for the item that unlocks large basements, most users will leave this as it is.

keyRequiredToEnterBasementEachTime - 0 for off, 1 for on. Controls if the user MUST have a key in their hand to enter a basement.

damageKeyOnUse - 0 for off, 1 for on. If this is on the key object will be damaged by the percentage set in this file.

damagePercentOnUse - This is the amount of damage the key will get for each use if the option above is enabled. In percentage 0-100

playerLosesKeyOnUse - 0 for off, 1 for on. If this is on, each use of the keycard the player will lose the item entirely, cannot be used with damageKey option.

keyRequiredToManageBasement - 0 for off, 1 for on. If this is on the player must have a key in hand to change basement name, change PIN or delete basement.

JSON Settings - AdminSettings.json

This file is simple, it takes your steam ID and for all people that have steam ID listed in this file will have access to the Basement Admin menu using the keybind set within the game, the keybind will not work unless your steam ID is in this file.

JSON Settings - DoorLocations.json

This file controls where doors are placed, if you prefer you can just place them using DayZ Editor, but please do not spawn them in with COT, VPP Admin Tools etc. You can however use the object builder function in VPP Admin tools to place them if you wish.

ClassName - this is the actual object, do not change this, it will break the mod. Position - the world position to place the door when the server starts.

Remember to include commas between each new record here, just copy and paste, but the last record MUST NOT have a comma.

Hope these instructions were helpful.

Credits:

- h4rp1xd for the Large Basement Model & Bookshelves. - Nikita Blite for assisting with textures for large basement https://steamcommunity.com/id/nikitablite/ - Colleague of Nikita Blite for assisting with textures for large basement https://steamcommunity.com/profiles/76561198407751342/ - The Reagent PvE server for their assistance with texturing for large basement.

Legal