Skip to main content
Version: latest - a1.7.0 ⚖️

User Interface

How to display information in the Screen for the Player.

In nanos world there are 2 official ways of plotting screen data: WebUI and Render Canvas.

caution

Although we highly recommend using WebUI, using Render Canvas is still supported but deprecated.

WebUI​

With WebUI you can load HTML pages which integrate with your Packages in Lua using Events.

Basic WebUI Setup​

This sample code shows how to add a basic page using HTML+JavaScript with the WebUI class.

info

Note: All WebUI code runs on Client side!

Client/Index.lua
-- Spawns a WebUI with the HTML file you just created
MyUI = WebUI("My UI", "file:///UI/index.html")

-- When the HTML is ready, triggers an Event in there
MyUI:Subscribe("Ready", function()
    MyUI:CallEvent("MyAwesomeEvent", "Hello! You are ready!")
end)

MyUI:Subscribe("MyAwesomeAnswer", function(param1)
    Package.Log("Received an answer! Message: " .. param1)
end)
Client/UI/index.html
<html>
    <head>
        <script src="index.js"></script>
    </head>
    <body>
        Hello World!
    </body>
</html>
Client/UI/index.js
// Register for "MyAwesomeEvent" from Lua
Events.Subscribe("MyAwesomeEvent", function(param1) {
    console.log("Triggered! " + param1);

    // Triggers "MyAwesomeAnswer" on Lua
    Events.Call("MyAwesomeAnswer", "Hey there!");
})

WebUI results

This will output:

[WebUI]  Triggered! Hello! You are ready!
[Script] Received an answer! Message: Hey there!
Basic HUD (HTML)getting-started/tutorials-and-examples/basic-hud-html

Canvas​

Basic HUD (Canvas)getting-started/tutorials-and-examples/basic-hud-canvas