# YAInteraction

A DayZ server mod that adds interactable furniture (search for loot) and a
two-stage repairable sink (repair, then gather water).

> **Requires [@YAProxy](http://192.168.88.23/edvinas/YAProxy)** — the furniture
> are proxies baked into house models, not entities. @YAProxy handles proxy
> detection + position sync; YAInteraction's actions extend `YAProxyActionBase`.
> Load `@YAProxy` before `@YAInteraction` (handled via `requiredAddons`).

## Features

- **Searchable furniture** — medical cabinet and fridge yield random items from
  weighted, config-defined loot tables. Per-object cooldown.
- **Repairable sink** — repair with a `Wrench`/`PipeWrench`, then gather water
  into a held container. Per-player cooldown, configurable amount.
- **JSON-configured** — interactables, loot tables and scalar tunables live in
  JSON under `<ProfileFolder>/YAInteraction/`. Defaults are written on first
  start and read (overriding defaults) on every start after. No target/loot
  classnames exist anywhere else in the codebase.

## Target objects

Entries are matched by name as a substring, against **either**:
- a **house proxy** name (furniture baked into a building) via @YAProxy, **or**
- a **standalone entity** classname (objects spawned in the world via init.c /
  CE), targeted directly — no proxy needed.

| Name | Action | Loot table | Notes |
|------|--------|-----------|-------|
| `case_sink_a` | Repair → Gather Water | — | house proxy |
| `lekarnicka` | Search | MedTable | house proxy |
| `fridge` | Search | FoodTable | house proxy or standalone |
| `vending_machine` | Search | VendingTable | **standalone only** |

> House-baked vending **proxies** can't be detected (the engine exposes no
> targetable object), but a vending machine **spawned standalone** (e.g.
> `CreateObjectEx("StaticObj_Furniture_vending_machine", …)` in init.c) is a real
> entity and works. The same applies to any spawned object: add its classname (or
> a substring) to the registry as a `search` entry to make it lootable.

## Configuration files

Generated on first start under `<ProfileFolder>/YAInteraction/`:

- **`settings.json`** — scalar tunables: `WaterAmountMin`, `WaterAmountMax`,
  `SinkPlayerCooldownSec`, `ObjectCooldownSec`.
- **`interactables.json`** — the `Interactables` registry and all `LootTables`.
  Each search entry has `SearchChance` (% chance a search yields anything),
  `SearchMin`/`SearchMax` (item count on a successful search), `CooldownSec`,
  and a `LootTableName`.

Delete a file and restart to regenerate it from code defaults.

## Structure

```
config.cpp / mod.cpp          mod + script-module registration, metadata
scripts/3_Game                shared game-layer placeholder (v2 hooks)
scripts/4_World/YAInteraction
  Config/YAInteractionSettings.c     serializable scalar settings (settings.json)
  Config/YAInteractionData.c         serializable registry + loot tables (interactables.json)
  Config/YAInteractionConfigLoader.c JSON load/save + code defaults (singleton)
  Config/YAInteractionConfig.c       compile-time constants only
  YALootTableManager.c               weighted pick + item spawning
  Entities/YAInteractionManager.c    registry lookup + repair state
  Actions/                           Search / RepairSink / GatherWater actions
  YAInteractionInit.c                modded BuildingBase action injection
scripts/5_Mission/YAInteraction
  YAInteractionMissionInit.c         modded MissionServer.OnInit -> load config
```

## Notes

- Config is loaded server-side at `MissionServer.OnInit` (before any player
  connects). Clients fall back to in-code defaults for action injection.
- Cooldowns and sink repair state are tracked in memory and **reset on server
  restart**. CF persistence hooks are marked with `// TODO (v2)`.
- All item and tool classnames are verified against the base game data.

## Adding a new interactable

Edit `interactables.json` (add to `Interactables`, and a `LootTables` entry if
it searches), then restart. To change the built-in defaults, add one line to
`BuildDefaultData()` in `YAInteractionConfigLoader.c`:

```c
d.Interactables.Insert(MakeEntry("Your_Classname", YAInteractionConfig.ACTION_SEARCH, YAInteractionConfig.TABLE_FOOD, Settings.ObjectCooldownSec));
```