HEADKNOCKA Scale Menu [ESCROWED]

HEADKNOCKA-SCALEMENU — Asset Escrow Edition

Bring advanced character size customization, biometric scaling, and immersive body variety to your FiveM server.

HEADKNOCKA-SCALEMENU is a standalone auto-detect ped scale system that allows players to adjust their character’s height, body weight, and physical appearance through a clean in-game menu.

Create more realistic roleplay characters, support different body types, give players deeper identity customization, and provide staff with admin tools to manage player scale safely.

This Asset Escrow Edition protects the resource’s core runtime files while keeping important configuration, UI, documentation, SQL, and branding files editable.

📏 ADVANCED PED SCALE SYSTEM

HEADKNOCKA-SCALEMENU gives players a smooth and immersive way to adjust their character’s physical dimensions.

Players can customize:

• Height scale

• Weight scale

• Body size

• Character proportions

• Visual appearance

• Preset body styles

The system applies scaling directly to the player ped and syncs the result so other players can see the correct character size in-game.

Whether your server wants taller characters, shorter characters, heavier builds, athletic builds, or realistic body variety, ScaleMenu gives players a clean way to create a more unique roleplay identity.

🧍 CHARACTER BODY CUSTOMIZATION

Players can open the menu and adjust their character through a simple and responsive interface.

The menu includes:

• Height adjustment

• Weight adjustment

• Live character preview

• Body preset options

• Metric and imperial unit support

• Reset option

• Apply option

• Clean modern UI

• Easy-to-use controls

Included body presets:

• Slim

• Normal

• Heavy

• Athletic

These presets allow players to quickly choose a body type, while still allowing manual scale adjustments for more precise customization.

🎥 3D PREVIEW CAMERA

HEADKNOCKA-SCALEMENU includes an interactive preview camera so players can view their character while editing.

Camera controls include:

• Rotate camera

• Move camera up and down

• Zoom in and out

• Left-click drag support

• Right-click drag support

• Mouse scroll zoom

• Smooth visual preview

This allows players to see exactly how their character looks before applying the final scale.

💾 SAVED PLAYER SCALE DATA

Player scale data is saved automatically so characters keep their selected body size after reconnecting.

The resource works without SQL by default using standalone KVP storage, making it easy to install on any server.

Storage support includes:

• Standalone KVP saving

• Automatic KVP fallback

• Optional SQL mirror support

• Optional oxmysql support

• Framework-aware identifiers

• Saved UI preferences

• Persistent player scaling

Optional SQL mirroring can be enabled for servers that want to store scale data in their framework database.

Supported SQL mirror setups include:

• ESX users table

• QBCore players table

• Qbox players table

The included scalemenu.sql file is available for manual SQL setups if needed.

⚙️ STANDALONE AUTO-DETECT FRAMEWORK SUPPORT

HEADKNOCKA-SCALEMENU does not require a specific framework.

The resource automatically detects the active server framework and falls back to standalone mode if no framework is found.

Supported setups:

• Standalone / no framework

• ESX Legacy

• QBCore

• Qbox / qbx_core

• ox_core-style setups

Auto-detection order:

• qbx_core

• qb-core

• es_extended

• ox_core

• standalone fallback

You can also force a specific framework mode through the editable config file.

🔐 OPTIONAL ACCESS CONTROL

ScaleMenu can be left open for all players or restricted to authorized users only.

When restricted access is enabled, the system can check multiple permission methods.

Access control options include:

• Temporary access grants

• ACE permission support

• Allowed license list

• ESX group checks

• QBCore permission checks

• Qbox permission support

• ox_core-style permission fallback

• Admin group support

Default ACE permission:

hk_scalemenu.admin

This gives server owners full control over who can open the menu and who can use admin commands.

🛠️ ADMIN COMMANDS

Authorized staff can manage player scale directly through commands.

Included commands:

/scalemenu

Opens the ScaleMenu interface.

/setpedscale [id] [height] [weight]

Force a player’s height and weight scale.

/givepedscale [id]

Grant temporary ScaleMenu access to a player.

/removepedscale [id]

Remove temporary ScaleMenu access from a player.

These tools are perfect for staff teams that want to approve custom body sizes, manage special characters, or control scale access for events and roleplay scenarios.

🎯 CUSTOM SCALED HIT ZONE SUPPORT

HEADKNOCKA-SCALEMENU includes developer exports for resources that need to detect scaled player hit zones.

Included exports:

• GetScaledHitZones

• GetClosestScaledHitZone

• GetPedScaleDataFromPed

The synced state bag key remains:

pedScaleSync

This allows other scripts to read player scale data and connect with custom combat, damage, medical, targeting, or roleplay systems.

⚔️ OPTIONAL COMBAT AND HIT REGISTRATION SUPPORT

The system includes configurable scaled hit zone and damage logic for servers that want body size to matter more in gameplay.

Supported logic can include:

• Custom scaled hit zones

• Head zone detection

• Chest zone detection

• Pelvis zone detection

• Left leg detection

• Right leg detection

• Weapon-based damage configuration

• Shot debounce settings

• Debug options for zones and shots

This gives developers a foundation for creating custom combat, medical, or damage systems that respect player body scale.

🚀 PERFORMANCE OPTIONS

HEADKNOCKA-SCALEMENU includes performance-focused options for larger servers or servers that do not need advanced hit zone logic.

Performance Mode can disable heavier systems such as:

• Custom hitbox calculations

• Extra damage calculations

• Smooth camera features

Debug options are disabled by default and can be enabled through server convars only when needed.

Debug convars:

setr hk_scalemenu_debug_zones true

setr hk_scalemenu_debug_shots true

This keeps the resource clean, optimized, and suitable for live roleplay servers.

🔔 NOTIFICATION SUPPORT

The resource automatically uses the best available notification method on your server.

Supported notification fallbacks include:

• ox_lib notifications

• QBCore notifications

• Qbox notifications

• ESX notifications

• Chat fallback

This means the script can fit into many server setups without requiring custom edits.

🔒 ASSET ESCROW EDITION

This edition is prepared for FiveM Asset Escrow.

Core runtime files are protected while important customer-editable files remain accessible.

Customer-editable files include:

• Main configuration file

• README documentation

• Installation documentation

• Sale-ready notes

• SQL file

• User-interface HTML

• User-interface CSS

• User-interface JavaScript

• Logo / branding image

The editable configuration allows server owners to customize framework mode, storage mode, permissions, scale limits, notifications, performance mode, debug options, body presets, and more.

The protected core helps prevent unauthorized copying, modification, redistribution, or leaking of the resource.

⚙️ COMPATIBILITY

Framework Support:

• Standalone

• ESX Legacy

• QBCore

• Qbox

• ox_core-style setups

Required Dependencies:

• None

Optional Dependencies:

• ox_lib for notifications

• oxmysql for SQL mirror support

Optional Integrations:

• Custom medical resources

• Custom combat resources

• Custom targeting systems

• Custom roleplay systems

• Custom admin systems

HEADKNOCKA-SCALEMENU works without a framework and without SQL by default.

🚀 EASY INSTALLATION

Installation is simple and the resource is ready to run as-is.

Recommended Start Line:

ensure HEADKNOCKA-SCALEMENU

Default command:

/scalemenu

Recommended default configuration:

Config.Framework.mode = 'auto'

Config.Storage.mode = 'auto'

Config.Storage.useKvpFallback = true

Config.Storage.mirrorKvp = true

Optional ACE permission example:

add_ace group.admin hk_scalemenu.admin allow

add_principal identifier.license:xxxxxxxx group.admin

No SQL import is required by default.

The included scalemenu.sql file is only needed for manual SQL mirror setups.

📦 INCLUDED WITH YOUR PURCHASE

• Complete Asset Escrow-ready ScaleMenu resource

• Standalone auto-detect ped scale system

• Height and weight adjustment menu

• Character body preset system

• Interactive 3D preview camera

• Metric and imperial display support

• Persistent KVP player saving

• Optional SQL mirror support

• Framework auto-detection bridge

• ESX compatibility

• QBCore compatibility

• Qbox compatibility

• ox_core-style compatibility

• Optional ox_lib notification support

• Admin scale commands

• Temporary access commands

• ACE permission support

• Configurable access restriction

• Configurable scale limits

• Performance mode option

• Debug convars

• Developer exports

• Scaled hit zone support

• Customer-editable configuration

• Customer-editable UI files

• Customer-editable documentation

• Installation guide

• SQL file for optional manual setup

📥 DELIVERY

After purchase, the resource is delivered automatically through the FiveM Asset Escrow system.

The download includes the protected runtime resource, editable configuration files, editable user-interface files, documentation, SQL setup file, and all required installation files.

Give your players deeper character identity.

Add realistic body variety, immersive height differences, saved player scaling, admin control, and developer-friendly exports to your FiveM server with HEADKNOCKA-SCALEMENU Asset Escrow Edition.

Available now at:

headknocka.dev