infoThis version ships no README. Showing the README from v0.1.2, mirrored from wally.

ServerAuthToolkit

Server-authoritative movement toolkit for Roblox games using Input Actions System and client-side prediction.

Register movement modules that define input, default state, and simulation logic. The toolkit handles player lifecycle, runs modules each simulation step, and replicates movement state through root-part attributes.

Installation

Add the package with Wally:

ServerAuthToolkit = "cameronnh/serverauthtoolkit@0.1.2"

Quick start

Require the toolkit on both the server and client, register your modules, then start it:

local ServerAuthToolkit = require(ReplicatedStorage.ServerAuthToolkit)

ServerAuthToolkit:RegisterDefinition({
	Name = "Jump",
	Priority = 1,
	Actions = {
		{
			Name = "Jump",
			Type = Enum.InputActionType.Bool,
			Bindings = {
				Keyboard = {
					KeyCode = Enum.KeyCode.Space,
				},
				Gamepad = {
					KeyCode = Enum.KeyCode.ButtonA,
				},
			},
			ApplyInput = function(state: ServerAuthToolkit.MovementState, inputState: boolean)
				state.IsJumping = inputState
			end,
		},
	},
	NeededStates = {
		IsJumping = false,
		OnGround = false,
	},
	Disable = {
		"JumpAction",
	},
	Process = function(state, deltaTime)
		-- Jump logic
	end,
})

ServerAuthToolkit:Start()

Call Start once per process after registering modules and animations.

Features

• Movement modules with priority-ordered simulation
• Input Actions integration and movement state replication
• Client camera hooks for pre-simulation and post-camera effects
• Built-in animation helpers and flat look-direction utilities