Batch setting unreal engine blueprint asset material plugin

Abstract

The application relates to a batch setting unreal engine blueprint asset material plug-in. The plug-in comprises a blueprint inter-material one-key copy module, a smart material name matching and replacing mechanism module in multiple modes, a same material setting module for all mesh bodies in a blueprint and a same material setting module for specified named components in the blueprint, the smart material name matching and replacing mechanism module is combined with a set of configurable multi-rule string matching algorithm and an unreal engine blueprint asset structure traversal system, the algorithm intelligently analyzes and compares existing material names and candidate material names according to a matching mode selected by a user, after successful matching, the system accurately and batch assigns corresponding material asset pointers to target slots, and triggers instant compilation and updating of the blueprint. The application allows developers to easily and batch modify material assets in a blueprint asset, thereby simplifying the production process of a system such as a film or a game.

Description

Technical Field

[0001] This invention belongs to the field of Unreal Engine digital twin technology, specifically relating to a plugin for batch setting Unreal Engine Blueprint asset materials. Background Technology

[0002] "Blueprint assets" are special resource files in Unreal Engine used to visually create game logic, interaction rules, and reusable objects.

[0003] In Unreal Engine, everything imported or created is an "asset." It's like a standalone file in the project library. For example: a static mesh: a 3D model of a stone, a chair, or a building. Materials / material instances: files that define the visual properties of an object's surface (color, texture, reflection, etc.).

[0004] Textures: Images applied to the model's surface. Sound effects, particle effects, animations, data tables, etc. All assets are stored in the content browser and have unique names and paths.

[0005] Blueprints are Unreal Engine's signature visual scripting system. They allow you to create game functionality by connecting "nodes" instead of writing traditional code. Blueprints themselves are also assets, hence the term "Blueprint assets." They are primarily divided into two categories: Blueprint Class: This is the most common and important type. You can think of it as a "template" or "prefab" that can behave autonomously. Functionality: It not only contains 3D models (components), but more importantly, it contains the logic that makes these models "come alive" (such as how to move, how to react to player clicks, when to play sound effects, etc.). Analogy: Like a Lego instruction manual (Blueprint class), you can instantiate countless specific Lego models (concrete objects to be placed in the level) based on it. Example: A Blueprint class for an "automatic door" contains the door's mesh, the opening / closing animation, and the logic for "automatically opening when the player approaches." You can place many instances of this door in the level, and they will all follow the same logic.

[0006] Other Blueprint types: Level Blueprint: A global event script attached to a specific level. Blueprint Function Library: Encapsulates reusable pure function nodes. Blueprint Interface: Defines a set of functions that can be shared by different Blueprint classes.

[0007] A "Blueprint asset" typically refers to a "Blueprint class" that contains "static mesh components". A "Blueprint asset" may reference one or more material assets.

[0008] When you need to make batch modifications, the objects might be: 1. Directly modifying the materials of one hundred static mesh assets. 2. Modifying the materials on the static mesh components used in one hundred blueprint assets. 3. Modifying the materials of one hundred instances generated from blueprint assets that have already been placed in a level.

[0009] Blueprint assets (especially blueprints) are the basic units in Unreal Engine that package data (mesh, texture) and behavioral logic (visual scripts) together to form interactive game objects. They are a core tool for non-programmers participating in game development and serve as the blueprint for everything interactive within the engine.

[0010] As a project progresses to a certain stage, it inevitably encounters many sub-asset types. These include sub-asset types that need to be adapted to different level scenes and storyboards, requiring specific modifications. Essentially, it presents a variety of polymorphic situations. Currently, the massive asset data management needs encountered when using Unreal Engine for film or game development are significant, but the engine's built-in asset management tools are relatively limited and cannot effectively adapt to different users' needs for quick application in specific situations. Summary of the Invention To address the problems existing in the prior art, this invention provides a plugin for batch setting Unreal Engine Blueprint assets materials. It features a flexible and convenient menu management framework, allowing developers to easily modify material assets in Blueprint assets in batches, thereby simplifying the production process of systems such as film and television or games.

[0011] This invention adopts the following technical solution: a plugin for batch setting Unreal Engine Blueprint assets materials, characterized by including a module for one-click material copying between Blueprints, a module for intelligent material name matching and replacement mechanism in multiple modes, a module for setting the same material for all meshes within a Blueprint, and a module for uniformly setting the same material for specified named components within a Blueprint. The intelligent material name matching and replacement mechanism module combines a configurable multi-rule string matching algorithm with Unreal Engine's Blueprint asset structure traversal system. The algorithm intelligently parses and compares existing material names and candidate material names according to the matching mode selected by the user. After a successful match, the system automatically and accurately assigns the corresponding material asset pointers to the target slots in batches and triggers the real-time compilation and update of the Blueprint.

[0012] Preferably, the Unreal Engine's Blueprint Asset Structure Traversal System extracts all USCS_Node nodes and their component templates layer by layer by accessing the Blueprint's GeneratedClass and SimpleConstructionScript, thereby achieving complete coverage of the default instances of all mesh components in the entire Blueprint inheritance system.

[0013] Preferably, the multi-mode intelligent material name matching and replacement mechanism module includes five modes: normal, reverse, replacement, equal, and shielding.

[0014] Preferably, the module for one-click material copying between blueprints collects the material information of the source blueprint and the material slots in the target blueprint mesh component, sets the materials in the target blueprint according to the slots, compiles the blueprint, marks the target blueprint as modified, outputs logs, and prints the execution results.

[0015] Preferably, the step of setting the same material for all meshes within a blueprint involves first traversing all input blueprint assets and all components within the blueprint class, setting materials for all material slots, compiling and marking the blueprint as modified, outputting logs, and printing the execution results.

[0016] Preferably, the module for uniformly setting the same material for named components within a blueprint first iterates through all input blueprint assets and all components within the blueprint class, retrieves the name of the component in the current loop to check if it matches, and if so, sets the material for all material slots of that component; compiles and marks the blueprint as modified, outputs the log, and prints the execution result; if not, it returns to the step of retrieving the name of the component in the current loop.

[0017] This invention integrates four core functional modules through the development of a C++ editor plugin. It overcomes the previous technical challenge of not being able to obtain default instances of Blueprint-type assets. Building upon this, and combining a configurable multi-rule string matching algorithm, the system can intelligently identify and replace material assets that conform to the rules, thereby achieving batch, precise, and automated material management. Integrated non-intrusively into the Unreal Engine Content Browser, it significantly improves the efficiency and standardization of adjusting multi-version, multi-scene asset materials in film and game projects. Attached Figure Description

[0018] Figure 1 This is the overall flowchart of the present invention.

[0019] Figure 2 This is a flowchart illustrating function 1 of the present invention.

[0020] Figure 3 This is a flowchart illustrating function 2 of the present invention.

[0021] Figure 4 This is a flowchart illustrating function 3 of the present invention.

[0022] Figure 5 This is a flowchart illustrating function 4 of the present invention. Detailed Implementation

[0023] The present invention will be further described below with reference to specific embodiments.

[0024] like Figures 1-5 As shown, this invention provides a plugin for batch setting Unreal Engine Blueprint assets materials. It includes a module for one-click material copying between Blueprints, a module for intelligent material name matching and replacement under multiple modes, a module for setting the same material for all meshes within a Blueprint, and a module for uniformly setting the same material for specified named components within a Blueprint. The intelligent material name matching and replacement mechanism combines a configurable multi-rule string matching algorithm with Unreal Engine's Blueprint asset structure traversal system. The algorithm intelligently parses and compares existing material names and candidate material names based on the user-selected matching mode. Upon successful matching, the system automatically and precisely assigns the corresponding material asset pointers to the target slots in batches, triggering real-time compilation and updates of the Blueprint. This invention integrates four core functional modules through the development of a C++ editor plugin. The key technology of this solution lies in the automatic parsing and traversal of the Unreal Engine Blueprint component structure.

[0025] Specifically, Unreal Engine's Blueprint asset structure traversal system extracts all USCS_Node nodes and their component templates layer by layer by accessing the Blueprint's GeneratedClass and SimpleConstructionScript, achieving complete coverage of default instances of all mesh components in the entire Blueprint inheritance system. This technology overcomes the previous technical difficulty of not being able to obtain the default instances corresponding to Blueprint-type assets. Based on this, combined with a configurable multi-rule string matching algorithm, the system can intelligently identify and replace material assets that conform to the rules, thereby achieving batch, precise, and automated material management.

[0026] Specifically, the intelligent material name matching and replacement mechanism module under multiple modes includes five modes: normal, reverse, replacement, equal, and shielding.

[0027] Specifically, such as Figure 1 In Function 1, the module for one-click material copying between blueprints collects material information from the source blueprint and material slots in the target blueprint's mesh component. It then sets the materials in the target blueprint according to the corresponding slots, compiles the blueprint, marks it as modified, outputs logs, and prints the execution results. The algorithm intelligently parses and compares existing material names with candidate material names based on the user-selected matching mode (e.g., Common, Inverse, Shield), performing actions such as underscore positioning and filtering or specifying character filtering. Upon successful matching, the system automatically and precisely assigns the corresponding material asset pointers to the target slots in batches, triggering real-time compilation and updating of the blueprint.

[0028] Specifically, such as Figure 4In Function 3, the module that sets the same material for all meshes within a blueprint first iterates through all input blueprint class assets and all components in the blueprint class, sets materials for all material slots, compiles and marks the blueprint as modified, outputs logs and prints the execution results.

[0029] Specifically, such as Figure 5 In function 4, the module for uniformly setting the same material for named components within a blueprint first iterates through all input blueprint assets and all components in the blueprint class, obtains the name of the component in the current loop to check if it matches, if it does, then sets the material for all material slots of that component; compiles and marks the blueprint as modified, outputs the log and prints the execution result; if not, it returns to the step of obtaining the name of the component in the current loop.

[0030] This invention transforms tedious manual identification and operation into an automated processing flow driven by string rules, thereby achieving accurate and efficient material replacement and significantly improving the management efficiency of material assets.

[0031] It should be understood that these embodiments are for illustrative purposes only and are not intended to limit the scope of the invention. Furthermore, it should be understood that after reading the teachings of this invention, those skilled in the art can make various alterations or modifications to the invention, and these equivalent forms also fall within the scope defined by the appended claims.

Claims

1. A plugin for batch setting Unreal Engine Blueprint asset materials, characterized by... This includes a module for one-click material copying between blueprints, a module for intelligent material name matching and replacement in multiple modes, a module for setting the same material for all meshes within a blueprint, and a module for uniformly setting the same material for specified named components within a blueprint. The intelligent material name matching and replacement mechanism combines a configurable multi-rule string matching algorithm with Unreal Engine's blueprint asset structure traversal system. The algorithm intelligently parses and compares existing material names and candidate material names according to the matching mode selected by the user. After a successful match, the system automatically and precisely assigns the corresponding material asset pointers to the target slots in batches and triggers the real-time compilation and update of the blueprint.

2. The batch setting Unreal Engine Blueprint asset material plugin according to claim 1, characterized in that... The Unreal Engine's Blueprint asset structure traversal system extracts all USCS_Node nodes and their component templates layer by layer by accessing the Blueprint's GeneratedClass and SimpleConstructionScript, thus achieving complete coverage of the default instances of all mesh components in the entire Blueprint inheritance system.

3. The batch setting Unreal Engine Blueprint asset material plugin according to claim 1 or 2, characterized in that... The intelligent material name matching and replacement mechanism module under multiple modes includes five modes: normal, reverse, replacement, equal, and shielding.

4. The batch setting Unreal Engine Blueprint asset material plugin according to claim 1, characterized in that... The module for one-click material copying between blueprints collects material information from the source blueprint and material slots in the target blueprint mesh component. It then sets the materials in the target blueprint according to the slots, compiles the code, marks the target blueprint as modified, outputs logs, and prints the execution results.

5. The batch setting Unreal Engine Blueprint asset material plugin according to claim 1, characterized in that... The module for setting the same material for all meshes within a blueprint first iterates through all input blueprint assets and all components within the blueprint class, sets materials for all material slots, compiles and marks the blueprint as modified, outputs logs, and prints the execution results.

6. The batch setting Unreal Engine Blueprint asset material plugin according to claim 1, characterized in that... The module for uniformly setting the same material for named components within a blueprint first iterates through all input blueprint assets and all components within the blueprint class, retrieves the name of the component in the current loop to check if it matches, and if so, sets the material for all material slots of that component. Compile and mark the blueprint as modified, output the log, and print the execution result; otherwise, return to the step of getting the name of the component in the current loop.

Images