HEADKNOCKA Scale Menu [OPENSOURCE]

HEADKNOCKA-SCALEMENU — Open Source Edition

Bring advanced character size customization, biometric scaling, and immersive body variety to your FiveM server with full editable source access.

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 Open Source Edition includes editable source files, configuration files, UI files, documentation, SQL files, and integration files so server owners and developers can fully customize the resource for their own server.

🔓 OPEN SOURCE EDITION

This edition is delivered as a full-source editable FiveM resource.

Developers can edit, expand, customize, and integrate the system directly into their server environment.

Included editable files:

• Client-side Lua files

• Server-side Lua files

• Shared configuration files

• User-interface HTML

• User-interface CSS

• User-interface JavaScript

• SQL setup files

• Documentation files

• Branding and logo files

• Install notes

• Integration notes

This version is perfect for developers who want complete control over the system’s behavior, UI, permissions, storage logic, framework bridge, and custom integrations.

📏 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

⚙️ 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 support includes:

• 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.

🎯 DEVELOPER EXPORTS

HEADKNOCKA-SCALEMENU includes developer exports for resources that need to read player scale data or connect with custom systems.

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, clothing, 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.

🧩 OPEN SOURCE CUSTOMIZATION

Because this edition includes full editable source access, developers can customize the system to fit their server.

You can edit:

• UI layout

• UI colors

• Branding

• Menu behavior

• Scale limits

• Body presets

• Framework bridge logic

• Storage logic

• Permission checks

• Admin commands

• Notifications

• Developer exports

• Hit zone logic

• Combat integration logic

• SQL mirror behavior

Open source access gives server owners and developers the flexibility to build custom features, connect third-party systems, adjust the design, or create private server-specific integrations.

⚙️ 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 clothing 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 Open Source ScaleMenu resource

• Full editable client source files

• Full editable server source files

• Full editable shared configuration

• Full editable UI files

• Full editable documentation

• 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

• SQL file for optional manual setup

• Installation guide

• Open source usage notes

📥 DELIVERY

After purchase, the resource is delivered as a complete open-source FiveM resource package.

The download includes editable Lua files, editable configuration files, editable user-interface files, documentation, SQL setup file, branding files, and all required installation files.

Open Source Edition means the code is editable for your server.

Redistribution, leaking, reselling, or sharing the resource is still not permitted unless your license specifically allows it.

Give your players deeper character identity.

Add realistic body variety, immersive height differences, saved player scaling, admin control, and developer-friendly source access to your FiveM server with HEADKNOCKA-SCALEMENU Open Source Edition.

Available now at:

headknocka.dev