Mobius's "The Story So Far" Script

じ☆ve冰风

The Story So Far
    by
    MobiusXVI​

Release Notes
Dec 2013 - v. 1.0 Initial Release
Mar 2023 - v. 1.1 Fixed a bug where it would ask the user if they wanted to watch the story even if it didn't exist

Introduction
    The purpose of this script is to allow you to remind the player about what has happened in the story whenever they load their game.  I hope you enjoy it!

Features
  - Very little scripting needed to make script work, since it uses maps for cutscenes.
  - Can have as many or few chapters as you want
  - Allows player to skip watching the cutscene and load directly into game (especially useful when reloading a game due to     death)

Screenshots
None.

How to Use
  - Place this script below the defaults but above main. If you have other scripts that modify saving/loading, put this one  below them.
  - What this script does is check a game variable of your choosing to  determine the current "chapter". Then it loads a map that you specify to let you play out a cutscene of your own design to recap the story. So you'll need to complete the configuration section below to do this.
- You can do whatever you want on the cutscene maps, including going to  additional maps if need be. Whenever you finish with your cutscene, all you have to do is put the following script call in an event and the game will then load and allow the player to keep going:  "Mobius_Story_So_Far.finish_cutscene" (without quotes)
- The additional configuration needed is listed in the script under "Configuration"

Demo
http://www.mediafire.com/download/alsku2kn3c2ke0d/Story So Far Demo.zip

Script
Spoiler                Code:       

1. #===============================================================================
2. # The Story So Far
3. # Author: Mobius XVI
4. # Version: 1.1
5. # Date: 02 MAR 2023
6. #===============================================================================
7. #
8. # Introduction:
9. #
10. #   The purpose of this script is to allow you to remind the player about what
11. #   has happened in the story whenever they load their game.
12. #
13. # Instructions:
14. #
15. #  - Place this script below the defaults but above main. If you have other
16. #    scripts that modify saving/loading, put this one below them.
17. #  - What this script does is check a game variable of your choosing to
18. #    determine the current "chapter". Then it loads a map that you specify to
19. #    let you play out a cutscene of your own design to recap the story.
20. #    So you'll need to complete the configuration section below to do this.
21. #  - You can do whatever you want on the cutscene maps, including going to
22. #    additional maps if need be. Whenever you finish with your cutscene, all
23. #    you have to do is put the following script call in an event and the game
24. #    will then load and allow the player to keep going.
25. #    "Mobius_Story_So_Far.finish_cutscene" (without quotes)
26. #
27. # Features:
28. #
29. #  - Very little scripting needed to make script work, since it uses maps for
30. #    cutscenes.
31. #  - Can have as many or few chapters as you want
32. #  - Allows player to skip watching the cutscene and load directly into game
33. #    (especially useful when reloading a game due to death)
34. #
35. # Issues/Bugs/Possible Bugs:
36. #
37. #   - There may be incompatibility issues with any script that heavily modifies
38. #     the saving/loading of the game. Placing this script below them should
39. #     alleviate most problems
40. #
41. #  Credits/Thanks:
42. #    - Mobius XVI, author
43. #    - Monkeysnow55, for requesting it
44. #
45. #  License
46. #    - Copyright 2023 Mobius XVI
47. #    - This script is licensed under the MIT license.
48. #      The full license is availble here:
49. #      https://opensource.org/license/mit/
50. #      Further, if you decide to use this script in a commercial product,
51. #      I'd ask that you let me know via a forum post or a PM. Thanks.
52. #
53. #===============================================================================
54. #                             CONFIGURATION
55. #===============================================================================
56. module Mobius_Story_So_Far
57.   CHAPTER_VARIABLE = 0
58.   # Define the game variable that will be used to determine what chapter
59.   # the player is on.
61.   CUTSCENE_MAPS = [[5, 0, 0],  # Chapter 0
62.                    [1, 9, 21],  # Chapter 1
63.                    [15, 30, 0], # Chapter 2
64.                    # ...
65.                    #[MAP_ID, STARTING_X, STARTING_Y], # CHAPTER X
66.                    # ...
67.                    ] # Array end - DON'T DELETE!
68.   # This is an array of arrays. The inner arrays have three entries. The first
69.   # is the Map_ID for whatever map you want to use for the cutscene. The second
70.   # and third entries are for the player's x and y coordinates respectively.
71.   # The inner arrays are all indexed, so whichever one comes first is used
72.   # when the chapter variable is 0, the second array is used when the chapter
73.   # variable is 1, and so on. Make sure all inner arrays are separated by commas
74. end
75. #===============================================================================
76. # ** Story So Far - EDIT BELOW THIS LINE AT OWN RISK
77. #===============================================================================
78. class Game_Temp
79.   attr_accessor :cutscene_filename  # filename to load after cutscene
80. end
82. class Scene_Load
84.   # alias old loading method
85.   alias mobius_ssf_on_decision on_decision
87.   # new loading method
88.   def on_decision(filename)
89.     # If file doesn't exist
90.     unless FileTest.exist?(filename)
91.       # Play buzzer SE
92.       $game_system.se_play($data_system.buzzer_se)
93.       return
94.     end
95.     # Read save data
96.     file = File.open(filename, "rb")
97.     read_save_data(file)
98.     file.close
99.     # Get chapter info
100.     chapter_variable = Mobius_Story_So_Far::CHAPTER_VARIABLE
101.     chapter = $game_variables[chapter_variable]
102.     # Get cutscene info
103.     @cutscene_info_array = Mobius_Story_So_Far::CUTSCENE_MAPS[chapter]
104.     if @cutscene_info_array == nil or @cutscene_info_array.length < 3
105.       # If there's no info, then load the save as normal
106.       # Play load SE
107.       $game_system.se_play($data_system.load_se)
108.       # Load savefile as normal
109.       mobius_ssf_on_decision(filename)
110.       return
111.     end
112.     # If there is a cutscene, ask the player if they want to see it
113.     # Play decision SE
114.     $game_system.se_play($data_system.decision_se)
115.     # Set help text
116.     @help_text = "Do you want to watch the story so far?"
117.     @help_window.set_text(@help_text)
118.     # Create choice window
119.     @choice_window = Window_Command.new(120, ["Yes", "No"])
120.     @choice_window.active = true
121.     # Center choice window
122.     @choice_window.x = 640 / 2 - @choice_window.width / 2
123.     @choice_window.y = 480 / 2 - @choice_window.height / 2
124.     @choice_window.z = 200
125.     # Wait for input
126.   end
127.    
128.   # Load into cutscene
129.   def load_into_cutscene(filename)
130.     # Play load SE
131.     $game_system.se_play($data_system.load_se)
132.     # Remeber filename
133.     $game_temp.cutscene_filename = filename  
134.     # Set cutscene info
135.     cutscene_map_id = @cutscene_info_array[0]
136.     cutscene_x = @cutscene_info_array[1]
137.     cutscene_y = @cutscene_info_array[2]
138.     # Stop BGM
139.     Audio.bgm_stop
140.     # Load cutscene map
141.     # Set up new map
142.     $game_map.setup(cutscene_map_id)
143.     # Move player to initial position
144.     $game_player.moveto(cutscene_x, cutscene_y)
145.     # Refresh player
146.     $game_player.refresh
147.     # Straighten player
148.     $game_player.straighten
149.     # Run automatic change for BGM and BGS set with map
150.     $game_map.autoplay
151.     # Update map (run parallel process event)
152.     $game_map.update
153.     # Switch to map screen
154.     $scene = Scene_Map.new
155.   end
156. end
158. class Scene_File
160.   # alias old update method
161.   alias mobius_ssf_update update
163.   def update
164.     # If choice window is up don't do other updating
165.     if @choice_window != nil and @choice_window.active
166.       # Update command window
167.       @choice_window.update
168.       # If C button was pressed
169.       if Input.trigger?(Input::C)
170.         # Branch by command window cursor position
171.         case @choice_window.index
172.         when 0  # Yes
173.           # Load into cutscene
174.           load_into_cutscene(make_filename(@file_index))
175.         when 1  # No
176.           # Call old loading method
177.           mobius_ssf_on_decision(make_filename(@file_index))
178.         end
179.         @choice_window.dispose
180.       end
181.       return
182.     else # If no choice window, perform normal updating
183.       mobius_ssf_update
184.     end
185.   end
186. end
188. module Mobius_Story_So_Far
190.   def Mobius_Story_So_Far.finish_cutscene
191.     # Prevent Screen Changes
192.     Graphics.freeze
193.     # Recall old filename
194.     filename = $game_temp.cutscene_filename
195.     # Create Load screen
196.     $scene = Scene_Load.new
197.     # Load savefile using original method
198.     $scene.mobius_ssf_on_decision(filename)
199.   end
200. end

复制代码

FAQ
None yet.

Credit and Thanks
Special thanks to Monkeysnow55 for requesting this script.

Author's Notes
Copyright 2023 Mobius XVI
This script is licensed under the MIT license
The full license is available here: https://opensource.org/license/mit/
Further, if you decide to use this script in a commercial product, I'd ask that you let me know via a post here or a PM. Thanks.


本贴来自国际rpgmaker官方论坛作者:MobiusXVI处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/mobiuss-the-story-so-far-script.21464/