R3EXS 1.0.0

data/lib/R3EXS/ast.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require 'prism'
+
+module R3EXS
+
+    # 用来提取源码生成的 AST 中的字符串和符号
+    class StringsExtractor < Prism::Visitor
+
+        # @param strings [Array<String>] 存储提取出的字符串的数组
+        # @param with_symbol [Boolean] 是否包含脚本中的符号
+        # @return [StringsExtractor]
+        def initialize(strings, with_symbol)
+            @strings = strings
+            @with_symbol = with_symbol
+        end
+
+        # 处理类型为 StringNode 的节点
+        #
+        # @param node [Prism::StringNode] AST 节点
+        # @return [void]
+        def visit_string_node(node)
+            @strings << node.content
+            super
+        end
+
+        # 处理类型为 SymbolNode 的节点
+        #
+        # @param node [Prism::SymbolNode] AST 节点
+        # @return [void]
+        def visit_symbol_node(node)
+            @strings << node.value if @with_symbol
+            super
+        end
+
+        # 提取后存储的字符串数组
+        #
+        # @return [Array<String>]
+        attr_accessor :strings
+
+        # 是否包含脚本中的符号
+        #
+        # @return [Boolean]
+        attr_accessor :with_symbol
+
+    end
+
+    # 用来替换源码里面的字符串和符号
+    class StringsInjector < Prism::Visitor
+
+        # 用来记录字符串的位置
+        class Location
+
+            # @note start_offset 是字符串在二进制下打开时的位置
+            #
+            # @param start_offset [Integer] 字符串在源文件中的起始位置
+            # @param length [Integer] 字符串的长度
+            # @param content [String] 字符串内容
+            # @return [Location]
+            def initialize(start_offset, length, content)
+                @start_offset = start_offset
+                @length = length
+                @content = content
+            end
+
+            # 字符串在二进制源文件中的起始位置
+            #
+            # @return [Integer]
+            attr_reader :start_offset
+
+            # 字符串的长度
+            #
+            # @return [Integer]
+            attr_reader :length
+
+            # 字符串内容
+            #
+            # @return [String]
+            attr_reader :content
+
+        end
+
+        # @param hash [Hash<String, String>] 字符串翻译表
+        # @return [StringsInjector]
+        def initialize(hash)
+            @strings_hash = hash
+            @content_loc = []
+            @code = []
+        end
+
+        # 处理类型为 StringNode 的节点
+        #
+        # @param node [Prism::StringNode] AST 节点
+        # @return [void]
+        def visit_string_node(node)
+            location = node.content_loc
+            value = location.slice
+            if @strings_hash.has_key?(value)
+                @content_loc << Location.new(location.start_offset, location.length, @strings_hash[value])
+            end
+            super
+        end
+
+        # 处理类型为 SymbolNode 的节点
+        #
+        # @param node [Prism::SymbolNode] AST 节点
+        # @return [void]
+        def visit_symbol_node(node)
+            location = node.value_loc
+            # 如果 location 不为 nil，说明这个符号是一个字符串
+            if location
+                value = location.slice
+                if @strings_hash.has_key?(value)
+                    @content_loc << Location.new(location.start_offset, location.length, @strings_hash[value])
+                end
+            end
+            super
+        end
+
+        # 将 file_path 对应位置的源码中的字符串替换成 '@strings_hash' 翻译后的字符串
+        #
+        # @param file_path [String] 源文件路径
+        # @param ast_root [Prism::ProgramNode] AST 树根节点
+        # @return [String]
+        def rewrite(file_path, ast_root)
+            # 读取文件内容
+            # 这里必须使用 rb 模式，因为 Prism 定位的位置是二进制下的位置
+            # 也就是说没有考虑换行符的问题，所以必须使用二进制模式读取文件
+            code = File.read(file_path, mode: 'rb')
+
+            # 首先遍历一遍，找到所有需要替换的字符串的位置
+            visit(ast_root)
+
+            # 然后开始替换 code 中的字符串
+            # 先将 @content_loc 按照 start_offset 从小到大排序
+            @content_loc.sort_by! { |loc| loc.start_offset }
+
+            #  然后将 code 切片，将字符串替换成新的字符串
+            start_offset = 0
+            @content_loc.each do |loc|
+                @code << code[start_offset...loc.start_offset]
+                @code << loc.content
+                start_offset = loc.start_offset + loc.length
+            end
+            @code << code[start_offset..-1]
+
+            # 将 @code 里面的字符串全部改为 UTF-8 编码
+            @code.map! { |str| str.force_encoding('UTF-8') }
+            @code.join
+        end
+
+    end
+
+end

data/lib/R3EXS/error.rb

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+module R3EXS
+
+    # 用来处理 RPG 模块下的类型错误的异常
+    class RPGTypeError < TypeError
+
+        # @param msg [String] 异常信息
+        # @param obj [Object] 引发异常的类
+        # @return [RPGTypeError]
+        def initialize(msg = '', obj)
+            super(msg)
+            @obj = obj
+        end
+
+        # 引发异常的类
+        #
+        # @return [Object]
+        attr_reader :obj
+    end
+
+    # 用来处理 R3EXS 模块下的类型错误的异常
+    class R3EXSTypeError < TypeError
+
+        # @param msg [String] 异常信息
+        # @param obj [Object] 引发异常的的类型
+        # @return [R3EXSTypeError]
+        def initialize(msg = '', obj)
+            super(msg)
+            @obj = obj
+        end
+
+        # 引发异常的类型
+        #
+        # @return [Object]
+        attr_reader :obj
+    end
+
+    # 用来处理 rvdata2 文件损坏的异常
+    class Rvdata2FileError < StandardError
+
+        # @param msg [String] 异常信息
+        # @param rvdata2_path [String] 引发异常的 rvdata2 文件路径
+        # @return [Rvdata2DirError]
+        def initialize(msg = '', rvdata2_path)
+            super(msg)
+            @rvdata2_path = rvdata2_path
+        end
+
+        # 引发异常的 rvdata2 文件路径
+        #
+        # @return [String]
+        attr_reader :rvdata2_path
+    end
+
+    # 用来处理 RPG 模块下 JSON 文件损坏的异常
+    class RPGJsonFileError < StandardError
+
+        # @param msg [String] 异常信息
+        # @param json_path [String] 引发异常的 json 文件路径
+        # @return [RPGJsonFileError]
+        def initialize(msg = '', json_path)
+            super(msg)
+            @json_path = json_path
+        end
+
+        # 引发异常的 json 文件路径
+        #
+        # @return [String]
+        attr_reader :json_path
+    end
+
+    # 用来处理 R3EXS 模块下 JSON 文件损坏的异常
+    class R3EXSJsonFileError < StandardError
+
+        # @param msg [String] 异常信息
+        # @param json_path [String] 引发异常的 json 文件路径
+        # @return [R3EXSJsonFileError]
+        def initialize(msg = '', json_path)
+            super(msg)
+            @json_path = json_path
+        end
+
+        # 引发异常的 json 文件路径
+        #
+        # @return [String]
+        attr_reader :rvdata2_path
+    end
+
+    # 用来处理模块名错误的异常
+    class ModuleNameError < ArgumentError
+
+        # @param msg [String] 异常信息
+        # @param module_name [Symbol] 引发异常的模块名
+        # @return [ModuleNameError]
+        def initialize(msg = '', module_name)
+            super(msg)
+            @module_name = module_name
+        end
+
+        # 引发异常的模块名
+        #
+        # @return [Symbol]
+        attr_reader :module_name
+    end
+
+    # 用来处理文件名错误的异常
+    class FileBaseNameError < ArgumentError
+
+        # @param msg [String] 异常信息
+        # @param filebasename [String] 引发异常的文件名
+        # @return [FileBaseNameError]
+        def initialize(msg = '', filebasename)
+            super(msg)
+            @filebasename = filebasename
+        end
+
+        # 引发异常的文件名
+        #
+        # @return [String]
+        attr_reader :filebasename
+    end
+
+    # 用来处理 *.rvdata2 文件目录不存在的异常
+    class Rvdata2DirError < IOError
+
+        # @param msg [String] 异常信息
+        # @param rvdata2_dir [String] 引发异常的 *.rvdata2 文件目录
+        # @return [Rvdata2DirError]
+        def initialize(msg = '', rvdata2_dir)
+            super(msg)
+            @rvdata2_dir = rvdata2_dir
+        end
+
+        # 引发异常的 *.rvdata2 文件目录
+        #
+        # @return [String]
+        attr_reader :rvdata2_dir
+    end
+
+    # 用来处理 *.json 文件目录不存在的异常
+    class JsonDirError < IOError
+
+        # @param msg [String] 异常信息
+        # @param json_dir [String] 引发异常的 *.json 文件目录
+        # @return [JsonDirError]
+        def initialize(msg = '', json_dir)
+            super(msg)
+            @json_dir = json_dir
+        end
+
+        # 引发异常的 *.json 文件目录
+        #
+        # @return [String]
+        attr_reader :json_dir
+    end
+
+    # 用来处理 *.rb 文件目录不存在的异常
+    class ScriptsDirError < IOError
+
+        # @param msg [String] 异常信息
+        # @param scripts_dir [String] 引发异常的 *.rb 文件目录
+        # @return [ScriptsDirError]
+        def initialize(msg = '', scripts_dir)
+            super(msg)
+            @scripts_dir = scripts_dir
+        end
+
+        # 引发异常的 *.rb 文件目录
+        #
+        # @return [String]
+        attr_reader :scripts_dir
+    end
+
+    # 用来处理 Scripts_info.json 文件不存在的异常
+    class ScriptsInfoPathError < IOError
+
+        # @param msg [String] 异常信息
+        # @param scripts_info_path [String] 引发异常的 Scripts_info.json 文件路径
+        # @return [ScriptsInfoPathError]
+        def initialize(msg = '', scripts_info_path)
+            super(msg)
+            @scripts_info_path = scripts_info_path
+        end
+
+        # 引发异常的 Scripts_info.json 文件路径
+        #
+        # @return [String]
+        attr_reader :scripts_info_path
+    end
+
+    # 用来处理 ManualTransFile.json 文件不存在的异常
+    class ManualTransFilePathError < IOError
+
+        # @param msg [String] 异常信息
+        # @param manualtransfile_path [String] 引发异常的 ManualTransFile.json 文件路径
+        # @return [ManualTransFilePathError]
+        def initialize(msg = '', manualtransfile_path)
+            super(msg)
+            @manualtransfile_path = manualtransfile_path
+        end
+
+        # 引发异常的 ManualTransFile.json 文件路径
+        #
+        # @return [String]
+        attr_reader :manualtransfile_path
+    end
+
+end

data/lib/R3EXS/extract_strings.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require 'zlib'
+require_relative 'ast'
+require_relative 'utils'
+require_relative 'RGSS3_R3EXS'
+
+module R3EXS
+
+    # 将 Ruby 源码中的字符串和符号提取出来
+    #
+    # @param target_dir [String] 目标目录
+    # @param with_symbol [Boolean] 是否包含脚本中的符号
+    #
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    #
+    # @return [Array<String>]
+    def R3EXS.rb_ex_strings(target_dir, with_symbol)
+        full_dir = File.join(target_dir, 'Scripts')
+        Dir.exist?(full_dir) or raise ScriptsDirError.new(full_dir), "Scripts directory not found: #{full_dir}"
+
+        strings = []
+        strings_extractor = StringsExtractor.new(strings, with_symbol)
+        Dir.glob(File.join(full_dir, '*.rb')).each do |script_file_path|
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Exreacting from #{Utils::RESET_COLOR}#{script_file_path}...\r" if $global_options[:verbose]
+
+            strings_extractor.visit(Prism.parse_file(script_file_path).value)
+
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Exreacted #{Utils::RESET_COLOR}#{script_file_path}\n" if $global_options[:verbose]
+        end
+        strings
+    end
+
+    # 将指定目录下的所有已经序列化为 R3EXS 后的 JOSN 文件中的字符串提取出来
+    #
+    # @param target_dir [String] 目标目录
+    # @param output_dir [String] 输出目录
+    # @param with_scripts [Boolean] 是否包含脚本
+    # @param with_symbol [Boolean] 是否包含脚本中的符号
+    # @param with_scripts_separate [Boolean] 是否将脚本提取的字符串单独存放
+    #
+    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+    # @raise [JsonDirError] target_dir 不存在
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    #
+    # @return [void]
+    def R3EXS.ex_strings(target_dir, output_dir, with_scripts, with_symbol, with_scripts_separate)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+        all_ex_strings = []
+
+        Utils.all_json_files(target_dir, :R3EXS) do |object, file_basename|
+            file_path = File.join(target_dir, "#{file_basename}.json")
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Extracting from #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
+            if object.is_a?(Array)
+                object.each do |obj|
+                    all_ex_strings.concat(obj.ex_strings)
+                end
+            else
+                all_ex_strings.concat(object.ex_strings)
+            end
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Extracted #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+        end
+
+        if with_scripts
+            scripts_strings = rb_ex_strings(target_dir, with_symbol)
+            if with_scripts_separate
+                # 去除 nil 元素
+                scripts_strings.compact!
+                Utils.object_json(scripts_strings.each_with_object({}) { |item, h| h[item] = item }, File.join(output_dir, 'ManualTransFile_scripts.json'))
+            else
+                all_ex_strings.concat(scripts_strings)
+            end
+        end
+
+        # 去除 nil 元素
+        all_ex_strings.compact!
+        Utils.object_json(all_ex_strings.each_with_object({}) { |item, h| h[item] = item }, File.join(output_dir, "ManualTransFile.json"))
+    end
+
+end

data/lib/R3EXS/inject_strings.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'zlib'
+require_relative 'ast'
+require_relative 'utils'
+require_relative 'RGSS3_R3EXS'
+
+module R3EXS
+
+    # 将 Ruby 源码中的字符串和符号替换为指定的字符串
+    #
+    # @param target_dir [String] 目标目录
+    # @param output_dir [String] 输出目录
+    # @param hash [Hash]
+    #
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    #
+    # @return [void]
+    def R3EXS.rb_in_strings(target_dir, output_dir, hash)
+        target_full_dir = File.join(target_dir, 'Scripts')
+        output_full_dir = File.join(output_dir, 'Scripts')
+        FileUtils.mkdir(output_full_dir) unless Dir.exist?(output_full_dir)
+        Dir.exist?(target_full_dir) or raise ScriptsDirError.new(target_full_dir), "Scripts directory not found: #{target_full_dir}"
+
+        Dir.glob(File.join(target_full_dir, "*.rb")).each do |script_file_path|
+            output_script_file_dir = File.join(output_full_dir, File.basename(script_file_path))
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Injecting to #{Utils::RESET_COLOR}#{output_script_file_dir}...\r" if $global_options[:verbose]
+
+            File.write(output_script_file_dir, StringsInjector.new(hash).rewrite(script_file_path, Prism.parse_file(script_file_path).value), mode: 'w')
+
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Injected #{Utils::RESET_COLOR}#{output_script_file_dir}\n" if $global_options[:verbose]
+        end
+    end
+
+    # 将指定目录下的所有已经序列化为 R3EXS 后的 JOSN 文件按照 ManualTransFile.json 翻译注入
+    #
+    # @param target_dir [String] 目标目录
+    # @param output_dir [String] 输出目录
+    # @param manualtransfile_path [String] ManualTransFile.json 文件路径
+    # @param with_scripts [Boolean] 是否包含脚本
+    #
+    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+    # @raise [JsonDirError] target_dir 不存在
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    # @raise [ManualTransFilePath] ManualTransFile.json 不存在
+    #
+    # @return [void]
+    def R3EXS.in_strings(target_dir, output_dir, manualtransfile_path, with_scripts)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+        File.exist?(manualtransfile_path) or raise ManualTransFilePathError.new(manualtransfile_path), "ManualTransFile.json not found: #{manualtransfile_path}"
+
+        manual_trans_hash = Oj.load_file(manualtransfile_path)
+
+        Utils.all_json_files(target_dir, :R3EXS) do |object, file_basename|
+            file_path = File.join(output_dir, "#{file_basename}.json")
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Injecting to #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
+            if object.is_a?(Array)
+                object.each do |obj|
+                    obj.in_strings(manual_trans_hash)
+                end
+            else
+                object.in_strings(manual_trans_hash)
+            end
+            Utils.object_json(object, file_path)
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Injected #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+        end
+
+        if with_scripts
+            rb_in_strings(target_dir, output_dir, manual_trans_hash)
+        end
+    end
+
+end

data/lib/R3EXS/json_rvdata2.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require 'zlib'
+require_relative 'utils'
+require_relative 'RGSS3_R3EXS'
+
+module R3EXS
+
+    # 将 Ruby 源码读取压缩后序列化到输出目录
+    #
+    # @param target_dir [String] 目标目录
+    # @param output_dir [String] 输出目录
+    #
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
+    #
+    # @return [void]
+    def R3EXS.rb_scripts(target_dir, output_dir)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+        scripts_array = []
+        full_dir = File.join(target_dir, 'Scripts')
+        script_info_file_path = File.join(full_dir, 'Scripts_info.json')
+
+        Dir.exist?(full_dir) or raise ScriptsDirError.new(full_dir), "Scripts directory not found: #{full_dir}"
+        File.exist?(script_info_file_path) or raise ScriptsInfoPathError.new(script_info_file_path), "Scripts_info.json not found: #{script_info_file_path}"
+
+        print "#{Utils::ESCAPE}#{Utils::YELLOW_COLOR}Reading from #{Utils::RESET_COLOR}#{script_info_file_path}...\r" if $global_options[:verbose]
+        scripts_info_array = Oj.load_file(script_info_file_path)
+
+        scripts_info_array.each do |script_info|
+            index = script_info[:index]
+            script_file_path = File.join(full_dir, "#{format('%03d', index)}.rb")
+            print "#{Utils::ESCAPE}#{Utils::YELLOW_COLOR}Reading from #{Utils::RESET_COLOR}#{script_file_path}...\r" if $global_options[:verbose]
+            scripts_array << [114514, script_info[:name], Zlib::Deflate.deflate(File.read(script_file_path, mode: "r"))]
+        end
+        Utils.object_rvdata2(scripts_array, File.join(output_dir, 'Scripts.rvdata2'))
+    end
+
+    # 将指定目录下的所有JSON文件转换为 rvdata2 文件
+    #
+    # @param [String] target_dir 目标目录
+    # @param [String] output_dir 输出目录
+    # @param [String] original_dir 原始 rvdata2 文件目录
+    # @param [Boolean] complete 是否完全转换
+    # @param [Boolean] with_scripts 是否转换Scripts
+    #
+    # @raise [RPGJsonFileError] json 文件不是 RPG 模块中的对象
+    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+    # @raise [Rvdata2FileError] 原始 rvdata2 文件可能损坏
+    # @raise [JsonDirError] target_dir 不存在
+    # @raise [Rvdata2DirError] original_dir 不存在
+    # @raise [ScriptsDirError] Scripts 目录不存在
+    # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
+    #
+    # @return [void]
+    def R3EXS.json_rvdata2(target_dir, output_dir, original_dir, complete, with_scripts)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+
+        if complete
+            Utils.all_json_files(target_dir, :RPG) do |object, file_basename|
+                file_path = File.join(output_dir, "#{file_basename}.rvdata2")
+                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{file_path}...\n" if $global_options[:verbose]
+                Utils.object_rvdata2(object, file_path)
+                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+            end
+        else
+            # 检查 original_dir 是否存在
+            Dir.exist?(original_dir) or raise Rvdata2DirError.new(original_dir), "Original rvdata2 directory not found: #{original_dir}"
+            Utils.all_json_files(target_dir, :R3EXS) do |object, file_basename|
+
+                original_file_path = File.join(original_dir, file_basename + '.rvdata2')
+                print "#{Utils::ESCAPE}#{Utils::BLUE_COLOR}Reading and Deserializing #{Utils::RESET_COLOR}#{original_file_path}...\r" if $global_options[:verbose]
+                original_object = File.open(original_file_path, 'rb') { |file| Marshal.load(file) }
+
+                # 这里的类型检查要用紧凑模式，因为 rvdata2 文件中可能存在 nil 元素，必须忽略
+                begin
+                    Utils.check_type(original_object, file_basename, true, :RPG)
+                rescue RPGTypeError
+                    raise Rvdata2FileError.new(original_file_path), "Invalid rvdata2 file: #{original_file_path}"
+                end
+
+                file_path = File.join(output_dir, "#{file_basename}.rvdata2")
+                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{file_path}...\n" if $global_options[:verbose]
+
+                # 根据是否为数组进行不同的处理
+                if object.is_a?(Array)
+                    object.each do |obj|
+                        obj.inject_to(original_object[obj.index])
+                    end
+                else
+                    object.inject_to(original_object)
+                end
+                Utils.object_rvdata2(original_object, file_path)
+                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+            end
+        end
+
+        if with_scripts
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{File.join(output_dir, 'Scripts.rvdata2')}...\r" if $global_options[:verbose]
+            rb_scripts(target_dir, output_dir)
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}Scripts\n" if $global_options[:verbose]
+        end
+    end
+
+end

data/lib/R3EXS/rvdata2_json.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'zlib'
+require_relative 'utils'
+require_relative 'RGSS3_R3EXS'
+
+module R3EXS
+
+    # 将 Script 对象数组序列化为 Ruby 源码
+    #
+    # @param scripts [Array<Array>] 待转换的 Script 对象数组
+    # @param output_dir [String] 输出目录
+    # @return [void]
+    def R3EXS.scripts_rb(scripts, output_dir)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+        full_dir = File.join(output_dir, 'Scripts')
+        FileUtils.mkdir(full_dir) unless Dir.exist?(full_dir)
+
+        scripts_info_array = []
+        scripts.each_with_index do |script, index|
+            next if script.nil?
+            scripts_info_array << { index: index, name: script[1] }
+            script_file_path = File.join(full_dir, "#{format('%03d', index)}.rb")
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{script_file_path}...\r" if $global_options[:verbose]
+            File.write(script_file_path, Zlib::Inflate.inflate(script[2]).encode(universal_newline: true), mode: 'w')
+        end
+
+        script_info_file_path = File.join(full_dir, 'Scripts_info.json')
+        print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{script_info_file_path}\r" if $global_options[:verbose]
+        Utils.object_json(scripts_info_array, script_info_file_path)
+    end
+
+    # 将指定目录下的所有 rvdata2 文件序列化为 JSON 格式
+    #
+    # @param target_dir [String] 目标目录
+    # @param output_dir [String] 输出目录
+    # @param complete [Boolean] 是否序列化所有内容
+    # @param with_scripts [Boolean] 是否包含脚本
+    # @param with_notes [Boolean] 是否包含备注
+    #
+    # @raise [Rvdata2FileError] rvdata2 文件可能损坏
+    # @raise [Rvdata2DirError] target_dir 不存在
+    #
+    # @return [void]
+    def R3EXS.rvdata2_json(target_dir, output_dir, complete, with_scripts, with_notes)
+        FileUtils.mkdir(output_dir) unless Dir.exist?(output_dir)
+        Utils.all_rvdata2_files(target_dir) do |object, file_basename|
+
+            if file_basename == 'Scripts'
+                scripts_rb(object, output_dir) if with_scripts
+                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+                next
+            end
+
+            file_path = File.join(output_dir, "#{file_basename}.json")
+            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
+            if complete
+                Utils.object_json(object, file_path)
+            else
+                Utils.object_json(Utils.rpg_r3exs(object, file_basename, with_notes), file_path)
+            end
+            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{file_basename}\n" if $global_options[:verbose]
+        end
+    end
+
+end