AlfaShotTracker

Мод AlfaShotTracker для DayZ (дейз). Установлен на 1 серверах RiseOfServers. Ниже: серверы с модом и описание Workshop.

Мод AlfaShotTracker для DayZ (дейз). Установлен на 1 серверах RiseOfServers. Ниже: серверы с модом и описание Workshop.

https://discord.gg/Ju3Kcb6Nct

# 🎯 Alfa Shot Tracker v1.0.7

## 🔫 Advanced Shot, Hit & Kill Tracking System for DayZ

**Alfa Shot Tracker** is an advanced combat logging and analysis mod designed for DayZ server administrators.

The system automatically records player hits, kills, and detailed combat information, including player names, weapons, ammunition, damage values, distances, and combat locations.

The built-in administration interface allows authorized administrators to review combat history and visualize shot locations on the map.

**Version 1.0.7 introduces DayZ 1.30 compatibility fixes and automatic map detection!**

## 🆕 What's New – v1.0.7

### 🗺️ Automatic Map Detection

- ✅ Automatically detects the current world.
- ✅ Displays the map immediately when the admin menu opens.
- ✅ No need to select a shot before the map becomes visible.
- ✅ Supports common custom map texture paths.
- ✅ Custom map image paths can be configured manually.
- ✅ The server sends the resolved map image path to the client.

### 🛠️ DayZ 1.30 Compatibility Fixes

- Fixed the in-game admin panel layout.
- Replaced outdated GUI layout positioning fields.
- Corrected the panel rendering order.
- Initialized the MapWidget when opening the admin menu.
- Verified admin authorization and combat history requests on a local DayZ 1.30 server.

## ⚙️ Main Features

- 🔫 **FIRE Logging:** Optional shot event logging.
- 🎯 **HIT Tracking:** Automatic hit event recording.
- ☠️ **KILL Tracking:** Records fatal hits and kills.
- 🕒 **Accurate Timestamps:** Full date and time for combat events.
- 👤 **Player Identification:** Shooter and target information.
- 🔫 **Weapon Information:** Weapon and ammunition tracking.
- 📏 **Shot Distance:** Records engagement distances.
- 🩸 **Damage Details:** Health, Shock, and Blood Damage values.
- 🎯 **Hit Zones:** Records relevant body parts and damage zones.
- 🗺️ **Map Visualization:** Shot origins and hit positions.
- 🔎 **Combat History:** Review previously recorded events.
- 📋 **Admin Interface:** Permission-controlled administration panel.
- 💾 **CSV & JSONL Logging:** Detailed server-side combat logs.
- 📂 **Per-Player Logs:** Individual player log files.
- 🛡️ **Configurable Authorization:** Steam64 ID-based administrator access.

**HIT and KILL logging are enabled by default. FIRE and IMPACT logging can be enabled separately.**

## 🗺️ Supported Maps

Version 1.0.7 includes automatic map image resolution for:

- 🌲 Chernarus
- 🌳 Livonia (Enoch)
- ❄️ Sakhal
- 🏜️ Nasdara
- 🌍 Custom maps using common map texture paths

**Important:** Namalsk is not included in the built-in automatic map image support. A custom map image override may be required.

### ⚙️ Custom Map Configuration

If a custom map image cannot be detected automatically, configure it in `Settings.json`:

```json
"MapImageOverrides": [
{
"WorldName": "MyCustomWorld",
"ImagePath": "MyCustomMap/worlds/mycustomworld/data/map_unfolded_mycustomworld_co.paa"
}
]
```

The example path is a placeholder. Replace it with the actual world name and map texture path.

## 🔐 Administrator Access Configuration

**IMPORTANT! Administrator permissions must be configured to access the admin interface!**

### 📂 Configuration File Location

`$profile:AlfaShotTracker/Settings.json`

The `$profile` location is determined by your server's startup parameters.

### 🛠️ How to Add Steam64 IDs

1. Install the mod and start your server.
2. Open `AlfaShotTracker/Settings.json`.
3. Locate the `AdminIds` field.
4. Add the administrators' 17-digit Steam64 IDs.
5. Save the configuration file.
6. Restart the server.

### 📝 Example – Multiple Administrators

```json
"AdminIds": [
"76561198000000000",
"76561198000000001"
],
"AdminNames": []
```

**Important:**

- Replace the example IDs with the actual Steam64 IDs.
- Multiple administrators can be configured.
- The `AdminNames` field also grants access based on player names. For stronger access control, keep it empty and use Steam64 IDs.
- Preserve all other configuration settings.

## 🖥️ Using the Admin Panel

Authorized administrators can access the interface directly in-game.

- Open the menu using the numeric keypad minus key (NumPad Minus).
- The server validates administrator access.
- The map appears automatically when the panel opens.
- Review recorded combat events.
- Inspect shot and hit positions on the map.
- Close the interface using `ESC`.

## 💾 Combat Logging & Configuration

Server logging directory:

`$profile:AlfaShotTracker/Logs/`

Supported configuration options include:

- CSV and JSONL combat logs.
- Global and per-player log files.
- Daily log file generation.
- Configurable log retention.
- Configurable shot, hit, and kill logging.
- Adjustable admin combat history limits.

## 🛠️ Server Installation

1. Subscribe to Alfa Shot Tracker on Steam Workshop.
2. Install the mod on your server and clients.
3. Add the mod to your launch parameters:

`@AlfaShotTracker`

4. Copy `AlfaShotTracker_MapFix2.bikey` into your server's `keys` directory.
5. Start your server.
6. Configure administrator Steam64 IDs.
7. Restart the server.

## ℹ️ Important Information

- Does not modify weapon damage.
- Does not alter player statistics.
- Combat events are logged server-side.
- The administration interface requires the client-side mod.
- Configuration settings can be modified through `Settings.json`.

## 👨‍💻 Mod Information

**Mod Name:** Alfa Shot Tracker

**Version:** 1.0.7

**DayZ:** 1.30

**Developer:** AlfaParty

## 💬 Discord – Support, Bug Reports & Updates

Found a bug? Map not displaying correctly? Need assistance with administrator configuration?

Join our Discord community!

**Thank you for using Alfa Shot Tracker!**

Источник: Steam Workshop