Before you go through the README file, I would first like to give a huge thanks to Draythianna. They fixed an issue that gave me large headaches and was integral in the creation of this script. Please know, they are the reason you are able to use this script the way that it is.

A comprehensive FiveM script that allows players to scale their character's height/size in real-time with a beautiful web-based interface. Preview

Features

Real-time scaling: Adjust your character's height from 0.1x to 2.0x scale
Modern UI: Clean, responsive web-based interface
Framework Support: Compatible with ESX, QBCore, and Standalone
Multiplayer Sync: All players see each other's scaled characters
Persistent Storage: Your scale settings are saved and restored
Permission System: Configurable ACE permissions for commands
Multi-language: Support for English and Spanish (easily extensible)

Installation Guide

Dependencies

FiveM Server
One of the supported frameworks: ESX, QBCore, QBox, or Standalone
Basic knowledge of FiveM resource installation

Step 1: Download and Extract

Download the latest release from our repository
Extract the nass_pedscaler folder to your server's resources directory
Place it in your resources/[nass-scripts]/ folder (or any folder structure you prefer)

Step 2: Add to Server Configuration

Add the following line to your server.cfg:

ensure nass_pedscaler

Important: Make sure to add this line AFTER your framework initialization (ESX/QBCore/QBox).

Step 3: Framework Configuration

The script automatically detects your framework. No additional configuration is required for:

ESX: Works out of the box
QBCore: Works out of the box
QBox: Works out of the box
Standalone: Works without any framework

Step 4: Start Your Server

Start your FiveM server
Check the console for any error messages
The script should load successfully with the message: nass_pedscaler started successfully

Configuration

Basic Configuration (`config.lua`)

Config = {}

-- Commands
Config.commands = {
    openMenu = {
        enabled = true,
        command = "scale"  -- Change this to customize the command
    },
    resetScale = {
        enabled = true,
        command = "resetscale"  -- Change this to customize the command
    }
}

-- Scaling limits
Config.scaling = {
    min = 0.1,    -- Minimum scale (10% of original size)
    max = 2.0,    -- Maximum scale (200% of original size)
    scaleSpeed = {
        enabled = false,  -- Enable/disable speed scaling based on size
        inverse = true,   -- Smaller peds move faster, larger peds move slower
    }
}

Permission System

To enable permissions, set Config.permissions.enabled = true:

Config.permissions = {
    enabled = true,
    defaultPermissions = {
        openSelf = true,    -- Players can open their own menu
        openOther = false,  -- Players cannot open others' menus
        resetSelf = true,   -- Players can reset their own scale
        resetOther = false, -- Players cannot reset others' scales
    },
    acePermissions = {
        ["nass_fighting.scaler"] = {  -- ACE permission name
            openSelf = true,
            openOther = true,
            resetSelf = true,
            resetOther = true,
        }
    }
}

Adding ACE Permissions

To give players admin permissions, add this to your server.cfg:

# Give admin group access to all scaling commands
add_ace group.admin nass_fighting.scaler allow

Usage

Commands

/scale - Open the scaling menu
/scale [playerid] - Open scaling menu for another player (requires permission)
/resetscale - Reset your scale to default (1.0)
/resetscale [playerid] - Reset another player's scale (requires permission)

How to Use

Open the Menu: Type /scale in chat or use the command
Adjust Scale: Use the slider to adjust your character's height
Preview: See the changes in real-time as you move the slider
Apply: Click "Apply" to save your scale permanently
Close: Click "Close" to exit without saving changes

Important Notes

Vehicle Scaling: When entering/exiting vehicles, your scale resets to 1.0
Terrain Changes: You may notice slight scale adjustments when changing terrain
Aiming: You may also notice your scale will reset while aiming a weapon
Persistence: Your scale is saved and will be restored when you reconnect

Troubleshooting

Common Issues

Script won't start:

Check that you have the correct framework installed
Ensure the resource is in the correct folder
Verify your server.cfg has ensure nass_pedscaler

Menu won't open:

Check console for error messages
Verify you have permission to use the command
Try restarting the resource: restart nass_pedscaler

Scale not syncing between players:

Check that the script is running on both client and server
Verify network events are working properly
Try restarting the resource

Web interface not loading:

Check that web/build/ folder contains the necessary files
Verify your FiveM server has proper file permissions
Clear browser cache if using web interface

Performance Issues

If you experience performance issues:

Reduce the scaling update frequency in the client script
Limit the number of players who can use scaling simultaneously
Consider disabling scaleSpeed feature if not needed

Getting Help

If you're still having issues:

Check the Console: Look for error messages in your server console
Join our Discord: Get real-time support from our community
Create an Issue: Report bugs on our GitHub repository

Support & Community

If you have any questions, need help, or want to connect with other users, join our Discord community!
We're always happy to help and hear your feedback.

👉 Join our Discord

By joining, you can:

Get real-time support
Suggest new features
Stay updated with the latest news
Support the project and help us grow!

Contributing

We welcome contributions! Please create pull requests or directly contact me on discord.

Thank you for using our script. Your support means a lot to us!

README.md

Nass Ped Scaler