{"id":15008142,"url":"https://github.com/ziccur/zonamedusa","last_synced_at":"2025-10-24T02:16:25.239Z","repository":{"id":256098578,"uuid":"850039452","full_name":"ziccur/ZonaMedusa","owner":"ziccur","description":"👋 Un script para servidores de FiveM que genera una zona de disputa donde los jugadores aprobados por el servidor pueden luchar por conquerir el territorio y ganar recompensas","archived":false,"fork":false,"pushed_at":"2024-09-08T23:25:23.000Z","size":58,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T08:32:19.363Z","etag":null,"topics":["conquer","conquer-online","esx","esx-framework","esx-legacy","esx-script","fivem","fivem-script","gta-pvp","gta5","gta5-features","guns","lua","pvp","script","zone","zone-planning-and-guest"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ziccur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-30T18:49:27.000Z","updated_at":"2024-10-01T10:42:43.000Z","dependencies_parsed_at":"2024-09-09T11:04:14.207Z","dependency_job_id":null,"html_url":"https://github.com/ziccur/ZonaMedusa","commit_stats":null,"previous_names":["ziccur/zonamedusa"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziccur%2FZonaMedusa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziccur%2FZonaMedusa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziccur%2FZonaMedusa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziccur%2FZonaMedusa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ziccur","download_url":"https://codeload.github.com/ziccur/ZonaMedusa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238968301,"owners_count":19560586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conquer","conquer-online","esx","esx-framework","esx-legacy","esx-script","fivem","fivem-script","gta-pvp","gta5","gta5-features","guns","lua","pvp","script","zone","zone-planning-and-guest"],"created_at":"2024-09-24T19:15:20.117Z","updated_at":"2025-10-24T02:16:25.225Z","avatar_url":"https://github.com/ziccur.png","language":"Lua","funding_links":["https://buymeacoffee.com/ziccur"],"categories":[],"sub_categories":[],"readme":"\u003ch3 align=\"center\"\u003eZonaMedusa\u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Status](https://img.shields.io/badge/status-active-green?style=for-the-badge\u0026link=https%3A%2F%2Fwww.lua.org)]()      [![Made in](https://img.shields.io/badge/made%20in-lua-blue?style=for-the-badge\u0026link=https%3A%2F%2Fwww.lua.org)](www.lua.org)      [![License](https://img.shields.io/badge/licence-MIT-black?style=for-the-badge\u0026link=%2FLICENCE)](/LICENSE)\n\n\u003ch5\u003e Made for \u003c/h5\u003e\n\n[![Server](https://img.shields.io/badge/Server-FiveM-orange?style=for-the-badge)]() [![GAME](https://img.shields.io/badge/Game-%20GTA%20V%20-darkgreen?style=for-the-badge\n)]() [![Framework](https://img.shields.io/badge/Framwork-ESX%20%2F%20ESX%20Legacy-red?style=for-the-badge)]()\n\n\u003c/div\u003e\n\n---\n\n\u003cp align=\"left\"\u003e ZonaMedusa es un script para servidores de \u003cb\u003eFiveM (ESX) \u003c/b\u003e que permite tener una zona localizada en el mapa donde los jugadores con una \u003cb\u003efacción o trabajo admitido\u003c/b\u003e puedan luchar por el control de la zona y sus recompensas. Esta zona se considera como una zona de disputa en la que se avisa a todos los jugadores que se aproximan. \n    \u003cbr\u003e \n\u003c/p\u003e\n\n## 📝 Contenidos\n\n- [Requisitos](#requisitos)\n- [Instalacion](#instalacion)\n- [Configuración](#configuracion)\n- [Como usar ZonaMedusa](#uso)\n- [Notas de desarrollo](#desarrollo)\n- [Comandos](#comandos)\n- [Autores](#authors)\n\n## 🧐 Requisitos \u003ca name = \"requisitos\"\u003e\u003c/a\u003e\n\nAntes de instalar el script, asegúrate de tener los siguientes requisitos en tu servidor:\n\n- ESX o ESX Legacy como framework\n- Los siguientes scripts instalados:\n  - [es_extended](https://github.com/esx-framework/esx_core/tree/main/%5Bcore%5D/es_extended)\n  - [esx_banking](https://github.com/esx-framework/esx_banking) o con las mismas funciones\n  - [esx_jobs](https://github.com/esx-framework/esx_jobs)\n\n## 🏁 Instalación \u003ca name = \"instalacion\"\u003e\u003c/a\u003e\n\n Sigue los siguientes pasos para instalar correctamente el script en tu servidor, si quieres saber mas puedes mirar las [notas de desarrollo](#desarollo).\n\n#### Clona el repositiorio\n\nClona el repositorio en tu la carpeta \u003cu\u003e \u003cb\u003e resources\u003c/b\u003e\u003c/u\u003e de tu servidor de FiveM.\n\n```\n git clone https://github.com/ziccur/ZonaMedusa.git\n```\n\nUna vez clonado el repositorio, deberás de añadir el script a tu archivo de configuración de recursos \u003cu\u003e \u003cb\u003e server.cfg \u003c/b\u003e\u003c/u\u003e de tu servidor.\n\n```\n ensure ZonaMedusa \n```\n\n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281058441502130196/undefined_-_Imgur.png?ex=66da5625\u0026is=66d904a5\u0026hm=e7a3e74eea575743587321aa50617f540996054e7d6e5d244de4afd12bdddf83\u0026\" alt=\"server.cfg\" width=\"500\"/\u003e\n\n\nPara acabar de ver los cambios en tu servidor, deberás de reiniciar el servidor o ejecutar el comando \u003cu\u003e \u003cb\u003e ensure ZonaMedusa \u003c/b\u003e\u003c/u\u003e en la consola de tu servidor.\n\n##  🔩 Configuración \u003ca name=\"configuracion\"\u003e\u003c/a\u003e\n\nPara configurar el script, deberás de modificar el archivo \u003cu\u003e \u003cb\u003e config.lua \u003c/b\u003e\u003c/u\u003e que se encuentra en la carpeta del script. A continuación una lista de las variables que puedes modificar y su descripción:\n\n- \u003ca \u003eLenguage \u003c/a\u003e = Idioma del script, por defecto es \"es\" (Español)\n- \u003ca \u003elocation \u003c/a\u003e = Coordenadas de la zona de disputa (x,y,z)\n- \u003ca \u003eallowedJobs \u003c/a\u003e = Lista de trabajos \u003cb\u003e legales \u003c/b\u003e que pueden conquistar la zona de disputa\n- \u003ca \u003eallowedIllegalJobs \u003c/a\u003e = Lista de trabajos \u003cb\u003e no legales \u003c/b\u003e que pueden conquistar la zona de disputa\n- \u003ca \u003eNPCspawn \u003c/a\u003e = Escoge si quieres que aparezca un NPC en medio de la zona de disputa\n- \u003ca \u003epedModel\u003c/a\u003e = Modelo del NPC que aparecerá en la zona de disputa\n- \u003ca \u003econquerKey \u003c/a\u003e = Tecla que usaran los jugadores para conquistar la zona de disputa\n- \u003ca \u003eSize \u003c/a\u003e = Tamaño de la zona de disputa\t\n- \u003ca \u003etimeToConquer \u003c/a\u003e = Tiempo en \u003cb\u003e segundos \u003c/b\u003e que se tarda en conquistar la zona\n- \u003ca \u003etimeToReward \u003c/a\u003e = Frequencia en \u003cb\u003e segundos \u003c/b\u003e que se reparten las recompensas\n- \u003ca \u003eilegalReward \u003c/a\u003e = Recompensa que se reparte a los trabajos ilegales -\u003e \u003ca \u003eallowedIllegalJobs \u003c/a\u003e\n- \u003ca \u003elegalReward \u003c/a\u003e = Recompensa que se reparte a los trabajos legales -\u003e \u003ca \u003eallowedJobs \u003c/a\u003e\n\n- \u003ca \u003eBlipColour \u003c/a\u003e = Color del blip de la zona de disputa\n- \u003ca \u003eBlipSprite \u003c/a\u003e = Sprite del blip de la zona de disputa (dibuo)\n- \u003ca \u003eBlipAlpha \u003c/a\u003e = Opacidad del blip de la zona de disputa\n- \u003ca \u003edefaultOwner \u003c/a\u003e = Dueño de la zona de disputa por defecto\n\n## 🎈 Como usar ZonaMedusa \u003ca name=\"uso\"\u003e\u003c/a\u003e\n\nDesde el lado del jugador aparece en el mapa una zona con un rango que indica el nombre de la zona y quien tiene la posesión de la zona. Así se ve la zona por defecto:\n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281068018147004477/image.png?ex=66da5f10\u0026is=66d90d90\u0026hm=2db43a436e958f35720dc83614899fabf10bddb6e3c4bc6795bfeb2c573cbb19\u0026\"\u003e\n\nAl entrar y al abandonar de la zona de disputa se te avisará para que sepas que estas en una zona conflictiva \n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281068771372695603/image.png?ex=66da5fc4\u0026is=66d90e44\u0026hm=50e2549794bac2b0be0592438edfbf4665b0f63ecdf97c53f609e000dc3e76e4\u0026\"\u003e \u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281068845578064044/image.png?ex=66da5fd5\u0026is=66d90e55\u0026hm=5a5b2e7a3a973d7424813856cb0fb88e4cc861e6aa17dcf698b542827d41af55\u0026\"\u003e\n\nAl entrar si estas en un trabajo admitido, podrás conquistar la zona de disputa pulsando la tecla que hayas configurado en el archivo \u003cu\u003e \u003cb\u003e config.lua \u003c/b\u003e\u003c/u\u003e. Si no estás autorizado te aparecerá un mensaje advirtiendote que no puedes conquistar la zona hasta que salgas de la zona.\n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281069564687286322/image.png?ex=66da6081\u0026is=66d90f01\u0026hm=4dc6c862626d4d84e618285f9ddf9ada8a2314a358e1278e92844eb59e0c8f41\u0026\"\u003e\n\nAl empezar la conquista empezará una cuenta atras en la que deberás mantenerte en la zona para poder completar la conquista. Si sales de la zona la conquista se cancelará y deberás empezar de nuevo.\n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281069977323180215/image.png?ex=66da60e3\u0026is=66d90f63\u0026hm=caac42cd1d165c7ebcbcbae94db55c07791732850349e5278378583d81b4a17d\u0026\"\u003e\n\nUna vez conquistada la zona, recibirás una recompensa en tu inventario. Si eres un trabajo legal recibirás una recompensa y si eres un trabajo ilegal recibirás otra recompensa. Además, el dueño de la zona de disputa cambiará a tu trabajo.\n\n\u003cimg src=\"https://cdn.discordapp.com/attachments/1234234265437212754/1281070227228200970/image.png?ex=66da611f\u0026is=66d90f9f\u0026hm=3ae5df845c074cd4b039ed5722fe8fec7f9d552812481008c885a6e3bb4b1922\u0026\"\u003e\n\n\nSe mantendrá la conquista mientras no se reinicie el script o se reinicie el servidor y mientras nadie conquiste la zona de disputa.\n\n\n## 🚀 Notas de desarrollo \u003ca name = \"desarrollo\"\u003e\u003c/a\u003e\n\nDocumentación seguida oficial y recursos utilizados para el desarrollo del script:\n- [Documentation Oficial de ESX](https://documentation.esx-framework.org/legacy/installation)\n- [Documentación Oficial de FiveM](https://docs.fivem.net/docs/scripting-reference/runtimes/lua/)\n- [Documentación Oficial de Lua](https://www.lua.org/manual/5.1/es/)\n- [KeyMap de FiveM](https://docs.fivem.net/docs/game-references/controls/)\n- [Referencias de Ped's GTA](https://docs.fivem.net/docs/game-references/ped-models/)\n- [Referencias de Blips GTA](https://docs.fivem.net/docs/game-references/blips/)\n\n## 🛠 Comandos \u003ca name=\"comandos\"\u003e\u003c/a\u003e\n\nSe han añadido comandos para uso a nivel de administrador, estos comandos son los siguientes:\n\n- /changeOwnerOfMedusa \u003cjob name\u003e \u003cjob label\u003e -\u003e Cambia el dueño de la zona de disputa a un trabajo especifico\n\nEjemplo:\n```\n  /changeOwnerOfMedusa police LSPD\n```\n\n\n## ✍️ Autor \u0026 Contribuidores \u003ca name = \"authors\"\u003e\u003c/a\u003e\n\n- [@ziccur](https://github.com/ziccur) - Idea principal y desarrollo del script\n- [@jitodv](https://github.com/jitodv) - Complementación de idea principal\n- [@Yxel14](https://github.com/Yxelixx14) - Revisión de código\n\n####  💌 If you want to support project or contact with me:\n\n- \u003cb\u003eDiscord:\u003c/b\u003e Ziccur\n\n[![BUY ME A COFFEE](https://miro.medium.com/v2/resize:fit:1400/1*VJdus0nKuy1uNoByh5BN3w.png)](https://buymeacoffee.com/ziccur)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziccur%2Fzonamedusa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziccur%2Fzonamedusa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziccur%2Fzonamedusa/lists"}