client/addons/admin/README.md
Jacob Schmidt 21beefe668 feat: Enhance documentation and update variable names
This commit introduces several enhancements to the Forge client, including improved documentation for the Garage and Locker modules, updates to variable names for consistency, and additions to the .gitignore file.

The following changes were made:

- **Garage and Locker Modules:** Added comprehensive README.md files to the Garage and Locker modules, providing overviews, dependency information, author details, feature descriptions, event handler usage, debugging instructions, and version information.
- **Variable Name Consistency:** Updated variable names in `fnc_playerDBSave.sqf` and `fnc_firstLogin.sqf` to use the `FORGE_PayGrade` constant instead of `Paygrade` for consistency with the Forge naming conventions.
- **.gitignore:** Added `/api` to the .gitignore file to exclude the Forge API directory from version control.
2025-04-05 16:51:53 -05:00

63 lines
1.9 KiB
Markdown

# Forge Admin Module
## Overview
The Admin module provides administrative functionality for the Forge client system. It includes features for user management, messaging, and administrative controls.
## Dependencies
- forge_client_main
## Authors
- J. Schmidt
- Creedcoder
- IDSolutions
## Features
### Administrative Functions
1. **Admin Initialization** (`fnc_initAdmin.sqf`)
- Initializes the admin system
- Sets up necessary permissions and configurations
2. **Admin Interface** (`fnc_openAdmin.sqf`)
- Opens the administrative user interface
- Provides access to administrative controls
3. **User Management**
- **Promotion** (`fnc_adminPromote.sqf`)
- Handles user promotion to administrative roles
- **Transfer** (`fnc_adminTransfer.sqf`)
- Manages administrative role transfers
- **Refresh** (`fnc_adminRefresh.sqf`)
- Updates administrative permissions and states
4. **Communication**
- **Admin Messages** (`fnc_adminMessage.sqf`)
- Handles administrative messaging system
### User Interface
The module includes two main UI components:
1. **RscCommon.hpp**
- Common UI elements and definitions
2. **RscAdmin.hpp**
- Administrative interface specific elements
## Event Handlers
The module uses several event handlers for initialization and execution:
- `XEH_preInit.sqf`: Pre-initialization setup
- `XEH_postInit.sqf`: Post-initialization tasks
- `XEH_preStart.sqf`: Pre-start configuration
## Usage
To use the admin module:
1. Ensure the module is properly loaded in your mission
2. Access administrative functions through the provided UI
3. Use appropriate administrative commands based on your role
## Debugging
Debug mode can be enabled by uncommenting the following in `script_component.hpp`:
```cpp
#define DEBUG_MODE_FULL
```
## Version Information
Version information is managed through the main Forge client system configuration.