# Client Main Usage Guide - forge-docus
The client main addon provides the shared mod identity, version metadata, CBA settings, and macro foundation used by the Forge client addons.

Client Addons

# Client Main Usage Guide

The client main addon provides the shared mod identity, version metadata, CBA settings, and macro foundation used by the Forge client addons.

# Client Main Usage Guide

The client `main` addon provides the shared mod identity, version metadata, CBA settings, and macro foundation used by the Forge client addons.

## Purpose

Use `forge_client_main` as the foundation dependency for client addons that need Forge macros, function naming, settings, or mod-level configuration.

Feature logic should stay in the owning addon. `main` should remain limited to shared client configuration and compile infrastructure.

## Key Files

File | Purpose
--- | ---
`script_mod.hpp` | Client mod identity.
`script_version.hpp` | Client mod version values.
`script_macros.hpp` | Shared client macros.
`CfgSettings.hpp` | Client CBA settings.
`config.cpp` | Addon config and mod wiring.

## Dependency Pattern

Feature addons normally depend on `forge_client_main` in their `config.cpp`.

    class forge_client_example {
        requiredAddons[] = {
            "forge_client_main"
        };
    };

## Usage Notes

- Put domain UI, repositories, and event handling in feature addons.
- Put reusable browser bridge behavior in `forge_client_common`.
- Put server-only behavior in `arma/server/addons`.
- Keep settings in `CfgSettings.hpp` when they apply to the client mod as a whole or to a client feature toggle.

## Related Guides

- Client Usage Guide
- Client Common Usage Guide
- Development Guide

Edit this page or Report an issue

Client Usage Guide

Forge Client contains the Arma client-side addons that open player interfaces, handle browser events, cache client-visible state, and forward authoritative requests to the server addons.

Client Phone Usage Guide

The client phone addon provides the in-game phone UI for contacts, SMS messages, email, and local utility apps such as notes, calendar events, world clocks, and alarms.