cluaupp 1.3.0 → 1.4.0

package/templates/game/include/clpp/libs/module3d.clh

@@ -1,23 +0,0 @@
-#pragma once
-
-// TheNexusAvenger/Module3D — ViewportFrame adorn, vendored into CluauppLibs.Module3D
-struct Model3D {
-	Model Object3D;
-	GuiObject AdornFrame;
-	Camera Camera;
-	bool Visible;
-	void Update();
-	void SetCFrame(CFrame newCF);
-	CFrame GetCFrame();
-	void SetDepthMultiplier(double multiplier);
-	double GetDepthMultiplier();
-	void SetActive(bool active);
-	bool GetActive();
-	void Destroy();
-	void End();
-};
-
-struct Module3D {
-	static Model3D new_(Instance model);
-	static Model3D Attach3D(GuiObject frame, Instance model);
-};

package/templates/game/include/clpp/libs/spring.clh

@@ -1,17 +0,0 @@
-#pragma once
-
-// nightcycle/spring — Fraktality-style damped spring, vendored into CluauppLibs.Spring
-struct Spring {
-	double Damping;
-	double Frequency;
-	double Goal;
-	double Position;
-	double Velocity;
-	Spring(double dampingRatio, double frequency, double position);
-	void Set(double goal);
-	double Get();
-	void Step(double dt);
-	void Impulse(double velocity);
-	void SetGoal(double target);
-	double Update(double dt);
-};

package/templates/game/include/clpp/libs/statemachine.clh

@@ -1,18 +0,0 @@
-#pragma once
-
-// Prooheckcp/RobloxStateMachine — vendored into CluauppLibs.StateMachine
-struct StateData {};
-
-struct StateMachine {
-	static StateMachine new_(string initial);
-	static StateData LoadDirectory(Instance directory);
-	void ChangeState(string name);
-	string GetState();
-	string GetCurrentState();
-	string GetPreviousState();
-	StateData GetData();
-	void ChangeData(string index, string value);
-	void ChangeData(string index, double value);
-	void ChangeData(string index, bool value);
-	void Destroy();
-};

package/templates/game/include/clpp/libs/stickybillboard.clh

@@ -1,13 +0,0 @@
-#pragma once
-
-// Cluaupp StickyBillboard — BillboardGui that stays on an adornee.
-struct StickyBillboard {
-	static StickyBillboard new_(Instance adornee, GuiObject gui);
-	void SetText(string text);
-	void SetEnabled(bool enabled);
-	void SetMaxDistance(double distance);
-	void Destroy();
-	Instance Adornee;
-	GuiObject Gui;
-	BillboardGui Billboard;
-};

package/templates/game/include/clpp/libs/topbarplus.clh

@@ -1,28 +0,0 @@
-#pragma once
-
-// 1ForeverHD/TopbarPlus — vendored into CluauppLibs.TopbarPlus (struct Icon)
-struct IconTheme {};
-
-struct Icon {
-	static Icon new_();
-	Icon setName(string name);
-	Icon setLabel(string text);
-	Icon setImage(string image);
-	Icon setEnabled(bool enabled);
-	Icon setOrder(int order);
-	Icon setWidth(int offset);
-	Icon align(string leftCenterOrRight);
-	Icon setLeft();
-	Icon setMid();
-	Icon setRight();
-	Icon bindEvent(string eventName, void (*callback)());
-	Icon bindToggleItem(GuiObject gui);
-	Icon modifyTheme(IconTheme modifications);
-	Icon setTheme(IconTheme theme);
-	Icon notify();
-	Icon clearNotices();
-	Icon select();
-	Icon deselect();
-	Icon autoDeselect(bool enabled);
-	void Destroy();
-};

package/templates/game/include/clpp/libs/twinkle.clh

@@ -1,15 +0,0 @@
-#pragma once
-
-// UI animator. https://devforum.roblox.com/t/twinkle-free-powerful-ui-animator-module/4512304
-namespace Twinkle {
-	void Fade(GuiObject element, bool show);
-	void Fade(GuiObject element, bool show, double speed);
-	void FrameSlide(GuiObject element, bool show);
-	void FrameSlide(GuiObject element, bool show, double speed);
-	void FrameZoom(GuiObject element, bool show);
-	void FrameZoom(GuiObject element, bool show, double speed);
-	void FrameBounce(GuiObject element);
-	void FrameBounce(GuiObject element, double speed);
-	void SetButtonStyle(GuiObject element);
-	void SetButtonStyle(GuiObject element, string hoverType, string pressType, double scalePercent);
-}

package/templates/game/include/clpp/libs/vfx.clh

@@ -1,13 +0,0 @@
-#pragma once
-
-// Cluaupp VfxUtil — emit / play / stop / clone ParticleEmitters, Beams, Trails, Sounds.
-namespace VfxUtil {
-	void Emit(Instance root);
-	void Emit(Instance root, int count);
-	void Play(Instance effect);
-	void Stop(Instance effect);
-	Instance CloneOnto(Instance template_, Instance parent);
-	void Scale(Instance root, double factor);
-	void DestroyAfter(Instance root, double lifetime);
-	Instance Burst(Instance template_, Instance parent);
-}

package/templates/game/libs/ArrayIndexer/init.luau

@@ -1,144 +0,0 @@
---!strict
---[=[
-	@class ArrayIndexer
-	Type function `Table` — pick one or more keys from a service manifest.
-	`Table<Manifest, "CurrencyService">` is the service, not a generic table.
-]=]
-type ManifestExample = {
-	CurrencyService: { AddCash: () -> (), SubtractCash: () -> () },
-	DataService: { FetchData: () -> (), ClearData: () -> () },
-	PlayerService: { RespawnChar: () -> (), RemoveChar: () -> () },
-}
-export type function Table(list: type, id: type): type
-	if not list:is("table") then
-		error(`[Manifest] list deve ser a manifest table, recebi {list.tag}`)
-	end
-
-	if id:is("any") or id:is("unknown") or id:is("never") then
-		return types.any
-	end
-
-	-- quantas opcoes um tipo descreve (para desempatar intersection)
-	local function largura(t: type): number?
-		local alvo = t
-		if alvo:is("table") then
-			local ix = alvo:readindexer()
-			if not ix then
-				return nil
-			end
-			alvo = ix.result
-		end
-		if alvo:is("singleton") then
-			return 1
-		end
-		if alvo:is("union") then
-			local n = 0
-			for _ in alvo:components() do
-				n += 1
-			end
-			return n
-		end
-		return nil
-	end
-
-	-- 1. INTERSECTION: fica o ramo mais estreito, sem depender de ordem
-	if id:is("intersection") then
-		local melhor, menor = nil, math.huge
-		for _, parte in id:components() do
-			local w = largura(parte)
-			if w and w < menor then
-				menor, melhor = w, parte
-			end
-		end
-		if not melhor then
-			error("[Manifest] intersection sem ramo utilizavel (nenhum singleton, union ou array deles)")
-		end
-		id = melhor
-	end
-
-	-- 2. ARRAY: desce no indexer
-	local fromArray = false
-	if id:is("table") then
-		local indexer = id:readindexer()
-		if not indexer then
-			error("[Manifest] esperava array de chaves, recebi table sem indexer")
-		end
-		fromArray = true
-		id = indexer.result
-	end
-
-	if id:is("string") then
-		error(
-			'[Manifest] WIDENED: as chaves viraram `string`. Use `:: { "A" | "B" }` no literal, ou passe a union direto'
-		)
-	end
-
-	-- 3. CHAVE UNICA e nao veio de array: devolve o servico direto
-	if id:is("singleton") and not fromArray then
-		local alvo = id:value()
-		local prop = list:readproperty(id)
-		if prop then
-			return prop
-		end
-		local disponiveis = {}
-		for key in list:properties() do
-			table.insert(disponiveis, tostring(key:value()))
-		end
-		table.sort(disponiveis)
-		error(`[Manifest] "{alvo}" nao existe. Disponiveis: {table.concat(disponiveis, ", ")}`)
-	end
-
-	-- 4. coleta os pedidos
-	local pedidos = {}
-	if id:is("singleton") then
-		pedidos[id:value()] = true
-	elseif id:is("union") then
-		for _, c in id:components() do
-			if not c:is("singleton") then
-				error(`[Manifest] componentes da union devem ser singleton, recebi {c.tag}`)
-			end
-			pedidos[c:value()] = true
-		end
-	else
-		error(`[Manifest] id deve ser singleton, union de singletons, ou array deles. Recebi {id.tag}`)
-	end
-
-	-- 5. monta o subconjunto
-	local resultado = types.newtable()
-	for key, prop in list:properties() do
-		local nome = key:value()
-		if type(nome) == "string" and pedidos[nome] then
-			pedidos[nome] = nil
-			if prop.read then
-				resultado:setreadproperty(key, prop.read)
-			end
-			if prop.write then
-				resultado:setwriteproperty(key, prop.write)
-			end
-		end
-	end
-
-	-- 6. o que sobrou foi pedido e nao existe
-	local faltando = {}
-	for nome in pedidos do
-		table.insert(faltando, nome)
-	end
-	if #faltando > 0 then
-		table.sort(faltando)
-		local disponiveis = {}
-		for key in list:properties() do
-			table.insert(disponiveis, tostring(key:value()))
-		end
-		table.sort(disponiveis)
-		error(
-			`[Manifest] nao existe(m): {table.concat(faltando, ", ")}. Disponiveis: {table.concat(disponiveis, ", ")}`
-		)
-	end
-
-	return resultado
-end
-
-type CurrencyService = Table<ManifestExample, "CurrencyService"> --> AddCash: () -> (), SubtractCash: () -> ()
-type TwoServices = Table<ManifestExample, "PlayerService" | "DataService"> --> {RespawnChar: () -> (), RemoveChar: () -> ()}, {FetchData: () -> (), ClearData: () -> ()}
-
-return {}

package/templates/game/libs/Chrono/Client/ClientClock.luau

@@ -1,202 +0,0 @@
-const RunService = game:GetService("RunService")
-
-const Warn = require(script.Parent.Parent.Shared.Warn)
-const Config = require(script.Parent.Parent.Shared.Config)
-const Types = require(script.Parent.Parent.Shared.Types)
-const BufferTracker = require(script.Parent.InterpolationBuffer)
-
-const ClientClocks = {}
-const _ServerOwnedClocks = {}
-
-const function GetBuffer(clientClock: Types.ClientClock): number
-	if clientClock.buffer then
-		return BufferTracker.GetBuffer(clientClock.buffer, clientClock.tickRate)
-	else
-		return clientClock.bufferConst or 0
-	end
-end
-
-const function Clear(clientClock: Types.ClientClock)
-	clientClock.lastClockAt = nil
-	clientClock.lastClockDuration = 0
-	clientClock.renderAt = nil
-
-	if clientClock.buffer then
-		clientClock.buffer.init = false
-	end
-end
-
-const function GetTargetRenderTime(clientClock: Types.ClientClock): number
-	if not clientClock.renderAt then
-		Warn.low("ClientClock: Render time not yet established for", clientClock.name)
-		return 0
-	end
-
-	return clientClock.renderAt
-end
-
-const function GetEstimatedServerTime(clientClock: Types.ClientClock): number
-	if not clientClock.lastClockAt then
-		Warn.low("ClientClock: Estimated server time not yet established for", clientClock.name)
-		return 0
-	end
-
-	return clientClock.lastClockAt + (os.clock() - clientClock.lastClockDuration)
-end
-
-const function CheckHasLastClockAt(clientClock: Types.ClientClock, sendTime: number)
-	if not clientClock.lastClockAt then
-		clientClock.lastClockAt = sendTime
-		clientClock.lastClockDuration = os.clock()
-		clientClock.renderAt = nil
-	end
-end
-
-const function Refresh(clientClock: Types.ClientClock, currentSendTime: number): boolean
-	if not clientClock.lastClockAt then
-		CheckHasLastClockAt(clientClock, currentSendTime)
-		return false
-	end
-
-	if currentSendTime > clientClock.lastClockAt then
-		clientClock.lastClockAt = currentSendTime
-		clientClock.lastClockDuration = os.clock()
-		return true
-	end
-
-	return false
-end
-
-const function OnSnapShot(clientClock: Types.ClientClock, currentSendTime: number)
-	if not clientClock.lastClockAt then
-		CheckHasLastClockAt(clientClock, currentSendTime)
-		return
-	end
-
-	if clientClock.buffer then
-		BufferTracker.Register(clientClock.buffer, currentSendTime)
-	end
-
-	if Refresh(clientClock, currentSendTime) and not clientClock.renderAt then
-		clientClock.renderAt = currentSendTime - GetBuffer(clientClock)
-	end
-end
-
-const function SetTickRate(clientClock: Types.ClientClock, tickRate: number)
-	if clientClock.tickRate == tickRate then
-		return
-	end
-	clientClock.tickRate = tickRate
-	--//Do something here maybe?
-end
-
-const function Destroy(clientClock: Types.ClientClock)
-	ClientClocks[clientClock] = nil
-	if _ServerOwnedClocks[clientClock] then
-		_ServerOwnedClocks[clientClock] = nil
-	end
-end
-
-const function Update(clientClock: Types.ClientClock, dt: number)
-	const now = os.clock()
-	const delay = GetBuffer(clientClock)
-	if not clientClock.lastClockAt then
-		return
-	end
-	const estimatedServerTime = clientClock.lastClockAt + (now - clientClock.lastClockDuration)
-	local renderAt = (clientClock.renderAt or (estimatedServerTime - delay)) + dt
-
-	const renderTimeError = delay - (estimatedServerTime - renderAt)
-
-	if math.abs(renderTimeError) > 0.1 then
-		renderAt = estimatedServerTime - delay
-	elseif renderTimeError > 0.01 then
-		renderAt = math.max(estimatedServerTime - delay, renderAt - 0.1 * dt)
-	elseif renderTimeError < -0.01 then
-		renderAt = math.min(estimatedServerTime - delay, renderAt + 0.1 * dt)
-	end
-
-	clientClock.renderAt = renderAt
-end
-
-const function UpdateBuffer(clientClock: Types.ClientClock, buffer: number?)
-	buffer = if buffer and buffer <= 0 then nil else buffer
-	const currentBuffer = clientClock.bufferConst
-	if currentBuffer == buffer then
-		return
-	end
-	if not buffer then
-		if not clientClock.buffer then
-			clientClock.buffer = BufferTracker.new(clientClock)
-		end
-	else
-		clientClock.buffer = nil
-	end
-	clientClock.bufferConst = buffer
-	clientClock.renderAt = nil
-end
-
-const function new(tickRate: number, name: string, bufferNumber: number?, networkOwner: Player?): Types.ClientClock
-	bufferNumber = if bufferNumber and bufferNumber <= 0 then nil else bufferNumber
-	const self: Types.ClientClock = {
-		name = name,
-		lastClockAt = nil,
-		lastClockDuration = 0,
-		renderAt = nil,
-		tickRate = tickRate,
-		_baseTickRate = tickRate,
-		_owner = networkOwner,
-		buffer = nil,
-		bufferConst = bufferNumber,
-
-		OnSnapShot = OnSnapShot,
-		Refresh = Refresh,
-		GetEstimatedServerTime = GetEstimatedServerTime,
-		GetTargetRenderTime = GetTargetRenderTime,
-		Clear = Clear,
-		SetTickRate = SetTickRate,
-		UpdateBuffer = UpdateBuffer,
-		Destroy = Destroy,
-	}
-	if not bufferNumber then
-		self.buffer = BufferTracker.new(self)
-	end
-
-	if not networkOwner then
-		_ServerOwnedClocks[self] = true
-	end
-
-	ClientClocks[self] = true
-	return self
-end
-
-const function UpdateAll(dt: number)
-	for clientClock, _ in ClientClocks do
-		Update(clientClock, dt)
-	end
-end
-
-Config._WaitForLock(function()
-	if RunService:IsServer() then
-		return
-	end
-	for name, config in Config._EntityConfigs do
-		const clientClocks = config.CLIENT_CLOCK
-		if not clientClocks then
-			Warn.high("Entity Config", name, "is missing client clocks")
-			return
-		end
-		clientClocks.NORMAL = new(config.TICK_RATE, name .. "_NORMAL", config.BUFFER)
-		if config.HALF_TICK_DISTANCE < math.huge then
-			clientClocks.HALF = new(config.TICK_RATE * 2, name .. "_HALF", config.BUFFER)
-		end
-	end
-end)
-
-return {
-	_getBuffer = GetBuffer,
-	new = new,
-	clientClocks = ClientClocks,
-	serverOwnedClocks = _ServerOwnedClocks,
-	UpdateAll = UpdateAll,
-}

package/templates/game/libs/Chrono/Client/InterpolationBuffer.luau

@@ -1,74 +0,0 @@
-const Warn = require(script.Parent.Parent.Shared.Warn)
-const Config = require(script.Parent.Parent.Shared.Config)
-const Types = require(script.Parent.Parent.Shared.Types)
-
-local MIN_BUFFER
-local MAX_BUFFER
-const ALPHA = 0.1
-
-Config._WaitForLock(function()
-	MIN_BUFFER = Config._GetConfig("MIN_BUFFER")
-	MAX_BUFFER = Config._GetConfig("MAX_BUFFER")
-end)
-const Buffer = {}
-
-function Buffer.new(clientClock: Types.ClientClock)
-	return {
-		init = false,
-		averageLatency = 0,
-		deviation = 0,
-		lastLatency = 0,
-
-		clientClock = clientClock,
-	}
-end
-
-function Buffer.Register(data: Types.InterpolationBuffer, time: number)
-	const clientClock = data.clientClock
-	const clientNow = clientClock:GetEstimatedServerTime()
-	const latency = clientNow - time
-
-	if math.abs(latency) > 1 then
-		clientClock:Clear()
-		Warn.low(data.clientClock.name, ` latency too high, cleared cache to repredict in case of error:! {latency}`)
-	end
-
-	if not data.init then
-		--using the difference between current and last latency, i could smooth out the deviation (the variation in latency, which correlates to packet loss)
-		--this is using statistics https://en.wikipedia.org/wiki/Moving_average
-		data.averageLatency = latency
-		data.deviation = 0
-		data.lastLatency = latency
-		data.init = true
-		return
-	end
-
-	if data.lastLatency then
-		const delta = math.abs(latency - data.lastLatency)
-		--deviation is essentially jitter, and we calculate that using RFC 3550 jitter estimation
-		--see: https://tech.ebu.ch/docs/tech/tech3337.pdf
-		data.deviation = data.deviation + (delta - data.deviation) * ALPHA
-	end
-
-	data.averageLatency = data.averageLatency + (latency - data.averageLatency) * ALPHA
-	data.lastLatency = latency
-end
-
-function Buffer.GetBuffer(data: Types.InterpolationBuffer, tickRate: number)
-	if not data then
-		return MIN_BUFFER
-	end
-
-	const deviationMargin = data.deviation * 2
-	const rawBuffer = tickRate + deviationMargin
-
-	local buffer = if rawBuffer < MIN_BUFFER then MIN_BUFFER + (MIN_BUFFER - rawBuffer) * 0.2 else rawBuffer
-	if buffer > MAX_BUFFER then
-		Warn.low(`Interpolation buffer exceeded max! Was {buffer}, clamped to {MAX_BUFFER} for`, data.clientClock.name)
-		buffer = MAX_BUFFER
-	end
-
-	return buffer
-end
-
-return Buffer

package/templates/game/libs/Chrono/Client/ModelResolver.luau

@@ -1,53 +0,0 @@
-const CollectionService = game:GetService("CollectionService")
-
-const Warn = require(script.Parent.Parent.Shared.Warn)
-const Config = require(script.Parent.Parent.Shared.Config)
-const Types = require(script.Parent.Parent.Shared.Types)
-const Entity = require(script.Parent.Parent.Shared.Entity)
-const ModelHelper = require(script.Parent.Parent.Shared.ModelHelper)
-const TAG = ModelHelper.TAG
-const CHRONO_META_NAME = ModelHelper.CHRONO_META_NAME
-
-const RegisteredModels = {}
-
-const function OnInstanceAdded(instance: Instance)
-	const metaStringValue: string? = instance:GetAttribute(CHRONO_META_NAME) :: any
-	if metaStringValue then
-		RegisteredModels[metaStringValue] = instance.Parent :: any
-		Warn.low(
-			`Model with meta {metaStringValue} was added to the game. Entities using this model will now be able to resolve it.`
-		)
-	end
-end
-
-CollectionService:GetInstanceAddedSignal(TAG):Connect(OnInstanceAdded)
-CollectionService:GetInstanceRemovedSignal(TAG):Connect(function(instance)
-	const attribute: string? = instance:GetAttribute(CHRONO_META_NAME) :: any
-	if attribute then
-		RegisteredModels[attribute] = nil
-		Warn.low(
-			`Model with meta {attribute} was removed from the game. Entities using this model will no longer be able to resolve it.`
-		)
-	end
-end)
-for _, instance in CollectionService:GetTagged(TAG) do
-	OnInstanceAdded(instance)
-end
-
-return function(entity: Types.Entity)
-	const model = entity.model
-
-	if model and model.Parent then
-		return
-	end
-
-	const metaData = entity._modelMetaData
-	if not metaData then
-		return
-	end
-	const registered = RegisteredModels[metaData] :: Model | BasePart?
-	if registered and registered ~= model then
-		Entity.SetModel(entity, registered)
-		Warn.low(`Model with meta {metaData} was resolved for entity {entity.id}.`)
-	end
-end