# eXtended Persistent DB

![CoverImage](images/cover_image.jpg)

<p align="center">
	<a href="https://gitea.innovativedevsolutions.org/IDSolutions/xpdb/releases/latest" target="blank">
		<img src="https://img.shields.io/gitea/v/release/IDSolutions/xpdb?gitea_url=https%3A%2F%2Fgitea.innovativedevsolutions.org" alt="latest-release" /></a>
    <a href="https://gitea.innovativedevsolutions.org/IDSolutions/xpdb/issues" target="blank">
		<img src="https://img.shields.io/gitea/issues/open/IDSolutions/xpdb?gitea_url=https%3A%2F%2Fgitea.innovativedevsolutions.org" alt="open-issues" /></a>
	<a href="https://gitea.innovativedevsolutions.org/IDSolutions/xpdb/actions?workflow=build.yml" target="blank">
		<img src="https://gitea.innovativedevsolutions.org/IDSolutions/xpdb/actions/workflows/build.yml/badge.svg?branch=master" alt="build-status" /></a>
</p>

## Description

eXtended Persistent DB is the mod version of [Arma Persistent Core System](https://github.com/NikolaiF90/ArmaPersistentCoreSystem)

## Features

- Persist vehicle position, rotation, crew, turret and etc.
- Persist player units alongside team member.
- Persist environment information like overcast, date and time.
- Persist all map markers including player placed markers.
- Configure mod to save according to your preferences

## Installation

- Download the latest release from the [releases](https://github.com/jschmidt92/eXtendedPersistentDB/releases) page.
- Extract @xpdb from the zip file and paste it into your Arma 3 folder and activate it within the Arma 3 Launcher.

## Usage

- Open 3DEN Mission Editor.
- If you already have an init.sqf and an initPlayerLocal.sqf, paste the following into the init.sqf <br/> `Scenario_Name = "NameOfYourScenario";` and then `[] call xpdb_db_fnc_init;` into the initPlayerLocal.sqf.
- From here you are pretty much done. You don't need to edit anything else.
- Start the mission and use mouse scroll wheel to reveal the save action.
- If you want to implement your own save configuration check out the `missionTemplate` to see how it's done.

$${\color{red}Important: \space Please \space read \space this \space message \space carefully!}$$
<br/>_eXtended Persistent DB_ saves/loads everything via `hashMaps`, for more info on `hashMaps` check out the [BIS Wiki](https://community.bistudio.com/wiki/HashMap)

## Contributing

- Fork the repository.
- Create a branch for your changes.
- Create a pull request.

## License

[![License APL-SA](https://img.shields.io/badge/APL--SA-black?style=plastic)](https://www.bohemia.net/community/licenses/arma-public-license-share-alike)

With this license you are free to adapt (i.e. modify, rework or update) and share (i.e. copy, distribute or transmit) the material under the following conditions:

- Attribution - You must attribute the material in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the material).
- Noncommercial - You may not use this material for any commercial purposes.
- Arma Only - You may not convert or adapt this material to be used in other games than Arma.
- Share Alike - If you adapt, or build upon this material, you may distribute the resulting material only under the same license.

## Credits

- [NikolaiF90 (PrinceF90)](https://github.com/NikolaiF90)
- [Sukhoi191](https://gitlab.com/sukhoi191)
- [Jacob Schmidt](https://github.com/jschmidt92)
