Installation Guide

Step-by-Step Installation Process

1. Organize the Map

This separates the world into "Chunks" that the script can move in and out of memory.

1. Create a Folder in Workspace named MapChunks.

2. Break your map into sections (Folders or Models).

3. Move these sections into the MapChunks folder.

2. Tag the Chunks

This tells the script which folders are part of the map so it doesn't accidentally hide players or UI.

1. Select all your chunk folders inside MapChunks.

2. In the Properties window, click Add Attribute.

3. Set the Name to IsChunk, the Type to boolean, and check the box so it is true.

3. Set Pivot Points

1. Select each chunk.

2. Go to the Model tab and click Edit Pivot.

3. Center the pivot on the chunk so the distance check is accurate.

4. Install Script

Create a LocalScript in StarterPlayerScripts and paste the code below.

local player = game.Players.LocalPlayer
local runService = game:GetService("RunService")
local storage = game.ReplicatedStorage:FindFirstChild("ChunkStorage") or Instance.new("Folder", game.ReplicatedStorage)
storage.Name = "ChunkStorage"

local mapFolder = workspace:WaitForChild("MapChunks")
local LOAD_DISTANCE = 300 
local CHECK_INTERVAL = 0.5
local nextCheck = 0

for _, chunk in ipairs(mapFolder:GetChildren()) do
	if chunk:GetAttribute("IsChunk") then
		chunk.Parent = storage
	end
end

runService.Heartbeat:Connect(function()
	if os.clock() < nextCheck then return end
	nextCheck = os.clock() + CHECK_INTERVAL

	local char = player.Character
	local root = char and char:FindFirstChild("HumanoidRootPart")
	if not root then return end
	local pos = root.Position

	for _, chunk in ipairs(storage:GetChildren()) do
		if (chunk.WorldPivot.Position - pos).Magnitude <= LOAD_DISTANCE then
			chunk.Parent = mapFolder
		end
	end

	for _, chunk in ipairs(mapFolder:GetChildren()) do
		if chunk:GetAttribute("IsChunk") and (chunk.WorldPivot.Position - pos).Magnitude > LOAD_DISTANCE then
			chunk.Parent = storage
		end
	end
end)