# villagernews/villager-news-addon architecture

> Architecture diagram of the GitHub repository villagernews/villager-news-addon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/villagernews/villager-news-addon
- Repository: https://github.com/villagernews/villager-news-addon

## Overview

Villager News Addon is a Bedrock add-on centered on enabling a pack in a world and providing villager voices, reactions, and gossip/reputation; Java support is presented as notes rather than the Marketplace pack. The tree and excerpts identify pack, mob, voice, and Java responsibilities, but do not expose runtime calls or configuration wiring. Edges therefore show only documented usage and capability relationships, not an inferred internal execution pipeline.

Main entry points: [`mob/Villager.cpp`](https://github.com/villagernews/villager-news-addon/blob/main/mob/Villager.cpp) (Villager Reactions), [`java/Java.cpp`](https://github.com/villagernews/villager-news-addon/blob/main/java/Java.cpp) (Java Notes), [`pack/Addon.cpp`](https://github.com/villagernews/villager-news-addon/blob/main/pack/Addon.cpp) (Bedrock Add-on), [`pack/Enable.cpp`](https://github.com/villagernews/villager-news-addon/blob/main/pack/Enable.cpp) (Pack Toggle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pack["Bedrock Pack"]
  node_addon["Bedrock Add-on<br/>[Addon.cpp]"]
  node_enable["Pack Toggle<br/>[Enable.cpp]"]
  node_manifest["Pack Manifest<br/>[Manifest.h]"]
end

subgraph group_mob["Villager Behavior"]
  node_villager["Villager Reactions<br/>[Villager.cpp]"]
  node_actions["Action Compatibility<br/>[React.cpp]"]
  node_trade["Trade Hook<br/>[Trade.h]"]
end

subgraph group_voice["Voice and Gossip"]
  node_lines["Voiced Reactions<br/>[Lines.cpp]"]
  node_gossip["Gossip Reputation<br/>[Gossip.cpp]"]
  node_lipsync["Lip Sync Marks<br/>[Lip.h]"]
end

subgraph group_java["Java Notes"]
  node_java["Java Notes<br/>[Java.cpp]"]
  node_fabric["Fabric Notes<br/>[Fabric.cpp]"]
  node_minecraft["Minecraft Version Gate<br/>[Mc.h]"]
  node_sounds["Java Sound Notes<br/>[Sounds.cpp]"]
end

node_player(("Player"))
node_world["Minecraft World"]

node_player -->|"enables"| node_addon
node_addon -->|"offers toggle"| node_enable
node_enable -->|"load enabled pack"| node_world
node_villager -.->|"has voiced reactions"| node_lines
node_villager -.->|"supports gossip"| node_gossip
node_villager -.->|"supports actions"| node_actions
node_villager -.->|"has trade hook"| node_trade
node_lines -.->|"lip-sync marks"| node_lipsync
node_player -->|"consults notes"| node_java
node_java -.->|"includes Fabric notes"| node_fabric
node_java -.->|"includes version gate"| node_minecraft
node_java -.->|"includes sound notes"| node_sounds

click node_addon "https://github.com/villagernews/villager-news-addon/blob/main/pack/Addon.cpp"
click node_enable "https://github.com/villagernews/villager-news-addon/blob/main/pack/Enable.cpp"
click node_manifest "https://github.com/villagernews/villager-news-addon/blob/main/pack/Manifest.h"
click node_villager "https://github.com/villagernews/villager-news-addon/blob/main/mob/Villager.cpp"
click node_actions "https://github.com/villagernews/villager-news-addon/blob/main/mob/React.cpp"
click node_trade "https://github.com/villagernews/villager-news-addon/blob/main/mob/Trade.h"
click node_lines "https://github.com/villagernews/villager-news-addon/blob/main/voice/Lines.cpp"
click node_gossip "https://github.com/villagernews/villager-news-addon/blob/main/voice/Gossip.cpp"
click node_lipsync "https://github.com/villagernews/villager-news-addon/blob/main/voice/Lip.h"
click node_java "https://github.com/villagernews/villager-news-addon/blob/main/java/Java.cpp"
click node_fabric "https://github.com/villagernews/villager-news-addon/blob/main/java/Fabric.cpp"
click node_minecraft "https://github.com/villagernews/villager-news-addon/blob/main/java/Mc.h"
click node_sounds "https://github.com/villagernews/villager-news-addon/blob/main/java/Sounds.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_addon,node_enable,node_manifest toneBlue
class node_villager,node_actions,node_trade toneAmber
class node_lines,node_gossip,node_lipsync toneMint
class node_java,node_fabric,node_minecraft,node_sounds toneRose
class node_player,node_world toneIndigo
```

## Components

### Bedrock Pack

- [Bedrock Add-on](https://github.com/villagernews/villager-news-addon/blob/main/pack/Addon.cpp): `pack/Addon.cpp`
- [Pack Toggle](https://github.com/villagernews/villager-news-addon/blob/main/pack/Enable.cpp): `pack/Enable.cpp`
- [Pack Manifest](https://github.com/villagernews/villager-news-addon/blob/main/pack/Manifest.h): `pack/Manifest.h`

### Villager Behavior

- [Villager Reactions](https://github.com/villagernews/villager-news-addon/blob/main/mob/Villager.cpp): `mob/Villager.cpp`
- [Action Compatibility](https://github.com/villagernews/villager-news-addon/blob/main/mob/React.cpp): `mob/React.cpp`
- [Trade Hook](https://github.com/villagernews/villager-news-addon/blob/main/mob/Trade.h): `mob/Trade.h`

### Voice and Gossip

- [Voiced Reactions](https://github.com/villagernews/villager-news-addon/blob/main/voice/Lines.cpp): `voice/Lines.cpp`
- [Gossip Reputation](https://github.com/villagernews/villager-news-addon/blob/main/voice/Gossip.cpp): `voice/Gossip.cpp`
- [Lip Sync Marks](https://github.com/villagernews/villager-news-addon/blob/main/voice/Lip.h): `voice/Lip.h`

### Java Notes

- [Java Notes](https://github.com/villagernews/villager-news-addon/blob/main/java/Java.cpp): `java/Java.cpp`
- [Fabric Notes](https://github.com/villagernews/villager-news-addon/blob/main/java/Fabric.cpp): `java/Fabric.cpp`
- [Minecraft Version Gate](https://github.com/villagernews/villager-news-addon/blob/main/java/Mc.h): `java/Mc.h`
- [Java Sound Notes](https://github.com/villagernews/villager-news-addon/blob/main/java/Sounds.cpp): `java/Sounds.cpp`

### Other components

- **Player**
- **Minecraft World**

## Connections

- Player → Bedrock Add-on: enables (evidence: `README.md`)
- Bedrock Add-on → Pack Toggle: offers toggle (evidence: `pack/Addon.cpp`)
- Pack Toggle → Minecraft World: load enabled pack (evidence: `README.md`)
- Villager Reactions → Voiced Reactions: has voiced reactions
- Villager Reactions → Gossip Reputation: supports gossip
- Villager Reactions → Action Compatibility: supports actions
- Villager Reactions → Trade Hook: has trade hook
- Voiced Reactions → Lip Sync Marks: lip-sync marks
- Player → Java Notes: consults notes (evidence: `README.md`)
- Java Notes → Fabric Notes: includes Fabric notes
- Java Notes → Minecraft Version Gate: includes version gate
- Java Notes → Java Sound Notes: includes sound notes
