NullSect
Systems nominal

Docs / Height / Installation

Installation — ns-height

  1. Put the ns-height folder into your resources (e.g. resources/[nullsect]/ns-height).

  2. Make sure oxmysql and your framework start before it. With Config.Database.autoMigrate = true (default) the tables are created on the first start. Otherwise import sql/ns-height.sql manually.

  3. OneSync must be enabled (the server reads the ped model to know the natural height).

  4. Add to server.cfg:

    ensure ns-height
    add_ace group.admin ns-height.admin allow
    
  5. Restart the server.

Verify

CheckExpected
Server console[ns-height:SV] [INFO] ready (framework=qbox, core=…)
Databasetables ns_height_meta and ns_height exist
/boy as adminthe panel opens with the "Manage" tab
/boy as a player without creditsrefused with a notification
/boyizin <id> 1, then /boy as that playerthe panel opens, Apply works once, then the credit is gone
A second player standing next to yousees the new height
Relog / restart ns-heightthe height is still there

Calibration

The natural heights in Config.BaseHeight and Config.PelvisOffset are estimates. Calibrate them once on your server:

  1. Set your height to the minimum (150) and stand on flat ground. If the feet float, lower Config.PelvisOffset. If they sink into the ground, raise it. Repeat at 200.
  2. Stand next to a prop of known height to check that 178 cm looks like 178 cm. If not, change Config.BaseHeight for that model.
  3. Addon / custom peds use Config.BaseHeight.default. Add a line per model you use (model_name = cm).

Troubleshooting

  • oxmysql is not started → start oxmysql before ns-height.
  • Migration v… failed → the database user needs CREATE / ALTER permission, or import the SQL file.
  • No framework adapter is active → Config.Framework names a framework that is not started.
  • Everyone has the default natural height → OneSync is off, so the server cannot read the ped model.
  • The height flickers in some animations → expected for a few emotes and scenarios. GTA resets the matrix there.

Cart

Your cart is empty.