61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
|
|
---
|
|
# Contents
|
|
|
|
[TOC]
|
|
|
|
|
|
---
|
|
# Introduction
|
|
|
|
Object instance: `luajava`
|
|
|
|
|
|
---
|
|
## Description
|
|
|
|
`luajava` is an object of the [LuajavaLib library][home.luaj]. It can be used to coerce Java static
|
|
objects to Lua or create new Java object instances.
|
|
|
|
|
|
---
|
|
# Examples
|
|
|
|
Example of exposing a static object &enums to Lua:
|
|
|
|
```lua
|
|
-- store a Java enum in a Lua global variable
|
|
ConversationStates = luajava.bindClass("games.stendhal.server.entity.npc.ConversationStates")
|
|
|
|
-- access the enum values like so
|
|
ConversationStates.IDLE
|
|
```
|
|
|
|
Example of creating an object instance:
|
|
|
|
```lua
|
|
-- store instance in local variable
|
|
local dog = luajava.newInstance("games.stendhal.server.entity.npc.SilentNPC")
|
|
-- access object methods like so
|
|
dog:setEntityClass("animal/puppy")
|
|
dog:setPosition(2, 5)
|
|
|
|
-- class with constructor using parameters
|
|
local speaker = luajava.newInstance("games.stendhal.server.entity.npc.SpeakerNPC", "Frank")
|
|
speaker:setOutfit("body=0,head=0,eyes=0,hair=5,dress=5")
|
|
speaker:setPosition(2, 6)
|
|
```
|
|
|
|
|
|
---
|
|
# Synopsis
|
|
|
|
To make scripting easier, Stendhal employs a [master script][init.lua] & some
|
|
[helper objects & methods][objects] to handle the functionality mentioned above.
|
|
|
|
|
|
[home.luaj]: http://luaj.org/luaj.html
|
|
|
|
[init.lua]: https://github.com/arianne/stendhal/blob/master/src/games/stendhal/server/core/scripting/lua/init.lua
|
|
|
|
[objects]: /reference/lua/objects
|