ZMN Bot Logo
    التوثيق

    ZMN Bot التوثيق

    أدلة الإعداد ومرجع الضبط لكل وحدات زمن — الحماية، الإشراف، الأدوار، المستويات، والتحكم بالوصول.

    تنقل سريع

    الأساسيات
    الوحدات

    مدير الرتب

    نظام إدارة رتب متقدم

    نظرة عامة

    نظام احترافي لإدارة الهيكل الوظيفي.

    مناسب لـ:

    • • سيرفرات الرول بلاي العسكرية
    • • عشائر الألعاب
    • • المنظمات الإدارية
    • • السيرفرات ذات الرتب التراتبية

    الميزات

    لوحات الرتب

    لوحات تفاعلية للرتب

    سلم الترقية

    تقدم رتبي تلقائي

    نظام التوظيف

    إدارة التوظيف

    نظام التحذيرات

    تحذيرات وتخفيض تلقائي

    التحكم بالصلاحيات

    صلاحيات مفصلة

    تسجيل الإجراءات

    سجل كامل للعمليات

    How It Works

    1Create a Panel

    Set up a panel with a name, description, and configure log channels for different action types (promotions, demotions, role sets).

    2Define Role Hierarchies

    Create role maps for recruit roles, promotion ladder, additional roles, warning roles, and termination roles. Drag and drop to set hierarchy order.

    3Assign Managers

    Specify which roles can perform each action type. Different roles can manage recruitment, promotions, demotions, warnings, and terminations.

    4Use Commands

    Staff members use /panels to view available panels and perform actions on members.

    Panel Configuration

    Basic Settings

    Panel Name

    text

    Unique name for this role panel

    Panel Description

    text

    Description of what this panel manages

    Log Channels

    Promotions Log Channel

    channel

    Channel for logging promotion actions

    Demotions Log Channel

    channel

    Channel for logging demotion actions

    Role Set Log Channel

    channel

    Channel for logging recruit, set, warning, and terminate actions

    Action Types

    Recruit

    Adds all configured recruit roles to a new member. Marks them as recruited in the system.

    Requirement: None (first action for new members)

    Promotion

    Moves member up the promotion ladder by one step. Removes previous promotion role and adds next role.

    Requirement: Must be recruited

    Demotion

    Moves member down the promotion ladder by one step. Removes current role and adds previous role.

    Requirement: Must be recruited

    Set (Additional Roles)

    Toggle additional roles that don't affect promotion ladder. Opens a dropdown to select roles.

    Requirement: Must be recruited

    Warning

    Adds progressive warning roles. At max warnings, automatically demotes one step and clears warnings.

    Requirement: Must be recruited

    Terminate

    Removes all panel roles and adds termination roles. Removes member from recruited list.

    Requirement: Must be recruited

    Role Maps

    Role maps define the hierarchy and available roles for each action type. Roles are ordered by hierarchy (drag to reorder).

    Recruit Roles

    Roles automatically assigned when recruiting a new member. All roles in this list are added at once.

    Promotion Roles (Ladder)

    Ordered list of promotion roles. Members progress through this ladder one step at a time.

    Example: Cadet → Officer → Lieutenant → Captain → Major

    Additional Roles (Non-Promotion)

    Roles that can be toggled independently without affecting promotion ladder. Used for specializations, departments, or certifications.

    Warning Roles

    Progressive warning roles. Each warning adds the next role in the list.

    Auto-Demotion: When max warnings reached, member is demoted one step and all warnings are cleared.

    Terminate Roles

    Roles assigned when terminating a member. All other panel roles are removed.

    Manager Permissions

    Control who can perform each action type by assigning manager roles. Members with these roles can execute the corresponding actions.

    Recruit ManagersCan recruit new members
    Promotion ManagersCan promote members
    Demotion ManagersCan demote members
    Additional ManagersCan toggle additional roles
    Warning ManagersCan issue warnings
    Terminate ManagersCan terminate members
    Global manager roles (set in main module settings) can perform all actions on all panels, bypassing per-panel permissions.

    Using the System

    Step 1: View Available Panels

    discord
    /panels

    Lists all configured panels with their descriptions. Shows "Start" buttons for each panel.

    Step 2: Select Action

    Click the "Start" button for a panel to see available actions:

    RecruitPromotionDemotionSetWarningTerminate

    Step 3: Target Member

    After selecting an action, send a message mentioning the target member or containing their user ID:

    discord
    @Username

    Or paste their ID: 123456789012345678

    Step 4: Confirmation

    The bot will apply the role changes and send a confirmation message with details about what was added/removed.

    Commands Configuration

    The Roles Manager includes two configurable commands with granular permissions:

    /helpConfigurable

    Shows bot help and Roles Manager status, including enabled panels.

    Configure: Enabled/disabled roles, enabled/disabled channels, auto-delete options
    /panelsConfigurable

    Lists all configured panels and allows starting actions.

    Configure: Enabled/disabled roles, enabled/disabled channels, auto-delete options
    Each command can be restricted to specific roles or channels, and you can enable auto-deletion of command messages or bot replies.

    Session System

    The Roles Manager uses a session-based system for action execution:

    30-Second Window: After selecting an action, you have 30 seconds to send a message with the target member. Sessions are per-user, per-channel, so multiple staff can work simultaneously in different channels.

    Logging

    All role changes are logged with detailed information:

    Log Information Includes:

    • • Action type (recruit, promotion, demotion, etc.)
    • • Panel name
    • • Executor (who performed the action)
    • • Target member
    • • Roles added
    • • Roles removed
    • • Timestamp

    Logs are sent to the configured log channels (promotions, demotions, or role set channels) based on the action type.

    Best Practices

    ✓ Do

    • • Set up separate log channels for different action types
    • • Use descriptive panel names and descriptions
    • • Order promotion roles from lowest to highest
    • • Test the system with a test user before going live
    • • Assign manager roles carefully based on trust level

    ✗ Don't

    • • Don't use the same role in multiple role maps (causes conflicts)
    • • Don't give manager permissions to untrusted roles
    • • Don't forget to set up log channels (important for auditing)
    • • Don't make promotion ladders too long (harder to manage)

    Example Use Case

    Military Roleplay Server

    Recruit Roles: Trainee, Basic Access
    Promotion Ladder: Private → Corporal → Sergeant → Lieutenant → Captain
    Additional Roles: Sniper Certified, Medic Certified, Vehicle Operator
    Warning Roles: Warning 1, Warning 2, Warning 3
    Terminate Roles: Discharged, Former Member
    Manager Permissions:
    • • Recruit Managers: Recruitment Officers
    • • Promotion Managers: Command Staff
    • • Demotion Managers: Command Staff
    • • Warning Managers: Military Police
    • • Terminate Managers: High Command Only