FyyMountTools

Roblox Luau mount utility toolkit with a WindUI-powered script hub, license-gated feature tabs, auto-walk route playback, and a standalone path recorder for creating JSON movement tracks.

This folder contains two Roblox Luau scripts used around mount-route workflows:

• FyyMountHub.lua - the main Fyy mount hub with authentication, UI tabs, player tools, auto-walk playback, teleport tools, animations, and utility features.
• FyyRouteRecorder.lua - a standalone recorder/player utility for capturing movement paths into JSON and replaying those tracks.

The project is best described as a Roblox mount route toolkit: one script consumes route JSON files through a polished hub, while the other helps create those JSON tracks.

---

Table of contents

1. Project overview
2. Script layout
3. Core architecture
4. FyyMountHub.lua
5. FyyRouteRecorder.lua
6. Route data model
7. External services and dependencies
8. Runtime requirements
9. Important notes

---

Project overview

At a high level, this project does four things:

1. Provides a mount-focused script hub

   • WindUI window and tab-based feature layout
   • license/authentication gate before premium tabs are created
   • mobile-friendly floating icon and keyboard toggle support

2. Loads and replays route JSON tracks

   • downloads route files from remote raw GitHub URLs
   • interpolates recorded positions, velocity, rotation, movement direction, and jump states
   • supports loop, reverse, flip, playback speed, and auto-respawn behavior

3. Records movement paths

   • captures player movement at 60 FPS
   • stores position, velocity, movement direction, rotation, walk speed, hip height, state, and equipped tool
   • saves route data as local JSON files

4. Adds supporting player utilities

   • movement helpers
   • teleport helpers
   • visual/name tools
   • animation presets
   • anti-lag/full-bright/anti-AFK utilities

---

Script layout

.
├─ FyyMountHub.lua        # main WindUI mount hub and route playback menu
├─ FyyRouteRecorder.lua   # standalone path recorder and JSON route utility
└─ README.md

The scripts are intentionally standalone. There is no package manager, build step, or compiled artifact.

---

Core architecture

The workflow is centered around recorded JSON route frames:

FyyRouteRecorder.lua
  -> captures player movement frames
  -> saves route as <name>.json
  -> optionally posts route data to a local web app

Route JSON file
  -> position / velocity / movement state per frame
  -> hosted locally or remotely

FyyMountHub.lua
  -> downloads selected route JSON
  -> finds nearest route point
  -> interpolates frame playback
  -> moves the local character along the route

Both scripts share the same basic playback model: decode a JSON array, locate timeline frames around the current playback time, interpolate position/rotation/velocity, then apply those values to the Roblox character.

---

FyyMountHub.lua

FyyMountHub.lua is the main hub script.

It currently owns or coordinates:

• WindUI bootstrap and AMOLED theme setup
• draggable mobile floating button
• local config save/load helpers
• license-key validation and saved-token auto-login
• Discord invite info panel
• tab creation after successful authentication
• player movement and visual utility features
• auto-summit and auto-walk systems
• teleport tools
• animation preset/custom animation tools
• general tools and danger-zone actions

Main tabs

Authentication
Player Menu
Auto Summit
Auto Walk
Animation
Teleport
Tools
Danger Zone

Authentication flow

The hub validates keys against a remote API before unlocking the main feature tabs.

License input
  -> ValidateKey()
    -> GET /check?key=...&hwid=...&robloxId=...&placeId=...&username=...
    -> save token locally on success
    -> create feature tabs

Saved tokens are stored under:

FyyVerifyyy/auth/token.dat

The script accepts key prefixes such as:

FYY-...
TRIAL-...

Auto Walk system

The Auto Walk tab contains route playback controls:

• track dropdown with searchable route names
• route URL mapping for remote JSON tracks
• selected track cache
• nearest-point detection before playback
• loop toggle
• auto-respawn toggle
• playback speed slider
• draggable mini control GUI with:
  • PLAY
  • REV
  • FLIP

The playback engine handles:

• frame interpolation
• jump/freefall state replay
• velocity correction
• hip-height offset correction
• tool equip/unequip replay
• reverse playback
• flip rotation mode

---

FyyRouteRecorder.lua

FyyRouteRecorder.lua is the standalone path recorder and route playback utility.

It currently provides:

• custom Roblox ScreenGui recorder panel
• record / pause / stop controls
• hotkeys for recording workflow
• 60 FPS movement capture
• safe rewind to the last running frame
• quick step-back trimming
• JSON save to local files
• optional POST to a local web app
• route playback helpers exported from the returned module table
• anti-lag toggle for smoother recording sessions

Recorder controls

R       Start recording
P       Pause / resume recording
L       Stop recording
,       Rewind to safe point
.       Step back several frames
G       Minimize / restore GUI
X       Close recorder GUI

Saved output

Recordings are saved with:

<fileName>.json

If no file name is entered, the default output is:

recording.json

Local web app integration

The recorder can send saved route data to a local endpoint:

<local-web-app-endpoint>

Payload includes:

• fileName
• frameCount
• duration
• durationStr
• player
• game
• receivedAt
• jsonData

This is useful when pairing the recorder with a local route-management or upload tool.

---

Route data model

Route files are JSON arrays of movement frames.

Example shape:

[
  {
    "time": 0,
    "position": {
      "x": -40.03893280029297,
      "y": 9.005918502807617,
      "z": 2.5321121215820312
    },
    "velocity": {
      "x": -19.240800857543945,
      "y": 0.00007808336522430182,
      "z": 1.1801910400390625
    },
    "moveDirection": {
      "x": -0.9981241226196289,
      "y": 0,
      "z": 0.061222873628139496
    },
    "rotation": 1.6229817867279053,
    "walkSpeed": 16,
    "hipHeight": 4.955921173095703,
    "jumping": false,
    "state": "Running",
    "tool": null
  }
]

Common fields:

• time - playback timestamp
• position - recorded world-space position
• velocity - recorded assembly velocity
• moveDirection - humanoid movement direction
• rotation - yaw rotation captured from the root part
• walkSpeed - humanoid walk speed at the frame
• hipHeight - humanoid hip-height for height correction
• jumping - jump marker
• state - movement state such as Running, Jumping, Freefall, or Climbing
• tool - equipped tool name, if one was held during capture

---

External services and dependencies

WindUI

FyyMountHub.lua loads a WindUI-style library at runtime:

loadstring(game:HttpGet("<private-ui-library-url>"))()

WindUI provides the hub UI surface: windows, tabs, controls, themes, notifications, and config-style state handling. The exact remote file should be treated as a runtime dependency because the loaded URL controls which UI implementation is used.

Remote license API

The hub validates access through a private backend endpoint. The exact domain is intentionally omitted from this README for privacy.

The request includes the submitted key, client ID/HWID, Roblox user ID, place ID, and username.

Route JSON hosting

Auto Walk route data is loaded from raw GitHub URLs. The hub currently references route files under private route repositories.

If the GitHub username or route repository changes, these URLs should be updated.

Optional external scripts

The hub also contains buttons/toggles that load external helper scripts, including:

• Fly GUI from an external helper source
• Vexro Emotes from an external helper source

---

Runtime requirements

These scripts are designed for Roblox Luau environments that expose common executor-style APIs:

• loadstring
• game:HttpGet
• writefile
• readfile
• isfile
• isfolder
• makefolder
• delfile
• listfiles
• setclipboard or equivalent clipboard helper
• request, http.request, http_request, or syn.request for local web-app POST support

Roblox services used include:

• Players
• RunService
• HttpService
• UserInputService
• TweenService
• TeleportService
• ContextActionService
• RbxAnalyticsService
• VirtualUser
• Lighting
• Workspace

---

Important notes

Route URL maintenance

Several route URLs still point to older GitHub paths. If the route archive has moved to a newer repository or renamed account, update the Auto Walk trackURLs table so route loading stays reliable.

Local files

The hub and recorder create local files/folders for saved config, tokens, and JSON output. These are runtime artifacts and should not be committed unless intentionally archived.

Safety and scope

This repository documents the scripts as a mount-route toolkit. Some tabs include powerful player/world manipulation utilities. Use responsibly, respect game rules, and keep dangerous or experimental actions clearly separated from normal route recording/playback workflows.