the cool awesome updates!!!

BlockTypes.lua

@@ -0,0 +1,60 @@
+--- BlockTypes library for easier use of block types.
+...
+
+--- Impervious block type. ("impervious")
+IMPERVIOUS = "impervious"
+
+--- Weak block type. ("weak")
+WEAK = "weak"
+
+--- Active block type. ("active")
+ACTIVE = "active"
+
+--- Start block type. ("start")
+START = "start"
+
+--- Inactive block type. ("inactive")
+INACTIVE = "inactive"
+
+--- Change block type. ("change")
+CHANGE = "change"
+
+--- Move block type. ("move")
+MOVE = "move"
+
+--- Water block type. ("water")
+WATER = "water"
+
+--- Reactor block type. ("reactor")
+REACTOR = "reactor"
+
+--- Generator block type. ("generator")
+GENERATOR = "generator"
+
+--- Inactive lua block type. ("lua inactive")
+INACTIVE_LUA = "lua inactive"
+
+--- Water lua block type. ("lua water")
+WATER_LUA = "lua water"
+
+
+--- Checks if a block type string is of an active block type.
+--- @param type The block type string
+--- @treturn boolean Returns whether the block type string is of an active block type.
+--- @usage isActive = BlockTypes.isActive(block.type)
+function isActive(type)
+end
+
+--- Checks if a block type string is of an inactive block type.
+--- @param type The block type string
+--- @treturn boolean Returns whether the block type string is of an inactive block type.
+--- @usage isInactive = BlockTypes.isInactive(block.type)
+function isInactive(type)
+end
+
+--- Checks if a block type string is of a water block type.
+--- @param type The block type string
+--- @treturn boolean Returns whether the block type string is of a water block type.
+--- @usage isWater = BlockTypes.isWater(block.type)
+function isWater(type)
+end

RNG.lua

@@ -16,12 +16,12 @@ end
 
 --- Functions the same as math.randomseed(seed), but affecting the RNG object's state.
 --- Sets the pseudo-random generator's seed: equal seeds produce equal sequences of numbers.
---- @tparam int seed (optional) An optional number input to set the seed with. If none is given, a client-generated seed is used.
+--- @tparam number seed (optional) An optional number input to set the seed with. If none is given, a client-generated seed is used.
 --- @usage RNG.randomseed(151260123)
 function randomseed(seed)
 end
 
---- Returns the RNG object's seed.
---- @treturn int The RNG object's seed.
+--- Returns the last number the RNG object was seeded with
+--- @treturn number The RNG object's seed.
 function getseed()
 end

block.lua

@@ -16,6 +16,13 @@ xpos = 0
 --- The absolute y-position of the block.
 ypos = 0
 
+--- An array containing all of a block's block tags. The tags themselves are strings.
+blockTags = 0
+
+--- A string describing a block's type.
+--- @see BlockTypes
+type = "active"
+
 --- The event handler for block break. This event may be cancelled to prevent the block from breaking.
 --- 
 --- Provides the broken block, the side from which it was broken, and the reason;
@@ -25,13 +32,13 @@ ypos = 0
 --- @usage game.level.getBlockAt(5, 7).onBreak.addListener(function(event)
 ----     event.cancelled = true --Prevents the block from breaking
 ----     
-----     local block = tolua(event.block)
-----     local side = tolua(event.side)
-----     local reason = tolua(event.reason)
+----     local block = event.block
+----     local side = event.side
+----     local reason = event.reason
 ----     
-----     if tolua(instanceof(reason, Projectile)) then --Checks if an item was used to break the block
-----         local shooter = tolua(reason.shooter)
-----         if tolua(instanceof(shooter, LocalPlayer)) then --Checks if the shooter is the local player
+----     if instanceof(reason, Projectile) then --Checks if an item was used to break the block
+----         local shooter = reason.shooter
+----         if instanceof(shooter, LocalPlayer) then --Checks if the shooter is the local player
 ----             shooter.hurt()
 ----         end
 ----     end
@@ -150,7 +157,7 @@ end
 
 --- Returns the block's texture as a lua stamp.
 --- The texture is the block's raw texture, not accounting for effects such as vanishing, freezing, dye, etc.
---- @usage local stamp = tolua(block.getStamp())
+--- @usage local stamp = block.getStamp()
 --- @treturn stamp The block's texture, or nil if the player has backgrounds disabled in their settings.
 function getStamp()
 end
@@ -159,7 +166,7 @@ end
 --- @tparam int x How many blocks to the right the wanted block is?
 --- @tparam int y How many blocks downwards the wanted block is?
 --- @tparam boolean keepPlayerReference Is the player reference kept? By default false.
---- @treturn block The found block as an object. Returns nil if a block isn't found.
+--- @treturn block The found block as an object. Returns safe null if a block isn't found.
 --- @usage block.getblock(0,-1).shatter()
 function getblock(x, y, keepPlayerReference)
 end
@@ -180,3 +187,12 @@ end
 --- @usage block.getmetadata("block name", "unnamed")
 function getmetadata(key, defaultValue)
 end
+
+--- Returns the first matching block tag, or nil if none is found
+--- @tparam string tag The tag to search for
+--- @tparam boolean isExact If true, only search for tags that match exactly. Otherwise, matches with any tag that contains the given string. True by default
+--- @return Returns the first matching block tag, or nil if none is found.
+--- @usage if block.searchTag("awesome", true) then player.chat("Awesome!") end
+--- @usage local startTag = block.searchTag("start", false)
+function searchTag(tag, isExact)
+end

game.lua

@@ -45,8 +45,8 @@ _METADATA = {}
 ----     lock = event.acquireLock()
 ----     
 ----     game.requestUserData(function(data, error)
-----         data = tolua(data)
-----         error = tolua(error)
+----         data = data
+----         error = error
 ----         -- Do something here
 ----         lock.dispose()
 ----     end)
@@ -73,8 +73,8 @@ enterFrame = nil
 ---
 --- tolua method must be used for every variable you get from the gameEvent.
 --- @usage game.gameEvent.addListener(function(event)
-----     local data = tolua(event.data)
-----     local sender = tolua(event.source)
+----     local data = event.data
+----     local sender = event.source
 ----     -- Do something here
 ---- end)
 gameEvent = nil
@@ -86,8 +86,8 @@ gameEvent = nil
 ---- end)
 playerRemoved = nil
 
---- Returns a new lua-side RNG object (tolua not needed), seeded by the given seed, or a generated client seed is none is given.
---- int seed (optional) An optional number input to set the seed with. If none is given, a client-generated seed is used.
+--- Returns a new lua-side RNG object, seeded by the given seed, or a generated client seed is none is given.
+--- @tparam int seed (optional) An optional number input to set the seed with. If none is given, a client-generated seed is used.
 --- @treturn RNG The new RNG object.
 --- @usage local rng = game.newRNG(51832591)
 --- @see RNG
@@ -132,7 +132,7 @@ end
 --- @see timer
 --- @usage alienSpawnTimer = game.newTimer(1000 * 10, -1, function()
 ----     -- Spawns a new alien every 10 seconds (in simulated game time)
-----     game.level.newAlien(1, tolua(game.elapsedMS), toobject{})
+----     game.level.newAlien(1, game.elapsedMS, toobject{})
 ---- end)
 function newTimer(interval, maxCount, listener)
 end
@@ -148,11 +148,11 @@ end
 --- @treturn timer The created timer object.
 --- @see timer
 --- @usage playerDiedTimer = game.newRealTimer(100, -1, function()
-----     if (not player) or (tolua(player.health) > 0) then
+----     if (not player) or (player.health > 0) then
 ----         return
 ----     end
 ----     
-----     player.chat("You died around " .. (tolua(playerDiedTimer.elapsedMS) / 1000) .. " seconds after the timer started!")
+----     player.chat("You died around " .. (playerDiedTimer.elapsedMS / 1000) .. " seconds after the timer started!")
 ----     playerDiedTimer.destroy()
 ---- end)
 function newRealTimer(interval, maxCount, listener)
@@ -169,15 +169,14 @@ end
 --- This is an asynchronous method; it will not pause the script while the request is processing.
 --- Instead, it will later run the given callback function once the request has completed or failed.
 ---
---- tolua method must be used for every variable you get from the userdata, as well as for the error message.
 --- @tparam function callback The function that will be called once the request has completed or failed.
 --- @usage game.requestUserData(function(data, error)
-----     if tolua(error) ~= nil then
-----         player.chat("Error loading user data: " .. tostring(tolua(error)), 0xFF0000)
+----     if error ~= nil then
+----         player.chat("Error loading user data: " .. tostring(error), 0xFF0000)
 ----     else
-----         player.speed = tolua(data.speed)
-----         player.accel = tolua(data.accel)
-----         player.jump = tolua(data.jump)
+----         player.speed = data.speed
+----         player.accel = data.accel
+----         player.jump = data.jump
 ----     end
 ---- end)
 --- @see saveUserData
@@ -190,18 +189,18 @@ end
 --- Instead, it will later run the given callback function once the request has completed or failed.
 ---
 --- toobject method must be used for the userdata if it is a table.
---- tolua method must be used for the error message.
+--- Buffer data cannot be sent over the network currently, it must be converted to a string with the BufferUtils methods.
 --- @param userdata The userdata for the level that will be saved to the server.
 --- @tparam function callback The function that will be called once the request has completed or failed.
 --- @usage local userdata = {
-----     speed = tolua(player.speed),
-----     accel = tolua(player.accel),
-----     jump = tolua(player.jump)
+----     speed = player.speed,
+----     accel = player.accel,
+----     jump = player.jump
 ---- }
 ----     
 ---- game.saveUserData(toobject(userdata), function(error)
-----     if tolua(error) ~= nil then
-----         player.chat("Error saving user data: " .. tostring(tolua(error)), 0xFF0000)
+----     if error ~= nil then
+----         player.chat("Error saving user data: " .. tostring(error), 0xFF0000)
 ----     end
 ---- end)
 --- @see requestUserData

level.lua

@@ -16,7 +16,7 @@ maxY = 0
 --- Finds a block in the specific coordinates.
 --- @tparam int x The absolute x position.
 --- @tparam int y The absolute y position.
---- @treturn block Returns the found block, or nil if not found.
+--- @treturn block Returns the found block, or safe null if not found.
 function getBlockAt(x, y)
 end
 
@@ -25,7 +25,7 @@ end
 --- @see @{utils.totable|totable}
 --- @usage local blocks = totable(game.level.getAllBlocks()) 
 ---- for i, v in pairs(blocks) do
-----     v.setmetatable("index", i)
+----     v.setmetadata("index", i)
 ---- end
 function getAllBlocks()
 end
@@ -58,7 +58,7 @@ end
 --- @tparam int layerNum The layerNum of the art layer (equivalent to the ">" icon in Level Editor). By default 1. Greater layerNum layers are drawn above lesser layerNum layers, regardless of layer depth. layerNums of 2 or greater draw above blocks. 3 or greater draws above players, hats, projectiles, and other visual effects.
 --- @treturn artlayer The new art layer, or nil if the player has backgrounds disabled in their settings.
 --- @see artlayer
---- @usage local layer = tolua(game.level.newArtLayer(1, 3))
+--- @usage local layer = game.level.newArtLayer(1, 3)
 ---- if layer then
 ----     layer.drawStamp(someStamp)
 ---- end
@@ -80,7 +80,7 @@ end
 --- @tparam boolean smoothing Whether the stamp will be smoothed when scaled and rotated or not. By default false.
 --- @treturn stamp The new stamp, or nil if the player has backgrounds disabled in their settings.
 --- @see stamp
---- @usage local stamp = tolua(game.level.newStamp(500, 500))
+--- @usage local stamp = game.level.newStamp(500, 500)
 ---- if stamp then
 ----     stamp.setRect(0, 0, 500, 500, 0xFF000000)
 ----     someLayer.drawStamp(stamp)
@@ -99,7 +99,7 @@ end
 --- A sprite may also be set as the "parent" of other display objects, meaning that they will also be rendered whenever the sprite is rendered to an art layer, and with the same transformations as the sprite.
 --- @treturn sprite The new sprite, or nil if the player has backgrounds disabled in their settings.
 --- @see sprite
---- @usage local sprite = tolua(game.level.newSprite())
+--- @usage local sprite = game.level.newSprite()
 ---- if sprite then
 ----     sprite.beginFill(0xFF000000) -- Draw everything with a solid, fully opaque black.
 ----     sprite.drawCircle(0, 0, 250)
@@ -122,7 +122,7 @@ end
 --- @param vars An AS3 object containing other variables to provide to the text field, see the text field page for reference.
 --- @treturn textfield The new text field, or nil if the player has backgrounds disabled in their settings.
 --- @see textfield
---- @usage local textField = tolua(game.level.newTextField("Awesome Text", 24, 0x80FFCC))
+--- @usage local textField = game.level.newTextField("Awesome Text", 24, 0x80FFCC)
 ---- someLayer.drawTextField(text)
 function newTextField(text, size, color, vars)
 end

player.lua

@@ -198,7 +198,7 @@ end
 --- @treturn timer The created timer object.
 --- @usage healthRegenTimer = player.newTimer(1000 * 6, -1, function()
 ----   -- Heals 1 health every 6 seconds (in simulated game time)
-----   player.health = tolua(player.health) + 1
+----   player.health = player.health + 1
 ---- end)
 function newTimer(interval, maxCount, listener)
 end
@@ -212,11 +212,11 @@ end
 --- @tparam int maxCount How many intervals will be completed. Set to -1 for infinite intervals.
 --- @tparam function listener The listener to be called every time an iteration is completed.
 --- @treturn timer The created timer object.
---- @usage startElapsedTicks = tolua(game.elapsedTicks)
+--- @usage startElapsedTicks = game.elapsedTicks
 ---- tpsCountTimer = player.newRealTimer(1000 * 6, -1, function()
 ----   -- Reports average ticks per second over a 6 second interval
-----   player.chat(tostring((tolua(game.elapsedTicks) - startElapsedTicks) / 6))
-----   startElapsedTicks = tolua(game.elapsedTicks)
+----   player.chat(tostring((game.elapsedTicks - startElapsedTicks) / 6))
+----   startElapsedTicks = game.elapsedTicks
 ---- end)
 function newRealTimer(interval, maxCount, listener)
 end
@@ -609,7 +609,7 @@ end
 --- @usage local item = totable(player.getitem())
 ---- local item_name = item.typename
 ---- local item_ammo = item.ammo
---- @return Returns the item as an AS3 Object, with each key being the property name and each value being the property's value.
+--- @return Returns the item as an AS3 Object, with each key being the property name and each value being the property's value. If the player is not holding an item, returns safe null.
 --- 
 ---### Fields ###
 --- 
@@ -751,7 +751,7 @@ end
 --- Is the specified key currently pressed?
 --- @tparam int keycode The specified key that is being checked.
 --- @return Returns true if pressed, otherwise false.
---- @usage local Zpressed = tolua(player.keypressed(keys.Z))
+--- @usage local Zpressed = player.keypressed(keys.Z)
 --- @see @{utils.keys|keys}
 function keypressed(keycode)
 end

projectile.lua

@@ -3,5 +3,5 @@
 
 --- The shooter.
 --- May be either a @{utils.Player|Player} (which may also be a @{utils.LocalPlayer|LocalPlayer}) or nil.
---- @see @{utils.Player|Player}
-shooter = nil
+--- @see {utils.Player|Player}
+shooter = nil

sprite.lua

@@ -234,11 +234,11 @@ end
 --- @usage local colors = toarray{0xFF0000FF, 0xFFFFFFFF} -- The gradient will be blue on the left and white on the right
 ---- local ratios = toarray{0.3 * 255, 1 * 255} -- The gradient will be fully blue up to 30% of the way through the fill, then transition from blue to white across the remaining 70%
 ---- someSprite.lineStyle(0,24)
----- someSprite.gradientLineStyle(colors, ratios, toobject{width = 100, height = 200, spreadMethod = GradientSpreadMethod.PAD}) -- The width and height of the gradient box will now match that of our next draw call.
+---- someSprite.lineGradientStyle(colors, ratios, toobject{width = 100, height = 200, spreadMethod = GradientSpreadMethod.PAD}) -- The width and height of the gradient box will now match that of our next draw call.
 ---- someSprite.drawRect(0, 0, 100, 200)
 ---- someSprite.endFill()
 ---- someLayer.drawSprite(someSprite)
-function gradientLineStyle(colors, ratios, vars)
+function lineGradientStyle(colors, ratios, vars)
 end
 
 
@@ -269,15 +269,15 @@ end
 --- @see endFill
 --- @usage
 ---- someSprite.lineStyle(0,24)
----- someSprite.beginBitmapFill(someStamp,true,true,toobject{
+---- someSprite.lineBitmapStyle(someStamp,true,true,toobject{
 ----     x = 5, y = 5,
 ----     scaleX = 3, scaleY = 3,
 ----     rotation = 45
 ---- })
 ---- someSprite.drawRect(0,0,255,255)
 ---- someSprite.endFill()
 ---- someLayer.drawSprite(someSprite)
-function bitmapLineStyle(stamp, repeats, smooth, vars)
+function lineBitmapStyle(stamp, repeats, smooth, vars)
 end
 
 --- Sets the current drawing position used by `lineTo`, `curveTo`, and `cubicCurveTo` to the given coordinates.