• The property at the top marked "Pool Profile" represents your currently chosen Pool Profile. You can change it using the drop-down, which will give you a list of all the Pool Profile assets contained within your project.

• The save button gives you a way to save any changes you make to the currently selected Pool Profile. The button only becomes clickable when any unsaved changes have been detected as a result of a property being changed using the editor tool.

• The profile entries visible in the picture are explained at PoolProfileEntry.

Things to note:

• The tool becomes read-only when a level is being played. This is done to prevent issues that may arise from editing underlying assets that are currently being used inside of the world.

• The save button becomes available when a level is playing and allows you to save the current pooling information to an external text file in case you want to analyse the data at a later date.

• Each pool entry contains the following core information above the table:

  1. The custom pool profile name assigned by the user for the pool profile.

  2. The name of the pool profile asset within the project files.

  3. The name of the owner that the pool profile is a part of.

• The table lists the following columns of information about each pooled actor type:

  1. Name - The name of the pooled actor type.

  2. Current Count - The number of actors currently held in the pool.

  3. Peak Count - The maximum number of actors held in the pool at any time.

  4. Current Active - The number of currently active actors.

  5. Peak Active - The maximum number of actors that were active at any time.

  6. Current Inactive - The number of currently inactive actors.

  7. Peak Inactive - The maximum number of actors that were inactive at any time.

  8. Dynamic Allocations - The number of actors that were dynamically allocated during gameplay, due to insufficient available actors.

  9. Decaying Count - The number of currently decaying actors.

  10. Peak Decaying - The maximum number of decaying actors at any time.

  11. Decayed Count - The number of actors that have decayed to date.

  12. Destroyed Count - The number of actors that have been destroyed to date via decay/destroy calls.

Things to note:

• Pooling information is not immediately cleared on level end to allow for further analysis of data.

• ActorPoolComponents that are added during runtime are automatically added to the profiler and their information is tracked as usual.

• Similarly, when an ActorPoolComponent is destroyed their entry is automatically removed from the profiler to reflect the current state of the world.

• When the profiler is opened after the level has begun playing, the profiler will display a "Start Profiling" that the user can press to begin pool profiling.

• The analysis files are stored at the following location within your project files like so: "[Your Unreal Project]/Saved/SmartPool/".

• The file name is constructed like so: "PoolAnalysis-[MAP_NAME]-[CURRENT_DATE]-[CURRENT_TIME]".

  1. MAP_NAME - The name of the map from which the analysis came from. 

  2. CURRENT_DATE/TIME - The time at which the snapshot was captured, allows you to capture multiple snapshots within the same level without overriding previous snapshots.

• The information captured is the same as the information visible in the Pool Profiler, with the addition of recommendations for each pooled actor type.

  1. Initial Pool Size - Recommends a new initial pool size based on things like the number of active actors and dynamic allocations.

  2. Stop Pooled Actor Destruction - Recommends the user to stop destroying pooled actors in case too many explicit destruction calls are made. Typically destruction calls are reserved for cleanup only.

  3. Adjust Decaying Times - Recommends the user to adjust decaying times in case too many actors end up decaying. 

The commands are as follows:

• SmartPool.Class [CLASS_NAME] - Displays minimal pooling information for the specified actor class from all pools where the actor type is pooled. Changes are reflected every second.

• SmartPool.List [PoolType] - Displays a list of all the actor types pooled by the specified PoolType. The following values can be used:

  1. EMPTY - Shows all pooled actor types across all pools (Global, Local, Component).

  2. g/G - Shows all pooled actor types pooled by the global pool.

  3. l/L - Shows all pooled actor types pooled by the local pool.

  4. c/C - Shows all pooled actor types pooled by all ActorPoolComponents.

• SmartPool.Close - Closes the currently open SmartPool debug visual.

Things to note:

• The "Class" command comes with the following helper visuals:

  1. When no class name is provided, lets users know that they should provide a class name when using the command.

  2. Notifies users when the provided class name has no corresponding actor classes.

  3. Notifies users with a list of all the matching classes if the provided class name matched with more than one class.

• The "List" command works with any string so long as the initial character is g, l or c.