static
new
(
string
game_id
= ""
)
static
new
(
string
game_id
= ""
,
string
def_name
)
->
(
boolean
)
static
from_def
(
string
def_name
,
string
game_id
= ""
)
->
(
am.character
)
->
(
string
)
->
(
am.character
)
->
(
string
)
->
(
am.character
)
->
(
number
)
->
(
am.character
)
->
(
am.stats
)
->
(
boolean
)
,
string
part_type
= UNKNOWN_PART
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
table
)
,
am.body_part
part
)
->
(
boolean
)
,
string
part_name
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
am.item
)
->
(
am.inventory
)
->
(
am.code
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
integer
)
,
number
x
,
number
y
)
->
(
integer
)
->
(
number
)
->
(
am.character
)
->
(
Race
)
->
(
am.character
)
->
(
am.character
)
->
(
string
)
->
(
am.character
)
->
(
am.coin_purse
)
->
(
am.sprite
)
->
(
am.character
)
->
(
am.character
)
->
(
number
,
number
)
,
number
y
)
->
(
am.character
)
->
(
integer
,
integer
)
,
integer
y
)
->
(
am.character
)
->
(
number
)
->
(
boolean
)
->
(
number
,
number
)
,
number
y
)
->
(
am.character
)
->
(
integer
,
integer
)
,
integer
y
)
->
(
am.character
)
,
number
y
)
->
(
am.character
)
,
integer
y
)
->
(
am.character
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
am.character
)
->
(
am.map
)
->
(
am.character
)
->
(
am.map
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
boolean
)
->
(
table
)
->
(
string
)
->
(
boolean
)
static
find
(
string
game_id
)
->
(
am.character
)
->
(
am.dialogue_component
)
,
boolean
set_attached
= true
)
->
(
)
,
function
listener
,
table
content
= nil
)
->
(
boolean
)
,
function
listener
,
table
context
= nil
)
->
(
boolean
)
->
(
boolean
)
->
(
integer
)
->
(
am.character
)
->
(
am.character
)
->
(
integer
)
->
(
am.character
)
->
(
am.character
)
->
(
integer
)
->
(
am.character
)
->
(
function
)
->
(
am.character
)
->
(
function
)
->
(
am.character
)
,
bool
by_movement
)
->
(
am.code
)
->
(
DataTable
)
->
(
am.character
)
static
new
(
string
game_id
= ""
)
static
new
(
string
game_id
= ""
,
string
def_name
)
->
(
boolean
)
static
from_def
(
string
def_name
,
string
game_id
= ""
)
->
(
am.character
)
Example (a test map Lua file):
npc = am.character.from_def("npcs:male1")
if (npc ~= nil)
npc:name("Fred")
end
In "data/defs/npcs.lua":
game = am.engine.game()
npc = am.character.new()
npc:age(21):gender("male"):graphic(am.sprite.new("characters/npc/front"))
-- Here the npc is registered with the name "male1" and "npcs:" will
-- automatically be prepended because of the filename.
game:char_def("male1", npc)
->
(
string
)
->
(
am.character
)
->
(
string
)
->
(
am.character
)
->
(
number
)
->
(
am.character
)
->
(
am.stats
)
->
(
boolean
)
,
string
part_type
= UNKNOWN_PART
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
table
)
,
am.body_part
part
)
->
(
boolean
)
,
string
part_name
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
am.item
)
->
(
am.inventory
)
->
(
am.code
)
| success | The item was picked up. |
| nil_parameter | The item was nil. |
| out_of_range | The item was out of range of this characters pickup radius. |
| not_enough_inventory_space | There's not enough space for the item to be picked up. |
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
integer
)
| success | The item was dropped. |
| nil_parameter | The item was nil. |
| off_the_map | The drop location was off the map. |
| out_of_range | The item was out of range of this characters pickup radius to drop (should not happen). |
| invalid_location | The drop location was invalid for the item. |
,
number
x
,
number
y
)
->
(
integer
)
->
(
number
)
->
(
am.character
)
->
(
Race
)
->
(
am.character
)
->
(
am.character
)
->
(
string
)
->
(
am.character
)
->
(
am.coin_purse
)
->
(
am.sprite
)
->
(
am.character
)
->
(
am.character
)
->
(
number
,
number
)
,
number
y
)
->
(
am.character
)
->
(
integer
,
integer
)
,
integer
y
)
->
(
am.character
)
->
(
number
)
->
(
boolean
)
->
(
number
,
number
)
,
number
y
)
->
(
am.character
)
->
(
integer
,
integer
)
,
integer
y
)
->
(
am.character
)
,
number
y
)
->
(
am.character
)
,
integer
y
)
->
(
am.character
)
->
(
boolean
)
->
(
boolean
)
->
(
boolean
)
->
(
am.character
)
->
(
am.map
)
->
(
am.character
)
->
(
am.map
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
am.character
)
->
(
boolean
)
->
(
table
)
->
(
string
)
->
(
boolean
)
static
find
(
string
game_id
)
->
(
am.character
)
->
(
am.dialogue_component
)
,
boolean
set_attached
= true
)
->
(
)
,
function
listener
,
table
content
= nil
)
->
(
boolean
)
character:on("talkTo", function(event)
am_log("Character talked to")
end)
,
function
listener
,
table
context
= nil
)
->
(
boolean
)
function talkToOnce(event)
am_log("Character talked to once")
character:off("talkTo", talkToOnce)
end
character:on("talkTo", talkToOnce)
->
(
boolean
)
->
(
integer
)
->
(
am.character
)
->
(
am.character
)
->
(
integer
)
->
(
am.character
)
->
(
am.character
)
->
(
integer
)
->
(
am.character
)
->
(
function
)
->
(
am.character
)
->
(
function
)
->
(
am.character
)
,
bool
by_movement
)
->
(
am.code
)
| did_interact | Interaction occured, perform no further actions. |
| did_not_interact | Interaction did not occur, can perform further actions. |
| do_not_interact | Interaction did not occur, but do not perform any further actions. |
->
(
DataTable
)
->
(
am.character
)
npc1 = am.character.new("npc1") npc1:name("Fredrick Smith") game = am.engine.get_game() main = game:main()