---@meta
bit32 = bit

---Indicates a call when the server first starts up.
RESET_REASON_BOOT = 0
---Indicates a call by the engine, usually when the round/day resets in default game modes.
RESET_REASON_ENGINECALL = 1
---Indicates a call after the Lua state was manually reset.
RESET_REASON_LUARESET = 2
---Indicates a call from Server:reset.
RESET_REASON_LUACALL = 3

---In round-based modes, the player list screen is shown in this state to those who aren't spawned in. Prefer an enum library.
STATE_PREGAME = 1
---Game is ongoing. In round-based modes, players not spawned in will spectate. World players can spawn as they please. Prefer an enum library.
STATE_GAME = 2
---Used in round-based modes when the game is over and the player list is shown before reset. Prefer an enum library.
STATE_RESTARTING = 3

---Driving mode. Prefer an enum library.
---@deprecated
TYPE_DRIVING = 1
---Racing mode. Prefer an enum library.
---@deprecated
TYPE_RACE = 2
---Round mode. Prefer an enum library.
TYPE_ROUND = 3
---World mode. Prefer an enum library.
TYPE_WORLD = 4
---Eliminator mode. Prefer an enum library.
TYPE_TERMINATOR = 5
---Co-op mode. Prefer an enum library.
TYPE_COOP = 6
---Versus mode. Prefer an enum library.
TYPE_VERSUS = 7

---File was accessed.
FILE_WATCH_ACCESS = 0
---Metadata changed.
FILE_WATCH_ATTRIB = 0
---Writable file was closed.
FILE_WATCH_CLOSE_WRITE = 0
---Unwritable file closed.
FILE_WATCH_CLOSE_NOWRITE = 0
---Subfile was created.
FILE_WATCH_CREATE = 0
---Subfile was deleted.
FILE_WATCH_DELETE = 0
---Self was deleted.
FILE_WATCH_DELETE_SELF = 0
---File was modified.
FILE_WATCH_MODIFY = 0
---Self was moved.
FILE_WATCH_MOVE_SELF = 0
---File was moved from X.
FILE_WATCH_MOVED_FROM = 0
---File was moved to Y.
FILE_WATCH_MOVED_TO = 0
---File was opened.
FILE_WATCH_OPEN = 0
---Moves.
FILE_WATCH_MOVE = 0
---Closes.
FILE_WATCH_CLOSE = 0
---Do not follow a sym link.
FILE_WATCH_DONT_FOLLOW = 0
---Exclude events on unlinked objects.
FILE_WATCH_EXCL_UNLINK = 0
---Add to the mask of an already existing watch.
FILE_WATCH_MASK_ADD = 0
---Only send event once.
FILE_WATCH_ONESHOT = 0
---Only watch the path if it is a directory.
FILE_WATCH_ONLYDIR = 0
---File was ignored.
FILE_WATCH_IGNORED = 0
---Event occurred against a directory.
FILE_WATCH_ISDIR = 0
---Event queue overflowed.
FILE_WATCH_Q_OVERFLOW = 0
---Backing fs was unmounted.
FILE_WATCH_UNMOUNT = 0

---The hook library which hooked events will call upon.
---The hook.run function must be defined to use hooks.
---@class HookGlobal
hook = {
	persistentMode = "",
}

---Enable a hook for use in Lua.
---@param eventName string The name of the event to be enabled.
---@return boolean exists Whether the event exists.
function hook.enable(eventName) end

---Disable a hook for use in Lua.
---@param eventName string The name of the event to be disabled.
---@return boolean exists Whether the event exists.
function hook.disable(eventName) end

---Disable every hook for use in Lua, until they are enabled again.
function hook.clear() end

---Recreate the Lua state completely at the start of the next logic tick.
---Runs lua/main.lua again after reset.
---@param mode string The string to set to hook.persistentMode in the new state.
function flagStateForReset(mode) end

---Create a new Vector with 0 for every coordinate.
---Available in worker threads.
---@return Vector vector The created vector.
function Vector() end

---Create a new Vector with given coordinates.
---Available in worker threads.
---@param x number
---@param y number
---@param z number
---@return Vector vector The created vector.
function Vector(x, y, z) end

---Create a new RotMatrix.
---Available in worker threads.
---@param x1 number
---@param y1 number
---@param z1 number
---@param x2 number
---@param y2 number
---@param z2 number
---@param x3 number
---@param y3 number
---@param z3 number
---@return RotMatrix rotMatrix The created rotation matrix.
function RotMatrix(x1, y1, z1, x2, y2, z2, x3, y3, z3) end

---Create an empty RotMatrix with 0 for every component.
---Available in worker threads.
---@return RotMatrix rotMatrix The created rotation matrix.
function RotMatrix() end

---Library for sending HTTP(S) requests.
http = {}

---@class HTTPResponse
---@field status integer The HTTP status code.
---@field body string The response body.
---@field headers table<string, string> The response headers.

---Send an HTTP(S) GET request synchronously.
---Available in worker threads.
---Not recommended to use this on the main thread.
---@param scheme string The hostname of the server to send the request to, with optional protocol and port. Ex. google.com, https://google.com, https://google.com:443
---@param path string The path to request from the server.
---@param headers table<string, string> The table of request headers.
---@return HTTPResponse? response
function http.getSync(scheme, path, headers) end

---Send an HTTP(S) POST request synchronously.
---Available in worker threads.
---Not recommended to use this on the main thread.
---@param scheme string The hostname of the server to send the request to, with optional protocol and port. Ex. google.com, https://google.com, https://google.com:443
---@param path string The path to request from the server.
---@param headers table<string, string> The table of request headers.
---@param body string The request body.
---@param contentType string The request body MIME type.
---@return HTTPResponse? response
function http.postSync(scheme, path, headers, body, contentType) end

---Library for lz4 compression/decompression.
lz4 = {}

---Compress a string of bytes.
---Available in worker threads.
---@param input string The data to compress.
---@return string compressed The compressed data. This can be longer than the input if the input is very short.
function lz4.compress(input) end

---Decompress a compressed string of bytes.
---Available in worker threads.
---@param compressed string The compressed data.
---@param uncompressedSize integer The maximum size of the uncompressed data. This should be the size of the original data before compression.
---@return string uncompressed The uncompressed data.
function lz4.uncompress(compressed, uncompressedSize) end

---Library for crpytographic functions.
crypto = {}

---Get the MD5 hash of a string of bytes.
---@param input string The data to hash.
---@return string md5 The hashed data.
function crypto.md5(input) end

---Get the SHA-256 hash of a string of bytes.
---@param input string The data to hash.
---@return string sha256 The hashed data.
function crypto.sha256(input) end

---Library for using generic physics functions of the engine.
physics = {}

---@class LineIntersectResult
---@field hit boolean Whether it hit. If false, all other fields will be nil.
---@field pos Vector? The global position where the ray hit.
---@field normal Vector? The normal of the surface the ray hit.
---@field fraction number? How far along the ray the hit was (0.0 - 1.0).
---@field bone integer? Which bone the ray hit, if it was cast on a human.
---@field face integer? Which face the ray hit, if not a wheel, if it was cast on a vehicle.
---@field wheel integer? Which wheel the ray hit, if not a face, if it was cast on a vehicle.

---Cast a ray in the level and find where it hits.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param onlyCity boolean Whether to only include the city (not landscape, tracks, etc).
---@return LineIntersectResult result The result of the intersection.
function physics.lineIntersectLevel(posA, posB, onlyCity) end

---Cast a ray on a single human.
---@param human Human The human to cast the ray on.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param padding number The extra padding.
---@return LineIntersectResult result The result of the intersection.
function physics.lineIntersectHuman(human, posA, posB, padding) end

---Cast a ray on a single vehicle.
---@param vehicle Vehicle The vehicle to cast the ray on.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param includeWheels boolean Whether to include wheels.
---@return LineIntersectResult result The result of the intersection.
function physics.lineIntersectVehicle(vehicle, posA, posB, includeWheels) end

---Cast a quick ray in the level and find how far along the ray it went.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param onlyCity boolean Whether to only include the city (not landscape, tracks, etc).
---@return number? fraction The fraction of the intersection.
function physics.lineIntersectLevelQuick(posA, posB, onlyCity) end

---Cast a quick ray on a single human.
---@param human Human The human to cast the ray on.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param padding number The extra padding.
---@return number? fraction The fraction of the intersection.
function physics.lineIntersectHumanQuick(human, posA, posB, padding) end

---Cast a quick ray on a single vehicle.
---@param vehicle Vehicle The vehicle to cast the ray on.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param includeWheels boolean Whether to include wheels.
---@return number? fraction The fraction of the intersection.
function physics.lineIntersectVehicleQuick(vehicle, posA, posB, includeWheels) end

---Cast a quick ray on any human or vehicle.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param ignoreHuman Human|nil The human to ignore during raycast.
---@param humanPadding number The extra padding applied to humans.
---@param includeWheels boolean Whether to include vehicles' wheels.
---@return Human|Vehicle? object The nearest human or vehicle that the ray hit, or nil if it hit the level or nothing.
---@return number? fraction The fraction of the intersection.
function physics.lineIntersectAnyQuick(posA, posB, ignoreHuman, humanPadding, includeWheels) end

---Cast a ray on an arbitrary triangle.
---The vertices of the triangle must be clockwise relative to the normal.
---The vector passed to outPosition will be modified by the function.
---@param outPosition Vector A vector whose values will be set to the position the ray hit.
---@param normal Vector The normal of the triangle.
---@param posA Vector The start point of the ray.
---@param posB Vector The end point of the ray.
---@param triA Vector The first vertex of the triangle.
---@param triB Vector The second vertex of the triangle.
---@param triC Vector The third vertex of the triangle.
---@return number? fraction How far along the ray hit was (0.0 - 1.0). Nil if it did not hit.
function physics.lineIntersectTriangle(outPosition, normal, posA, posB, triA, triB, triC) end

---Remove all bullets that have no time remaining.
---May shift bullets in memory if any are removed.
function physics.garbageCollectBullets() end

---Create a collidable block in the level.
---@param blockX integer
---@param blockY integer
---@param blockZ integer
---@param flags integer
function physics.createBlock(blockX, blockY, blockZ, flags) end

---Get the the collidable block in the level.
---@param blockX integer
---@param blockY integer
---@param blockZ integer
function physics.getBlock(blockX, blockY, blockZ) end

---Delete a collidable block in the level.
---@param blockX integer
---@param blockY integer
---@param blockZ integer
function physics.deleteBlock(blockX, blockY, blockZ) end

---Generates the world-mode map train tracks and racetrack. Mainly hitboxes.
---Will not generate the racetrack if level is not named `test2`.
function physics.levelGenerateTrainRaceTrack() end

---Generates the world-mode map racetrack, even if the level is not named `test2`. Mainly hitboxes.
function physics.levelGenerateRaceTrack() end

---Library for sending chat messages.
chat = {}

---Display a message in the chat box to everybody.
---@param message string The message to send. Max length 63.
---@return Event event The created event.
function chat.announce(message) end

---Display a message in the chat box to everybody.
---@param message string The message to send.
---@return Event event The created event.
function chat.announceWrap(message) end

---Display a message in the chat box only to admins.
---More specifically, all players whose connection has `adminVisible` set to true.
---@param message string The message to send. Max length 63.
---@return Event event The created event.
function chat.tellAdmins(message) end

---Library for managing Account objects.
---accounts[index: integer] -> Account
accounts = {}

---Save all accounts to the `server.srk` file.
function accounts.save() end

---Get all accounts.
---@return Account[] accounts A list of all Account objects.
function accounts.getAll() end

---Get the number of accounts.
---@return integer count How many Account objects there are.
function accounts.getCount() end

---Find an account by phone number.
---@param phoneNumber integer The phone identifier to search for.
---@return Account? account The found account, or nil.
function accounts.getByPhone(phoneNumber) end

---Library for managing Player objects.
---players[index: integer] -> Player
players = {}

---Get all players.
---@return Player[] players A list of all Player objects.
function players.getAll() end

---Get the number of players.
---@return integer count How many Player objects there are.
function players.getCount() end

---Find a player by phone number.
---@param phoneNumber integer The phone identifier to search for.
---@return Player? player The found player, or nil.
function players.getByPhone(phoneNumber) end

---Get all players, excluding bots.
---@return Player[] players A list of all Player objects, excluding bots.
function players.getNonBots() end

---Get all players that are bots.
---@return Player[] bots A list of all Player objects that are bots.
function players.getBots() end

---Create a new bot player.
---@return Player? bot The created bot player, or nil on failure.
function players.createBot() end

---Library for managing Human objects.
---humans[index: integer] -> Human
humans = {}

---Get all humans.
---@return Human[] humans A list of all Human objects.
function humans.getAll() end

---Get the number of humans.
---@return integer count How many Human objects there are.
function humans.getCount() end

---Create a new human.
---@param position Vector The position of the new Human.
---@param rotation RotMatrix The rotation of the new Human.
---@param player Player The player whose human this will be.
---@return Human? human The created human, or nil on failure.
function humans.create(position, rotation, player) end

---Library for managing ItemType objects.
---itemTypes[index: integer] -> ItemType
itemTypes = {}

---Get all item types.
---@return ItemType[] itemTypes A list of all ItemType objects.
function itemTypes.getAll() end

---Get the number of item types.
---@return integer count How many ItemType objects there are.
function itemTypes.getCount() end

---Get an item type by its name.
---@param name string The exact name of the item type to search for. Case sensitive.
---@return ItemType? itemType The found item type, or nil.
function itemTypes.getByName(name) end

---Library for managing Item objects.
---items[index: integer] -> Item
items = {}

---Get all items.
---@return Item[] items A list of all Item objects.
function items.getAll() end

---Get the number of items.
---@return integer count How many Item objects there are.
function items.getCount() end

---Create a new item.
---@param type ItemType The type of the item.
---@param position Vector The position of the item.
---@param rotation RotMatrix The rotation of the item.
---@return Item? item The created item, or nil on failure.
function items.create(type, position, rotation) end

---Create a new item.
---@param type ItemType The type of the item.
---@param position Vector The position of the item.
---@param velocity Vector The initial velocity of the item.
---@param rotation RotMatrix The rotation of the item.
---@return Item? item The created item, or nil on failure.
function items.create(type, position, velocity, rotation) end

---Create a floppy rope consisting of many items.
---@param position Vector The position of the rope. Seems to be offset.
---@param rotation Vector The rotation of the rope.
---@return Item? item The created item, or nil on failure.
---@deprecated
function items.createRope(position, rotation) end

---Library for managing VehicleType objects.
---vehicleTypes[index: integer] -> VehicleType
vehicleTypes = {}

---Get all vehicle types.
---@return VehicleType[] vehicleTypes A list of all VehicleType objects.
function vehicleTypes.getAll() end

---Get the number of vehicle types.
---@return integer count How many VehicleType objects there are.
function vehicleTypes.getCount() end

---Get a vehicle type by its name.
---@param name string The exact name of the vehicle type to search for. Case sensitive.
---@return VehicleType? vehicleType The found vehicle type, or nil.
function vehicleTypes.getByName(name) end

---Library for managing Vehicle objects.
---vehicles[index: integer] -> Vehicle
vehicles = {}

---Get all vehicles.
---@return Vehicle[] vehicles A list of all Vehicle objects.
function vehicles.getAll() end

---Get all vehicles that are not bots.
---@return Vehicle[] vehicles A list of all Vehicle objects that are not bots.
function vehicles.getNonTrafficCars() end

---Get all vehicles that are bots.
---@return Vehicle[] vehicles A list of all Vehicle objects that are bots.
function vehicles.getTrafficCars() end

---Get the number of vehicles.
---@return integer count How many Vehicle objects there are.
function vehicles.getCount() end

---Create a new vehicle.
---@param type VehicleType The type of the vehicle.
---@param position Vector The position of the vehicle.
---@param rotation RotMatrix The rotation of the vehicle.
---@param color integer The color of the vehicle.
---@return Vehicle? vehicle The created vehicle, or nil on failure.
function vehicles.create(type, position, rotation, color) end

---Library for managing Bullet objects.
bullets = {}

---Get all bullets.
---@return Bullet[] bullets A list of all Bullet objects.
function bullets.getAll() end

---Get the number of bullets.
---@return integer count How many Bullet objects there are.
function bullets.getCount() end

---Create a bullet.
---@param bulletType integer The type of bullet.
---@param position Vector The initial position of the bullet.
---@param velocity Vector The initial velocity of the bullet.
---@param player? Player The player who fired this bullet.
---@return Bullet? bullet The created bullet, or nil on failure.
function bullets.create(bulletType, position, velocity, player) end

---Library for managing RigidBody objects.
---rigidBodies[index: integer] -> RigidBody
rigidBodies = {}

---Get all rigid bodies.
---@return RigidBody[] rigidBodies A list of all RigidBody objects.
function rigidBodies.getAll() end

---Get the number of rigid bodies.
---@return integer count How many RigidBody objects there are.
function rigidBodies.getCount() end

---Library for managing Bond objects.
---bonds[index: integer] -> Bond
bonds = {}

---Get all bonds.
---@return Bond[] bonds A list of all Bond objects.
function bonds.getAll() end

---Get the number of bonds.
---@return integer count How many Bond objects there are.
function bonds.getCount() end

---Library for managing Street objects.
---streets[index: integer] -> Street
streets = {}

---Get all streets.
---@return Street[] streets A list of all Street objects.
function streets.getAll() end

---Get the number of streets.
---@return integer count How many Street objects there are.
function streets.getCount() end

---Library for managing StreetIntersection objects.
---intersections[index: integer] -> StreetIntersection
intersections = {}

---Get all street intersections.
---@return StreetIntersection[] intersections A list of all StreetIntersection objects.
function intersections.getAll() end

---Get the number of street intersections.
---@return integer count How many StreetIntersection objects there are.
function intersections.getCount() end

---Library for managing TrafficCar objects.
---trafficCars[index: integer] -> TrafficCar
trafficCars = {}

---Get all traffic cars.
---@return TrafficCar[] cars A list of all TrafficCar objects.
function trafficCars.getAll() end

---Get the number of traffic cars.
---@return integer count How many TrafficCar objects there are.
function trafficCars.getCount() end

---Randomly create some traffic cars.
---@param amount integer The number of cars to create.
function trafficCars.createMany(amount) end

---Library for managing corporations.
---corporations[index: integer] -> Corporation
corporations = {}

---Get all corporations.
---@return Corporation[] buildings A list of all corporations.
function corporations.getAll() end

---Get the number of corporations.
---@return integer count How many corporations there are.
function corporations.getCount() end

---Library for managing Building objects.
---buildings[index: integer] -> Building
buildings = {}

---Get all buildings.
---@return Building[] buildings A list of all Building objects.
function buildings.getAll() end

---Get the number of buildings.
---@return integer count How many Building objects there are.
function buildings.getCount() end

---Library for managing Event objects.
---events[index: integer] -> Event
events = {}

---Get all events.
---@return Event[] events A list of all Event objects.
function events.getAll() end

---Get the number of events.
---@return integer count How many Event objects there are.
function events.getCount() end

---Display a bullet with a sound, tracer, and optionally a muzzle flash and casing.
---@param bulletType integer The type of bullet.
---@param position Vector The initial position the bullet.
---@param velocity Vector The initial velocity of the bullet.
---@param item? Item The item the bullet came from.
---@return Event event The created event.
function events.createBullet(bulletType, position, velocity, item) end

---Indicate a bullet has hit a person or thing.
---@param hitType integer The type of hit. 0 = bullet hole (stays until round reset), 1 = human hit (blood), 2 = car hit (metal), 3 = blood drip (bleeding).
---@param position Vector The position the bullet hit.
---@param normal Vector The normal of the surface the bullet hit.
---@return Event event The created event.
function events.createBulletHit(hitType, position, normal) end

---Show a chat message.
---@param speakerType integer The type of message. 0 = dead chat, 1 = human speaking, 2 = item speaking, 3 = MOTD, 4 = to admins, 5 = billboard, 6 = to player.
---@param message string The message to send. Max length 63.
---@param speakerIndex integer The index of the speaker object of the corresponding type, if applicable, or -1.
---@param volumeLevel integer The volume to speak at. 0 = whisper, 1 = normal, 2 = yell.
---@return Event event The created event.
function events.createMessage(speakerType, message, speakerIndex, volumeLevel) end

---Play a sound.
---@param soundType integer The type of the sound.
---@param position Vector The position of the sound.
---@param volume number The volume of the sound, where 1.0 is standard.
---@param pitch number The pitch of the sound, where 1.0 is standard.
---@return Event event The created event.
function events.createSound(soundType, position, volume, pitch) end

---Play a sound.
---@param soundType integer The type of the sound.
---@param position Vector The position of the sound.
---@return Event event The created event.
function events.createSound(soundType, position) end

---Play a sound from an item.
---@param soundType integer The type of the sound.
---@param item Item The item to play the sound from.
---@return Event event The created event.
function events.createSound(soundType, item) end

---Play a sound.
---@param soundType integer The type of the sound.
---@param item Item The item to play the sound from.
---@param volume number The volume of the sound, where 1.0 is standard.
---@param pitch number The pitch of the sound, where 1.0 is standard.
---@return Event event The created event.
function events.createSound(soundType, item, volume, pitch) end

---Display a grenade explosion.
---@param position Vector The position to show the explosion at.
---@return Event event The created event.
function events.createExplosion(position) end

---Manual update corp mission event creation. Only use this if you know what you're doing!
---Use corporation:updateMission instead!
---@see Corporation.updateMission
---@param corpIdx integer Corporation index in memory.
---@param missionIdx integer Mission index in memory.
function events.createEventUpdateCorpMission(corpIdx, missionIdx) end

---Internal game networking function. Only use this if you know EXACTLY what you're doing!
function events.prepareObjectPacket() end

---Library for directly reading and writing any memory.
memory = {}

---Get the base address of the server executable.
---@return integer address
function memory.getBaseAddress() end

---Get the address of a game object.
---@param object Connection|Account|Player|Human|ItemType|Item|Vehicle|Bullet|Bone|RigidBody|Bond|Action|MenuButton|StreetLane|Street|StreetIntersection|Building|Corporation|Event|Voice|EarShot
---@return integer address
function memory.getAddress(object) end

---Read a signed 1-byte integer from memory.
---@param address integer
---@return integer value
function memory.readByte(address) end

---Read an unsigned 1-byte integer from memory.
---@param address integer
---@return integer value
function memory.readUByte(address) end

---Read a signed 2-byte integer from memory.
---@param address integer
---@return integer value
function memory.readShort(address) end

---Read an unsigned 2-byte integer from memory.
---@param address integer
---@return integer value
function memory.readUShort(address) end

---Read a signed 4-byte integer from memory.
---@param address integer
---@return integer value
function memory.readInt(address) end

---Read an unsigned 4-byte integer from memory.
---@param address integer
---@return integer value
function memory.readUInt(address) end

---Read a signed 8-byte integer from memory.
---@param address integer
---@return integer value
function memory.readLong(address) end

---Read an unsigned 8-byte integer from memory.
---@param address integer
---@return integer value
function memory.readULong(address) end

---Read a single-precision floating point number from memory.
---@param address integer
---@return number value
function memory.readFloat(address) end

---Read a double-precision floating point number from memory.
---@param address integer
---@return number value
function memory.readDouble(address) end

---Read many bytes from memory.
---@param address integer
---@param count integer The number of bytes to read.
---@return string bytes
function memory.readBytes(address, count) end

---Write a signed 1-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeByte(address, value) end

---Write an unsigned 1-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeUByte(address, value) end

---Write a signed 2-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeShort(address, value) end

---Write an unsigned 2-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeUShort(address, value) end

---Write a signed 4-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeInt(address, value) end

---Write an unsigned 4-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeUInt(address, value) end

---Write a signed 8-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeLong(address, value) end

---Write an unsigned 8-byte integer to memory.
---@param address integer
---@param value integer
function memory.writeULong(address, value) end

---Write a single-precision floating point number to memory.
---@param address integer
---@param value integer
function memory.writeFloat(address, value) end

---Write a double-precision floating point number to memory.
---@param address integer
---@param value integer
function memory.writeDouble(address, value) end

---Write many bytes to memory.
---@param address integer
---@param bytes string The bytes to write.
function memory.writeBytes(address, bytes) end

---Convert a 1-byte integer value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexByte(value) end

---Convert a 2-byte integer value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexShort(value) end

---Convert a 4-byte integer value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexInt(value) end

---Convert a 8-byte integer value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexLong(value) end

---Convert a 4-byte single-precision floating point value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexFloat(value) end

---Convert a 8-byte double-precision floating point value into a hexadecimal string.
---@param value integer
---@return string value
function memory.toHexDouble(value) end

---Converts every byte in a string of arbitrary length into a hexadecimal string.
---@param value string
---@return string value
function memory.toHexString(value) end

---@class ListDirectoryEntry
---@field isDirectory boolean Whether the entry is a directory.
---@field name string The name of the file/directory. Ex. "asphalt2.png".
---@field stem string The stem of the filename if this is a file. Ex. "asphalt2".
---@field extension string The extension of the filename if this is a file. Ex. ".png".

---Get the contents of a directory.
---Available in worker threads.
---@param path string The path to the directory to scan.
---@return ListDirectoryEntry[] entries A list of all entries in the directory.
function os.listDirectory(path) end

---Create a directory if it does not already exist.
---Available in worker threads.
---@param path string The path of the directory.
---@return boolean created Whether the directory was created.
function os.createDirectory(path) end

---Get the time that a file was last modified.
---Available in worker threads.
---@param path string The path of the file to check.
---@return number lastWriteTime The time that the file was last modified as a precise fractional Unix timestamp in seconds.
function os.getLastWriteTime(path) end

---Get an accurate clock value counting up in real seconds.
---Available in worker threads.
---@return number seconds The number of seconds elapsed, with millisecond precision.
function os.realClock() end

---Send a message to the main thread.
---Only available in worker threads.
---Adds to a queue such that when receiveMessage is called on the worker object in the main thread, this message can be returned.
---@param message string The message to send to the main thread.
---@see Worker#receiveMessage
function sendMessage(message) end

---Pop a message from the queue of messages received from the main thread.
---Only available in worker threads.
---@return string? message The oldest remaining message received from the main thread, or nil if none are left.
---@see Worker#sendMessage
function receiveMessage() end

---Suspend this thread for a number of milliseconds.
---Only available in worker threads.
---@param ms integer The number of milliseconds to sleep for.
---@return boolean isDestroyed Whether the main thread has destroyed the Worker object responsible for this thread while it was sleeping. If true, execution of this thread has to finish.
function sleep(ms) end