client/addons/admin/README.md
Jacob Schmidt 9936d6ddc3
All checks were successful
Build / Build (push) Successful in 28s
feat: Enhance module documentation and features
This commit updates the documentation for several Forge modules, adding comprehensive details about their functionalities, user interfaces, and integration with other systems. Key enhancements include:

- Expanded descriptions for the Admin, Arsenal, Bank, Garage, Interaction, Locker, Medical, Organization, Service, Store, and other modules.
- Added new features such as financial operations, user interface improvements, and integration with organization systems.
- Improved clarity on usage instructions and configuration options across modules.

These changes aim to provide better guidance for users and developers interacting with the Forge client system.
2025-05-25 16:03:03 -05:00

103 lines
3.1 KiB
Markdown

# Forge Admin Module
## Overview
The Admin module provides comprehensive administrative functionality for the Forge client system. It includes features for user management, financial operations, messaging, and administrative controls through both traditional and web-based interfaces.
## 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**
- **Traditional UI** (`fnc_openAdmin.sqf`)
- Opens the administrative user interface
- Provides access to administrative controls
- **Web-based UI** (`RscWebAdmin.hpp`)
- Modern web interface for administrative tasks
- Real-time player statistics and management
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. **Financial Operations**
- **Payday System**
- Distributes funds based on player ranks
- Configurable paygrade amounts
- **Money Management**
- Advance funds to players
- Deduct funds from players
- Global money distribution
- Company account balance tracking
5. **Communication**
- **Admin Messages** (`fnc_adminMessage.sqf`)
- Handles administrative messaging system
- **Broadcast System**
- Send messages to all players
- Targeted player messaging
### User Interface Components
1. **Traditional UI** (`RscAdmin.hpp`)
- Player list management
- Rank selection and promotion
- Financial operations
- Messaging system
2. **Web Interface** (`ui/_site/`)
- Modern, responsive design
- Real-time statistics
- Player management
- Financial operations
- Messaging system
## 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 either:
- Traditional UI: Use the provided dialog interface
- Web Interface: Access through the modern web-based panel
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.
## Security
The module includes built-in security features:
- Admin authentication
- Permission-based access control
- Secure financial transactions
- Protected administrative functions
## Technical Details
- Supports both traditional Arma 3 UI and modern web interface
- Real-time data updates
- Configurable paygrade system
- Comprehensive player management
- Secure financial operations