Class: Game_Map

Inherits:

Object

Object
Game_Map

show all

Defined in:: docs/01450_Systems_00003_Map_Engine.rb

Overview

Describe the Map processing

Constant Summary collapse

MACH_BIKE_BGM = Audiofile to play when the player is on mach bike Returns: (RPG::AudioFile)

RPG::AudioFile.new('09 Bicycle', 100, 100)

ACRO_BIKE_BGM = Audiofile to play when the player is on acro bike Returns: (RPG::AudioFile)

MACH_BIKE_BGM.clone

PATH_FINDING_ENABLED = If the Path Finding system is enabled

true

CenterPlayer = If the player is always on the center of the screen

Configs.display.is_player_always_centered

NUM_TILE_VIEW_Y = Number of tiles the player can see in x

NUM_TILE_VIEW_X = Number of tiles the player can see in y

FOLLOWER_ID_REGEXP = Regular expression catching follower id

/\[follow=([0-9]+)\]/

TERRAIN_TAGS_TABLE = Convert terrain tag to location symbol Returns: (Hash<Integer, Symbol>)

{GameData::SystemTags::TGrass => :grass, GameData::SystemTags::TTallGrass => :grass, GameData::SystemTags::HeadButt => :grass, GameData::SystemTags::TSnow => :snow, GameData::SystemTags::TPond => :shallow_water, GameData::SystemTags::TWetSand => :shallow_water, GameData::SystemTags::SwampBorder => :shallow_water, GameData::SystemTags::DeepSwamp => :shallow_water, GameData::SystemTags::TSand => :desert, GameData::SystemTags::TCave => :cave, GameData::SystemTags::TMount => :cave, GameData::SystemTags::TIce => :icy_cave, GameData::SystemTags::TSea => :water, GameData::SystemTags::WaterFall => :water, GameData::SystemTags::RapidsL => :water, GameData::SystemTags::RapidsD => :water, GameData::SystemTags::RapidsU => :water, GameData::SystemTags::RapidsR => :water, GameData::SystemTags::Whirlpool => :water}

IVAR_TO_REMOVE_FROM_SAVE_FILE = List of variable to remove in order to keep the map data safe

%i[@map @tileset_name @autotile_names @panorama_name @panorama_hue @fog_name @fog_hue @fog_opacity @fog_blend_type @fog_zoom @fog_sx @fog_sy @battleback_name @passages @priorities @terrain_tags @events @common_events @system_tags]

Instance Attribute Summary collapse

#autotile_names

タイルセットファイル名.
#battleback_name

フォグ SY.
#display_x

バトルバックファイル名.
#display_y

表示 X 座標 * 128.
#event_erased ⇒ Boolean

If an event has been erased (helps removing it).
#events ⇒ Hash{Integer => Game_Event} readonly

地形タグテーブル.
#events_sym_to_id ⇒ Hash<Symbol, Integer>

Return the hash of symbol associate to event id.
#fog_blend_type

フォグ不透明度.
#fog_hue

フォグファイル名.
#fog_name

パノラマ色相.
#fog_opacity

フォグ色相.
#fog_ox readonly

Returns the value of attribute fog_ox.
#fog_oy readonly

フォグ原点 X 座標.
#fog_sx

フォグ拡大率.
#fog_sy

フォグ SX.
#fog_tone readonly

フォグ原点 Y 座標.
#fog_zoom

フォグブレンド方法.
#maplinker_disabled ⇒ Boolean readonly

フォグ色調.
#need_refresh

表示 Y 座標 * 128.
#panorama_hue

パノラマファイル名.
#panorama_name

オートタイルファイル名.
#passages readonly

リフレッシュ要求フラグ.
#priorities readonly

通行テーブル.
#system_tags ⇒ Table readonly

The system_tags linked to each tiles of the tileset.
#terrain_tags readonly

プライオリティテーブル.
#tileset_name

Returns the value of attribute tileset_name.

Instance Method Summary collapse

#autoplay

Auto play bgm and bgs of the map if defined.
#begin_save

Method that prevent non wanted data save of the Game_Map object.
#bush?(x, y) ⇒ Boolean

Tells if the tile is a bush tile.
#counter?(x, y) ⇒ Boolean

カウンター判定 (no idea, need GTranslate).
#data ⇒ Table

Returns the tile matrix of the Map.
#encounter_list deprecated Deprecated.

Not used by the Core of PSDK because not precise enough to be used
#end_save

Method that end the save state of the Game_Map object.
#get_tile(x, y) ⇒ Integer

Retrieve the id of a specific tile.
#height ⇒ Integer

Returns the height of the map.
#initialize ⇒ Game_Map constructor

Initialize the default Game_Map object.
#jump_passable?(x, y, d) ⇒ Boolean

Check if the player can jump a case with the acro bike.
#load_systemtags

Loads the SystemTags of the map.
#location_type(x, y) ⇒ Symbol

Return the current location type.
#map_id ⇒ Integer

Returns the ID of the Map.
#passable?(x, y, d, self_event = nil) ⇒ Boolean

Tells if the tile front/current tile is passsable or not.
#refresh

Refresh events and common events of the map.
#rmxp_encounter_steps ⇒ Integer

Returns the encounter steps from RMXP data.
#scroll_down(distance, is_priority = false)

Scrolls the map down.
#scroll_left(distance, is_priority = false)

Scrolls the map left.
#scroll_right(distance, is_priority = false)

Scrolls the map right.
#scroll_up(distance, is_priority = false)

Scrolls the map up.
#scrolling? ⇒ Boolean

is the map scrolling ?.
#setup(map_id)

setup the Game_Map object with the right Map data.
#start_fog_opacity_change(opacity, duration)

Starts a fog opacity change process.
#start_fog_tone_change(tone, duration)

Starts a fog tone change process.
#start_scroll(direction, distance, speed, x_priority = false, y_priority = false)

Starts a scroll processing.
#system_tag(x, y) ⇒ Integer

Retrieve the ID of the SystemTag on a specific tile.
#system_tag_here?(x, y, tag) ⇒ Boolean

Check if a specific SystemTag is present on a specific tile.
#terrain_tag(x, y) ⇒ Integer^?

Returns the tag of the tile.
#update

Update the Map processing.
#valid?(x, y) ⇒ Boolean

Tells if the x,y coordinate is valid or not (inside of bounds).
#width ⇒ Integer

Returns the width of the map.

Constructor Details

#initialize ⇒ `Game_Map`

Initialize the default Game_Map object



2515
2516

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2515

def initialize
end

Instance Attribute Details

#autotile_names

タイルセットファイル名



2467
2468
2469

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2467

def autotile_names
  @autotile_names
end

#battleback_name

フォグ SY



2487
2488
2489

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2487

def battleback_name
  @battleback_name
end

#display_x

バトルバックファイル名



2489
2490
2491

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2489

def display_x
  @display_x
end

#display_y

表示 X 座標 * 128



2491
2492
2493

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2491

def display_y
  @display_y
end

#event_erased ⇒ `Boolean`

If an event has been erased (helps removing it)

Returns:

(Boolean)



2654
2655
2656

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2654

def event_erased
  @event_erased
end

#events ⇒ `Hash{Integer => Game_Event}` (readonly)

地形タグテーブル

Returns:

(Hash{Integer => Game_Event}) —

all the living events



2502
2503
2504

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2502

def events
  @events
end

#events_sym_to_id ⇒ `Hash<Symbol, Integer>`

Return the hash of symbol associate to event id

Returns:

(Hash<Symbol, Integer>)



2505
2506
2507

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2505

def events_sym_to_id
  @events_sym_to_id
end

#fog_blend_type

フォグ不透明度



2479
2480
2481

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2479

def fog_blend_type
  @fog_blend_type
end

#fog_hue

フォグファイル名



2475
2476
2477

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2475

def fog_hue
  @fog_hue
end

#fog_name

パノラマ色相



2473
2474
2475

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2473

def fog_name
  @fog_name
end

#fog_opacity

フォグ色相



2477
2478
2479

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2477

def fog_opacity
  @fog_opacity
end

#fog_ox (readonly)

Returns the value of attribute fog_ox.



2506
2507
2508

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2506

def fog_ox
  @fog_ox
end

#fog_oy (readonly)

フォグ原点 X 座標



2508
2509
2510

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2508

def fog_oy
  @fog_oy
end

#fog_sx

フォグ拡大率



2483
2484
2485

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2483

def fog_sx
  @fog_sx
end

#fog_sy

フォグ SX



2485
2486
2487

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2485

def fog_sy
  @fog_sy
end

#fog_tone (readonly)

フォグ原点 Y 座標



2510
2511
2512

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2510

def fog_tone
  @fog_tone
end

#fog_zoom

フォグブレンド方法



2481
2482
2483

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2481

def fog_zoom
  @fog_zoom
end

#maplinker_disabled ⇒ `Boolean` (readonly)

フォグ色調

Returns:

(Boolean) —

if the maplinker was disabled when the map was setup



2513
2514
2515

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2513

def maplinker_disabled
  @maplinker_disabled
end

#need_refresh

表示 Y 座標 * 128



2493
2494
2495

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2493

def need_refresh
  @need_refresh
end

#panorama_hue

パノラマファイル名



2471
2472
2473

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2471

def panorama_hue
  @panorama_hue
end

#panorama_name

オートタイルファイル名



2469
2470
2471

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2469

def panorama_name
  @panorama_name
end

#passages (readonly)

リフレッシュ要求フラグ



2495
2496
2497

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2495

def passages
  @passages
end

#priorities (readonly)

通行テーブル



2497
2498
2499

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2497

def priorities
  @priorities
end

#system_tags ⇒ `Table` (readonly)

The system_tags linked to each tiles of the tileset

Returns:

(Table)



2657
2658
2659

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2657

def system_tags
  @system_tags
end

#terrain_tags (readonly)

プライオリティテーブル



2499
2500
2501

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2499

def terrain_tags
  @terrain_tags
end

#tileset_name

Returns the value of attribute tileset_name.



2465
2466
2467

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2465

def tileset_name
  @tileset_name
end

Instance Method Details

#autoplay

Auto play bgm and bgs of the map if defined



2546
2547

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2546

def autoplay
end

#begin_save

Method that prevent non wanted data save of the Game_Map object

Author:

Nuri Yuri



2703
2704

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2703

def begin_save
end

#bush?(x, y) ⇒ `Boolean`

Tells if the tile is a bush tile

Parameters:

x (Integer) —

x coordinate of the tile
y (Integer) —

y coordinate of the tile

Returns:

(Boolean)



2589
2590

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2589

def bush?(x, y)
end

#counter?(x, y) ⇒ `Boolean`

カウンター判定 (no idea, need GTranslate)

Parameters:

x (Integer) —

x coordinate of the tile
y (Integer) —

y coordinate of the tile

Returns:

(Boolean)



2595
2596

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2595

def counter?(x, y)
end

#data ⇒ `Table`

Returns the tile matrix of the Map

Returns:

(Table) —

a 3D table containing ids of tile



2543
2544

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2543

def data
end

#encounter_list

Deprecated.

Not used by the Core of PSDK because not precise enough to be used

Returns the encounter list



2535
2536

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2535

def encounter_list
end

#end_save

Method that end the save state of the Game_Map object

Author:

Nuri Yuri



2707
2708

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2707

def end_save
end

#get_tile(x, y) ⇒ `Integer`

Retrieve the id of a specific tile

Parameters:

x (Integer) —

x position of the tile
y (Integer) —

y position of the tile

Returns:

(Integer) —

id of the tile

Author:

Nuri Yuri



2682
2683

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2682

def get_tile(x, y)
end

#height ⇒ `Integer`

Returns the height of the map

Returns:

(Integer)



2531
2532

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2531

def height
end

#jump_passable?(x, y, d) ⇒ `Boolean`

Check if the player can jump a case with the acro bike

Parameters:

x (Integer) —

x position of the tile
y (Integer) —

y position of the tile
d (Integer) —

the direction of the player

Returns:

(Boolean)

Author:

Nuri Yuri



2690
2691

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2690

def jump_passable?(x, y, d)
end

#load_systemtags

Loads the SystemTags of the map

Author:

Nuri Yuri



2675
2676

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2675

def load_systemtags
end

#location_type(x, y) ⇒ `Symbol`

Return the current location type

Returns:

(Symbol)



2694
2695

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2694

def location_type(x, y)
end

#map_id ⇒ `Integer`

Returns the ID of the Map

Returns:

(Integer)



2523
2524

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2523

def map_id
end

#passable?(x, y, d, self_event = nil) ⇒ `Boolean`

Tells if the tile front/current tile is passsable or not

Parameters:

x (Integer) —

x position on the Map
y (Integer) —

y position on the Map
d (Integer) —

direction : 2, 4, 6, 8, 0. 0 = current position
self_event (Game_Event, nil) (defaults to: nil) —

the “tile” event to ignore

Returns:

(Boolean) —

if the front/current tile is passable



2583
2584

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2583

def passable?(x, y, d, self_event = nil)
end

#refresh

Refresh events and common events of the map



2549
2550

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2549

def refresh
end

#rmxp_encounter_steps ⇒ `Integer`

Returns the encounter steps from RMXP data

Returns:

(Integer)



2539
2540

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2539

def rmxp_encounter_steps
end

#scroll_down(distance, is_priority = false)

Scrolls the map down

Parameters:

distance (Integer) —

distance in y to scroll
is_priority (Boolean) (defaults to: false) —

used if there is a prioratary scroll running



2554
2555

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2554

def scroll_down(distance, is_priority = false)
end

#scroll_left(distance, is_priority = false)

Scrolls the map left

Parameters:

distance (Integer) —

distance in -x to scroll
is_priority (Boolean) (defaults to: false) —

used if there is a prioratary scroll running



2559
2560

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2559

def scroll_left(distance, is_priority = false)
end

#scroll_right(distance, is_priority = false)

Scrolls the map right

Parameters:

distance (Integer) —

distance in x to scroll
is_priority (Boolean) (defaults to: false) —

used if there is a prioratary scroll running



2564
2565

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2564

def scroll_right(distance, is_priority = false)
end

#scroll_up(distance, is_priority = false)

Scrolls the map up

Parameters:

distance (Integer) —

distance in -y to scroll
is_priority (Boolean) (defaults to: false) —

used if there is a prioratary scroll running



2569
2570

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2569

def scroll_up(distance, is_priority = false)
end

#scrolling? ⇒ `Boolean`

is the map scrolling ?

Returns:

(Boolean)



2613
2614

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2613

def scrolling?
end

#setup(map_id)

setup the Game_Map object with the right Map data

Parameters:

map_id (Integer) —

the ID of the map



2519
2520

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2519

def setup(map_id)
end

#start_fog_opacity_change(opacity, duration)

Starts a fog opacity change process

Parameters:

opacity (Integer) —

the new opacity of the fog
duration (Integer) —

the number of frame the opacity change will take



2623
2624

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2623

def start_fog_opacity_change(opacity, duration)
end

#start_fog_tone_change(tone, duration)

Starts a fog tone change process

Parameters:

tone (Tone) —

the new tone of the fog
duration (Integer) —

the number of frame the tone change will take



2618
2619

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2618

def start_fog_tone_change(tone, duration)
end

#start_scroll(direction, distance, speed, x_priority = false, y_priority = false)

Starts a scroll processing

Parameters:

direction (Integer) —

the direction to scroll
distance (Integer) —

the distance to scroll
speed (Integer) —

the speed of the scroll processing
x_priority (Boolean) (defaults to: false) —

true if the scroll is prioritary in x axis, be careful using this
y_priority (Boolean) (defaults to: false) —

true if the scroll is prioritary in y axis, be careful using this



2609
2610

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2609

def start_scroll(direction, distance, speed, x_priority = false, y_priority = false)
end

#system_tag(x, y) ⇒ `Integer`

Retrieve the ID of the SystemTag on a specific tile

Parameters:

x (Integer) —

x position of the tile
y (Integer) —

y position of the tile

Returns:

(Integer)

Author:

Nuri Yuri



2663
2664

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2663

def system_tag(x, y)
end

#system_tag_here?(x, y, tag) ⇒ `Boolean`

Check if a specific SystemTag is present on a specific tile

Parameters:

x (Integer) —

x position of the tile
y (Integer) —

y position of the tile
tag (Integer) —

ID of the SystemTag

Returns:

(Boolean)

Author:

Nuri Yuri



2671
2672

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2671

def system_tag_here?(x, y, tag)
end

#terrain_tag(x, y) ⇒ `Integer`^?

Returns the tag of the tile

Parameters:

x (Integer) —

x coordinate of the tile
y (Integer) —

y coordinate of the tile

Returns:

(Integer, nil) —

Tag of the tile



2601
2602

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2601

def terrain_tag(x, y)
end

#update

Update the Map processing



2626
2627

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2626

def update
end

#valid?(x, y) ⇒ `Boolean`

Tells if the x,y coordinate is valid or not (inside of bounds)

Parameters:

x (Integer) —

the x coordinate
y (Integer) —

the y coordinate

Returns:

(Boolean) —

if it’s valid or not



2575
2576

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2575

def valid?(x, y)
end

#width ⇒ `Integer`

Returns the width of the map

Returns:

(Integer)



2527
2528

# File 'docs/01450_Systems_00003_Map_Engine.rb', line 2527

def width
end

Class: Game_Map

Overview

Constant Summary collapse

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Game_Map

Instance Attribute Details

#autotile_names

#battleback_name

#display_x

#display_y

#event_erased ⇒ Boolean

#events ⇒ Hash{Integer => Game_Event} (readonly)

#events_sym_to_id ⇒ Hash<Symbol, Integer>

#fog_blend_type

#fog_hue

#fog_name

#fog_opacity

#fog_ox (readonly)

#fog_oy (readonly)

#fog_sx

#fog_sy

#fog_tone (readonly)

#fog_zoom

#maplinker_disabled ⇒ Boolean (readonly)

#need_refresh

#panorama_hue

#panorama_name

#passages (readonly)

#priorities (readonly)

#system_tags ⇒ Table (readonly)

#terrain_tags (readonly)

#tileset_name

Instance Method Details

#autoplay

#begin_save

#bush?(x, y) ⇒ Boolean

#counter?(x, y) ⇒ Boolean

#data ⇒ Table

#encounter_list

#end_save

#get_tile(x, y) ⇒ Integer

#height ⇒ Integer

#jump_passable?(x, y, d) ⇒ Boolean

#load_systemtags

#location_type(x, y) ⇒ Symbol

#map_id ⇒ Integer

#passable?(x, y, d, self_event = nil) ⇒ Boolean

#refresh

#rmxp_encounter_steps ⇒ Integer

#scroll_down(distance, is_priority = false)

#scroll_left(distance, is_priority = false)

#scroll_right(distance, is_priority = false)

#scroll_up(distance, is_priority = false)

#scrolling? ⇒ Boolean

#setup(map_id)

#start_fog_opacity_change(opacity, duration)

#start_fog_tone_change(tone, duration)

#start_scroll(direction, distance, speed, x_priority = false, y_priority = false)

#system_tag(x, y) ⇒ Integer

#system_tag_here?(x, y, tag) ⇒ Boolean

#terrain_tag(x, y) ⇒ Integer?

#update

#valid?(x, y) ⇒ Boolean

#width ⇒ Integer

#initialize ⇒ `Game_Map`

#event_erased ⇒ `Boolean`

#events ⇒ `Hash{Integer => Game_Event}` (readonly)

#events_sym_to_id ⇒ `Hash<Symbol, Integer>`

#maplinker_disabled ⇒ `Boolean` (readonly)

#system_tags ⇒ `Table` (readonly)

#bush?(x, y) ⇒ `Boolean`

#counter?(x, y) ⇒ `Boolean`

#data ⇒ `Table`

#get_tile(x, y) ⇒ `Integer`

#height ⇒ `Integer`

#jump_passable?(x, y, d) ⇒ `Boolean`

#location_type(x, y) ⇒ `Symbol`

#map_id ⇒ `Integer`

#passable?(x, y, d, self_event = nil) ⇒ `Boolean`

#rmxp_encounter_steps ⇒ `Integer`

#scrolling? ⇒ `Boolean`

#system_tag(x, y) ⇒ `Integer`

#system_tag_here?(x, y, tag) ⇒ `Boolean`

#terrain_tag(x, y) ⇒ `Integer`^?

#valid?(x, y) ⇒ `Boolean`

#width ⇒ `Integer`