gtac-types 0.0.1

package/lib/build.js

@@ -0,0 +1,186 @@
+"use strict";
+
+const {
+	readFileSync,
+	writeFileSync,
+	existsSync,
+	mkdirSync,
+	readdirSync,
+} = require("fs");
+const { join, dirname } = require("path");
+const { execSync } = require("child_process");
+
+let _esbuild;
+function getEsbuild() {
+	if (!_esbuild) {
+		try {
+			_esbuild = require("esbuild");
+		} catch (_) {
+			try {
+				_esbuild = require(
+					join(
+						dirname(
+							require.resolve("gtac-types/package.json", {
+								paths: [process.cwd()],
+							})
+						),
+						"node_modules",
+						"esbuild"
+					)
+				);
+			} catch (_e) {
+				console.error(
+					"esbuild not found. Run: npm install esbuild --save-dev"
+				);
+				process.exit(1);
+			}
+		}
+	}
+	return _esbuild;
+}
+
+function scanDir(root, order) {
+	const out = [];
+	try {
+		const entries = readdirSync(root, { withFileTypes: true });
+		const tsFiles = entries
+			.filter((e) => e.isFile() && e.name.endsWith(".ts"))
+			.map((e) => e.name.replace(/\.ts$/, ""));
+		for (const name of order) {
+			if (tsFiles.includes(name)) out.push(name);
+		}
+		for (const name of tsFiles.sort()) {
+			if (!order.includes(name)) out.push(name);
+		}
+	} catch (_) {}
+	return out;
+}
+
+function buildFileList(patterns, dirOrder, baseDir) {
+	const result = [];
+	for (const dir of patterns) {
+		for (const name of scanDir(join(baseDir, dir), dirOrder[dir] || [])) {
+			result.push(dir + "/" + name + ".ts");
+		}
+	}
+	return result;
+}
+
+function resolveSourcePath(metaSrc, baseDir) {
+	const tsPath = join(baseDir, metaSrc);
+	const jsPath = join(baseDir, metaSrc.replace(/\.ts$/, ".js"));
+	if (existsSync(tsPath)) return tsPath;
+	if (existsSync(jsPath)) return jsPath;
+	return null;
+}
+
+function typecheck(baseDir) {
+	const tsconfig = join(baseDir, "tsconfig.json");
+	if (!existsSync(tsconfig)) return true;
+	try {
+		const esbuild = getEsbuild();
+		execSync("npx tsc --noEmit", { cwd: baseDir, stdio: "pipe" });
+		return true;
+	} catch (err) {
+		return false;
+	}
+}
+
+function buildBundle(scripts, outFile, baseDir, injectPrologue) {
+	const esbuild = getEsbuild();
+	const parts = [];
+	for (const scriptSrc of scripts) {
+		const sourcePath = resolveSourcePath(scriptSrc, baseDir);
+		if (!sourcePath) {
+			console.warn("[warn] Source not found:", scriptSrc);
+			continue;
+		}
+		const source = readFileSync(sourcePath, "utf-8");
+		const result = esbuild.transformSync(source, {
+			loader: "ts",
+			target: "es2015",
+			minify: true,
+		});
+		parts.push(result.code);
+	}
+
+	let code = parts.join("\n");
+
+	if (injectPrologue) {
+		const prologue = [
+			'function safeAddNetworkHandler(n,h){addNetworkHandler(n,function(){try{return h.apply(this,arguments)}catch(e){var m="[@CLIENTERROR] "+n+": "+(e.message||String(e));console.log(m);console.log("Stack: "+(e.stack||"no stack"));try{triggerNetworkEvent("clientError",m+" | stack: "+(e.stack||"no stack"))}catch(_){}}})}',
+			'function safeAddEventHandler(n,h){addEventHandler(n,function(){try{return h.apply(this,arguments)}catch(e){var m="[@CLIENTERROR] "+n+": "+(e.message||String(e));console.log(m);console.log("Stack: "+(e.stack||"no stack"));try{triggerNetworkEvent("clientError",m+" | stack: "+(e.stack||"no stack"))}catch(_){}}})}',
+			'function safeAddCommandHandler(n,h){addCommandHandler(n,function(){try{return h.apply(this,arguments)}catch(e){var m="[@CLIENTERROR] "+n+": "+(e.message||String(e));console.log(m);console.log("Stack: "+(e.stack||"no stack"));try{triggerNetworkEvent("clientError",m+" | stack: "+(e.stack||"no stack"))}catch(_){}}})}',
+			'function _log(){var m=Array.prototype.join.call(arguments," ");try{triggerNetworkEvent("clientLog",m)}catch(_){}}try{var _cl=console.log;console.log=function(){_cl.apply(console,arguments);_log.apply(this,arguments)}}catch(_){}',
+		].join("");
+
+		code = code
+			.split("addNetworkHandler(")
+			.join("safeAddNetworkHandler(")
+			.split("addEventHandler(")
+			.join("safeAddEventHandler(")
+			.split("addCommandHandler(")
+			.join("safeAddCommandHandler(");
+
+		code = prologue + code;
+	}
+
+	mkdirSync(dirname(outFile), { recursive: true });
+	writeFileSync(outFile, code, "utf-8");
+}
+
+function buildBundles(scripts) {
+	if (!Array.isArray(scripts)) {
+		console.error("Config must have a 'scripts' array.");
+		process.exit(1);
+	}
+	for (const entry of scripts) {
+		const baseDir = entry.base || process.cwd();
+		const files = buildFileList(
+			entry.patterns,
+			entry.order || {},
+			baseDir
+		);
+		const outFile = join(process.cwd(), entry.outFile || "server.js");
+		buildBundle(
+			files,
+			outFile,
+			baseDir,
+			entry.injectPrologue || false
+		);
+		console.log("[build] Created", outFile, "(" + files.length + " files)");
+	}
+}
+
+function buildFromConfig(config) {
+	if (config.server) {
+		const baseDir = config.server.base || process.cwd();
+		const files = buildFileList(
+			config.server.patterns,
+			config.server.order || {},
+			baseDir
+		);
+		buildBundle(
+			files,
+			join(process.cwd(), config.server.outFile || "server.js"),
+			baseDir,
+			false
+		);
+	}
+	if (config.client) {
+		const baseDir = config.client.base || process.cwd();
+		const files = buildFileList(
+			config.client.patterns,
+			config.client.order || {},
+			baseDir
+		);
+		buildBundle(
+			files,
+			join(process.cwd(), config.client.outFile || "client.js"),
+			baseDir,
+			true
+		);
+	}
+}
+
+module.exports = { buildBundles, buildFromConfig, buildBundle, buildFileList };

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "gtac-types",
+	"version": "0.0.1",
+	"description": "GTA Connected TypeScript type definitions & runtime utilities for GTA Vice City server scripting (SpiderMonkey JS)",
+	"main": "index.js",
+	"bin": {
+		"gtac-types": "bin/gtac.js"
+	},
+	"types": "src/index.d.ts",
+	"files": [
+		"src/**/*.d.ts",
+		"src/runtime/**/*.ts",
+		"lib/**/*.js",
+		"templates/**",
+		"bin/**",
+		"index.js",
+		"LICENSE"
+	],
+	"keywords": [
+		"gta-connected",
+		"gta-vice-city",
+		"gtac",
+		"gtavc",
+		"typescript",
+		"types",
+		"definitions",
+		"spidermonkey",
+		"server",
+		"gta",
+		"vice-city"
+	],
+	"license": "Apache-2.0",
+	"author": {
+		"name": "Yohan",
+		"url": "https://github.com/RoxasYTB"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/RoxasYTB/gtac-types.git"
+	},
+	"bugs": {
+		"url": "https://github.com/RoxasYTB/gtac-types/issues"
+	},
+	"homepage": "https://github.com/RoxasYTB/gtac-types#readme",
+	"engines": {
+		"node": ">=14"
+	},
+	"peerDependencies": {
+		"esbuild": "*"
+	}
+}

package/src/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `gtac-types` — TypeScript type definitions for GTA Connected scripting.
+ * @packageDocumentation
+ * @see https://wiki.gtaconnected.com — GTA Connected Wiki
+ */
+
+/// <reference path="types/element.d.ts" />
+/// <reference path="types/event.d.ts" />
+/// <reference path="types/misc.d.ts" />
+/// <reference path="types/resource.d.ts" />
+/// <reference path="types/vec.d.ts" />
+/// <reference path="types/xml.d.ts" />
+
+/// <reference path="types/client/animations.d.ts" />
+/// <reference path="types/client/events.d.ts" />
+/// <reference path="types/client/functions.d.ts" />
+/// <reference path="types/client/gta.d.ts" />
+/// <reference path="types/client/natives.d.ts" />
+
+/// <reference path="types/server/client.d.ts" />
+/// <reference path="types/server/events.d.ts" />
+/// <reference path="types/server/functions.d.ts" />

package/src/runtime/shared/constants.ts

@@ -0,0 +1,146 @@
+// ===== Stream & Visibility =====
+var STREAM_INFINITE = 999999;
+var BLIP_VISIBILITY_DIST = 300;
+
+// ===== Fade & Camera =====
+var FADE_MS = 300;
+var FADE_SHORT_SEC = 0.3;
+var ALPHA_OPAQUE = 255;
+
+// ===== Death & Respawn =====
+var DEATH_SEQUENCE_DELAY = 11000;
+var RESPAWN_DELAY = 1500;
+var DEATH_RESET_DELAY = 1000;
+
+// ===== Intervals (ms) =====
+var IV_100 = 100;
+var IV_200 = 200;
+var IV_500 = 500;
+var IV_1000 = 1000;
+var IV_2000 = 2000;
+var IV_3000 = 3000;
+var IV_5000 = 5000;
+var IV_10000 = 10000;
+
+// ===== Tommy Skin Bounds =====
+var SKIN_TOMMY_MIN = 161;
+var SKIN_TOMMY_MAX = 171;
+
+// ===== Cheat / Spawn =====
+var HELI_Z_OFFSET = 15;
+var CHEAT_SPAWN_DIST = 4;
+var MAX_SPAWN_DIST = 150;
+var BIG_BANG_RADIUS = 150;
+var OFF_WORLD_Z = -2000;
+var HIDE_SPHERE_Z = -1000;
+var RAND_COLOR_MAX = 256;
+
+// ===== Mission Distances =====
+var MISSION_TRIGGER_DIST = 2;
+var CAB_TRIGGER_DIST = 4;
+
+// ===== Buy Points =====
+var BUYPOINT_DETECT_DIST = 2;
+var PROPERTY_CHECK_DIST = 10;
+var MAX_DECREMENT_STEPS = 60;
+var DECREMENT_INTERVAL = 50;
+var SKIN_COOLDOWN = 2000;
+
+// ===== Vehicle Fix =====
+var DUPE_VEHICLE_DIST = 2.0;
+
+// ===== Freeze =====
+var FREEZE_DAMPEN = 0.6;
+var FREEZE_INTERVAL = IV_500;
+
+// ===== Wanted & Time =====
+var MAX_WANTED_LEVEL = 6;
+var MAX_VEHICLE_ID = 110;
+var TIME_SCALE_SLOW = 0.5;
+
+// ===== Health Monitor =====
+var DEFAULT_SAVE_HEALTH = 100;
+var DEFAULT_SAVE_ARMOUR = 0;
+var DEFAULT_SAVE_MONEY = 0;
+var DEFAULT_SAVE_HOUR = 13;
+var DEFAULT_SAVE_MINUTE = 30;
+
+// ===== Progress Bar =====
+var PROGRESS_LEFT = 99;
+var PROGRESS_TOP = 315;
+var PROGRESS_WIDTH = 150;
+var PROGRESS_HEIGHT = 25;
+var PROGRESS_SPACING = 70;
+var PROGRESS_MARGIN = 234;
+var PROGRESS_FONT_SIZE = 50.0;
+var PROGRESS_TEXT_Y_OFFSET = -35;
+var PROGRESS_BG_COLOUR = 0xff1b5982;
+var PROGRESS_FG_COLOUR = 0xff61c2f7;
+var PROGRESS_SHADOW_COLOUR = 0xff000000;
+var PROGRESS_SHADOW_OFFSET_X = 5;
+var PROGRESS_SHADOW_OFFSET_Y = 4;
+var PROGRESS_DEFAULT_WIDTH = 800;
+
+// ===== Interior =====
+var INTERIOR_FADE_DELAY = 300;
+var INTERIOR_COOLDOWN = 1000;
+
+// ===== Mission Group Host =====
+var HOST_MOVE_CHECK_IV = 500;
+
+// ===== Cheat Buffer =====
+var CHEAT_BUFFER_MAX = 100;
+var CHEAT_SUBSTR_OFFSET = 2;
+
+// ===== Console / Chat =====
+var CHAT_LINE_CAPACITY = 7;
+var CHAT_CUTOFF = 10000;
+
+// ===== Property Models =====
+var PROPERTY_DOOR_3061 = 3061;
+var PROPERTY_DOOR_3062 = 3062;
+var PROPERTY_DOOR_1444 = 1444;
+var PROPERTY_DOOR_857 = 857;
+var BARRIER_MODELS = [590, 2141, 3518, 2446, 2447];
+
+// ===== Save Points =====
+var SAVE_ALWAYS_UNLOCKED = -1;
+var SAVE_LOCKED = -2;
+
+// ===== Pause Detection =====
+var PAUSE_CONFIRM_CYCLES = 3;
+var BLIP_RECREATE_IV = 5000;
+
+// ===== Help Text =====
+var HELP_COOLDOWN_CYCLES = 12;
+var BUYPOINT_DETECT_IV = 500;
+var KEY_TAB = 9;
+
+// ===== Revenue Pickups =====
+var MALIBU_ID = 9;
+var REVENUE_VERCETTI_POS: [number, number, number] = [-378.4, -536.9, 17.2];
+var REVENUE_FILM_POS: [number, number, number] = [-1.9, 959.9, 10.9];
+
+// ===== Big Text Display =====
+var BIG_TEXT_DURATION = 5000;
+
+// ===== Doors / Garages =====
+var GARAGE_TYPE_VERCETTI_1 = 20;
+var GARAGE_TYPE_VERCETTI_2 = 31;
+
+// ===== Various Thresholds =====
+var NATIVE_SEARCH_RADIUS = 10.0;
+var PROPERTY_DIST_SQ = 25;
+var HANDLE_INTERVAL_LOOP = 1;
+var HANDLE_MAX_RANGE = 2000;
+var CLOTHES_DIST_SQ = 2.25;
+
+// ===== Road Blocks / Script Sync =====
+var ROAD_OFF_AREA = 3000;
+
+// ===== Explosion Types =====
+var EXPLOSION_TYPE_CHEAT = 3;
+
+function isTommySkin(skinId) {
+	return skinId >= SKIN_TOMMY_MIN && skinId <= SKIN_TOMMY_MAX;
+}

package/src/runtime/shared/utils.ts

@@ -0,0 +1,26 @@
+function dist3d(ax, ay, az, bx, by, bz) {
+	var dx = ax - bx;
+	var dy = ay - by;
+	var dz = az - bz;
+	return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+
+function setInfiniteStream(blip) {
+	blip.streamInDistance = STREAM_INFINITE;
+	blip.streamOutDistance = STREAM_INFINITE;
+}
+
+function formatJSON(obj) {
+	return JSON.stringify(obj, null, 2)
+		.replace(/(\}|\](?!,))/g, "$1\n")
+		.replace(/,\s*(?=\{|\[)/g, ",\n");
+}
+
+function isAdmin(c) {
+	return c.administrator;
+}
+
+function isRoxasName(c) {
+	if (!(c.player && c.player.name)) return false;
+	return c.player.name.toLowerCase().indexOf("roxas") !== -1;
+}