Build your first Hexis script
Start here every time you make a new script. Choose the job, open its guide, run one complete action, then add one behavior at a time.
The four-step workflow
- Choose the job. Describe what the player should accomplish.
- Open the matching guide. Copy its smallest Lua pattern and request the capabilities it names.
- Run one complete action. Wait for the result and handle failure or cancellation.
- Add the next behavior. Use the script library after the first action works.
What kind of script do you want to build?
Mine blocks →
Mine one exact coordinate, choose one matching block, finish a connected vein or tree, or clear matching blocks inside a bounded place.
Automate a GUI →
Read the open screen, find a current slot, submit one guarded operation, and observe the result.
Fight mobs →
Fire once, engage known targets, or let Hexis acquire matching mobs.
Navigate →
Walk to a coordinate, enter a named area, or read work points from a route.
Farm crops →
Harvest a bounded crop patch and understand what continuous row farming still needs.
Show a HUD →
Publish sections, values, progress, and item icons for the current run.
Observe the world →
Read the crosshair, blocks, entities, routes, or tab list without taking control.
Use inventory or interact →
Hold the right item, use one observed target, then verify what changed.
React to events →
Wait for filtered GUI or chat events and race an event against an action.
Your smallest complete action
Lua chooses a goal. Hexis owns the movement, camera, input, cleanup, and final result:
function hexis.main()
local result = hexis.await(hexis.navigate.to({
destination = {x = 12, y = 70, z = -8},
arrive_within = 2.0,
}), {timeout = 60})
if not result.ok then
return
end
end
If you are starting from an empty directory, create your first bundle. Then run and test it.
When to use the API reference
Start with a job guide, not the API reference. Open the reference when you need the exact member name, capability, request field, or result shape.
For larger compositions, browse the maintained script library.