0.11.12026-10-21
This release addresses a security vulnerability with HTTPS certificates. If you are using net.request, especially with untrusted / dynamic input, it is suggested that you upgrade Lune. You can read more about the vulnerability here.
Fixed
- Fixed a regression where passing fractional numeric args to certain datatype constructors in @lune/roblox would error in Lune 0.12 while they did not in 0.11 nor in Roblox
0.11.02026-10-11
This version of Lune contains one breaking change for scripts - the stop function on web server handles returned by net.serve is now a method, meaning handle.stop() is now handle:stop().
If you use any of the Lune crates as a dependency, Lune now also uses mlua version 0.12, and you may need to upgrade as well.
Added
- Added a size field to the metadata returned by fs.metadata, containing the file size in bytes, or nil for directories ([#405])
- Added FromName and FromValue methods to the Enum datatype in the roblox standard library ([#423])
Changed
- Web server handles returned by net.serve now use standard Lua method calling convention and colon syntax, just like web sockets - handle.stop() is now handle:stop()
- Improved the documentation for roblox.getAuthCookie and for web sockets in the net standard library
- Updated to Luau version 0.740
- Updated to rbx-dom database version 0.741
Fixed
- Fixed the close method on web sockets always erroring with "Socket has been closed" instead of closing the socket ([#400])
- Fixed the documentation for serde.hmac saying it returns a base64 string, when it returns a hex string ([#417])
- Fixed CFrame.lookAt, CFrame.lookAlong and CFrame.new(pos, lookAt) producing incorrect rotations when not rotating purely around the Y axis ([#419])
- Fixed Color3:ToHex truncating color channels instead of rounding them, and returning uppercase hex digits instead of lowercase ([#410])
- Fixed net.serve responding with a 500 error when a response table does not contain a status, which now defaults to 200
- Fixed methods and properties added using roblox.implementMethod and roblox.implementProperty being shadowed by children with the same name
- Fixed Enum and EnumItem values in the roblox standard library not having a stable identity, making them unusable as table keys
- Fixed type definitions for the net standard library missing the http and ws submodules, as well as the ip and port fields on ServeHandle
- Fixed the MetadataKind type definition including symlink, which fs.metadata never returns since symlinks are always followed ([#405])
- Fixed the documentation for captures in the regex standard library describing it as finding all matches, when it only returns the capture groups of the first match
Internal Changes
- Upgraded to mlua version 0.12 - if you use any of the Lune crates as a dependency, you may also need to upgrade
- Removed the deprecated jit module alias from the lune-utils crate - please use the process module directly instead
- Updated all dependencies to their latest major versions, and removed several unused ones
[#405]: https://github.com/lune-org/lune/pull/405
[#423]: https://github.com/lune-org/lune/pull/423
[#400]: https://github.com/lune-org/lune/pull/400
[#417]: https://github.com/lune-org/lune/pull/417
[#419]: https://github.com/lune-org/lune/pull/419
[#410]: https://github.com/lune-org/lune/pull/410
0.10.52026-07-02
Added
- Added QueryDescendants to instances in the roblox standard library.
- Added registerClass and registerService functions to the roblox standard library, letting classes and services that
the reflection database does not know about - such as those only present in specific Roblox builds - be implemented and used:
``luau
local roblox = require("@lune/roblox")
roblox.registerService("FileSystemService")
roblox.implementMethod("FileSystemService", "ReadFile", function(_, path: string)
return -- ... read and return the file contents ...
end)
local game = roblox.Instance.new("DataModel")
local fss = game:GetService("FileSystemService")
`
Changed
- Refactored the roblox standard library to support multiple independent doms. Instances now have stable references,
and place or model files containing colliding referents can be loaded at the same time without conflicts.
- Updated to Luau version 0.709
- Updated to rbx-dom database version 0.728
Fixed
- Fixed task.wait not gracefully handling negative, NaN, and other non-finite durations
- Fixed datatype arithmetic in @lune/roblox not working with a scalar on the left-hand side, such as 2 * Vector3.new(1, 2, 3)
- Fixed various completeness and correctness issues across datatypes in the roblox standard library
- Fixed web socket close codes not being set to 1005 (no status) or 1006 (abnormal closure) when a connection was closed without one
- Fixed error stack traces truncating real file paths on Windows
- Fixed NumberSequence.new(start, end) silently ignoring its second constructor argument
- Fixed ColorSequence.new(start, end) silently ignoring its second constructor argument ([#391])
- Fixed the close method on a child process writer not closing it ([#359])
- Fixed truncation of lune build` output paths containing dots on non-Windows targets ([#396])
- Fixed deserialization of Roblox place/model files failing due to Tags now serializing using SharedString ([#397])
[#391]: https://github.com/lune-org/lune/pull/391
[#359]: https://github.com/lune-org/lune/pull/359
[#396]: https://github.com/lune-org/lune/pull/396
[#397]: https://github.com/lune-org/lune/pull/397
0.10.42025-10-14
Added
- Added support for the jsonc serialization format in the serde standard library
- Added an mlua feature flag to lune-roblox, so that it may be used from Rust without bundling the entirety of Luau
Changed
- Updated to rbx-dom database version 0.694
- Updated to Luau version 0.694
Fixed
- Fixed attribute name validation being too strict in the roblox standard library, not allowing the characters /.-
- Fixed various issues in the roblox standard library caused by an outdated reflection database and version of rbx-dom ([#358])
[#358]: https://github.com/lune-org/lune/pull/358
0.10.32025-10-06
Changed
- Updated to Luau version 0.693
Fixed
- Fixed readToEnd being slow for child processes with large output ([#354])
- Fixed process.exec not reading stdio until child exits ([#353])
[#354]: https://github.com/lune-org/lune/pull/354
[#353]: https://github.com/lune-org/lune/pull/353
0.10.22025-08-31
Added
- Added support for the ZSTD compression format in the serde standard library ([#339])
- Added support for UniqueId properties to the roblox standard library ([#343])
- Added prebuilt Lune binaries for Windows on ARM to GitHub releases
Changed
- Updated to Luau version 0.688
- Lune no longer depends on liblzma, making it easier to install on macOS
- Prebuilt binaries for Ubuntu now use an older version (22.04) for better GLIBC compatibility
Fixed
- Fixed Lune crashing while emitting an error and parsing its source
[#339]: https://github.com/lune-org/lune/pull/339
[#343]: https://github.com/lune-org/lune/pull/343
0.10.12025-07-16
Fixed
- Fixed a regression where it was not possible to run directories with init.luau files in them directly using lune run directory-name.
- Fixed a panic when calling process.exit inside a file that require was called on. ([#333])
- Fixed a panic when calling process.exit inside a request handler for net.serve. ([#333])
[#333]: https://github.com/lune-org/lune/pull/333
0.10.02025-07-15
This version of Lune contains a major internal refactoring of the require function, now using the proper require-by-string APIs exposed by Luau.
If you relied on any (incorrect) behavior of relative, non-@self requires, from within init.luau files in Lune 0.9.0, you may need to update your code.
No other usages of require will be affected - but if you previously encountered any internal bugs or panics during require, these will have been fixed!
Added
- Added support for TCP client in the net standard library.
It may be used either with TLS or not, and basic usage looks as such:
``luau
-- Plain TCP connections
local stream = net.tcp.connect("example.com", 80)
-- TLS connections (shorthand)
local tlsStream = net.tcp.connect("example.com", 443, true)
-- Connections with custom TLS setting & TTL
local customStream = net.tcp.connect("192.168.1.100", 8080, {
tls = false,
ttl = 128
})
-- Interacting with the stream
tlsStream:write("GET / HTTP/1.1\r\nHost: example.com\r\n\r\n")
while true do
local data = tlsStream:read()
if data ~= nil then
print(data)
else
break -- Connection was closed
end
end
`
- Added submodules to the net standard library: http, tcp, and ws.
These will be the preferred way of interacting with the net standard library going forward, but none of the old functions have been removed or deprecated yet to allow users time to migrate.
In a future major version of Lune, direct functions such as net.socket will be removed in favor of their equivalent functions in submodules, such as net.ws.connect. Here is the full new list of functions:
- net.http.request
- net.http.serve
- net.tcp.connect
- net.ws.connect
- Added a method with_lib to the Runtime struct in the lune crate, to allow registering custom libraries.
Changed
- Updated to Luau version 0.682
- Upgraded to mlua version 0.11 - if you use any of the Lune crates as a dependency, you may also need to upgrade
Fixed
- Fixed errors being emitted twice when the error is thrown from the main (entrypoint) script
- Fixed a panic when calling net.request and related functions in the main body of a module during require`
- Fixed various issues with not conforming to the new Luau require-by-string semantics
0.9.42025-06-13
Changed
- lune setup now properly sets up a .luaurc file instead of using legacy VSCode-specific settings
- process.args and process.env are now plain tables again - not userdata - thank you to everyone who provided feedback on this and the usability issues!
Fixed
- Fixed invalid handling of http redirects in net.request
- Fixed not being able to download binaries for cross-compiling with lune build
- Fixed binary output when running lune build not being deterministic and sometimes truncating
- Fixed cargo install lune failing due to a yanked dependency ([#323])
[#323]: https://github.com/lune-org/lune/pull/323
0.9.32025-05-06
Added
- Added support for non-UTF8 strings in arguments to process.exec and process.spawn
Changed
- Improved cross-platform compatibility and correctness for values in process.args and process.env, especially on Windows
Fixed
- Fixed stdin not being properly closed when not providing the stdin option to process.exec
- Fixed various crashes during require that had the error cannot mutably borrow app data container