# d4rk_divegear

Tauchausrüstung für QBox. Fork von [qbx_divegear](https://github.com/Qbox-project/qbx_divegear)
mit Flaschengrößen, gesyncter Lampe, Tiefen- und Druckanzeige — und Ausrüstung,
die bei Animationen nicht mehr verschwindet.

![HUD](docs/hud-normal.svg?v=konsole)

## Features

- **Fünf Flaschen** — 5, 10, 15, 20 Minuten Pressluft plus Trimix. Die Restluft
  liegt in der Item-Metadata und überlebt Ablegen, Relog, Restart und Tod.
- **Tauchkonsole als HUD** — Finimeter, Restluft und Tiefenmesser mit Zeigern und
  farbigen Gefahrenbereichen. Skaliert mit der Bildschirmauflösung.
- **Gesyncte Tauchlampe** über die spieleigene Scuba-Lampe.
- **Tiefengrenze übers Atemgas** — mit Pressluft ab 45 m Tiefenrausch, mit Trimix
  erst ab 100 m. Macht ein Tiefenlimit mechanisch statt zur Absprache.
- **Ausrüstung bleibt dran** — bei Emotes, Ragdoll, Kleiderwechsel und
  aufräumenden Fremd-Scripts.
- **Serverseitige Prüfung** — die Restluft kann nur sinken, und nicht schneller
  als physikalisch möglich.

## Abhängigkeiten

[`qbx_core`](https://github.com/Qbox-project/qbx_core) ·
[`ox_lib`](https://github.com/overextended/ox_lib) ·
[`ox_inventory`](https://github.com/overextended/ox_inventory)

## Installation

1. `ensure d4rk_divegear` in der `server.cfg`, **nach** `ox_inventory` und `qbx_core`
2. [`items_for_ox_inventory.lua`](items_for_ox_inventory.lua) in
   `ox_inventory/data/items.lua` einfügen
3. Die sieben PNGs aus [`icons/`](icons) aufs Icon-CDN hochladen

Ausführlich, inklusive der beiden häufigsten Stolpersteine:
**[Wiki → Installation](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Installation)**

## Dokumentation

Alles Weitere steht im
**[Wiki](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki)**:

[Items](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Items) ·
[Bedienung](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Bedienung) ·
[Konfiguration](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Konfiguration) ·
[Tiefe und Atemgas](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Tiefe-und-Atemgas) ·
[Lampe](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Lampe) ·
[Exports](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Exports) ·
[Entwicklung](https://git.d4rkst3r.de/D4rkst3r/d4rk_divegear/wiki/Entwicklung)

Warum die Dinge so gebaut sind und welche Fallstricke dahinterstecken, steht
code-nah hier im Repo: [ENTSCHEIDUNGEN.md](ENTSCHEIDUNGEN.md).

## Lizenz

GPL-3.0, wie das Original. Die Upstream-Historie ist erhalten und liegt auf dem
Remote `upstream`.