abu_UnstuckPlayer

Discord DmitriyBlade#0123
Source code: https://drive.google.com/file/d/1g9n-35IzCkP8yfnF1Vh2sLVyvZe3uL-S/view?usp=sharing

Overview
A player-initiated unstuck system for Arma Reforger that allows players to free themselves when stuck in terrain, objects, or vehicle compartments. Features both map toolbar button and chat command access with a shared cooldown system.
Features
Two Activation Methods
Map Toolbar Button - Click the "PlayerMarker" button when the map is open
Chat Command - Type !unstuck in any chat channel
Shared 15-Second Cooldown
Both methods share the same cooldown timer
Prevents spam and abuse
Silent cooldown (no feedback if on cooldown)
Smart Teleportation System
Saves player's current position before teleporting
Teleports to safe location (world origin + terrain height + 1m)
Automatically returns player to saved position after 2 seconds
Vehicle Support
Automatically detects if player is in a vehicle compartment
Ejects player from vehicle before teleporting
Handles vehicle exit animations properly
Technical Details
Activation Flow
Player triggers unstuck via toolbar button or !unstuck chat command
Cooldown check (15 seconds since last use)
Validates player is alive and not unconscious
Broadcasts chat message: "[This player uses unstucking]"
Saves current position and initiates teleport sequence
Teleport Sequence
Save Position - Current coordinates stored in per-player map
Initial Teleport - Player moved to safe location (0,0 + terrain height)
Wait Period - 2-second delay
Return Teleport - Player returned to original position (adjusted for terrain)
Vehicle Handling
Detects player in vehicle compartment
Executes GetOutVehicle_NoDoor() on client
500ms delay for exit animation
Proceeds with standard teleport
Network Architecture
Uses RplRpc for client-server communication
Server validates all teleports
Position storage is per-player (playerId key)
Physics velocity reset after each teleport
Configuration
Cooldown: 15 seconds (configurable in code)
Return Delay: 2 seconds
Vehicle Exit Delay: 500ms
Target Location: World origin (0,0) + terrain height + 1m
Files Structure
abu_Unstuck/
├── scripts/Game/
│   ├── SCR_ChatComponent_Unstuck.c    # !unstuck chat command handler
│   └── Map/ComponentsUI/
│       └── SCR_UnstuckUI.c            # Toolbar button & shared cooldown
├── scripts/Game/Unstuck/
│   └── SCR_UnstuckTeleport.c          # Server RPC & teleport logic
└── Configs/Map/
    └── Unstuck.conf                    # Direction indicator config
Requirements
Works on dedicated servers
No conflicts with other mods (uses isolated modded classes)
Works in both singleplayer and multiplayer