FG7 - Easy Item Charges

じ☆ve冰风

Easy Item Charges
By: FamilyGamer7
​

Introduction

                        This script was designed to imitate an item charge effect on consumable items. I had this script created within my own project/game and I thought someone could find it useful. Easy and efficient.               
Click to expand...

Features

                        The ability to have an item charge count on a consumable item for multiple uses. By default the game engine works similar in this way without the concept of non-stacks. The script is designed/intended to be used with Hime - Instance Items and is also a requirement for this script run and work.
Click to expand...

Screenshots

                        - Not Needed -               
Click to expand...

Script
Spoiler: FG7 - Easy Item Charges

                Ruby:       

1. #==============================================================================
2. # Title: Easy Item Charges
3. # Author: FamilyGamer7 (FG7)
4. # Version: 1.3
5. # Engine: RPG Maker VX Ace
6. #==============================================================================
7. # ** Description |
8. # ----------------
9. # The "easiest" way to implement an Item Charge type effect on items.
10. #==============================================================================
11. # ** Change Log |
12. # ---------------
13. # 1.0 => Created Script
14. # 1.1 => Removed "Alias" method as it caused issues with the project
15. # 1.2 => Removed item charge limit (Flexible for any game/project)
16. # 1.3 => Added Item Charges switch for ON/OFF functionality
17. #==============================================================================
18. # ** Terms of Use |
19. # -----------------
20. # * Free to use in non-commercial projects and commercial projects
21. # * Feel free to modify and improve the script. Credit is still required.
22. # * Credit FamilyGamer7
23. #==============================================================================
24. # ** Script(s) Required |
25. # -----------------------
26. # Hime - Instance Items:
27. # (http://himeworks.com/redirect.php?type=script&name=Instance_Items)
28. #
29. # Place this script below "Hime - Instance Items" script.
30. #==============================================================================
31. # ** Usage |
32. # ----------
33. # * Plug & Play (See notes below for more information)
34. #==============================================================================
35. # ** Notes |
36. # ----------
37. # Just need to add "ANY" number value on the end of your item name.
38. #
39. # Ex: "Potion 3"
40. # Ex: "Antidote 76"
41. # Ex: "Elixir 6"
42. #
43. # -----------------
44. # | Script calls: |
45. # -----------------
47. # - To turn script off:
48. #     $game_system.item_charges_switch_off(true)
49. #
50. # - To turn script on:
51. #     $game_system.item_charges_switch_off(false)
52. #
53. # * This script is ON by default, so the turn script on call is not needed
54. #   unless you used the turn off script.
55. #==============================================================================
57. #==============================================================================
58. # ** Required Script Checker
59. #------------------------------------------------------------------------------
60. # Ensures Required Script is in place. If not, Game will close down.
61. #==============================================================================
63. $imported = {} if $imported.nil?
64.   unless $imported["TH_InstanceItems"]
65.     msgbox("Required 'Hime - Instance Items' is not detected - Closing Game")
66.   exit
67. end
69. #==============================================================================
70. # ** Module: FG7::Easy_Item_Charges
71. #------------------------------------------------------------------------------
72. #  This modules creates a static variable to be used within the script.
73. #==============================================================================
75. module FG7
76.   module Easy_Item_Charges
77.    
78. #==============================================================================
79. # -------------------- ALLOWED TO EDIT BELOW THIS LINE ---------------------- #
80. #==============================================================================
82.   # Sets the switch number used for the Item Charges script
83.   # (Feel free to change switch number for your project)
84.   Item_Charge_Switch = 1001
86. #==============================================================================
87. # ---------- DO NOT EDIT BELOW THIS LINE (FOR ADVANCED USERS) --------------- #
88. #==============================================================================
90.   end
91. end
93. #==============================================================================
94. # ** Game_System
95. #------------------------------------------------------------------------------
96. #  This class handles system data. It saves the disable state of saving and
97. # menus. Instances of this class are referenced by $game_system.
98. #==============================================================================
100. class Game_System
101.   #--------------------------------------------------------------------------
102.   # * New Method: Item Charges Switch - To turn OFF/ON
103.   # (By default the switch is off = the script is turned "ON" working)
104.   #--------------------------------------------------------------------------
105.   def item_charges_switch_off(string)
106.     $game_switches[FG7::Easy_Item_Charges::Item_Charge_Switch] = string
107.   end
108. end
110. #==============================================================================
111. # ** Scene_ItemBase
112. #------------------------------------------------------------------------------
113. #  This class performs common processing for the item screen and skill screen.
114. #==============================================================================
116. class Scene_ItemBase < Scene_MenuBase
117.   #--------------------------------------------------------------------------
118.   # * Alias Method: Use Item (Modified to simulate "Item Charges" on items)
119.   #--------------------------------------------------------------------------
120.   alias :fg7_easy_item_charges_use_item :use_item
121.   def use_item
122.     # Checks if switch is turned on to use item charges for items
123.     if $game_switches[FG7::Easy_Item_Charges::Item_Charge_Switch] == false
124.       play_se_for_item
125.       # Checks if a number is in the items name
126.       if item.name =~ /\d/
127.         # Separates the number from item.name and subtracts to equal new number
128.         $item_name = item.name
129.         $original_charge = $item_name.gsub(/[^0-9]/, '')
130.         $reduced_charge = $original_charge.to_i - 1
131.         $item_name = $item_name.gsub!(/\d+/,"") + $reduced_charge.to_s
132.         # If item charge equals 1 - remove the "1" number value on item name
133.         if $reduced_charge.to_s == "1"
134.           $item_name = $item_name.gsub!(/\d+/,"")
135.         end
136.         # Places item variable back into "item.name"
137.         item.name = $item_name
138.         @category_window.activate
139.       # When no number in item name - treat item as normal usage
140.       else
141.         user.use_item(item)
142.         # If consuming last item in list, move cursor to top of list
143.         @item_window.select(0) if item == nil
144.       end
145.       use_item_to_actors
146.       check_common_event
147.       check_gameover
148.       @actor_window.refresh
149.       # Added to provide a true item charge usage feel
150.       @actor_window.deactivate.unselect
151.     else
152.       # If switch is turned off - perform original use_item call
153.       fg7_easy_item_charges_use_item
154.     end
155.   end
156. end

复制代码

How to Use

                        Add this script in the script editor under in the "Materials" section and above "Main Process".
The instructions and setup for the script are held within the script header itself. No need to repeat here.               
Click to expand...

Terms of Use

                        - Free to use in non-commercial projects and commercial projects
- Feel free to modify and improve the script. Credit is still required.
- Credit FamilyGamer7               
Click to expand...

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