Engine Tools

[Blueprint] Array Helper

Blueprint Array Helper delivers Blueprint functions for array handling, predicate sorting, RegEx matching, math operations, and spatial proximity queries.

[Blueprint] Array HelperEngine Tools

Resource overview

[Blueprint] Array Helper provides a library of Blueprint nodes designed to simplify how collections of data are processed throughout project graphs. By default, visual scripting graphs often require repetitive loop structures, custom macro setups, or iterative logic to handle everyday data reorganizations. This plugin centralizes these tasks into accessible Blueprint functions that can be invoked anywhere in the project, giving developers immediate control over both generic and typed arrays.

Global Array Operations and Reference Handling in Blueprint

Data mutation in node graphs frequently forces a choice between preserving the original data structure or working on an isolated duplicate. The plugin provides explicit handling modes to address this balance, allowing functions to process arrays either by reference or by value. Operating by reference applies alterations directly to the existing source array, preventing the memory overhead of duplicate allocations when modifying long sequences. Operating by value creates a distinct copy before applying transformations, safeguarding incoming structures against unintended mutations when downstream systems require pristine source data.

Type coverage extends across both generic arrays and specific primitive or engine types. Supported data types include standard numeric formats such as Byte, Integer, Float, and Double, alongside text and identifier formats including String and Name. For engine-level references and spatial calculations, the toolset natively accepts Vector, Vector2D, Object, and Actor collections. This breadth allows the same functional methodology to govern basic integer counters, string lookups, and transform-heavy actor groupings without requiring bespoke type-casting nodes before every operation.

Predicate-Based Sorting, Filtering, and Subarray Extraction

Organizing sequential information in standard node graphs typically requires multi-node bubble sorts or temporary storage containers. [Blueprint] Array Helper simplifies this workflow by introducing direct sorting and filtering nodes driven by predicates. By attaching a custom evaluation function, the developer specifies the precise criteria governing how elements compare against one another. The underlying sorting node processes the target collection according to that rule, yielding ordered results directly within the graph.

Filtering functions use the same predicate pattern to evaluate elements conditionally. Instead of constructing manual loop bodies with conditional branches and temporary output arrays, a single filter node accepts the source collection alongside a custom condition. Items satisfying the predicate criteria pass through, while non-matching entries are omitted. When only a specific segment of a sequence is needed, subarray extraction nodes isolate and return that portion without destroying the remainder of the dataset. Complementing these extraction tools, copy-reverse functions duplicate and invert element ordering in a single step.

Math Operations, Clamping, and Normalization for Numeric Arrays

Datasets composed of Byte, Integer, Float, or Double values frequently require batch transformations before they can feed gameplay systems, user interfaces, or procedural calculations. The plugin includes nodes dedicated exclusively to math operations on numeric arrays. Rather than running an iterative loop across an entire container to modify every entry individually, developers can apply mathematical operations across the full collection at once.

Data normalization and range enforcement are built directly into the numeric toolset. Normalizing a numeric array adjusts the internal spread of values against a standardized distribution, making raw metrics suitable for weighting systems or relative scaling algorithms. Clamping functions restrict numeric elements to predefined upper and lower boundaries, ensuring that runaway calculations or extreme outlying values do not compromise dependent systems. For testing routines, procedural variations, and statistical distributions, the toolset also generates random numeric arrays populated with randomized values on demand.

Proximity Queries Across Vector and Actor Collections

Spatial calculations represent a substantial portion of gameplay programming, particularly when tracking transforms, waypoints, or world objects. The plugin includes specialized logic to resolve distance queries across Vector arrays and Actor arrays without requiring custom math sequences inside the graph.

Dedicated nodes evaluate an entire collection of positions or actors to find either the closest or farthest item relative to a query point. When dealing with Vector arrays, the search functions calculate spatial separation between coordinate points to return the nearest or most distant vector. When working with Actor arrays, the function queries the target actors to locate which specific instance sits closest to or farthest from the reference location. Consolidating proximity loops into single functional nodes eliminates visual clutter and reduces graph complexity in tracking, targeting, and environmental query tasks.

String Parsing, RegEx Evaluation, and Deduplication via Sets

String processing often demands parsing delimited text feeds or validating data formats. The plugin supports string splitting by designated separators, immediately converting continuous string inputs into structured string arrays. For complex character evaluation, string arrays can be evaluated against Regular Expressions (RegEx). Matching nodes verify whether string elements adhere to regular expression patterns, enabling syntax checks, token identification, and pattern filtering directly within Blueprint logic.

Data hygiene is further supported through array-to-set conversion nodes. Converting an array to a set automatically purges all duplicate entries, producing a clean collection containing only unique elements. This workflow pairs naturally with broader project utility structures, offering direct compatibility alongside tools like [Blueprint] File Helper when ingesting, cleaning, and routing external text files or persistent data streams.

Explore Similar Assets

Free Download

Download this resource

Log in or create a free account to start your download.

Resources are manually reviewed before listing to improve quality and reduce obvious risks.

Resource archiveArray Helper Blueprint Library.7z

Related resources