@rbxts/humanoid-stat-manager 1.0.0

package/out/index.d.ts

@@ -0,0 +1,4 @@
+import { Modifier } from './shared';
+export declare namespace HumanoidStatManager {
+    function addModifier(char: Model, modifier: Omit<Modifier, 'id' | 'startTime'>): () => void;
+}

package/out/init.luau

@@ -0,0 +1,168 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local _services = TS.import(script, TS.getModule(script, "@rbxts", "services"))
+local HttpService = _services.HttpService
+local Players = _services.Players
+local RunService = _services.RunService
+local observeCharacters = TS.import(script, TS.getModule(script, "@rbxts", "roblox-observers").out["observe-characters"]).observeCharacters
+local _shared = TS.import(script, script, "shared")
+local _internalCreateModifier = _shared._internalCreateModifier
+local pruneExpiredModifiers = _shared.pruneExpiredModifiers
+local calculateStat = _shared.calculateStat
+local REMOTE_NAME = "ServerToClient"
+local IS_SERVER = RunService:IsServer()
+local serverNpcModifiers = {}
+local clientModifiers = {}
+local clientHumanoid
+local remote
+local clientAddInternal, clientRemoveInternal
+if IS_SERVER then
+	remote = Instance.new("RemoteEvent")
+	remote.Name = REMOTE_NAME
+	remote.Parent = script
+	RunService.Heartbeat:Connect(function()
+		for char, modifiers in serverNpcModifiers do
+			if not char.Parent then
+				serverNpcModifiers[char] = nil
+				continue
+			end
+			pruneExpiredModifiers(modifiers)
+			if #modifiers == 0 then
+				serverNpcModifiers[char] = nil
+			end
+			local humanoid = char:FindFirstChildOfClass("Humanoid")
+			if humanoid then
+				humanoid.WalkSpeed = calculateStat("WalkSpeed", modifiers)
+				humanoid.JumpHeight = calculateStat("JumpHeight", modifiers)
+			end
+		end
+	end)
+else
+	remote = script:WaitForChild(REMOTE_NAME)
+	RunService.Heartbeat:Connect(function()
+		pruneExpiredModifiers(clientModifiers)
+		if not clientHumanoid then
+			return nil
+		end
+		clientHumanoid.WalkSpeed = calculateStat("WalkSpeed", clientModifiers)
+		clientHumanoid.JumpHeight = calculateStat("JumpHeight", clientModifiers)
+	end)
+	remote.OnClientEvent:Connect(function(action, ...)
+		local args = { ... }
+		if action == "Add" then
+			local modifier = args[1]
+			clientAddInternal(modifier)
+		elseif action == "Remove" then
+			local id = args[1]
+			clientRemoveInternal(id)
+		end
+	end)
+	observeCharacters(function(char, player)
+		if player ~= Players.LocalPlayer then
+			return nil
+		end
+		table.clear(clientModifiers)
+		clientHumanoid = char:WaitForChild("Humanoid")
+		return function()
+			clientHumanoid = nil
+		end
+	end)
+end
+function clientAddInternal(modifier)
+	local _modifier = modifier
+	table.insert(clientModifiers, _modifier)
+end
+function clientRemoveInternal(id)
+	-- ▼ ReadonlyArray.findIndex ▼
+	local _callback = function(m)
+		return m.id == id
+	end
+	local _result = -1
+	for _i, _v in clientModifiers do
+		if _callback(_v, _i - 1, clientModifiers) == true then
+			_result = _i - 1
+			break
+		end
+	end
+	-- ▲ ReadonlyArray.findIndex ▲
+	local index = _result
+	if index ~= -1 then
+		table.remove(clientModifiers, index + 1)
+	end
+end
+local addModifierServer, addModifierClient
+local HumanoidStatManager = {}
+do
+	local _container = HumanoidStatManager
+	local function addModifier(char, modifier)
+		if IS_SERVER then
+			return addModifierServer(char, modifier)
+		end
+		return addModifierClient(char, modifier)
+	end
+	_container.addModifier = addModifier
+end
+function addModifierServer(char, modifier)
+	local player = Players:GetPlayerFromCharacter(char)
+	local id = HttpService:GenerateGUID(false)
+	if player then
+		local _remote = remote
+		local _object = table.clone(modifier)
+		setmetatable(_object, nil)
+		_object.id = id
+		_remote:FireClient(player, "Add", _object)
+		return function()
+			remote:FireClient(player, "Remove", id)
+		end
+	else
+		local _char = char
+		local modifiers = serverNpcModifiers[_char]
+		if not modifiers then
+			modifiers = {}
+			local _char_1 = char
+			local _modifiers = modifiers
+			serverNpcModifiers[_char_1] = _modifiers
+		end
+		local _object = table.clone(modifier)
+		setmetatable(_object, nil)
+		_object.id = id
+		local internalMod = _internalCreateModifier(_object)
+		table.insert(modifiers, internalMod)
+		return function()
+			local _char_1 = char
+			local currentMods = serverNpcModifiers[_char_1]
+			if not currentMods then
+				return nil
+			end
+			-- ▼ ReadonlyArray.findIndex ▼
+			local _callback = function(m)
+				return m.id == id
+			end
+			local _result = -1
+			for _i, _v in currentMods do
+				if _callback(_v, _i - 1, currentMods) == true then
+					_result = _i - 1
+					break
+				end
+			end
+			-- ▲ ReadonlyArray.findIndex ▲
+			local index = _result
+			if index ~= -1 then
+				table.remove(currentMods, index + 1)
+			end
+		end
+	end
+end
+function addModifierClient(char, modifier)
+	if char ~= Players.LocalPlayer.Character then
+		error("HumanoidStatManager: Client can only modify the LocalPlayer\'s character.")
+	end
+	local internalMod = _internalCreateModifier(modifier)
+	clientAddInternal(internalMod)
+	return function()
+		clientRemoveInternal(internalMod.id)
+	end
+end
+return {
+	HumanoidStatManager = HumanoidStatManager,
+}

package/out/loaders/client.meta.json

@@ -0,0 +1,5 @@
+{
+    "properties": {
+        "RunContext": "Client" 
+    }
+}

package/out/loaders/client.server.d.ts

@@ -0,0 +1 @@
+export {};

package/out/loaders/client.server.luau

@@ -0,0 +1,10 @@
+-- Compiled with roblox-ts v3.0.0
+local _module = script.Parent
+if _module ~= nil then
+	_module = _module.Parent
+end
+local module = _module
+local _arg0 = module and module:IsA("ModuleScript")
+local _arg1 = `Module not found`
+assert(_arg0, _arg1)
+require(module)

package/out/loaders/server.meta.json

@@ -0,0 +1,5 @@
+{
+    "properties": {
+        "RunContext": "Server" 
+    }
+}

package/out/loaders/server.server.d.ts

@@ -0,0 +1 @@
+export {};

package/out/loaders/server.server.luau

@@ -0,0 +1,10 @@
+-- Compiled with roblox-ts v3.0.0
+local _module = script.Parent
+if _module ~= nil then
+	_module = _module.Parent
+end
+local module = _module
+local _arg0 = module and module:IsA("ModuleScript")
+local _arg1 = `Module not found`
+assert(_arg0, _arg1)
+require(module)

package/out/shared.d.ts

@@ -0,0 +1,16 @@
+export interface Modifier {
+    id?: string;
+    stat: 'WalkSpeed' | 'JumpHeight';
+    type: 'Add' | 'Multiply' | 'Set';
+    value: number;
+    duration?: number;
+    startTime?: number;
+    priority?: number;
+}
+export declare const BASE_STATS: {
+    WalkSpeed: number;
+    JumpHeight: number;
+};
+export declare function calculateStat(stat: Modifier['stat'], modifiers: Modifier[]): number;
+export declare function pruneExpiredModifiers(modifiers: Modifier[]): void;
+export declare function _internalCreateModifier(modifier: Omit<Modifier, 'startTime'>): Modifier;

package/out/shared.luau

@@ -0,0 +1,79 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local _services = TS.import(script, TS.getModule(script, "@rbxts", "services"))
+local HttpService = _services.HttpService
+local StarterPlayer = _services.StarterPlayer
+local BASE_STATS = {
+	WalkSpeed = StarterPlayer.CharacterWalkSpeed,
+	JumpHeight = StarterPlayer.CharacterJumpHeight,
+}
+local function calculateStat(stat, modifiers)
+	local base = BASE_STATS[stat]
+	local setMod
+	for _, modifier in modifiers do
+		if modifier.stat ~= stat then
+			continue
+		end
+		if modifier.type == "Set" then
+			local _condition = not setMod
+			if not _condition then
+				local _condition_1 = modifier.priority
+				if _condition_1 == nil then
+					_condition_1 = 0
+				end
+				local _condition_2 = setMod.priority
+				if _condition_2 == nil then
+					_condition_2 = 0
+				end
+				_condition = _condition_1 > _condition_2
+			end
+			if _condition then
+				setMod = modifier
+			end
+		elseif not setMod then
+			if modifier.type == "Add" then
+				base += modifier.value
+			elseif modifier.type == "Multiply" then
+				base *= modifier.value
+			end
+		end
+	end
+	return if setMod then setMod.value else base
+end
+local function pruneExpiredModifiers(modifiers)
+	local now = tick()
+	for i = #modifiers - 1, 0, -1 do
+		local modifier = modifiers[i + 1]
+		local _condition = modifier.duration ~= nil
+		if _condition then
+			local _condition_1 = modifier.startTime
+			if _condition_1 == nil then
+				_condition_1 = 0
+			end
+			_condition = now - _condition_1 >= modifier.duration
+		end
+		if _condition then
+			local _modifiers = modifiers
+			local _i = i
+			table.remove(_modifiers, _i + 1)
+		end
+	end
+end
+local function _internalCreateModifier(modifier)
+	local _object = table.clone(modifier)
+	setmetatable(_object, nil)
+	local _left = "id"
+	local _condition = modifier.id
+	if _condition == nil then
+		_condition = HttpService:GenerateGUID(false)
+	end
+	_object[_left] = _condition
+	_object.startTime = tick()
+	return _object
+end
+return {
+	calculateStat = calculateStat,
+	pruneExpiredModifiers = pruneExpiredModifiers,
+	_internalCreateModifier = _internalCreateModifier,
+	BASE_STATS = BASE_STATS,
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@rbxts/humanoid-stat-manager",
+  "version": "1.0.0",
+  "description": "",
+  "main": "out/init.lua",
+  "scripts": {
+    "build": "rbxtsc",
+    "watch": "rbxtsc -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "types": "out/index.d.ts",
+  "files": [
+    "out",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@rbxts/compiler-types": "^3.0.0-types.0",
+    "@rbxts/types": "^1.0.896",
+    "roblox-ts": "^3.0.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@rbxts/roblox-observers": "^1.0.8",
+    "@rbxts/services": "^1.6.0"
+  }
+}