{"id":22900335,"url":"https://github.com/vectorial1024/v1024_genesis_signal","last_synced_at":"2026-03-19T23:56:53.439Z","repository":{"id":245708699,"uuid":"819017119","full_name":"Vectorial1024/v1024_genesis_signal","owner":"Vectorial1024","description":"Unified Mission Director signaling for detecting X4 Foundations game start events.","archived":false,"fork":false,"pushed_at":"2024-07-24T14:54:58.000Z","size":1303,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-07T03:24:30.472Z","etag":null,"topics":["mod","x4foundations"],"latest_commit_sha":null,"homepage":"https://steamcommunity.com/sharedfiles/filedetails/?id=3275279686","language":null,"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/Vectorial1024.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-06-23T14:40:02.000Z","updated_at":"2024-07-24T14:55:03.000Z","dependencies_parsed_at":"2024-06-23T16:16:40.465Z","dependency_job_id":null,"html_url":"https://github.com/Vectorial1024/v1024_genesis_signal","commit_stats":null,"previous_names":["vectorial1024/v1024_genesis_signal"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vectorial1024%2Fv1024_genesis_signal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vectorial1024%2Fv1024_genesis_signal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vectorial1024%2Fv1024_genesis_signal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vectorial1024%2Fv1024_genesis_signal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vectorial1024","download_url":"https://codeload.github.com/Vectorial1024/v1024_genesis_signal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246586048,"owners_count":20801026,"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":["mod","x4foundations"],"created_at":"2024-12-14T01:19:07.346Z","updated_at":"2026-01-11T01:45:37.373Z","avatar_url":"https://github.com/Vectorial1024.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Genesis Signal\nUnified Mission Director cues for correctly detecting X4 Foundations game start events.\n\n- Our GitHub repository: https://github.com/Vectorial1024/v1024_genesis_signal\n- Our EgoSoft Forums page: https://forum.egosoft.com/viewtopic.php?t=463558\n- Our Steam Workshop page: https://steamcommunity.com/sharedfiles/filedetails/?id=3275279686\n- Our Nexus page: (WIP)\n\nWhere reasonable, some vanilla script triggers are also changed to use Genesis Signal:\n- `md/drain_stations.xml`: A script that regularly drains NPC trade stations\n- `md/finalizestations.xml`: A script that helps design stations for spawning/building\n\n---\n\nFor a long time in the modern X-game engine (X: Rebirth, and X4: Foundations), it has always been possible to start the game in so-called \"alternate universes\". This feature is later extensively used in X4 Foundations:\n- Tutorial levels\n- Station Design Simulator\n- 7.0 Timelines DLC\n\nMods that listen to game start events may be triggered when e.g. visiting the Station Design Simulator. These usually can be overlooked, but mods starting inside the Facility in the Timelines DLC is simply going too far. This mod therefore provides some unified signals for such mods to listen to, so that the Timelines DLC is not tampered with (at least not so obviously).\n\nAlternate universes that may also be considered \"canon\" (e.g. the Star Wars overhaul universe) should patch their universe information into this mod to unify the start up sequence.\n\n## How to listen to the proper \"universe started\" events?\n\nPerhaps you are trying to initialize something when the universe starts.\n\nIf you would normally be listening for `\u003cevent_cue_signalled cue=\"md.Setup.Start\" /\u003e`, then it is simple:\n\n```xml\n\u003cconditions\u003e\n    \u003c!-- This is triggered only when the universe is a known Open Universe --\u003e\n    \u003cevent_cue_signalled cue=\"md.GenesisSignal.Start\" /\u003e\n\u003c/conditions\u003e\n```\n\nIt is probably rarer to need to listen for `\u003cevent_cue_complete cue=\"md.Setup.Start\" /\u003e`, but it is still doable:\n\n```xml\n\u003cconditions\u003e\n    \u003cevent_cue_complete cue=\"md.Setup.Start\" /\u003e\n    \u003c!-- if true, then it is an Open Universe game --\u003e\n    \u003ccheck_value value=\"@global.$isOpenUniverse\" /\u003e\n\u003c/conditions\u003e\n```\n\nThis showcases the global variable for Open Universe checking, which may be used in regular MD scripts and AI scripts.\n\n## How to patch my alternate universe into Genesis Signal?\n\nExample of alternate universe from the community: Star Wars Interworlds.\n\nYour mod structure:\n\n```\n/content.xml\n/libraries/[...]\n/extensions/v1024_genesis_signal/md/v1024_genesissignal.md\n```\n\nInside `/extensions/v1024_genesis_signal/md/genesissignal.md`:\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"utf-8\" ?\u003e\n\u003cdiff\u003e\n    \u003cadd sel=\"/mdscript/cues/cue[@name='Start']/conditions/check_any\"\u003e\n        \u003c!-- Your open universe here --\u003e\n        \u003ccheck_value value=\"player.galaxy.macro.ismacro.{macro.your_open_universe_here}\" /\u003e\n    \u003c/add\u003e\n\u003c/diff\u003e\n```\n\nOptionally, declare dependency on Genesis Signal by editing your `content.xml`:\n\n```xml\n\u003ccontent\u003e\n    \u003cdependency id=\"ws_3275279686\" name=\"Genesis Signal\"/\u003e\n\u003c/content\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvectorial1024%2Fv1024_genesis_signal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvectorial1024%2Fv1024_genesis_signal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvectorial1024%2Fv1024_genesis_signal/lists"}