Introduction
ObjectCache is a modern implementation on handling thousands of active parts, while keeping performance high.
Why ObjectCache?
The source code is minimal and with no bloat, and has another important difference - it uses Roblox’s BulkMoveTo API to achieve peak performance!
Instead of manually setting the CFrame of each part one-by-one, all parts are batched together into a single movement call. And best of all, you don’t need to worry about any of this! ObjectCache puts all returned objects into a queue to move them away in the same frame as you call the method.
Supports models
By utilizing the engine’s behavior, ObjectCache supports using models directly – and it remains as efficient as ever, much faster than calling :PivotTo! To use a model as the template, you just have to set a PrimaryPart, and weld all parts in the model to the PrimaryPart. ObjectCache will call BulkMoveTo on the PrimaryPart, which will automatically move all the other parts in the model with it, at much faster speeds than normal!
API
The API is dead simple - easy to learn, and eventually forget.
ObjectCache is fully typed, but an API reference is always handy to have:
ObjectCacheConstructor.new(
Template: BasePart | Model,
CacheSize: number?,
CachesContainer: Folder?
) -> ObjectCache
ObjectCache:GetPart(PartCFrame: CFrame?): BasePart
ObjectCache:ReturnPart(Part: BasePart)
Cache:IsInUse(Part: BasePart): boolean
ObjectCache:Update()
Cache:ExpandCache(Amount)
Cache:SetExpandAmount(Amount: number)
ObjectCache:Destroy()
You may have noticed that ObjectCache:GetPart lets you provide an optional target CFrame. This argument lets you squeeze out the maximum performance out of the module! Since :GetPart(TargetCFrame) and :ReturnPart(Object) both use queued workspace:BulkMoveTo calls, it can actually be more performant to call these two methods every frame.
The following video calls :GetPart and :ReturnPart every frame, yet runs smooth as butter:
There is some lag from the recorder - ingame, I can run this smoothly at max FPS.
The place file used in the above video can be found here:
ObjectCache_Demo.rbxl
The demo file uses an outdated version of the module! Do not use the module from there.
Installation
Simply grab the file from Roblox marketplace: https://create.roblox.com/store/asset/18819618773/ObjectCache
Alternatively, Wally users can install the package through wally:
