From c24c883252df2636e03f1acd12ad8fd02a2acee7 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 10 Jan 2026 23:13:58 +0000 Subject: [PATCH] Add comprehensive GTA IV freeroam server with multiple resources Features: - Freeroam resource: Player spawning, basic commands, kill tracking - Vehicles resource: 100+ GTA IV vehicles with spawn commands - Admin resource: Full moderation (kick, ban, mute, freeze, etc.) - World resource: Weather and time control - Chat resource: Private messages, local chat, roleplay actions - Teleport resource: 30+ Liberty City locations with waypoints - Server configuration and comprehensive README documentation --- README.md | 238 ++++++++++++++++- resources/admin/meta.xml | 5 + resources/admin/server.js | 490 +++++++++++++++++++++++++++++++++++ resources/chat/meta.xml | 5 + resources/chat/server.js | 246 ++++++++++++++++++ resources/freeroam/client.js | 41 +++ resources/freeroam/meta.xml | 6 + resources/freeroam/server.js | 331 +++++++++++++++++++++++ resources/teleport/meta.xml | 5 + resources/teleport/server.js | 314 ++++++++++++++++++++++ resources/vehicles/meta.xml | 5 + resources/vehicles/server.js | 347 +++++++++++++++++++++++++ resources/world/meta.xml | 5 + resources/world/server.js | 240 +++++++++++++++++ server.xml | 37 +++ 15 files changed, 2314 insertions(+), 1 deletion(-) create mode 100644 resources/admin/meta.xml create mode 100644 resources/admin/server.js create mode 100644 resources/chat/meta.xml create mode 100644 resources/chat/server.js create mode 100644 resources/freeroam/client.js create mode 100644 resources/freeroam/meta.xml create mode 100644 resources/freeroam/server.js create mode 100644 resources/teleport/meta.xml create mode 100644 resources/teleport/server.js create mode 100644 resources/vehicles/meta.xml create mode 100644 resources/vehicles/server.js create mode 100644 resources/world/meta.xml create mode 100644 resources/world/server.js create mode 100644 server.xml diff --git a/README.md b/README.md index 671f7b7..dfdc7b8 100644 --- a/README.md +++ b/README.md @@ -1 +1,237 @@ -# GTAConnected \ No newline at end of file +# GTAConnected - Liberty City Freeroam Server + +A comprehensive GTA IV freeroam server for GTAConnected with multiple features including vehicle spawning, teleportation, admin tools, weather control, and enhanced chat. + +## Features + +- **Freeroam System** - Random spawning across Liberty City with starter weapons +- **Vehicle Spawning** - 100+ GTA IV vehicles available via commands +- **Teleportation** - 30+ preset locations across all Liberty City boroughs +- **Admin System** - Full moderation tools (kick, ban, mute, freeze, etc.) +- **World Control** - Weather and time manipulation +- **Enhanced Chat** - Private messages, local chat, actions, and OOC chat +- **Kill Tracking** - Statistics for kills, deaths, and K/D ratio + +## Installation + +1. Download and install GTAConnected server from [gtaconnected.com](https://gtaconnected.com) +2. Copy all files from this repository to your GTAConnected server directory +3. Start the server using `Server.exe` (Windows) or `./Server` (Linux) + +## Server Structure + +``` +GTAConnected/ +├── server.xml # Main server configuration +├── README.md +└── resources/ + ├── freeroam/ # Player spawning and basic commands + │ ├── meta.xml + │ ├── server.js + │ └── client.js + ├── vehicles/ # Vehicle spawning system + │ ├── meta.xml + │ └── server.js + ├── admin/ # Admin moderation tools + │ ├── meta.xml + │ └── server.js + ├── world/ # Weather and time control + │ ├── meta.xml + │ └── server.js + ├── chat/ # Enhanced chat system + │ ├── meta.xml + │ └── server.js + └── teleport/ # Teleportation system + ├── meta.xml + └── server.js +``` + +## Commands + +### Player Commands + +| Command | Description | +|---------|-------------| +| `/help` | Show all available commands | +| `/spawn` | Respawn at a random location | +| `/kill` | Kill yourself | +| `/pos` | Show your current coordinates | +| `/stats` | Show your kill/death statistics | +| `/players` | List online players | +| `/heal` | Restore your health | +| `/armour` | Give yourself armour | +| `/weapons` | Get all weapons | +| `/skin ` | Change your player skin | + +### Vehicle Commands + +| Command | Description | +|---------|-------------| +| `/v ` | Spawn a vehicle | +| `/dv` | Delete your spawned vehicles | +| `/vlist` | Show vehicle categories | +| `/vsearch ` | Search for vehicles | +| `/vcolor ` | Change vehicle colors | +| `/flip` | Flip your vehicle upright | +| `/fix` | Repair your vehicle | +| `/eject` | Exit current vehicle | + +### Teleport Commands + +| Command | Description | +|---------|-------------| +| `/tp ` | Teleport to a location | +| `/tplist` | Show all teleport locations | +| `/tpsearch ` | Search for locations | +| `/setpos ` | Teleport to coordinates | +| `/savewaypoint ` | Save current position | +| `/tpwp ` | Teleport to saved waypoint | +| `/waypoints` | List your saved waypoints | +| `/airport` | Quick teleport to airport | +| `/hospital` | Quick teleport to hospital | + +### World Commands + +| Command | Description | +|---------|-------------| +| `/weather <0-9>` | Set weather type | +| `/time ` | Set time of day | +| `/morning` | Set time to 8:00 | +| `/noon` | Set time to 12:00 | +| `/evening` | Set time to 18:00 | +| `/night` | Set time to 0:00 | +| `/sunny` | Set sunny weather | +| `/rain` | Set rainy weather | +| `/thunder` | Set thunderstorm | +| `/foggy` | Set foggy weather | +| `/freezetime` | Toggle time freeze | +| `/gettime` | Show current time | +| `/getweather` | Show current weather | + +### Chat Commands + +| Command | Description | +|---------|-------------| +| `/pm ` | Send private message | +| `/r ` | Reply to last PM | +| `/me ` | Roleplay action | +| `/do ` | Roleplay description | +| `/shout ` | Shout message | +| `/ooc ` | Out-of-character chat | +| `/local ` | Local area chat | + +### Admin Commands + +| Command | Description | +|---------|-------------| +| `/ahelp` | Show admin commands | +| `/kick [reason]` | Kick a player | +| `/ban [reason]` | Ban a player | +| `/unban ` | Unban a player | +| `/mute ` | Mute a player | +| `/unmute ` | Unmute a player | +| `/freeze ` | Freeze a player | +| `/unfreeze ` | Unfreeze a player | +| `/slap ` | Slap a player | +| `/goto ` | Teleport to player | +| `/bring ` | Bring player to you | +| `/announce ` | Server announcement | +| `/setadmin ` | Grant admin rights | +| `/getip ` | Get player's IP | +| `/sethealth ` | Set player health | +| `/setarmour ` | Set player armour | +| `/explode ` | Explode a player | +| `/admins` | Show online admins | +| `/report ` | Report to admins | + +## Available Vehicles + +### Sports & Super Cars +- infernus, turismo, comet, banshee, sultan, coquette, feltzer +- entityxf, adder, vacca, bullet, cheetah + +### Muscle Cars +- sabregt, stalion, vigero, dukes, ruiner, phoenix, gauntlet, dominator + +### SUVs & Sedans +- patriot, cavalcade, granger, huntley, landstalker +- oracle, schafter, admiral, vincent, presidente, cognoscenti + +### Emergency Vehicles +- police, police2, fbi, fbi2, noose, ambulance, firetruk + +### Motorcycles +- nrg900, pcj600, sanchez, faggio, bati, akuma, hakuchou + +### Aircraft & Boats +- annihilator, maverick, polmav, buzzard, shamal +- jetmax, marquis, predator, tropic, dinghy + +## Teleport Locations + +### Algonquin (Manhattan) +- starjunction, middlepark, rotterdam, chinatown, exchange, happiness + +### Broker/Dukes (Brooklyn/Queens) +- broker, firefly, outlook, beach, hove, meadows, willis, airport + +### Bohan (Bronx) +- bohan, northholland, industrial + +### Alderney (New Jersey) +- alderney, alderneyport, westdyke, acter, berchem, tudor, leftwood + +### Points of Interest +- hospital, police, bowling, cabaret, burgershot, helipad + +## Weather Types + +| ID | Weather | +|----|---------| +| 0 | Extra Sunny | +| 1 | Sunny | +| 2 | Sunny Windy | +| 3 | Cloudy | +| 4 | Raining | +| 5 | Drizzle | +| 6 | Foggy | +| 7 | Thunder | +| 8 | Extra Sunny 2 | +| 9 | Sunny Windy 2 | + +## Configuration + +### Server Settings (server.xml) + +```xml +Liberty City Freeroam +32 +22000 +IV +``` + +### Adding Admins + +Edit `resources/admin/server.js` and add player names to the admins array: + +```javascript +const admins = [ + "YourName", + "AnotherAdmin" +]; +``` + +## Requirements + +- GTAConnected Server (v1.0.72 or newer) +- GTA IV (with Episodes from Liberty City for all vehicles) +- Port 22000 UDP forwarded for online play + +## Credits + +- Built for [GTAConnected](https://gtaconnected.com) +- Documentation: [GTAConnected Wiki](https://wiki.gtaconnected.com) + +## License + +This project is open source and free to use for your GTA IV multiplayer server. diff --git a/resources/admin/meta.xml b/resources/admin/meta.xml new file mode 100644 index 0000000..fef965f --- /dev/null +++ b/resources/admin/meta.xml @@ -0,0 +1,5 @@ + + + +