pokecrystal-board/docs/map_event_scripts.md
vulcandth c3331eb7b1
Rename scene and callback labels (#981)
Co-authored-by: Rangi <35663410+Rangi42@users.noreply.github.com>
2022-08-09 18:04:18 -04:00

4.0 KiB

Map Event Scripts

Contents

Object constants

	object_const_def
	const MAPNAME_OBJECTNAME

Map scripts

MapName_MapScripts:

Scene scripts

	def_scene_scripts
	scene_script script, SCENE_MAPNAME_SCENE_NAME

Callbacks

	def_callbacks
	callback type, script

Callback types

  • MAPCALLBACK_NEWMAP

  • MAPCALLBACK_TILES

  • MAPCALLBACK_OBJECTS

  • MAPCALLBACK_SPRITES

  • MAPCALLBACK_CMDQUEUE

	callback MAPCALLBACK_CMDQUEUE, MapNameBouldersCallback

MapNameBouldersCallback:
	writecmdqueue .BoulderCmdQueue
	endcallback

.BoulderCmdQueue:
	cmdqueue CMDQUEUE_STONETABLE, .BoulderTable

.BoulderTable:
	stonetable warp_id, person, script
	db -1 ; end

Event scripts

Event commands

Text

Text commands

Movement data

Movement commands

Map events

MapName_MapEvents:
	db 0, 0 ; filler

Warp events

	def_warp_events
	warp_event x, y, map, warp_id

Coord events

	def_coord_events
	coord_event x, y, scene_id, script

BG events

	def_bg_events
	bg_event x, y, type, script

BG event types

  • BGEVENT_READ

  • BGEVENT_UP/DOWN/LEFT/RIGHT

  • BGEVENT_IFSET/IFNOTSET

	conditional_event event_flag, script
  • BGEVENT_ITEM
	hiddenitem item_id, event_flag
  • BGEVENT_COPY

Object events

	def_object_events
	object_event x, y, sprite, movement, rx, ry, h1, h2, palette, type, range, script, event_flag

Movement types

  • SPRITEMOVEDATA_STILL

  • SPRITEMOVEDATA_WANDER

  • SPRITEMOVEDATA_SPINRANDOM_SLOW

  • SPRITEMOVEDATA_WALK_UP_DOWN

  • SPRITEMOVEDATA_WALK_LEFT_RIGHT

  • SPRITEMOVEDATA_STANDING_UP/DOWN/LEFT/RIGHT

  • SPRITEMOVEDATA_SPINRANDOM_FAST

  • SPRITEMOVEDATA_BIGDOLLSYM

  • SPRITEMOVEDATA_POKEMON

  • SPRITEMOVEDATA_SUDOWOODO

  • SPRITEMOVEDATA_SMASHABLE_ROCK

  • SPRITEMOVEDATA_STRENGTH_BOULDER

  • SPRITEMOVEDATA_SPINCOUNTERCLOCKWISE

  • SPRITEMOVEDATA_SPINCLOCKWISE

  • SPRITEMOVEDATA_BIGDOLLASYM

  • SPRITEMOVEDATA_BIGDOLL

  • SPRITEMOVEDATA_SWIM_WANDER

Object types

  • OBJECTTYPE_SCRIPT

  • OBJECTTYPE_ITEMBALL

	itemball item_id[, quantity=1]
  • OBJECTTYPE_TRAINER
	trainer group_id, trainer_id, event_flag, seen_text, beaten_text, loss_text, script

Template

	object_const_def
;	const MAPNAME_OBJECTNAME

MapName_MapScripts:
	def_scene_scripts
;	scene_script script, SCENE_MAPNAME_SCENE_NAME

	def_callbacks
;	callback type, script

MapName_MapEvents:
	db 0, 0 ; filler

	def_warp_events
;	warp_event x, y, map, warp_id

	def_coord_events
;	coord_event x, y, scene_id, script

	def_bg_events
;	bg_event x, y, type, script

	def_object_events
;	object_event x, y, sprite, movement, rx, ry, h1, h2, palette, type, range, script, event_flag