This mod implements a priority slot access system for full servers in Arma Reforger. When the server reaches maximum capacity, players with priority access can join by automatically freeing a slot from a regular player.

================================================================================
              PRIORITY SLOT MANAGER - CONFIGURATION & USAGE
================================================================================

🚀 QUICK SETUP (5 STEPS):

STEP 1: Configure Server Native Limit
--------------------------------------
Edit your serverconfig.json and set maxPlayers JSON in server profile folder HIGHER than your desired slots:

Formula: maxPlayers = desired_slots + 3

Examples:
- Want 100 slots? Set maxPlayers to 103
- Want 64 slots? Set maxPlayers to 67
- Want 125 slots? Set maxPlayers to 128

Example serverconfig.json:
{
  "game": {
    "maxPlayers": 103
  }
}

STEP 2: Start Server (First Time)
----------------------------------
The mod will automatically create: $profile:PQD_PrioritySlots.json

STEP 3: Configure Mod Limit
----------------------------
Edit the auto-created PQD_PrioritySlots.json file.
Set "max_players" to your REAL desired limit (NOT the buffer value):

Example PQD_PrioritySlots.json:
{
  "max_players": 100,
  "kick_random_player": false,
  "priority_players": [
    "44ee269b-67e6-47da-8e5a-061e55b06377",
    "another-bohemia-id-here"
  ]
}

Configuration Options:
- "max_players": Your real desired slot limit (e.g., 100)
- "kick_random_player": false = kick most recent player, true = kick random player
- "priority_players": Array of Bohemia Identity IDs with priority access

STEP 4: Get Bohemia Identity IDs
---------------------------------
Find player IDs in your server logs:

NETWORK : ### Updating player: PlayerId=1, Name=PlayerName,
          IdentityId=44ee269b-67e6-47da-8e5a-061e55b06377

Copy the IdentityId (36 characters with hyphens) and add to priority_players.

STEP 5: Restart Server
-----------------------
Done! Priority players can now join full servers.

================================================================================
                         HOW THE OVERFLOW SYSTEM WORKS
================================================================================

The mod uses an "overflow buffer" system:

┌─────────────────────────────────────┐
│  Regular Zone (Slots 1-100)         │
│  → Anyone can join and stay         │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│  Overflow Zone (Slots 101-103)      │
│  → Priority players: Stay           │
│  → Regular players: Kicked          │
└─────────────────────────────────────┘

Example Scenario (100-slot server):
- server.json maxPlayers = 103 (native limit)
- PQD_PrioritySlots.json max_players = 100 (real limit)
- Buffer = 3 slots

When server has 100 players and a priority player tries to join:
1. Player enters overflow zone (slot 101)
2. Mod detects: Priority player + Server full
3. Mod kicks a regular player (see kick modes below)
4. Priority player takes the freed slot

KICK MODES (controlled by "kick_random_player" in JSON):

MODE 1: Most Recent Kick (kick_random_player: false) - DEFAULT
- Tracks connection timestamps for all players
- Always kicks the MOST RECENT regular player (last non-priority to join)
- Ensures oldest regular players stay connected
- Priority players can reconnect and will kick newest regular player

MODE 2: Random Kick (kick_random_player: true)
- Randomly selects any regular player to kick
- No preference for connection order
- All regular players have equal chance of being kicked
- Useful for fairness when you don't want to penalize recent connections

================================================================================
                      CONFIGURATION TABLE (REFERENCE)
================================================================================

| Real Slots | server.json maxPlayers | PQD_PrioritySlots.json max_players |
|-----------|------------------------|-------------------------------------|
| 32        | 35                     | 32                                  |
| 64        | 67                     | 64                                  |
| 100       | 103                    | 100                                 |
| 128       | 131                    | 128                                 |

================================================================================
                    TWO WAYS TO GRANT PRIORITY ACCESS
================================================================================

OPTION 1: Admin List (server.json)
-----------------------------------
- Grants: Priority access + Admin powers
- Limit: 20 IDs maximum
- Use for: Server owners, moderators

Add to server.json:
{
  "game": {
    "admins": [
      "44ee269b-67e6-47da-8e5a-061e55b06377",
      "admin-id-here"
    ]
  }
}

OPTION 2: Mod JSON (PQD_PrioritySlots.json)
--------------------------------------------
- Grants: Priority access WITHOUT admin powers
- Limit: Unlimited IDs
- Use for: Friendly players, supporters, donors

Add to PQD_PrioritySlots.json:
{
  "priority_players": [
    "player-id-1",
    "player-id-2"
  ]
}

Recommended Setup:
- server.json admins → Real admins/moderators (1-20 people)
- PQD_PrioritySlots.json → Priority players without admin powers (unlimited)



================================================================================
                    PRIORITY SLOT MANAGER - LICENSE TERMS
================================================================================


================================================================================
                              IMPORTANT NOTICE
================================================================================

ANY MODIFICATIONS OF THIS MOD ARE STRICTLY PROHIBITED BY THE AUTHOR.

This mod is provided "as is" without warranty of any kind, express or implied.
The author is not responsible for any damages or issues arising from the use
of this mod.

================================================================================
                         MONETIZATION POLICY
================================================================================

UNAUTHORIZED MONETIZATION IS STRICTLY PROHIBITED.

Rules for Server Usage:

1. SERVERS WITH AUTHORIZED MONETIZATION BY BOHEMIA INTERACTIVE
   → Must request WRITTEN PERMISSION from the author
   → Open a ticket at: discord.gg/exilados
   → Contact: PQDT_Raphael (Discord direct messages are disabled)

2. SERVERS RECEIVING DONATIONS (even if voluntary)
   → Must request WRITTEN PERMISSION from the author
   → Permission is required regardless of donation type

3. NON-PROFIT SERVERS (no monetization, no donations)
   → Can use the mod FREELY without permission

================================================================================
                      HOW TO REQUEST PERMISSION
================================================================================

1. Join Discord server: discord.gg/exilados
2. Open a support ticket
3. Provide:
   - Server name
   - Server IP/URL
   - Monetization model (if applicable)
   - Donation system details (if applicable)
4. Wait for written authorization

NOTE: The author does not accept Discord direct messages. Use the ticket
system only.

================================================================================
                           APPROVED SERVERS
================================================================================

The following servers have been granted permission to use this mod:

✅ Exilados Brasil

(Additional approved servers will be listed here after authorization)

================================================================================
                        DISTRIBUTION RESTRICTIONS
================================================================================

- ❌ Redistribution of modified versions is PROHIBITED
- ❌ Reuploading to other platforms is PROHIBITED
- ❌ Commercial use without permission is PROHIBITED
- ✅ Sharing the official Workshop link is ALLOWED
- ✅ Non-profit server use is ALLOWED

================================================================================
                         COMPLIANCE REQUIREMENTS
================================================================================

By using this mod, you agree to comply with:

1. Bohemia Interactive's Workshop Terms of Service
   https://www.bohemia.net/community/licenses/bohemia-interactive-workshop-subscriber-agreement

2. Arma Reforger End User License Agreement (EULA)
   https://www.bohemia.net/community/licenses/arma-reforger-eula

3. This mod's specific license terms stated above

For more information about Workshop licenses and intellectual property:
https://reforger.armaplatform.com/news/workshop-licenses-and-ip-faq

================================================================================
                            ENFORCEMENT
================================================================================

Servers found to be using this mod in violation of these terms will be:

1. Publicly listed as unauthorized
2. Reported to Bohemia Interactive (if applicable)
3. Subject to takedown requests

The author reserves the right to:
- Revoke permission at any time
- Update these terms without prior notice
- Take legal action against violations

================================================================================
                             ATTRIBUTION
================================================================================

When using this mod, you must:

✅ Do not claim ownership or authorship

================================================================================
                        SUPPORT & CONTACT
================================================================================

For support, bug reports, or permission requests:
- Discord: discord.gg/exilados (open a ticket)
- Contact: PQDT_Raphael
- DO NOT send Discord direct messages - they will not be read

================================================================================
                              DISCLAIMER
================================================================================

By downloading, installing, or using this mod, you acknowledge that you have
read, understood, and agree to be bound by these license terms.

If you do not agree to these terms, do not use this mod.

================================================================================
                            END OF LICENSE
================================================================================

PQD - Priority Slot Manager

Development complete, mod working.
Priority Slot Manager Mod for Arma Reforger

PQD - Priority Slot Manager

1.0.0

0.0.8

0.0.7

0.0.6

0.0.5

0.0.4

0.0.3

0.0.2

0.0.1