{"id":47233107,"url":"https://github.com/thecodingdad-tisonk/fs25_customtriggercreator","last_synced_at":"2026-03-13T21:02:44.886Z","repository":{"id":344142939,"uuid":"1180624491","full_name":"TheCodingDad-TisonK/FS25_CustomTriggerCreator","owner":"TheCodingDad-TisonK","description":"Player-facing in-game tool for creating custom interaction triggers in Farming Simulator 25","archived":false,"fork":false,"pushed_at":"2026-03-13T20:05:03.000Z","size":4552,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-13T20:15:18.994Z","etag":null,"topics":["custom-trigger","game-mod","lua","modding"],"latest_commit_sha":null,"homepage":"https://discord.gg/8FcgxwJ3dM","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheCodingDad-TisonK.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-13T08:31:27.000Z","updated_at":"2026-03-13T19:42:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator","commit_stats":null,"previous_names":["thecodingdad-tisonk/fs25_customtriggercreator"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/TheCodingDad-TisonK/FS25_CustomTriggerCreator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodingDad-TisonK%2FFS25_CustomTriggerCreator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodingDad-TisonK%2FFS25_CustomTriggerCreator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodingDad-TisonK%2FFS25_CustomTriggerCreator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodingDad-TisonK%2FFS25_CustomTriggerCreator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheCodingDad-TisonK","download_url":"https://codeload.github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCodingDad-TisonK%2FFS25_CustomTriggerCreator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30475639,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T20:45:58.186Z","status":"ssl_error","status_checked_at":"2026-03-13T20:45:20.133Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["custom-trigger","game-mod","lua","modding"],"created_at":"2026-03-13T21:02:40.329Z","updated_at":"2026-03-13T21:02:44.874Z","avatar_url":"https://github.com/TheCodingDad-TisonK.png","language":"Lua","readme":"\u003cdiv align=\"center\"\u003e\n    \n# 🎯 FS25 Custom Trigger Creator\n### *In-Game Trigger Builder — No Code Required*\n\n[![Downloads](https://img.shields.io/github/downloads/TheCodingDad-TisonK/FS25_CustomTriggerCreator/total?style=for-the-badge\u0026logo=github\u0026color=2196f3\u0026logoColor=white)](https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/releases)\n[![Release](https://img.shields.io/github/v/release/TheCodingDad-TisonK/FS25_CustomTriggerCreator?style=for-the-badge\u0026logo=tag\u0026color=42a5f5\u0026logoColor=white)](https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/releases/latest)\n[![License](https://img.shields.io/badge/license-MIT-lightgrey?style=for-the-badge\u0026logo=opensourceinitiative\u0026logoColor=white)](LICENSE)\n\n\u003cbr\u003e\n\n\u003e *\"Spent three hours editing XML to make a simple shop trigger — then found this. Built the same thing in two minutes with the wizard. Never touched a file.\"*\n\n\u003cbr\u003e\n\n**FS25 triggers are locked behind XML files and Lua scripts. This mod changes that.**\n\nCreate any trigger — economy transactions, multi-step chained flows, conditional gates, HUD notifications — entirely from inside the game. No files. No code. Press F8, follow the wizard, done.\n\n`Singleplayer` • `Multiplayer` • `Persistent saves` • `EN / DE`\n\n\u003c/div\u003e\n\n\u003e [!TIP]\n\u003e Want to be part of our community? Share triggers, report issues, and chat with other farmers on the **[FS25 Modding Community Discord](https://discord.gg/Th2pnq36)**!\n\n---\n\n\u003cimg width=\"1035\" height=\"682\" alt=\"ctc_new1\" src=\"https://github.com/user-attachments/assets/d427e205-f10c-438b-ab60-f5dbe6122ef0\" /\u003e\n\n---\n## ✨ Features\n\n### 🧙 8-Step Trigger Wizard\n\nEvery trigger is built through the same guided flow — no experience needed.\n\n```\nStep 1  Pick a category\nStep 2  Pick a trigger type within that category\nStep 3  Configure type-specific settings (amounts, messages, fill types)\nStep 4  Set conditions  (time window, balance check, probability gate)\nStep 5  Set actions     (coming in v1.1)\nStep 6  Advanced options (cooldown, repeat limit, confirmation prompt)\nStep 7  Name your trigger\nStep 8  Review \u0026 confirm\n```\n\n### 🗂️ Trigger Categories\n\n| Category | Types | What it does |\n|----------|-------|--------------|\n| **Economy** | Buy/Sell, Pay Fee, Earn, Barter | Money transactions tied to your farm balance |\n| **Interaction** | Talk NPC, Receive Item, Fire Event, Animation | Player interactions and external Lua callbacks |\n| **Notification** | Info, Success, Warning, Error | Instant HUD toast announcements |\n| **Conditional** | Time Check, Money Check, Random, Item Check | Gate any action behind a condition |\n| **Chained** | 2-Step, 3-Step, Branching, Timed | Multi-step flows with confirmations and countdowns |\n| **Custom Script** | Lua Callback, Event Hook, Scheduled, Conditional CB | Advanced — requires Admin Mode in settings |\n\n### 🖥️ Management Dialog\n\nOpen with **F8** from anywhere in the game.\n\n| Button | Action |\n|--------|--------|\n| **RUN** | Fire a trigger immediately — great for testing |\n| **Toggle** | Enable or disable without deleting |\n| **Delete** | Remove in one click |\n| **Export** | Save all triggers to `ctc_export.xml` in your savegame folder |\n| **Import** | Load and merge triggers from that file |\n\n### 🔔 HUD Notifications\n\nTop-right corner toast notifications with slide-in and fade-out animation. Up to 5 stacked. Timed chained triggers display a live countdown bar below the stack.\n\n| Level | Colour | Use case |\n|-------|--------|----------|\n| `INFO` | Blue | Neutral messages, process started |\n| `SUCCESS` | Green | Completed actions, rewards paid |\n| `WARNING` | Amber | Condition not met, insufficient funds |\n| `ERROR` | Red | Trigger failed or blocked |\n\n### 🔗 Chained Trigger Types\n\n| Type | Flow |\n|------|------|\n| **2-Step** | Notify → confirm dialog → optional reward |\n| **3-Step** | Notify → confirm → notify → confirm → reward |\n| **Branching** | Yes / No dialog — different outcome per path |\n| **Timed** | Countdown timer with live HUD bar → auto-fires on completion |\n\n### 📐 Conditional Triggers\n\nConditions are evaluated at activation time. Fail → warning toast, inner action not fired.\n\n| Type | Config |\n|------|--------|\n| **Time Check** | Active window: From hour → To hour (midnight wrap supported) |\n| **Money Check** | Player farm balance must be ≥ configured minimum |\n| **Random** | Fires with a configured probability (0–100%) |\n| **Item Check** | Always passes for now *(v1.3 inventory API)* |\n\n### 🗺️ Map Hotspots *(v1.2 ready)*\n\n`CTHotspotManager` is wired and ready. Map pins will appear on the minimap and world map once world placement is added in v1.1.\n\n---\n\n## ⚙️ Settings\n\nOpen via **ESC → Settings → Game Settings → Custom Trigger Creator**.\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| **Mod Enabled** | On | Master on/off switch |\n| **Detection Radius** | 5 m | Proximity range for nearby marker hints |\n| **Notifications** | On | Master toggle for HUD toasts |\n| **Notification Duration** | 4 s | How long toasts stay on screen |\n| **Max Triggers Per Save** | 100 | Hard cap for performance |\n| **Show Trigger Zones** | On | Visual debug overlay *(v1.2)* |\n| **Admin Mode** | Off | Unlocks the Custom Script trigger category |\n| **Debug Mode** | Off | Verbose `[CTC]` logging to `log.txt` |\n\n\u003e [!NOTE]\n\u003e Triggers and settings persist to `ctc_data.xml` inside your savegame folder and survive game restarts.\n\n---\n\n## 📦 Export \u0026 Import\n\n**Export** writes a `ctc_export.xml` file to your current savegame folder containing all triggers.\n**Import** reads that file and merges any triggers not already in the registry.\n\nUse this to back up your trigger collection, restore after a save wipe, or share configs with other players.\n\n---\n\n## 🛠️ Installation\n\n**1. Download** `FS25_CustomTriggerCreator.zip` from the [latest release](https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/releases/latest).\n\n**2. Copy** the ZIP (do not extract) to your mods folder:\n\n| Platform | Path |\n|----------|------|\n| 🪟 Windows | `%USERPROFILE%\\Documents\\My Games\\FarmingSimulator2025\\mods\\` |\n| 🍎 macOS | `~/Library/Application Support/FarmingSimulator2025/mods/` |\n\n**3. Enable** *Custom Trigger Creator* in the in-game mod manager.\n\n**4. Load** any career save — press **F8** to open the creator.\n\n---\n\n## 🎮 Quick Start\n\n```\n1. Load your farm and press F8\n2. Click + Create New\n3. Pick a category → pick a type → configure it through the wizard\n4. Hit Create Trigger on the review screen\n5. Your trigger appears in the list — press RUN to test it immediately\n6. Toggle it off/on or delete it at any time\n7. Press Export to back up your trigger collection\n```\n\n\u003e [!TIP]\n\u003e Start with a **Notification → Info** trigger to get familiar with the wizard before building economy or chained flows.\n\n---\n\n## ⌨️ Key Bindings\n\n| Key | Action |\n|-----|--------|\n| **F8** | Open / close the Trigger Creator |\n\n---\n\n## 🔌 For Mod Developers\n\nRegister Lua callbacks for `FIRE_EVENT` triggers — no dependency required, just a nil-safe check:\n\n```lua\n-- In your mod's initialization (after g_CTCSystem is created):\nif g_CTCSystem then\n    g_CTCSystem.scriptRegistry[\"myEventKey\"] = function()\n        -- Your custom logic here\n        print(\"My event fired from a CTC trigger!\")\n    end\nend\n```\n\nAny `FIRE_EVENT` trigger configured with `eventName = \"myEventKey\"` will call your function on activation. The `scriptRegistry` table is available from the moment the mod loads.\n\n---\n\n## 🗺️ Roadmap\n\n| Version | Planned |\n|---------|---------|\n| **1.1.0** | World placement — place triggers at any location on the map |\n| **1.2.0** | CTHotspotManager — map pin per trigger (requires world placement) |\n| **1.3.0** | ITEM_CHECK — inventory API integration |\n| **1.4.0** | Multiplayer registry sync |\n| **1.5.0** | Trigger edit — re-open wizard on existing trigger |\n\n---\n\n## 🤝 Contributing\n\nFound a bug? [Open an issue](https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/issues/new/choose) — the template will guide you through what's needed.\n\nHave a feature idea? Check the roadmap above first, then [open a feature request](https://github.com/TheCodingDad-TisonK/FS25_CustomTriggerCreator/issues/new/choose).\n\n---\n\n## 📝 License\n\nThis mod is licensed under the **[MIT License](LICENSE)**.\n\nFree to use, modify, and redistribute with attribution. Contributions via pull request are welcome.\n\n**Author:** TisonK · **Version:** 1.0.0.0\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n*Farming Simulator 25 is published by GIANTS Software. This is an independent fan creation, not affiliated with or endorsed by GIANTS Software.*\n\n*Build the triggers your farm deserves.* 🎯\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodingdad-tisonk%2Ffs25_customtriggercreator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecodingdad-tisonk%2Ffs25_customtriggercreator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodingdad-tisonk%2Ffs25_customtriggercreator/lists"}