Runtime

User command

Read and change what the player sends to the server every tick.

The cmd object is only valid inside events.create_move. Luna fixes the command checksum after your changes. Moves range from -1 to 1.

FunctionParametersReturnsDescription
cmd:get_button(mask)mask: numberboolcmd:set_button(mask, on?), cmd:remove_button(mask), cmd:press(mask), cmd:release(mask)
cmd:get_buttons()numbercmd:set_buttons(value)
cmd:get_user_buttons()numberWhat the player physically holds. cmd:is_user_holding(mask)
cmd:get_viewangles()Vectorcmd:set_viewangles(vector or pitch, yaw) (sent to the server)
cmd:set_camera_angles(vector or pitch, yaw)boolAlso moves the local camera.
cmd:get_forward_move()numberget_left_move, get_side_move, get_up_move and their set_ versions
cmd:set_move(forward, left, press_keys?)nonepress_keys (default true) also sets W A S D.
cmd:get_user_move()forward, leftWhat the player pressed.
cmd:rotate_movement(from_yaw)noneKeeps the world direction after you changed the yaw.
cmd:get_tick()intcmd:get_command_number(), cmd:is_new_tick()
cmd:get_luna_state()tablebhop, jumpbug, edgebug, pixelsurf, texturebug, ticks_on_ground, ticks_in_air
cmd:get_pointers()addressesRaw command, base command and input for FFI.

Fields work too: cmd.buttons, cmd.forwardmove, cmd.leftmove, cmd.sidemove, cmd.upmove, cmd.viewangles (read and write), cmd.command_number, cmd.tick. Outside create_move, luna.view_angles() and luna.set_view_angles(...) read and set the view.

events.create_move:add(function(cmd)
    local state = luna.local_state()
    if not state or state.on_ground then return end
    if cmd:is_user_holding(buttons.jump) then
        cmd:press(buttons.duck)
    end
    local angles = cmd:get_viewangles()
    cmd:set_viewangles(angles.x, angles.y)
end)