Display Maps Under Maps, Make a cliff actually a cliff! Options

[SuperMega]

Version: 0.8
Author: The Staff of RGSS2Dai Page
Translation: SuperMega

Introduction
This is a translation of a fantastic script from Dai Page. I AM NOT the creator of this script, so I don't deserve full credit. I only translated the script, in order to share it with the English community. The primary functions of the script are translated, but not everything is. If anyone would like everything to be translated, please let me know. Let me also mention I can only help with basic problems, and not ones that involve the script.


Features
-Stacks a map ontop of another map, making a map appear higher up than the other (Basically, making the lower map like a parallax)
-EVENTS CANNOT BE PLACED ON A MAP THAT IS UNDER A MAP
-Maps must be the same size in order for this to work
-You can change the scrolling speed of the distance, you see (Don't Make the
player dizzy!)


Script

[Show/Hide] The script...

CODE

=begin
#-------------------------------------------------------------------------------
Display Maps Under Maps
Version: 0.8
Original Japanese Version From: RGSS2 DAIpage
English Translation By: SuperMega
#-------------------------------------------------------------------------------

Script Features and Use:
　-Stacks a map ontop of another map, making a map appear higher up than the other
-EVENTS CANNOT BE PLACED ON A MAP THAT IS UNDER A MAP
-Maps must be the same size in order for this to work
-You can change the scrolling speed of the distance, you see (Don't Make the
player dizzy!)

This Script Redifines:
  Spriteset_Map

　 Changing this script may result in compatability errors, so do so at your own
  risk...

Update Log:
08/12/16 ：Script Released
09/9/7 : Script Translated!
=end
#============================================================================
# Begin Customization
#============================================================================

module DAI_tile_parallax
   #MapID => [map distance, X scroll speed, Y scroll speed]
   P = {
   # Map 1, with Map 2 shown in the distance. Both horizontal and vertical scroll at 1 speed.
   1 => [2, 1.4, 1.4],  
   } #DON'T ERASE!

end  
#============================================================================
# End Customization
#============================================================================  

#==============================================================================
# â–  Spriteset_Map
#==============================================================================
class Spriteset_Map
  #--------------------------------------------------------------------------
  # â—� ビューãƒ�ートã�®ä½œæˆ�
  #--------------------------------------------------------------------------
  alias dai_tile_parallax_create_viewports create_viewports
  def create_viewports
    dai_tile_parallax_create_viewports
    create_tile_parallax
  end
  #--------------------------------------------------------------------------
  # â—� 解放
  #--------------------------------------------------------------------------
  alias dai_tile_parallax_dispose dispose
  def dispose
    @tile_parallax.dispose if @tile_parallax != nil
    dai_tile_parallax_dispose
  end
  #--------------------------------------------------------------------------
  # â—� フレーム更新
  #--------------------------------------------------------------------------
  alias dai_tile_parallax_update update
  def update
    update_tile_parallax if @tile_parallax != nil
    dai_tile_parallax_update
  end
  #--------------------------------------------------------------------------
  # â—� タイルマップé� æ™¯IDã�®å�–å¾—
  #--------------------------------------------------------------------------
  def tile_parallax_id
    if DAI_tile_parallax::P.include?($game_map.map_id)
      return DAI_tile_parallax::P[$game_map.map_id][0]
    else
      return 0
    end
  end
  #--------------------------------------------------------------------------
  # â—� タイルマップé� æ™¯ã�®ä½œæˆ�
  #--------------------------------------------------------------------------
  def create_tile_parallax
    if tile_parallax_id == 0
      @tile_parallax = nil
      return
    end
    a = Tile_Parallax.new
    a.setup(tile_parallax_id)
    @tile_parallax = Tilemap.new(@viewport1)
    @tile_parallax.bitmaps[0] = Cache.system("TileA1")
    @tile_parallax.bitmaps[1] = Cache.system("TileA2")
    @tile_parallax.bitmaps[2] = Cache.system("TileA3")
    @tile_parallax.bitmaps[3] = Cache.system("TileA4")
    @tile_parallax.bitmaps[4] = Cache.system("TileA5")
    @tile_parallax.bitmaps[5] = Cache.system("TileB")
    @tile_parallax.bitmaps[6] = Cache.system("TileC")
    @tile_parallax.bitmaps[7] = Cache.system("TileD")
    @tile_parallax.bitmaps[8] = Cache.system("TileE")
    @tile_parallax.map_data = a.data
  end
  #--------------------------------------------------------------------------
  # â—� タイルマップã�®æ›´æ–°
  #--------------------------------------------------------------------------
  def update_tile_parallax
    a = DAI_tile_parallax::P[$game_map.map_id]
    @tile_parallax.ox = $game_map.display_x / 8 * a[1]
    @tile_parallax.oy = $game_map.display_y / 8 * a[2]
    @tile_parallax.update
  end
end
#==============================================================================
# â–  Tile_Parallax
#==============================================================================
class Tile_Parallax
  #--------------------------------------------------------------------------
  # â—� オブジェクトåˆ�期化
  #--------------------------------------------------------------------------
  def initialize
    @map_id = 0
  end
  #--------------------------------------------------------------------------
  # â—� セットアップ
  #--------------------------------------------------------------------------
  def setup(map_id)
    @map_id = map_id
    @map = load_data(sprintf("Data/Map%03d.rvdata", @map_id))
  end
  #--------------------------------------------------------------------------
  # â—� マップデータã�®å�–å¾—
  #--------------------------------------------------------------------------
  def data
    return @map.data
  end
end

Compatibility
Untested with other scripts. Should work fine, with the exception of things such as Mode 7 (Though, that might actually work).

Screenshot



DEMO
I highly recommend playing the demo to get a good idea of how it can work.
Demo

Installation
Add the map ID's you wish to use this script for, with the scroll speed "X" and "Y."


FAQ
Q.Help!!! This script is giving me an error!
A.Sadly, I can't help with that. I merely translated this script, and have a weak scripting ability. You may want to contact the script makers, to see what you can do to get it to work properly. If there's something you don't understand about the script, then those kind of questions are ones I can answer.


Credits
RGSS2DaiPage Staff-The script
SuperMega-Translation
(Please credit both! Don't leave RGSS2Daipage Staff out of your credits! You know they did a great job!)

[guzzleboy478]

Wow. That's really useful. Thanks for sharing!

[SuperMega]

You're quite welcome quzzleboy478, it was simple to translate! I figured this was something never before seen, and it's completely useful too.

[link245]

I didn't know such a thing existed, thanks for the translation. Now I can actually have a real cliff in my game, without it looking awkward.

[platipus]

omg that is so awesome!!!!!!!!!!!!!!!!!!!!!!!!!!! i love u for this script

[wltr3565]

The script looked rather simple, but effected very marvelous. I little envy you that you can read kanjis to translate the scripts . Maybe I can use this script someday.

EDIT: This script's real effects is to make another map to be a parallax for the assigned map. So if you want to show a parallax, maybe won't show because it's replaced by the parallax map. Well, this saves us time to make a map parallax

[SuperMega]

The script looked rather simple, but effected very marvelous. I little envy you that you can read kanjis to translate the scripts . Maybe I can use this script someday.

EDIT: This script's real effects is to make another map to be a parallax for the assigned map. So if you want to show a parallax, maybe won't show because it's replaced by the parallax map. Well, this saves us time to make a map parallax

Yeah, it can do that too. Must have forgotten to mention it...*Edits thread*

Thanks for all the comments!

[platipus]

can u allow the panorama/parallax of the map show as well?

[Jacklo]

Might use this, thanks for spending the time to translate!